SEP-973: 为实现、资源、工具和提示词暴露额外元数据

/**
 * 一个指向图标 URL 或 base64 编码数据 URI 的 url
 *
 * 支持渲染图标的客户端必须至少支持以下 MIME 类型：
 * - image/png - PNG 图像（安全，通用兼容）
 * - image/jpeg (and image/jpg) - JPEG 图像（安全，通用兼容）
 *
 * 支持渲染图标的客户端还应该支持：
 * - image/svg+xml - SVG 图像（可缩放但需要安全措施）
 * - image/webp - WebP 图像（现代，高效格式）
 */
export interface Icon {
  /**
   * 一个指向图标资源的标准 URI。
   *
   * 使用者必须采取措施确保提供图标的 URL 来自
   * 与客户端/服务器相同的域或受信任的域。
   *
   * 使用者在使用 SVG 时必须采取适当的预防措施，因为它们可能包含
   * 可执行的 JavaScript
   *
   * @format uri
   */
  src: string;
  /** 如果服务器的 MIME 类型缺失或通用，则为可选覆盖。 */
  mimeType?: string;
  /** 例如 "48x48", "any"（用于 SVG），或 "48x48 96x96" */
  sizes?: string;
}

/**
 * 描述 MCP 实现
 */
export interface Implementation extends BaseMetadata {
  version: string;
  /**
   * 此实现的可选图标列表。
   * 客户端可以使用此列表在用户界面中显示实现。
   * 每个图标应有一个 `kind` 属性，指定它是数据表示还是 URL 源，一个 `src` 属性指向图标文件或数据表示，并且可能还包括 `mimeType` 和 `sizes` 属性。
   * `mimeType` 属性应为图标文件的有效 MIME 类型，例如 "image/png" 或 "image/svg+xml"。
   * `sizes` 属性应为一个字符串，指定图标文件可以使用的尺寸，例如 "48x48" 或 "any" 用于 SVG 等可缩放格式。
   * `sizes` 属性是可选的，如果未提供，客户端应假设图标可以在任何尺寸下使用。
   */
  icons?: Icon[];
  /**
   * 此实现的网站的可选 URL。
   *
   * 使用者必须采取措施确保提供图标的 URL 来自
   * 与客户端/服务器相同的域或受信任的域。
   *
   * 使用者在使用 SVG 时必须采取适当的预防措施，因为它们可能包含
   * 可执行的 JavaScript
   *
   * @format: uri
   */
  websiteUrl?: string;
}

  /**
   * 资源的可选图标列表。
   * 客户端可以使用此列表在用户界面中显示资源的图标。
   * 每个图标应有一个 `kind` 属性，指定它是数据表示还是 URL 源，一个 `src` 属性指向图标文件或数据表示，并且可能还包括 `mimeType` 和 `sizes` 属性。
   * `mimeType` 属性应为图标文件的有效 MIME 类型，例如 "image/png" 或 "image/svg+xml"。
   * `sizes` 属性应为一个字符串，指定图标文件可以使用的尺寸，例如 "48x48" 或 "any" 用于 SVG 等可缩放格式。
   * `sizes` 属性是可选的，如果未提供，客户端应假设图标可以在任何尺寸下使用。
   */
  icons?: Icon[];