@tambo-ai/react 0.75.0 → 1.0.0-rc.4

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

@@ -1 +1 @@
-{"version":3,"file":"tambo-mcp-token-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-mcp-token-provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAEZ,iBAAiB,EAMlB,MAAM,OAAO,CAAC;AAQf,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAuF7D,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,MAAM,KAClB,yBAiEF,CAAC"}
+{"version":3,"file":"tambo-mcp-token-provider.d.ts","sourceRoot":"","sources":["../../src/providers/tambo-mcp-token-provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAEZ,KAAK,iBAAiB,EAMvB,MAAM,OAAO,CAAC;AAGf,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAsB7D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,MAAM,KAClB,yBA+CF,CAAC"}

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

@@ -37,21 +37,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.useTamboMcpToken = exports.TamboMcpTokenProvider = void 0;
 const react_1 = __importStar(require("react"));
 const tambo_client_provider_1 = require("./tambo-client-provider");
-const tambo_thread_provider_1 = require("./tambo-thread-provider");
 const TamboMcpTokenContext = (0, react_1.createContext)(undefined);
 /**
  * Provider for managing the MCP access token that is returned by the Tambo API.
  * This token is used to authenticate with the internal Tambo MCP server.
  *
- * Token selection logic:
- * - Returns the current thread's mcpAccessToken if available
- * - Returns null if no thread or thread has no token
- *
- * Token fetching:
- * - Thread-specific token: always fetched when switching to thread without token
- * - Tokens are fetched regardless of client-side MCP server configuration
- *   to support server-side MCP servers that are not visible to the provider
- * - Threadless tokens must be fetched by individual hooks/callbacks using contextKey
+ * Exposes the base URL and a null token by default. Token fetching is handled
+ * by the useTamboMcpToken hook which supports contextKey-based token retrieval.
  * @internal
  * @param props - The provider props
  * @param props.children - The children to wrap
@@ -64,71 +56,17 @@ const TamboMcpTokenProvider = ({ children, }) => {
     }
     const { client } = clientContext;
     const tamboBaseUrl = client.baseURL;
-    // Optional thread context - may not be available in all contexts
-    const threadContext = (0, react_1.useContext)(tambo_thread_provider_1.TamboThreadContext);
-    const currentThread = threadContext?.currentThread ?? null;
-    const currentThreadId = threadContext?.currentThreadId ?? null;
-    const setThreadMap = (0, react_1.useMemo)(() => threadContext?.setThreadMap ?? (() => { }), [threadContext?.setThreadMap]);
-    // Track previous thread ID to detect thread switches
-    const previousThreadId = (0, react_1.useRef)(null);
-    // Return the current thread's token or null
-    const selectedToken = (0, react_1.useMemo)(() => {
-        return currentThread?.mcpAccessToken ?? null;
-    }, [currentThread]);
-    // Fetch thread-specific token when switching to a thread without one
-    // Always fetch to support server-side MCP servers (not just client-side)
-    // Skip PLACEHOLDER_THREAD - never send it to the server
-    (0, react_1.useEffect)(() => {
-        const hasThreadChanged = previousThreadId.current !== currentThreadId;
-        previousThreadId.current = currentThreadId;
-        const isPlaceholderThread = currentThreadId === tambo_thread_provider_1.PLACEHOLDER_THREAD.id;
-        const shouldFetchThreadToken = hasThreadChanged &&
-            currentThreadId &&
-            !isPlaceholderThread &&
-            currentThread &&
-            !currentThread.mcpAccessToken;
-        if (shouldFetchThreadToken) {
-            const fetchThreadToken = async () => {
-                try {
-                    const response = await client.beta.auth.getMcpToken({
-                        threadId: currentThreadId,
-                    });
-                    if (response.mcpAccessToken) {
-                        // Update thread in threadMap with new token
-                        setThreadMap((prev) => {
-                            const thread = prev[currentThreadId];
-                            if (thread) {
-                                return {
-                                    ...prev,
-                                    [currentThreadId]: {
-                                        ...thread,
-                                        mcpAccessToken: response.mcpAccessToken,
-                                    },
-                                };
-                            }
-                            return prev;
-                        });
-                    }
-                }
-                catch (error) {
-                    console.error(`Failed to fetch MCP token for thread ${currentThreadId}:`, error);
-                }
-            };
-            void fetchThreadToken();
-        }
-    }, [currentThreadId, currentThread, client, setThreadMap]);
-    const value = (0, react_1.useMemo)(() => ({ mcpAccessToken: selectedToken, tamboBaseUrl }), [selectedToken, tamboBaseUrl]);
+    const value = (0, react_1.useMemo)(() => ({ mcpAccessToken: null, tamboBaseUrl }), [tamboBaseUrl]);
     return (react_1.default.createElement(TamboMcpTokenContext.Provider, { value: value }, children));
 };
 exports.TamboMcpTokenProvider = TamboMcpTokenProvider;
 /**
- * Hook to access the current MCP access token with optional threadless token fetching.
+ * Hook to access the current MCP access token with optional token fetching.
  *
- * Token selection logic:
- * 1. If current thread has mcpAccessToken → use thread-specific token
- * 2. Else if contextKey provided and no thread (or placeholder thread) → fetch and use threadless token
- * 3. Else → null
- * @param contextKey - Optional context key for fetching threadless tokens when not in a thread
+ * Token fetching logic:
+ * - If contextKey is provided → fetches a token using that contextKey
+ * - Otherwise → returns null
+ * @param contextKey - Optional context key for fetching tokens
  * @returns The current MCP access token and base URL
  */
 const useTamboMcpToken = (contextKey) => {
@@ -141,45 +79,30 @@ const useTamboMcpToken = (contextKey) => {
         throw new Error("useTamboMcpToken must be used within a TamboClientProvider");
     }
     const { client } = clientContext;
-    const threadContext = (0, react_1.useContext)(tambo_thread_provider_1.TamboThreadContext);
-    const currentThreadId = threadContext?.currentThreadId ?? null;
-    // State for threadless token
-    const [threadlessToken, setThreadlessToken] = (0, react_1.useState)(null);
+    // State for fetched token
+    const [fetchedToken, setFetchedToken] = (0, react_1.useState)(null);
     const hasAttemptedFetch = (0, react_1.useRef)(false);
-    // Determine if we should fetch a threadless token
-    const isPlaceholderThread = currentThreadId === tambo_thread_provider_1.PLACEHOLDER_THREAD.id;
-    const shouldFetchThreadless = contextKey &&
-        (!currentThreadId || isPlaceholderThread) &&
-        !context.mcpAccessToken &&
-        !threadlessToken &&
-        !hasAttemptedFetch.current;
-    // Fetch threadless token when needed
+    // Determine if we should fetch a token
+    const shouldFetch = contextKey && !fetchedToken && !hasAttemptedFetch.current;
+    // Fetch token when needed
     (0, react_1.useEffect)(() => {
-        if (shouldFetchThreadless) {
+        if (shouldFetch) {
             hasAttemptedFetch.current = true;
-            const fetchThreadlessToken = async () => {
+            const fetchToken = async () => {
                 try {
                     const response = await client.beta.auth.getMcpToken({ contextKey });
                     if (response.mcpAccessToken) {
-                        setThreadlessToken(response.mcpAccessToken);
+                        setFetchedToken(response.mcpAccessToken);
                     }
                 }
                 catch (error) {
-                    console.error("Failed to fetch threadless MCP token:", error);
+                    console.error("Failed to fetch MCP token:", error);
                 }
             };
-            void fetchThreadlessToken();
-        }
-    }, [shouldFetchThreadless, client, contextKey]);
-    // Reset threadless token when switching to a real thread
-    (0, react_1.useEffect)(() => {
-        if (currentThreadId && currentThreadId !== tambo_thread_provider_1.PLACEHOLDER_THREAD.id) {
-            setThreadlessToken(null);
-            hasAttemptedFetch.current = false;
+            void fetchToken();
         }
-    }, [currentThreadId]);
-    // Return thread token if available, otherwise threadless token
-    const selectedToken = context.mcpAccessToken ?? threadlessToken;
+    }, [shouldFetch, client, contextKey]);
+    const selectedToken = fetchedToken;
     return {
         mcpAccessToken: selectedToken,
         tamboBaseUrl: context.tamboBaseUrl,

package/dist/providers/tambo-mcp-token-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"tambo-mcp-token-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-mcp-token-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\nimport React, {\n  createContext,\n  PropsWithChildren,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport { TamboThread } from \"../model/tambo-thread\";\nimport { TamboClientContext } from \"./tambo-client-provider\";\nimport {\n  PLACEHOLDER_THREAD,\n  TamboThreadContext,\n} from \"./tambo-thread-provider\";\n\nexport interface TamboMcpTokenContextProps {\n  /**\n   * The current MCP access token for the internal Tambo MCP server.\n   * Prefers thread-specific token over threadless token.\n   */\n  mcpAccessToken: string | null;\n  /**\n   * The base URL for the Tambo API (used to construct the MCP server URL)\n   * Returns undefined if the client is not yet initialized\n   */\n  tamboBaseUrl: string | undefined;\n}\n\nconst TamboMcpTokenContext = createContext<\n  TamboMcpTokenContextProps | undefined\n>(undefined);\n\n/**\n * Provider for managing the MCP access token that is returned by the Tambo API.\n * This token is used to authenticate with the internal Tambo MCP server.\n *\n * Token selection logic:\n * - Returns the current thread's mcpAccessToken if available\n * - Returns null if no thread or thread has no token\n *\n * Token fetching:\n * - Thread-specific token: always fetched when switching to thread without token\n * - Tokens are fetched regardless of client-side MCP server configuration\n *   to support server-side MCP servers that are not visible to the provider\n * - Threadless tokens must be fetched by individual hooks/callbacks using contextKey\n * @internal\n * @param props - The provider props\n * @param props.children - The children to wrap\n * @returns The TamboMcpTokenProvider component\n */\nexport const TamboMcpTokenProvider: React.FC<PropsWithChildren> = ({\n  children,\n}) => {\n  const clientContext = useContext(TamboClientContext);\n  if (!clientContext) {\n    throw new Error(\n      \"TamboMcpTokenProvider must be used within a TamboClientProvider\",\n    );\n  }\n  const { client } = clientContext;\n  const tamboBaseUrl = client.baseURL;\n\n  // Optional thread context - may not be available in all contexts\n  const threadContext = useContext(TamboThreadContext);\n  const currentThread = threadContext?.currentThread ?? null;\n  const currentThreadId = threadContext?.currentThreadId ?? null;\n  const setThreadMap = useMemo(\n    () => threadContext?.setThreadMap ?? (() => {}),\n    [threadContext?.setThreadMap],\n  );\n\n  // Track previous thread ID to detect thread switches\n  const previousThreadId = useRef<string | null>(null);\n\n  // Return the current thread's token or null\n  const selectedToken = useMemo(() => {\n    return currentThread?.mcpAccessToken ?? null;\n  }, [currentThread]);\n\n  // Fetch thread-specific token when switching to a thread without one\n  // Always fetch to support server-side MCP servers (not just client-side)\n  // Skip PLACEHOLDER_THREAD - never send it to the server\n  useEffect(() => {\n    const hasThreadChanged = previousThreadId.current !== currentThreadId;\n    previousThreadId.current = currentThreadId;\n\n    const isPlaceholderThread = currentThreadId === PLACEHOLDER_THREAD.id;\n    const shouldFetchThreadToken =\n      hasThreadChanged &&\n      currentThreadId &&\n      !isPlaceholderThread &&\n      currentThread &&\n      !currentThread.mcpAccessToken;\n\n    if (shouldFetchThreadToken) {\n      const fetchThreadToken = async () => {\n        try {\n          const response = await client.beta.auth.getMcpToken({\n            threadId: currentThreadId,\n          });\n          if (response.mcpAccessToken) {\n            // Update thread in threadMap with new token\n            setThreadMap((prev: Record<string, TamboThread>) => {\n              const thread = prev[currentThreadId];\n              if (thread) {\n                return {\n                  ...prev,\n                  [currentThreadId]: {\n                    ...thread,\n                    mcpAccessToken: response.mcpAccessToken,\n                  },\n                };\n              }\n              return prev;\n            });\n          }\n        } catch (error) {\n          console.error(\n            `Failed to fetch MCP token for thread ${currentThreadId}:`,\n            error,\n          );\n        }\n      };\n      void fetchThreadToken();\n    }\n  }, [currentThreadId, currentThread, client, setThreadMap]);\n\n  const value = useMemo(\n    () => ({ mcpAccessToken: selectedToken, tamboBaseUrl }),\n    [selectedToken, tamboBaseUrl],\n  );\n\n  return (\n    <TamboMcpTokenContext.Provider value={value}>\n      {children}\n    </TamboMcpTokenContext.Provider>\n  );\n};\n\n/**\n * Hook to access the current MCP access token with optional threadless token fetching.\n *\n * Token selection logic:\n * 1. If current thread has mcpAccessToken → use thread-specific token\n * 2. Else if contextKey provided and no thread (or placeholder thread) → fetch and use threadless token\n * 3. Else → null\n * @param contextKey - Optional context key for fetching threadless tokens when not in a thread\n * @returns The current MCP access token and base URL\n */\nexport const useTamboMcpToken = (\n  contextKey?: string,\n): TamboMcpTokenContextProps => {\n  const context = useContext(TamboMcpTokenContext);\n  if (context === undefined) {\n    throw new Error(\n      \"useTamboMcpToken must be used within a TamboMcpTokenProvider\",\n    );\n  }\n\n  const clientContext = useContext(TamboClientContext);\n  if (!clientContext) {\n    throw new Error(\n      \"useTamboMcpToken must be used within a TamboClientProvider\",\n    );\n  }\n  const { client } = clientContext;\n\n  const threadContext = useContext(TamboThreadContext);\n  const currentThreadId = threadContext?.currentThreadId ?? null;\n\n  // State for threadless token\n  const [threadlessToken, setThreadlessToken] = useState<string | null>(null);\n  const hasAttemptedFetch = useRef(false);\n\n  // Determine if we should fetch a threadless token\n  const isPlaceholderThread = currentThreadId === PLACEHOLDER_THREAD.id;\n  const shouldFetchThreadless =\n    contextKey &&\n    (!currentThreadId || isPlaceholderThread) &&\n    !context.mcpAccessToken &&\n    !threadlessToken &&\n    !hasAttemptedFetch.current;\n\n  // Fetch threadless token when needed\n  useEffect(() => {\n    if (shouldFetchThreadless) {\n      hasAttemptedFetch.current = true;\n      const fetchThreadlessToken = async () => {\n        try {\n          const response = await client.beta.auth.getMcpToken({ contextKey });\n          if (response.mcpAccessToken) {\n            setThreadlessToken(response.mcpAccessToken);\n          }\n        } catch (error) {\n          console.error(\"Failed to fetch threadless MCP token:\", error);\n        }\n      };\n      void fetchThreadlessToken();\n    }\n  }, [shouldFetchThreadless, client, contextKey]);\n\n  // Reset threadless token when switching to a real thread\n  useEffect(() => {\n    if (currentThreadId && currentThreadId !== PLACEHOLDER_THREAD.id) {\n      setThreadlessToken(null);\n      hasAttemptedFetch.current = false;\n    }\n  }, [currentThreadId]);\n\n  // Return thread token if available, otherwise threadless token\n  const selectedToken = context.mcpAccessToken ?? threadlessToken;\n\n  return {\n    mcpAccessToken: selectedToken,\n    tamboBaseUrl: context.tamboBaseUrl,\n  };\n};\n"]}
+{"version":3,"file":"tambo-mcp-token-provider.js","sourceRoot":"","sources":["../../src/providers/tambo-mcp-token-provider.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACb,+CAQe;AACf,mEAA6D;AAc7D,MAAM,oBAAoB,GAAG,IAAA,qBAAa,EAExC,SAAS,CAAC,CAAC;AAEb;;;;;;;;;;GAUG;AACI,MAAM,qBAAqB,GAAgC,CAAC,EACjE,QAAQ,GACT,EAAE,EAAE;IACH,MAAM,aAAa,GAAG,IAAA,kBAAU,EAAC,0CAAkB,CAAC,CAAC;IACrD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC;IACjC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC;IAEpC,MAAM,KAAK,GAAG,IAAA,eAAO,EACnB,GAAG,EAAE,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAC9C,CAAC,YAAY,CAAC,CACf,CAAC;IAEF,OAAO,CACL,8BAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,IACxC,QAAQ,CACqB,CACjC,CAAC;AACJ,CAAC,CAAC;AAtBW,QAAA,qBAAqB,yBAsBhC;AAEF;;;;;;;;GAQG;AACI,MAAM,gBAAgB,GAAG,CAC9B,UAAmB,EACQ,EAAE;IAC7B,MAAM,OAAO,GAAG,IAAA,kBAAU,EAAC,oBAAoB,CAAC,CAAC;IACjD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,kBAAU,EAAC,0CAAkB,CAAC,CAAC;IACrD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC;IAEjC,0BAA0B;IAC1B,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,IAAA,gBAAQ,EAAgB,IAAI,CAAC,CAAC;IACtE,MAAM,iBAAiB,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAC;IAExC,uCAAuC;IACvC,MAAM,WAAW,GAAG,UAAU,IAAI,CAAC,YAAY,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC;IAE9E,0BAA0B;IAC1B,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,WAAW,EAAE,CAAC;YAChB,iBAAiB,CAAC,OAAO,GAAG,IAAI,CAAC;YACjC,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;gBAC5B,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;oBACpE,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;wBAC5B,eAAe,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;oBAC3C,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC,CAAC;YACF,KAAK,UAAU,EAAE,CAAC;QACpB,CAAC;IACH,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAEtC,MAAM,aAAa,GAAG,YAAY,CAAC;IAEnC,OAAO;QACL,cAAc,EAAE,aAAa;QAC7B,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC;AACJ,CAAC,CAAC;AAjDW,QAAA,gBAAgB,oBAiD3B","sourcesContent":["\"use client\";\nimport React, {\n  createContext,\n  type PropsWithChildren,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport { TamboClientContext } from \"./tambo-client-provider\";\n\nexport interface TamboMcpTokenContextProps {\n  /**\n   * The current MCP access token for the internal Tambo MCP server.\n   */\n  mcpAccessToken: string | null;\n  /**\n   * The base URL for the Tambo API (used to construct the MCP server URL)\n   * Returns undefined if the client is not yet initialized\n   */\n  tamboBaseUrl: string | undefined;\n}\n\nconst TamboMcpTokenContext = createContext<\n  TamboMcpTokenContextProps | undefined\n>(undefined);\n\n/**\n * Provider for managing the MCP access token that is returned by the Tambo API.\n * This token is used to authenticate with the internal Tambo MCP server.\n *\n * Exposes the base URL and a null token by default. Token fetching is handled\n * by the useTamboMcpToken hook which supports contextKey-based token retrieval.\n * @internal\n * @param props - The provider props\n * @param props.children - The children to wrap\n * @returns The TamboMcpTokenProvider component\n */\nexport const TamboMcpTokenProvider: React.FC<PropsWithChildren> = ({\n  children,\n}) => {\n  const clientContext = useContext(TamboClientContext);\n  if (!clientContext) {\n    throw new Error(\n      \"TamboMcpTokenProvider must be used within a TamboClientProvider\",\n    );\n  }\n  const { client } = clientContext;\n  const tamboBaseUrl = client.baseURL;\n\n  const value = useMemo(\n    () => ({ mcpAccessToken: null, tamboBaseUrl }),\n    [tamboBaseUrl],\n  );\n\n  return (\n    <TamboMcpTokenContext.Provider value={value}>\n      {children}\n    </TamboMcpTokenContext.Provider>\n  );\n};\n\n/**\n * Hook to access the current MCP access token with optional token fetching.\n *\n * Token fetching logic:\n * - If contextKey is provided → fetches a token using that contextKey\n * - Otherwise → returns null\n * @param contextKey - Optional context key for fetching tokens\n * @returns The current MCP access token and base URL\n */\nexport const useTamboMcpToken = (\n  contextKey?: string,\n): TamboMcpTokenContextProps => {\n  const context = useContext(TamboMcpTokenContext);\n  if (context === undefined) {\n    throw new Error(\n      \"useTamboMcpToken must be used within a TamboMcpTokenProvider\",\n    );\n  }\n\n  const clientContext = useContext(TamboClientContext);\n  if (!clientContext) {\n    throw new Error(\n      \"useTamboMcpToken must be used within a TamboClientProvider\",\n    );\n  }\n  const { client } = clientContext;\n\n  // State for fetched token\n  const [fetchedToken, setFetchedToken] = useState<string | null>(null);\n  const hasAttemptedFetch = useRef(false);\n\n  // Determine if we should fetch a token\n  const shouldFetch = contextKey && !fetchedToken && !hasAttemptedFetch.current;\n\n  // Fetch token when needed\n  useEffect(() => {\n    if (shouldFetch) {\n      hasAttemptedFetch.current = true;\n      const fetchToken = async () => {\n        try {\n          const response = await client.beta.auth.getMcpToken({ contextKey });\n          if (response.mcpAccessToken) {\n            setFetchedToken(response.mcpAccessToken);\n          }\n        } catch (error) {\n          console.error(\"Failed to fetch MCP token:\", error);\n        }\n      };\n      void fetchToken();\n    }\n  }, [shouldFetch, client, contextKey]);\n\n  const selectedToken = fetchedToken;\n\n  return {\n    mcpAccessToken: selectedToken,\n    tamboBaseUrl: context.tamboBaseUrl,\n  };\n};\n"]}

package/dist/testing/tools.d.ts

@@ -1,4 +1,4 @@
-import { TamboComponent, TamboTool } from "../providers";
+import { TamboComponent, TamboTool } from "../model/component-metadata";
 /**
  * Serializes the registry for testing purposes.
  * Converts Standard Schema validators to JSON Schema format.
@@ -8,12 +8,12 @@ import { TamboComponent, TamboTool } from "../providers";
  */
 export declare function serializeRegistry(mockRegistry: TamboComponent[]): {
     props: import("json-schema").JSONSchema7 | undefined;
-    contextTools: import("..").ComponentContextToolMetadata[] | undefined;
+    contextTools: import("../model/component-metadata").ComponentContextToolMetadata[] | undefined;
     name: string;
     description: string;
     propsDefinition?: any;
     loadingComponent?: import("react").ComponentType<any>;
-    annotations?: import("..").ToolAnnotations;
+    annotations?: import("../model/component-metadata").ToolAnnotations;
 }[];
 interface CreateMockToolOptions {
     inputSchema: TamboTool["inputSchema"];

package/dist/testing/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/testing/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,cAAc,EAAE;;;;;;;;IAiB/D;AAED,UAAU,qBAAqB;IAC7B,WAAW,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,eAAe,EAAE,SAAS,CAAC,aAAa,CAAC,GAAG,qBAAqB,GAChE,SAAS,CAoCX"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/testing/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAIxE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,cAAc,EAAE;;;;;;;;IAiB/D;AAED,UAAU,qBAAqB;IAC7B,WAAW,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,eAAe,EAAE,SAAS,CAAC,aAAa,CAAC,GAAG,qBAAqB,GAChE,SAAS,CAoCX"}

package/dist/testing/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/testing/tools.ts"],"names":[],"mappings":";;AAWA,8CAiBC;AAgBD,wCAsCC;AAjFD,sCAAqE;AACrE,+CAA6D;AAE7D;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,YAA8B;IAC9D,OAAO,YAAY,CAAC,GAAG,CACrB,CAAC,EACC,SAAS,EAAE,UAAU,EACrB,WAAW,EACX,eAAe,EACf,GAAG,cAAc,EAClB,EAAE,EAAE,CAAC,CAAC;QACL,GAAG,cAAc;QACjB,KAAK,EAAE,IAAA,yBAAgB,EAAC,WAAW,CAAC;YAClC,CAAC,CAAC,IAAA,+BAAsB,EAAC,WAAW,CAAC;YACrC,CAAC,CAAC,WAAW;QACf,YAAY,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1C,IAAA,oCAAyB,EAAC,IAAI,CAAC,CAChC;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAQD,mDAAmD;AACnD;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,eAAiE;IAEjE,qCAAqC;IACrC,MAAM,sBAAsB,GAAG,CAC7B,GAAY,EACkB,EAAE;QAChC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;YACvB,GAAG,KAAK,IAAI;YACZ,aAAa,IAAI,GAAG;YACpB,GAAG,CAAC,WAAW,IAAI,IAAI,CACxB,CAAC;IACJ,CAAC,CAAC;IAEF,IAAI,sBAAsB,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5C,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,yBAAyB;YACtC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YAC5C,WAAW,EAAE,eAAe,CAAC,WAAW;YACxC,YAAY,EAAE,eAAe,CAAC,YAAY,IAAI;gBAC5C,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;aACf;YACD,GAAG,CAAC,eAAe,CAAC,QAAQ,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,EAAE;gBACxC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,yBAAyB;QACtC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;QAC5C,WAAW,EAAE,eAAe;QAC5B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KACjD,CAAC;AACJ,CAAC","sourcesContent":["import { TamboComponent, TamboTool } from \"../providers\";\nimport { isStandardSchema, safeSchemaToJsonSchema } from \"../schema\";\nimport { mapTamboToolToContextTool } from \"../util/registry\";\n\n/**\n * Serializes the registry for testing purposes.\n * Converts Standard Schema validators to JSON Schema format.\n * Uses the same logic as production code via mapTamboToolToContextTool.\n * @param mockRegistry - The registry to serialize\n * @returns The serialized registry with JSON Schema representations\n */\nexport function serializeRegistry(mockRegistry: TamboComponent[]) {\n  return mockRegistry.map(\n    ({\n      component: _component,\n      propsSchema,\n      associatedTools,\n      ...componentEntry\n    }) => ({\n      ...componentEntry,\n      props: isStandardSchema(propsSchema)\n        ? safeSchemaToJsonSchema(propsSchema)\n        : propsSchema,\n      contextTools: associatedTools?.map((tool) =>\n        mapTamboToolToContextTool(tool),\n      ),\n    }),\n  );\n}\n\ninterface CreateMockToolOptions {\n  inputSchema: TamboTool[\"inputSchema\"];\n  outputSchema?: TamboTool[\"outputSchema\"];\n  maxCalls?: number;\n}\n\n// Helper to create a minimal TamboTool for testing\n/**\n * Creates a mock TamboTool with the given input schema for testing purposes.\n * Accepts either an inputSchema directly or an options object with inputSchema and outputSchema.\n * @param schemaOrOptions - The input schema or options object\n * @returns A mock TamboTool instance\n * @internal\n */\nexport function createMockTool(\n  schemaOrOptions: TamboTool[\"inputSchema\"] | CreateMockToolOptions,\n): TamboTool {\n  // Check if options object was passed\n  const hasInputSchemaProperty = (\n    obj: unknown,\n  ): obj is CreateMockToolOptions => {\n    return (\n      typeof obj === \"object\" &&\n      obj !== null &&\n      \"inputSchema\" in obj &&\n      obj.inputSchema != null\n    );\n  };\n\n  if (hasInputSchemaProperty(schemaOrOptions)) {\n    return {\n      name: \"mockTool\",\n      description: \"A mock tool for testing\",\n      tool: jest.fn().mockImplementation(() => {}),\n      inputSchema: schemaOrOptions.inputSchema,\n      outputSchema: schemaOrOptions.outputSchema ?? {\n        type: \"object\",\n        properties: {},\n      },\n      ...(schemaOrOptions.maxCalls !== undefined\n        ? { maxCalls: schemaOrOptions.maxCalls }\n        : {}),\n    };\n  }\n\n  return {\n    name: \"mockTool\",\n    description: \"A mock tool for testing\",\n    tool: jest.fn().mockImplementation(() => {}),\n    inputSchema: schemaOrOptions,\n    outputSchema: { type: \"object\", properties: {} },\n  };\n}\n"]}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/testing/tools.ts"],"names":[],"mappings":";;AAWA,8CAiBC;AAgBD,wCAsCC;AAjFD,sCAAqE;AACrE,+CAA6D;AAE7D;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,YAA8B;IAC9D,OAAO,YAAY,CAAC,GAAG,CACrB,CAAC,EACC,SAAS,EAAE,UAAU,EACrB,WAAW,EACX,eAAe,EACf,GAAG,cAAc,EAClB,EAAE,EAAE,CAAC,CAAC;QACL,GAAG,cAAc;QACjB,KAAK,EAAE,IAAA,yBAAgB,EAAC,WAAW,CAAC;YAClC,CAAC,CAAC,IAAA,+BAAsB,EAAC,WAAW,CAAC;YACrC,CAAC,CAAC,WAAW;QACf,YAAY,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC1C,IAAA,oCAAyB,EAAC,IAAI,CAAC,CAChC;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAQD,mDAAmD;AACnD;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,eAAiE;IAEjE,qCAAqC;IACrC,MAAM,sBAAsB,GAAG,CAC7B,GAAY,EACkB,EAAE;QAChC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;YACvB,GAAG,KAAK,IAAI;YACZ,aAAa,IAAI,GAAG;YACpB,GAAG,CAAC,WAAW,IAAI,IAAI,CACxB,CAAC;IACJ,CAAC,CAAC;IAEF,IAAI,sBAAsB,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5C,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,yBAAyB;YACtC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;YAC5C,WAAW,EAAE,eAAe,CAAC,WAAW;YACxC,YAAY,EAAE,eAAe,CAAC,YAAY,IAAI;gBAC5C,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;aACf;YACD,GAAG,CAAC,eAAe,CAAC,QAAQ,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,EAAE;gBACxC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,yBAAyB;QACtC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;QAC5C,WAAW,EAAE,eAAe;QAC5B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KACjD,CAAC;AACJ,CAAC","sourcesContent":["import { TamboComponent, TamboTool } from \"../model/component-metadata\";\nimport { isStandardSchema, safeSchemaToJsonSchema } from \"../schema\";\nimport { mapTamboToolToContextTool } from \"../util/registry\";\n\n/**\n * Serializes the registry for testing purposes.\n * Converts Standard Schema validators to JSON Schema format.\n * Uses the same logic as production code via mapTamboToolToContextTool.\n * @param mockRegistry - The registry to serialize\n * @returns The serialized registry with JSON Schema representations\n */\nexport function serializeRegistry(mockRegistry: TamboComponent[]) {\n  return mockRegistry.map(\n    ({\n      component: _component,\n      propsSchema,\n      associatedTools,\n      ...componentEntry\n    }) => ({\n      ...componentEntry,\n      props: isStandardSchema(propsSchema)\n        ? safeSchemaToJsonSchema(propsSchema)\n        : propsSchema,\n      contextTools: associatedTools?.map((tool) =>\n        mapTamboToolToContextTool(tool),\n      ),\n    }),\n  );\n}\n\ninterface CreateMockToolOptions {\n  inputSchema: TamboTool[\"inputSchema\"];\n  outputSchema?: TamboTool[\"outputSchema\"];\n  maxCalls?: number;\n}\n\n// Helper to create a minimal TamboTool for testing\n/**\n * Creates a mock TamboTool with the given input schema for testing purposes.\n * Accepts either an inputSchema directly or an options object with inputSchema and outputSchema.\n * @param schemaOrOptions - The input schema or options object\n * @returns A mock TamboTool instance\n * @internal\n */\nexport function createMockTool(\n  schemaOrOptions: TamboTool[\"inputSchema\"] | CreateMockToolOptions,\n): TamboTool {\n  // Check if options object was passed\n  const hasInputSchemaProperty = (\n    obj: unknown,\n  ): obj is CreateMockToolOptions => {\n    return (\n      typeof obj === \"object\" &&\n      obj !== null &&\n      \"inputSchema\" in obj &&\n      obj.inputSchema != null\n    );\n  };\n\n  if (hasInputSchemaProperty(schemaOrOptions)) {\n    return {\n      name: \"mockTool\",\n      description: \"A mock tool for testing\",\n      tool: jest.fn().mockImplementation(() => {}),\n      inputSchema: schemaOrOptions.inputSchema,\n      outputSchema: schemaOrOptions.outputSchema ?? {\n        type: \"object\",\n        properties: {},\n      },\n      ...(schemaOrOptions.maxCalls !== undefined\n        ? { maxCalls: schemaOrOptions.maxCalls }\n        : {}),\n    };\n  }\n\n  return {\n    name: \"mockTool\",\n    description: \"A mock tool for testing\",\n    tool: jest.fn().mockImplementation(() => {}),\n    inputSchema: schemaOrOptions,\n    outputSchema: { type: \"object\", properties: {} },\n  };\n}\n"]}

