@explyt/ai-agent 0.1.0-rc.1 → 0.1.4

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

@@ -1,698 +0,0 @@
-/**
- * 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/sdk/types.js";
-/**
- * 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;
-    /**
-     * Index signature required for MCP SDK `Protocol` class compatibility.
-     * Note: The generated schema uses passthrough() to allow additional properties.
-     */
-    [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;
-    /**
-     * Index signature required for MCP SDK `Protocol` class compatibility.
-     * Note: The generated schema uses passthrough() to allow additional properties.
-     */
-    [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;
-    /**
-     * Index signature required for MCP SDK `Protocol` class compatibility.
-     * Note: The generated schema uses passthrough() to allow additional properties.
-     */
-    [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 {
-    /**
-     * Index signature required for MCP SDK `Protocol` class compatibility.
-     */
-    [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;
-    /**
-     * Index signature required for MCP SDK `Protocol` class compatibility.
-     * Note: The generated schema uses passthrough() to allow additional properties.
-     */
-    [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;
-    /**
-     * Index signature required for MCP SDK `Protocol` class compatibility.
-     * 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[];
-}