@modelcontextprotocol/ext-apps 0.0.7 → 0.2.0

package/dist/src/types.d.ts

@@ -1,849 +1,41 @@
-import { CallToolResult, ContentBlock, Implementation, RequestId, Tool } from "@modelcontextprotocol/sdk/types.js";
-import { z } from "zod/v4";
 /**
- * Current protocol version supported by this SDK.
+ * MCP Apps Protocol Types and Schemas
  *
- * The SDK automatically handles version negotiation during initialization.
- * Apps and hosts don't need to manage protocol versions manually.
- */
-export declare const LATEST_PROTOCOL_VERSION = "2025-11-21";
-/**
- * Color theme preference for the host environment.
- * @see {@link McpUiHostContext.theme}
- */
-export type McpUiTheme = "light" | "dark";
-/** Runtime validation schema for {@link McpUiTheme}. */
-export declare const McpUiThemeSchema: z.ZodEnum<{
-    light: "light";
-    dark: "dark";
-}>;
-/**
- * Display mode for UI presentation.
- * - `inline`: Embedded within the conversation flow
- * - `fullscreen`: Expanded to fill the available viewport
- * - `pip`: Picture-in-picture floating window
- *
- * @see {@link McpUiHostContext.displayMode}
- */
-export type McpUiDisplayMode = "inline" | "fullscreen" | "pip";
-/** Runtime validation schema for {@link McpUiDisplayMode}. */
-export declare const McpUiDisplayModeSchema: z.ZodEnum<{
-    inline: "inline";
-    fullscreen: "fullscreen";
-    pip: "pip";
-}>;
-/**
- * Request to open an external URL in the host's default browser.
- *
- * Sent from the Guest UI to the Host when requesting to open an external link.
- * The host may deny the request based on user preferences or security policy.
- *
- * @see {@link app.App.sendOpenLink} for the method that sends this request
- */
-export interface McpUiOpenLinkRequest {
-    method: "ui/open-link";
-    params: {
-        /** URL to open in the host's browser */
-        url: string;
-    };
-}
-/**
- * Runtime validation schema for {@link McpUiOpenLinkRequest}.
- * @internal
- */
-export declare const McpUiOpenLinkRequestSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/open-link">;
-    params: z.ZodObject<{
-        url: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-/**
- * Result from a {@link McpUiOpenLinkRequest}.
- *
- * The host returns this result after attempting to open the requested URL.
- *
- * @see {@link McpUiOpenLinkRequest}
- */
-export interface McpUiOpenLinkResult {
-    /**
-     * True if the host failed to open the URL (e.g., due to security policy,
-     * user cancellation, or system error). False or undefined indicates success.
-     */
-    isError?: boolean;
-    /**
-     * Index signature required for MCP SDK `Protocol` class compatibility.
-     * Note: The schema intentionally omits this to enforce strict validation.
-     */
-    [key: string]: unknown;
-}
-/**
- * Runtime validation schema for {@link McpUiOpenLinkResult}.
- * @internal
- */
-export declare const McpUiOpenLinkResultSchema: z.ZodType<McpUiOpenLinkResult>;
-/**
- * Request to send a message to the host's chat interface.
- *
- * Sent from the Guest UI to the Host when the app wants to add a message to the
- * conversation thread. This enables interactive apps to communicate with the user
- * through the host's chat interface.
- *
- * @see {@link app.App.sendMessage} for the method that sends this request
- */
-export interface McpUiMessageRequest {
-    method: "ui/message";
-    params: {
-        /** Message role, currently only "user" is supported */
-        role: "user";
-        /** Message content blocks (text, image, etc.) */
-        content: ContentBlock[];
-    };
-}
-/**
- * Runtime validation schema for {@link McpUiMessageRequest}.
- * @internal
- */
-export declare const McpUiMessageRequestSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/message">;
-    params: z.ZodObject<{
-        role: z.ZodLiteral<"user">;
-        content: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-            type: z.ZodLiteral<"text">;
-            text: z.ZodString;
-            annotations: z.ZodOptional<z.ZodObject<{
-                audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
-                    assistant: "assistant";
-                }>>>;
-                priority: z.ZodOptional<z.ZodNumber>;
-                lastModified: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strip>>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"image">;
-            data: z.ZodString;
-            mimeType: z.ZodString;
-            annotations: z.ZodOptional<z.ZodObject<{
-                audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
-                    assistant: "assistant";
-                }>>>;
-                priority: z.ZodOptional<z.ZodNumber>;
-                lastModified: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strip>>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"audio">;
-            data: z.ZodString;
-            mimeType: z.ZodString;
-            annotations: z.ZodOptional<z.ZodObject<{
-                audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
-                    assistant: "assistant";
-                }>>>;
-                priority: z.ZodOptional<z.ZodNumber>;
-                lastModified: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strip>>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            uri: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-            mimeType: z.ZodOptional<z.ZodString>;
-            annotations: z.ZodOptional<z.ZodObject<{
-                audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
-                    assistant: "assistant";
-                }>>>;
-                priority: z.ZodOptional<z.ZodNumber>;
-                lastModified: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strip>>;
-            _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
-            icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                src: z.ZodString;
-                mimeType: z.ZodOptional<z.ZodString>;
-                sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            }, z.core.$strip>>>;
-            name: z.ZodString;
-            title: z.ZodOptional<z.ZodString>;
-            type: z.ZodLiteral<"resource_link">;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"resource">;
-            resource: z.ZodUnion<readonly [z.ZodObject<{
-                uri: z.ZodString;
-                mimeType: z.ZodOptional<z.ZodString>;
-                _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-                text: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                uri: z.ZodString;
-                mimeType: z.ZodOptional<z.ZodString>;
-                _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-                blob: z.ZodString;
-            }, z.core.$strip>]>;
-            annotations: z.ZodOptional<z.ZodObject<{
-                audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
-                    assistant: "assistant";
-                }>>>;
-                priority: z.ZodOptional<z.ZodNumber>;
-                lastModified: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strip>>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>]>>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-/**
- * Result from a {@link McpUiMessageRequest}.
- *
- * Note: The host does not return message content or follow-up results to prevent
- * leaking information from the conversation. Only error status is provided.
- *
- * @see {@link McpUiMessageRequest}
- */
-export interface McpUiMessageResult {
-    /**
-     * True if the host rejected or failed to deliver the message (e.g., due to
-     * rate limiting, content policy, or system error). False or undefined
-     * indicates the message was accepted.
-     */
-    isError?: boolean;
-    /**
-     * Index signature required for MCP SDK `Protocol` class compatibility.
-     * Note: The schema intentionally omits this to enforce strict validation.
-     */
-    [key: string]: unknown;
-}
-/**
- * Runtime validation schema for {@link McpUiMessageResult}.
- * @internal
- */
-export declare const McpUiMessageResultSchema: z.ZodType<McpUiMessageResult>;
-/**
- * Notification that the sandbox proxy iframe is ready to receive content.
- *
- * This is an internal message used by web-based hosts implementing the
- * double-iframe sandbox architecture. The sandbox proxy sends this to the host
- * after it loads and is ready to receive HTML content via
- * {@link McpUiSandboxResourceReadyNotification}.
- *
- * @internal
- * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx#sandbox-proxy
- */
-export interface McpUiSandboxProxyReadyNotification {
-    method: "ui/notifications/sandbox-proxy-ready";
-    params: {};
-}
-/**
- * Runtime validation schema for {@link McpUiSandboxProxyReadyNotification}.
- * @internal
- */
-export declare const McpUiSandboxProxyReadyNotificationSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/notifications/sandbox-proxy-ready">;
-    params: z.ZodObject<{}, z.core.$strip>;
-}, z.core.$strip>;
-/**
- * Notification containing HTML resource for the sandbox proxy to load.
- *
- * This is an internal message used by web-based hosts implementing the
- * double-iframe sandbox architecture. After the sandbox proxy signals readiness,
- * the host sends this notification with the HTML content and optional sandbox
- * attributes to load into the inner iframe.
- *
- * @internal
- * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx#sandbox-proxy
- */
-export interface McpUiSandboxResourceReadyNotification {
-    method: "ui/notifications/sandbox-resource-ready";
-    params: {
-        /** HTML content to load into the inner iframe */
-        html: string;
-        /** Optional override for the inner iframe's sandbox attribute */
-        sandbox?: string;
-        /** CSP configuration from resource metadata */
-        csp?: {
-            /** Origins for network requests (fetch/XHR/WebSocket) */
-            connectDomains?: string[];
-            /** Origins for static resources (scripts, images, styles, fonts) */
-            resourceDomains?: string[];
-        };
-    };
-}
-/**
- * Runtime validation schema for {@link McpUiSandboxResourceReadyNotification}.
- * @internal
- */
-export declare const McpUiSandboxResourceReadyNotificationSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/notifications/sandbox-resource-ready">;
-    params: z.ZodObject<{
-        html: z.ZodString;
-        sandbox: z.ZodOptional<z.ZodString>;
-        csp: z.ZodOptional<z.ZodObject<{
-            connectDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            resourceDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-/**
- * Notification of UI size changes (bidirectional: Guest ↔ Host).
- *
- * **Guest UI → Host**: Sent by the Guest UI when its rendered content size changes,
- * typically using ResizeObserver. This helps the host adjust the iframe container.
- * If {@link app.App} is configured with `autoResize: true` (default), this is sent
- * automatically.
- *
- * **Host → Guest UI**: Sent by the Host when the viewport size changes (e.g.,
- * window resize, orientation change). This allows the Guest UI to adjust its layout.
- *
- * @see {@link app.App.sendSizeChanged} for the method to send this from Guest UI
- * @see {@link app.App.setupSizeChangedNotifications} for automatic size reporting
- */
-export interface McpUiSizeChangedNotification {
-    method: "ui/notifications/size-changed";
-    params: {
-        /** New width in pixels */
-        width?: number;
-        /** New height in pixels */
-        height?: number;
-    };
-}
-/**
- * Runtime validation schema for {@link McpUiSizeChangedNotification}.
- * @internal
- */
-export declare const McpUiSizeChangedNotificationSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/notifications/size-changed">;
-    params: z.ZodObject<{
-        width: z.ZodOptional<z.ZodNumber>;
-        height: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-/**
- * Notification containing complete tool arguments (Host → Guest UI).
- *
- * The host MUST send this notification after the Guest UI's initialize request
- * completes, when complete tool arguments become available. This notification is
- * sent exactly once and is required before {@link McpUiToolResultNotification}.
- *
- * The arguments object contains the complete tool call parameters that triggered
- * this App instance.
- */
-export interface McpUiToolInputNotification {
-    method: "ui/notifications/tool-input";
-    params: {
-        /** Complete tool call arguments as key-value pairs */
-        arguments?: Record<string, unknown>;
-    };
-}
-/**
- * Runtime validation schema for {@link McpUiToolInputNotification}.
- * @internal
- */
-export declare const McpUiToolInputNotificationSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/notifications/tool-input">;
-    params: z.ZodObject<{
-        arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-/**
- * Notification containing partial/streaming tool arguments (Host → Guest UI).
- *
- * The host MAY send this notification zero or more times while the agent is
- * streaming tool arguments, before {@link McpUiToolInputNotification} is sent
- * with complete arguments.
- *
- * The arguments object represents best-effort recovery of incomplete JSON, with
- * unclosed structures automatically closed to produce valid JSON. Guest UIs may
- * ignore these notifications or use them to render progressive loading states.
- *
- * Guest UIs MUST NOT rely on partial arguments for critical operations and SHOULD
- * gracefully handle missing or changing fields between notifications.
- */
-export interface McpUiToolInputPartialNotification {
-    method: "ui/notifications/tool-input-partial";
-    params: {
-        /** Partial tool call arguments (incomplete, may change) */
-        arguments?: Record<string, unknown>;
-    };
-}
-/**
- * Runtime validation schema for {@link McpUiToolInputPartialNotification}.
- * @internal
- */
-export declare const McpUiToolInputPartialNotificationSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/notifications/tool-input-partial">;
-    params: z.ZodObject<{
-        arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-/**
- * Notification containing tool execution result (Host → Guest UI).
- *
- * The host MUST send this notification when tool execution completes successfully,
- * provided the UI is still displayed. If the UI was closed before execution
- * completes, the host MAY skip this notification. This notification is sent after
- * {@link McpUiToolInputNotification}.
- *
- * The result follows the standard MCP CallToolResult format, containing content
- * for the model and optionally structuredContent optimized for UI rendering.
- */
-export interface McpUiToolResultNotification {
-    method: "ui/notifications/tool-result";
-    /** Standard MCP tool execution result */
-    params: CallToolResult;
-}
-/**
- * Runtime validation schema for {@link McpUiToolResultNotification}.
- * @internal
- */
-export declare const McpUiToolResultNotificationSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/notifications/tool-result">;
-    params: z.ZodObject<{
-        _meta: z.ZodOptional<z.ZodObject<{
-            "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
-                taskId: z.ZodString;
-            }, z.core.$loose>>;
-        }, z.core.$loose>>;
-        content: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-            type: z.ZodLiteral<"text">;
-            text: z.ZodString;
-            annotations: z.ZodOptional<z.ZodObject<{
-                audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
-                    assistant: "assistant";
-                }>>>;
-                priority: z.ZodOptional<z.ZodNumber>;
-                lastModified: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strip>>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"image">;
-            data: z.ZodString;
-            mimeType: z.ZodString;
-            annotations: z.ZodOptional<z.ZodObject<{
-                audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
-                    assistant: "assistant";
-                }>>>;
-                priority: z.ZodOptional<z.ZodNumber>;
-                lastModified: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strip>>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"audio">;
-            data: z.ZodString;
-            mimeType: z.ZodString;
-            annotations: z.ZodOptional<z.ZodObject<{
-                audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
-                    assistant: "assistant";
-                }>>>;
-                priority: z.ZodOptional<z.ZodNumber>;
-                lastModified: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strip>>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>, z.ZodObject<{
-            uri: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-            mimeType: z.ZodOptional<z.ZodString>;
-            annotations: z.ZodOptional<z.ZodObject<{
-                audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
-                    assistant: "assistant";
-                }>>>;
-                priority: z.ZodOptional<z.ZodNumber>;
-                lastModified: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strip>>;
-            _meta: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
-            icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                src: z.ZodString;
-                mimeType: z.ZodOptional<z.ZodString>;
-                sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            }, z.core.$strip>>>;
-            name: z.ZodString;
-            title: z.ZodOptional<z.ZodString>;
-            type: z.ZodLiteral<"resource_link">;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"resource">;
-            resource: z.ZodUnion<readonly [z.ZodObject<{
-                uri: z.ZodString;
-                mimeType: z.ZodOptional<z.ZodString>;
-                _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-                text: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                uri: z.ZodString;
-                mimeType: z.ZodOptional<z.ZodString>;
-                _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-                blob: z.ZodString;
-            }, z.core.$strip>]>;
-            annotations: z.ZodOptional<z.ZodObject<{
-                audience: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                    user: "user";
-                    assistant: "assistant";
-                }>>>;
-                priority: z.ZodOptional<z.ZodNumber>;
-                lastModified: z.ZodOptional<z.ZodISODateTime>;
-            }, z.core.$strip>>;
-            _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>]>>>;
-        structuredContent: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        isError: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$loose>;
-}, z.core.$strip>;
-/**
- * Rich context about the host environment provided to Guest UIs.
- *
- * Hosts provide this context in the {@link McpUiInitializeResult} response and send
- * updates via {@link McpUiHostContextChangedNotification} when values change.
- * All fields are optional and Guest UIs should handle missing fields gracefully.
- *
- * @example
- * ```typescript
- * // Received during initialization
- * const result = await app.connect(transport);
- * const context = result.hostContext;
- *
- * if (context.theme === "dark") {
- *   document.body.classList.add("dark-mode");
- * }
- * ```
- */
-export interface McpUiHostContext {
-    /** Metadata of the tool call that instantiated this App */
-    toolInfo?: {
-        /** JSON-RPC id of the tools/call request */
-        id: RequestId;
-        /** Tool definition including name, inputSchema, etc. */
-        tool: Tool;
-    };
-    /**
-     * Current color theme preference.
-     * @example "dark"
-     */
-    theme?: McpUiTheme;
-    /**
-     * How the UI is currently displayed.
-     * @example "inline"
-     */
-    displayMode?: McpUiDisplayMode;
-    /**
-     * Display modes the host supports.
-     * Apps can use this to offer mode-switching UI if applicable.
-     */
-    availableDisplayModes?: string[];
-    /** Current and maximum dimensions available to the UI */
-    viewport?: {
-        /** Current viewport width in pixels */
-        width: number;
-        /** Current viewport height in pixels */
-        height: number;
-        /** Maximum available height in pixels (if constrained) */
-        maxHeight?: number;
-        /** Maximum available width in pixels (if constrained) */
-        maxWidth?: number;
-    };
-    /**
-     * User's language and region preference in BCP 47 format.
-     * @example "en-US", "fr-CA", "ja-JP"
-     */
-    locale?: string;
-    /**
-     * User's timezone in IANA format.
-     * @example "America/New_York", "Europe/London", "Asia/Tokyo"
-     */
-    timeZone?: string;
-    /**
-     * Host application identifier.
-     * @example "claude-desktop/1.0.0"
-     */
-    userAgent?: string;
-    /**
-     * Platform type for responsive design decisions.
-     * @example "desktop"
-     */
-    platform?: "web" | "desktop" | "mobile";
-    /** Device input capabilities */
-    deviceCapabilities?: {
-        /** Whether the device supports touch input */
-        touch?: boolean;
-        /** Whether the device supports hover interactions */
-        hover?: boolean;
-    };
-    /**
-     * Safe area boundaries in pixels.
-     * Used to avoid notches, rounded corners, and system UI.
-     */
-    safeAreaInsets?: {
-        /** Top safe area inset in pixels */
-        top: number;
-        /** Right safe area inset in pixels */
-        right: number;
-        /** Bottom safe area inset in pixels */
-        bottom: number;
-        /** Left safe area inset in pixels */
-        left: number;
-    };
-}
-/**
- * Runtime validation schema for {@link McpUiHostContext}.
- * @internal
- */
-export declare const McpUiHostContextSchema: z.ZodType<McpUiHostContext>;
-/**
- * Notification that host context has changed (Host → Guest UI).
- *
- * The host MAY send this notification when any context field changes, such as:
- * - Theme toggled (light/dark)
- * - Display mode changed (inline/fullscreen)
- * - Device orientation changed
- * - Window/panel resized
- *
- * This notification contains partial updates. Guest UIs SHOULD merge received
- * fields with their current context state rather than replacing it entirely.
- *
- * @see {@link McpUiHostContext} for the full context structure
- */
-export interface McpUiHostContextChangedNotification {
-    method: "ui/notifications/host-context-changed";
-    /** Partial context update containing only changed fields */
-    params: McpUiHostContext;
-}
-/**
- * Runtime validation schema for {@link McpUiHostContextChangedNotification}.
- * @internal
- */
-export declare const McpUiHostContextChangedNotificationSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/notifications/host-context-changed">;
-    params: z.ZodType<McpUiHostContext, unknown, z.core.$ZodTypeInternals<McpUiHostContext, unknown>>;
-}, z.core.$strip>;
-/**
- * Request for graceful shutdown of the Guest UI (Host → Guest UI).
- *
- * The host MUST send this request before tearing down the UI resource, for any
- * reason including user action, resource reallocation, or app closure. This gives
- * the Guest UI an opportunity to save state, cancel pending operations, or show
- * confirmation dialogs.
- *
- * The host SHOULD wait for the response before unmounting the iframe to prevent
- * data loss.
- *
- * @see {@link app-bridge.AppBridge.sendResourceTeardown} for the host method that sends this
- */
-export interface McpUiResourceTeardownRequest {
-    method: "ui/resource-teardown";
-    params: {};
-}
-/**
- * Runtime validation schema for {@link McpUiResourceTeardownRequest}.
- * @internal
- */
-export declare const McpUiResourceTeardownRequestSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/resource-teardown">;
-    params: z.ZodObject<{}, z.core.$strip>;
-}, z.core.$strip>;
-/**
- * Result from graceful shutdown request.
- *
- * Empty result indicates the Guest UI has completed cleanup and is ready to be
- * torn down.
- *
- * @see {@link McpUiResourceTeardownRequest}
- */
-export interface McpUiResourceTeardownResult {
-}
-/**
- * Runtime validation schema for {@link McpUiResourceTeardownResult}.
- * @internal
- */
-export declare const McpUiResourceTeardownResultSchema: z.ZodType<McpUiResourceTeardownResult>;
-/**
- * Capabilities supported by the host application.
- *
- * Hosts declare these capabilities during the initialization handshake. Guest UIs
- * can check capabilities before attempting to use specific features.
+ * This file re-exports types from spec.types.ts and schemas from generated/schema.ts.
+ * Compile-time verification is handled by generated/schema.test.ts.
  *
- * @example Check if host supports opening links
- * ```typescript
- * const result = await app.connect(transport);
- * if (result.hostCapabilities.openLinks) {
- *   await app.sendOpenLink({ url: "https://example.com" });
- * }
- * ```
- *
- * @see {@link McpUiInitializeResult} for the initialization result that includes these capabilities
- */
-export interface McpUiHostCapabilities {
-    /** Experimental features (structure TBD) */
-    experimental?: {};
-    /** Host supports opening external URLs via {@link app.App.sendOpenLink} */
-    openLinks?: {};
-    /** Host can proxy tool calls to the MCP server */
-    serverTools?: {
-        /** Host supports tools/list_changed notifications */
-        listChanged?: boolean;
-    };
-    /** Host can proxy resource reads to the MCP server */
-    serverResources?: {
-        /** Host supports resources/list_changed notifications */
-        listChanged?: boolean;
-    };
-    /** Host accepts log messages via {@link app.App.sendLog} */
-    logging?: {};
-}
-/**
- * Runtime validation schema for {@link McpUiHostCapabilities}.
- * @internal
+ * @see spec.types.ts for the source of truth TypeScript interfaces
+ * @see generated/schema.ts for auto-generated Zod schemas
+ * @see generated/schema.test.ts for compile-time verification
  */
