@mcp-ts/sdk 1.3.9 → 1.4.0

package/dist/client/react.d.mts

@@ -1,10 +1,11 @@
-import { SSEClient, AppHost } from './index.mjs';
-export { SSEClientOptions } from './index.mjs';
+import { c as SSEClient, e as AppHostOptions, f as AppHostClient, a as AppHost } from '../index-CQr9q0bF.mjs';
+export { A as APP_HOST_DEFAULTS, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, d as SSEClientOptions } from '../index-CQr9q0bF.mjs';
 import { c as McpConnectionState, M as McpConnectionEvent } from '../events-CK3N--3g.mjs';
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-CK3N--3g.mjs';
 import { T as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CW6lghof.mjs';
 export { p as McpRpcRequest, q as McpRpcResponse } from '../types-CW6lghof.mjs';
 import React$1 from 'react';
+import '@modelcontextprotocol/ext-apps/app-bridge';
 import '@modelcontextprotocol/sdk/types.js';
 
 /**
@@ -172,23 +173,19 @@ declare function useMcp(options: UseMcpOptions): McpClient$1;
 /**
  * Hook to host an MCP App in a React component
  *
- * Optimized for instant loading:
- * - Creates AppHost synchronously
- * - Starts bridge connection immediately
- * - Returns host before connection completes (ready to call launch)
+ * Initialization is async but optimized for instant availability:
+ * - Constructor runs synchronously (sandbox + bridge handler setup)
+ * - Host is set in state immediately so launch() can be called right away
+ * - start() is a lightweight no-op reserved for future async pre-init work
+ * - The real async work (iframe load, bridge connect) happens inside launch()
  *
  * @param client - Connected SSEClient instance
  * @param iframeRef - Reference to the iframe element
  * @param options - Optional configuration
  * @returns Object containing the AppHost instance (or null) and error state
  */
-declare function useAppHost(client: SSEClient, iframeRef: React.RefObject<HTMLIFrameElement>, options?: {
-    /** Callback when the App sends a message (e.g. to chat) */
-    onMessage?: (params: {
-        role: string;
-        content: unknown;
-    }) => void;
-}): {
+type UseAppHostOptions = AppHostOptions;
+declare function useAppHost(client: AppHostClient | null, iframeRef: React.RefObject<HTMLIFrameElement>, options?: UseAppHostOptions): {
     host: AppHost | null;
     error: Error | null;
 };
@@ -222,42 +219,34 @@ interface McpAppMetadata {
     resourceUri: string;
     sessionId: string;
 }
-interface McpAppRendererProps {
-    mcpClient: McpClient | null;
+/**
+ * Imperative handle for {@link useMcpApps}'s `McpAppRenderer` (via `ref`),
+ * aligned with `@mcp-ui/client`'s `AppRendererHandle.teardownResource`.
+ */
+interface McpAppRendererHandle {
+    teardownResource: (params?: Record<string, unknown>) => void;
+}
+/** Props for {@link useMcpApps}'s `McpAppRenderer` (client is supplied via the hook). */
+interface McpAppRendererProps extends Pick<UseAppHostOptions, 'sandbox' | 'hostContext' | 'onCallTool' | 'onReadResource' | 'onFallbackRequest' | 'onMessage' | 'onOpenLink' | 'onLoggingMessage' | 'onSizeChanged' | 'onError'> {
     name: string;
+    toolResourceUri?: string;
+    html?: string;
     input?: Record<string, unknown>;
     result?: unknown;
-    status: 'executing' | 'inProgress' | 'complete' | 'idle';
-    /** Custom CSS class for the container */
+    status?: 'executing' | 'inProgress' | 'complete' | 'idle';
+    toolInputPartial?: any;
+    toolCancelled?: boolean;
     className?: string;
+    loader?: React$1.ReactNode;
 }
 /**
- * Simple hook to get MCP app metadata
- *
- * @param mcpClient - The MCP client from useMcp() or context
- * @returns Object with getAppMetadata function and McpAppRenderer component
- *
- * @example
- * ```tsx
- * function ToolRenderer(props) {
- *   const { getAppMetadata, McpAppRenderer } = useMcpApps(mcpClient);
- *   const metadata = getAppMetadata(props.name);
+ * Helpers scoped to one `mcpClient`. Pass the client here once; `McpAppRenderer` only needs per-tool props (`name`, `input`, `result`, `status`).
  *
- *   if (!metadata) return null;
- *   return (
- *     <McpAppRenderer
- *       metadata={metadata}
- *       input={props.args}
- *       result={props.result}
- *       status={props.status}
- *     />
- *   );
- * }
- * ```
+ * @param mcpClient - From `useMcp()` or context (for example `useMcpContext()`).
  */
 declare function useMcpApps(mcpClient: McpClient | null): {
     getAppMetadata: (toolName: string) => McpAppMetadata | undefined;
-    McpAppRenderer: React$1.NamedExoticComponent<McpAppRendererProps>;
+    McpAppRenderer: React$1.MemoExoticComponent<React$1.ForwardRefExoticComponent<McpAppRendererProps & React$1.RefAttributes<McpAppRendererHandle>>>;
 };
 
-export { AppHost, type McpClient$1 as McpClient, type McpConnection, McpConnectionEvent, McpConnectionState, SSEClient, ToolInfo, type UseMcpOptions, useAppHost, useMcp, useMcpApps };
+export { AppHost, type McpAppMetadata, type McpAppRendererHandle, type McpAppRendererProps, type McpClient$1 as McpClient, type McpConnection, McpConnectionEvent, McpConnectionState, SSEClient, ToolInfo, type UseMcpOptions, useAppHost, useMcp, useMcpApps };

package/dist/client/react.d.ts

@@ -1,10 +1,11 @@
-import { SSEClient, AppHost } from './index.js';
-export { SSEClientOptions } from './index.js';
+import { c as SSEClient, e as AppHostOptions, f as AppHostClient, a as AppHost } from '../index-nE_7Io0I.js';
+export { A as APP_HOST_DEFAULTS, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, d as SSEClientOptions } from '../index-nE_7Io0I.js';
 import { c as McpConnectionState, M as McpConnectionEvent } from '../events-CK3N--3g.js';
 export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, d as McpObservabilityEvent } from '../events-CK3N--3g.js';
 import { T as ToolInfo, k as FinishAuthResult, n as ListToolsRpcResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CW6lghof.js';
 export { p as McpRpcRequest, q as McpRpcResponse } from '../types-CW6lghof.js';
 import React$1 from 'react';
+import '@modelcontextprotocol/ext-apps/app-bridge';
 import '@modelcontextprotocol/sdk/types.js';
 
 /**
@@ -172,23 +173,19 @@ declare function useMcp(options: UseMcpOptions): McpClient$1;
 /**
  * Hook to host an MCP App in a React component
  *
- * Optimized for instant loading:
- * - Creates AppHost synchronously
- * - Starts bridge connection immediately
- * - Returns host before connection completes (ready to call launch)
+ * Initialization is async but optimized for instant availability:
+ * - Constructor runs synchronously (sandbox + bridge handler setup)
+ * - Host is set in state immediately so launch() can be called right away
+ * - start() is a lightweight no-op reserved for future async pre-init work
+ * - The real async work (iframe load, bridge connect) happens inside launch()
  *
  * @param client - Connected SSEClient instance
  * @param iframeRef - Reference to the iframe element
  * @param options - Optional configuration
  * @returns Object containing the AppHost instance (or null) and error state
  */
-declare function useAppHost(client: SSEClient, iframeRef: React.RefObject<HTMLIFrameElement>, options?: {
-    /** Callback when the App sends a message (e.g. to chat) */
-    onMessage?: (params: {
-        role: string;
-        content: unknown;
-    }) => void;
-}): {
+type UseAppHostOptions = AppHostOptions;
+declare function useAppHost(client: AppHostClient | null, iframeRef: React.RefObject<HTMLIFrameElement>, options?: UseAppHostOptions): {
     host: AppHost | null;
     error: Error | null;
 };
@@ -222,42 +219,34 @@ interface McpAppMetadata {
     resourceUri: string;
     sessionId: string;
 }
-interface McpAppRendererProps {
-    mcpClient: McpClient | null;
+/**
+ * Imperative handle for {@link useMcpApps}'s `McpAppRenderer` (via `ref`),
+ * aligned with `@mcp-ui/client`'s `AppRendererHandle.teardownResource`.
+ */
+interface McpAppRendererHandle {
+    teardownResource: (params?: Record<string, unknown>) => void;
+}
+/** Props for {@link useMcpApps}'s `McpAppRenderer` (client is supplied via the hook). */
+interface McpAppRendererProps extends Pick<UseAppHostOptions, 'sandbox' | 'hostContext' | 'onCallTool' | 'onReadResource' | 'onFallbackRequest' | 'onMessage' | 'onOpenLink' | 'onLoggingMessage' | 'onSizeChanged' | 'onError'> {
     name: string;
+    toolResourceUri?: string;
+    html?: string;
     input?: Record<string, unknown>;
     result?: unknown;
-    status: 'executing' | 'inProgress' | 'complete' | 'idle';
-    /** Custom CSS class for the container */
+    status?: 'executing' | 'inProgress' | 'complete' | 'idle';
+    toolInputPartial?: any;
+    toolCancelled?: boolean;
     className?: string;
+    loader?: React$1.ReactNode;
 }
 /**
- * Simple hook to get MCP app metadata
- *
- * @param mcpClient - The MCP client from useMcp() or context
- * @returns Object with getAppMetadata function and McpAppRenderer component
- *
- * @example
- * ```tsx
- * function ToolRenderer(props) {
- *   const { getAppMetadata, McpAppRenderer } = useMcpApps(mcpClient);
- *   const metadata = getAppMetadata(props.name);
+ * Helpers scoped to one `mcpClient`. Pass the client here once; `McpAppRenderer` only needs per-tool props (`name`, `input`, `result`, `status`).
  *
- *   if (!metadata) return null;
- *   return (
- *     <McpAppRenderer
- *       metadata={metadata}
- *       input={props.args}
- *       result={props.result}
- *       status={props.status}
- *     />
- *   );
- * }
- * ```
+ * @param mcpClient - From `useMcp()` or context (for example `useMcpContext()`).
  */
 declare function useMcpApps(mcpClient: McpClient | null): {
     getAppMetadata: (toolName: string) => McpAppMetadata | undefined;
-    McpAppRenderer: React$1.NamedExoticComponent<McpAppRendererProps>;
+    McpAppRenderer: React$1.MemoExoticComponent<React$1.ForwardRefExoticComponent<McpAppRendererProps & React$1.RefAttributes<McpAppRendererHandle>>>;
 };
 
-export { AppHost, type McpClient$1 as McpClient, type McpConnection, McpConnectionEvent, McpConnectionState, SSEClient, ToolInfo, type UseMcpOptions, useAppHost, useMcp, useMcpApps };
+export { AppHost, type McpAppMetadata, type McpAppRendererHandle, type McpAppRendererProps, type McpClient$1 as McpClient, type McpConnection, McpConnectionEvent, McpConnectionState, SSEClient, ToolInfo, type UseMcpOptions, useAppHost, useMcp, useMcpApps };