@mcp-ts/sdk 1.3.10 → 1.5.0

package/dist/index-DcYfpY3H.d.mts

@@ -0,0 +1,295 @@
+import { M as McpConnectionEvent, d as McpObservabilityEvent, e as McpAppsUIEvent } from './events-CK3N--3g.mjs';
+import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from './types-CfCoIsWI.mjs';
+import { AppBridge } from '@modelcontextprotocol/ext-apps/app-bridge';
+import { LoggingMessageNotification } from '@modelcontextprotocol/sdk/types.js';
+
+/**
+ * Stateless RPC-over-stream client for MCP connections.
+ *
+ * Uses single POST requests with `Accept: text/event-stream` for every RPC call.
+ * Progress events and the final rpc-response are delivered in the same response.
+ */
+
+interface SSEClientOptions {
+    /** MCP endpoint URL */
+    url: string;
+    /** User/Client identifier */
+    identity: string;
+    /** Optional auth token for authenticated requests */
+    authToken?: string;
+    /** Callback for MCP connection state changes */
+    onConnectionEvent?: (event: McpConnectionEvent) => void;
+    /** Callback for observability/logging events */
+    onObservabilityEvent?: (event: McpObservabilityEvent) => void;
+    /** Callback for connection status changes */
+    onStatusChange?: (status: ConnectionStatus) => void;
+    /** Callback for MCP App UI events */
+    onEvent?: (event: McpAppsUIEvent) => void;
+    /** Enable debug logging @default false */
+    debug?: boolean;
+}
+type ConnectionStatus = 'connecting' | 'connected' | 'disconnected' | 'error';
+declare class SSEClient {
+    private readonly options;
+    private resourceCache;
+    private connected;
+    constructor(options: SSEClientOptions);
+    connect(): void;
+    disconnect(): void;
+    isConnected(): boolean;
+    getSessions(): Promise<SessionListResult>;
+    connectToServer(params: ConnectParams): Promise<ConnectResult>;
+    disconnectFromServer(sessionId: string): Promise<DisconnectResult>;
+    listTools(sessionId: string): Promise<ListToolsRpcResult>;
+    callTool(sessionId: string, toolName: string, toolArgs: Record<string, unknown>): Promise<unknown>;
+    restoreSession(sessionId: string): Promise<RestoreSessionResult>;
+    finishAuth(sessionId: string, code: string): Promise<FinishAuthResult>;
+    listPrompts(sessionId: string): Promise<ListPromptsResult>;
+    getPrompt(sessionId: string, name: string, args?: Record<string, string>): Promise<unknown>;
+    listResources(sessionId: string): Promise<ListResourcesResult>;
+    readResource(sessionId: string, uri: string): Promise<unknown>;
+    preloadToolUiResources(sessionId: string, tools: Array<{
+        name: string;
+        _meta?: unknown;
+    }>): void;
+    getOrFetchResource(sessionId: string, uri: string): Promise<unknown>;
+    hasPreloadedResource(uri: string): boolean;
+    clearResourceCache(): void;
+    private sendRequest;
+    private readRpcResponseFromStream;
+    private sleep;
+    private parseRpcResponse;
+    private buildUrl;
+    private buildHeaders;
+    private extractUiResourceUri;
+    private emitUiEventIfPresent;
+    private log;
+}
+
+/**
+ * Abstraction layer for the AppHost's network communication.
+ *
+ * This interface decouples the `AppHost` from the concrete networking implementation (like `SSEClient`).
+ * Implementation can be:
+ * 1. `SSEClient`: Direct connection to MCP Server (Browser -> Server).
+ * 2. `ProxyClient`: Connection via an intermediary API (Browser -> Next.js API -> Server).
+ */
+interface AppHostClient {
+    /**
+     * Check if the client is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get list of active sessions
+     */
+    getSessions(): Promise<SessionListResult>;
+    /**
+     * Call a tool on a specific session
+     */
+    callTool(sessionId: string, toolName: string, toolArgs: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Read a resource from a specific session
+     */
+    readResource(sessionId: string, uri: string): Promise<unknown>;
+}
+
+/**
+ * MCP App Host
+ *
+ * Bridges the gap between an iframe (MCP App) and the SSEClient (MCP Server).
+ * Handles secure iframe sandboxing, resource loading, and bi-directional
+ * communication via the AppBridge protocol.
+ *
+ * Key features:
+ * - Secure iframe sandboxing with minimal permissions (proxy-based)
+ * - Resource preloading for instant MCP App UI loading
+ * - Cache-aware resource fetching (SSEClient cache → local cache → direct fetch)
+ * - Support for ui:// and mcp-app:// resource URIs
+ */
+
+type McpUiResourceCsp = Record<string, string>;
+type McpUiHostContext = Record<string, unknown>;
+type OnMessageHandler = NonNullable<AppBridge['onmessage']>;
+type McpUiMessageParams = Parameters<OnMessageHandler>[0];
+type RequestHandlerExtra = Parameters<OnMessageHandler>[1];
+type McpUiMessageResult = ReturnType<OnMessageHandler> extends Promise<infer R> ? R : never;
+type OnOpenLinkHandler = NonNullable<AppBridge['onopenlink']>;
+type McpUiOpenLinkParams = Parameters<OnOpenLinkHandler>[0];
+type McpUiOpenLinkResult = ReturnType<OnOpenLinkHandler> extends Promise<infer R> ? R : never;
+type OnSizeChangeHandler = NonNullable<AppBridge['onsizechange']>;
+type McpUiSizeChangedParams = Parameters<OnSizeChangeHandler>[0];
+type OnRequestDisplayModeHandler = NonNullable<AppBridge['onrequestdisplaymode']>;
+type McpUiRequestDisplayModeParams = Parameters<OnRequestDisplayModeHandler>[0];
+type McpUiRequestDisplayModeResult = ReturnType<OnRequestDisplayModeHandler> extends Promise<infer R> ? R : never;
+interface SandboxConfig {
+    url: URL | string;
+    permissions?: string;
+    csp?: McpUiResourceCsp;
+}
+/**
+ * Default Content-Security-Policy for MCP App iframes.
+ *
+ * Allows inline scripts/styles (required by most MCP App frameworks),
+ * outbound network connections, and common asset sources, while blocking
+ * nested frames and plugin objects.
+ *
+ * Pass this (or a spread of it) as `sandbox.csp` to enforce it:
+ * @example
+ * sandbox={{ url: '/sandbox.html', csp: DEFAULT_MCP_APP_CSP }}
+ * // or to extend:
+ * sandbox={{ url: '/sandbox.html', csp: { ...DEFAULT_MCP_APP_CSP, 'connect-src': "'self' https://api.example.com" } }}
+ */
+declare const DEFAULT_MCP_APP_CSP: McpUiResourceCsp;
+interface AppHostOptions {
+    /** Enable debug logging @default false */
+    debug?: boolean;
+    /** Sandbox proxy configuration */
+    sandbox?: SandboxConfig;
+    /** Host context for theming, viewport, locale */
+    hostContext?: McpUiHostContext;
+    /** Custom handler for call tool requests, overriding automatic client forwarding */
+    onCallTool?: (params: ToolCallParams) => Promise<unknown>;
+    /** Custom handler for resources/read */
+    onReadResource?: (uri: string) => Promise<ResourceResponse>;
+    /** Custom handler for fallback JSON-RPC requests */
+    onFallbackRequest?: (request: any) => Promise<any>;
+    /** Handler for open-link requests from the guest UI */
+    onOpenLink?: (params: McpUiOpenLinkParams, extra: RequestHandlerExtra) => Promise<McpUiOpenLinkResult>;
+    /** Handler for message requests from the guest UI */
+    onMessage?: (params: McpUiMessageParams, extra: RequestHandlerExtra) => Promise<McpUiMessageResult>;
+    /** Handler for logging messages from the guest UI */
+    onLoggingMessage?: (params: LoggingMessageNotification['params']) => void;
+    /** Handler for size change notifications from the guest UI */
+    onSizeChanged?: (params: McpUiSizeChangedParams) => void;
+    /** Callback invoked when an error occurs during setup or message handling */
+    onError?: (error: Error) => void;
+    /** Handler for display mode change requests from the guest UI */
+    onRequestDisplayMode?: (params: McpUiRequestDisplayModeParams, extra: RequestHandlerExtra) => Promise<McpUiRequestDisplayModeResult>;
+}
+interface AppMessageParams {
+    role: string;
+    content: unknown;
+}
+interface ToolCallParams {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
+interface ResourceContent {
+    blob?: string;
+    text?: string;
+}
+interface ResourceResponse {
+    contents: ResourceContent[];
+}
+/**
+ * Host for MCP Apps embedded in iframes.
+ * Manages secure communication between the app and the MCP server.
+ */
+declare class AppHost {
+    private readonly client;
+    private readonly iframe;
+    private bridge;
+    private sessionId?;
+    private resourceCache;
+    private debug;
+    private sandboxConfig?;
+    private options;
+    onAppMessage?: (params: AppMessageParams) => void;
+    constructor(client: AppHostClient | null, iframe: HTMLIFrameElement, options?: AppHostOptions);
+    /**
+     * Start the host. This prepares the bridge handlers but doesn't connect yet.
+     * The actual connection happens in launch() after HTML is loaded.
+     * @returns Promise that resolves immediately (bridge connects during launch)
+     */
+    start(): Promise<void>;
+    /**
+     * Preload UI resources to enable instant app loading.
+     * Call this when tools are discovered to cache their UI resources.
+     */
+    preload(tools: Array<{
+        _meta?: unknown;
+    }>): void;
+    /**
+     * Launch an MCP App from a URL, MCP resource URI, or RAW HTML.
+     * Loads the HTML first, then establishes bridge connection.
+     */
+    launch(source: {
+        uri?: string;
+        html?: string;
+    }, sessionId?: string): Promise<void>;
+    setHostContext(context: McpUiHostContext): void;
+    sendToolInputPartial(params: any): void;
+    /**
+     * Wait for app to signal initialization complete
+     */
+    private onAppReady;
+    /**
+     * Wait for iframe to finish loading
+     */
+    private onIframeReady;
+    /**
+     * Send tool input arguments to the MCP App.
+     * Call this after launch() when tool input is available.
+     */
+    sendToolInput(args: Record<string, unknown>): void;
+    /**
+     * Send tool result to the MCP App.
+     * Call this when the tool call completes.
+     */
+    sendToolResult(result: unknown): void;
+    /**
+     * Send tool cancellation to the MCP App.
+     * Call this when the tool call is cancelled or fails.
+     */
+    sendToolCancelled(reason: string): void;
+    /**
+     * Tell the guest UI the resource is being torn down (unload / cleanup).
+     * Forwards to {@link AppBridge.teardownResource} on `@modelcontextprotocol/ext-apps/app-bridge`.
+     */
+    teardownResource(params?: Record<string, unknown>): void;
+    private initializeBridge;
+    private connectBridge;
+    private handleToolCall;
+    private handleOpenLink;
+    private handleMessage;
+    private launchSandboxedHtml;
+    private readMcpAppHtml;
+    private fetchResourceWithCache;
+    private preloadResource;
+    private getSessionId;
+    private isMcpUri;
+    private hasClientCache;
+    private extractUiResourceUri;
+    private decodeContent;
+    private log;
+}
+
+/**
+ * Default configuration values for the App Host.
+ *
+ * `SANDBOX_*_READY_METHOD` match `@modelcontextprotocol/ext-apps` (see
+ * https://github.com/modelcontextprotocol/ext-apps/blob/main/src/types.ts ).
+ * Duplicated here because the package root `app.d.ts` often omits these value exports under
+ * `moduleResolution: "NodeNext"`.
+ */
+declare const SANDBOX_PROXY_READY_METHOD: "ui/notifications/sandbox-proxy-ready";
+declare const SANDBOX_RESOURCE_READY_METHOD: "ui/notifications/sandbox-resource-ready";
+declare const APP_HOST_DEFAULTS: {
+    /** Default timeout for waiting for the sandbox proxy to be ready (ms). */
+    readonly SANDBOX_TIMEOUT_MS: 10000;
+    /** Default host info reported to guest apps. */
+    readonly HOST_INFO: {
+        readonly name: "mcp-ts-host";
+        readonly version: "1.0.0";
+    };
+    /** Supported MCP App URI schemes. */
+    readonly URI_SCHEMES: readonly ["ui://", "mcp-app://"];
+    /** Default theme for the host context. */
+    readonly THEME: "dark";
+    /** Default platform for the host context. */
+    readonly PLATFORM: "web";
+    /** Default max height for the iframe container (px). */
+    readonly MAX_HEIGHT: 6000;
+};
+
+export { APP_HOST_DEFAULTS as A, DEFAULT_MCP_APP_CSP as D, SANDBOX_PROXY_READY_METHOD as S, AppHost as a, SANDBOX_RESOURCE_READY_METHOD as b, SSEClient as c, type SSEClientOptions as d, type AppHostOptions as e, type AppHostClient as f };

package/dist/index-GfC_eNEv.d.ts

@@ -0,0 +1,295 @@
+import { M as McpConnectionEvent, d as McpObservabilityEvent, e as McpAppsUIEvent } from './events-CK3N--3g.js';
+import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from './types-CfCoIsWI.js';
+import { AppBridge } from '@modelcontextprotocol/ext-apps/app-bridge';
+import { LoggingMessageNotification } from '@modelcontextprotocol/sdk/types.js';
+
+/**
+ * Stateless RPC-over-stream client for MCP connections.
+ *
+ * Uses single POST requests with `Accept: text/event-stream` for every RPC call.
+ * Progress events and the final rpc-response are delivered in the same response.
+ */
+
+interface SSEClientOptions {
+    /** MCP endpoint URL */
+    url: string;
+    /** User/Client identifier */
+    identity: string;
+    /** Optional auth token for authenticated requests */
+    authToken?: string;
+    /** Callback for MCP connection state changes */
+    onConnectionEvent?: (event: McpConnectionEvent) => void;
+    /** Callback for observability/logging events */
+    onObservabilityEvent?: (event: McpObservabilityEvent) => void;
+    /** Callback for connection status changes */
+    onStatusChange?: (status: ConnectionStatus) => void;
+    /** Callback for MCP App UI events */
+    onEvent?: (event: McpAppsUIEvent) => void;
+    /** Enable debug logging @default false */
+    debug?: boolean;
+}
+type ConnectionStatus = 'connecting' | 'connected' | 'disconnected' | 'error';
+declare class SSEClient {
+    private readonly options;
+    private resourceCache;
+    private connected;
+    constructor(options: SSEClientOptions);
+    connect(): void;
+    disconnect(): void;
+    isConnected(): boolean;
+    getSessions(): Promise<SessionListResult>;
+    connectToServer(params: ConnectParams): Promise<ConnectResult>;
+    disconnectFromServer(sessionId: string): Promise<DisconnectResult>;
+    listTools(sessionId: string): Promise<ListToolsRpcResult>;
+    callTool(sessionId: string, toolName: string, toolArgs: Record<string, unknown>): Promise<unknown>;
+    restoreSession(sessionId: string): Promise<RestoreSessionResult>;
+    finishAuth(sessionId: string, code: string): Promise<FinishAuthResult>;
+    listPrompts(sessionId: string): Promise<ListPromptsResult>;
+    getPrompt(sessionId: string, name: string, args?: Record<string, string>): Promise<unknown>;
+    listResources(sessionId: string): Promise<ListResourcesResult>;
+    readResource(sessionId: string, uri: string): Promise<unknown>;
+    preloadToolUiResources(sessionId: string, tools: Array<{
+        name: string;
+        _meta?: unknown;
+    }>): void;
+    getOrFetchResource(sessionId: string, uri: string): Promise<unknown>;
+    hasPreloadedResource(uri: string): boolean;
+    clearResourceCache(): void;
+    private sendRequest;
+    private readRpcResponseFromStream;
+    private sleep;
+    private parseRpcResponse;
+    private buildUrl;
+    private buildHeaders;
+    private extractUiResourceUri;
+    private emitUiEventIfPresent;
+    private log;
+}
+
+/**
+ * Abstraction layer for the AppHost's network communication.
+ *
+ * This interface decouples the `AppHost` from the concrete networking implementation (like `SSEClient`).
+ * Implementation can be:
+ * 1. `SSEClient`: Direct connection to MCP Server (Browser -> Server).
+ * 2. `ProxyClient`: Connection via an intermediary API (Browser -> Next.js API -> Server).
+ */
+interface AppHostClient {
+    /**
+     * Check if the client is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get list of active sessions
+     */
+    getSessions(): Promise<SessionListResult>;
+    /**
+     * Call a tool on a specific session
+     */
+    callTool(sessionId: string, toolName: string, toolArgs: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Read a resource from a specific session
+     */
+    readResource(sessionId: string, uri: string): Promise<unknown>;
+}
+
+/**
+ * MCP App Host
+ *
+ * Bridges the gap between an iframe (MCP App) and the SSEClient (MCP Server).
+ * Handles secure iframe sandboxing, resource loading, and bi-directional
+ * communication via the AppBridge protocol.
+ *
+ * Key features:
+ * - Secure iframe sandboxing with minimal permissions (proxy-based)
+ * - Resource preloading for instant MCP App UI loading
+ * - Cache-aware resource fetching (SSEClient cache → local cache → direct fetch)
+ * - Support for ui:// and mcp-app:// resource URIs
+ */
+
+type McpUiResourceCsp = Record<string, string>;
+type McpUiHostContext = Record<string, unknown>;
+type OnMessageHandler = NonNullable<AppBridge['onmessage']>;
+type McpUiMessageParams = Parameters<OnMessageHandler>[0];
+type RequestHandlerExtra = Parameters<OnMessageHandler>[1];
+type McpUiMessageResult = ReturnType<OnMessageHandler> extends Promise<infer R> ? R : never;
+type OnOpenLinkHandler = NonNullable<AppBridge['onopenlink']>;
+type McpUiOpenLinkParams = Parameters<OnOpenLinkHandler>[0];
+type McpUiOpenLinkResult = ReturnType<OnOpenLinkHandler> extends Promise<infer R> ? R : never;
+type OnSizeChangeHandler = NonNullable<AppBridge['onsizechange']>;
+type McpUiSizeChangedParams = Parameters<OnSizeChangeHandler>[0];
+type OnRequestDisplayModeHandler = NonNullable<AppBridge['onrequestdisplaymode']>;
+type McpUiRequestDisplayModeParams = Parameters<OnRequestDisplayModeHandler>[0];
+type McpUiRequestDisplayModeResult = ReturnType<OnRequestDisplayModeHandler> extends Promise<infer R> ? R : never;
+interface SandboxConfig {
+    url: URL | string;
+    permissions?: string;
+    csp?: McpUiResourceCsp;
+}
+/**
+ * Default Content-Security-Policy for MCP App iframes.
+ *
+ * Allows inline scripts/styles (required by most MCP App frameworks),
+ * outbound network connections, and common asset sources, while blocking
+ * nested frames and plugin objects.
+ *
+ * Pass this (or a spread of it) as `sandbox.csp` to enforce it:
+ * @example
+ * sandbox={{ url: '/sandbox.html', csp: DEFAULT_MCP_APP_CSP }}
+ * // or to extend:
+ * sandbox={{ url: '/sandbox.html', csp: { ...DEFAULT_MCP_APP_CSP, 'connect-src': "'self' https://api.example.com" } }}
+ */
+declare const DEFAULT_MCP_APP_CSP: McpUiResourceCsp;
+interface AppHostOptions {
+    /** Enable debug logging @default false */
+    debug?: boolean;
+    /** Sandbox proxy configuration */
+    sandbox?: SandboxConfig;
+    /** Host context for theming, viewport, locale */
+    hostContext?: McpUiHostContext;
+    /** Custom handler for call tool requests, overriding automatic client forwarding */
+    onCallTool?: (params: ToolCallParams) => Promise<unknown>;
+    /** Custom handler for resources/read */
+    onReadResource?: (uri: string) => Promise<ResourceResponse>;
+    /** Custom handler for fallback JSON-RPC requests */
+    onFallbackRequest?: (request: any) => Promise<any>;
+    /** Handler for open-link requests from the guest UI */
+    onOpenLink?: (params: McpUiOpenLinkParams, extra: RequestHandlerExtra) => Promise<McpUiOpenLinkResult>;
+    /** Handler for message requests from the guest UI */
+    onMessage?: (params: McpUiMessageParams, extra: RequestHandlerExtra) => Promise<McpUiMessageResult>;
+    /** Handler for logging messages from the guest UI */
+    onLoggingMessage?: (params: LoggingMessageNotification['params']) => void;
+    /** Handler for size change notifications from the guest UI */
+    onSizeChanged?: (params: McpUiSizeChangedParams) => void;
+    /** Callback invoked when an error occurs during setup or message handling */
+    onError?: (error: Error) => void;
+    /** Handler for display mode change requests from the guest UI */
+    onRequestDisplayMode?: (params: McpUiRequestDisplayModeParams, extra: RequestHandlerExtra) => Promise<McpUiRequestDisplayModeResult>;
+}
+interface AppMessageParams {
+    role: string;
+    content: unknown;
+}
+interface ToolCallParams {
+    name: string;
+    arguments?: Record<string, unknown>;
+}
+interface ResourceContent {
+    blob?: string;
+    text?: string;
+}
+interface ResourceResponse {
+    contents: ResourceContent[];
+}
+/**
+ * Host for MCP Apps embedded in iframes.
+ * Manages secure communication between the app and the MCP server.
+ */
+declare class AppHost {
+    private readonly client;
+    private readonly iframe;
+    private bridge;
+    private sessionId?;
+    private resourceCache;
+    private debug;
+    private sandboxConfig?;
+    private options;
+    onAppMessage?: (params: AppMessageParams) => void;
+    constructor(client: AppHostClient | null, iframe: HTMLIFrameElement, options?: AppHostOptions);
+    /**
+     * Start the host. This prepares the bridge handlers but doesn't connect yet.
+     * The actual connection happens in launch() after HTML is loaded.
+     * @returns Promise that resolves immediately (bridge connects during launch)
+     */
+    start(): Promise<void>;
+    /**
+     * Preload UI resources to enable instant app loading.
+     * Call this when tools are discovered to cache their UI resources.
+     */
+    preload(tools: Array<{
+        _meta?: unknown;
+    }>): void;
+    /**
+     * Launch an MCP App from a URL, MCP resource URI, or RAW HTML.
+     * Loads the HTML first, then establishes bridge connection.
+     */
+    launch(source: {
+        uri?: string;
+        html?: string;
+    }, sessionId?: string): Promise<void>;
+    setHostContext(context: McpUiHostContext): void;
+    sendToolInputPartial(params: any): void;
+    /**
+     * Wait for app to signal initialization complete
+     */
+    private onAppReady;
+    /**
+     * Wait for iframe to finish loading
+     */
+    private onIframeReady;
+    /**
+     * Send tool input arguments to the MCP App.
+     * Call this after launch() when tool input is available.
+     */
+    sendToolInput(args: Record<string, unknown>): void;
+    /**
+     * Send tool result to the MCP App.
+     * Call this when the tool call completes.
+     */
+    sendToolResult(result: unknown): void;
+    /**
+     * Send tool cancellation to the MCP App.
+     * Call this when the tool call is cancelled or fails.
+     */
+    sendToolCancelled(reason: string): void;
+    /**
+     * Tell the guest UI the resource is being torn down (unload / cleanup).
+     * Forwards to {@link AppBridge.teardownResource} on `@modelcontextprotocol/ext-apps/app-bridge`.
+     */
+    teardownResource(params?: Record<string, unknown>): void;
+    private initializeBridge;
+    private connectBridge;
+    private handleToolCall;
+    private handleOpenLink;
+    private handleMessage;
+    private launchSandboxedHtml;
+    private readMcpAppHtml;
+    private fetchResourceWithCache;
+    private preloadResource;
+    private getSessionId;
+    private isMcpUri;
+    private hasClientCache;
+    private extractUiResourceUri;
+    private decodeContent;
+    private log;
+}
+
+/**
+ * Default configuration values for the App Host.
+ *
+ * `SANDBOX_*_READY_METHOD` match `@modelcontextprotocol/ext-apps` (see
+ * https://github.com/modelcontextprotocol/ext-apps/blob/main/src/types.ts ).
+ * Duplicated here because the package root `app.d.ts` often omits these value exports under
+ * `moduleResolution: "NodeNext"`.
+ */
+declare const SANDBOX_PROXY_READY_METHOD: "ui/notifications/sandbox-proxy-ready";
+declare const SANDBOX_RESOURCE_READY_METHOD: "ui/notifications/sandbox-resource-ready";
+declare const APP_HOST_DEFAULTS: {
+    /** Default timeout for waiting for the sandbox proxy to be ready (ms). */
+    readonly SANDBOX_TIMEOUT_MS: 10000;
+    /** Default host info reported to guest apps. */
+    readonly HOST_INFO: {
+        readonly name: "mcp-ts-host";
+        readonly version: "1.0.0";
+    };
+    /** Supported MCP App URI schemes. */
+    readonly URI_SCHEMES: readonly ["ui://", "mcp-app://"];
+    /** Default theme for the host context. */
+    readonly THEME: "dark";
+    /** Default platform for the host context. */
+    readonly PLATFORM: "web";
+    /** Default max height for the iframe container (px). */
+    readonly MAX_HEIGHT: 6000;
+};
+
+export { APP_HOST_DEFAULTS as A, DEFAULT_MCP_APP_CSP as D, SANDBOX_PROXY_READY_METHOD as S, AppHost as a, SANDBOX_RESOURCE_READY_METHOD as b, SSEClient as c, type SSEClientOptions as d, type AppHostOptions as e, type AppHostClient as f };

package/dist/index.d.mts

@@ -2,9 +2,11 @@ export { M as MCPClient, a as MultiSessionClient, S as StorageOAuthClientProvide
 export { A as AuthenticationError, C as ConfigurationError, a as ConnectionError, I as InvalidStateError, M as McpError, N as NotConnectedError, R as RpcErrorCode, b as RpcErrorCodes, S as SessionNotFoundError, c as SessionValidationError, T as ToolExecutionError, U as UnauthorizedError, s as sanitizeServerLabel } from './utils-0qmYrqoa.mjs';
 export { ClientMetadata, NextMcpHandlerOptions, SSEConnectionManager, SSEHandlerOptions, StorageBackend, createNextMcpHandler, createSSEHandler, storage } from './server/index.mjs';
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from './events-CK3N--3g.mjs';
-export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, L as ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolInfo, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from './types-CW6lghof.mjs';
+export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, L as ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, v as ToolInfo, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from './types-CfCoIsWI.mjs';
 export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
 export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
-export { AppHost, SSEClient, SSEClientOptions } from './client/index.mjs';
-export { DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolUiConfig, findToolByName, getToolUiResourceUri } from './shared/index.mjs';
+export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, c as SSEClient, d as SSEClientOptions } from './index-DcYfpY3H.mjs';
+export { CallToolFn, DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolUiConfig, createExecuteToolDefinition, createGetSchemaToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isMetaTool, resolveMetaToolProxy } from './shared/index.mjs';
+export { C as CompactTool, a as CompressionStats, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, b as ToolIndex, c as ToolIndexOptions, d as ToolRouter, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSummary } from './tool-router-XnWVxPzv.mjs';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/ext-apps/app-bridge';

package/dist/index.d.ts

@@ -2,9 +2,11 @@ export { M as MCPClient, a as MultiSessionClient, S as StorageOAuthClientProvide
 export { A as AuthenticationError, C as ConfigurationError, a as ConnectionError, I as InvalidStateError, M as McpError, N as NotConnectedError, R as RpcErrorCode, b as RpcErrorCodes, S as SessionNotFoundError, c as SessionValidationError, T as ToolExecutionError, U as UnauthorizedError, s as sanitizeServerLabel } from './utils-0qmYrqoa.js';
 export { ClientMetadata, NextMcpHandlerOptions, SSEConnectionManager, SSEHandlerOptions, StorageBackend, createNextMcpHandler, createSSEHandler, storage } from './server/index.js';
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from './events-CK3N--3g.js';
-export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, L as ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolInfo, u as TransportType, v as isCallToolSuccess, w as isConnectAuthRequired, x as isConnectError, y as isConnectSuccess, z as isListToolsSuccess } from './types-CW6lghof.js';
+export { C as CallToolParams, a as CallToolRequest, b as CallToolResponse, c as ConnectAuthRequiredResponse, d as ConnectErrorResponse, e as ConnectParams, f as ConnectRequest, g as ConnectResponse, h as ConnectResult, i as ConnectSuccessResponse, D as DisconnectParams, j as DisconnectResult, F as FinishAuthParams, k as FinishAuthResult, G as GetPromptParams, L as ListPromptsResult, l as ListResourcesResult, m as ListToolsResponse, n as ListToolsRpcResult, M as McpRpcMethod, o as McpRpcParams, p as McpRpcRequest, q as McpRpcResponse, R as ReadResourceParams, r as RestoreSessionResult, S as SessionInfo, s as SessionListResult, t as SessionParams, T as ToolClient, u as ToolClientProvider, v as ToolInfo, w as TransportType, x as isCallToolSuccess, y as isConnectAuthRequired, z as isConnectError, A as isConnectSuccess, B as isListToolsSuccess } from './types-CfCoIsWI.js';
 export { OAuthClientInformation, OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
 export { CallToolResult, ListToolsResult, Tool } from '@modelcontextprotocol/sdk/types.js';
-export { AppHost, SSEClient, SSEClientOptions } from './client/index.js';
-export { DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolUiConfig, findToolByName, getToolUiResourceUri } from './shared/index.js';
+export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, c as SSEClient, d as SSEClientOptions } from './index-GfC_eNEv.js';
+export { CallToolFn, DEFAULT_CLIENT_NAME, DEFAULT_CLIENT_URI, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_LOGO_URI, DEFAULT_POLICY_URI, MCP_CLIENT_NAME, MCP_CLIENT_VERSION, REDIS_KEY_PREFIX, SESSION_TTL_SECONDS, SOFTWARE_ID, SOFTWARE_VERSION, STATE_EXPIRATION_MS, TOKEN_EXPIRY_BUFFER_MS, ToolUiConfig, createExecuteToolDefinition, createGetSchemaToolDefinition, createRegexSearchToolDefinition, createSearchToolDefinition, executeMetaTool, findToolByName, getToolUiResourceUri, isMetaTool, resolveMetaToolProxy } from './shared/index.js';
+export { C as CompactTool, a as CompressionStats, E as EmbedFn, I as IndexedTool, S as SchemaCompressor, T as ToolGroupInfo, b as ToolIndex, c as ToolIndexOptions, d as ToolRouter, e as ToolRouterClientInput, f as ToolRouterOptions, g as ToolRouterStrategy, h as ToolSummary } from './tool-router-Bo8qZbsD.js';
 import '@modelcontextprotocol/sdk/client/auth.js';
+import '@modelcontextprotocol/ext-apps/app-bridge';