@modelcontextprotocol/ext-apps 0.0.7 → 0.1.0

package/README.md

@@ -1,6 +1,6 @@
 # @modelcontextprotocol/ext-apps
 
-[![API Documentation](https://img.shields.io/badge/docs-API%20Reference-blue)](https://modelcontextprotocol.github.io/ext-apps/api/)
+[![npm version](https://img.shields.io/npm/v/@modelcontextprotocol/ext-apps.svg)](https://www.npmjs.com/package/@modelcontextprotocol/ext-apps) [![API Documentation](https://img.shields.io/badge/docs-API%20Reference-blue)](https://modelcontextprotocol.github.io/ext-apps/api/)
 
 This repo contains the SDK and [specification](https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx) for MCP Apps Extension ([SEP-1865](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/1865)).
 

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 { Implementation, LoggingMessageNotification, Notification, PingRequest, Request, Result } from "@modelcontextprotocol/sdk/types.js";
 import { Protocol, ProtocolOptions, RequestOptions } from "@modelcontextprotocol/sdk/shared/protocol.js";
-import { type McpUiSandboxResourceReadyNotification, type McpUiSizeChangedNotification, type McpUiToolInputNotification, type McpUiToolInputPartialNotification, type McpUiToolResultNotification, McpUiAppCapabilities, McpUiHostCapabilities, McpUiHostContext, McpUiHostContextChangedNotification, McpUiInitializedNotification, McpUiMessageRequest, McpUiMessageResult, McpUiOpenLinkRequest, McpUiOpenLinkResult, McpUiResourceTeardownRequest, McpUiSandboxProxyReadyNotification } from "./types";
+import { type McpUiSandboxResourceReadyNotification, type McpUiSizeChangedNotification, type McpUiToolCancelledNotification, type McpUiToolInputNotification, type McpUiToolInputPartialNotification, type McpUiToolResultNotification, McpUiAppCapabilities, McpUiHostCapabilities, McpUiHostContext, McpUiHostContextChangedNotification, McpUiInitializedNotification, McpUiMessageRequest, McpUiMessageResult, McpUiOpenLinkRequest, McpUiOpenLinkResult, McpUiResourceTeardownRequest, McpUiSandboxProxyReadyNotification } from "./types";
 export * from "./types";
 export { RESOURCE_URI_META_KEY, RESOURCE_MIME_TYPE } from "./app";
 export { PostMessageTransport } from "./message-transport";
@@ -510,6 +510,37 @@ export declare class AppBridge extends Protocol<Request, Notification, Result> {
      * @see {@link sendToolInput} for sending tool arguments before results
      */
     sendToolResult(params: McpUiToolResultNotification["params"]): Promise<void>;
+    /**
+     * Notify the Guest UI that tool execution was cancelled.
+     *
+     * The host MUST send this notification if tool execution was cancelled for any
+     * reason, including user action, sampling error, classifier intervention, or
+     * any other interruption. This allows the Guest UI to update its state and
+     * display appropriate feedback to the user.
+     *
+     * @param params - Optional cancellation details:
+     *   - `reason`: Human-readable explanation for why the tool was cancelled
+     *
+     * @example User-initiated cancellation
+     * ```typescript
+     * // User clicked "Cancel" button
+     * bridge.sendToolCancelled({ reason: "User cancelled the operation" });
+     * ```
+     *
+     * @example System-level cancellation
+     * ```typescript
+     * // Sampling error or timeout
+     * bridge.sendToolCancelled({ reason: "Request timeout after 30 seconds" });
+     *
+     * // Classifier intervention
+     * bridge.sendToolCancelled({ reason: "Content policy violation detected" });
+     * ```
+     *
+     * @see {@link McpUiToolCancelledNotification} for the notification type
+     * @see {@link sendToolResult} for sending successful results
+     * @see {@link sendToolInput} for sending tool arguments
+     */
+    sendToolCancelled(params: McpUiToolCancelledNotification["params"]): Promise<void>;
     /**
      * Send HTML resource to the sandbox proxy for secure loading.
      *
@@ -550,7 +581,7 @@ export declare class AppBridge extends Protocol<Request, Notification, Result> {
      * }
      * ```
      */
-    sendResourceTeardown(params: McpUiResourceTeardownRequest["params"], options?: RequestOptions): Promise<import("./types").McpUiResourceTeardownResult>;
+    sendResourceTeardown(params: McpUiResourceTeardownRequest["params"], options?: RequestOptions): Promise<Record<string, unknown>>;
     private forwardRequest;
     private forwardNotification;
     /**