@tambo-ai/react 0.67.0 → 0.68.0

package/esm/mcp/tambo-mcp-provider.js

@@ -1,4 +1,5 @@
 import React, { createContext, useContext, useEffect, useMemo, useRef, useState, } from "react";
+import { ServerType } from "./mcp-constants";
 import { getMcpServerUniqueKey, } from "../model/mcp-server-info";
 import { useTamboMcpToken } from "../providers/tambo-mcp-token-provider";
 import { useTamboMcpServerInfos, useTamboRegistry, } from "../providers/tambo-registry-provider";
@@ -53,6 +54,150 @@ function hashString(input) {
     }
     return (hash >>> 0).toString(36);
 }
+/**
+ * Safely closes an MCP client, handling both sync and async close methods.
+ * Logs errors but doesn't throw.
+ */
+function closeClientSafely(server) {
+    if (!server?.client?.close)
+        return;
+    try {
+        const closeResult = server.client.close();
+        // If it returns a promise, handle errors but don't wait
+        if (closeResult && typeof closeResult.catch === "function") {
+            void closeResult.catch((error) => {
+                const url = server.url ?? "(unknown url)";
+                console.error(`Error closing MCP client for ${url}:`, error);
+            });
+        }
+    }
+    catch (error) {
+        const url = server.url ?? "(unknown url)";
+        console.error(`Error closing MCP client for ${url}:`, error);
+    }
+}
+/**
+ * Builds effective handlers for a server, with per-server overrides taking
+ * precedence over provider-level handlers.
+ * @returns The effective handlers with per-server overrides applied
+ */
+function buildEffectiveHandlers(serverInfo, providerElicitationHandler, providerSamplingHandler) {
+    const effectiveHandlers = {};
+    if (serverInfo.handlers?.elicitation) {
+        effectiveHandlers.elicitation = serverInfo.handlers.elicitation;
+    }
+    else if (providerElicitationHandler) {
+        effectiveHandlers.elicitation = async (request, extra) => await providerElicitationHandler(request, extra, serverInfo);
+    }
+    if (serverInfo.handlers?.sampling) {
+        effectiveHandlers.sampling = serverInfo.handlers.sampling;
+    }
+    else if (providerSamplingHandler) {
+        effectiveHandlers.sampling = async (request, extra) => await providerSamplingHandler(request, extra, serverInfo);
+    }
+    return effectiveHandlers;
+}
+/**
+ * Hook to compute the stable map of server configurations from registry servers
+ * and the internal Tambo MCP server (when token is available).
+ * @returns A map of server key to server configuration
+ */
+function useServerConfigs(mcpServers, mcpAccessToken, tamboBaseUrl) {
+    return useMemo(() => {
+        const serverMap = new Map();
+        // Add user-provided MCP servers (browser-side)
+        mcpServers.forEach((server) => {
+            const serverInfo = normalizeServerInfo(server, ServerType.BROWSER_SIDE);
+            serverMap.set(serverInfo.key, serverInfo);
+        });
+        // Add internal Tambo MCP server if we have an access token and a base URL
+        if (mcpAccessToken && tamboBaseUrl) {
+            const base = new URL(tamboBaseUrl);
+            base.pathname = `${base.pathname.replace(/\/+$/, "")}/mcp`;
+            const tamboMcpUrl = base.toString();
+            const tokenHash = hashString(mcpAccessToken);
+            const internalServer = {
+                name: TAMBO_INTERNAL_MCP_SERVER_NAME,
+                url: tamboMcpUrl,
+                transport: MCPTransport.HTTP,
+                serverKey: `tambo-${tokenHash}`,
+                customHeaders: {
+                    Authorization: `Bearer ${mcpAccessToken}`,
+                },
+            };
+            const serverInfo = normalizeServerInfo(internalServer, ServerType.TAMBO_INTERNAL);
+            serverMap.set(serverInfo.key, serverInfo);
+        }
+        return serverMap;
+    }, [mcpServers, mcpAccessToken, tamboBaseUrl]);
+}
+/**
+ * Registers tools from a connected MCP server with deduplication.
+ */
+async function registerServerTools(client, serverInfo, key, shouldPrefix, clientMap, ownershipRefs, registerTool) {
+    const { toolOwnerRef, keyToToolsRef } = ownershipRefs;
+    try {
+        const tools = await client.listTools();
+        tools.forEach((tool) => {
+            const toolName = shouldPrefix
+                ? `${serverInfo.serverKey}__${tool.name}`
+                : tool.name;
+            // Skip if another server already owns this tool
+            const currentOwner = toolOwnerRef.current.get(toolName);
+            if (currentOwner && currentOwner !== key) {
+                return;
+            }
+            // Record ownership
+            if (!currentOwner) {
+                toolOwnerRef.current.set(toolName, key);
+                if (!keyToToolsRef.current.has(key)) {
+                    keyToToolsRef.current.set(key, new Set());
+                }
+                keyToToolsRef.current.get(key).add(toolName);
+            }
+            registerTool({
+                description: tool.description ?? "",
+                name: toolName,
+                tool: async (args = {}) => {
+                    const server = clientMap.get(key);
+                    if (!server?.client) {
+                        throw new Error(`MCP server for tool ${tool.name} is not connected`);
+                    }
+                    const result = await server.client.callTool(tool.name, args);
+                    if (result.isError) {
+                        const errorMessage = extractErrorMessage(result.content);
+                        throw new Error(errorMessage);
+                    }
+                    return result.content;
+                },
+                inputSchema: tool.inputSchema ?? {},
+                outputSchema: {},
+                transformToContent: (content) => {
+                    if (isContentPartArray(content)) {
+                        return content;
+                    }
+                    return [{ type: "text", text: toText(content) }];
+                },
+            });
+        });
+    }
+    catch (error) {
+        console.error(`Failed to register tools from MCP server ${serverInfo.url}:`, error);
+    }
+}
+/**
+ * Releases tool ownership for a server being removed.
+ */
+function releaseToolOwnership(key, ownershipRefs) {
+    const { toolOwnerRef, keyToToolsRef } = ownershipRefs;
+    const owned = keyToToolsRef.current.get(key);
+    if (owned) {
+        for (const name of owned) {
+            toolOwnerRef.current.delete(name);
+        }
+        keyToToolsRef.current.delete(key);
+    }
+}
 /**
  * This provider is used to register tools from MCP servers.
  * It automatically includes an internal Tambo MCP server when an MCP access token is available.
@@ -78,41 +223,31 @@ export const TamboMcpProvider = ({ handlers, contextKey, children }) => {
     // Stable reference to track active clients by server key
     const clientMapRef = useRef(new Map());
     // Track tool ownership to prevent duplicate registrations across servers
-    // toolOwnerRef: tool name -> server key; keyToToolsRef: server key -> set of tool names
     const toolOwnerRef = useRef(new Map());
     const keyToToolsRef = useRef(new Map());
+    const ownershipRefs = { toolOwnerRef, keyToToolsRef };
     // State for exposing connected servers to consumers
     const [connectedMcpServers, setConnectedMcpServers] = useState([]);
-    // Stable map of current server configurations keyed by server key
-    const currentServersMap = useMemo(() => {
-        const servers = [...mcpServers];
-        // Add internal Tambo MCP server if we have an access token and a base URL
-        if (mcpAccessToken && tamboBaseUrl) {
-            const base = new URL(tamboBaseUrl);
-            base.pathname = `${base.pathname.replace(/\/+$/, "")}/mcp`;
-            const tamboMcpUrl = base.toString();
-            // Include token hash in serverKey so changing tokens trigger reconnection
-            const tokenHash = hashString(mcpAccessToken);
-            servers.push({
-                name: TAMBO_INTERNAL_MCP_SERVER_NAME,
-                url: tamboMcpUrl,
-                transport: MCPTransport.HTTP,
-                serverKey: `tambo-${tokenHash}`, // Include token hash in key to force reconnection on token change
-                customHeaders: {
-                    Authorization: `Bearer ${mcpAccessToken}`,
-                },
-            });
-        }
-        // Create a map of server key -> server info for efficient lookups
-        const serverMap = new Map();
-        servers.forEach((server) => {
-            const serverInfo = normalizeServerInfo(server);
-            // Store without cloning to avoid unnecessary allocation
-            serverMap.set(serverInfo.key, serverInfo);
-        });
-        return serverMap;
-    }, [mcpServers, mcpAccessToken, tamboBaseUrl]);
+    // Compute server configurations from registry and internal server
+    const currentServersMap = useServerConfigs(mcpServers, mcpAccessToken, tamboBaseUrl);
     // Main effect: manage client lifecycle (create/remove)
+    useClientLifecycle(currentServersMap, clientMapRef, ownershipRefs, providerElicitationHandler, providerSamplingHandler, registerTool, setConnectedMcpServers);
+    // Update handlers when they change (without recreating clients)
+    useHandlerUpdates(currentServersMap, clientMapRef, providerElicitationHandler, providerSamplingHandler);
+    // Cleanup on unmount: close all clients
+    useCleanupOnUnmount(clientMapRef, ownershipRefs);
+    const contextValue = useMemo(() => ({
+        servers: connectedMcpServers,
+        elicitation,
+        resolveElicitation,
+    }), [connectedMcpServers, elicitation, resolveElicitation]);
+    return (React.createElement(McpProviderContext.Provider, { value: contextValue }, children));
+};
+/**
+ * Hook to manage client lifecycle: creating clients for new servers,
+ * removing clients for servers that are no longer in the list.
+ */
+function useClientLifecycle(currentServersMap, clientMapRef, ownershipRefs, providerElicitationHandler, providerSamplingHandler, registerTool, setConnectedMcpServers) {
     useEffect(() => {
         const clientMap = clientMapRef.current;
         const currentKeys = new Set(currentServersMap.keys());
@@ -121,30 +256,10 @@ export const TamboMcpProvider = ({ handlers, contextKey, children }) => {
         const keysToRemove = Array.from(existingKeys).filter((key) => !currentKeys.has(key));
         keysToRemove.forEach((key) => {
             const server = clientMap.get(key);
-            if (server?.client?.close) {
-                try {
-                    // Call close() sync - it may or may not return a promise
-                    const closeResult = server.client.close();
-                    // If it returns a promise, handle errors but don't wait
-                    if (closeResult && typeof closeResult.catch === "function") {
-                        void closeResult.catch((error) => {
-                            const url = server.url ?? "(unknown url)";
-                            console.error(`Error closing MCP client for ${url}:`, error);
-                        });
-                    }
-                }
-                catch (error) {
-                    const url = server.url ?? "(unknown url)";
-                    console.error(`Error closing MCP client for ${url}:`, error);
-                }
-            }
-            // Release tool ownership for this server
-            const owned = keyToToolsRef.current.get(key);
-            if (owned) {
-                for (const name of owned)
-                    toolOwnerRef.current.delete(name);
-                keyToToolsRef.current.delete(key);
+            if (server) {
+                closeClientSafely(server);
             }
+            releaseToolOwnership(key, ownershipRefs);
             clientMap.delete(key);
         });
         // 2. Add new clients for servers that don't exist yet
@@ -153,20 +268,7 @@ export const TamboMcpProvider = ({ handlers, contextKey, children }) => {
             await Promise.allSettled(keys.map(async (key) => {
                 const serverInfo = currentServersMap.get(key);
                 try {
-                    // Build effective handlers (per-server overrides provider)
-                    const effectiveHandlers = {};
-                    if (serverInfo.handlers?.elicitation) {
-                        effectiveHandlers.elicitation = serverInfo.handlers.elicitation;
-                    }
-                    else if (providerElicitationHandler) {
-                        effectiveHandlers.elicitation = async (request, extra) => await providerElicitationHandler(request, extra, serverInfo);
-                    }
-                    if (serverInfo.handlers?.sampling) {
-                        effectiveHandlers.sampling = serverInfo.handlers.sampling;
-                    }
-                    else if (providerSamplingHandler) {
-                        effectiveHandlers.sampling = async (request, extra) => await providerSamplingHandler(request, extra, serverInfo);
-                    }
+                    const effectiveHandlers = buildEffectiveHandlers(serverInfo, providerElicitationHandler, providerSamplingHandler);
                     const client = await MCPClient.create(serverInfo.url, serverInfo.transport, serverInfo.customHeaders, undefined, undefined, effectiveHandlers);
                     const connectedServer = {
                         ...serverInfo,
@@ -174,57 +276,9 @@ export const TamboMcpProvider = ({ handlers, contextKey, children }) => {
                     };
                     clientMap.set(key, connectedServer);
                     setConnectedMcpServers(Array.from(clientMap.values()));
-                    // Register tools from this server (deduplicated by ownership)
-                    try {
-                        const tools = await client.listTools();
-                        const shouldPrefix = currentServersMap.size > 1;
-                        tools.forEach((tool) => {
-                            // Prefix tool name with serverKey if multiple servers are present
-                            const toolName = shouldPrefix
-                                ? `${serverInfo.serverKey}__${tool.name}`
-                                : tool.name;
-                            // Skip if another server already owns this tool (using final name for ownership)
-                            const currentOwner = toolOwnerRef.current.get(toolName);
-                            if (currentOwner && currentOwner !== key) {
-                                return;
-                            }
-                            // Record ownership for this server key (using final name)
-                            if (!currentOwner) {
-                                toolOwnerRef.current.set(toolName, key);
-                                if (!keyToToolsRef.current.has(key)) {
-                                    keyToToolsRef.current.set(key, new Set());
-                                }
-                                keyToToolsRef.current.get(key).add(toolName);
-                            }
-                            registerTool({
-                                description: tool.description ?? "",
-                                name: toolName,
-                                tool: async (args = {}) => {
-                                    const server = clientMap.get(key);
-                                    if (!server?.client) {
-                                        throw new Error(`MCP server for tool ${tool.name} is not connected`);
-                                    }
-                                    const result = await server.client.callTool(tool.name, args);
-                                    if (result.isError) {
-                                        const errorMessage = extractErrorMessage(result.content);
-                                        throw new Error(errorMessage);
-                                    }
-                                    return result.content;
-                                },
-                                inputSchema: tool.inputSchema ?? {},
-                                outputSchema: {},
-                                transformToContent: (content) => {
-                                    if (isContentPartArray(content)) {
-                                        return content;
-                                    }
-                                    return [{ type: "text", text: toText(content) }];
-                                },
-                            });
-                        });
-                    }
-                    catch (error) {
-                        console.error(`Failed to register tools from MCP server ${serverInfo.url}:`, error);
-                    }
+                    // Register tools from this server
+                    const shouldPrefix = currentServersMap.size > 1;
+                    await registerServerTools(client, serverInfo, key, shouldPrefix, clientMap, ownershipRefs, registerTool);
                 }
                 catch (error) {
                     const failedServer = {
@@ -242,17 +296,24 @@ export const TamboMcpProvider = ({ handlers, contextKey, children }) => {
                 console.error("Unexpected error in addClients:", err);
             });
         }
-        // Update state after removals (additions update state asynchronously above)
+        // Update state after removals
         if (keysToRemove.length > 0) {
             setConnectedMcpServers(Array.from(clientMap.values()));
         }
+        // Note: refs (clientMapRef, ownershipRefs) and setters (setConnectedMcpServers)
+        // are intentionally excluded from deps as they are stable references
+        // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [
         currentServersMap,
         providerElicitationHandler,
         providerSamplingHandler,
         registerTool,
     ]);
-    // Update handlers when they change (without recreating clients)
+}
+/**
+ * Hook to update handlers on connected clients when provider handlers change.
+ */
+function useHandlerUpdates(currentServersMap, clientMapRef, providerElicitationHandler, providerSamplingHandler) {
     useEffect(() => {
         const clientMap = clientMapRef.current;
         clientMap.forEach((server, key) => {
@@ -261,9 +322,9 @@ export const TamboMcpProvider = ({ handlers, contextKey, children }) => {
             }
             const serverInfo = currentServersMap.get(key);
             if (!serverInfo) {
-                return; // Server was removed, handled by main effect
+                return; // Server was removed, handled by lifecycle effect
             }
-            // Determine effective handlers
+            // Build effective handlers and update the client
             const effectiveElicitationHandler = serverInfo.handlers?.elicitation ??
                 (providerElicitationHandler
                     ? async (request, extra) => await providerElicitationHandler(request, extra, serverInfo)
@@ -272,48 +333,32 @@ export const TamboMcpProvider = ({ handlers, contextKey, children }) => {
                 (providerSamplingHandler
                     ? async (request, extra) => await providerSamplingHandler(request, extra, serverInfo)
                     : undefined);
-            // Update handlers unconditionally (allows removal by passing undefined)
             server.client.updateElicitationHandler?.(effectiveElicitationHandler);
             server.client.updateSamplingHandler?.(effectiveSamplingHandler);
         });
+        // Note: clientMapRef is intentionally excluded from deps as it's a stable ref
+        // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [currentServersMap, providerElicitationHandler, providerSamplingHandler]);
-    // Cleanup on unmount: close all clients
+}
+/**
+ * Hook to cleanup all clients and tool ownership on component unmount.
+ */
+function useCleanupOnUnmount(clientMapRef, ownershipRefs) {
     useEffect(() => {
         const clientMap = clientMapRef.current;
-        const ownerMapAtMount = toolOwnerRef.current;
-        const keyToToolsAtMount = keyToToolsRef.current;
+        const { toolOwnerRef, keyToToolsRef } = ownershipRefs;
         return () => {
             clientMap.forEach((server) => {
-                if (server?.client?.close) {
-                    try {
-                        // Call close() sync - it may or may not return a promise
-                        const closeResult = server.client.close();
-                        // If it returns a promise, handle errors but don't wait
-                        if (closeResult && typeof closeResult.catch === "function") {
-                            void closeResult.catch((error) => {
-                                const url = server.url ?? "(unknown url)";
-                                console.error(`Error closing MCP client on unmount for ${url}:`, error);
-                            });
-                        }
-                    }
-                    catch (error) {
-                        const url = server.url ?? "(unknown url)";
-                        console.error(`Error closing MCP client on unmount for ${url}:`, error);
-                    }
-                }
+                closeClientSafely(server);
             });
             clientMap.clear();
-            ownerMapAtMount.clear();
-            keyToToolsAtMount.clear();
+            toolOwnerRef.current.clear();
+            keyToToolsRef.current.clear();
         };
+        // Only run cleanup on unmount
+        // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
-    const contextValue = useMemo(() => ({
-        servers: connectedMcpServers,
-        elicitation,
-        resolveElicitation,
-    }), [connectedMcpServers, elicitation, resolveElicitation]);
-    return (React.createElement(McpProviderContext.Provider, { value: contextValue }, children));
-};
+}
 /**
  * Hook to access the actual MCP servers, as they are connected (or fail to
  * connect).
@@ -384,9 +429,10 @@ export const useTamboElicitationContext = useTamboMcpElicitation;
  * `transport` and a `serverKey` derived by the registry, and narrows the
  * opaque `handlers` field to `Partial<MCPHandlers>`.
  * @param server - The normalized MCP server info from the registry
- * @returns The server config with typed handlers and unique key
+ * @param serverType - The type of server (internal vs browser-side)
+ * @returns The server config with typed handlers, unique key, and server type
  */
-function normalizeServerInfo(server) {
+function normalizeServerInfo(server, serverType) {
     // Always use getMcpServerUniqueKey for connection identity to ensure
     // that changes to URL, transport, or customHeaders trigger client recreation.
     // The serverKey is kept for namespacing purposes (readable short name),
@@ -398,6 +444,7 @@ function normalizeServerInfo(server) {
         ...server,
         handlers,
         key,
+        serverType,
     };
 }
 //# sourceMappingURL=tambo-mcp-provider.js.map

package/esm/mcp/tambo-mcp-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-mcp-provider.js","sourceRoot":"","sources":["../../src/mcp/tambo-mcp-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, {\n  createContext,\n  FC,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport {\n  getMcpServerUniqueKey,\n  type NormalizedMcpServerInfo,\n} from \"../model/mcp-server-info\";\nimport { useTamboMcpToken } from \"../providers/tambo-mcp-token-provider\";\nimport {\n  useTamboMcpServerInfos,\n  useTamboRegistry,\n} from \"../providers/tambo-registry-provider\";\nimport { isContentPartArray, toText } from \"../util/content-parts\";\nimport { type ElicitationContextState, useElicitation } from \"./elicitation\";\nimport {\n  MCPClient,\n  MCPElicitationHandler,\n  MCPHandlers,\n  MCPSamplingHandler,\n  MCPTransport,\n} from \"./mcp-client\";\n\n/**\n * Extracts error message from MCP tool result content.\n * Handles both array and string content formats.\n * Always returns a string, even for invalid/null inputs.\n * @returns The extracted error message as a string\n */\nexport function extractErrorMessage(content: unknown): string {\n  if (content === undefined || content === null) {\n    return \"Unknown error occurred\";\n  }\n\n  if (Array.isArray(content)) {\n    const textItems = content\n      .filter((item) => item?.type === \"text\" && typeof item.text === \"string\")\n      .map((item) => item.text);\n\n    return textItems.length > 0\n      ? textItems.join(\" \")\n      : \"Error occurred but no details provided\";\n  }\n\n  if (typeof content === \"object\") {\n    return JSON.stringify(content);\n  }\n\n  return `${content}`;\n}\n\n/**\n * Normalized MCP server information as consumed by the provider.\n *\n * Extends `NormalizedMcpServerInfo` from the core model by:\n * - narrowing `handlers` to `Partial<MCPHandlers>`\n * - adding a stable `key` derived from URL/transport/headers\n *\n * The registry is responsible for producing `NormalizedMcpServerInfo`\n * instances; this type adds the MCP-specific wiring needed to connect and\n * track clients.\n */\ninterface McpServerConfig extends NormalizedMcpServerInfo {\n  /**\n   * Optional handlers for elicitation and sampling requests from the server.\n   * Interpreted as a partial set of MCP handlers.\n   */\n  handlers?: Partial<MCPHandlers>;\n  /**\n   * Stable identity for this server derived from its URL/transport/headers.\n   * Present for all server states (connected or failed).\n   */\n  key: string;\n}\n\n/**\n * Connected MCP server with an active client.\n */\nexport interface ConnectedMcpServer extends McpServerConfig {\n  client: MCPClient;\n}\n\n/**\n * Failed MCP server with a connection error.\n */\nexport interface FailedMcpServer extends McpServerConfig {\n  client?: never;\n  connectionError: Error;\n}\n\n/**\n * An active or failed MCP server, with access to the MCP client.\n */\nexport type McpServer = ConnectedMcpServer | FailedMcpServer;\n\n/**\n * Provider-level MCP handlers that receive the McpServerInfo as context in addition to the request.\n * These handlers are applied to all MCP servers unless overridden by per-server handlers.\n *\n * Handlers receive three parameters:\n * 1. request - The MCP request\n * 2. extra - RequestHandlerExtra containing AbortSignal and other metadata\n * 3. serverInfo - Configuration of the MCP server that triggered this request\n */\nexport interface ProviderMCPHandlers {\n  elicitation?: (\n    request: Parameters<MCPElicitationHandler>[0],\n    extra: Parameters<MCPElicitationHandler>[1],\n    serverInfo: McpServerConfig,\n  ) => ReturnType<MCPElicitationHandler>;\n  sampling?: (\n    request: Parameters<MCPSamplingHandler>[0],\n    extra: Parameters<MCPSamplingHandler>[1],\n    serverInfo: McpServerConfig,\n  ) => ReturnType<MCPSamplingHandler>;\n}\n\n/**\n * Context value for MCP provider including server list and elicitation state\n */\ninterface McpProviderContextValue extends ElicitationContextState {\n  servers: McpServer[];\n}\n\nconst McpProviderContext = createContext<McpProviderContextValue>({\n  servers: [],\n  elicitation: null,\n  resolveElicitation: null,\n});\n\n// Constant for the internal Tambo MCP server name\nconst TAMBO_INTERNAL_MCP_SERVER_NAME = \"__tambo_internal_mcp_server__\";\n\n/**\n * Creates a stable hash of a string for use as a cache key.\n * Uses Java-style string hashing (DJB2-like) for deterministic results.\n *\n * Note: We use a synchronous hash instead of crypto.subtle.digest because:\n * - crypto.subtle.digest is async, which adds complexity in React hooks (useMemo, useEffect)\n * - This is not for security, just for creating a stable identifier to detect token changes\n * - Synchronous hashing avoids race conditions and simplifies component lifecycle\n * @param input - The string to hash\n * @returns A compact base36 hash string\n */\nfunction hashString(input: string): string {\n  let hash = 0;\n  for (let i = 0; i < input.length; i++) {\n    hash = (Math.imul(31, hash) + input.charCodeAt(i)) | 0;\n  }\n  return (hash >>> 0).toString(36);\n}\n\n/**\n * This provider is used to register tools from MCP servers.\n * It automatically includes an internal Tambo MCP server when an MCP access token is available.\n *\n * **BREAKING CHANGE**: This provider no longer accepts `mcpServers` as a prop.\n * Instead, pass `mcpServers` to `TamboProvider` or `TamboRegistryProvider`.\n * This provider must be wrapped inside `TamboProvider` to access the MCP server registry.\n * @param props - The provider props\n * @param props.handlers - Optional handlers applied to all MCP servers unless overridden per-server\n * @param props.contextKey - Optional context key for fetching threadless MCP tokens when not in a thread\n * @param props.children - The children to wrap\n * @returns The TamboMcpProvider component\n */\nexport const TamboMcpProvider: FC<{\n  handlers?: ProviderMCPHandlers;\n  contextKey?: string;\n  children: React.ReactNode;\n}> = ({ handlers, contextKey, children }) => {\n  const { registerTool } = useTamboRegistry();\n  const { mcpAccessToken, tamboBaseUrl } = useTamboMcpToken(contextKey);\n  const mcpServers = useTamboMcpServerInfos();\n  const providerSamplingHandler = handlers?.sampling;\n\n  // Elicitation state and default handler\n  const { elicitation, resolveElicitation, defaultElicitationHandler } =\n    useElicitation();\n\n  // Use provided handler or fall back to default\n  const providerElicitationHandler =\n    handlers?.elicitation ?? defaultElicitationHandler;\n\n  // Stable reference to track active clients by server key\n  const clientMapRef = useRef<Map<string, McpServer>>(new Map());\n  // Track tool ownership to prevent duplicate registrations across servers\n  // toolOwnerRef: tool name -> server key; keyToToolsRef: server key -> set of tool names\n  const toolOwnerRef = useRef<Map<string, string>>(new Map());\n  const keyToToolsRef = useRef<Map<string, Set<string>>>(new Map());\n\n  // State for exposing connected servers to consumers\n  const [connectedMcpServers, setConnectedMcpServers] = useState<McpServer[]>(\n    [],\n  );\n\n  // Stable map of current server configurations keyed by server key\n  const currentServersMap = useMemo(() => {\n    const servers = [...mcpServers];\n\n    // Add internal Tambo MCP server if we have an access token and a base URL\n    if (mcpAccessToken && tamboBaseUrl) {\n      const base = new URL(tamboBaseUrl);\n      base.pathname = `${base.pathname.replace(/\\/+$/, \"\")}/mcp`;\n      const tamboMcpUrl = base.toString();\n      // Include token hash in serverKey so changing tokens trigger reconnection\n      const tokenHash = hashString(mcpAccessToken);\n      servers.push({\n        name: TAMBO_INTERNAL_MCP_SERVER_NAME,\n        url: tamboMcpUrl,\n        transport: MCPTransport.HTTP,\n        serverKey: `tambo-${tokenHash}`, // Include token hash in key to force reconnection on token change\n        customHeaders: {\n          Authorization: `Bearer ${mcpAccessToken}`,\n        },\n      });\n    }\n\n    // Create a map of server key -> server info for efficient lookups\n    const serverMap = new Map<string, McpServerConfig>();\n    servers.forEach((server) => {\n      const serverInfo = normalizeServerInfo(server);\n      // Store without cloning to avoid unnecessary allocation\n      serverMap.set(serverInfo.key, serverInfo);\n    });\n\n    return serverMap;\n  }, [mcpServers, mcpAccessToken, tamboBaseUrl]);\n\n  // Main effect: manage client lifecycle (create/remove)\n  useEffect(() => {\n    const clientMap = clientMapRef.current;\n    const currentKeys = new Set(currentServersMap.keys());\n    const existingKeys = new Set(clientMap.keys());\n\n    // 1. Remove clients that are no longer in the current server list\n    const keysToRemove = Array.from(existingKeys).filter(\n      (key) => !currentKeys.has(key),\n    );\n    keysToRemove.forEach((key) => {\n      const server = clientMap.get(key);\n      if (server?.client?.close) {\n        try {\n          // Call close() sync - it may or may not return a promise\n          const closeResult = server.client.close();\n          // If it returns a promise, handle errors but don't wait\n          if (closeResult && typeof closeResult.catch === \"function\") {\n            void closeResult.catch((error) => {\n              const url = (server as McpServer).url ?? \"(unknown url)\";\n              console.error(`Error closing MCP client for ${url}:`, error);\n            });\n          }\n        } catch (error) {\n          const url = (server as McpServer).url ?? \"(unknown url)\";\n          console.error(`Error closing MCP client for ${url}:`, error);\n        }\n      }\n      // Release tool ownership for this server\n      const owned = keyToToolsRef.current.get(key);\n      if (owned) {\n        for (const name of owned) toolOwnerRef.current.delete(name);\n        keyToToolsRef.current.delete(key);\n      }\n      clientMap.delete(key);\n    });\n\n    // 2. Add new clients for servers that don't exist yet\n    const keysToAdd = Array.from(currentKeys).filter(\n      (key) => !existingKeys.has(key),\n    );\n\n    async function addClients(keys: string[]) {\n      await Promise.allSettled(\n        keys.map(async (key) => {\n          const serverInfo = currentServersMap.get(key)!;\n\n          try {\n            // Build effective handlers (per-server overrides provider)\n            const effectiveHandlers: Partial<MCPHandlers> = {};\n\n            if (serverInfo.handlers?.elicitation) {\n              effectiveHandlers.elicitation = serverInfo.handlers.elicitation;\n            } else if (providerElicitationHandler) {\n              effectiveHandlers.elicitation = async (\n                request: Parameters<MCPElicitationHandler>[0],\n                extra: Parameters<MCPElicitationHandler>[1],\n              ) => await providerElicitationHandler(request, extra, serverInfo);\n            }\n\n            if (serverInfo.handlers?.sampling) {\n              effectiveHandlers.sampling = serverInfo.handlers.sampling;\n            } else if (providerSamplingHandler) {\n              effectiveHandlers.sampling = async (\n                request: Parameters<MCPSamplingHandler>[0],\n                extra: Parameters<MCPSamplingHandler>[1],\n              ) => await providerSamplingHandler(request, extra, serverInfo);\n            }\n\n            const client = await MCPClient.create(\n              serverInfo.url,\n              serverInfo.transport,\n              serverInfo.customHeaders,\n              undefined,\n              undefined,\n              effectiveHandlers,\n            );\n\n            const connectedServer: ConnectedMcpServer = {\n              ...serverInfo,\n              client,\n            };\n\n            clientMap.set(key, connectedServer);\n            setConnectedMcpServers(Array.from(clientMap.values()));\n\n            // Register tools from this server (deduplicated by ownership)\n            try {\n              const tools = await client.listTools();\n              const shouldPrefix = currentServersMap.size > 1;\n\n              tools.forEach((tool) => {\n                // Prefix tool name with serverKey if multiple servers are present\n                const toolName = shouldPrefix\n                  ? `${serverInfo.serverKey}__${tool.name}`\n                  : tool.name;\n\n                // Skip if another server already owns this tool (using final name for ownership)\n                const currentOwner = toolOwnerRef.current.get(toolName);\n                if (currentOwner && currentOwner !== key) {\n                  return;\n                }\n\n                // Record ownership for this server key (using final name)\n                if (!currentOwner) {\n                  toolOwnerRef.current.set(toolName, key);\n                  if (!keyToToolsRef.current.has(key)) {\n                    keyToToolsRef.current.set(key, new Set());\n                  }\n                  keyToToolsRef.current.get(key)!.add(toolName);\n                }\n\n                registerTool({\n                  description: tool.description ?? \"\",\n                  name: toolName,\n                  tool: async (args: Record<string, unknown> = {}) => {\n                    const server = clientMap.get(key);\n                    if (!server?.client) {\n                      throw new Error(\n                        `MCP server for tool ${tool.name} is not connected`,\n                      );\n                    }\n                    const result = await server.client.callTool(\n                      tool.name,\n                      args,\n                    );\n                    if (result.isError) {\n                      const errorMessage = extractErrorMessage(result.content);\n                      throw new Error(errorMessage);\n                    }\n                    return result.content;\n                  },\n                  inputSchema: tool.inputSchema ?? {},\n                  outputSchema: {},\n                  transformToContent: (content: unknown) => {\n                    if (isContentPartArray(content)) {\n                      return content;\n                    }\n                    return [{ type: \"text\", text: toText(content) }];\n                  },\n                });\n              });\n            } catch (error) {\n              console.error(\n                `Failed to register tools from MCP server ${serverInfo.url}:`,\n                error,\n              );\n            }\n          } catch (error) {\n            const failedServer: FailedMcpServer = {\n              ...serverInfo,\n              connectionError: error as Error,\n            };\n            clientMap.set(key, failedServer);\n            setConnectedMcpServers(Array.from(clientMap.values()));\n            console.error(\n              `Failed to connect to MCP server ${serverInfo.url}:`,\n              error,\n            );\n          }\n        }),\n      );\n    }\n\n    if (keysToAdd.length > 0) {\n      addClients(keysToAdd).catch((err) => {\n        console.error(\"Unexpected error in addClients:\", err);\n      });\n    }\n\n    // Update state after removals (additions update state asynchronously above)\n    if (keysToRemove.length > 0) {\n      setConnectedMcpServers(Array.from(clientMap.values()));\n    }\n  }, [\n    currentServersMap,\n    providerElicitationHandler,\n    providerSamplingHandler,\n    registerTool,\n  ]);\n\n  // Update handlers when they change (without recreating clients)\n  useEffect(() => {\n    const clientMap = clientMapRef.current;\n\n    clientMap.forEach((server, key) => {\n      if (!server.client) {\n        return; // Skip failed servers\n      }\n\n      const serverInfo = currentServersMap.get(key);\n      if (!serverInfo) {\n        return; // Server was removed, handled by main effect\n      }\n\n      // Determine effective handlers\n      const effectiveElicitationHandler =\n        serverInfo.handlers?.elicitation ??\n        (providerElicitationHandler\n          ? async (\n              request: Parameters<MCPElicitationHandler>[0],\n              extra: Parameters<MCPElicitationHandler>[1],\n            ) => await providerElicitationHandler(request, extra, serverInfo)\n          : undefined);\n\n      const effectiveSamplingHandler =\n        serverInfo.handlers?.sampling ??\n        (providerSamplingHandler\n          ? async (\n              request: Parameters<MCPSamplingHandler>[0],\n              extra: Parameters<MCPSamplingHandler>[1],\n            ) => await providerSamplingHandler(request, extra, serverInfo)\n          : undefined);\n\n      // Update handlers unconditionally (allows removal by passing undefined)\n      server.client.updateElicitationHandler?.(effectiveElicitationHandler);\n      server.client.updateSamplingHandler?.(effectiveSamplingHandler);\n    });\n  }, [currentServersMap, providerElicitationHandler, providerSamplingHandler]);\n\n  // Cleanup on unmount: close all clients\n  useEffect(() => {\n    const clientMap = clientMapRef.current;\n    const ownerMapAtMount = toolOwnerRef.current;\n    const keyToToolsAtMount = keyToToolsRef.current;\n    return () => {\n      clientMap.forEach((server) => {\n        if (server?.client?.close) {\n          try {\n            // Call close() sync - it may or may not return a promise\n            const closeResult = server.client.close();\n            // If it returns a promise, handle errors but don't wait\n            if (closeResult && typeof closeResult.catch === \"function\") {\n              void closeResult.catch((error) => {\n                const url = (server as McpServer).url ?? \"(unknown url)\";\n                console.error(\n                  `Error closing MCP client on unmount for ${url}:`,\n                  error,\n                );\n              });\n            }\n          } catch (error) {\n            const url = (server as McpServer).url ?? \"(unknown url)\";\n            console.error(\n              `Error closing MCP client on unmount for ${url}:`,\n              error,\n            );\n          }\n        }\n      });\n      clientMap.clear();\n      ownerMapAtMount.clear();\n      keyToToolsAtMount.clear();\n    };\n  }, []);\n\n  const contextValue = useMemo(\n    () => ({\n      servers: connectedMcpServers,\n      elicitation,\n      resolveElicitation,\n    }),\n    [connectedMcpServers, elicitation, resolveElicitation],\n  );\n\n  return (\n    <McpProviderContext.Provider value={contextValue}>\n      {children}\n    </McpProviderContext.Provider>\n  );\n};\n\n/**\n * Hook to access the actual MCP servers, as they are connected (or fail to\n * connect).\n *\n * You can call methods on the MCP client that is included in the MCP server\n * object.\n *\n * If the server fails to connect, the `client` property will be `undefined` and\n * the `connectionError` property will be set.\n *\n * For example, to forcibly disconnect and reconnect all MCP servers:\n *\n * ```tsx\n * const mcpServers = useTamboMcpServers();\n * mcpServers.forEach((mcpServer) => {\n *   mcpServer.client?.reconnect();\n * });\n * ```\n *\n * Note that the MCP servers are not guaranteed to be in the same order as the\n * input array, because they are added as they are connected.\n * @returns The MCP servers\n */\nexport const useTamboMcpServers = () => {\n  return useContext(McpProviderContext).servers;\n};\n\n/**\n * Hook to access MCP elicitation state from TamboMcpProvider.\n * This provides access to the current elicitation request and methods to respond to it.\n *\n * The elicitation state is automatically managed by TamboMcpProvider when MCP servers\n * request user input through the elicitation protocol.\n * @returns The elicitation state with current request and response handler\n * @example\n * ```tsx\n * function ElicitationUI() {\n *   const { elicitation, resolveElicitation } = useTamboMcpElicitation();\n *\n *   if (!elicitation) return null;\n *\n *   return (\n *     <div>\n *       <p>{elicitation.message}</p>\n *       <button onClick={() => resolveElicitation?.({ action: \"accept\", content: {} })}>\n *         Accept\n *       </button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport const useTamboMcpElicitation = (): ElicitationContextState => {\n  const context = useContext(McpProviderContext);\n  return {\n    elicitation: context.elicitation,\n    resolveElicitation: context.resolveElicitation,\n  };\n};\n\n/**\n * @deprecated Use `useTamboMcpElicitation` instead.\n * This hook will be removed in a future version.\n */\nexport const useTamboElicitationContext = useTamboMcpElicitation;\n\n/**\n * Normalizes registry server metadata into a `McpServerConfig`.\n *\n * Accepts a `NormalizedMcpServerInfo`, which already guarantees a concrete\n * `transport` and a `serverKey` derived by the registry, and narrows the\n * opaque `handlers` field to `Partial<MCPHandlers>`.\n * @param server - The normalized MCP server info from the registry\n * @returns The server config with typed handlers and unique key\n */\nfunction normalizeServerInfo(server: NormalizedMcpServerInfo): McpServerConfig {\n  // Always use getMcpServerUniqueKey for connection identity to ensure\n  // that changes to URL, transport, or customHeaders trigger client recreation.\n  // The serverKey is kept for namespacing purposes (readable short name),\n  // but the connection identity key must include all connection properties.\n  const key = getMcpServerUniqueKey(server);\n  // Cast handlers to proper type if present\n  const handlers = server.handlers as Partial<MCPHandlers> | undefined;\n  return {\n    ...server,\n    handlers,\n    key,\n  };\n}\n"]}
+{"version":3,"file":"tambo-mcp-provider.js","sourceRoot":"","sources":["../../src/mcp/tambo-mcp-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["import React, {\n  createContext,\n  FC,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport { ServerType } from \"./mcp-constants\";\nimport {\n  getMcpServerUniqueKey,\n  type NormalizedMcpServerInfo,\n} from \"../model/mcp-server-info\";\nimport { useTamboMcpToken } from \"../providers/tambo-mcp-token-provider\";\nimport {\n  useTamboMcpServerInfos,\n  useTamboRegistry,\n} from \"../providers/tambo-registry-provider\";\nimport { isContentPartArray, toText } from \"../util/content-parts\";\nimport { type ElicitationContextState, useElicitation } from \"./elicitation\";\nimport {\n  MCPClient,\n  MCPElicitationHandler,\n  MCPHandlers,\n  MCPSamplingHandler,\n  MCPTransport,\n} from \"./mcp-client\";\n\n/**\n * Extracts error message from MCP tool result content.\n * Handles both array and string content formats.\n * Always returns a string, even for invalid/null inputs.\n * @returns The extracted error message as a string\n */\nexport function extractErrorMessage(content: unknown): string {\n  if (content === undefined || content === null) {\n    return \"Unknown error occurred\";\n  }\n\n  if (Array.isArray(content)) {\n    const textItems = content\n      .filter((item) => item?.type === \"text\" && typeof item.text === \"string\")\n      .map((item) => item.text);\n\n    return textItems.length > 0\n      ? textItems.join(\" \")\n      : \"Error occurred but no details provided\";\n  }\n\n  if (typeof content === \"object\") {\n    return JSON.stringify(content);\n  }\n\n  return `${content}`;\n}\n\n/**\n * Normalized MCP server information as consumed by the provider.\n *\n * Extends `NormalizedMcpServerInfo` from the core model by:\n * - narrowing `handlers` to `Partial<MCPHandlers>`\n * - adding a stable `key` derived from URL/transport/headers\n * - adding `serverType` to distinguish internal vs browser-side servers\n *\n * The registry is responsible for producing `NormalizedMcpServerInfo`\n * instances; this type adds the MCP-specific wiring needed to connect and\n * track clients.\n */\ninterface McpServerConfig extends NormalizedMcpServerInfo {\n  /**\n   * Optional handlers for elicitation and sampling requests from the server.\n   * Interpreted as a partial set of MCP handlers.\n   */\n  handlers?: Partial<MCPHandlers>;\n  /**\n   * Stable identity for this server derived from its URL/transport/headers.\n   * Present for all server states (connected or failed).\n   */\n  key: string;\n  /**\n   * Type of server - determines how resources are resolved.\n   * Internal servers are resolved server-side, browser-side servers are resolved client-side.\n   */\n  serverType: ServerType;\n}\n\n/**\n * Connected MCP server with an active client.\n */\nexport interface ConnectedMcpServer extends McpServerConfig {\n  client: MCPClient;\n}\n\n/**\n * Failed MCP server with a connection error.\n */\nexport interface FailedMcpServer extends McpServerConfig {\n  client?: never;\n  connectionError: Error;\n}\n\n/**\n * An active or failed MCP server, with access to the MCP client.\n */\nexport type McpServer = ConnectedMcpServer | FailedMcpServer;\n\n/**\n * Provider-level MCP handlers that receive the McpServerInfo as context in addition to the request.\n * These handlers are applied to all MCP servers unless overridden by per-server handlers.\n *\n * Handlers receive three parameters:\n * 1. request - The MCP request\n * 2. extra - RequestHandlerExtra containing AbortSignal and other metadata\n * 3. serverInfo - Configuration of the MCP server that triggered this request\n */\nexport interface ProviderMCPHandlers {\n  elicitation?: (\n    request: Parameters<MCPElicitationHandler>[0],\n    extra: Parameters<MCPElicitationHandler>[1],\n    serverInfo: McpServerConfig,\n  ) => ReturnType<MCPElicitationHandler>;\n  sampling?: (\n    request: Parameters<MCPSamplingHandler>[0],\n    extra: Parameters<MCPSamplingHandler>[1],\n    serverInfo: McpServerConfig,\n  ) => ReturnType<MCPSamplingHandler>;\n}\n\n/**\n * Context value for MCP provider including server list and elicitation state\n */\ninterface McpProviderContextValue extends ElicitationContextState {\n  servers: McpServer[];\n}\n\nconst McpProviderContext = createContext<McpProviderContextValue>({\n  servers: [],\n  elicitation: null,\n  resolveElicitation: null,\n});\n\n// Constant for the internal Tambo MCP server name\nconst TAMBO_INTERNAL_MCP_SERVER_NAME = \"__tambo_internal_mcp_server__\";\n\n/**\n * Creates a stable hash of a string for use as a cache key.\n * Uses Java-style string hashing (DJB2-like) for deterministic results.\n *\n * Note: We use a synchronous hash instead of crypto.subtle.digest because:\n * - crypto.subtle.digest is async, which adds complexity in React hooks (useMemo, useEffect)\n * - This is not for security, just for creating a stable identifier to detect token changes\n * - Synchronous hashing avoids race conditions and simplifies component lifecycle\n * @param input - The string to hash\n * @returns A compact base36 hash string\n */\nfunction hashString(input: string): string {\n  let hash = 0;\n  for (let i = 0; i < input.length; i++) {\n    hash = (Math.imul(31, hash) + input.charCodeAt(i)) | 0;\n  }\n  return (hash >>> 0).toString(36);\n}\n\n/**\n * Safely closes an MCP client, handling both sync and async close methods.\n * Logs errors but doesn't throw.\n */\nfunction closeClientSafely(server: McpServer): void {\n  if (!server?.client?.close) return;\n\n  try {\n    const closeResult = server.client.close();\n    // If it returns a promise, handle errors but don't wait\n    if (closeResult && typeof closeResult.catch === \"function\") {\n      void closeResult.catch((error) => {\n        const url = server.url ?? \"(unknown url)\";\n        console.error(`Error closing MCP client for ${url}:`, error);\n      });\n    }\n  } catch (error) {\n    const url = server.url ?? \"(unknown url)\";\n    console.error(`Error closing MCP client for ${url}:`, error);\n  }\n}\n\n/**\n * Builds effective handlers for a server, with per-server overrides taking\n * precedence over provider-level handlers.\n * @returns The effective handlers with per-server overrides applied\n */\nfunction buildEffectiveHandlers(\n  serverInfo: McpServerConfig,\n  providerElicitationHandler: ProviderMCPHandlers[\"elicitation\"] | undefined,\n  providerSamplingHandler: ProviderMCPHandlers[\"sampling\"] | undefined,\n): Partial<MCPHandlers> {\n  const effectiveHandlers: Partial<MCPHandlers> = {};\n\n  if (serverInfo.handlers?.elicitation) {\n    effectiveHandlers.elicitation = serverInfo.handlers.elicitation;\n  } else if (providerElicitationHandler) {\n    effectiveHandlers.elicitation = async (\n      request: Parameters<MCPElicitationHandler>[0],\n      extra: Parameters<MCPElicitationHandler>[1],\n    ) => await providerElicitationHandler(request, extra, serverInfo);\n  }\n\n  if (serverInfo.handlers?.sampling) {\n    effectiveHandlers.sampling = serverInfo.handlers.sampling;\n  } else if (providerSamplingHandler) {\n    effectiveHandlers.sampling = async (\n      request: Parameters<MCPSamplingHandler>[0],\n      extra: Parameters<MCPSamplingHandler>[1],\n    ) => await providerSamplingHandler(request, extra, serverInfo);\n  }\n\n  return effectiveHandlers;\n}\n\n/**\n * Hook to compute the stable map of server configurations from registry servers\n * and the internal Tambo MCP server (when token is available).\n * @returns A map of server key to server configuration\n */\nfunction useServerConfigs(\n  mcpServers: NormalizedMcpServerInfo[],\n  mcpAccessToken: string | null | undefined,\n  tamboBaseUrl: string | null | undefined,\n): Map<string, McpServerConfig> {\n  return useMemo(() => {\n    const serverMap = new Map<string, McpServerConfig>();\n\n    // Add user-provided MCP servers (browser-side)\n    mcpServers.forEach((server) => {\n      const serverInfo = normalizeServerInfo(server, ServerType.BROWSER_SIDE);\n      serverMap.set(serverInfo.key, serverInfo);\n    });\n\n    // Add internal Tambo MCP server if we have an access token and a base URL\n    if (mcpAccessToken && tamboBaseUrl) {\n      const base = new URL(tamboBaseUrl);\n      base.pathname = `${base.pathname.replace(/\\/+$/, \"\")}/mcp`;\n      const tamboMcpUrl = base.toString();\n      const tokenHash = hashString(mcpAccessToken);\n      const internalServer: NormalizedMcpServerInfo = {\n        name: TAMBO_INTERNAL_MCP_SERVER_NAME,\n        url: tamboMcpUrl,\n        transport: MCPTransport.HTTP,\n        serverKey: `tambo-${tokenHash}`,\n        customHeaders: {\n          Authorization: `Bearer ${mcpAccessToken}`,\n        },\n      };\n      const serverInfo = normalizeServerInfo(\n        internalServer,\n        ServerType.TAMBO_INTERNAL,\n      );\n      serverMap.set(serverInfo.key, serverInfo);\n    }\n\n    return serverMap;\n  }, [mcpServers, mcpAccessToken, tamboBaseUrl]);\n}\n\ninterface ToolOwnershipRefs {\n  toolOwnerRef: React.MutableRefObject<Map<string, string>>;\n  keyToToolsRef: React.MutableRefObject<Map<string, Set<string>>>;\n}\n\n/**\n * Registers tools from a connected MCP server with deduplication.\n */\nasync function registerServerTools(\n  client: MCPClient,\n  serverInfo: McpServerConfig,\n  key: string,\n  shouldPrefix: boolean,\n  clientMap: Map<string, McpServer>,\n  ownershipRefs: ToolOwnershipRefs,\n  registerTool: ReturnType<typeof useTamboRegistry>[\"registerTool\"],\n): Promise<void> {\n  const { toolOwnerRef, keyToToolsRef } = ownershipRefs;\n\n  try {\n    const tools = await client.listTools();\n\n    tools.forEach((tool) => {\n      const toolName = shouldPrefix\n        ? `${serverInfo.serverKey}__${tool.name}`\n        : tool.name;\n\n      // Skip if another server already owns this tool\n      const currentOwner = toolOwnerRef.current.get(toolName);\n      if (currentOwner && currentOwner !== key) {\n        return;\n      }\n\n      // Record ownership\n      if (!currentOwner) {\n        toolOwnerRef.current.set(toolName, key);\n        if (!keyToToolsRef.current.has(key)) {\n          keyToToolsRef.current.set(key, new Set());\n        }\n        keyToToolsRef.current.get(key)!.add(toolName);\n      }\n\n      registerTool({\n        description: tool.description ?? \"\",\n        name: toolName,\n        tool: async (args: Record<string, unknown> = {}) => {\n          const server = clientMap.get(key);\n          if (!server?.client) {\n            throw new Error(\n              `MCP server for tool ${tool.name} is not connected`,\n            );\n          }\n          const result = await server.client.callTool(tool.name, args);\n          if (result.isError) {\n            const errorMessage = extractErrorMessage(result.content);\n            throw new Error(errorMessage);\n          }\n          return result.content;\n        },\n        inputSchema: tool.inputSchema ?? {},\n        outputSchema: {},\n        transformToContent: (content: unknown) => {\n          if (isContentPartArray(content)) {\n            return content;\n          }\n          return [{ type: \"text\", text: toText(content) }];\n        },\n      });\n    });\n  } catch (error) {\n    console.error(\n      `Failed to register tools from MCP server ${serverInfo.url}:`,\n      error,\n    );\n  }\n}\n\n/**\n * Releases tool ownership for a server being removed.\n */\nfunction releaseToolOwnership(\n  key: string,\n  ownershipRefs: ToolOwnershipRefs,\n): void {\n  const { toolOwnerRef, keyToToolsRef } = ownershipRefs;\n  const owned = keyToToolsRef.current.get(key);\n  if (owned) {\n    for (const name of owned) {\n      toolOwnerRef.current.delete(name);\n    }\n    keyToToolsRef.current.delete(key);\n  }\n}\n\n/**\n * This provider is used to register tools from MCP servers.\n * It automatically includes an internal Tambo MCP server when an MCP access token is available.\n *\n * **BREAKING CHANGE**: This provider no longer accepts `mcpServers` as a prop.\n * Instead, pass `mcpServers` to `TamboProvider` or `TamboRegistryProvider`.\n * This provider must be wrapped inside `TamboProvider` to access the MCP server registry.\n * @param props - The provider props\n * @param props.handlers - Optional handlers applied to all MCP servers unless overridden per-server\n * @param props.contextKey - Optional context key for fetching threadless MCP tokens when not in a thread\n * @param props.children - The children to wrap\n * @returns The TamboMcpProvider component\n */\nexport const TamboMcpProvider: FC<{\n  handlers?: ProviderMCPHandlers;\n  contextKey?: string;\n  children: React.ReactNode;\n}> = ({ handlers, contextKey, children }) => {\n  const { registerTool } = useTamboRegistry();\n  const { mcpAccessToken, tamboBaseUrl } = useTamboMcpToken(contextKey);\n  const mcpServers = useTamboMcpServerInfos();\n  const providerSamplingHandler = handlers?.sampling;\n\n  // Elicitation state and default handler\n  const { elicitation, resolveElicitation, defaultElicitationHandler } =\n    useElicitation();\n\n  // Use provided handler or fall back to default\n  const providerElicitationHandler =\n    handlers?.elicitation ?? defaultElicitationHandler;\n\n  // Stable reference to track active clients by server key\n  const clientMapRef = useRef<Map<string, McpServer>>(new Map());\n  // Track tool ownership to prevent duplicate registrations across servers\n  const toolOwnerRef = useRef<Map<string, string>>(new Map());\n  const keyToToolsRef = useRef<Map<string, Set<string>>>(new Map());\n  const ownershipRefs: ToolOwnershipRefs = { toolOwnerRef, keyToToolsRef };\n\n  // State for exposing connected servers to consumers\n  const [connectedMcpServers, setConnectedMcpServers] = useState<McpServer[]>(\n    [],\n  );\n\n  // Compute server configurations from registry and internal server\n  const currentServersMap = useServerConfigs(\n    mcpServers,\n    mcpAccessToken,\n    tamboBaseUrl,\n  );\n\n  // Main effect: manage client lifecycle (create/remove)\n  useClientLifecycle(\n    currentServersMap,\n    clientMapRef,\n    ownershipRefs,\n    providerElicitationHandler,\n    providerSamplingHandler,\n    registerTool,\n    setConnectedMcpServers,\n  );\n\n  // Update handlers when they change (without recreating clients)\n  useHandlerUpdates(\n    currentServersMap,\n    clientMapRef,\n    providerElicitationHandler,\n    providerSamplingHandler,\n  );\n\n  // Cleanup on unmount: close all clients\n  useCleanupOnUnmount(clientMapRef, ownershipRefs);\n\n  const contextValue = useMemo(\n    () => ({\n      servers: connectedMcpServers,\n      elicitation,\n      resolveElicitation,\n    }),\n    [connectedMcpServers, elicitation, resolveElicitation],\n  );\n\n  return (\n    <McpProviderContext.Provider value={contextValue}>\n      {children}\n    </McpProviderContext.Provider>\n  );\n};\n\n/**\n * Hook to manage client lifecycle: creating clients for new servers,\n * removing clients for servers that are no longer in the list.\n */\nfunction useClientLifecycle(\n  currentServersMap: Map<string, McpServerConfig>,\n  clientMapRef: React.MutableRefObject<Map<string, McpServer>>,\n  ownershipRefs: ToolOwnershipRefs,\n  providerElicitationHandler: ProviderMCPHandlers[\"elicitation\"] | undefined,\n  providerSamplingHandler: ProviderMCPHandlers[\"sampling\"] | undefined,\n  registerTool: ReturnType<typeof useTamboRegistry>[\"registerTool\"],\n  setConnectedMcpServers: React.Dispatch<React.SetStateAction<McpServer[]>>,\n): void {\n  useEffect(() => {\n    const clientMap = clientMapRef.current;\n    const currentKeys = new Set(currentServersMap.keys());\n    const existingKeys = new Set(clientMap.keys());\n\n    // 1. Remove clients that are no longer in the current server list\n    const keysToRemove = Array.from(existingKeys).filter(\n      (key) => !currentKeys.has(key),\n    );\n    keysToRemove.forEach((key) => {\n      const server = clientMap.get(key);\n      if (server) {\n        closeClientSafely(server);\n      }\n      releaseToolOwnership(key, ownershipRefs);\n      clientMap.delete(key);\n    });\n\n    // 2. Add new clients for servers that don't exist yet\n    const keysToAdd = Array.from(currentKeys).filter(\n      (key) => !existingKeys.has(key),\n    );\n\n    async function addClients(keys: string[]) {\n      await Promise.allSettled(\n        keys.map(async (key) => {\n          const serverInfo = currentServersMap.get(key)!;\n\n          try {\n            const effectiveHandlers = buildEffectiveHandlers(\n              serverInfo,\n              providerElicitationHandler,\n              providerSamplingHandler,\n            );\n\n            const client = await MCPClient.create(\n              serverInfo.url,\n              serverInfo.transport,\n              serverInfo.customHeaders,\n              undefined,\n              undefined,\n              effectiveHandlers,\n            );\n\n            const connectedServer: ConnectedMcpServer = {\n              ...serverInfo,\n              client,\n            };\n\n            clientMap.set(key, connectedServer);\n            setConnectedMcpServers(Array.from(clientMap.values()));\n\n            // Register tools from this server\n            const shouldPrefix = currentServersMap.size > 1;\n            await registerServerTools(\n              client,\n              serverInfo,\n              key,\n              shouldPrefix,\n              clientMap,\n              ownershipRefs,\n              registerTool,\n            );\n          } catch (error) {\n            const failedServer: FailedMcpServer = {\n              ...serverInfo,\n              connectionError: error as Error,\n            };\n            clientMap.set(key, failedServer);\n            setConnectedMcpServers(Array.from(clientMap.values()));\n            console.error(\n              `Failed to connect to MCP server ${serverInfo.url}:`,\n              error,\n            );\n          }\n        }),\n      );\n    }\n\n    if (keysToAdd.length > 0) {\n      addClients(keysToAdd).catch((err) => {\n        console.error(\"Unexpected error in addClients:\", err);\n      });\n    }\n\n    // Update state after removals\n    if (keysToRemove.length > 0) {\n      setConnectedMcpServers(Array.from(clientMap.values()));\n    }\n    // Note: refs (clientMapRef, ownershipRefs) and setters (setConnectedMcpServers)\n    // are intentionally excluded from deps as they are stable references\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    currentServersMap,\n    providerElicitationHandler,\n    providerSamplingHandler,\n    registerTool,\n  ]);\n}\n\n/**\n * Hook to update handlers on connected clients when provider handlers change.\n */\nfunction useHandlerUpdates(\n  currentServersMap: Map<string, McpServerConfig>,\n  clientMapRef: React.MutableRefObject<Map<string, McpServer>>,\n  providerElicitationHandler: ProviderMCPHandlers[\"elicitation\"] | undefined,\n  providerSamplingHandler: ProviderMCPHandlers[\"sampling\"] | undefined,\n): void {\n  useEffect(() => {\n    const clientMap = clientMapRef.current;\n\n    clientMap.forEach((server, key) => {\n      if (!server.client) {\n        return; // Skip failed servers\n      }\n\n      const serverInfo = currentServersMap.get(key);\n      if (!serverInfo) {\n        return; // Server was removed, handled by lifecycle effect\n      }\n\n      // Build effective handlers and update the client\n      const effectiveElicitationHandler =\n        serverInfo.handlers?.elicitation ??\n        (providerElicitationHandler\n          ? async (\n              request: Parameters<MCPElicitationHandler>[0],\n              extra: Parameters<MCPElicitationHandler>[1],\n            ) => await providerElicitationHandler(request, extra, serverInfo)\n          : undefined);\n\n      const effectiveSamplingHandler =\n        serverInfo.handlers?.sampling ??\n        (providerSamplingHandler\n          ? async (\n              request: Parameters<MCPSamplingHandler>[0],\n              extra: Parameters<MCPSamplingHandler>[1],\n            ) => await providerSamplingHandler(request, extra, serverInfo)\n          : undefined);\n\n      server.client.updateElicitationHandler?.(effectiveElicitationHandler);\n      server.client.updateSamplingHandler?.(effectiveSamplingHandler);\n    });\n    // Note: clientMapRef is intentionally excluded from deps as it's a stable ref\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [currentServersMap, providerElicitationHandler, providerSamplingHandler]);\n}\n\n/**\n * Hook to cleanup all clients and tool ownership on component unmount.\n */\nfunction useCleanupOnUnmount(\n  clientMapRef: React.MutableRefObject<Map<string, McpServer>>,\n  ownershipRefs: ToolOwnershipRefs,\n): void {\n  useEffect(() => {\n    const clientMap = clientMapRef.current;\n    const { toolOwnerRef, keyToToolsRef } = ownershipRefs;\n    return () => {\n      clientMap.forEach((server) => {\n        closeClientSafely(server);\n      });\n      clientMap.clear();\n      toolOwnerRef.current.clear();\n      keyToToolsRef.current.clear();\n    };\n    // Only run cleanup on unmount\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n}\n\n/**\n * Hook to access the actual MCP servers, as they are connected (or fail to\n * connect).\n *\n * You can call methods on the MCP client that is included in the MCP server\n * object.\n *\n * If the server fails to connect, the `client` property will be `undefined` and\n * the `connectionError` property will be set.\n *\n * For example, to forcibly disconnect and reconnect all MCP servers:\n *\n * ```tsx\n * const mcpServers = useTamboMcpServers();\n * mcpServers.forEach((mcpServer) => {\n *   mcpServer.client?.reconnect();\n * });\n * ```\n *\n * Note that the MCP servers are not guaranteed to be in the same order as the\n * input array, because they are added as they are connected.\n * @returns The MCP servers\n */\nexport const useTamboMcpServers = () => {\n  return useContext(McpProviderContext).servers;\n};\n\n/**\n * Hook to access MCP elicitation state from TamboMcpProvider.\n * This provides access to the current elicitation request and methods to respond to it.\n *\n * The elicitation state is automatically managed by TamboMcpProvider when MCP servers\n * request user input through the elicitation protocol.\n * @returns The elicitation state with current request and response handler\n * @example\n * ```tsx\n * function ElicitationUI() {\n *   const { elicitation, resolveElicitation } = useTamboMcpElicitation();\n *\n *   if (!elicitation) return null;\n *\n *   return (\n *     <div>\n *       <p>{elicitation.message}</p>\n *       <button onClick={() => resolveElicitation?.({ action: \"accept\", content: {} })}>\n *         Accept\n *       </button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport const useTamboMcpElicitation = (): ElicitationContextState => {\n  const context = useContext(McpProviderContext);\n  return {\n    elicitation: context.elicitation,\n    resolveElicitation: context.resolveElicitation,\n  };\n};\n\n/**\n * @deprecated Use `useTamboMcpElicitation` instead.\n * This hook will be removed in a future version.\n */\nexport const useTamboElicitationContext = useTamboMcpElicitation;\n\n/**\n * Normalizes registry server metadata into a `McpServerConfig`.\n *\n * Accepts a `NormalizedMcpServerInfo`, which already guarantees a concrete\n * `transport` and a `serverKey` derived by the registry, and narrows the\n * opaque `handlers` field to `Partial<MCPHandlers>`.\n * @param server - The normalized MCP server info from the registry\n * @param serverType - The type of server (internal vs browser-side)\n * @returns The server config with typed handlers, unique key, and server type\n */\nfunction normalizeServerInfo(\n  server: NormalizedMcpServerInfo,\n  serverType: ServerType,\n): McpServerConfig {\n  // Always use getMcpServerUniqueKey for connection identity to ensure\n  // that changes to URL, transport, or customHeaders trigger client recreation.\n  // The serverKey is kept for namespacing purposes (readable short name),\n  // but the connection identity key must include all connection properties.\n  const key = getMcpServerUniqueKey(server);\n  // Cast handlers to proper type if present\n  const handlers = server.handlers as Partial<MCPHandlers> | undefined;\n  return {\n    ...server,\n    handlers,\n    key,\n    serverType,\n  };\n}\n"]}

package/esm/model/component-metadata.d.ts

@@ -13,7 +13,7 @@ import { $ZodFunction as Zod4Function, $ZodFunctionArgs as Zod4FunctionArgs, $Zo
  * allowing us to accept any compliant validator without depending on a specific library.
  * @see https://standardschema.dev/
  */
-export type SupportedSchema = StandardSchemaV1 | JSONSchema7;
+export type SupportedSchema<Shape = unknown> = StandardSchemaV1<Shape, Shape> | JSONSchema7;
 /** Extension of the ToolParameters interface from Tambo AI to include JSONSchema definition */
 export type ParameterSpec = TamboAI.ToolParameters & {
     schema?: JSONSchema7;