package/dist/util/registry-validators.js

@@ -59,7 +59,7 @@ function validateTool(tool) {
     if ("toolSchema" in tool) {
         throw new Error(`Tool "${toolName}" uses deprecated "toolSchema" property. ` +
             `Migrate to "inputSchema" and "outputSchema" properties. ` +
-            `See migration guide: https://docs.tambo.co/reference/react-sdk/migration/toolschema`);
+            `See migration guide: https://docs.tambo.co/reference/react-sdk/migration`);
     }
     // Validate required properties exist
     if (!("name" in tool) || typeof tool.name !== "string") {

package/dist/util/registry-validators.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry-validators.js","sourceRoot":"","sources":["../../src/util/registry-validators.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema7 } from \"json-schema\";\nimport type { TamboComponent, TamboTool } from \"../model/component-metadata\";\nimport {\n  assertNoRecordSchema,\n  isStandardSchema,\n  looksLikeJSONSchema,\n  schemaToJsonSchema,\n} from \"../schema\";\nimport { assertValidName } from \"./validate-component-name\";\n\n/**\n * Checks if a JSON Schema represents an object type.\n * @param schema - The JSON Schema to check\n * @returns True if the schema is an object type\n */\nfunction isObjectSchema(schema: JSONSchema7): boolean {\n  return schema.type === \"object\" || schema.properties !== undefined;\n}\n\n/**\n * Validates that a schema is an object type.\n * Throws an error if it's not.\n * @param schema - The schema to validate (Standard Schema or JSON Schema)\n * @param context - Description of where the schema is used (for error messages)\n */\nfunction assertObjectSchema(schema: unknown, context: string): void {\n  let jsonSchema: JSONSchema7;\n\n  if (isStandardSchema(schema)) {\n    try {\n      jsonSchema = schemaToJsonSchema(schema);\n    } catch {\n      // If conversion fails, we can't validate - let it fail later\n      return;\n    }\n  } else if (looksLikeJSONSchema(schema)) {\n    jsonSchema = schema;\n  } else {\n    // Unknown schema type, can't validate\n    return;\n  }\n\n  if (!isObjectSchema(jsonSchema)) {\n    throw new Error(\n      `${context} must be an object schema (e.g., z.object({...})). ` +\n        `Received type: \"${jsonSchema.type ?? \"unknown\"}\". ` +\n        `Tool parameters are passed as a single object argument.`,\n    );\n  }\n}\n\n/**\n * Validates a tool before registration.\n * Throws an error if the tool is invalid.\n * @param tool - The tool to validate\n */\nexport function validateTool(tool: unknown): asserts tool is TamboTool {\n  // Basic runtime type checks before narrowing\n  if (!tool || typeof tool !== \"object\") {\n    throw new Error(\"Tool must be an object\");\n  }\n\n  // Extract name for error messages (before we know it's valid)\n  const toolName =\n    \"name\" in tool && typeof tool.name === \"string\" ? tool.name : \"<unknown>\";\n\n  // Check for deprecated toolSchema - throw error with migration instructions\n  if (\"toolSchema\" in tool) {\n    throw new Error(\n      `Tool \"${toolName}\" uses deprecated \"toolSchema\" property. ` +\n        `Migrate to \"inputSchema\" and \"outputSchema\" properties. ` +\n        `See migration guide: https://docs.tambo.co/reference/react-sdk/migration/toolschema`,\n    );\n  }\n\n  // Validate required properties exist\n  if (!(\"name\" in tool) || typeof tool.name !== \"string\") {\n    throw new Error(\"Tool must have a 'name' property of type string\");\n  }\n\n  if (!(\"description\" in tool) || typeof tool.description !== \"string\") {\n    throw new Error(\n      `Tool \"${tool.name}\" must have a 'description' property of type string`,\n    );\n  }\n\n  if (!(\"tool\" in tool) || typeof tool.tool !== \"function\") {\n    throw new Error(\n      `Tool \"${tool.name}\" must have a 'tool' property of type function`,\n    );\n  }\n\n  if (!(\"inputSchema\" in tool)) {\n    throw new Error(`Tool \"${tool.name}\" must have an 'inputSchema' property`);\n  }\n\n  if (!(\"outputSchema\" in tool)) {\n    throw new Error(`Tool \"${tool.name}\" must have an 'outputSchema' property`);\n  }\n\n  // Validate tool name format\n  assertValidName(tool.name, \"tool\");\n\n  // Validate tool schemas - inputSchema must be an object schema\n  if (tool.inputSchema) {\n    assertObjectSchema(tool.inputSchema, `inputSchema of tool \"${tool.name}\"`);\n    assertNoRecordSchema(\n      tool.inputSchema,\n      `inputSchema of tool \"${tool.name}\"`,\n    );\n  }\n\n  // Validate maxCalls if provided - must be a positive integer\n  if (\n    \"maxCalls\" in tool &&\n    tool.maxCalls !== undefined &&\n    tool.maxCalls !== null\n  ) {\n    const maxCalls = tool.maxCalls;\n    if (\n      typeof maxCalls !== \"number\" ||\n      !Number.isInteger(maxCalls) ||\n      maxCalls < 0\n    ) {\n      throw new Error(\n        `maxCalls for tool \"${tool.name}\" must be a positive integer`,\n      );\n    }\n  }\n}\n\n/**\n * Converts a props schema to a serialized JSON Schema format.\n * @param propsDefinition - Deprecated: legacy props definition (will log warning)\n * @param propsSchema - The props schema (Standard Schema or JSON Schema)\n * @param name - Component/tool name for error messages\n * @returns Serialized JSON Schema object\n */\nfunction getSerializedProps(\n  propsDefinition: unknown,\n  propsSchema: unknown,\n  name: string,\n): Record<string, unknown> {\n  if (propsDefinition) {\n    console.warn(`propsDefinition is deprecated. Use propsSchema instead.`);\n    return propsDefinition as Record<string, unknown>;\n  }\n\n  // Check for Standard Schema (Zod, Valibot, ArkType, etc.)\n  if (isStandardSchema(propsSchema)) {\n    try {\n      return schemaToJsonSchema(propsSchema) as Record<string, unknown>;\n    } catch (error) {\n      console.error(\n        `Error converting ${name} props schema to JSON Schema:`,\n        error,\n      );\n      throw new Error(\n        `Error converting ${name} props schema to JSON Schema: ${error}`,\n      );\n    }\n  }\n\n  // Check for JSON Schema\n  if (looksLikeJSONSchema(propsSchema)) {\n    return propsSchema as Record<string, unknown>;\n  }\n\n  throw new Error(`Invalid props schema for ${name}`);\n}\n\n/**\n * Validates a component and prepares its props for registration.\n * Throws an error if the component is invalid.\n * @param component - The component to validate and prepare\n * @returns Object containing the serialized props\n */\nexport function validateAndPrepareComponent(component: TamboComponent): {\n  props: Record<string, unknown>;\n} {\n  const { name, propsSchema, propsDefinition } = component;\n\n  // Validate component name\n  assertValidName(name, \"component\");\n\n  // Validate that at least one props definition is provided\n  if (!propsSchema && !propsDefinition) {\n    throw new Error(\n      `Component ${name} must have either propsSchema (recommended) or propsDefinition defined`,\n    );\n  }\n\n  // Validate that only one props definition is provided\n  if (propsSchema && propsDefinition) {\n    throw new Error(\n      `Component ${name} cannot have both propsSchema and propsDefinition defined. Use only one. We recommend using propsSchema.`,\n    );\n  }\n\n  // Validate that the propsSchema does not include record types\n  if (propsSchema) {\n    assertNoRecordSchema(propsSchema, `propsSchema of component \"${name}\"`);\n  }\n\n  // Convert propsSchema to JSON Schema if it exists\n  const props = getSerializedProps(propsDefinition, propsSchema, name);\n\n  return { props };\n}\n\n/**\n * Validates a tool association between a component and tool.\n * Throws an error if the association is invalid.\n * @param componentName - The component name\n * @param toolName - The tool name\n * @param componentExists - Whether the component exists in the registry\n * @param toolExists - Whether the tool exists in the registry\n */\nexport function validateToolAssociation(\n  componentName: string,\n  toolName: string,\n  componentExists: boolean,\n  toolExists: boolean,\n): void {\n  // Validate component and tool names\n  assertValidName(componentName, \"component\");\n  assertValidName(toolName, \"tool\");\n\n  if (!componentExists) {\n    throw new Error(`Component ${componentName} not found in registry`);\n  }\n  if (!toolExists) {\n    throw new Error(`Tool ${toolName} not found in registry`);\n  }\n}\n"]}
+{"version":3,"file":"registry-validators.js","sourceRoot":"","sources":["../../src/util/registry-validators.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema7 } from \"json-schema\";\nimport type { TamboComponent, TamboTool } from \"../model/component-metadata\";\nimport {\n  assertNoRecordSchema,\n  isStandardSchema,\n  looksLikeJSONSchema,\n  schemaToJsonSchema,\n} from \"../schema\";\nimport { assertValidName } from \"./validate-component-name\";\n\n/**\n * Checks if a JSON Schema represents an object type.\n * @param schema - The JSON Schema to check\n * @returns True if the schema is an object type\n */\nfunction isObjectSchema(schema: JSONSchema7): boolean {\n  return schema.type === \"object\" || schema.properties !== undefined;\n}\n\n/**\n * Validates that a schema is an object type.\n * Throws an error if it's not.\n * @param schema - The schema to validate (Standard Schema or JSON Schema)\n * @param context - Description of where the schema is used (for error messages)\n */\nfunction assertObjectSchema(schema: unknown, context: string): void {\n  let jsonSchema: JSONSchema7;\n\n  if (isStandardSchema(schema)) {\n    try {\n      jsonSchema = schemaToJsonSchema(schema);\n    } catch {\n      // If conversion fails, we can't validate - let it fail later\n      return;\n    }\n  } else if (looksLikeJSONSchema(schema)) {\n    jsonSchema = schema;\n  } else {\n    // Unknown schema type, can't validate\n    return;\n  }\n\n  if (!isObjectSchema(jsonSchema)) {\n    throw new Error(\n      `${context} must be an object schema (e.g., z.object({...})). ` +\n        `Received type: \"${jsonSchema.type ?? \"unknown\"}\". ` +\n        `Tool parameters are passed as a single object argument.`,\n    );\n  }\n}\n\n/**\n * Validates a tool before registration.\n * Throws an error if the tool is invalid.\n * @param tool - The tool to validate\n */\nexport function validateTool(tool: unknown): asserts tool is TamboTool {\n  // Basic runtime type checks before narrowing\n  if (!tool || typeof tool !== \"object\") {\n    throw new Error(\"Tool must be an object\");\n  }\n\n  // Extract name for error messages (before we know it's valid)\n  const toolName =\n    \"name\" in tool && typeof tool.name === \"string\" ? tool.name : \"<unknown>\";\n\n  // Check for deprecated toolSchema - throw error with migration instructions\n  if (\"toolSchema\" in tool) {\n    throw new Error(\n      `Tool \"${toolName}\" uses deprecated \"toolSchema\" property. ` +\n        `Migrate to \"inputSchema\" and \"outputSchema\" properties. ` +\n        `See migration guide: https://docs.tambo.co/reference/react-sdk/migration`,\n    );\n  }\n\n  // Validate required properties exist\n  if (!(\"name\" in tool) || typeof tool.name !== \"string\") {\n    throw new Error(\"Tool must have a 'name' property of type string\");\n  }\n\n  if (!(\"description\" in tool) || typeof tool.description !== \"string\") {\n    throw new Error(\n      `Tool \"${tool.name}\" must have a 'description' property of type string`,\n    );\n  }\n\n  if (!(\"tool\" in tool) || typeof tool.tool !== \"function\") {\n    throw new Error(\n      `Tool \"${tool.name}\" must have a 'tool' property of type function`,\n    );\n  }\n\n  if (!(\"inputSchema\" in tool)) {\n    throw new Error(`Tool \"${tool.name}\" must have an 'inputSchema' property`);\n  }\n\n  if (!(\"outputSchema\" in tool)) {\n    throw new Error(`Tool \"${tool.name}\" must have an 'outputSchema' property`);\n  }\n\n  // Validate tool name format\n  assertValidName(tool.name, \"tool\");\n\n  // Validate tool schemas - inputSchema must be an object schema\n  if (tool.inputSchema) {\n    assertObjectSchema(tool.inputSchema, `inputSchema of tool \"${tool.name}\"`);\n    assertNoRecordSchema(\n      tool.inputSchema,\n      `inputSchema of tool \"${tool.name}\"`,\n    );\n  }\n\n  // Validate maxCalls if provided - must be a positive integer\n  if (\n    \"maxCalls\" in tool &&\n    tool.maxCalls !== undefined &&\n    tool.maxCalls !== null\n  ) {\n    const maxCalls = tool.maxCalls;\n    if (\n      typeof maxCalls !== \"number\" ||\n      !Number.isInteger(maxCalls) ||\n      maxCalls < 0\n    ) {\n      throw new Error(\n        `maxCalls for tool \"${tool.name}\" must be a positive integer`,\n      );\n    }\n  }\n}\n\n/**\n * Converts a props schema to a serialized JSON Schema format.\n * @param propsDefinition - Deprecated: legacy props definition (will log warning)\n * @param propsSchema - The props schema (Standard Schema or JSON Schema)\n * @param name - Component/tool name for error messages\n * @returns Serialized JSON Schema object\n */\nfunction getSerializedProps(\n  propsDefinition: unknown,\n  propsSchema: unknown,\n  name: string,\n): Record<string, unknown> {\n  if (propsDefinition) {\n    console.warn(`propsDefinition is deprecated. Use propsSchema instead.`);\n    return propsDefinition as Record<string, unknown>;\n  }\n\n  // Check for Standard Schema (Zod, Valibot, ArkType, etc.)\n  if (isStandardSchema(propsSchema)) {\n    try {\n      return schemaToJsonSchema(propsSchema) as Record<string, unknown>;\n    } catch (error) {\n      console.error(\n        `Error converting ${name} props schema to JSON Schema:`,\n        error,\n      );\n      throw new Error(\n        `Error converting ${name} props schema to JSON Schema: ${error}`,\n      );\n    }\n  }\n\n  // Check for JSON Schema\n  if (looksLikeJSONSchema(propsSchema)) {\n    return propsSchema as Record<string, unknown>;\n  }\n\n  throw new Error(`Invalid props schema for ${name}`);\n}\n\n/**\n * Validates a component and prepares its props for registration.\n * Throws an error if the component is invalid.\n * @param component - The component to validate and prepare\n * @returns Object containing the serialized props\n */\nexport function validateAndPrepareComponent(component: TamboComponent): {\n  props: Record<string, unknown>;\n} {\n  const { name, propsSchema, propsDefinition } = component;\n\n  // Validate component name\n  assertValidName(name, \"component\");\n\n  // Validate that at least one props definition is provided\n  if (!propsSchema && !propsDefinition) {\n    throw new Error(\n      `Component ${name} must have either propsSchema (recommended) or propsDefinition defined`,\n    );\n  }\n\n  // Validate that only one props definition is provided\n  if (propsSchema && propsDefinition) {\n    throw new Error(\n      `Component ${name} cannot have both propsSchema and propsDefinition defined. Use only one. We recommend using propsSchema.`,\n    );\n  }\n\n  // Validate that the propsSchema does not include record types\n  if (propsSchema) {\n    assertNoRecordSchema(propsSchema, `propsSchema of component \"${name}\"`);\n  }\n\n  // Convert propsSchema to JSON Schema if it exists\n  const props = getSerializedProps(propsDefinition, propsSchema, name);\n\n  return { props };\n}\n\n/**\n * Validates a tool association between a component and tool.\n * Throws an error if the association is invalid.\n * @param componentName - The component name\n * @param toolName - The tool name\n * @param componentExists - Whether the component exists in the registry\n * @param toolExists - Whether the tool exists in the registry\n */\nexport function validateToolAssociation(\n  componentName: string,\n  toolName: string,\n  componentExists: boolean,\n  toolExists: boolean,\n): void {\n  // Validate component and tool names\n  assertValidName(componentName, \"component\");\n  assertValidName(toolName, \"tool\");\n\n  if (!componentExists) {\n    throw new Error(`Component ${componentName} not found in registry`);\n  }\n  if (!toolExists) {\n    throw new Error(`Tool ${toolName} not found in registry`);\n  }\n}\n"]}

