@blade-hq/agent-react 2612.0.0-beta.68 → 2612.0.0-beta.69

package/node_modules/@modelcontextprotocol/ext-apps/dist/src/spec.types.d.ts

@@ -0,0 +1,698 @@
+/**
+ * MCP Apps Protocol Types (spec.types.ts)
+ *
+ * This file contains pure TypeScript interface definitions for the MCP Apps protocol.
+ * These types are the source of truth and are used to generate Zod schemas via `ts-to-zod`.
+ *
+ * - Use `@description` JSDoc tags to generate `.describe()` calls on schemas
+ * - Run `npm run generate:schemas` to regenerate schemas from these types
+ *
+ * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx
+ */
+import type { CallToolResult, ContentBlock, EmbeddedResource, Implementation, RequestId, ResourceLink, Tool } from "@modelcontextprotocol/client";
+/**
+ * Current protocol version supported by this SDK.
+ *
+ * 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 = "2026-01-26";
+/**
+ * @description Color theme preference for the host environment.
+ */
+export type McpUiTheme = "light" | "dark";
+/**
+ * @description Display mode for UI presentation.
+ */
+export type McpUiDisplayMode = "inline" | "fullscreen" | "pip";
+/**
+ * @description CSS variable keys available to MCP apps for theming.
+ */
+export type McpUiStyleVariableKey = "--color-background-primary" | "--color-background-secondary" | "--color-background-tertiary" | "--color-background-inverse" | "--color-background-ghost" | "--color-background-info" | "--color-background-danger" | "--color-background-success" | "--color-background-warning" | "--color-background-disabled" | "--color-text-primary" | "--color-text-secondary" | "--color-text-tertiary" | "--color-text-inverse" | "--color-text-ghost" | "--color-text-info" | "--color-text-danger" | "--color-text-success" | "--color-text-warning" | "--color-text-disabled" | "--color-border-primary" | "--color-border-secondary" | "--color-border-tertiary" | "--color-border-inverse" | "--color-border-ghost" | "--color-border-info" | "--color-border-danger" | "--color-border-success" | "--color-border-warning" | "--color-border-disabled" | "--color-ring-primary" | "--color-ring-secondary" | "--color-ring-inverse" | "--color-ring-info" | "--color-ring-danger" | "--color-ring-success" | "--color-ring-warning" | "--font-sans" | "--font-mono" | "--font-weight-normal" | "--font-weight-medium" | "--font-weight-semibold" | "--font-weight-bold" | "--font-text-xs-size" | "--font-text-sm-size" | "--font-text-md-size" | "--font-text-lg-size" | "--font-heading-xs-size" | "--font-heading-sm-size" | "--font-heading-md-size" | "--font-heading-lg-size" | "--font-heading-xl-size" | "--font-heading-2xl-size" | "--font-heading-3xl-size" | "--font-text-xs-line-height" | "--font-text-sm-line-height" | "--font-text-md-line-height" | "--font-text-lg-line-height" | "--font-heading-xs-line-height" | "--font-heading-sm-line-height" | "--font-heading-md-line-height" | "--font-heading-lg-line-height" | "--font-heading-xl-line-height" | "--font-heading-2xl-line-height" | "--font-heading-3xl-line-height" | "--border-radius-xs" | "--border-radius-sm" | "--border-radius-md" | "--border-radius-lg" | "--border-radius-xl" | "--border-radius-full" | "--border-width-regular" | "--shadow-hairline" | "--shadow-sm" | "--shadow-md" | "--shadow-lg";
+/**
+ * @description Style variables for theming MCP apps.
+ *
+ * Individual style keys are optional - hosts may provide any subset of these values.
+ * Values are strings containing CSS values (colors, sizes, font stacks, etc.).
+ *
+ * Note: This type uses `Record<K, string | undefined>` rather than `Partial<Record<K, string>>`
+ * for compatibility with Zod schema generation. Both are functionally equivalent for validation.
+ */
+export type McpUiStyles = Record<McpUiStyleVariableKey, string | undefined>;
+/**
+ * @description Request to open an external URL in the host's default browser.
+ * @see {@link app!App.openLink `App.openLink`} for the method that sends this request
+ */
+export interface McpUiOpenLinkRequest {
+    method: "ui/open-link";
+    params: {
+        /** @description URL to open in the host's browser */
+        url: string;
+    };
+}
+/**
+ * @description Result from opening a URL.
+ * @see {@link McpUiOpenLinkRequest `McpUiOpenLinkRequest`}
+ */
+export interface McpUiOpenLinkResult {
+    /** @description True if the host failed to open the URL (e.g., due to security policy). */
+    isError?: boolean;
+    /**
+     * Additional result properties are preserved for protocol extensibility.
+     * The generated schema uses passthrough() to allow them.
+     */
+    [key: string]: unknown;
+}
+/**
+ * @description Request to download a file through the host.
+ *
+ * Sent from the View to the Host when the app wants to trigger a file download.
+ * Since MCP Apps run in sandboxed iframes where direct downloads are blocked,
+ * this provides a host-mediated mechanism for file exports.
+ * The host SHOULD show a confirmation dialog before initiating the download.
+ *
+ * @see {@link app!App.downloadFile `App.downloadFile`} for the method that sends this request
+ */
+export interface McpUiDownloadFileRequest {
+    method: "ui/download-file";
+    params: {
+        /** @description Resource contents to download — embedded (inline data) or linked (host fetches). Uses standard MCP resource types. */
+        contents: (EmbeddedResource | ResourceLink)[];
+    };
+}
+/**
+ * @description Result from a file download request.
+ * @see {@link McpUiDownloadFileRequest `McpUiDownloadFileRequest`}
+ */
+export interface McpUiDownloadFileResult {
+    /** @description True if the download failed (e.g., user cancelled or host denied). */
+    isError?: boolean;
+    /**
+     * Additional result properties are preserved for protocol extensibility.
+     * The generated schema uses passthrough() to allow them.
+     */
+    [key: string]: unknown;
+}
+/**
+ * @description Request to send a message to the host's chat interface.
+ * @see {@link app!App.sendMessage `App.sendMessage`} for the method that sends this request
+ */
+export interface McpUiMessageRequest {
+    method: "ui/message";
+    params: {
+        /** @description Message role, currently only "user" is supported. */
+        role: "user";
+        /** @description Message content blocks (text, image, etc.). */
+        content: ContentBlock[];
+    };
+}
+/**
+ * @description Result from sending a message.
+ * @see {@link McpUiMessageRequest `McpUiMessageRequest`}
+ */
+export interface McpUiMessageResult {
+    /** @description True if the host rejected or failed to deliver the message. */
+    isError?: boolean;
+    /**
+     * Additional result properties are preserved for protocol extensibility.
+     * The generated schema uses passthrough() to allow them.
+     */
+    [key: string]: unknown;
+}
+/**
+ * @description Notification that the sandbox proxy iframe is ready to receive content.
+ * @internal
+ * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx#sandbox-proxy
+ */
+export interface McpUiSandboxProxyReadyNotification {
+    method: "ui/notifications/sandbox-proxy-ready";
+    params: {};
+}
+/**
+ * @description Notification containing HTML resource for the sandbox proxy to load.
+ * @internal
+ * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx#sandbox-proxy
+ */
+export interface McpUiSandboxResourceReadyNotification {
+    method: "ui/notifications/sandbox-resource-ready";
+    params: {
+        /** @description HTML content to load into the inner iframe. */
+        html: string;
+        /** @description Optional override for the inner iframe's sandbox attribute. */
+        sandbox?: string;
+        /** @description CSP configuration from resource metadata. */
+        csp?: McpUiResourceCsp;
+        /** @description Sandbox permissions from resource metadata. */
+        permissions?: McpUiResourcePermissions;
+    };
+}
+/**
+ * @description Notification of UI size changes (View -> Host).
+ * @see {@link app!App.sendSizeChanged `App.sendSizeChanged`} for the method to send this from View
+ */
+export interface McpUiSizeChangedNotification {
+    method: "ui/notifications/size-changed";
+    params: {
+        /** @description New width in pixels. */
+        width?: number;
+        /** @description New height in pixels. */
+        height?: number;
+    };
+}
+/**
+ * @description Notification containing complete tool arguments (Host -> View).
+ */
+export interface McpUiToolInputNotification {
+    method: "ui/notifications/tool-input";
+    params: {
+        /** @description Complete tool call arguments as key-value pairs. */
+        arguments?: Record<string, unknown>;
+    };
+}
+/**
+ * @description Notification containing partial/streaming tool arguments (Host -> View).
+ */
+export interface McpUiToolInputPartialNotification {
+    method: "ui/notifications/tool-input-partial";
+    params: {
+        /** @description Partial tool call arguments (incomplete, may change). */
+        arguments?: Record<string, unknown>;
+    };
+}
+/**
+ * @description Notification containing tool execution result (Host -> View).
+ */
+export interface McpUiToolResultNotification {
+    method: "ui/notifications/tool-result";
+    /** @description Standard MCP tool execution result. */
+    params: CallToolResult;
+}
+/**
+ * @description Notification that tool execution was cancelled (Host -> View).
+ * Host MUST send this if tool execution was cancelled for any reason (user action,
+ * sampling error, classifier intervention, etc.).
+ */
+export interface McpUiToolCancelledNotification {
+    method: "ui/notifications/tool-cancelled";
+    params: {
+        /** @description Optional reason for the cancellation (e.g., "user action", "timeout"). */
+        reason?: string;
+    };
+}
+/**
+ * @description CSS blocks that can be injected by apps.
+ */
+export interface McpUiHostCss {
+    /** @description CSS for font loading (`@font-face` rules or `@import` statements). Apps must apply using {@link applyHostFonts `applyHostFonts`}. */
+    fonts?: string;
+}
+/**
+ * @description Style configuration for theming MCP apps.
+ */
+export interface McpUiHostStyles {
+    /** @description CSS variables for theming the app. */
+    variables?: McpUiStyles;
+    /** @description CSS blocks that apps can inject. */
+    css?: McpUiHostCss;
+}
+/**
+ * @description Rich context about the host environment provided to views.
+ */
+export interface McpUiHostContext {
+    /** @description Allow additional properties for forward compatibility. */
+    [key: string]: unknown;
+    /** @description Metadata of the tool call that instantiated this App. */
+    toolInfo?: {
+        /** @description JSON-RPC id of the tools/call request. */
+        id?: RequestId;
+        /** @description Tool definition including name, inputSchema, etc. */
+        tool: Tool;
+    };
+    /** @description Current color theme preference. */
+    theme?: McpUiTheme;
+    /** @description Style configuration for theming the app. */
+    styles?: McpUiHostStyles;
+    /** @description How the UI is currently displayed. */
+    displayMode?: McpUiDisplayMode;
+    /** @description Display modes the host supports. */
+    availableDisplayModes?: McpUiDisplayMode[];
+    /**
+     * @description Container dimensions. Represents the dimensions of the iframe or other
+     * container holding the app. Specify either width or maxWidth, and either height or maxHeight.
+     */
+    containerDimensions?: ({
+        /** @description Fixed container height in pixels. */
+        height: number;
+    } | {
+        /** @description Maximum container height in pixels. */
+        maxHeight?: number | undefined;
+    }) & ({
+        /** @description Fixed container width in pixels. */
+        width: number;
+    } | {
+        /** @description Maximum container width in pixels. */
+        maxWidth?: number | undefined;
+    });
+    /** @description User's language and region preference in BCP 47 format. */
+    locale?: string;
+    /** @description User's timezone in IANA format. */
+    timeZone?: string;
+    /** @description Host application identifier. */
+    userAgent?: string;
+    /** @description Platform type for responsive design decisions. */
+    platform?: "web" | "desktop" | "mobile";
+    /** @description Device input capabilities. */
+    deviceCapabilities?: {
+        /** @description Whether the device supports touch input. */
+        touch?: boolean;
+        /** @description Whether the device supports hover interactions. */
+        hover?: boolean;
+    };
+    /** @description Mobile safe area boundaries in pixels. */
+    safeAreaInsets?: {
+        /** @description Top safe area inset in pixels. */
+        top: number;
+        /** @description Right safe area inset in pixels. */
+        right: number;
+        /** @description Bottom safe area inset in pixels. */
+        bottom: number;
+        /** @description Left safe area inset in pixels. */
+        left: number;
+    };
+}
+/**
+ * @description Notification that host context has changed (Host -> View).
+ * @see {@link McpUiHostContext `McpUiHostContext`} for the full context structure
+ */
+export interface McpUiHostContextChangedNotification {
+    method: "ui/notifications/host-context-changed";
+    /** @description Partial context update containing only changed fields. */
+    params: McpUiHostContext;
+}
+/**
+ * @description Request to update the agent's context without requiring a follow-up action (View -> Host).
+ *
+ * Unlike `notifications/message` which is for debugging/logging, this request is intended
+ * to update the Host's model context. Each request overwrites the previous context sent by the View.
+ * Unlike messages, context updates do not trigger follow-ups.
+ *
+ * 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.
+ *
+ * @see {@link app.App.updateModelContext `App.updateModelContext`} for the method that sends this request
+ */
+export interface McpUiUpdateModelContextRequest {
+    method: "ui/update-model-context";
+    params: {
+        /** @description Context content blocks (text, image, etc.). */
+        content?: ContentBlock[];
+        /** @description Structured content for machine-readable context data. */
+        structuredContent?: Record<string, unknown>;
+    };
+}
+/**
+ * @description Request for graceful shutdown of the View (Host -> View).
+ * @see {@link app-bridge!AppBridge.teardownResource `AppBridge.teardownResource`} for the host method that sends this
+ */
+export interface McpUiResourceTeardownRequest {
+    method: "ui/resource-teardown";
+    params: {};
+}
+/**
+ * @description Result from graceful shutdown request.
+ * @see {@link McpUiResourceTeardownRequest `McpUiResourceTeardownRequest`}
+ */
+export interface McpUiResourceTeardownResult {
+    /**
+     * Additional result properties are preserved for protocol extensibility.
+     */
+    [key: string]: unknown;
+}
+export interface McpUiSupportedContentBlockModalities {
+    /** @description Host supports text content blocks. */
+    text?: {};
+    /** @description Host supports image content blocks. */
+    image?: {};
+    /** @description Host supports audio content blocks. */
+    audio?: {};
+    /** @description Host supports resource content blocks. */
+    resource?: {};
+    /** @description Host supports resource link content blocks. */
+    resourceLink?: {};
+    /** @description Host supports structured content. */
+    structuredContent?: {};
+}
+/**
+ * @description Notification for app-initiated teardown request (View -> Host).
+ * Views send this to request that the host tear them down. The host decides
+ * whether to proceed - if approved, the host will send
+ * `ui/resource-teardown` to allow the view to perform cleanup before being
+ * unmounted.
+ * @see {@link app.App.requestTeardown} for the app method that sends this
+ */
+export interface McpUiRequestTeardownNotification {
+    method: "ui/notifications/request-teardown";
+    params?: {};
+}
+/**
+ * @description Capabilities supported by the host application.
+ * @see {@link McpUiInitializeResult `McpUiInitializeResult`} for the initialization result that includes these capabilities
+ */
+export interface McpUiHostCapabilities {
+    /** @description Experimental features keyed by identifier. */
+    experimental?: Record<string, object>;
+    /** @description Host supports opening external URLs. */
+    openLinks?: {};
+    /** @description Host supports file downloads via ui/download-file. */
+    downloadFile?: {};
+    /** @description Host can proxy tool calls to the MCP server. */
+    serverTools?: {
+        /** @description Host supports tools/list_changed notifications. */
+        listChanged?: boolean;
+    };
+    /** @description Host can proxy resource reads to the MCP server. */
+    serverResources?: {
+        /** @description Host supports resources/list_changed notifications. */
+        listChanged?: boolean;
+    };
+    /** @description Host accepts log messages. */
+    logging?: {};
+    /** @description Sandbox configuration applied by the host. */
+    sandbox?: {
+        /** @description Permissions granted by the host (camera, microphone, geolocation). */
+        permissions?: McpUiResourcePermissions;
+        /** @description CSP domains approved by the host. */
+        csp?: McpUiResourceCsp;
+    };
+    /** @description Host accepts context updates (ui/update-model-context) to be included in the model's context for future turns. */
+    updateModelContext?: McpUiSupportedContentBlockModalities;
+    /** @description Host supports receiving content messages (ui/message) from the view. */
+    message?: McpUiSupportedContentBlockModalities;
+    /**
+     * @description Host supports LLM sampling (sampling/createMessage) from the view.
+     * Mirrors the MCP `ClientCapabilities.sampling` shape so hosts can pass it through.
+     */
+    sampling?: {
+        /** @description Host supports tool use via `tools` and `toolChoice` parameters. */
+        tools?: {};
+    };
+}
+/**
+ * @description Capabilities provided by the View ({@link app!App `App`}).
+ * @see {@link McpUiInitializeRequest `McpUiInitializeRequest`} for the initialization request that includes these capabilities
+ */
+export interface McpUiAppCapabilities {
+    /** @description Experimental features keyed by identifier. */
+    experimental?: Record<string, object>;
+    /** @description App exposes MCP-style tools that the host can call. */
+    tools?: {
+        /** @description App supports tools/list_changed notifications. */
+        listChanged?: boolean;
+    };
+    /** @description Display modes the app supports. */
+    availableDisplayModes?: McpUiDisplayMode[];
+}
+/**
+ * @description Initialization request sent from View to Host.
+ * @see {@link app!App.connect `App.connect`} for the method that sends this request
+ */
+export interface McpUiInitializeRequest {
+    method: "ui/initialize";
+    params: {
+        /** @description App identification (name and version). */
+        appInfo: Implementation;
+        /** @description Features and capabilities this app provides. */
+        appCapabilities: McpUiAppCapabilities;
+        /** @description Protocol version this app supports. */
+        protocolVersion: string;
+    };
+}
+/**
+ * @description Initialization result returned from Host to View.
+ * @see {@link McpUiInitializeRequest `McpUiInitializeRequest`}
+ */
+export interface McpUiInitializeResult {
+    /** @description Negotiated protocol version string (e.g., "2025-11-21"). */
+    protocolVersion: string;
+    /** @description Host application identification and version. */
+    hostInfo: Implementation;
+    /** @description Features and capabilities provided by the host. */
+    hostCapabilities: McpUiHostCapabilities;
+    /** @description Rich context about the host environment. */
+    hostContext: McpUiHostContext;
+    /**
+     * Additional result properties are preserved for protocol extensibility.
+     * The generated schema uses passthrough() to allow them.
+     */
+    [key: string]: unknown;
+}
+/**
+ * @description Notification that View has completed initialization (View -> Host).
+ * @see {@link app!App.connect `App.connect`} for the method that sends this notification
+ */
+export interface McpUiInitializedNotification {
+    method: "ui/notifications/initialized";
+    params?: {};
+}
+/**
+ * @description Content Security Policy configuration for UI resources.
+ *
+ * Servers declare which origins their UI requires. Hosts use this to enforce appropriate CSP headers.
+ *
+ * > [!IMPORTANT]
+ * > MCP App HTML runs in a sandboxed iframe with no same-origin server.
+ * > **All** origins must be declared—including where your bundled JS/CSS is
+ * > served from (`localhost` in dev, your CDN in production).
+ */
+export interface McpUiResourceCsp {
+    /**
+     * @description Origins for network requests (fetch/XHR/WebSocket).
+     *
+     * - Maps to CSP `connect-src` directive
+     * - Empty or omitted → no network connections (secure default)
+     *
+     * @example
+     * ```ts
+     * ["https://api.weather.com", "wss://realtime.service.com"]
+     * ```
+     */
+    connectDomains?: string[];
+    /**
+     * @description Origins for static resources (images, scripts, stylesheets, fonts, media).
+     *
+     * - Maps to CSP `img-src`, `script-src`, `style-src`, `font-src`, `media-src` directives
+     * - Wildcard subdomains supported: `https://*.example.com`
+     * - Empty or omitted → no network resources (secure default)
+     *
+     * @example
+     * ```ts
+     * ["https://cdn.jsdelivr.net", "https://*.cloudflare.com"]
+     * ```
+     */
+    resourceDomains?: string[];
+    /**
+     * @description Origins for nested iframes.
+     *
+     * - Maps to CSP `frame-src` directive
+     * - Empty or omitted → no nested iframes allowed (`frame-src 'none'`)
+     *
+     * @example
+     * ```ts
+     * ["https://www.youtube.com", "https://player.vimeo.com"]
+     * ```
+     */
+    frameDomains?: string[];
+    /**
+     * @description Allowed base URIs for the document.
+     *
+     * - Maps to CSP `base-uri` directive
+     * - Empty or omitted → only same origin allowed (`base-uri 'self'`)
+     *
+     * @example
+     * ```ts
+     * ["https://cdn.example.com"]
+     * ```
+     */
+    baseUriDomains?: string[];
+}
+/**
+ * @description Sandbox permissions requested by the UI resource.
+ *
+ * Servers declare which browser capabilities their UI needs.
+ * Hosts MAY honor these by setting appropriate iframe `allow` attributes.
+ * Apps SHOULD NOT assume permissions are granted; use JS feature detection as fallback.
+ */
+export interface McpUiResourcePermissions {
+    /**
+     * @description Request camera access.
+     *
+     * Maps to Permission Policy `camera` feature.
+     */
+    camera?: {};
+    /**
+     * @description Request microphone access.
+     *
+     * Maps to Permission Policy `microphone` feature.
+     */
+    microphone?: {};
+    /**
+     * @description Request geolocation access.
+     *
+     * Maps to Permission Policy `geolocation` feature.
+     */
+    geolocation?: {};
+    /**
+     * @description Request clipboard write access.
+     *
+     * Maps to Permission Policy `clipboard-write` feature.
+     */
+    clipboardWrite?: {};
+}
+/**
+ * @description UI Resource metadata for security and rendering configuration.
+ */
+export interface McpUiResourceMeta {
+    /** @description Content Security Policy configuration for UI resources. */
+    csp?: McpUiResourceCsp;
+    /** @description Sandbox permissions requested by the UI resource. */
+    permissions?: McpUiResourcePermissions;
+    /**
+     * @description Dedicated origin for view sandbox.
+     *
+     * Useful when views need stable, dedicated origins for OAuth callbacks, CORS policies, or API key allowlists.
+     *
+     * **Host-dependent:** The format and validation rules for this field are determined by each host. Servers MUST consult host-specific documentation for the expected domain format. Common patterns include:
+     * - Hash-based subdomains (e.g., `{hash}.claudemcpcontent.com`)
+     * - URL-derived subdomains (e.g., `www-example-com.oaiusercontent.com`)
+     *
+     * If omitted, host uses default sandbox origin (typically per-conversation).
+     *
+     * @example
+     * ```ts
+     * "a904794854a047f6.claudemcpcontent.com"
+     * ```
+     *
+     * @example
+     * ```ts
+     * "www-example-com.oaiusercontent.com"
+     * ```
+     */
+    domain?: string;
+    /**
+     * @description Visual boundary preference - true if view prefers a visible border.
+     *
+     * Boolean requesting whether a visible border and background is provided by the host. Specifying an explicit value for this is recommended because hosts' defaults may vary.
+     *
+     * - `true`: request visible border + background
+     * - `false`: request no visible border + background
+     * - omitted: host decides border
+     */
+    prefersBorder?: boolean;
+}
+/**
+ * @description Request to change the display mode of the UI.
+ * The host will respond with the actual display mode that was set,
+ * which may differ from the requested mode if not supported.
+ * @see {@link app!App.requestDisplayMode `App.requestDisplayMode`} for the method that sends this request
+ */
+export interface McpUiRequestDisplayModeRequest {
+    method: "ui/request-display-mode";
+    params: {
+        /** @description The display mode being requested. */
+        mode: McpUiDisplayMode;
+    };
+}
+/**
+ * @description Result from requesting a display mode change.
+ * @see {@link McpUiRequestDisplayModeRequest `McpUiRequestDisplayModeRequest`}
+ */
+export interface McpUiRequestDisplayModeResult {
+    /** @description The display mode that was actually set. May differ from requested if not supported. */
+    mode: McpUiDisplayMode;
+    /**
+     * Additional result properties are preserved for protocol extensibility.
+     * Note: The generated schema uses passthrough() to allow additional properties.
+     */
+    [key: string]: unknown;
+}
+/**
+ * @description Tool visibility scope - who can access the tool.
+ */
+export type McpUiToolVisibility = "model" | "app";
+/**
+ * @description UI-related metadata for tools.
+ */
+export interface McpUiToolMeta {
+    /**
+     * URI of the UI resource to display for this tool, if any.
+     *
+     * @example
+     * ```ts
+     * "ui://weather/view.html"
+     * ```
+     */
+    resourceUri?: string;
+    /**
+     * @description Who can access this tool. Default: ["model", "app"]
+     * - "model": Tool visible to and callable by the agent
+     * - "app": Tool callable by the app from this server only
+     */
+    visibility?: McpUiToolVisibility[];
+    /**
+     * `csp` belongs on the UI **resource** (see {@link McpUiResourceMeta}),
+     * not the tool. Hosts read it from the `resources/read` content item
+     * (with `resources/list` entry as fallback) and ignore it here.
+     */
+    csp?: never;
+    /**
+     * `permissions` belongs on the UI **resource** (see {@link McpUiResourceMeta}),
+     * not the tool. Hosts ignore it here.
+     */
+    permissions?: never;
+}
+/**
+ * Method string constants for MCP Apps protocol messages.
+ *
+ * These constants provide a type-safe way to check message methods without
+ * accessing internal Zod schema properties. External libraries should use
+ * these constants instead of accessing `schema.shape.method._def.values[0]`.
+ *
+ * @example
+ * ```typescript
+ * import { SANDBOX_PROXY_READY_METHOD } from '@modelcontextprotocol/ext-apps';
+ *
+ * if (event.data.method === SANDBOX_PROXY_READY_METHOD) {
+ *   // Handle sandbox proxy ready notification
+ * }
+ * ```
+ */
+export declare const OPEN_LINK_METHOD: McpUiOpenLinkRequest["method"];
+export declare const DOWNLOAD_FILE_METHOD: McpUiDownloadFileRequest["method"];
+export declare const MESSAGE_METHOD: McpUiMessageRequest["method"];
+export declare const SANDBOX_PROXY_READY_METHOD: McpUiSandboxProxyReadyNotification["method"];
+export declare const SANDBOX_RESOURCE_READY_METHOD: McpUiSandboxResourceReadyNotification["method"];
+export declare const SIZE_CHANGED_METHOD: McpUiSizeChangedNotification["method"];
+export declare const TOOL_INPUT_METHOD: McpUiToolInputNotification["method"];
+export declare const TOOL_INPUT_PARTIAL_METHOD: McpUiToolInputPartialNotification["method"];
+export declare const TOOL_RESULT_METHOD: McpUiToolResultNotification["method"];
+export declare const TOOL_CANCELLED_METHOD: McpUiToolCancelledNotification["method"];
+export declare const HOST_CONTEXT_CHANGED_METHOD: McpUiHostContextChangedNotification["method"];
+export declare const REQUEST_TEARDOWN_METHOD: McpUiRequestTeardownNotification["method"];
+export declare const RESOURCE_TEARDOWN_METHOD: McpUiResourceTeardownRequest["method"];
+export declare const INITIALIZE_METHOD: McpUiInitializeRequest["method"];
+export declare const INITIALIZED_METHOD: McpUiInitializedNotification["method"];
+export declare const REQUEST_DISPLAY_MODE_METHOD: McpUiRequestDisplayModeRequest["method"];
+/**
+ * @description MCP Apps capability settings advertised by clients to servers.
+ *
+ * Clients advertise these capabilities via the `extensions` field in their
+ * capabilities during MCP initialization. Servers can check for MCP Apps
+ * support using {@link server-helpers!getUiCapability}.
+ */
+export interface McpUiClientCapabilities {
+    /**
+     * @description Array of supported MIME types for UI resources.
+     * Must include `"text/html;profile=mcp-app"` for MCP Apps support.
+     */
+    mimeTypes?: string[];
+}