-export declare const McpUiHostCapabilitiesSchema: z.ZodType<McpUiHostCapabilities>;
+export { LATEST_PROTOCOL_VERSION, type McpUiTheme, type McpUiDisplayMode, type McpUiStyleVariableKey, type McpUiStyles, type McpUiHostStyles, type McpUiOpenLinkRequest, type McpUiOpenLinkResult, type McpUiMessageRequest, type McpUiMessageResult, type McpUiSandboxProxyReadyNotification, type McpUiSandboxResourceReadyNotification, type McpUiSizeChangedNotification, type McpUiToolInputNotification, type McpUiToolInputPartialNotification, type McpUiToolResultNotification, type McpUiToolCancelledNotification, type McpUiHostContext, type McpUiHostContextChangedNotification, type McpUiResourceTeardownRequest, type McpUiResourceTeardownResult, type McpUiHostCapabilities, type McpUiAppCapabilities, type McpUiInitializeRequest, type McpUiInitializeResult, type McpUiInitializedNotification, type McpUiResourceCsp, type McpUiResourceMeta, type McpUiRequestDisplayModeRequest, type McpUiRequestDisplayModeResult, type McpUiToolVisibility, type McpUiToolMeta, } from "./spec.types.js";
+import type { McpUiInitializeRequest, McpUiOpenLinkRequest, McpUiMessageRequest, McpUiResourceTeardownRequest, McpUiRequestDisplayModeRequest, McpUiHostContextChangedNotification, McpUiToolInputNotification, McpUiToolInputPartialNotification, McpUiToolResultNotification, McpUiToolCancelledNotification, McpUiSandboxResourceReadyNotification, McpUiInitializedNotification, McpUiSizeChangedNotification, McpUiSandboxProxyReadyNotification, McpUiInitializeResult, McpUiOpenLinkResult, McpUiMessageResult, McpUiResourceTeardownResult, McpUiRequestDisplayModeResult } from "./spec.types.js";
+export { McpUiThemeSchema, McpUiDisplayModeSchema, McpUiHostStylesSchema, McpUiOpenLinkRequestSchema, McpUiOpenLinkResultSchema, McpUiMessageRequestSchema, McpUiMessageResultSchema, McpUiSandboxProxyReadyNotificationSchema, McpUiSandboxResourceReadyNotificationSchema, McpUiSizeChangedNotificationSchema, McpUiToolInputNotificationSchema, McpUiToolInputPartialNotificationSchema, McpUiToolResultNotificationSchema, McpUiToolCancelledNotificationSchema, McpUiHostContextSchema, McpUiHostContextChangedNotificationSchema, McpUiResourceTeardownRequestSchema, McpUiResourceTeardownResultSchema, McpUiHostCapabilitiesSchema, McpUiAppCapabilitiesSchema, McpUiInitializeRequestSchema, McpUiInitializeResultSchema, McpUiInitializedNotificationSchema, McpUiResourceCspSchema, McpUiResourceMetaSchema, McpUiRequestDisplayModeRequestSchema, McpUiRequestDisplayModeResultSchema, McpUiToolVisibilitySchema, McpUiToolMetaSchema, } from "./generated/schema.js";
+import { CallToolRequest, CallToolResult, EmptyResult, ListPromptsRequest, ListPromptsResult, ListResourcesRequest, ListResourcesResult, ListResourceTemplatesRequest, ListResourceTemplatesResult, ListToolsRequest, ListToolsResult, LoggingMessageNotification, PingRequest, PromptListChangedNotification, ReadResourceRequest, ReadResourceResult, ResourceListChangedNotification, ToolListChangedNotification } from "@modelcontextprotocol/sdk/types.js";
 /**
- * Capabilities provided by the Guest UI (App).
- *
- * Apps declare these capabilities during the initialization handshake to indicate
- * what features they provide to the host.
+ * All request types in the MCP Apps protocol.
  *
- * @example Declare tool capabilities
- * ```typescript
- * const app = new App(
- *   { name: "MyApp", version: "1.0.0" },
- *   { tools: { listChanged: true } }
- * );
- * ```
- *
- * @see {@link McpUiInitializeRequest} for the initialization request that includes these capabilities
- */
-export interface McpUiAppCapabilities {
-    /** Experimental features (structure TBD) */
-    experimental?: {};
-    /**
-     * App exposes MCP-style tools that the host can call.
-     * These are app-specific tools, not proxied from the server.
-     */
-    tools?: {
-        /** App supports tools/list_changed notifications */
-        listChanged?: boolean;
-    };
-}
-/**
- * Runtime validation schema for {@link McpUiAppCapabilities}.
- * @internal
+ * Includes:
+ * - MCP UI requests (initialize, open-link, message, resource-teardown, request-display-mode)
+ * - MCP server requests forwarded from the app (tools/call, resources/*, prompts/list)
+ * - Protocol requests (ping)
  */
