@mcp-ts/sdk 1.3.9 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/README.md +0 -1
  2. package/dist/adapters/langchain-adapter.js.map +1 -1
  3. package/dist/adapters/langchain-adapter.mjs.map +1 -1
  4. package/dist/client/index.d.mts +3 -189
  5. package/dist/client/index.d.ts +3 -189
  6. package/dist/client/index.js +218 -54
  7. package/dist/client/index.js.map +1 -1
  8. package/dist/client/index.mjs +215 -55
  9. package/dist/client/index.mjs.map +1 -1
  10. package/dist/client/react.d.mts +29 -40
  11. package/dist/client/react.d.ts +29 -40
  12. package/dist/client/react.js +492 -147
  13. package/dist/client/react.js.map +1 -1
  14. package/dist/client/react.mjs +490 -149
  15. package/dist/client/react.mjs.map +1 -1
  16. package/dist/client/vue.d.mts +3 -2
  17. package/dist/client/vue.d.ts +3 -2
  18. package/dist/client/vue.js +239 -63
  19. package/dist/client/vue.js.map +1 -1
  20. package/dist/client/vue.mjs +236 -64
  21. package/dist/client/vue.mjs.map +1 -1
  22. package/dist/index-CQr9q0bF.d.mts +295 -0
  23. package/dist/index-nE_7Io0I.d.ts +295 -0
  24. package/dist/index.d.mts +2 -1
  25. package/dist/index.d.ts +2 -1
  26. package/dist/index.js +315 -64
  27. package/dist/index.js.map +1 -1
  28. package/dist/index.mjs +303 -65
  29. package/dist/index.mjs.map +1 -1
  30. package/dist/server/index.js +93 -10
  31. package/dist/server/index.js.map +1 -1
  32. package/dist/server/index.mjs +88 -10
  33. package/dist/server/index.mjs.map +1 -1
  34. package/package.json +13 -11
  35. package/src/adapters/langchain-adapter.ts +1 -1
  36. package/src/client/core/app-host.ts +252 -65
  37. package/src/client/core/constants.ts +30 -0
  38. package/src/client/index.ts +6 -1
  39. package/src/client/react/index.ts +6 -1
  40. package/src/client/react/use-app-host.ts +13 -19
  41. package/src/client/react/use-mcp-apps.tsx +297 -125
  42. package/src/client/react/use-mcp.ts +75 -36
  43. package/src/client/utils/app-host-utils.ts +62 -0
  44. package/src/client/vue/use-mcp.ts +23 -12
  45. package/src/server/mcp/oauth-client.ts +31 -8
  46. package/src/server/storage/crypto.ts +92 -0
  47. package/src/server/storage/supabase-backend.ts +7 -6
