@modelcontextprotocol/ext-apps 0.4.1 → 1.0.0

package/dist/src/spec.types.d.ts

@@ -7,7 +7,7 @@
  * - 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/draft/apps.mdx
+ * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/2026-01-26/apps.mdx
  */
 import type { CallToolResult, ContentBlock, Implementation, RequestId, Tool } from "@modelcontextprotocol/sdk/types.js";
 /**
@@ -16,7 +16,7 @@ import type { CallToolResult, ContentBlock, Implementation, RequestId, Tool } fr
  * 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";
+export declare const LATEST_PROTOCOL_VERSION = "2026-01-26";
 /**
  * @description Color theme preference for the host environment.
  */
@@ -41,7 +41,7 @@ export type McpUiStyleVariableKey = "--color-background-primary" | "--color-back
 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} for the method that sends this request
+ * @see {@link app!App.openLink `App.openLink`} for the method that sends this request
  */
 export interface McpUiOpenLinkRequest {
     method: "ui/open-link";
@@ -52,7 +52,7 @@ export interface McpUiOpenLinkRequest {
 }
 /**
  * @description Result from opening a URL.
- * @see {@link McpUiOpenLinkRequest}
+ * @see {@link McpUiOpenLinkRequest `McpUiOpenLinkRequest`}
  */
 export interface McpUiOpenLinkResult {
     /** @description True if the host failed to open the URL (e.g., due to security policy). */
@@ -65,7 +65,7 @@ export interface McpUiOpenLinkResult {
 }
 /**
  * @description Request to send a message to the host's chat interface.
- * @see {@link app!App.sendMessage} for the method that sends this request
+ * @see {@link app!App.sendMessage `App.sendMessage`} for the method that sends this request
  */
 export interface McpUiMessageRequest {
     method: "ui/message";
@@ -78,7 +78,7 @@ export interface McpUiMessageRequest {
 }
 /**
  * @description Result from sending a message.
- * @see {@link McpUiMessageRequest}
+ * @see {@link McpUiMessageRequest `McpUiMessageRequest`}
  */
 export interface McpUiMessageResult {
     /** @description True if the host rejected or failed to deliver the message. */
@@ -92,7 +92,7 @@ export interface McpUiMessageResult {
 /**
  * @description Notification that the sandbox proxy iframe is ready to receive content.
  * @internal
- * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx#sandbox-proxy
+ * @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";
@@ -101,7 +101,7 @@ export interface McpUiSandboxProxyReadyNotification {
 /**
  * @description Notification containing HTML resource for the sandbox proxy to load.
  * @internal
- * @see https://github.com/modelcontextprotocol/ext-apps/blob/main/specification/draft/apps.mdx#sandbox-proxy
+ * @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";
@@ -117,8 +117,8 @@ export interface McpUiSandboxResourceReadyNotification {
     };
 }
 /**
- * @description Notification of UI size changes (Guest UI -> Host).
- * @see {@link app!App.sendSizeChanged} for the method to send this from Guest UI
+ * @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";
@@ -130,7 +130,7 @@ export interface McpUiSizeChangedNotification {
     };
 }
 /**
- * @description Notification containing complete tool arguments (Host -> Guest UI).
+ * @description Notification containing complete tool arguments (Host -> View).
  */
 export interface McpUiToolInputNotification {
     method: "ui/notifications/tool-input";
@@ -140,7 +140,7 @@ export interface McpUiToolInputNotification {
     };
 }
 /**
- * @description Notification containing partial/streaming tool arguments (Host -> Guest UI).
+ * @description Notification containing partial/streaming tool arguments (Host -> View).
  */
 export interface McpUiToolInputPartialNotification {
     method: "ui/notifications/tool-input-partial";
@@ -150,7 +150,7 @@ export interface McpUiToolInputPartialNotification {
     };
 }
 /**
- * @description Notification containing tool execution result (Host -> Guest UI).
+ * @description Notification containing tool execution result (Host -> View).
  */
 export interface McpUiToolResultNotification {
     method: "ui/notifications/tool-result";
@@ -158,7 +158,7 @@ export interface McpUiToolResultNotification {
     params: CallToolResult;
 }
 /**
- * @description Notification that tool execution was cancelled (Host -> Guest UI).
+ * @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.).
  */
@@ -173,7 +173,7 @@ export interface McpUiToolCancelledNotification {
  * @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}. */
+    /** @description CSS for font loading (`@font-face` rules or `@import` statements). Apps must apply using {@link applyHostFonts `applyHostFonts`}. */
     fonts?: string;
 }
 /**
@@ -186,7 +186,7 @@ export interface McpUiHostStyles {
     css?: McpUiHostCss;
 }
 /**
- * @description Rich context about the host environment provided to Guest UIs.
+ * @description Rich context about the host environment provided to views.
  */
 export interface McpUiHostContext {
     /** @description Allow additional properties for forward compatibility. */
@@ -205,7 +205,7 @@ export interface McpUiHostContext {
     /** @description How the UI is currently displayed. */
     displayMode?: McpUiDisplayMode;
     /** @description Display modes the host supports. */
-    availableDisplayModes?: string[];
+    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.
@@ -251,8 +251,8 @@ export interface McpUiHostContext {
     };
 }
 /**
- * @description Notification that host context has changed (Host -> Guest UI).
- * @see {@link McpUiHostContext} for the full context structure
+ * @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";
@@ -260,16 +260,16 @@ export interface McpUiHostContextChangedNotification {
     params: McpUiHostContext;
 }
 /**
- * @description Request to update the agent's context without requiring a follow-up action (Guest UI -> Host).
+ * @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 Guest UI.
+ * 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} for the method that sends this request
+ * @see {@link app.App.updateModelContext `App.updateModelContext`} for the method that sends this request
  */
 export interface McpUiUpdateModelContextRequest {
     method: "ui/update-model-context";
@@ -281,8 +281,8 @@ export interface McpUiUpdateModelContextRequest {
     };
 }
 /**
- * @description Request for graceful shutdown of the Guest UI (Host -> Guest UI).
- * @see {@link app-bridge!AppBridge.teardownResource} for the host method that sends this
+ * @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";
@@ -290,7 +290,7 @@ export interface McpUiResourceTeardownRequest {
 }
 /**
  * @description Result from graceful shutdown request.
- * @see {@link McpUiResourceTeardownRequest}
+ * @see {@link McpUiResourceTeardownRequest `McpUiResourceTeardownRequest`}
  */
 export interface McpUiResourceTeardownResult {
     /**
@@ -314,7 +314,7 @@ export interface McpUiSupportedContentBlockModalities {
 }
 /**
  * @description Capabilities supported by the host application.
- * @see {@link McpUiInitializeResult} for the initialization result that includes these capabilities
+ * @see {@link McpUiInitializeResult `McpUiInitializeResult`} for the initialization result that includes these capabilities
  */
 export interface McpUiHostCapabilities {
     /** @description Experimental features (structure TBD). */
@@ -342,12 +342,12 @@ export interface McpUiHostCapabilities {
     };
     /** @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 Guest UI. */
+    /** @description Host supports receiving content messages (ui/message) from the view. */
     message?: McpUiSupportedContentBlockModalities;
 }
 /**
- * @description Capabilities provided by the Guest UI ({@link app!App}).
- * @see {@link McpUiInitializeRequest} for the initialization request that includes these capabilities
+ * @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 (structure TBD). */
@@ -357,10 +357,12 @@ export interface McpUiAppCapabilities {
         /** @description App supports tools/list_changed notifications. */
         listChanged?: boolean;
     };
+    /** @description Display modes the app supports. */
+    availableDisplayModes?: McpUiDisplayMode[];
 }
 /**
- * @description Initialization request sent from Guest UI to Host.
- * @see {@link app!App.connect} for the method that sends this request
+ * @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";
@@ -374,8 +376,8 @@ export interface McpUiInitializeRequest {
     };
 }
 /**
- * @description Initialization result returned from Host to Guest UI.
- * @see {@link McpUiInitializeRequest}
+ * @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"). */
@@ -393,8 +395,8 @@ export interface McpUiInitializeResult {
     [key: string]: unknown;
 }
 /**
- * @description Notification that Guest UI has completed initialization (Guest UI -> Host).
- * @see {@link app!App.connect} for the method that sends this notification
+ * @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";
@@ -436,7 +438,7 @@ export interface McpUiResourceMeta {
     csp?: McpUiResourceCsp;
     /** @description Sandbox permissions requested by the UI. */
     permissions?: McpUiResourcePermissions;
-    /** @description Dedicated origin for widget sandbox. */
+    /** @description Dedicated origin for view sandbox. */
     domain?: string;
     /** @description Visual boundary preference - true if UI prefers a visible border. */
     prefersBorder?: boolean;
@@ -445,7 +447,7 @@ export interface McpUiResourceMeta {
  * @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} for the method that sends this request
+ * @see {@link app!App.requestDisplayMode `App.requestDisplayMode`} for the method that sends this request
  */
 export interface McpUiRequestDisplayModeRequest {
     method: "ui/request-display-mode";
@@ -456,7 +458,7 @@ export interface McpUiRequestDisplayModeRequest {
 }
 /**
  * @description Result from requesting a display mode change.
- * @see {@link McpUiRequestDisplayModeRequest}
+ * @see {@link McpUiRequestDisplayModeRequest `McpUiRequestDisplayModeRequest`}
  */
 export interface McpUiRequestDisplayModeResult {
     /** @description The display mode that was actually set. May differ from requested if not supported. */
@@ -479,7 +481,7 @@ export interface McpUiToolMeta {
      * URI of the UI resource to display for this tool, if any.
      * This is converted to `_meta["ui/resourceUri"]`.
      *
-     * @example "ui://weather/widget.html"
+     * @example "ui://weather/view.html"
      */
     resourceUri?: string;
     /**
@@ -519,3 +521,17 @@ export declare const RESOURCE_TEARDOWN_METHOD: McpUiResourceTeardownRequest["met
 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[];
+}

package/dist/src/styles.d.ts

@@ -9,15 +9,13 @@ import { McpUiStyles, McpUiTheme } from "./types";
  * @returns The current theme ("light" or "dark")
  *
  * @example Check current theme
- * ```typescript
- * import { getDocumentTheme } from '@modelcontextprotocol/ext-apps';
- *
+ * ```ts source="./styles.examples.ts#getDocumentTheme_checkCurrent"
  * const theme = getDocumentTheme();
- * console.log(`Current theme: ${theme}`);
+ * document.body.classList.toggle("dark", theme === "dark");
  * ```
  *
- * @see {@link applyDocumentTheme} to set the theme
- * @see {@link McpUiTheme} for the theme type
+ * @see {@link applyDocumentTheme `applyDocumentTheme`} to set the theme
+ * @see {@link McpUiTheme `McpUiTheme`} for the theme type
  */
 export declare function getDocumentTheme(): McpUiTheme;
 /**
@@ -31,14 +29,21 @@ export declare function getDocumentTheme(): McpUiTheme;
  * @param theme - The theme to apply ("light" or "dark")
  *
  * @example Apply theme from host context
- * ```typescript
- * import { applyDocumentTheme } from '@modelcontextprotocol/ext-apps';
- *
+ * ```ts source="./styles.examples.ts#applyDocumentTheme_fromHostContext"
+ * // Apply when host context changes
  * app.onhostcontextchanged = (params) => {
  *   if (params.theme) {
  *     applyDocumentTheme(params.theme);
  *   }
  * };
+ *
+ * // Apply initial theme after connecting
+ * app.connect().then(() => {
+ *   const ctx = app.getHostContext();
+ *   if (ctx?.theme) {
+ *     applyDocumentTheme(ctx.theme);
+ *   }
+ * });
  * ```
  *
  * @example Use with CSS selectors
@@ -51,14 +56,14 @@ export declare function getDocumentTheme(): McpUiTheme;
  * }
  * ```
  *
- * @see {@link getDocumentTheme} to read the current theme
- * @see {@link McpUiTheme} for the theme type
+ * @see {@link getDocumentTheme `getDocumentTheme`} to read the current theme
+ * @see {@link McpUiTheme `McpUiTheme`} for the theme type
  */
 export declare function applyDocumentTheme(theme: McpUiTheme): void;
 /**
  * Apply host style variables as CSS custom properties on an element.
  *
- * This function takes the `variables` object from {@link McpUiHostContext.styles} and sets
+ * This function takes the `variables` object from {@link McpUiHostContext.styles `McpUiHostContext.styles`} and sets
  * each CSS variable on the specified root element (defaults to `document.documentElement`).
  * This allows apps to use the host's theming values via CSS variables like
  * `var(--color-background-primary)`.
@@ -67,24 +72,51 @@ export declare function applyDocumentTheme(theme: McpUiTheme): void;
  * @param root - The element to apply styles to (defaults to `document.documentElement`)
  *
  * @example Apply style variables from host context
- * ```typescript
- * import { applyHostStyleVariables } from '@modelcontextprotocol/ext-apps';
+ * ```ts source="./styles.examples.ts#applyHostStyleVariables_fromHostContext"
+ * // Use CSS variables in your styles
+ * document.body.style.background = "var(--color-background-primary)";
  *
+ * // Apply when host context changes
  * app.onhostcontextchanged = (params) => {
  *   if (params.styles?.variables) {
  *     applyHostStyleVariables(params.styles.variables);
  *   }
  * };
+ *
+ * // Apply initial styles after connecting
+ * app.connect().then(() => {
+ *   const ctx = app.getHostContext();
+ *   if (ctx?.styles?.variables) {
+ *     applyHostStyleVariables(ctx.styles.variables);
+ *   }
+ * });
  * ```
  *
  * @example Apply to a specific element
- * ```typescript
- * const container = document.getElementById('app-root');
- * applyHostStyleVariables(hostContext.styles?.variables, container);
+ * ```ts source="./styles.examples.ts#applyHostStyleVariables_toElement"
+ * app.onhostcontextchanged = (params) => {
+ *   const container = document.getElementById("app-root");
+ *   if (container && params.styles?.variables) {
+ *     applyHostStyleVariables(params.styles.variables, container);
+ *   }
+ * };
  * ```
  *
- * @see {@link McpUiStyles} for the available CSS variables
- * @see {@link McpUiHostContext} for the full host context structure
+ * @example Use host style variables in CSS
+ * ```css
+ * body {
+ *   background-color: var(--color-background-primary);
+ *   color: var(--color-text-primary);
+ * }
+ *
+ * .card {
+ *   background-color: var(--color-background-secondary);
+ *   border: 1px solid var(--color-border-primary);
+ * }
+ * ```
+ *
+ * @see {@link McpUiStyles `McpUiStyles`} for the available CSS variables
+ * @see {@link McpUiHostContext `McpUiHostContext`} for the full host context structure
  */
 export declare function applyHostStyleVariables(styles: McpUiStyles, root?: HTMLElement): void;
 /**
@@ -101,41 +133,52 @@ export declare function applyHostStyleVariables(styles: McpUiStyles, root?: HTML
  * @param fontCss - CSS string containing `@font-face` rules and/or `@import` statements
  *
  * @example Apply fonts from host context
- * ```typescript
- * import { applyHostFonts } from '@modelcontextprotocol/ext-apps';
- *
+ * ```ts source="./styles.examples.ts#applyHostFonts_fromHostContext"
+ * // Apply when host context changes
  * app.onhostcontextchanged = (params) => {
  *   if (params.styles?.css?.fonts) {
  *     applyHostFonts(params.styles.css.fonts);
  *   }
  * };
+ *
+ * // Apply initial fonts after connecting
+ * app.connect().then(() => {
+ *   const ctx = app.getHostContext();
+ *   if (ctx?.styles?.css?.fonts) {
+ *     applyHostFonts(ctx.styles.css.fonts);
+ *   }
+ * });
  * ```
  *
  * @example Host providing self-hosted fonts
- * ```typescript
- * hostContext.styles.css.fonts = `
+ * ```ts source="./styles.examples.ts#applyHostFonts_selfHosted"
+ * // Example of what a host might provide:
+ * const fontCss = `
  *   @font-face {
  *     font-family: "Anthropic Sans";
  *     src: url("https://assets.anthropic.com/.../Regular.otf") format("opentype");
  *     font-weight: 400;
  *   }
  * `;
+ * applyHostFonts(fontCss);
  * ```
  *
  * @example Host providing Google Fonts
- * ```typescript
- * hostContext.styles.css.fonts = `
+ * ```ts source="./styles.examples.ts#applyHostFonts_googleFonts"
+ * // Example of what a host might provide:
+ * const fontCss = `
  *   @import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');
  * `;
+ * applyHostFonts(fontCss);
  * ```
  *
  * @example Use host fonts in CSS
  * ```css
  * body {
- *   font-family: "Anthropic Sans", sans-serif;
+ *   font-family: var(--font-sans, system-ui, sans-serif);
  * }
  * ```
  *
- * @see {@link McpUiHostContext} for the full host context structure
+ * @see {@link McpUiHostContext `McpUiHostContext`} for the full host context structure
  */
 export declare function applyHostFonts(fontCss: string): void;

package/dist/src/styles.examples.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Type-checked examples for style utilities in {@link ./styles.ts `styles.ts`}.
+ *
+ * These examples are included in the API documentation via `@includeCode` tags.
+ * Each function's region markers define the code snippet that appears in the docs.
+ *
+ * @module
+ */
+export {};

package/dist/src/types.d.ts

@@ -8,7 +8,7 @@
  * @see `generated/schema.ts` for auto-generated Zod schemas
  * @see `generated/schema.test.ts` for compile-time verification
  */
-export { LATEST_PROTOCOL_VERSION, OPEN_LINK_METHOD, MESSAGE_METHOD, SANDBOX_PROXY_READY_METHOD, SANDBOX_RESOURCE_READY_METHOD, SIZE_CHANGED_METHOD, TOOL_INPUT_METHOD, TOOL_INPUT_PARTIAL_METHOD, TOOL_RESULT_METHOD, TOOL_CANCELLED_METHOD, HOST_CONTEXT_CHANGED_METHOD, RESOURCE_TEARDOWN_METHOD, INITIALIZE_METHOD, INITIALIZED_METHOD, REQUEST_DISPLAY_MODE_METHOD, type McpUiTheme, type McpUiDisplayMode, type McpUiStyleVariableKey, type McpUiStyles, type McpUiHostCss, type McpUiHostStyles, type McpUiOpenLinkRequest, type McpUiOpenLinkResult, type McpUiMessageRequest, type McpUiMessageResult, type McpUiUpdateModelContextRequest, type McpUiSupportedContentBlockModalities, 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 McpUiResourcePermissions, type McpUiResourceMeta, type McpUiRequestDisplayModeRequest, type McpUiRequestDisplayModeResult, type McpUiToolVisibility, type McpUiToolMeta, } from "./spec.types.js";
+export { LATEST_PROTOCOL_VERSION, OPEN_LINK_METHOD, MESSAGE_METHOD, SANDBOX_PROXY_READY_METHOD, SANDBOX_RESOURCE_READY_METHOD, SIZE_CHANGED_METHOD, TOOL_INPUT_METHOD, TOOL_INPUT_PARTIAL_METHOD, TOOL_RESULT_METHOD, TOOL_CANCELLED_METHOD, HOST_CONTEXT_CHANGED_METHOD, RESOURCE_TEARDOWN_METHOD, INITIALIZE_METHOD, INITIALIZED_METHOD, REQUEST_DISPLAY_MODE_METHOD, type McpUiTheme, type McpUiDisplayMode, type McpUiStyleVariableKey, type McpUiStyles, type McpUiHostCss, type McpUiHostStyles, type McpUiOpenLinkRequest, type McpUiOpenLinkResult, type McpUiMessageRequest, type McpUiMessageResult, type McpUiUpdateModelContextRequest, type McpUiSupportedContentBlockModalities, 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 McpUiResourcePermissions, type McpUiResourceMeta, type McpUiRequestDisplayModeRequest, type McpUiRequestDisplayModeResult, type McpUiToolVisibility, type McpUiToolMeta, type McpUiClientCapabilities, } from "./spec.types.js";
 import type { McpUiInitializeRequest, McpUiOpenLinkRequest, McpUiMessageRequest, McpUiUpdateModelContextRequest, McpUiResourceTeardownRequest, McpUiRequestDisplayModeRequest, McpUiHostContextChangedNotification, McpUiToolInputNotification, McpUiToolInputPartialNotification, McpUiToolResultNotification, McpUiToolCancelledNotification, McpUiSandboxResourceReadyNotification, McpUiInitializedNotification, McpUiSizeChangedNotification, McpUiSandboxProxyReadyNotification, McpUiInitializeResult, McpUiOpenLinkResult, McpUiMessageResult, McpUiResourceTeardownResult, McpUiRequestDisplayModeResult } from "./spec.types.js";
 export { McpUiThemeSchema, McpUiDisplayModeSchema, McpUiHostCssSchema, McpUiHostStylesSchema, McpUiOpenLinkRequestSchema, McpUiOpenLinkResultSchema, McpUiMessageRequestSchema, McpUiMessageResultSchema, McpUiUpdateModelContextRequestSchema, McpUiSupportedContentBlockModalitiesSchema, McpUiSandboxProxyReadyNotificationSchema, McpUiSandboxResourceReadyNotificationSchema, McpUiSizeChangedNotificationSchema, McpUiToolInputNotificationSchema, McpUiToolInputPartialNotificationSchema, McpUiToolResultNotificationSchema, McpUiToolCancelledNotificationSchema, McpUiHostContextSchema, McpUiHostContextChangedNotificationSchema, McpUiResourceTeardownRequestSchema, McpUiResourceTeardownResultSchema, McpUiHostCapabilitiesSchema, McpUiAppCapabilitiesSchema, McpUiInitializeRequestSchema, McpUiInitializeResultSchema, McpUiInitializedNotificationSchema, McpUiResourceCspSchema, McpUiResourcePermissionsSchema, 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";

package/package.json

@@ -5,7 +5,7 @@
     "url": "https://github.com/modelcontextprotocol/ext-apps"
   },
   "homepage": "https://github.com/modelcontextprotocol/ext-apps",
-  "version": "0.4.1",
+  "version": "1.0.0",
   "license": "MIT",
   "description": "MCP Apps SDK — Enable MCP servers to display interactive user interfaces in conversational clients.",
   "type": "module",
@@ -47,15 +47,16 @@
     "postinstall": "node scripts/setup-bun.mjs || echo 'setup-bun.mjs failed or not available'",
     "start": "npm run examples:dev",
     "generate:schemas": "tsx scripts/generate-schemas.ts && prettier --write \"src/generated/**/*\"",
-    "build": "npm run generate:schemas && node scripts/run-bun.mjs build.bun.ts",
+    "sync:snippets": "bun scripts/sync-snippets.ts",
+    "build": "npm run generate:schemas && npm run sync:snippets && node scripts/run-bun.mjs build.bun.ts",
     "prepack": "npm run build",
     "build:all": "npm run examples:build",
     "test": "bun test src",
     "test:e2e": "playwright test",
     "test:e2e:update": "playwright test --update-snapshots",
     "test:e2e:ui": "playwright test --ui",
-    "test:e2e:docker": "docker run --rm -v $(pwd):/work -w /work -it mcr.microsoft.com/playwright:v1.57.0-noble sh -c 'apt-get update -qq && apt-get install -qq -y python3-venv curl > /dev/null && curl -LsSf https://astral.sh/uv/install.sh | sh && export PATH=\"$HOME/.local/bin:$PATH\" && npm i -g bun && npm ci && npx playwright test'",
-    "test:e2e:docker:update": "npm run build:all && docker run --rm -v $(pwd):/work -w /work -it mcr.microsoft.com/playwright:v1.57.0-noble sh -c 'apt-get update -qq && apt-get install -qq -y python3-venv curl > /dev/null && curl -LsSf https://astral.sh/uv/install.sh | sh && export PATH=\"$HOME/.local/bin:$PATH\" && npm i -g bun && npm ci && npx playwright test --update-snapshots'",
+    "test:e2e:docker": "docker run --rm -e EXAMPLE -v $(pwd):/work -w /work -it mcr.microsoft.com/playwright:v1.57.0-noble sh -c 'apt-get update -qq && apt-get install -qq -y python3-venv curl > /dev/null && curl -LsSf https://astral.sh/uv/install.sh | sh && export PATH=\"$HOME/.local/bin:$PATH\" && npm i -g bun && npm ci && npx playwright test'",
+    "test:e2e:docker:update": "npm run build:all && docker run --rm -e EXAMPLE -v $(pwd):/work -w /work -it mcr.microsoft.com/playwright:v1.57.0-noble sh -c 'apt-get update -qq && apt-get install -qq -y python3-venv curl > /dev/null && curl -LsSf https://astral.sh/uv/install.sh | sh && export PATH=\"$HOME/.local/bin:$PATH\" && npm i -g bun && npm ci && npx playwright test --update-snapshots'",
     "preexamples:build": "npm run build",
     "examples:build": "bun examples/run-all.ts build",
     "examples:start": "NODE_ENV=development npm run build && bun examples/run-all.ts start",
@@ -64,25 +65,33 @@
     "prepare": "node scripts/setup-bun.mjs && npm run build && husky",
     "docs": "typedoc",
     "docs:watch": "typedoc --watch",
-    "generate:screenshots": "npm run build:all && docker run --rm -v $(pwd):/work -w /work mcr.microsoft.com/playwright:v1.57.0-noble sh -c 'apt-get update -qq && apt-get install -qq -y python3-venv curl > /dev/null && curl -LsSf https://astral.sh/uv/install.sh | sh && export PATH=\"$HOME/.local/bin:$PATH\" && npm i -g bun && npm ci && npx playwright test tests/e2e/generate-grid-screenshots.spec.ts'",
+    "generate:screenshots": "npm run build:all && docker run --rm -e EXAMPLE -v $(pwd):/work -w /work mcr.microsoft.com/playwright:v1.57.0-noble sh -c 'apt-get update -qq && apt-get install -qq -y python3-venv curl > /dev/null && curl -LsSf https://astral.sh/uv/install.sh | sh && export PATH=\"$HOME/.local/bin:$PATH\" && npm i -g bun && npm ci && npx playwright test tests/e2e/generate-grid-screenshots.spec.ts'",
     "prettier": "prettier -u \"**/*.{js,jsx,ts,tsx,mjs,json,md,yml,yaml}\" --check",
     "prettier:fix": "prettier -u \"**/*.{js,jsx,ts,tsx,mjs,json,md,yml,yaml}\" --write",
-    "check:versions": "node scripts/check-versions.mjs"
+    "check:versions": "node scripts/check-versions.mjs",
+    "update-lock:docker": "rm -rf node_modules package-lock.json && docker run --rm --platform linux/amd64 -v $(pwd):/work -w /work node:latest npm i --registry=https://registry.npmjs.org/ && rm -rf node_modules && npm i"
   },
   "author": "Olivier Chafik",
   "devDependencies": {
-    "@modelcontextprotocol/sdk": "^1.24.0",
-    "@playwright/test": "^1.52.0",
+    "@boneskull/typedoc-plugin-mermaid": "^0.2.0",
+    "@modelcontextprotocol/sdk": "1.25.2",
+    "@playwright/test": "1.57.0",
     "@types/bun": "^1.3.2",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
+    "@types/node": "20.19.27",
+    "caniuse-lite": "1.0.30001763",
+    "cheerio": "1.1.2",
     "concurrently": "^9.2.1",
     "cors": "^2.8.5",
     "cross-env": "^10.1.0",
+    "electron-to-chromium": "1.5.267",
     "esbuild": "^0.25.12",
     "express": "^5.1.0",
     "husky": "^9.1.7",
     "nodemon": "^3.1.0",
+    "playwright": "1.57.0",
+    "playwright-core": "1.57.0",
     "prettier": "^3.6.2",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
@@ -90,6 +99,7 @@
     "ts-to-zod": "^5.1.0",
     "tsx": "^4.21.0",
     "typedoc": "^0.28.14",
+    "typedoc-github-theme": "^0.3.1",
     "typescript": "^5.9.3",
     "zod": "^4.1.13"
   },
@@ -125,5 +135,12 @@
     "@rollup/rollup-linux-x64-gnu": "^4.53.3",
     "@rollup/rollup-win32-arm64-msvc": "^4.53.3",
     "@rollup/rollup-win32-x64-msvc": "^4.53.3"
+  },
+  "overrides": {
+    "seroval": "1.4.1",
+    "seroval-plugins": "1.4.2",
+    "solid-js": "1.9.10",
+    "@hono/node-server": "1.19.7",
+    "@types/node": "20.19.27"
   }
 }