-export declare const McpUiAppCapabilitiesSchema: z.ZodType<McpUiAppCapabilities>;
+export type AppRequest = McpUiInitializeRequest | McpUiOpenLinkRequest | McpUiMessageRequest | McpUiResourceTeardownRequest | McpUiRequestDisplayModeRequest | CallToolRequest | ListToolsRequest | ListResourcesRequest | ListResourceTemplatesRequest | ReadResourceRequest | ListPromptsRequest | PingRequest;
 /**
- * Initialization request sent from Guest UI to Host.
- *
- * This is the first message sent by the Guest UI after loading. The host responds
- * with {@link McpUiInitializeResult} containing host capabilities and context.
- * After receiving the response, the Guest UI MUST send
- * {@link McpUiInitializedNotification}.
+ * All notification types in the MCP Apps protocol.
  *
- * This replaces the custom iframe-ready pattern used in pre-SEP MCP-UI.
+ * Host to app:
+ * - Tool lifecycle (input, input-partial, result, cancelled)
+ * - Host context changes
+ * - MCP list changes (tools, resources, prompts)
+ * - Sandbox resource ready
  *
- * @see {@link app.App.connect} for the method that sends this request
+ * App to host:
+ * - Initialized, size-changed, sandbox-proxy-ready
+ * - Logging messages
  */
