@modelcontextprotocol/ext-apps 1.1.1 → 1.1.2

package/dist/src/app-bridge.d.ts

@@ -2,7 +2,7 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 import { CallToolRequest, CallToolResult, EmptyResult, Implementation, ListPromptsRequest, ListPromptsResult, ListResourcesRequest, ListResourcesResult, ListResourceTemplatesRequest, ListResourceTemplatesResult, LoggingMessageNotification, PingRequest, PromptListChangedNotification, ReadResourceRequest, ReadResourceResult, ResourceListChangedNotification, Tool, ToolListChangedNotification } from "@modelcontextprotocol/sdk/types.js";
 import { Protocol, ProtocolOptions, RequestOptions } from "@modelcontextprotocol/sdk/shared/protocol.js";
-import { type AppNotification, type AppRequest, type AppResult, type McpUiSandboxResourceReadyNotification, type McpUiSizeChangedNotification, type McpUiToolCancelledNotification, type McpUiToolInputNotification, type McpUiToolInputPartialNotification, type McpUiToolResultNotification, McpUiAppCapabilities, McpUiUpdateModelContextRequest, McpUiHostCapabilities, McpUiHostContext, McpUiHostContextChangedNotification, McpUiInitializedNotification, McpUiMessageRequest, McpUiMessageResult, McpUiOpenLinkRequest, McpUiOpenLinkResult, McpUiResourceTeardownRequest, McpUiSandboxProxyReadyNotification, McpUiRequestDisplayModeRequest, McpUiRequestDisplayModeResult, McpUiResourcePermissions } from "./types";
+import { type AppNotification, type AppRequest, type AppResult, type McpUiSandboxResourceReadyNotification, type McpUiSizeChangedNotification, type McpUiToolCancelledNotification, type McpUiToolInputNotification, type McpUiToolInputPartialNotification, type McpUiToolResultNotification, McpUiAppCapabilities, McpUiUpdateModelContextRequest, McpUiHostCapabilities, McpUiHostContext, McpUiHostContextChangedNotification, McpUiInitializedNotification, McpUiMessageRequest, McpUiMessageResult, McpUiOpenLinkRequest, McpUiOpenLinkResult, McpUiDownloadFileRequest, McpUiDownloadFileResult, McpUiResourceTeardownRequest, McpUiSandboxProxyReadyNotification, McpUiRequestDisplayModeRequest, McpUiRequestDisplayModeResult, McpUiResourcePermissions } from "./types";
 export * from "./types";
 export { RESOURCE_URI_META_KEY, RESOURCE_MIME_TYPE } from "./app";
 export { PostMessageTransport } from "./message-transport";
@@ -404,6 +404,49 @@ export declare class AppBridge extends Protocol<AppRequest, AppNotification, App
      * @see {@link McpUiOpenLinkResult `McpUiOpenLinkResult`} for the result type
      */
     set onopenlink(callback: (params: McpUiOpenLinkRequest["params"], extra: RequestHandlerExtra) => Promise<McpUiOpenLinkResult>);
+    /**
+     * Register a handler for file download requests from the View.
+     *
+     * The View sends `ui/download-file` requests when the user wants to
+     * download a file. The params contain an array of MCP resource content
+     * items — either `EmbeddedResource` (inline data) or `ResourceLink`
+     * (URI the host can fetch). The host should show a confirmation dialog
+     * and then trigger the download.
+     *
+     * @param callback - Handler that receives download params and returns a result
+     *   - `params.contents` - Array of `EmbeddedResource` or `ResourceLink` items
+     *   - `extra` - Request metadata (abort signal, session info)
+     *   - Returns: `Promise<McpUiDownloadFileResult>` with optional `isError` flag
+     *
+     * @example
+     * ```ts
+     * bridge.ondownloadfile = async ({ contents }, extra) => {
+     *   for (const item of contents) {
+     *     if (item.type === "resource") {
+     *       // EmbeddedResource — inline content
+     *       const res = item.resource;
+     *       const blob = res.blob
+     *         ? new Blob([Uint8Array.from(atob(res.blob), c => c.charCodeAt(0))], { type: res.mimeType })
+     *         : new Blob([res.text ?? ""], { type: res.mimeType });
+     *       const url = URL.createObjectURL(blob);
+     *       const link = document.createElement("a");
+     *       link.href = url;
+     *       link.download = res.uri.split("/").pop() ?? "download";
+     *       link.click();
+     *       URL.revokeObjectURL(url);
+     *     } else if (item.type === "resource_link") {
+     *       // ResourceLink — host fetches or opens directly
+     *       window.open(item.uri, "_blank");
+     *     }
+     *   }
+     *   return {};
+     * };
+     * ```
+     *
+     * @see {@link McpUiDownloadFileRequest `McpUiDownloadFileRequest`} for the request type
+     * @see {@link McpUiDownloadFileResult `McpUiDownloadFileResult`} for the result type
+     */
+    set ondownloadfile(callback: (params: McpUiDownloadFileRequest["params"], extra: RequestHandlerExtra) => Promise<McpUiDownloadFileResult>);
     /**
      * Register a handler for display mode change requests from the view.
      *