package/dist/v1/__tests__/v1-interactables.test.js

@@ -40,7 +40,7 @@ function createMockRegistry() {
     };
 }
 /**
- * Wrapper that provides the minimal V1-compatible provider tree for interactables:
+ * Wrapper that provides the minimal provider tree for interactables:
  * TamboRegistryContext > TamboContextHelpersProvider > TamboInteractableProvider
  */
 function V1InteractableWrapper({ children, registry, }) {

package/dist/v1/__tests__/v1-interactables.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"v1-interactables.test.js","sourceRoot":"","sources":["../../../src/v1/__tests__/v1-interactables.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { act, render, renderHook, screen } from \"@testing-library/react\";\nimport React from \"react\";\nimport { z } from \"zod/v3\";\nimport { withTamboInteractable } from \"../../hoc/with-tambo-interactable\";\nimport { useTamboInteractable } from \"../../providers/tambo-interactable-provider\";\nimport { useTamboContextHelpers } from \"../../providers/tambo-context-helpers-provider\";\nimport {\n  TamboRegistryContext,\n  type TamboRegistryContext as TamboRegistryContextType,\n} from \"../../providers/tambo-registry-provider\";\nimport { TamboContextHelpersProvider } from \"../../providers/tambo-context-helpers-provider\";\nimport { TamboInteractableProvider } from \"../../providers/tambo-interactable-provider\";\n\n// Minimal registry mock that captures registered tools\nfunction createMockRegistry() {\n  const toolRegistry: Record<string, unknown> = {};\n  return {\n    value: {\n      componentList: {},\n      toolRegistry,\n      componentToolAssociations: {},\n      mcpServerInfos: [],\n      resources: [],\n      resourceSource: null,\n      onCallUnregisteredTool: undefined,\n      registerComponent: jest.fn(),\n      registerTool: jest.fn((tool: { name: string }) => {\n        toolRegistry[tool.name] = tool;\n      }),\n      registerTools: jest.fn(),\n      addToolAssociation: jest.fn(),\n      registerMcpServer: jest.fn(),\n      registerMcpServers: jest.fn(),\n      registerResource: jest.fn(),\n      registerResources: jest.fn(),\n      registerResourceSource: jest.fn(),\n    } as unknown as TamboRegistryContextType,\n    getRegisteredToolNames: () => Object.keys(toolRegistry),\n  };\n}\n\n/**\n * Wrapper that provides the minimal V1-compatible provider tree for interactables:\n * TamboRegistryContext > TamboContextHelpersProvider > TamboInteractableProvider\n */\nfunction V1InteractableWrapper({\n  children,\n  registry,\n}: {\n  children: React.ReactNode;\n  registry: TamboRegistryContextType;\n}) {\n  return (\n    <TamboRegistryContext.Provider value={registry}>\n      <TamboContextHelpersProvider>\n        <TamboInteractableProvider>{children}</TamboInteractableProvider>\n      </TamboContextHelpersProvider>\n    </TamboRegistryContext.Provider>\n  );\n}\n\ndescribe(\"V1 Interactables Integration\", () => {\n  it(\"registers update_component_props and update_component_state tools when an interactable is added\", () => {\n    const mockRegistry = createMockRegistry();\n\n    const { result } = renderHook(() => useTamboInteractable(), {\n      wrapper: ({ children }) => (\n        <V1InteractableWrapper registry={mockRegistry.value}>\n          {children}\n        </V1InteractableWrapper>\n      ),\n    });\n\n    act(() => {\n      result.current.addInteractableComponent({\n        name: \"TestWidget\",\n        description: \"A test widget\",\n        component: () => <div>widget</div>,\n        props: { label: \"hello\" },\n        propsSchema: z.object({ label: z.string() }),\n      });\n    });\n\n    const toolNames = mockRegistry.getRegisteredToolNames();\n    expect(\n      toolNames.some((n) => n.startsWith(\"update_component_props_TestWidget\")),\n    ).toBe(true);\n    expect(\n      toolNames.some((n) => n.startsWith(\"update_component_state_TestWidget\")),\n    ).toBe(true);\n  });\n\n  it(\"registers interactables context helper that includes component info\", async () => {\n    const mockRegistry = createMockRegistry();\n\n    const { result } = renderHook(\n      () => ({\n        interactable: useTamboInteractable(),\n        helpers: useTamboContextHelpers(),\n      }),\n      {\n        wrapper: ({ children }) => (\n          <V1InteractableWrapper registry={mockRegistry.value}>\n            {children}\n          </V1InteractableWrapper>\n        ),\n      },\n    );\n\n    // Add an interactable component\n    act(() => {\n      result.current.interactable.addInteractableComponent({\n        name: \"InfoCard\",\n        description: \"An info card\",\n        component: () => <div>card</div>,\n        props: { title: \"Test\" },\n      });\n    });\n\n    // Get additional context - should include interactable info\n    const contexts = await act(async () => {\n      return await result.current.helpers.getAdditionalContext();\n    });\n\n    const interactablesContext = contexts.find(\n      (c) => c.name === \"interactables\",\n    );\n    expect(interactablesContext).toBeDefined();\n    expect(interactablesContext?.context).toBeDefined();\n  });\n\n  it(\"renders an interactable component via withTamboInteractable HOC\", () => {\n    const mockRegistry = createMockRegistry();\n\n    interface CardProps {\n      title: string;\n    }\n\n    const Card: React.FC<CardProps> = ({ title }) => (\n      <div data-testid=\"card-title\">{title}</div>\n    );\n\n    const InteractableCard = withTamboInteractable(Card, {\n      componentName: \"Card\",\n      description: \"A card component\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    render(\n      <V1InteractableWrapper registry={mockRegistry.value}>\n        <InteractableCard title=\"Hello V1\" />\n      </V1InteractableWrapper>,\n    );\n\n    expect(screen.getByTestId(\"card-title\")).toHaveTextContent(\"Hello V1\");\n  });\n\n  it(\"updates component props via the interactable provider\", () => {\n    const mockRegistry = createMockRegistry();\n\n    interface CounterProps {\n      count: number;\n    }\n\n    const Counter: React.FC<CounterProps> = ({ count }) => (\n      <div data-testid=\"count\">{count}</div>\n    );\n\n    const InteractableCounter = withTamboInteractable(Counter, {\n      componentName: \"Counter\",\n      description: \"A counter\",\n      propsSchema: z.object({ count: z.number() }),\n    });\n\n    // Inner component that triggers prop updates\n    function TestHarness() {\n      const { interactableComponents, updateInteractableComponentProps } =\n        useTamboInteractable();\n      const component = interactableComponents[0];\n\n      return (\n        <div>\n          <InteractableCounter count={0} />\n          {component && (\n            <button\n              data-testid=\"update-btn\"\n              onClick={() =>\n                updateInteractableComponentProps(component.id, { count: 42 })\n              }\n            >\n              Update\n            </button>\n          )}\n        </div>\n      );\n    }\n\n    render(\n      <V1InteractableWrapper registry={mockRegistry.value}>\n        <TestHarness />\n      </V1InteractableWrapper>,\n    );\n\n    // Initial render\n    expect(screen.getByTestId(\"count\")).toHaveTextContent(\"0\");\n\n    // Update props via the interactable provider\n    act(() => {\n      screen.getByTestId(\"update-btn\").click();\n    });\n\n    // The interactable should reflect updated props\n    expect(screen.getByTestId(\"count\")).toHaveTextContent(\"42\");\n  });\n});\n"]}
+{"version":3,"file":"v1-interactables.test.js","sourceRoot":"","sources":["../../../src/v1/__tests__/v1-interactables.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import { act, render, renderHook, screen } from \"@testing-library/react\";\nimport React from \"react\";\nimport { z } from \"zod/v3\";\nimport { withTamboInteractable } from \"../../hoc/with-tambo-interactable\";\nimport { useTamboInteractable } from \"../../providers/tambo-interactable-provider\";\nimport { useTamboContextHelpers } from \"../../providers/tambo-context-helpers-provider\";\nimport {\n  TamboRegistryContext,\n  type TamboRegistryContext as TamboRegistryContextType,\n} from \"../../providers/tambo-registry-provider\";\nimport { TamboContextHelpersProvider } from \"../../providers/tambo-context-helpers-provider\";\nimport { TamboInteractableProvider } from \"../../providers/tambo-interactable-provider\";\n\n// Minimal registry mock that captures registered tools\nfunction createMockRegistry() {\n  const toolRegistry: Record<string, unknown> = {};\n  return {\n    value: {\n      componentList: {},\n      toolRegistry,\n      componentToolAssociations: {},\n      mcpServerInfos: [],\n      resources: [],\n      resourceSource: null,\n      onCallUnregisteredTool: undefined,\n      registerComponent: jest.fn(),\n      registerTool: jest.fn((tool: { name: string }) => {\n        toolRegistry[tool.name] = tool;\n      }),\n      registerTools: jest.fn(),\n      addToolAssociation: jest.fn(),\n      registerMcpServer: jest.fn(),\n      registerMcpServers: jest.fn(),\n      registerResource: jest.fn(),\n      registerResources: jest.fn(),\n      registerResourceSource: jest.fn(),\n    } as unknown as TamboRegistryContextType,\n    getRegisteredToolNames: () => Object.keys(toolRegistry),\n  };\n}\n\n/**\n * Wrapper that provides the minimal provider tree for interactables:\n * TamboRegistryContext > TamboContextHelpersProvider > TamboInteractableProvider\n */\nfunction V1InteractableWrapper({\n  children,\n  registry,\n}: {\n  children: React.ReactNode;\n  registry: TamboRegistryContextType;\n}) {\n  return (\n    <TamboRegistryContext.Provider value={registry}>\n      <TamboContextHelpersProvider>\n        <TamboInteractableProvider>{children}</TamboInteractableProvider>\n      </TamboContextHelpersProvider>\n    </TamboRegistryContext.Provider>\n  );\n}\n\ndescribe(\"V1 Interactables Integration\", () => {\n  it(\"registers update_component_props and update_component_state tools when an interactable is added\", () => {\n    const mockRegistry = createMockRegistry();\n\n    const { result } = renderHook(() => useTamboInteractable(), {\n      wrapper: ({ children }) => (\n        <V1InteractableWrapper registry={mockRegistry.value}>\n          {children}\n        </V1InteractableWrapper>\n      ),\n    });\n\n    act(() => {\n      result.current.addInteractableComponent({\n        name: \"TestWidget\",\n        description: \"A test widget\",\n        component: () => <div>widget</div>,\n        props: { label: \"hello\" },\n        propsSchema: z.object({ label: z.string() }),\n      });\n    });\n\n    const toolNames = mockRegistry.getRegisteredToolNames();\n    expect(\n      toolNames.some((n) => n.startsWith(\"update_component_props_TestWidget\")),\n    ).toBe(true);\n    expect(\n      toolNames.some((n) => n.startsWith(\"update_component_state_TestWidget\")),\n    ).toBe(true);\n  });\n\n  it(\"registers interactables context helper that includes component info\", async () => {\n    const mockRegistry = createMockRegistry();\n\n    const { result } = renderHook(\n      () => ({\n        interactable: useTamboInteractable(),\n        helpers: useTamboContextHelpers(),\n      }),\n      {\n        wrapper: ({ children }) => (\n          <V1InteractableWrapper registry={mockRegistry.value}>\n            {children}\n          </V1InteractableWrapper>\n        ),\n      },\n    );\n\n    // Add an interactable component\n    act(() => {\n      result.current.interactable.addInteractableComponent({\n        name: \"InfoCard\",\n        description: \"An info card\",\n        component: () => <div>card</div>,\n        props: { title: \"Test\" },\n      });\n    });\n\n    // Get additional context - should include interactable info\n    const contexts = await act(async () => {\n      return await result.current.helpers.getAdditionalContext();\n    });\n\n    const interactablesContext = contexts.find(\n      (c) => c.name === \"interactables\",\n    );\n    expect(interactablesContext).toBeDefined();\n    expect(interactablesContext?.context).toBeDefined();\n  });\n\n  it(\"renders an interactable component via withTamboInteractable HOC\", () => {\n    const mockRegistry = createMockRegistry();\n\n    interface CardProps {\n      title: string;\n    }\n\n    const Card: React.FC<CardProps> = ({ title }) => (\n      <div data-testid=\"card-title\">{title}</div>\n    );\n\n    const InteractableCard = withTamboInteractable(Card, {\n      componentName: \"Card\",\n      description: \"A card component\",\n      propsSchema: z.object({ title: z.string() }),\n    });\n\n    render(\n      <V1InteractableWrapper registry={mockRegistry.value}>\n        <InteractableCard title=\"Hello V1\" />\n      </V1InteractableWrapper>,\n    );\n\n    expect(screen.getByTestId(\"card-title\")).toHaveTextContent(\"Hello V1\");\n  });\n\n  it(\"updates component props via the interactable provider\", () => {\n    const mockRegistry = createMockRegistry();\n\n    interface CounterProps {\n      count: number;\n    }\n\n    const Counter: React.FC<CounterProps> = ({ count }) => (\n      <div data-testid=\"count\">{count}</div>\n    );\n\n    const InteractableCounter = withTamboInteractable(Counter, {\n      componentName: \"Counter\",\n      description: \"A counter\",\n      propsSchema: z.object({ count: z.number() }),\n    });\n\n    // Inner component that triggers prop updates\n    function TestHarness() {\n      const { interactableComponents, updateInteractableComponentProps } =\n        useTamboInteractable();\n      const component = interactableComponents[0];\n\n      return (\n        <div>\n          <InteractableCounter count={0} />\n          {component && (\n            <button\n              data-testid=\"update-btn\"\n              onClick={() =>\n                updateInteractableComponentProps(component.id, { count: 42 })\n              }\n            >\n              Update\n            </button>\n          )}\n        </div>\n      );\n    }\n\n    render(\n      <V1InteractableWrapper registry={mockRegistry.value}>\n        <TestHarness />\n      </V1InteractableWrapper>,\n    );\n\n    // Initial render\n    expect(screen.getByTestId(\"count\")).toHaveTextContent(\"0\");\n\n    // Update props via the interactable provider\n    act(() => {\n      screen.getByTestId(\"update-btn\").click();\n    });\n\n    // The interactable should reflect updated props\n    expect(screen.getByTestId(\"count\")).toHaveTextContent(\"42\");\n  });\n});\n"]}