package/README.md CHANGED
@@ -270,7 +270,6 @@ export function ToolRenderer() {
270
270
  name: "*",
271
271
  render: ({ name, args, result, status }) => (
272
272
  <McpAppRenderer
273
- mcpClient={mcpClient}
274
273
  name={name}
275
274
  input={args}
276
275
  result={result}
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/adapters/langchain-adapter.ts"],"names":[],"mappings":"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","file":"langchain-adapter.js","sourcesContent":["import { MCPClient } from '../server/mcp/oauth-client';\nimport { MultiSessionClient } from '../server/mcp/multi-session-client';\nimport type { DynamicStructuredTool, StructuredTool } from '@langchain/core/tools';\nimport type { z } from 'zod';\n\nexport interface LangChainAdapterOptions {\n /** \n * Prefix for tool names to avoid collision with other tools.\n * Defaults to the client's serverId.\n */\n prefix?: string;\n\n /**\n * Whether to simplify error messages returned to the LLM.\n * If true, returns \"Error: <message>\" string instead of throwing.\n * @default false\n */\n simplifyErrors?: boolean;\n}\n\n/**\n * Adapter to use MCP tools within LangChain/LangGraph agents.\n */\nexport class LangChainAdapter {\n private DynamicStructuredTool: typeof DynamicStructuredTool | undefined;\n private z: typeof z | undefined;\n\n constructor(\n private client: MCPClient | MultiSessionClient,\n private options: LangChainAdapterOptions = {}\n ) { }\n\n /**\n * Lazy-loads LangChain and Zod dependencies\n */\n private async ensureDependencies() {\n if (!this.DynamicStructuredTool) {\n try {\n const langchain = await import('@langchain/core/tools');\n this.DynamicStructuredTool = langchain.DynamicStructuredTool;\n\n const zod = await import('zod');\n this.z = zod.z;\n } catch (error) {\n throw new Error(\n 'LangChain dependencies not installed. Install with:\\n' +\n ' npm install @langchain/core zod'\n );\n }\n }\n }\n\n private async transformTools(client: MCPClient): Promise<StructuredTool[]> {\n if (!client.isConnected()) {\n return [];\n }\n\n await this.ensureDependencies();\n\n const result = await client.listTools();\n const prefix = this.options.prefix ?? client.getServerId()?.replace(/-/g, '').substring(0, 8) ?? 'mcp';\n\n return result.tools.map((tool) => {\n // In a real implementation, you would use a library like 'json-schema-to-zod'\n const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n return new this.DynamicStructuredTool!({\n name: `${prefix}_${tool.name}`,\n description: tool.description || `Tool ${tool.name}`,\n schema: schema,\n func: async (args: any) => {\n try {\n return await client.callTool(tool.name, args);\n } catch (error: any) {\n if (this.options.simplifyErrors) {\n return `Error: ${error.message}`;\n }\n throw error;\n }\n },\n });\n });\n }\n\n private jsonSchemaToZod(schema: any): z.ZodType<any> {\n try {\n const { parseSchema } = require('json-schema-to-zod');\n const zodSchemaString = parseSchema(schema);\n // eslint-disable-next-line\n return new Function('z', 'return ' + zodSchemaString)(this.z);\n } catch (error) {\n // Fallback: Accept any object if conversion fails\n console.warn('[LangChainAdapter] Failed to convert JSON Schema to Zod, using fallback:', error);\n return this.z!.record(this.z!.any()).optional().describe(\"Dynamic Input\");\n }\n }\n\n /**\n * Fetches tools from the MCP server and converts them to LangChain StructuredTools.\n */\n async getTools(): Promise<StructuredTool[]> {\n // Use duck typing instead of instanceof to handle module bundling issues\n const isMultiSession = typeof (this.client as any).getClients === 'function';\n const clients = isMultiSession\n ? (this.client as MultiSessionClient).getClients()\n : [this.client as MCPClient];\n\n const results = await Promise.all(\n clients.map(async (client) => {\n try {\n return await this.transformTools(client);\n } catch (error) {\n console.error(`[LangChainAdapter] Failed to fetch tools from ${client.getServerId()}:`, error);\n return [];\n }\n })\n );\n return results.flat();\n }\n\n /**\n * Convenience static method to fetch tools in a single line.\n */\n static async getTools(client: MCPClient | MultiSessionClient, options: LangChainAdapterOptions = {}): Promise<StructuredTool[]> {\n return new LangChainAdapter(client, options).getTools();\n }\n}\n"]}
1
+ {"version":3,"sources":["../../src/adapters/langchain-adapter.ts"],"names":[],"mappings":"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","file":"langchain-adapter.js","sourcesContent":["import { MCPClient } from '../server/mcp/oauth-client';\nimport { MultiSessionClient } from '../server/mcp/multi-session-client';\nimport type { DynamicStructuredTool, StructuredTool } from '@langchain/core/tools';\nimport type { z } from 'zod';\n\nexport interface LangChainAdapterOptions {\n /** \n * Prefix for tool names to avoid collision with other tools.\n * Defaults to the client's serverId.\n */\n prefix?: string;\n\n /**\n * Whether to simplify error messages returned to the LLM.\n * If true, returns \"Error: <message>\" string instead of throwing.\n * @default false\n */\n simplifyErrors?: boolean;\n}\n\n/**\n * Adapter to use MCP tools within LangChain/LangGraph agents.\n */\nexport class LangChainAdapter {\n private DynamicStructuredTool: typeof DynamicStructuredTool | undefined;\n private z: typeof z | undefined;\n\n constructor(\n private client: MCPClient | MultiSessionClient,\n private options: LangChainAdapterOptions = {}\n ) { }\n\n /**\n * Lazy-loads LangChain and Zod dependencies\n */\n private async ensureDependencies() {\n if (!this.DynamicStructuredTool) {\n try {\n const langchain = await import('@langchain/core/tools');\n this.DynamicStructuredTool = langchain.DynamicStructuredTool as any;\n\n const zod = await import('zod');\n this.z = zod.z;\n } catch (error) {\n throw new Error(\n 'LangChain dependencies not installed. Install with:\\n' +\n ' npm install @langchain/core zod'\n );\n }\n }\n }\n\n private async transformTools(client: MCPClient): Promise<StructuredTool[]> {\n if (!client.isConnected()) {\n return [];\n }\n\n await this.ensureDependencies();\n\n const result = await client.listTools();\n const prefix = this.options.prefix ?? client.getServerId()?.replace(/-/g, '').substring(0, 8) ?? 'mcp';\n\n return result.tools.map((tool) => {\n // In a real implementation, you would use a library like 'json-schema-to-zod'\n const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n return new this.DynamicStructuredTool!({\n name: `${prefix}_${tool.name}`,\n description: tool.description || `Tool ${tool.name}`,\n schema: schema,\n func: async (args: any) => {\n try {\n return await client.callTool(tool.name, args);\n } catch (error: any) {\n if (this.options.simplifyErrors) {\n return `Error: ${error.message}`;\n }\n throw error;\n }\n },\n });\n });\n }\n\n private jsonSchemaToZod(schema: any): z.ZodType<any> {\n try {\n const { parseSchema } = require('json-schema-to-zod');\n const zodSchemaString = parseSchema(schema);\n // eslint-disable-next-line\n return new Function('z', 'return ' + zodSchemaString)(this.z);\n } catch (error) {\n // Fallback: Accept any object if conversion fails\n console.warn('[LangChainAdapter] Failed to convert JSON Schema to Zod, using fallback:', error);\n return this.z!.record(this.z!.any()).optional().describe(\"Dynamic Input\");\n }\n }\n\n /**\n * Fetches tools from the MCP server and converts them to LangChain StructuredTools.\n */\n async getTools(): Promise<StructuredTool[]> {\n // Use duck typing instead of instanceof to handle module bundling issues\n const isMultiSession = typeof (this.client as any).getClients === 'function';\n const clients = isMultiSession\n ? (this.client as MultiSessionClient).getClients()\n : [this.client as MCPClient];\n\n const results = await Promise.all(\n clients.map(async (client) => {\n try {\n return await this.transformTools(client);\n } catch (error) {\n console.error(`[LangChainAdapter] Failed to fetch tools from ${client.getServerId()}:`, error);\n return [];\n }\n })\n );\n return results.flat();\n }\n\n /**\n * Convenience static method to fetch tools in a single line.\n */\n static async getTools(client: MCPClient | MultiSessionClient, options: LangChainAdapterOptions = {}): Promise<StructuredTool[]> {\n return new LangChainAdapter(client, options).getTools();\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/adapters/langchain-adapter.ts"],"names":[],"mappings":"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","file":"langchain-adapter.mjs","sourcesContent":["import { MCPClient } from '../server/mcp/oauth-client';\nimport { MultiSessionClient } from '../server/mcp/multi-session-client';\nimport type { DynamicStructuredTool, StructuredTool } from '@langchain/core/tools';\nimport type { z } from 'zod';\n\nexport interface LangChainAdapterOptions {\n /** \n * Prefix for tool names to avoid collision with other tools.\n * Defaults to the client's serverId.\n */\n prefix?: string;\n\n /**\n * Whether to simplify error messages returned to the LLM.\n * If true, returns \"Error: <message>\" string instead of throwing.\n * @default false\n */\n simplifyErrors?: boolean;\n}\n\n/**\n * Adapter to use MCP tools within LangChain/LangGraph agents.\n */\nexport class LangChainAdapter {\n private DynamicStructuredTool: typeof DynamicStructuredTool | undefined;\n private z: typeof z | undefined;\n\n constructor(\n private client: MCPClient | MultiSessionClient,\n private options: LangChainAdapterOptions = {}\n ) { }\n\n /**\n * Lazy-loads LangChain and Zod dependencies\n */\n private async ensureDependencies() {\n if (!this.DynamicStructuredTool) {\n try {\n const langchain = await import('@langchain/core/tools');\n this.DynamicStructuredTool = langchain.DynamicStructuredTool;\n\n const zod = await import('zod');\n this.z = zod.z;\n } catch (error) {\n throw new Error(\n 'LangChain dependencies not installed. Install with:\\n' +\n ' npm install @langchain/core zod'\n );\n }\n }\n }\n\n private async transformTools(client: MCPClient): Promise<StructuredTool[]> {\n if (!client.isConnected()) {\n return [];\n }\n\n await this.ensureDependencies();\n\n const result = await client.listTools();\n const prefix = this.options.prefix ?? client.getServerId()?.replace(/-/g, '').substring(0, 8) ?? 'mcp';\n\n return result.tools.map((tool) => {\n // In a real implementation, you would use a library like 'json-schema-to-zod'\n const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n return new this.DynamicStructuredTool!({\n name: `${prefix}_${tool.name}`,\n description: tool.description || `Tool ${tool.name}`,\n schema: schema,\n func: async (args: any) => {\n try {\n return await client.callTool(tool.name, args);\n } catch (error: any) {\n if (this.options.simplifyErrors) {\n return `Error: ${error.message}`;\n }\n throw error;\n }\n },\n });\n });\n }\n\n private jsonSchemaToZod(schema: any): z.ZodType<any> {\n try {\n const { parseSchema } = require('json-schema-to-zod');\n const zodSchemaString = parseSchema(schema);\n // eslint-disable-next-line\n return new Function('z', 'return ' + zodSchemaString)(this.z);\n } catch (error) {\n // Fallback: Accept any object if conversion fails\n console.warn('[LangChainAdapter] Failed to convert JSON Schema to Zod, using fallback:', error);\n return this.z!.record(this.z!.any()).optional().describe(\"Dynamic Input\");\n }\n }\n\n /**\n * Fetches tools from the MCP server and converts them to LangChain StructuredTools.\n */\n async getTools(): Promise<StructuredTool[]> {\n // Use duck typing instead of instanceof to handle module bundling issues\n const isMultiSession = typeof (this.client as any).getClients === 'function';\n const clients = isMultiSession\n ? (this.client as MultiSessionClient).getClients()\n : [this.client as MCPClient];\n\n const results = await Promise.all(\n clients.map(async (client) => {\n try {\n return await this.transformTools(client);\n } catch (error) {\n console.error(`[LangChainAdapter] Failed to fetch tools from ${client.getServerId()}:`, error);\n return [];\n }\n })\n );\n return results.flat();\n }\n\n /**\n * Convenience static method to fetch tools in a single line.\n */\n static async getTools(client: MCPClient | MultiSessionClient, options: LangChainAdapterOptions = {}): Promise<StructuredTool[]> {\n return new LangChainAdapter(client, options).getTools();\n }\n}\n"]}
1
+ {"version":3,"sources":["../../src/adapters/langchain-adapter.ts"],"names":[],"mappings":"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","file":"langchain-adapter.mjs","sourcesContent":["import { MCPClient } from '../server/mcp/oauth-client';\nimport { MultiSessionClient } from '../server/mcp/multi-session-client';\nimport type { DynamicStructuredTool, StructuredTool } from '@langchain/core/tools';\nimport type { z } from 'zod';\n\nexport interface LangChainAdapterOptions {\n /** \n * Prefix for tool names to avoid collision with other tools.\n * Defaults to the client's serverId.\n */\n prefix?: string;\n\n /**\n * Whether to simplify error messages returned to the LLM.\n * If true, returns \"Error: <message>\" string instead of throwing.\n * @default false\n */\n simplifyErrors?: boolean;\n}\n\n/**\n * Adapter to use MCP tools within LangChain/LangGraph agents.\n */\nexport class LangChainAdapter {\n private DynamicStructuredTool: typeof DynamicStructuredTool | undefined;\n private z: typeof z | undefined;\n\n constructor(\n private client: MCPClient | MultiSessionClient,\n private options: LangChainAdapterOptions = {}\n ) { }\n\n /**\n * Lazy-loads LangChain and Zod dependencies\n */\n private async ensureDependencies() {\n if (!this.DynamicStructuredTool) {\n try {\n const langchain = await import('@langchain/core/tools');\n this.DynamicStructuredTool = langchain.DynamicStructuredTool as any;\n\n const zod = await import('zod');\n this.z = zod.z;\n } catch (error) {\n throw new Error(\n 'LangChain dependencies not installed. Install with:\\n' +\n ' npm install @langchain/core zod'\n );\n }\n }\n }\n\n private async transformTools(client: MCPClient): Promise<StructuredTool[]> {\n if (!client.isConnected()) {\n return [];\n }\n\n await this.ensureDependencies();\n\n const result = await client.listTools();\n const prefix = this.options.prefix ?? client.getServerId()?.replace(/-/g, '').substring(0, 8) ?? 'mcp';\n\n return result.tools.map((tool) => {\n // In a real implementation, you would use a library like 'json-schema-to-zod'\n const schema = this.jsonSchemaToZod(tool.inputSchema);\n\n return new this.DynamicStructuredTool!({\n name: `${prefix}_${tool.name}`,\n description: tool.description || `Tool ${tool.name}`,\n schema: schema,\n func: async (args: any) => {\n try {\n return await client.callTool(tool.name, args);\n } catch (error: any) {\n if (this.options.simplifyErrors) {\n return `Error: ${error.message}`;\n }\n throw error;\n }\n },\n });\n });\n }\n\n private jsonSchemaToZod(schema: any): z.ZodType<any> {\n try {\n const { parseSchema } = require('json-schema-to-zod');\n const zodSchemaString = parseSchema(schema);\n // eslint-disable-next-line\n return new Function('z', 'return ' + zodSchemaString)(this.z);\n } catch (error) {\n // Fallback: Accept any object if conversion fails\n console.warn('[LangChainAdapter] Failed to convert JSON Schema to Zod, using fallback:', error);\n return this.z!.record(this.z!.any()).optional().describe(\"Dynamic Input\");\n }\n }\n\n /**\n * Fetches tools from the MCP server and converts them to LangChain StructuredTools.\n */\n async getTools(): Promise<StructuredTool[]> {\n // Use duck typing instead of instanceof to handle module bundling issues\n const isMultiSession = typeof (this.client as any).getClients === 'function';\n const clients = isMultiSession\n ? (this.client as MultiSessionClient).getClients()\n : [this.client as MCPClient];\n\n const results = await Promise.all(\n clients.map(async (client) => {\n try {\n return await this.transformTools(client);\n } catch (error) {\n console.error(`[LangChainAdapter] Failed to fetch tools from ${client.getServerId()}:`, error);\n return [];\n }\n })\n );\n return results.flat();\n }\n\n /**\n * Convenience static method to fetch tools in a single line.\n */\n static async getTools(client: MCPClient | MultiSessionClient, options: LangChainAdapterOptions = {}): Promise<StructuredTool[]> {\n return new LangChainAdapter(client, options).getTools();\n }\n}\n"]}
@@ -1,191 +1,5 @@
1
- import { M as McpConnectionEvent, d as McpObservabilityEvent, e as McpAppsUIEvent } from '../events-CK3N--3g.mjs';
2
- export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, c as McpConnectionState } from '../events-CK3N--3g.mjs';
3
- import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CW6lghof.mjs';
1
+ export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, c as SSEClient, d as SSEClientOptions } from '../index-CQr9q0bF.mjs';
2
+ export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-CK3N--3g.mjs';
4
3
  export { p as McpRpcRequest, q as McpRpcResponse, T as ToolInfo } from '../types-CW6lghof.mjs';
4
+ import '@modelcontextprotocol/ext-apps/app-bridge';
5
5
  import '@modelcontextprotocol/sdk/types.js';
6
-
7
- /**
8
- * Stateless RPC-over-stream client for MCP connections.
9
- *
10
- * Uses single POST requests with `Accept: text/event-stream` for every RPC call.
11
- * Progress events and the final rpc-response are delivered in the same response.
12
- */
13
-
14
- interface SSEClientOptions {
15
- /** MCP endpoint URL */
16
- url: string;
17
- /** User/Client identifier */
18
- identity: string;
19
- /** Optional auth token for authenticated requests */
20
- authToken?: string;
21
- /** Callback for MCP connection state changes */
22
- onConnectionEvent?: (event: McpConnectionEvent) => void;
23
- /** Callback for observability/logging events */
24
- onObservabilityEvent?: (event: McpObservabilityEvent) => void;
25
- /** Callback for connection status changes */
26
- onStatusChange?: (status: ConnectionStatus) => void;
27
- /** Callback for MCP App UI events */
28
- onEvent?: (event: McpAppsUIEvent) => void;
29
- /** Enable debug logging @default false */
30
- debug?: boolean;
31
- }
32
- type ConnectionStatus = 'connecting' | 'connected' | 'disconnected' | 'error';
33
- declare class SSEClient {
34
- private readonly options;
35
- private resourceCache;
36
- private connected;
37
- constructor(options: SSEClientOptions);
38
- connect(): void;
39
- disconnect(): void;
40
- isConnected(): boolean;
41
- getSessions(): Promise<SessionListResult>;
42
- connectToServer(params: ConnectParams): Promise<ConnectResult>;
43
- disconnectFromServer(sessionId: string): Promise<DisconnectResult>;
44
- listTools(sessionId: string): Promise<ListToolsRpcResult>;
45
- callTool(sessionId: string, toolName: string, toolArgs: Record<string, unknown>): Promise<unknown>;
46
- restoreSession(sessionId: string): Promise<RestoreSessionResult>;
47
- finishAuth(sessionId: string, code: string): Promise<FinishAuthResult>;
48
- listPrompts(sessionId: string): Promise<ListPromptsResult>;
49
- getPrompt(sessionId: string, name: string, args?: Record<string, string>): Promise<unknown>;
50
- listResources(sessionId: string): Promise<ListResourcesResult>;
51
- readResource(sessionId: string, uri: string): Promise<unknown>;
52
- preloadToolUiResources(sessionId: string, tools: Array<{
53
- name: string;
54
- _meta?: unknown;
55
- }>): void;
56
- getOrFetchResource(sessionId: string, uri: string): Promise<unknown>;
57
- hasPreloadedResource(uri: string): boolean;
58
- clearResourceCache(): void;
59
- private sendRequest;
60
- private readRpcResponseFromStream;
61
- private sleep;
62
- private parseRpcResponse;
63
- private buildUrl;
64
- private buildHeaders;
65
- private extractUiResourceUri;
66
- private emitUiEventIfPresent;
67
- private log;
68
- }
69
-
70
- /**
71
- * Abstraction layer for the AppHost's network communication.
72
- *
73
- * This interface decouples the `AppHost` from the concrete networking implementation (like `SSEClient`).
74
- * Implementation can be:
75
- * 1. `SSEClient`: Direct connection to MCP Server (Browser -> Server).
76
- * 2. `ProxyClient`: Connection via an intermediary API (Browser -> Next.js API -> Server).
77
- */
78
- interface AppHostClient {
79
- /**
80
- * Check if the client is connected
81
- */
82
- isConnected(): boolean;
83
- /**
84
- * Get list of active sessions
85
- */
86
- getSessions(): Promise<SessionListResult>;
87
- /**
88
- * Call a tool on a specific session
89
- */
90
- callTool(sessionId: string, toolName: string, toolArgs: Record<string, unknown>): Promise<unknown>;
91
- /**
92
- * Read a resource from a specific session
93
- */
94
- readResource(sessionId: string, uri: string): Promise<unknown>;
95
- }
96
-
97
- /**
98
- * MCP App Host
99
- *
100
- * Bridges the gap between an iframe (MCP App) and the SSEClient (MCP Server).
101
- * Handles secure iframe sandboxing, resource loading, and bi-directional
102
- * communication via the AppBridge protocol.
103
- *
104
- * Key features:
105
- * - Secure iframe sandboxing with minimal permissions
106
- * - Resource preloading for instant MCP App UI loading
107
- * - Cache-aware resource fetching (SSEClient cache → local cache → direct fetch)
108
- * - Support for ui:// and mcp-app:// resource URIs
109
- */
110
-
111
- interface AppHostOptions {
112
- /** Enable debug logging @default false */
113
- debug?: boolean;
114
- }
115
- interface AppMessageParams {
116
- role: string;
117
- content: unknown;
118
- }
119
- /**
120
- * Host for MCP Apps embedded in iframes.
121
- * Manages secure communication between the app and the MCP server.
122
- */
123
- declare class AppHost {
124
- private readonly client;
125
- private readonly iframe;
126
- private bridge;
127
- private sessionId?;
128
- private resourceCache;
129
- private debug;
130
- /** Callback for app messages (e.g., chat messages from the app) */
131
- onAppMessage?: (params: AppMessageParams) => void;
132
- constructor(client: AppHostClient, iframe: HTMLIFrameElement, options?: AppHostOptions);
133
- /**
134
- * Start the host. This prepares the bridge handlers but doesn't connect yet.
135
- * The actual connection happens in launch() after HTML is loaded.
136
- * @returns Promise that resolves immediately (bridge connects during launch)
137
- */
138
- start(): Promise<void>;
139
- /**
140
- * Preload UI resources to enable instant app loading.
141
- * Call this when tools are discovered to cache their UI resources.
142
- */
143
- preload(tools: Array<{
144
- _meta?: unknown;
145
- }>): void;
146
- /**
147
- * Launch an MCP App from a URL or MCP resource URI.
148
- * Loads the HTML first, then establishes bridge connection.
149
- */
150
- launch(url: string, sessionId?: string): Promise<void>;
151
- /**
152
- * Wait for app to signal initialization complete
153
- */
154
- private onAppReady;
155
- /**
156
- * Wait for iframe to finish loading
157
- */
158
- private onIframeReady;
159
- /**
160
- * Send tool input arguments to the MCP App.
161
- * Call this after launch() when tool input is available.
162
- */
163
- sendToolInput(args: Record<string, unknown>): void;
164
- /**
165
- * Send tool result to the MCP App.
166
- * Call this when the tool call completes.
167
- */
168
- sendToolResult(result: unknown): void;
169
- /**
170
- * Send tool cancellation to the MCP App.
171
- * Call this when the tool call is cancelled or fails.
172
- */
173
- sendToolCancelled(reason: string): void;
174
- private configureSandbox;
175
- private initializeBridge;
176
- private connectBridge;
177
- private handleToolCall;
178
- private handleOpenLink;
179
- private handleMessage;
180
- private launchMcpApp;
181
- private fetchResourceWithCache;
182
- private preloadResource;
183
- private getSessionId;
184
- private isMcpUri;
185
- private hasClientCache;
186
- private extractUiResourceUri;
187
- private decodeContent;
188
- private log;
189
- }
190
-
191
- export { AppHost, McpConnectionEvent, McpObservabilityEvent, SSEClient, type SSEClientOptions };
@@ -1,191 +1,5 @@
1
- import { M as McpConnectionEvent, d as McpObservabilityEvent, e as McpAppsUIEvent } from '../events-CK3N--3g.js';
2
- export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, c as McpConnectionState } from '../events-CK3N--3g.js';
3
- import { s as SessionListResult, e as ConnectParams, h as ConnectResult, j as DisconnectResult, n as ListToolsRpcResult, r as RestoreSessionResult, k as FinishAuthResult, L as ListPromptsResult, l as ListResourcesResult } from '../types-CW6lghof.js';
1
+ export { A as APP_HOST_DEFAULTS, a as AppHost, D as DEFAULT_MCP_APP_CSP, S as SANDBOX_PROXY_READY_METHOD, b as SANDBOX_RESOURCE_READY_METHOD, c as SSEClient, d as SSEClientOptions } from '../index-nE_7Io0I.js';
2
+ export { D as Disposable, a as DisposableStore, E as Emitter, b as Event, M as McpConnectionEvent, c as McpConnectionState, d as McpObservabilityEvent } from '../events-CK3N--3g.js';
4
3
  export { p as McpRpcRequest, q as McpRpcResponse, T as ToolInfo } from '../types-CW6lghof.js';
4
+ import '@modelcontextprotocol/ext-apps/app-bridge';
5
5
  import '@modelcontextprotocol/sdk/types.js';
6
-
7
- /**
8
- * Stateless RPC-over-stream client for MCP connections.
9
- *
10
- * Uses single POST requests with `Accept: text/event-stream` for every RPC call.
11
- * Progress events and the final rpc-response are delivered in the same response.
12
- */
13
-
14
- interface SSEClientOptions {
15
- /** MCP endpoint URL */
16
- url: string;
17
- /** User/Client identifier */
18
- identity: string;
19
- /** Optional auth token for authenticated requests */
20
- authToken?: string;
21
- /** Callback for MCP connection state changes */
22
- onConnectionEvent?: (event: McpConnectionEvent) => void;
23
- /** Callback for observability/logging events */
24
- onObservabilityEvent?: (event: McpObservabilityEvent) => void;
25
- /** Callback for connection status changes */
26
- onStatusChange?: (status: ConnectionStatus) => void;
27
- /** Callback for MCP App UI events */
28
- onEvent?: (event: McpAppsUIEvent) => void;
29
- /** Enable debug logging @default false */
30
- debug?: boolean;
31
- }
32
- type ConnectionStatus = 'connecting' | 'connected' | 'disconnected' | 'error';
33
- declare class SSEClient {
34
- private readonly options;
35
- private resourceCache;
36
- private connected;
37
- constructor(options: SSEClientOptions);
38
- connect(): void;
39
- disconnect(): void;
40
- isConnected(): boolean;
41
- getSessions(): Promise<SessionListResult>;
42
- connectToServer(params: ConnectParams): Promise<ConnectResult>;
43
- disconnectFromServer(sessionId: string): Promise<DisconnectResult>;
44
- listTools(sessionId: string): Promise<ListToolsRpcResult>;
45
- callTool(sessionId: string, toolName: string, toolArgs: Record<string, unknown>): Promise<unknown>;
46
- restoreSession(sessionId: string): Promise<RestoreSessionResult>;
47
- finishAuth(sessionId: string, code: string): Promise<FinishAuthResult>;
48
- listPrompts(sessionId: string): Promise<ListPromptsResult>;
49
- getPrompt(sessionId: string, name: string, args?: Record<string, string>): Promise<unknown>;
50
- listResources(sessionId: string): Promise<ListResourcesResult>;
51
- readResource(sessionId: string, uri: string): Promise<unknown>;
52
- preloadToolUiResources(sessionId: string, tools: Array<{
53
- name: string;
54
- _meta?: unknown;
55
- }>): void;
56
- getOrFetchResource(sessionId: string, uri: string): Promise<unknown>;
57
- hasPreloadedResource(uri: string): boolean;
58
- clearResourceCache(): void;
59
- private sendRequest;
60
- private readRpcResponseFromStream;
61
- private sleep;
62
- private parseRpcResponse;
63
- private buildUrl;
64
- private buildHeaders;
65
- private extractUiResourceUri;
66
- private emitUiEventIfPresent;
67
- private log;
68
- }
69
-
70
- /**
71
- * Abstraction layer for the AppHost's network communication.
72
- *
73
- * This interface decouples the `AppHost` from the concrete networking implementation (like `SSEClient`).
74
- * Implementation can be:
75
- * 1. `SSEClient`: Direct connection to MCP Server (Browser -> Server).
76
- * 2. `ProxyClient`: Connection via an intermediary API (Browser -> Next.js API -> Server).
77
- */
78
- interface AppHostClient {
79
- /**
80
- * Check if the client is connected
81
- */
82
- isConnected(): boolean;
83
- /**
84
- * Get list of active sessions
85
- */
86
- getSessions(): Promise<SessionListResult>;
87
- /**
88
- * Call a tool on a specific session
89
- */
90
- callTool(sessionId: string, toolName: string, toolArgs: Record<string, unknown>): Promise<unknown>;
91
- /**
92
- * Read a resource from a specific session
93
- */
94
- readResource(sessionId: string, uri: string): Promise<unknown>;
95
- }
96
-
97
- /**
98
- * MCP App Host
99
- *
100
- * Bridges the gap between an iframe (MCP App) and the SSEClient (MCP Server).
101
- * Handles secure iframe sandboxing, resource loading, and bi-directional
102
- * communication via the AppBridge protocol.
103
- *
104
- * Key features:
105
- * - Secure iframe sandboxing with minimal permissions
106
- * - Resource preloading for instant MCP App UI loading
107
- * - Cache-aware resource fetching (SSEClient cache → local cache → direct fetch)
108
- * - Support for ui:// and mcp-app:// resource URIs
109
- */
110
-
111
- interface AppHostOptions {
112
- /** Enable debug logging @default false */
113
- debug?: boolean;
114
- }
115
- interface AppMessageParams {
116
- role: string;
117
- content: unknown;
118
- }
119
- /**
120
- * Host for MCP Apps embedded in iframes.
121
- * Manages secure communication between the app and the MCP server.
122
- */
123
- declare class AppHost {
124
- private readonly client;
125
- private readonly iframe;
126
- private bridge;
127
- private sessionId?;
128
- private resourceCache;
129
- private debug;
130
- /** Callback for app messages (e.g., chat messages from the app) */
131
- onAppMessage?: (params: AppMessageParams) => void;
132
- constructor(client: AppHostClient, iframe: HTMLIFrameElement, options?: AppHostOptions);
133
- /**
134
- * Start the host. This prepares the bridge handlers but doesn't connect yet.
135
- * The actual connection happens in launch() after HTML is loaded.
136
- * @returns Promise that resolves immediately (bridge connects during launch)
137
- */
138
- start(): Promise<void>;
139
- /**
140
- * Preload UI resources to enable instant app loading.
141
- * Call this when tools are discovered to cache their UI resources.
142
- */
143
- preload(tools: Array<{
144
- _meta?: unknown;
145
- }>): void;
146
- /**
147
- * Launch an MCP App from a URL or MCP resource URI.
148
- * Loads the HTML first, then establishes bridge connection.
149
- */
150
- launch(url: string, sessionId?: string): Promise<void>;
151
- /**
152
- * Wait for app to signal initialization complete
153
- */
154
- private onAppReady;
155
- /**
156
- * Wait for iframe to finish loading
157
- */
158
- private onIframeReady;
159
- /**
160
- * Send tool input arguments to the MCP App.
161
- * Call this after launch() when tool input is available.
162
- */
163
- sendToolInput(args: Record<string, unknown>): void;
164
- /**
165
- * Send tool result to the MCP App.
166
- * Call this when the tool call completes.
167
- */
168
- sendToolResult(result: unknown): void;
169
- /**
170
- * Send tool cancellation to the MCP App.
171
- * Call this when the tool call is cancelled or fails.
172
- */
173
- sendToolCancelled(reason: string): void;
174
- private configureSandbox;
175
- private initializeBridge;
176
- private connectBridge;
177
- private handleToolCall;
178
- private handleOpenLink;
179
- private handleMessage;
180
- private launchMcpApp;
181
- private fetchResourceWithCache;
182
- private preloadResource;
183
- private getSessionId;
184
- private isMcpUri;
185
- private hasClientCache;
186
- private extractUiResourceUri;
187
- private decodeContent;
188
- private log;
189
- }
190
-
191
- export { AppHost, McpConnectionEvent, McpObservabilityEvent, SSEClient, type SSEClientOptions };