@modelcontextprotocol/ext-apps 0.4.1 → 1.0.0

package/dist/src/generated/schema.d.ts

@@ -23,7 +23,7 @@ export declare const McpUiStyleVariableKeySchema: z.ZodUnion<readonly [z.ZodLite
 export declare const McpUiStylesSchema: z.ZodRecord<z.ZodUnion<readonly [z.ZodLiteral<"--color-background-primary">, z.ZodLiteral<"--color-background-secondary">, z.ZodLiteral<"--color-background-tertiary">, z.ZodLiteral<"--color-background-inverse">, z.ZodLiteral<"--color-background-ghost">, z.ZodLiteral<"--color-background-info">, z.ZodLiteral<"--color-background-danger">, z.ZodLiteral<"--color-background-success">, z.ZodLiteral<"--color-background-warning">, z.ZodLiteral<"--color-background-disabled">, z.ZodLiteral<"--color-text-primary">, z.ZodLiteral<"--color-text-secondary">, z.ZodLiteral<"--color-text-tertiary">, z.ZodLiteral<"--color-text-inverse">, z.ZodLiteral<"--color-text-ghost">, z.ZodLiteral<"--color-text-info">, z.ZodLiteral<"--color-text-danger">, z.ZodLiteral<"--color-text-success">, z.ZodLiteral<"--color-text-warning">, z.ZodLiteral<"--color-text-disabled">, z.ZodLiteral<"--color-text-ghost">, z.ZodLiteral<"--color-border-primary">, z.ZodLiteral<"--color-border-secondary">, z.ZodLiteral<"--color-border-tertiary">, z.ZodLiteral<"--color-border-inverse">, z.ZodLiteral<"--color-border-ghost">, z.ZodLiteral<"--color-border-info">, z.ZodLiteral<"--color-border-danger">, z.ZodLiteral<"--color-border-success">, z.ZodLiteral<"--color-border-warning">, z.ZodLiteral<"--color-border-disabled">, z.ZodLiteral<"--color-ring-primary">, z.ZodLiteral<"--color-ring-secondary">, z.ZodLiteral<"--color-ring-inverse">, z.ZodLiteral<"--color-ring-info">, z.ZodLiteral<"--color-ring-danger">, z.ZodLiteral<"--color-ring-success">, z.ZodLiteral<"--color-ring-warning">, z.ZodLiteral<"--font-sans">, z.ZodLiteral<"--font-mono">, z.ZodLiteral<"--font-weight-normal">, z.ZodLiteral<"--font-weight-medium">, z.ZodLiteral<"--font-weight-semibold">, z.ZodLiteral<"--font-weight-bold">, z.ZodLiteral<"--font-text-xs-size">, z.ZodLiteral<"--font-text-sm-size">, z.ZodLiteral<"--font-text-md-size">, z.ZodLiteral<"--font-text-lg-size">, z.ZodLiteral<"--font-heading-xs-size">, z.ZodLiteral<"--font-heading-sm-size">, z.ZodLiteral<"--font-heading-md-size">, z.ZodLiteral<"--font-heading-lg-size">, z.ZodLiteral<"--font-heading-xl-size">, z.ZodLiteral<"--font-heading-2xl-size">, z.ZodLiteral<"--font-heading-3xl-size">, z.ZodLiteral<"--font-text-xs-line-height">, z.ZodLiteral<"--font-text-sm-line-height">, z.ZodLiteral<"--font-text-md-line-height">, z.ZodLiteral<"--font-text-lg-line-height">, z.ZodLiteral<"--font-heading-xs-line-height">, z.ZodLiteral<"--font-heading-sm-line-height">, z.ZodLiteral<"--font-heading-md-line-height">, z.ZodLiteral<"--font-heading-lg-line-height">, z.ZodLiteral<"--font-heading-xl-line-height">, z.ZodLiteral<"--font-heading-2xl-line-height">, z.ZodLiteral<"--font-heading-3xl-line-height">, z.ZodLiteral<"--border-radius-xs">, z.ZodLiteral<"--border-radius-sm">, z.ZodLiteral<"--border-radius-md">, z.ZodLiteral<"--border-radius-lg">, z.ZodLiteral<"--border-radius-xl">, z.ZodLiteral<"--border-radius-full">, z.ZodLiteral<"--border-width-regular">, z.ZodLiteral<"--shadow-hairline">, z.ZodLiteral<"--shadow-sm">, z.ZodLiteral<"--shadow-md">, z.ZodLiteral<"--shadow-lg">]>, z.ZodUnion<readonly [z.ZodString, z.ZodUndefined]>>;
 /**
  * @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 declare const McpUiOpenLinkRequestSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/open-link">;
@@ -33,14 +33,14 @@ export declare const McpUiOpenLinkRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * @description Result from opening a URL.
- * @see {@link McpUiOpenLinkRequest}
+ * @see {@link McpUiOpenLinkRequest `McpUiOpenLinkRequest`}
  */
 export declare const McpUiOpenLinkResultSchema: z.ZodObject<{
     isError: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$loose>;
 /**
  * @description Result from sending a message.
- * @see {@link McpUiMessageRequest}
+ * @see {@link McpUiMessageRequest `McpUiMessageRequest`}
  */
 export declare const McpUiMessageResultSchema: z.ZodObject<{
     isError: z.ZodOptional<z.ZodBoolean>;
@@ -48,7 +48,7 @@ export declare const McpUiMessageResultSchema: z.ZodObject<{
 /**
  * @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 declare const McpUiSandboxProxyReadyNotificationSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/notifications/sandbox-proxy-ready">;
@@ -75,8 +75,8 @@ export declare const McpUiResourcePermissionsSchema: z.ZodObject<{
     clipboardWrite: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
 }, z.core.$strip>;
 /**
- * @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 declare const McpUiSizeChangedNotificationSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/notifications/size-changed">;
@@ -86,7 +86,7 @@ export declare const McpUiSizeChangedNotificationSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 /**
- * @description Notification containing complete tool arguments (Host -> Guest UI).
+ * @description Notification containing complete tool arguments (Host -> View).
  */
 export declare const McpUiToolInputNotificationSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/notifications/tool-input">;
@@ -95,7 +95,7 @@ export declare const McpUiToolInputNotificationSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 /**
- * @description Notification containing partial/streaming tool arguments (Host -> Guest UI).
+ * @description Notification containing partial/streaming tool arguments (Host -> View).
  */
 export declare const McpUiToolInputPartialNotificationSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/notifications/tool-input-partial">;
@@ -104,7 +104,7 @@ export declare const McpUiToolInputPartialNotificationSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 /**
- * @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.).
  */
@@ -130,8 +130,8 @@ export declare const McpUiHostStylesSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
- * @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 declare const McpUiResourceTeardownRequestSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/resource-teardown">;
@@ -139,7 +139,7 @@ export declare const McpUiResourceTeardownRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * @description Result from graceful shutdown request.
- * @see {@link McpUiResourceTeardownRequest}
+ * @see {@link McpUiResourceTeardownRequest `McpUiResourceTeardownRequest`}
  */
 export declare const McpUiResourceTeardownResultSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 export declare const McpUiSupportedContentBlockModalitiesSchema: z.ZodObject<{
@@ -152,7 +152,7 @@ export declare const McpUiSupportedContentBlockModalitiesSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * @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 declare const McpUiHostCapabilitiesSchema: z.ZodObject<{
     experimental: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
@@ -196,18 +196,19 @@ export declare const McpUiHostCapabilitiesSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
- * @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 declare const McpUiAppCapabilitiesSchema: z.ZodObject<{
     experimental: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
     tools: z.ZodOptional<z.ZodObject<{
         listChanged: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    availableDisplayModes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"inline">, z.ZodLiteral<"fullscreen">, z.ZodLiteral<"pip">]>>>;
 }, z.core.$strip>;
 /**
- * @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 declare const McpUiInitializedNotificationSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/notifications/initialized">;
@@ -236,7 +237,7 @@ export declare const McpUiResourceMetaSchema: z.ZodObject<{
  * @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 declare const McpUiRequestDisplayModeRequestSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/request-display-mode">;
@@ -246,7 +247,7 @@ export declare const McpUiRequestDisplayModeRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * @description Result from requesting a display mode change.
- * @see {@link McpUiRequestDisplayModeRequest}
+ * @see {@link McpUiRequestDisplayModeRequest `McpUiRequestDisplayModeRequest`}
  */
 export declare const McpUiRequestDisplayModeResultSchema: z.ZodObject<{
     mode: z.ZodUnion<readonly [z.ZodLiteral<"inline">, z.ZodLiteral<"fullscreen">, z.ZodLiteral<"pip">]>;
@@ -262,9 +263,19 @@ export declare const McpUiToolMetaSchema: z.ZodObject<{
     resourceUri: z.ZodOptional<z.ZodString>;
     visibility: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"model">, z.ZodLiteral<"app">]>>>;
 }, z.core.$strip>;
+/**
+ * @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 declare const McpUiClientCapabilitiesSchema: z.ZodObject<{
+    mimeTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
 /**
  * @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 declare const McpUiMessageRequestSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/message">;
@@ -361,7 +372,7 @@ export declare const McpUiMessageRequestSchema: z.ZodObject<{
 /**
  * @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 declare const McpUiSandboxResourceReadyNotificationSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/notifications/sandbox-resource-ready">;
@@ -383,7 +394,7 @@ export declare const McpUiSandboxResourceReadyNotificationSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 /**
- * @description Notification containing tool execution result (Host -> Guest UI).
+ * @description Notification containing tool execution result (Host -> View).
  */
 export declare const McpUiToolResultNotificationSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/notifications/tool-result">;
@@ -485,7 +496,7 @@ export declare const McpUiToolResultNotificationSchema: z.ZodObject<{
     }, z.core.$loose>;
 }, z.core.$strip>;
 /**
- * @description Rich context about the host environment provided to Guest UIs.
+ * @description Rich context about the host environment provided to views.
  */
 export declare const McpUiHostContextSchema: z.ZodObject<{
     toolInfo: z.ZodOptional<z.ZodObject<{
@@ -538,7 +549,7 @@ export declare const McpUiHostContextSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     displayMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"inline">, z.ZodLiteral<"fullscreen">, z.ZodLiteral<"pip">]>>;
-    availableDisplayModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    availableDisplayModes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"inline">, z.ZodLiteral<"fullscreen">, z.ZodLiteral<"pip">]>>>;
     containerDimensions: z.ZodOptional<z.ZodIntersection<z.ZodUnion<readonly [z.ZodObject<{
         height: z.ZodNumber;
     }, z.core.$strip>, z.ZodObject<{
@@ -564,8 +575,8 @@ export declare const McpUiHostContextSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$loose>;
 /**
- * @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 declare const McpUiHostContextChangedNotificationSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/notifications/host-context-changed">;
@@ -620,7 +631,7 @@ export declare const McpUiHostContextChangedNotificationSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         displayMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"inline">, z.ZodLiteral<"fullscreen">, z.ZodLiteral<"pip">]>>;
-        availableDisplayModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        availableDisplayModes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"inline">, z.ZodLiteral<"fullscreen">, z.ZodLiteral<"pip">]>>>;
         containerDimensions: z.ZodOptional<z.ZodIntersection<z.ZodUnion<readonly [z.ZodObject<{
             height: z.ZodNumber;
         }, z.core.$strip>, z.ZodObject<{
@@ -647,16 +658,16 @@ export declare const McpUiHostContextChangedNotificationSchema: z.ZodObject<{
     }, z.core.$loose>;
 }, z.core.$strip>;
 /**
- * @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 declare const McpUiUpdateModelContextRequestSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/update-model-context">;
@@ -751,8 +762,8 @@ export declare const McpUiUpdateModelContextRequestSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 /**
- * @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 declare const McpUiInitializeRequestSchema: z.ZodObject<{
     method: z.ZodLiteral<"ui/initialize">;
@@ -778,13 +789,14 @@ export declare const McpUiInitializeRequestSchema: z.ZodObject<{
             tools: z.ZodOptional<z.ZodObject<{
                 listChanged: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
+            availableDisplayModes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"inline">, z.ZodLiteral<"fullscreen">, z.ZodLiteral<"pip">]>>>;
         }, z.core.$strip>;
         protocolVersion: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
 /**
- * @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 declare const McpUiInitializeResultSchema: z.ZodObject<{
     protocolVersion: z.ZodString;
@@ -896,7 +908,7 @@ export declare const McpUiInitializeResultSchema: z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         displayMode: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"inline">, z.ZodLiteral<"fullscreen">, z.ZodLiteral<"pip">]>>;
-        availableDisplayModes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        availableDisplayModes: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<"inline">, z.ZodLiteral<"fullscreen">, z.ZodLiteral<"pip">]>>>;
         containerDimensions: z.ZodOptional<z.ZodIntersection<z.ZodUnion<readonly [z.ZodObject<{
             height: z.ZodNumber;
         }, z.core.$strip>, z.ZodObject<{

package/dist/src/generated/schema.test.d.ts

@@ -27,6 +27,7 @@ export type McpUiRequestDisplayModeRequestSchemaInferredType = z.infer<typeof ge
 export type McpUiRequestDisplayModeResultSchemaInferredType = z.infer<typeof generated.McpUiRequestDisplayModeResultSchema>;
 export type McpUiToolVisibilitySchemaInferredType = z.infer<typeof generated.McpUiToolVisibilitySchema>;
 export type McpUiToolMetaSchemaInferredType = z.infer<typeof generated.McpUiToolMetaSchema>;
+export type McpUiClientCapabilitiesSchemaInferredType = z.infer<typeof generated.McpUiClientCapabilitiesSchema>;
 export type McpUiMessageRequestSchemaInferredType = z.infer<typeof generated.McpUiMessageRequestSchema>;
 export type McpUiSandboxResourceReadyNotificationSchemaInferredType = z.infer<typeof generated.McpUiSandboxResourceReadyNotificationSchema>;
 export type McpUiToolResultNotificationSchemaInferredType = z.infer<typeof generated.McpUiToolResultNotificationSchema>;

package/dist/src/message-transport.d.ts

@@ -10,29 +10,29 @@ import { Transport, TransportSendOptions } from "@modelcontextprotocol/sdk/share
  * ## Security
  *
  * The `eventSource` parameter is required and validates the message source window
- * by checking `event.source`. For guest UIs, pass `window.parent`.
+ * by checking `event.source`. For views, pass `window.parent`.
  * For hosts, pass `iframe.contentWindow` to validate the iframe source.
  *
  * ## Usage
  *
- * **Guest UI**:
- * ```typescript
+ * **View**:
+ * ```ts source="./message-transport.examples.ts#PostMessageTransport_view"
  * const transport = new PostMessageTransport(window.parent, window.parent);
  * await app.connect(transport);
  * ```
  *
  * **Host**:
- * ```typescript
- * const iframe = document.getElementById('app-iframe') as HTMLIFrameElement;
+ * ```ts source="./message-transport.examples.ts#PostMessageTransport_host"
+ * const iframe = document.getElementById("app-iframe") as HTMLIFrameElement;
  * const transport = new PostMessageTransport(
  *   iframe.contentWindow!,
- *   iframe.contentWindow!
+ *   iframe.contentWindow!,
  * );
  * await bridge.connect(transport);
  * ```
  *
- * @see {@link app!App.connect} for Guest UI usage
- * @see {@link app-bridge!AppBridge.connect} for Host usage
+ * @see {@link app!App.connect `App.connect`} for View usage
+ * @see {@link app-bridge!AppBridge.connect `AppBridge.connect`} for Host usage
  */
 export declare class PostMessageTransport implements Transport {
     private eventTarget;
@@ -42,20 +42,20 @@ export declare class PostMessageTransport implements Transport {
      * Create a new PostMessageTransport.
      *
      * @param eventTarget - Target window to send messages to (default: `window.parent`)
-     * @param eventSource - Source window for message validation. For guests, pass
+     * @param eventSource - Source window for message validation. For views, pass
      *   `window.parent`. For hosts, pass `iframe.contentWindow`.
      *
-     * @example Guest UI connecting to parent
-     * ```typescript
+     * @example View connecting to parent
+     * ```ts source="./message-transport.examples.ts#PostMessageTransport_constructor_view"
      * const transport = new PostMessageTransport(window.parent, window.parent);
      * ```
      *
      * @example Host connecting to iframe
-     * ```typescript
-     * const iframe = document.getElementById('app') as HTMLIFrameElement;
+     * ```ts source="./message-transport.examples.ts#PostMessageTransport_constructor_host"
+     * const iframe = document.getElementById("app-iframe") as HTMLIFrameElement;
      * const transport = new PostMessageTransport(
      *   iframe.contentWindow!,
-     *   iframe.contentWindow!
+     *   iframe.contentWindow!,
      * );
      * ```
      */
@@ -80,13 +80,13 @@ export declare class PostMessageTransport implements Transport {
     /**
      * Stop listening for messages and cleanup.
      *
-     * Removes the message event listener and calls the {@link onclose} callback if set.
+     * Removes the message event listener and calls the {@link onclose `onclose`} callback if set.
      */
     close(): Promise<void>;
     /**
      * Called when the transport is closed.
      *
-     * Set this handler to be notified when {@link close} is called.
+     * Set this handler to be notified when {@link close `close`} is called.
      */
     onclose?: () => void;
     /**
@@ -101,7 +101,7 @@ export declare class PostMessageTransport implements Transport {
     /**
      * Called when a valid JSON-RPC message is received.
      *
-     * This handler is invoked after message validation succeeds. The {@link start}
+     * This handler is invoked after message validation succeeds. The {@link start `start`}
      * method must be called before messages will be received.
      *
      * @param message - The validated JSON-RPC message

package/dist/src/message-transport.examples.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Type-checked examples for {@link PostMessageTransport `PostMessageTransport`}.
+ *
+ * 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/react/index.d.ts

@@ -3,27 +3,25 @@
  *
  * This module provides React hooks and utilities for easily building
  * interactive MCP Apps using React. This is optional - the core SDK
- * ({@link App}, {@link PostMessageTransport}) is framework-agnostic and can be
+ * ({@link App `App`}, {@link PostMessageTransport `PostMessageTransport`}) is framework-agnostic and can be
  * used with any UI framework or vanilla JavaScript.
  *
  * ## Main Exports
  *
- * - {@link useApp} - React hook to create and connect an MCP App
- * - {@link useHostStyleVariables} - React hook to apply host style variables and theme
- * - {@link useHostFonts} - React hook to apply host fonts
- * - {@link useDocumentTheme} - React hook for reactive document theme
- * - {@link useAutoResize} - React hook for manual auto-resize control (rarely needed)
+ * - {@link useApp `useApp`} - React hook to create and connect an MCP App
+ * - {@link useHostStyleVariables `useHostStyleVariables`} - React hook to apply host style variables and theme
+ * - {@link useHostFonts `useHostFonts`} - React hook to apply host fonts
+ * - {@link useDocumentTheme `useDocumentTheme`} - React hook for reactive document theme
+ * - {@link useAutoResize `useAutoResize`} - React hook for manual auto-resize control (rarely needed)
  *
  * @module @modelcontextprotocol/ext-apps/react
  *
  * @example Basic React App
- * ```tsx
- * import { useApp } from '@modelcontextprotocol/ext-apps/react';
- *
+ * ```tsx source="./index.examples.tsx#index_basicReactApp"
  * function MyApp() {
  *   const { app, isConnected, error } = useApp({
  *     appInfo: { name: "MyApp", version: "1.0.0" },
- *     capabilities: {}
+ *     capabilities: {},
  *   });
  *
  *   if (error) return <div>Error: {error.message}</div>;

package/dist/src/react/index.examples.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Type-checked examples for the React module overview.
+ *
+ * @module
+ */
+export {};