-export interface McpUiInitializeRequest {
-    method: "ui/initialize";
-    params: {
-        /** App identification (name and version) */
-        appInfo: Implementation;
-        /** Features and capabilities this app provides */
-        appCapabilities: McpUiAppCapabilities;
-        /** Protocol version this app supports */
-        protocolVersion: string;
-    };
-}
+export type AppNotification = McpUiHostContextChangedNotification | McpUiToolInputNotification | McpUiToolInputPartialNotification | McpUiToolResultNotification | McpUiToolCancelledNotification | McpUiSandboxResourceReadyNotification | ToolListChangedNotification | ResourceListChangedNotification | PromptListChangedNotification | McpUiInitializedNotification | McpUiSizeChangedNotification | McpUiSandboxProxyReadyNotification | LoggingMessageNotification;
 /**
- * Runtime validation schema for {@link McpUiInitializeRequest}.
- * @internal
- */
-export declare const McpUiInitializeRequestSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/initialize">;
-    params: z.ZodObject<{
-        appInfo: z.ZodObject<{
-            version: z.ZodString;
-            websiteUrl: z.ZodOptional<z.ZodString>;
-            icons: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                src: z.ZodString;
-                mimeType: z.ZodOptional<z.ZodString>;
-                sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            }, z.core.$strip>>>;
-            name: z.ZodString;
-            title: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-        appCapabilities: z.ZodType<McpUiAppCapabilities, unknown, z.core.$ZodTypeInternals<McpUiAppCapabilities, unknown>>;
-        protocolVersion: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-/**
- * Initialization result returned from Host to Guest UI.
- *
- * Contains the negotiated protocol version, host information, capabilities,
- * and rich context about the host environment.
- *
- * @see {@link McpUiInitializeRequest}
- */
-export interface McpUiInitializeResult {
-    /** Negotiated protocol version string (e.g., "2025-11-21") */
-    protocolVersion: string;
-    /** Host application identification and version */
-    hostInfo: Implementation;
-    /** Features and capabilities provided by the host */
-    hostCapabilities: McpUiHostCapabilities;
-    /** Rich context about the host environment */
-    hostContext: McpUiHostContext;
-    /**
-     * Index signature required for MCP SDK `Protocol` class compatibility.
-     * Note: The schema intentionally omits this to enforce strict validation.
-     */
-    [key: string]: unknown;
-}
-/**
- * Runtime validation schema for {@link McpUiInitializeResult}.
- * @internal
- */
-export declare const McpUiInitializeResultSchema: z.ZodType<McpUiInitializeResult>;
-/**
- * Notification that Guest UI has completed initialization (Guest UI → Host).
- *
- * The Guest UI MUST send this notification after receiving
- * {@link McpUiInitializeResult} and completing any setup. The host waits for this
- * notification before sending tool input and other data to the Guest UI.
- *
- * @see {@link app.App.connect} for the method that sends this notification
- */
-export interface McpUiInitializedNotification {
-    method: "ui/notifications/initialized";
-    params?: {};
-}
-/**
- * Runtime validation schema for {@link McpUiInitializedNotification}.
- * @internal
- */
-export declare const McpUiInitializedNotificationSchema: z.ZodObject<{
-    method: z.ZodLiteral<"ui/notifications/initialized">;
-    params: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
-}, z.core.$strip>;
-/**
- * Content Security Policy configuration for UI resources.
- *
- * Servers declare which external origins their UI needs to access.
- * Hosts use this to enforce appropriate CSP headers.
- */
-export declare const McpUiResourceCspSchema: z.ZodObject<{
-    connectDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    resourceDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export type McpUiResourceCsp = z.infer<typeof McpUiResourceCspSchema>;
-/**
- * UI Resource metadata for security and rendering configuration.
- *
- * Included in the `_meta.ui` field of UI resource content returned via `resources/read`.
- *
- * @see {@link McpUiResourceCspSchema} for CSP configuration
+ * All result types in the MCP Apps protocol.
  */
-export declare const McpUiResourceMetaSchema: z.ZodObject<{
-    csp: z.ZodOptional<z.ZodObject<{
-        connectDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        resourceDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    domain: z.ZodOptional<z.ZodString>;
-    prefersBorder: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-export type McpUiResourceMeta = z.infer<typeof McpUiResourceMetaSchema>;
+export type AppResult = McpUiInitializeResult | McpUiOpenLinkResult | McpUiMessageResult | McpUiResourceTeardownResult | McpUiRequestDisplayModeResult | CallToolResult | ListToolsResult | ListResourcesResult | ListResourceTemplatesResult | ReadResourceResult | ListPromptsResult | EmptyResult;