@tambo-ai/react 0.49.0 → 0.53.0

package/dist/mcp/mcp-client.d.ts

@@ -16,10 +16,48 @@ export declare enum MCPTransport {
 export declare class MCPClient {
     private client;
     private transport;
+    private transportType;
+    private endpoint;
+    private headers;
+    /**
+     * Tracks an in-flight reconnect so concurrent triggers coalesce
+     * (single-flight). When set, additional calls to `reconnect()` or
+     * the automatic `onclose` handler will await the same Promise instead of
+     * starting another reconnect sequence.
+     */
+    private reconnecting?;
+    /**
+     * Timer id for a scheduled automatic reconnect (used by `onclose`).
+     * Present only while waiting for the backoff delay to elapse.
+     */
+    private reconnectTimer?;
+    /**
+     * Count of consecutive automatic reconnect failures used to compute
+     * exponential backoff. Reset to 0 after a successful connection.
+     */
+    private backoffAttempts;
+    /**
+     * Backoff policy (discoverable constants)
+     * - BACKOFF_INITIAL_MS: initial delay for the first automatic retry
+     * - BACKOFF_MULTIPLIER: exponential growth factor for each failed attempt
+     * - BACKOFF_MAX_MS: upper bound for the delay
+     * - BACKOFF_JITTER_RATIO: jitter range as a fraction of the base delay
+     *
+     * Jitter is applied symmetrically in [-ratio, +ratio]. For example, with a
+     * 500ms base delay and 0.2 ratio, the actual delay is in [400ms, 600ms].
+     *
+     * The backoff applies only to automatic reconnects started from the
+     * `onclose` handler. Explicit/manual calls to `reconnect()` run immediately
+     * (no backoff), and will preempt any scheduled automatic attempt.
+     */
+    static readonly BACKOFF_INITIAL_MS = 500;
+    static readonly BACKOFF_MULTIPLIER = 2;
+    static readonly BACKOFF_MAX_MS = 30000;
+    static readonly BACKOFF_JITTER_RATIO = 0.2;
     /**
      * Private constructor to enforce using the static create method.
      * @param endpoint - The URL of the MCP server to connect to
-     * @param transport - The transport to use for the MCP client
+     * @param transportType - The transport to use for the MCP client
      * @param headers - Optional custom headers to include in requests
      */
     private constructor();
@@ -28,12 +66,48 @@ export declare class MCPClient {
      * This is the recommended way to create an MCPClient as it handles both
      * instantiation and connection setup.
      * @param endpoint - The URL of the MCP server to connect to
-     * @param transport - The transport type to use for the MCP client. Defaults to HTTP.
+     * @param transportType - The transport type to use for the MCP client. Defaults to HTTP.
      * @param headers - Optional custom headers to include in requests
      * @returns A connected MCPClient instance ready for use
      * @throws Will throw an error if connection fails
      */
-    static create(endpoint: string, transport?: MCPTransport, headers?: Record<string, string>): Promise<MCPClient>;
+    static create(endpoint: string, transportType?: MCPTransport, headers?: Record<string, string>): Promise<MCPClient>;
+    /**
+     * Reconnects to the MCP server, optionally retaining the same session ID.
+     *
+     * Single‑flight semantics:
+     * - If a reconnect is already in progress (triggered either manually or by
+     * the automatic `onclose` handler), additional calls will await the
+     * in-flight reconnect rather than start another one.
+     * - If an automatic reconnect has been scheduled but not yet started (i.e.,
+     * we are waiting in a backoff delay), calling `reconnect()` manually will
+     * cancel the scheduled attempt and perform an immediate reconnect.
+     *
+     * Backoff policy:
+     * - Backoff delays with jitter are applied only for automatic reconnects
+     * (via `onclose`). Manual calls to `reconnect()` do not use backoff.
+     * @param newSession - Whether to create a new session (true) or reuse existing session ID (false)
+     * @param reportErrorOnClose - Whether to report errors when closing the client
+     * Note that only StreamableHTTPClientTransport supports session IDs.
+     */
+    reconnect(newSession?: boolean, reportErrorOnClose?: boolean): Promise<void>;
+    /**
+     * Called by the underlying MCP SDK when the connection closes.
+     * Schedules an automatic reconnect with bounded exponential backoff and
+     * jitter. If a reconnect is already scheduled or running, this is a no-op.
+     */
+    private onclose;
+    /**
+     * Compute the next backoff delay with symmetric jitter.
+     */
+    private computeBackoffDelayMs;
+    /**
+     * Schedule an automatic reconnect attempt if one is not already scheduled
+     * or running. Uses the backoff policy and self-reschedules on failure.
+     */
+    private scheduleAutoReconnect;
+    private initializeTransport;
+    private initializeClient;
     /**
      * Retrieves a complete list of all available tools from the MCP server.
      * Handles pagination automatically by following cursors until all tools are fetched.

package/dist/mcp/mcp-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,oBAAY,YAAY;IACtB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AACD;;;;;;;;;GASG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqD;IAEtE;;;;;OAKG;IACH,OAAO;IAoBP;;;;;;;;;OASG;WACU,MAAM,CACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,YAAgC,EAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;IAMrB;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAiCzC;;;;;;OAMG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAO3D;AASD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,oBAAY,YAAY;IACtB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AACD;;;;;;;;;GASG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqD;IACtE,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAyB;IACxC;;;;;OAKG;IACH,OAAO,CAAC,YAAY,CAAC,CAAgB;IACrC;;;OAGG;IACH,OAAO,CAAC,cAAc,CAAC,CAAgC;IACvD;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAK;IAE5B;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,OAAO;IACzC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,KAAK;IACvC,MAAM,CAAC,QAAQ,CAAC,cAAc,SAAU;IACxC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,OAAO;IAE3C;;;;;OAKG;IACH,OAAO;IAYP;;;;;;;;;OASG;WACU,MAAM,CACjB,QAAQ,EAAE,MAAM,EAChB,aAAa,GAAE,YAAgC,EAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;IAKrB;;;;;;;;;;;;;;;;;OAiBG;IACG,SAAS,CAAC,UAAU,UAAQ,EAAE,kBAAkB,UAAO;IAmD7D;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAIf;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAoC7B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,gBAAgB;IASxB;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAiCzC;;;;;;OAMG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAO3D;AASD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}

package/dist/mcp/mcp-client.js

@@ -22,43 +22,208 @@ var MCPTransport;
 class MCPClient {
     client;
     transport;
+    transportType;
+    endpoint;
+    headers;
+    /**
+     * Tracks an in-flight reconnect so concurrent triggers coalesce
+     * (single-flight). When set, additional calls to `reconnect()` or
+     * the automatic `onclose` handler will await the same Promise instead of
+     * starting another reconnect sequence.
+     */
+    reconnecting;
+    /**
+     * Timer id for a scheduled automatic reconnect (used by `onclose`).
+     * Present only while waiting for the backoff delay to elapse.
+     */
+    reconnectTimer;
+    /**
+     * Count of consecutive automatic reconnect failures used to compute
+     * exponential backoff. Reset to 0 after a successful connection.
+     */
+    backoffAttempts = 0;
+    /**
+     * Backoff policy (discoverable constants)
+     * - BACKOFF_INITIAL_MS: initial delay for the first automatic retry
+     * - BACKOFF_MULTIPLIER: exponential growth factor for each failed attempt
+     * - BACKOFF_MAX_MS: upper bound for the delay
+     * - BACKOFF_JITTER_RATIO: jitter range as a fraction of the base delay
+     *
+     * Jitter is applied symmetrically in [-ratio, +ratio]. For example, with a
+     * 500ms base delay and 0.2 ratio, the actual delay is in [400ms, 600ms].
+     *
+     * The backoff applies only to automatic reconnects started from the
+     * `onclose` handler. Explicit/manual calls to `reconnect()` run immediately
+     * (no backoff), and will preempt any scheduled automatic attempt.
+     */
+    static BACKOFF_INITIAL_MS = 500;
+    static BACKOFF_MULTIPLIER = 2;
+    static BACKOFF_MAX_MS = 30_000;
+    static BACKOFF_JITTER_RATIO = 0.2;
     /**
      * Private constructor to enforce using the static create method.
      * @param endpoint - The URL of the MCP server to connect to
-     * @param transport - The transport to use for the MCP client
+     * @param transportType - The transport to use for the MCP client
      * @param headers - Optional custom headers to include in requests
      */
-    constructor(endpoint, transport, headers) {
-        if (transport === MCPTransport.SSE) {
-            this.transport = new sse_js_1.SSEClientTransport(new URL(endpoint), {
-                requestInit: { headers },
-            });
-        }
-        else {
-            this.transport = new streamableHttp_js_1.StreamableHTTPClientTransport(new URL(endpoint), {
-                requestInit: { headers },
-            });
-        }
-        this.client = new index_js_1.Client({
-            name: "tambo-mcp-client",
-            version: "1.0.0",
-        });
+    constructor(endpoint, transportType, headers = {}) {
+        this.endpoint = endpoint;
+        this.headers = headers;
+        this.transportType = transportType;
+        this.transport = this.initializeTransport(undefined);
+        this.client = this.initializeClient();
     }
     /**
      * Creates and initializes a new MCPClient instance.
      * This is the recommended way to create an MCPClient as it handles both
      * instantiation and connection setup.
      * @param endpoint - The URL of the MCP server to connect to
-     * @param transport - The transport type to use for the MCP client. Defaults to HTTP.
+     * @param transportType - The transport type to use for the MCP client. Defaults to HTTP.
      * @param headers - Optional custom headers to include in requests
      * @returns A connected MCPClient instance ready for use
      * @throws Will throw an error if connection fails
      */
-    static async create(endpoint, transport = MCPTransport.HTTP, headers) {
-        const mcpClient = new MCPClient(endpoint, transport, headers);
+    static async create(endpoint, transportType = MCPTransport.HTTP, headers) {
+        const mcpClient = new MCPClient(endpoint, transportType, headers);
         await mcpClient.client.connect(mcpClient.transport);
         return mcpClient;
     }
+    /**
+     * Reconnects to the MCP server, optionally retaining the same session ID.
+     *
+     * Single‑flight semantics:
+     * - If a reconnect is already in progress (triggered either manually or by
+     * the automatic `onclose` handler), additional calls will await the
+     * in-flight reconnect rather than start another one.
+     * - If an automatic reconnect has been scheduled but not yet started (i.e.,
+     * we are waiting in a backoff delay), calling `reconnect()` manually will
+     * cancel the scheduled attempt and perform an immediate reconnect.
+     *
+     * Backoff policy:
+     * - Backoff delays with jitter are applied only for automatic reconnects
+     * (via `onclose`). Manual calls to `reconnect()` do not use backoff.
+     * @param newSession - Whether to create a new session (true) or reuse existing session ID (false)
+     * @param reportErrorOnClose - Whether to report errors when closing the client
+     * Note that only StreamableHTTPClientTransport supports session IDs.
+     */
+    async reconnect(newSession = false, reportErrorOnClose = true) {
+        // If a reconnect is already running, coalesce into it.
+        if (this.reconnecting) {
+            return await this.reconnecting;
+        }
+        // Manual reconnect preempts any scheduled automatic attempt.
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        const doReconnect = async () => {
+            const sessionId = newSession
+                ? undefined
+                : "sessionId" in this.transport
+                    ? this.transport.sessionId
+                    : undefined;
+            // Prevent re-entrant onclose during deliberate close by detaching
+            // the handler from the previous client instance.
+            const prevClient = this.client;
+            // Prevent re-entrant onclose callbacks from the previous client
+            prevClient.onclose = undefined;
+            try {
+                await prevClient.close();
+            }
+            catch (error) {
+                if (reportErrorOnClose) {
+                    console.error("Error closing Tambo MCP Client:", error);
+                }
+            }
+            this.transport = this.initializeTransport(sessionId);
+            this.client = this.initializeClient();
+            await this.client.connect(this.transport);
+        };
+        this.reconnecting = (async () => {
+            try {
+                await doReconnect();
+                // Successful manual reconnect: reset backoff.
+                this.backoffAttempts = 0;
+            }
+            finally {
+                this.reconnecting = undefined;
+            }
+        })();
+        return await this.reconnecting;
+    }
+    /**
+     * Called by the underlying MCP SDK when the connection closes.
+     * Schedules an automatic reconnect with bounded exponential backoff and
+     * jitter. If a reconnect is already scheduled or running, this is a no-op.
+     */
+    onclose() {
+        this.scheduleAutoReconnect();
+    }
+    /**
+     * Compute the next backoff delay with symmetric jitter.
+     */
+    computeBackoffDelayMs() {
+        const base = Math.min(MCPClient.BACKOFF_MAX_MS, MCPClient.BACKOFF_INITIAL_MS *
+            Math.pow(MCPClient.BACKOFF_MULTIPLIER, this.backoffAttempts));
+        const jitterRange = MCPClient.BACKOFF_JITTER_RATIO * base;
+        const jitter = (Math.random() * 2 - 1) * jitterRange; // [-range, +range]
+        const ms = Math.max(0, Math.round(base + jitter));
+        return ms;
+    }
+    /**
+     * Schedule an automatic reconnect attempt if one is not already scheduled
+     * or running. Uses the backoff policy and self-reschedules on failure.
+     */
+    scheduleAutoReconnect() {
+        if (this.reconnecting || this.reconnectTimer) {
+            return;
+        }
+        const delayMs = this.computeBackoffDelayMs();
+        console.warn("Tambo MCP Client closed; attempting automatic reconnect in", `${delayMs}ms`);
+        this.reconnectTimer = setTimeout(async () => {
+            this.reconnectTimer = undefined;
+            // Start the actual reconnect (single-flight)
+            const inFlight = (this.reconnecting = this.reconnect(false, false));
+            try {
+                await inFlight;
+                // Success: reset attempts
+                this.backoffAttempts = 0;
+            }
+            catch (err) {
+                // Failure: increase attempts; scheduling occurs in finally below so the
+                // new timer isn't blocked by `this.reconnecting` being truthy.
+                this.backoffAttempts += 1;
+                console.warn("Automatic reconnect failed; will retry with backoff.", err);
+            }
+            finally {
+                this.reconnecting = undefined;
+                if (this.backoffAttempts > 0) {
+                    this.scheduleAutoReconnect();
+                }
+            }
+        }, delayMs);
+    }
+    initializeTransport(sessionId) {
+        if (this.transportType === MCPTransport.SSE) {
+            return new sse_js_1.SSEClientTransport(new URL(this.endpoint), {
+                requestInit: { headers: this.headers },
+            });
+        }
+        else {
+            return new streamableHttp_js_1.StreamableHTTPClientTransport(new URL(this.endpoint), {
+                sessionId,
+                requestInit: { headers: this.headers },
+            });
+        }
+    }
+    initializeClient() {
+        const client = new index_js_1.Client({
+            name: "tambo-mcp-client",
+            version: "1.0.0",
+        });
+        client.onclose = this.onclose.bind(this);
+        return client;
+    }
     /**
      * Retrieves a complete list of all available tools from the MCP server.
      * Handles pagination automatically by following cursors until all tools are fetched.

package/dist/mcp/mcp-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../src/mcp/mcp-client.ts"],"names":[],"mappings":";;;AAAA,wEAAmE;AACnE,oEAA6E;AAC7E,0FAAmG;AAGnG,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,2BAAW,CAAA;IACX,6BAAa,CAAA;AACf,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB;AACD;;;;;;;;;GASG;AACH,MAAa,SAAS;IACZ,MAAM,CAAS;IACf,SAAS,CAAqD;IAEtE;;;;;OAKG;IACH,YACE,QAAgB,EAChB,SAAuB,EACvB,OAAgC;QAEhC,IAAI,SAAS,KAAK,YAAY,CAAC,GAAG,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,GAAG,IAAI,2BAAkB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE;gBACzD,WAAW,EAAE,EAAE,OAAO,EAAE;aACzB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,GAAG,IAAI,iDAA6B,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE;gBACpE,WAAW,EAAE,EAAE,OAAO,EAAE;aACzB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAM,CAAC;YACvB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,QAAgB,EAChB,YAA0B,YAAY,CAAC,IAAI,EAC3C,OAAgC;QAEhC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9D,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACpD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,IAAI,MAAM,GAAuB,SAAS,CAAC;QAE3C,OAAO,OAAO,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YAC7D,QAAQ,CAAC,IAAI,CACX,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAe,EAAE;gBAC1C,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACvC,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,CAAC,IAAI,mBAAmB,CACtD,CAAC;gBACJ,CAAC;gBAED,OAAO;oBACL,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,WAAW,EAAE,IAAI,CAAC,WAA0B;iBAC7C,CAAC;YACJ,CAAC,CAAC,CACH,CAAC;YAEF,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACxB,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,IAA6B;QACxD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACxC,IAAI;YACJ,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAvGD,8BAuGC","sourcesContent":["import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport { JSONSchema7 } from \"json-schema\";\n\nexport enum MCPTransport {\n  SSE = \"sse\",\n  HTTP = \"http\",\n}\n/**\n * A client for interacting with MCP (Model Context Protocol) servers.\n * Provides a simple interface for listing and calling tools exposed by the server.\n * @example\n * ```typescript\n * const mcp = await MCPClient.create('https://api.example.com/mcp');\n * const tools = await mcp.listTools();\n * const result = await mcp.callTool('toolName', { arg1: 'value1' });\n * ```\n */\nexport class MCPClient {\n  private client: Client;\n  private transport: SSEClientTransport | StreamableHTTPClientTransport;\n\n  /**\n   * Private constructor to enforce using the static create method.\n   * @param endpoint - The URL of the MCP server to connect to\n   * @param transport - The transport to use for the MCP client\n   * @param headers - Optional custom headers to include in requests\n   */\n  private constructor(\n    endpoint: string,\n    transport: MCPTransport,\n    headers?: Record<string, string>,\n  ) {\n    if (transport === MCPTransport.SSE) {\n      this.transport = new SSEClientTransport(new URL(endpoint), {\n        requestInit: { headers },\n      });\n    } else {\n      this.transport = new StreamableHTTPClientTransport(new URL(endpoint), {\n        requestInit: { headers },\n      });\n    }\n    this.client = new Client({\n      name: \"tambo-mcp-client\",\n      version: \"1.0.0\",\n    });\n  }\n\n  /**\n   * Creates and initializes a new MCPClient instance.\n   * This is the recommended way to create an MCPClient as it handles both\n   * instantiation and connection setup.\n   * @param endpoint - The URL of the MCP server to connect to\n   * @param transport - The transport type to use for the MCP client. Defaults to HTTP.\n   * @param headers - Optional custom headers to include in requests\n   * @returns A connected MCPClient instance ready for use\n   * @throws Will throw an error if connection fails\n   */\n  static async create(\n    endpoint: string,\n    transport: MCPTransport = MCPTransport.HTTP,\n    headers?: Record<string, string>,\n  ): Promise<MCPClient> {\n    const mcpClient = new MCPClient(endpoint, transport, headers);\n    await mcpClient.client.connect(mcpClient.transport);\n    return mcpClient;\n  }\n\n  /**\n   * Retrieves a complete list of all available tools from the MCP server.\n   * Handles pagination automatically by following cursors until all tools are fetched.\n   * @returns A complete list of all available tools and their descriptions\n   * @throws Will throw an error if any server request fails during pagination\n   */\n  async listTools(): Promise<MCPToolSpec[]> {\n    const allTools: MCPToolSpec[] = [];\n    let hasMore = true;\n    let cursor: string | undefined = undefined;\n\n    while (hasMore) {\n      const response = await this.client.listTools({ cursor }, {});\n      allTools.push(\n        ...response.tools.map((tool): MCPToolSpec => {\n          if (tool.inputSchema.type !== \"object\") {\n            throw new Error(\n              `Input schema for tool ${tool.name} is not an object`,\n            );\n          }\n\n          return {\n            name: tool.name,\n            description: tool.description,\n            inputSchema: tool.inputSchema as JSONSchema7,\n          };\n        }),\n      );\n\n      if (response.nextCursor) {\n        cursor = response.nextCursor;\n      } else {\n        hasMore = false;\n      }\n    }\n\n    return allTools;\n  }\n\n  /**\n   * Calls a specific tool on the MCP server with the provided arguments.\n   * @param name - The name of the tool to call\n   * @param args - Arguments to pass to the tool, must match the tool's expected schema\n   * @returns The result from the tool execution\n   * @throws Will throw an error if the tool call fails or if arguments are invalid\n   */\n  async callTool(name: string, args: Record<string, unknown>) {\n    const result = await this.client.callTool({\n      name,\n      arguments: args,\n    });\n    return result;\n  }\n}\n\n// Example usage:\n/*\nconst mcp = await MCPClient.create('https://api.example.com/mcp', MCPTransport.HTTP);\nconst tools = await mcp.listTools();\nconst result = await mcp.callTool('toolName', { arg1: 'value1' });\n*/\n\nexport interface MCPToolSpec {\n  name: string;\n  description?: string;\n  inputSchema?: JSONSchema7;\n}\n"]}
+{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../src/mcp/mcp-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { SSEClientTransport } from \"@modelcontextprotocol/sdk/client/sse.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport { JSONSchema7 } from \"json-schema\";\n\nexport enum MCPTransport {\n  SSE = \"sse\",\n  HTTP = \"http\",\n}\n/**\n * A client for interacting with MCP (Model Context Protocol) servers.\n * Provides a simple interface for listing and calling tools exposed by the server.\n * @example\n * ```typescript\n * const mcp = await MCPClient.create('https://api.example.com/mcp');\n * const tools = await mcp.listTools();\n * const result = await mcp.callTool('toolName', { arg1: 'value1' });\n * ```\n */\nexport class MCPClient {\n  private client: Client;\n  private transport: SSEClientTransport | StreamableHTTPClientTransport;\n  private transportType: MCPTransport;\n  private endpoint: string;\n  private headers: Record<string, string>;\n  /**\n   * Tracks an in-flight reconnect so concurrent triggers coalesce\n   * (single-flight). When set, additional calls to `reconnect()` or\n   * the automatic `onclose` handler will await the same Promise instead of\n   * starting another reconnect sequence.\n   */\n  private reconnecting?: Promise<void>;\n  /**\n   * Timer id for a scheduled automatic reconnect (used by `onclose`).\n   * Present only while waiting for the backoff delay to elapse.\n   */\n  private reconnectTimer?: ReturnType<typeof setTimeout>;\n  /**\n   * Count of consecutive automatic reconnect failures used to compute\n   * exponential backoff. Reset to 0 after a successful connection.\n   */\n  private backoffAttempts = 0;\n\n  /**\n   * Backoff policy (discoverable constants)\n   * - BACKOFF_INITIAL_MS: initial delay for the first automatic retry\n   * - BACKOFF_MULTIPLIER: exponential growth factor for each failed attempt\n   * - BACKOFF_MAX_MS: upper bound for the delay\n   * - BACKOFF_JITTER_RATIO: jitter range as a fraction of the base delay\n   *\n   * Jitter is applied symmetrically in [-ratio, +ratio]. For example, with a\n   * 500ms base delay and 0.2 ratio, the actual delay is in [400ms, 600ms].\n   *\n   * The backoff applies only to automatic reconnects started from the\n   * `onclose` handler. Explicit/manual calls to `reconnect()` run immediately\n   * (no backoff), and will preempt any scheduled automatic attempt.\n   */\n  static readonly BACKOFF_INITIAL_MS = 500;\n  static readonly BACKOFF_MULTIPLIER = 2;\n  static readonly BACKOFF_MAX_MS = 30_000;\n  static readonly BACKOFF_JITTER_RATIO = 0.2;\n\n  /**\n   * Private constructor to enforce using the static create method.\n   * @param endpoint - The URL of the MCP server to connect to\n   * @param transportType - The transport to use for the MCP client\n   * @param headers - Optional custom headers to include in requests\n   */\n  private constructor(\n    endpoint: string,\n    transportType: MCPTransport,\n    headers: Record<string, string> = {},\n  ) {\n    this.endpoint = endpoint;\n    this.headers = headers;\n    this.transportType = transportType;\n    this.transport = this.initializeTransport(undefined);\n    this.client = this.initializeClient();\n  }\n\n  /**\n   * Creates and initializes a new MCPClient instance.\n   * This is the recommended way to create an MCPClient as it handles both\n   * instantiation and connection setup.\n   * @param endpoint - The URL of the MCP server to connect to\n   * @param transportType - The transport type to use for the MCP client. Defaults to HTTP.\n   * @param headers - Optional custom headers to include in requests\n   * @returns A connected MCPClient instance ready for use\n   * @throws Will throw an error if connection fails\n   */\n  static async create(\n    endpoint: string,\n    transportType: MCPTransport = MCPTransport.HTTP,\n    headers?: Record<string, string>,\n  ): Promise<MCPClient> {\n    const mcpClient = new MCPClient(endpoint, transportType, headers);\n    await mcpClient.client.connect(mcpClient.transport);\n    return mcpClient;\n  }\n  /**\n   * Reconnects to the MCP server, optionally retaining the same session ID.\n   *\n   * Single‑flight semantics:\n   * - If a reconnect is already in progress (triggered either manually or by\n   * the automatic `onclose` handler), additional calls will await the\n   * in-flight reconnect rather than start another one.\n   * - If an automatic reconnect has been scheduled but not yet started (i.e.,\n   * we are waiting in a backoff delay), calling `reconnect()` manually will\n   * cancel the scheduled attempt and perform an immediate reconnect.\n   *\n   * Backoff policy:\n   * - Backoff delays with jitter are applied only for automatic reconnects\n   * (via `onclose`). Manual calls to `reconnect()` do not use backoff.\n   * @param newSession - Whether to create a new session (true) or reuse existing session ID (false)\n   * @param reportErrorOnClose - Whether to report errors when closing the client\n   * Note that only StreamableHTTPClientTransport supports session IDs.\n   */\n  async reconnect(newSession = false, reportErrorOnClose = true) {\n    // If a reconnect is already running, coalesce into it.\n    if (this.reconnecting) {\n      return await this.reconnecting;\n    }\n\n    // Manual reconnect preempts any scheduled automatic attempt.\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = undefined;\n    }\n\n    const doReconnect = async () => {\n      const sessionId = newSession\n        ? undefined\n        : \"sessionId\" in this.transport\n          ? this.transport.sessionId\n          : undefined;\n\n      // Prevent re-entrant onclose during deliberate close by detaching\n      // the handler from the previous client instance.\n      const prevClient = this.client;\n      // Prevent re-entrant onclose callbacks from the previous client\n      prevClient.onclose = undefined;\n\n      try {\n        await prevClient.close();\n      } catch (error) {\n        if (reportErrorOnClose) {\n          console.error(\"Error closing Tambo MCP Client:\", error);\n        }\n      }\n\n      this.transport = this.initializeTransport(sessionId);\n      this.client = this.initializeClient();\n      await this.client.connect(this.transport);\n    };\n\n    this.reconnecting = (async () => {\n      try {\n        await doReconnect();\n        // Successful manual reconnect: reset backoff.\n        this.backoffAttempts = 0;\n      } finally {\n        this.reconnecting = undefined;\n      }\n    })();\n\n    return await this.reconnecting;\n  }\n\n  /**\n   * Called by the underlying MCP SDK when the connection closes.\n   * Schedules an automatic reconnect with bounded exponential backoff and\n   * jitter. If a reconnect is already scheduled or running, this is a no-op.\n   */\n  private onclose() {\n    this.scheduleAutoReconnect();\n  }\n\n  /**\n   * Compute the next backoff delay with symmetric jitter.\n   */\n  private computeBackoffDelayMs(): number {\n    const base = Math.min(\n      MCPClient.BACKOFF_MAX_MS,\n      MCPClient.BACKOFF_INITIAL_MS *\n        Math.pow(MCPClient.BACKOFF_MULTIPLIER, this.backoffAttempts),\n    );\n    const jitterRange = MCPClient.BACKOFF_JITTER_RATIO * base;\n    const jitter = (Math.random() * 2 - 1) * jitterRange; // [-range, +range]\n    const ms = Math.max(0, Math.round(base + jitter));\n    return ms;\n  }\n\n  /**\n   * Schedule an automatic reconnect attempt if one is not already scheduled\n   * or running. Uses the backoff policy and self-reschedules on failure.\n   */\n  private scheduleAutoReconnect() {\n    if (this.reconnecting || this.reconnectTimer) {\n      return;\n    }\n\n    const delayMs = this.computeBackoffDelayMs();\n    console.warn(\n      \"Tambo MCP Client closed; attempting automatic reconnect in\",\n      `${delayMs}ms`,\n    );\n\n    this.reconnectTimer = setTimeout(async () => {\n      this.reconnectTimer = undefined;\n      // Start the actual reconnect (single-flight)\n      const inFlight = (this.reconnecting = this.reconnect(false, false));\n      try {\n        await inFlight;\n        // Success: reset attempts\n        this.backoffAttempts = 0;\n      } catch (err) {\n        // Failure: increase attempts; scheduling occurs in finally below so the\n        // new timer isn't blocked by `this.reconnecting` being truthy.\n        this.backoffAttempts += 1;\n        console.warn(\n          \"Automatic reconnect failed; will retry with backoff.\",\n          err,\n        );\n      } finally {\n        this.reconnecting = undefined;\n        if (this.backoffAttempts > 0) {\n          this.scheduleAutoReconnect();\n        }\n      }\n    }, delayMs);\n  }\n\n  private initializeTransport(sessionId: string | undefined) {\n    if (this.transportType === MCPTransport.SSE) {\n      return new SSEClientTransport(new URL(this.endpoint), {\n        requestInit: { headers: this.headers },\n      });\n    } else {\n      return new StreamableHTTPClientTransport(new URL(this.endpoint), {\n        sessionId,\n        requestInit: { headers: this.headers },\n      });\n    }\n  }\n\n  private initializeClient() {\n    const client = new Client({\n      name: \"tambo-mcp-client\",\n      version: \"1.0.0\",\n    });\n    client.onclose = this.onclose.bind(this);\n    return client;\n  }\n\n  /**\n   * Retrieves a complete list of all available tools from the MCP server.\n   * Handles pagination automatically by following cursors until all tools are fetched.\n   * @returns A complete list of all available tools and their descriptions\n   * @throws Will throw an error if any server request fails during pagination\n   */\n  async listTools(): Promise<MCPToolSpec[]> {\n    const allTools: MCPToolSpec[] = [];\n    let hasMore = true;\n    let cursor: string | undefined = undefined;\n\n    while (hasMore) {\n      const response = await this.client.listTools({ cursor }, {});\n      allTools.push(\n        ...response.tools.map((tool): MCPToolSpec => {\n          if (tool.inputSchema.type !== \"object\") {\n            throw new Error(\n              `Input schema for tool ${tool.name} is not an object`,\n            );\n          }\n\n          return {\n            name: tool.name,\n            description: tool.description,\n            inputSchema: tool.inputSchema as JSONSchema7,\n          };\n        }),\n      );\n\n      if (response.nextCursor) {\n        cursor = response.nextCursor;\n      } else {\n        hasMore = false;\n      }\n    }\n\n    return allTools;\n  }\n\n  /**\n   * Calls a specific tool on the MCP server with the provided arguments.\n   * @param name - The name of the tool to call\n   * @param args - Arguments to pass to the tool, must match the tool's expected schema\n   * @returns The result from the tool execution\n   * @throws Will throw an error if the tool call fails or if arguments are invalid\n   */\n  async callTool(name: string, args: Record<string, unknown>) {\n    const result = await this.client.callTool({\n      name,\n      arguments: args,\n    });\n    return result;\n  }\n}\n\n// Example usage:\n/*\nconst mcp = await MCPClient.create('https://api.example.com/mcp', MCPTransport.HTTP);\nconst tools = await mcp.listTools();\nconst result = await mcp.callTool('toolName', { arg1: 'value1' });\n*/\n\nexport interface MCPToolSpec {\n  name: string;\n  description?: string;\n  inputSchema?: JSONSchema7;\n}\n"]}

package/dist/mcp/tambo-mcp-provider.d.ts

@@ -4,6 +4,7 @@ import { MCPTransport } from "./mcp-client";
  * Extracts error message from MCP tool result content.
  * Handles both array and string content formats.
  * Always returns a string, even for invalid/null inputs.
+ * @returns The extracted error message as a string
  */
 export declare function extractErrorMessage(content: unknown): string;
 export interface McpServerInfo {

package/dist/mcp/tambo-mcp-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-mcp-provider.d.ts","sourceRoot":"","sources":["../../src/mcp/tambo-mcp-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAa,MAAM,OAAO,CAAC;AAGtC,OAAO,EAAa,YAAY,EAAE,MAAM,cAAc,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAsB5D;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AACD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC;IAChC,UAAU,EAAE,CAAC,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAkEA,CAAC"}
+{"version":3,"file":"tambo-mcp-provider.d.ts","sourceRoot":"","sources":["../../src/mcp/tambo-mcp-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAa,MAAM,OAAO,CAAC;AAGtC,OAAO,EAAa,YAAY,EAAE,MAAM,cAAc,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAsB5D;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AACD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC;IAChC,UAAU,EAAE,CAAC,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAkEA,CAAC"}

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

@@ -9,6 +9,7 @@ const mcp_client_1 = require("./mcp-client");
  * Extracts error message from MCP tool result content.
  * Handles both array and string content formats.
  * Always returns a string, even for invalid/null inputs.
+ * @returns The extracted error message as a string
  */
 function extractErrorMessage(content) {
     if (content === undefined || content === null) {

package/dist/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 { FC, useEffect } from \"react\";\nimport { TamboTool } from \"../model/component-metadata\";\nimport { useTamboRegistry } from \"../providers/tambo-registry-provider\";\nimport { MCPClient, MCPTransport } 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 */\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(\n        (item) => item && item.type === \"text\" && typeof item.text === \"string\",\n      )\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\nexport interface McpServerInfo {\n  name?: string;\n  url: string;\n  description?: string;\n  transport?: MCPTransport;\n  customHeaders?: Record<string, string>;\n}\n/**\n * This provider is used to register tools from MCP servers.\n * @returns the wrapped children\n */\nexport const TamboMcpProvider: FC<{\n  mcpServers: (McpServerInfo | string)[];\n  children: React.ReactNode;\n}> = ({ mcpServers, children }) => {\n  const { registerTool } = useTamboRegistry();\n\n  useEffect(() => {\n    if (!mcpServers) {\n      return;\n    }\n    async function registerMcpServers(mcpServers: (McpServerInfo | string)[]) {\n      // Maps tool names to the MCP client that registered them\n      const mcpServerMap = new Map<string, MCPClient>();\n      const serverToolLists = mcpServers.map(async (mcpServer) => {\n        const server =\n          typeof mcpServer === \"string\"\n            ? { url: mcpServer, transport: MCPTransport.SSE }\n            : mcpServer;\n        const { url, transport = MCPTransport.SSE, customHeaders } = server;\n        const mcpClient = await MCPClient.create(url, transport, customHeaders);\n        const tools = await mcpClient.listTools();\n        tools.forEach((tool) => {\n          mcpServerMap.set(tool.name, mcpClient);\n        });\n        return tools;\n      });\n      const toolResults = await Promise.allSettled(serverToolLists);\n\n      // Just log the failed tools, we can't do anything about them\n      const failedTools = toolResults.filter(\n        (result) => result.status === \"rejected\",\n      );\n      if (failedTools.length > 0) {\n        console.error(\n          \"Failed to register tools from MCP servers:\",\n          failedTools.map((result) => result.reason),\n        );\n      }\n\n      // Register the successful tools\n      const allTools = toolResults\n        .filter((result) => result.status === \"fulfilled\")\n        .map((result) => result.value)\n        .flat();\n      allTools.forEach((tool) => {\n        registerTool({\n          description: tool.description ?? \"\",\n          name: tool.name,\n          tool: async (args: Record<string, unknown>) => {\n            const mcpServer = mcpServerMap.get(tool.name);\n            if (!mcpServer) {\n              // should never happen\n              throw new Error(`MCP server for tool ${tool.name} not found`);\n            }\n            const result = await mcpServer.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          toolSchema: tool.inputSchema as TamboTool[\"toolSchema\"],\n        });\n      });\n    }\n    registerMcpServers(mcpServers);\n  }, [mcpServers, registerTool]);\n\n  return children;\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 { FC, useEffect } from \"react\";\nimport { TamboTool } from \"../model/component-metadata\";\nimport { useTamboRegistry } from \"../providers/tambo-registry-provider\";\nimport { MCPClient, MCPTransport } 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(\n        (item) => item && item.type === \"text\" && typeof item.text === \"string\",\n      )\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\nexport interface McpServerInfo {\n  name?: string;\n  url: string;\n  description?: string;\n  transport?: MCPTransport;\n  customHeaders?: Record<string, string>;\n}\n/**\n * This provider is used to register tools from MCP servers.\n * @returns the wrapped children\n */\nexport const TamboMcpProvider: FC<{\n  mcpServers: (McpServerInfo | string)[];\n  children: React.ReactNode;\n}> = ({ mcpServers, children }) => {\n  const { registerTool } = useTamboRegistry();\n\n  useEffect(() => {\n    if (!mcpServers) {\n      return;\n    }\n    async function registerMcpServers(mcpServers: (McpServerInfo | string)[]) {\n      // Maps tool names to the MCP client that registered them\n      const mcpServerMap = new Map<string, MCPClient>();\n      const serverToolLists = mcpServers.map(async (mcpServer) => {\n        const server =\n          typeof mcpServer === \"string\"\n            ? { url: mcpServer, transport: MCPTransport.SSE }\n            : mcpServer;\n        const { url, transport = MCPTransport.SSE, customHeaders } = server;\n        const mcpClient = await MCPClient.create(url, transport, customHeaders);\n        const tools = await mcpClient.listTools();\n        tools.forEach((tool) => {\n          mcpServerMap.set(tool.name, mcpClient);\n        });\n        return tools;\n      });\n      const toolResults = await Promise.allSettled(serverToolLists);\n\n      // Just log the failed tools, we can't do anything about them\n      const failedTools = toolResults.filter(\n        (result) => result.status === \"rejected\",\n      );\n      if (failedTools.length > 0) {\n        console.error(\n          \"Failed to register tools from MCP servers:\",\n          failedTools.map((result) => result.reason),\n        );\n      }\n\n      // Register the successful tools\n      const allTools = toolResults\n        .filter((result) => result.status === \"fulfilled\")\n        .map((result) => result.value)\n        .flat();\n      allTools.forEach((tool) => {\n        registerTool({\n          description: tool.description ?? \"\",\n          name: tool.name,\n          tool: async (args: Record<string, unknown>) => {\n            const mcpServer = mcpServerMap.get(tool.name);\n            if (!mcpServer) {\n              // should never happen\n              throw new Error(`MCP server for tool ${tool.name} not found`);\n            }\n            const result = await mcpServer.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          toolSchema: tool.inputSchema as TamboTool[\"toolSchema\"],\n        });\n      });\n    }\n    registerMcpServers(mcpServers);\n  }, [mcpServers, registerTool]);\n\n  return children;\n};\n"]}

package/dist/model/tambo-interactable.d.ts

@@ -13,7 +13,7 @@ export interface TamboInteractableContext {
     /** Remove an interactable component by ID */
     removeInteractableComponent: (id: string) => void;
     /** Update an interactable component's props */
-    updateInteractableComponentProps: (id: string, newProps: Record<string, any>) => void;
+    updateInteractableComponentProps: (id: string, newProps: Record<string, any>) => string;
     /** Get an interactable component by ID */
     getInteractableComponent: (id: string) => TamboInteractableComponent | undefined;
     /** Get all interactable components by component name */

package/dist/model/tambo-interactable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-interactable.d.ts","sourceRoot":"","sources":["../../src/model/tambo-interactable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,0BAA2B,SAAQ,cAAc;IAChE,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,sBAAsB,EAAE,0BAA0B,EAAE,CAAC;IACrD,uCAAuC;IACvC,wBAAwB,EAAE,CACxB,SAAS,EAAE,IAAI,CAAC,0BAA0B,EAAE,IAAI,GAAG,WAAW,CAAC,KAC5D,MAAM,CAAC;IACZ,6CAA6C;IAC7C,2BAA2B,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,+CAA+C;IAC/C,gCAAgC,EAAE,CAChC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC1B,IAAI,CAAC;IACV,0CAA0C;IAC1C,wBAAwB,EAAE,CACxB,EAAE,EAAE,MAAM,KACP,0BAA0B,GAAG,SAAS,CAAC;IAC5C,wDAAwD;IACxD,+BAA+B,EAAE,CAC/B,aAAa,EAAE,MAAM,KAClB,0BAA0B,EAAE,CAAC;IAClC,wCAAwC;IACxC,8BAA8B,EAAE,MAAM,IAAI,CAAC;CAC5C"}
+{"version":3,"file":"tambo-interactable.d.ts","sourceRoot":"","sources":["../../src/model/tambo-interactable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,0BAA2B,SAAQ,cAAc;IAChE,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,sBAAsB,EAAE,0BAA0B,EAAE,CAAC;IACrD,uCAAuC;IACvC,wBAAwB,EAAE,CACxB,SAAS,EAAE,IAAI,CAAC,0BAA0B,EAAE,IAAI,GAAG,WAAW,CAAC,KAC5D,MAAM,CAAC;IACZ,6CAA6C;IAC7C,2BAA2B,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,+CAA+C;IAC/C,gCAAgC,EAAE,CAChC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC1B,MAAM,CAAC;IACZ,0CAA0C;IAC1C,wBAAwB,EAAE,CACxB,EAAE,EAAE,MAAM,KACP,0BAA0B,GAAG,SAAS,CAAC;IAC5C,wDAAwD;IACxD,+BAA+B,EAAE,CAC/B,aAAa,EAAE,MAAM,KAClB,0BAA0B,EAAE,CAAC;IAClC,wCAAwC;IACxC,8BAA8B,EAAE,MAAM,IAAI,CAAC;CAC5C"}

package/dist/model/tambo-interactable.js.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-interactable.js","sourceRoot":"","sources":["../../src/model/tambo-interactable.ts"],"names":[],"mappings":"","sourcesContent":["import { TamboComponent } from \"./component-metadata\";\n\nexport interface TamboInteractableComponent extends TamboComponent {\n  /** Unique identifier for this component instance */\n  id: string;\n  /** Current props for the component */\n  props: Record<string, any>;\n}\n\nexport interface TamboInteractableContext {\n  /** List of all interactable components */\n  interactableComponents: TamboInteractableComponent[];\n  /** Add a new interactable component */\n  addInteractableComponent: (\n    component: Omit<TamboInteractableComponent, \"id\" | \"createdAt\">,\n  ) => string;\n  /** Remove an interactable component by ID */\n  removeInteractableComponent: (id: string) => void;\n  /** Update an interactable component's props */\n  updateInteractableComponentProps: (\n    id: string,\n    newProps: Record<string, any>,\n  ) => void;\n  /** Get an interactable component by ID */\n  getInteractableComponent: (\n    id: string,\n  ) => TamboInteractableComponent | undefined;\n  /** Get all interactable components by component name */\n  getInteractableComponentsByName: (\n    componentName: string,\n  ) => TamboInteractableComponent[];\n  /** Clear all interactable components */\n  clearAllInteractableComponents: () => void;\n}\n"]}
+{"version":3,"file":"tambo-interactable.js","sourceRoot":"","sources":["../../src/model/tambo-interactable.ts"],"names":[],"mappings":"","sourcesContent":["import { TamboComponent } from \"./component-metadata\";\n\nexport interface TamboInteractableComponent extends TamboComponent {\n  /** Unique identifier for this component instance */\n  id: string;\n  /** Current props for the component */\n  props: Record<string, any>;\n}\n\nexport interface TamboInteractableContext {\n  /** List of all interactable components */\n  interactableComponents: TamboInteractableComponent[];\n  /** Add a new interactable component */\n  addInteractableComponent: (\n    component: Omit<TamboInteractableComponent, \"id\" | \"createdAt\">,\n  ) => string;\n  /** Remove an interactable component by ID */\n  removeInteractableComponent: (id: string) => void;\n  /** Update an interactable component's props */\n  updateInteractableComponentProps: (\n    id: string,\n    newProps: Record<string, any>,\n  ) => string;\n  /** Get an interactable component by ID */\n  getInteractableComponent: (\n    id: string,\n  ) => TamboInteractableComponent | undefined;\n  /** Get all interactable components by component name */\n  getInteractableComponentsByName: (\n    componentName: string,\n  ) => TamboInteractableComponent[];\n  /** Clear all interactable components */\n  clearAllInteractableComponents: () => void;\n}\n"]}

package/dist/providers/__tests__/tambo-interactable-provider-partial-updates.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tambo-interactable-provider-partial-updates.test.d.ts.map

package/dist/providers/__tests__/tambo-interactable-provider-partial-updates.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-interactable-provider-partial-updates.test.d.ts","sourceRoot":"","sources":["../../../src/providers/__tests__/tambo-interactable-provider-partial-updates.test.tsx"],"names":[],"mappings":""}