@modelcontextprotocol/ext-apps 0.3.1 → 0.4.0

package/dist/src/app.d.ts

@@ -1,7 +1,7 @@
 import { type RequestOptions, Protocol, ProtocolOptions } from "@modelcontextprotocol/sdk/shared/protocol.js";
 import { CallToolRequest, CallToolResult, Implementation, ListToolsRequest, LoggingMessageNotification } from "@modelcontextprotocol/sdk/types.js";
 import { AppNotification, AppRequest, AppResult } from "./types";
-import { McpUiAppCapabilities, McpUiHostCapabilities, McpUiHostContext, McpUiHostContextChangedNotification, McpUiMessageRequest, McpUiOpenLinkRequest, McpUiResourceTeardownRequest, McpUiResourceTeardownResult, McpUiSizeChangedNotification, McpUiToolCancelledNotification, McpUiToolInputNotification, McpUiToolInputPartialNotification, McpUiToolResultNotification, McpUiRequestDisplayModeRequest } from "./types";
+import { McpUiAppCapabilities, McpUiUpdateModelContextRequest, McpUiHostCapabilities, McpUiHostContext, McpUiHostContextChangedNotification, McpUiMessageRequest, McpUiOpenLinkRequest, McpUiResourceTeardownRequest, McpUiResourceTeardownResult, McpUiSizeChangedNotification, McpUiToolCancelledNotification, McpUiToolInputNotification, McpUiToolInputPartialNotification, McpUiToolResultNotification, McpUiRequestDisplayModeRequest } from "./types";
 import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 export { PostMessageTransport } from "./message-transport";
 export * from "./types";
@@ -608,6 +608,47 @@ export declare class App extends Protocol<AppRequest, AppNotification, AppResult
      * @returns Promise that resolves when the log notification is sent
      */
     sendLog(params: LoggingMessageNotification["params"]): Promise<void>;
+    /**
+     * Update the host's model context with app state.
+     *
+     * Unlike `sendLog`, which is for debugging/telemetry, context updates
+     * are intended to be available to the model in future reasoning,
+     * without requiring a follow-up action (like `sendMessage`).
+     *
+     * The host will typically defer sending the context to the model until the
+     * next user message (including `ui/message`), and will only send the last
+     * update received. Each call overwrites any previous context update.
+     *
+     * @param params - Context content and/or structured content
+     * @param options - Request options (timeout, etc.)
+     *
+     * @throws {Error} If the host rejects the context update (e.g., unsupported content type)
+     *
+     * @example Update model context with current app state
+     * ```typescript
+     * await app.updateModelContext({
+     *   content: [{ type: "text", text: "User selected 3 items totaling $150.00" }]
+     * });
+     * ```
+     *
+     * @example Update with structured content
+     * ```typescript
+     * await app.updateModelContext({
+     *   structuredContent: { selectedItems: 3, total: 150.00, currency: "USD" }
+     * });
+     * ```
+     *
+     * @returns Promise that resolves when the context update is acknowledged
+     */
+    updateModelContext(params: McpUiUpdateModelContextRequest["params"], options?: RequestOptions): Promise<{
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    }>;
     /**
      * Request the host to open an external URL in the default browser.
      *