package/dist/v1/components/v1-component-renderer.d.ts

@@ -1,10 +1,10 @@
 import React, { type FC } from "react";
-import type { V1ComponentContent } from "../types/message";
-export interface V1ComponentRendererProps {
+import type { TamboComponentContent } from "../types/message";
+export interface ComponentRendererProps {
     /**
-     * The component content block from a v1 message
+     * The component content block from a message
      */
-    content: V1ComponentContent;
+    content: TamboComponentContent;
     /**
      * The thread ID the component belongs to
      */
@@ -25,15 +25,15 @@ export interface V1ComponentRendererProps {
  * The component instance is preserved across re-renders as long as React's
  * reconciliation keeps this wrapper mounted (use content.id as key).
  *
- * Wraps the rendered component with V1ComponentContentProvider so that hooks
- * like useTamboV1ComponentState can access component context.
- * @returns The rendered component wrapped in V1ComponentContentProvider, or fallback if not found
+ * Wraps the rendered component with ComponentContentProvider so that hooks
+ * like useTamboComponentState can access component context.
+ * @returns The rendered component wrapped in ComponentContentProvider, or fallback if not found
  * @example
  * ```tsx
  * function MessageContent({ content }: { content: Content }) {
  *   if (content.type === 'component') {
  *     return (
- *       <V1ComponentRenderer
+ *       <ComponentRenderer
  *         key={content.id}
  *         content={content}
  *         fallback={<div>Unknown component: {content.name}</div>}
@@ -44,5 +44,5 @@ export interface V1ComponentRendererProps {
  * }
  * ```
  */
-export declare const V1ComponentRenderer: FC<V1ComponentRendererProps>;
+export declare const ComponentRenderer: FC<ComponentRendererProps>;
 //# sourceMappingURL=v1-component-renderer.d.ts.map

package/dist/v1/components/v1-component-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v1-component-renderer.d.ts","sourceRoot":"","sources":["../../../src/v1/components/v1-component-renderer.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAAuB,MAAM,OAAO,CAAC;AAK5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3D,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,OAAO,EAAE,kBAAkB,CAAC;IAE5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,mBAAmB,EAAE,EAAE,CAAC,wBAAwB,CAoF5D,CAAC"}
+{"version":3,"file":"v1-component-renderer.d.ts","sourceRoot":"","sources":["../../../src/v1/components/v1-component-renderer.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAAuB,MAAM,OAAO,CAAC;AAK5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG9D,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,OAAO,EAAE,qBAAqB,CAAC;IAE/B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CAoFxD,CAAC"}

package/dist/v1/components/v1-component-renderer.js

@@ -34,17 +34,17 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.V1ComponentRenderer = void 0;
+exports.ComponentRenderer = void 0;
 /**
- * V1 Component Renderer
+ * Component Renderer
  *
  * A wrapper component that renders a component from the registry based on
  * component content block data. Uses React's normal reconciliation to maintain
  * component identity - as long as the key stays stable, the component instance
  * is preserved.
  *
- * Wraps the component with V1ComponentContentProvider so that hooks like
- * useTamboV1ComponentState can access component context.
+ * Wraps the component with ComponentContentProvider so that hooks like
+ * useTamboComponentState can access component context.
  */
 const partial_json_1 = require("partial-json");
 const react_1 = __importStar(require("react"));
@@ -60,15 +60,15 @@ const component_renderer_1 = require("../utils/component-renderer");
  * The component instance is preserved across re-renders as long as React's
  * reconciliation keeps this wrapper mounted (use content.id as key).
  *
- * Wraps the rendered component with V1ComponentContentProvider so that hooks
- * like useTamboV1ComponentState can access component context.
- * @returns The rendered component wrapped in V1ComponentContentProvider, or fallback if not found
+ * Wraps the rendered component with ComponentContentProvider so that hooks
+ * like useTamboComponentState can access component context.
+ * @returns The rendered component wrapped in ComponentContentProvider, or fallback if not found
  * @example
  * ```tsx
  * function MessageContent({ content }: { content: Content }) {
  *   if (content.type === 'component') {
  *     return (
- *       <V1ComponentRenderer
+ *       <ComponentRenderer
  *         key={content.id}
  *         content={content}
  *         fallback={<div>Unknown component: {content.name}</div>}
@@ -79,7 +79,7 @@ const component_renderer_1 = require("../utils/component-renderer");
  * }
  * ```
  */
-const V1ComponentRenderer = ({ content, threadId, messageId, fallback = null, }) => {
+const ComponentRenderer = ({ content, threadId, messageId, fallback = null, }) => {
     const registry = (0, react_1.useContext)(tambo_registry_provider_1.TamboRegistryContext);
     // Memoize the rendered element - only recreates when props change
     const element = (0, react_1.useMemo)(() => {
@@ -107,7 +107,7 @@ const V1ComponentRenderer = ({ content, threadId, messageId, fallback = null, })
             return react_1.default.createElement(registeredComponent.component, validatedProps);
         }
         catch (error) {
-            console.error("[V1ComponentRenderer] Failed to render component", {
+            console.error("[ComponentRenderer] Failed to render component", {
                 threadId,
                 messageId,
                 componentId: content.id,
@@ -130,8 +130,8 @@ const V1ComponentRenderer = ({ content, threadId, messageId, fallback = null, })
     if (element === null) {
         return react_1.default.createElement(react_1.default.Fragment, null, fallback);
     }
-    // Wrap with provider so hooks like useTamboV1ComponentState work
-    return (react_1.default.createElement(component_renderer_1.V1ComponentContentProvider, { componentId: content.id, threadId: threadId, messageId: messageId, componentName: content.name }, element));
+    // Wrap with provider so hooks like useTamboComponentState work
+    return (react_1.default.createElement(component_renderer_1.ComponentContentProvider, { componentId: content.id, threadId: threadId, messageId: messageId, componentName: content.name }, element));
 };
-exports.V1ComponentRenderer = V1ComponentRenderer;
+exports.ComponentRenderer = ComponentRenderer;
 //# sourceMappingURL=v1-component-renderer.js.map

package/dist/v1/components/v1-component-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"v1-component-renderer.js","sourceRoot":"","sources":["../../../src/v1/components/v1-component-renderer.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * V1 Component Renderer\n *\n * A wrapper component that renders a component from the registry based on\n * component content block data. Uses React's normal reconciliation to maintain\n * component identity - as long as the key stays stable, the component instance\n * is preserved.\n *\n * Wraps the component with V1ComponentContentProvider so that hooks like\n * useTamboV1ComponentState can access component context.\n */\n\nimport { parse } from \"partial-json\";\nimport React, { type FC, useMemo, useContext } from \"react\";\nimport { TamboRegistryContext } from \"../../providers/tambo-registry-provider\";\nimport { isStandardSchema } from \"../../schema\";\nimport { isPromise } from \"../../util/is-promise\";\nimport { getComponentFromRegistry } from \"../../util/registry\";\nimport type { V1ComponentContent } from \"../types/message\";\nimport { V1ComponentContentProvider } from \"../utils/component-renderer\";\n\nexport interface V1ComponentRendererProps {\n  /**\n   * The component content block from a v1 message\n   */\n  content: V1ComponentContent;\n\n  /**\n   * The thread ID the component belongs to\n   */\n  threadId: string;\n\n  /**\n   * The message ID the component belongs to\n   */\n  messageId: string;\n\n  /**\n   * Optional fallback to render if component is not found in registry\n   */\n  fallback?: React.ReactNode;\n}\n\n/**\n * Renders a component from the registry based on component content block data.\n *\n * Use this component in your message renderer to display AI-generated components.\n * The component instance is preserved across re-renders as long as React's\n * reconciliation keeps this wrapper mounted (use content.id as key).\n *\n * Wraps the rendered component with V1ComponentContentProvider so that hooks\n * like useTamboV1ComponentState can access component context.\n * @returns The rendered component wrapped in V1ComponentContentProvider, or fallback if not found\n * @example\n * ```tsx\n * function MessageContent({ content }: { content: Content }) {\n *   if (content.type === 'component') {\n *     return (\n *       <V1ComponentRenderer\n *         key={content.id}\n *         content={content}\n *         fallback={<div>Unknown component: {content.name}</div>}\n *       />\n *     );\n *   }\n *   // ... handle other content types\n * }\n * ```\n */\nexport const V1ComponentRenderer: FC<V1ComponentRendererProps> = ({\n  content,\n  threadId,\n  messageId,\n  fallback = null,\n}) => {\n  const registry = useContext(TamboRegistryContext);\n\n  // Memoize the rendered element - only recreates when props change\n  const element = useMemo(() => {\n    try {\n      const registeredComponent = getComponentFromRegistry(\n        content.name,\n        registry.componentList,\n      );\n\n      // Parse props (handles partial JSON during streaming)\n      const propsJson = JSON.stringify(content.props ?? {});\n      const parsedProps = parse(propsJson);\n\n      let validatedProps: Record<string, unknown> = parsedProps as Record<\n        string,\n        unknown\n      >;\n\n      // Validate props if schema is present\n      if (isStandardSchema(registeredComponent.props)) {\n        const result =\n          registeredComponent.props[\"~standard\"].validate(parsedProps);\n\n        if (isPromise(result)) {\n          // Async validation not supported - skip validation\n          console.warn(\n            `Async schema validation not supported for component ${content.name}`,\n          );\n        } else if (\"value\" in result) {\n          validatedProps = result.value as Record<string, unknown>;\n        } else {\n          // Validation failed - log warning but still render with raw props\n          console.warn(\n            `Props validation failed for component ${content.name}:`,\n            result.issues?.[0]?.message,\n          );\n        }\n      }\n\n      return React.createElement(registeredComponent.component, validatedProps);\n    } catch (error) {\n      console.error(\"[V1ComponentRenderer] Failed to render component\", {\n        threadId,\n        messageId,\n        componentId: content.id,\n        componentName: content.name,\n        streamingState: content.streamingState,\n        props: content.props,\n        error,\n      });\n      return null;\n    }\n  }, [\n    content.id,\n    content.name,\n    content.props,\n    content.streamingState,\n    messageId,\n    threadId,\n    registry.componentList,\n  ]);\n\n  if (element === null) {\n    return <>{fallback}</>;\n  }\n\n  // Wrap with provider so hooks like useTamboV1ComponentState work\n  return (\n    <V1ComponentContentProvider\n      componentId={content.id}\n      threadId={threadId}\n      messageId={messageId}\n      componentName={content.name}\n    >\n      {element}\n    </V1ComponentContentProvider>\n  );\n};\n"]}
+{"version":3,"file":"v1-component-renderer.js","sourceRoot":"","sources":["../../../src/v1/components/v1-component-renderer.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * Component Renderer\n *\n * A wrapper component that renders a component from the registry based on\n * component content block data. Uses React's normal reconciliation to maintain\n * component identity - as long as the key stays stable, the component instance\n * is preserved.\n *\n * Wraps the component with ComponentContentProvider so that hooks like\n * useTamboComponentState can access component context.\n */\n\nimport { parse } from \"partial-json\";\nimport React, { type FC, useMemo, useContext } from \"react\";\nimport { TamboRegistryContext } from \"../../providers/tambo-registry-provider\";\nimport { isStandardSchema } from \"../../schema\";\nimport { isPromise } from \"../../util/is-promise\";\nimport { getComponentFromRegistry } from \"../../util/registry\";\nimport type { TamboComponentContent } from \"../types/message\";\nimport { ComponentContentProvider } from \"../utils/component-renderer\";\n\nexport interface ComponentRendererProps {\n  /**\n   * The component content block from a message\n   */\n  content: TamboComponentContent;\n\n  /**\n   * The thread ID the component belongs to\n   */\n  threadId: string;\n\n  /**\n   * The message ID the component belongs to\n   */\n  messageId: string;\n\n  /**\n   * Optional fallback to render if component is not found in registry\n   */\n  fallback?: React.ReactNode;\n}\n\n/**\n * Renders a component from the registry based on component content block data.\n *\n * Use this component in your message renderer to display AI-generated components.\n * The component instance is preserved across re-renders as long as React's\n * reconciliation keeps this wrapper mounted (use content.id as key).\n *\n * Wraps the rendered component with ComponentContentProvider so that hooks\n * like useTamboComponentState can access component context.\n * @returns The rendered component wrapped in ComponentContentProvider, or fallback if not found\n * @example\n * ```tsx\n * function MessageContent({ content }: { content: Content }) {\n *   if (content.type === 'component') {\n *     return (\n *       <ComponentRenderer\n *         key={content.id}\n *         content={content}\n *         fallback={<div>Unknown component: {content.name}</div>}\n *       />\n *     );\n *   }\n *   // ... handle other content types\n * }\n * ```\n */\nexport const ComponentRenderer: FC<ComponentRendererProps> = ({\n  content,\n  threadId,\n  messageId,\n  fallback = null,\n}) => {\n  const registry = useContext(TamboRegistryContext);\n\n  // Memoize the rendered element - only recreates when props change\n  const element = useMemo(() => {\n    try {\n      const registeredComponent = getComponentFromRegistry(\n        content.name,\n        registry.componentList,\n      );\n\n      // Parse props (handles partial JSON during streaming)\n      const propsJson = JSON.stringify(content.props ?? {});\n      const parsedProps = parse(propsJson);\n\n      let validatedProps: Record<string, unknown> = parsedProps as Record<\n        string,\n        unknown\n      >;\n\n      // Validate props if schema is present\n      if (isStandardSchema(registeredComponent.props)) {\n        const result =\n          registeredComponent.props[\"~standard\"].validate(parsedProps);\n\n        if (isPromise(result)) {\n          // Async validation not supported - skip validation\n          console.warn(\n            `Async schema validation not supported for component ${content.name}`,\n          );\n        } else if (\"value\" in result) {\n          validatedProps = result.value as Record<string, unknown>;\n        } else {\n          // Validation failed - log warning but still render with raw props\n          console.warn(\n            `Props validation failed for component ${content.name}:`,\n            result.issues?.[0]?.message,\n          );\n        }\n      }\n\n      return React.createElement(registeredComponent.component, validatedProps);\n    } catch (error) {\n      console.error(\"[ComponentRenderer] Failed to render component\", {\n        threadId,\n        messageId,\n        componentId: content.id,\n        componentName: content.name,\n        streamingState: content.streamingState,\n        props: content.props,\n        error,\n      });\n      return null;\n    }\n  }, [\n    content.id,\n    content.name,\n    content.props,\n    content.streamingState,\n    messageId,\n    threadId,\n    registry.componentList,\n  ]);\n\n  if (element === null) {\n    return <>{fallback}</>;\n  }\n\n  // Wrap with provider so hooks like useTamboComponentState work\n  return (\n    <ComponentContentProvider\n      componentId={content.id}\n      threadId={threadId}\n      messageId={messageId}\n      componentName={content.name}\n    >\n      {element}\n    </ComponentContentProvider>\n  );\n};\n"]}