@tambo-ai/react 0.70.0 → 0.71.0

package/dist/v1/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;AAEH,yCAAyC;AACzC,mEAAmE;AACnE,oGAAoG;AAEpG,qCAAqC;AACrC,qDAAqD;AACrD,kEAAkE;AAClE,sEAAsE;AACtE,6EAA6E;AAC7E,mFAAmF;AAEnF,2CAA2C;AAC3C,uDAAuD","sourcesContent":["/**\n * @tambo-ai/react/v1 - React SDK for Tambo v1 API\n *\n * Provides React hooks and providers for building AI-powered applications\n * using the v1 streaming API with AG-UI protocol.\n *\n * Types are not re-exported. Import directly from specific type files:\n * - Custom events: import from '@tambo-ai/react/v1/types/event'\n * - Thread state: import from '@tambo-ai/react/v1/types/thread'\n * - Messages: import from '@tambo-ai/react/v1/types/message'\n * - Components: import from '@tambo-ai/react/v1/types/component'\n * - Tools: import from '@tambo-ai/react/v1/types/tool'\n *\n * SDK types: import directly from @tambo-ai/typescript-sdk\n * AG-UI events: import directly from @ag-ui/core\n * @example\n * ```typescript\n * import { TamboV1Provider, useTamboV1 } from '@tambo-ai/react/v1';\n *\n * function App() {\n *   return (\n *     <TamboV1Provider apiKey=\"your-api-key\">\n *       <ChatInterface />\n *     </TamboV1Provider>\n *   );\n * }\n *\n * function ChatInterface() {\n *   const { thread, sendMessage, isStreaming } = useTamboV1();\n *   // ... implementation\n * }\n * ```\n */\n\n// Providers (TODO: implement in Phase 7)\n// export { TamboV1Provider } from './providers/tambo-v1-provider';\n// export { TamboRegistryProvider } from '../providers/tambo-registry-provider'; // Reused from beta\n\n// Hooks (TODO: implement in Phase 7)\n// export { useTamboV1 } from './hooks/use-tambo-v1';\n// export { useTamboV1Thread } from './hooks/use-tambo-v1-thread';\n// export { useTamboV1Messages } from './hooks/use-tambo-v1-messages';\n// export { useTamboV1SendMessage } from './hooks/use-tambo-v1-send-message';\n// export { useTamboV1ComponentState } from './hooks/use-tambo-v1-component-state';\n\n// Utilities (TODO: implement in Phase 2-3)\n// export { applyJsonPatch } from './utils/json-patch';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;;;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,mEAGuC;AAFrC,oHAAA,eAAe,OAAA;AAIjB,+EAM6C;AAL3C,gIAAA,qBAAqB,OAAA;AACrB,yHAAA,cAAc,OAAA;AACd,4HAAA,iBAAiB,OAAA;AACjB,8HAAA,mBAAmB,OAAA;AAIrB,4DAA4D;AAC5D,gFAA6E;AAApE,gIAAA,qBAAqB,OAAA;AAE9B,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,qDAAyE;AAAhE,0GAAA,UAAU,OAAA;AAEnB,uEAGuC;AAFrC,2HAAA,kBAAkB,OAAA;AAIpB,+EAG2C;AAFzC,kIAAA,qBAAqB,OAAA;AAIvB,mEAA+D;AAAtD,uHAAA,gBAAgB,OAAA;AAEzB,6EAAwE;AAA/D,gIAAA,oBAAoB,OAAA;AAE7B,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,iDAAoD;AAA3C,4GAAA,cAAc,OAAA;AAEvB,mEAKqC;AAJnC,2HAAA,oBAAoB,OAAA;AACpB,4HAAA,qBAAqB,OAAA;AACrB,sHAAA,eAAe,OAAA;AACf,uHAAA,gBAAgB,OAAA;AAGlB,uDAI+B;AAH7B,kHAAA,iBAAiB,OAAA;AACjB,uHAAA,sBAAsB,OAAA;AAIxB,+DAA4D;AAAnD,oHAAA,eAAe,OAAA;AAExB,yDAA2D;AAAlD,mHAAA,iBAAiB,OAAA","sourcesContent":["/**\n * `@tambo-ai/react/v1` - React SDK for Tambo v1 API\n *\n * Provides React hooks and providers for building AI-powered applications\n * using the v1 streaming API with AG-UI protocol.\n *\n * ## Quick Start\n *\n * ```tsx\n * import {\n *   TamboV1Provider,\n *   useTamboV1,\n *   useTamboV1SendMessage,\n * } from '@tambo-ai/react/v1';\n *\n * function App() {\n *   return (\n *     <TamboV1Provider\n *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}\n *       components={[WeatherCard]}\n *       tools={[searchTool]}\n *     >\n *       <ChatInterface />\n *     </TamboV1Provider>\n *   );\n * }\n *\n * function ChatInterface() {\n *   const [threadId, setThreadId] = useState<string>();\n *   const { messages, isStreaming } = useTamboV1(threadId);\n *   const sendMessage = useTamboV1SendMessage(threadId);\n *\n *   const handleSend = async (text: string) => {\n *     const result = await sendMessage.mutateAsync({\n *       message: { role: 'user', content: [{ type: 'text', text }] },\n *     });\n *     if (!threadId) setThreadId(result.threadId);\n *   };\n *\n *   return (\n *     <div>\n *       {messages.map(msg => <Message key={msg.id} message={msg} />)}\n *       {isStreaming && <LoadingIndicator />}\n *       <MessageInput onSend={handleSend} />\n *     </div>\n *   );\n * }\n * ```\n *\n * ## Type Imports\n *\n * Types are imported directly from specific files:\n * - Thread state: `import type { TamboV1Thread } from '@tambo-ai/react/v1/types/thread'`\n * - Messages: `import type { TamboV1Message } from '@tambo-ai/react/v1/types/message'`\n * - Custom events: `import type { ComponentStartEvent } from '@tambo-ai/react/v1/types/event'`\n *\n * SDK types: `import type { ... } from '@tambo-ai/typescript-sdk'`\n * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`\n */\n\n// =============================================================================\n// Providers\n// =============================================================================\n\nexport {\n  TamboV1Provider,\n  type TamboV1ProviderProps,\n} from \"./providers/tambo-v1-provider\";\n\nexport {\n  TamboV1StreamProvider,\n  useStreamState,\n  useStreamDispatch,\n  useThreadManagement,\n  type ThreadManagement,\n} from \"./providers/tambo-v1-stream-context\";\n\n// Re-export registry provider from beta SDK (works with v1)\nexport { TamboRegistryProvider } from \"../providers/tambo-registry-provider\";\n\n// =============================================================================\n// Hooks\n// =============================================================================\n\nexport { useTamboV1, type UseTamboV1Return } from \"./hooks/use-tambo-v1\";\n\nexport {\n  useTamboV1Messages,\n  type UseTamboV1MessagesReturn,\n} from \"./hooks/use-tambo-v1-messages\";\n\nexport {\n  useTamboV1SendMessage,\n  type SendMessageOptions,\n} from \"./hooks/use-tambo-v1-send-message\";\n\nexport { useTamboV1Thread } from \"./hooks/use-tambo-v1-thread\";\n\nexport { useTamboV1ThreadList } from \"./hooks/use-tambo-v1-thread-list\";\n\n// =============================================================================\n// Utilities\n// =============================================================================\n\nexport { applyJsonPatch } from \"./utils/json-patch\";\n\nexport {\n  toAvailableComponent,\n  toAvailableComponents,\n  toAvailableTool,\n  toAvailableTools,\n} from \"./utils/registry-conversion\";\n\nexport {\n  executeClientTool,\n  executeAllPendingTools,\n  type PendingToolCall,\n} from \"./utils/tool-executor\";\n\nexport { ToolCallTracker } from \"./utils/tool-call-tracker\";\n\nexport { handleEventStream } from \"./utils/stream-handler\";\n"]}

package/dist/v1/providers/tambo-v1-provider.d.ts

@@ -0,0 +1,91 @@
+/**
+ * TamboV1Provider - Main Provider for v1 API
+ *
+ * Composes the necessary providers for the v1 SDK:
+ * - TamboClientProvider: API client and authentication
+ * - TamboRegistryProvider: Component and tool registration
+ * - TamboV1StreamProvider: Streaming state management
+ *
+ * This provider should wrap your entire application or the portion
+ * that needs access to Tambo v1 functionality.
+ */
+import React, { type PropsWithChildren } from "react";
+import { QueryClient } from "@tanstack/react-query";
+import { type TamboClientProviderProps } from "../../providers/tambo-client-provider";
+import { type TamboRegistryProviderProps } from "../../providers/tambo-registry-provider";
+import type { McpServerInfo } from "../../model/mcp-server-info";
+/**
+ * Props for TamboV1Provider
+ */
+export interface TamboV1ProviderProps extends Pick<TamboClientProviderProps, "apiKey" | "tamboUrl" | "environment" | "userToken"> {
+    /**
+     * Components to register with the registry.
+     * These will be available for the AI to use in responses.
+     */
+    components?: TamboRegistryProviderProps["components"];
+    /**
+     * Tools to register with the registry.
+     * These will be executed client-side when requested by the AI.
+     */
+    tools?: TamboRegistryProviderProps["tools"];
+    /**
+     * MCP servers to register with the registry.
+     * These provide additional tools and resources from MCP-compatible servers.
+     */
+    mcpServers?: (McpServerInfo | string)[];
+    /**
+     * Callback function called when an unregistered tool is called.
+     * If not provided, an error will be thrown for unknown tools.
+     */
+    onCallUnregisteredTool?: TamboRegistryProviderProps["onCallUnregisteredTool"];
+    /**
+     * Optional custom QueryClient instance.
+     * If not provided, a default client will be created.
+     */
+    queryClient?: QueryClient;
+    /**
+     * Children components
+     */
+    children: React.ReactNode;
+}
+/**
+ * Main provider for the Tambo v1 SDK.
+ *
+ * Composes TamboClientProvider, TamboRegistryProvider, and TamboV1StreamProvider
+ * to provide a complete context for building AI-powered applications.
+ *
+ * Threads are managed dynamically through useTamboV1() hook functions:
+ * - startNewThread() - Begin a new conversation
+ * - switchThread(threadId) - Switch to an existing thread
+ * - initThread(threadId) - Initialize a thread for receiving events
+ * @param props - Provider configuration
+ * @param props.apiKey - Tambo API key for authentication
+ * @param props.tamboUrl - Optional custom Tambo API URL
+ * @param props.environment - Optional environment configuration
+ * @param props.userToken - Optional OAuth token for user authentication
+ * @param props.components - Components to register with the AI
+ * @param props.tools - Tools to register for client-side execution
+ * @param props.mcpServers - MCP servers to register for additional tools/resources
+ * @param props.onCallUnregisteredTool - Callback for handling unknown tool calls
+ * @param props.queryClient - Optional custom React Query client
+ * @param props.children - Child components
+ * @returns Provider component tree
+ * @example
+ * ```tsx
+ * import { TamboV1Provider } from '@tambo-ai/react/v1';
+ *
+ * function App() {
+ *   return (
+ *     <TamboV1Provider
+ *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
+ *       components={[WeatherCard, StockChart]}
+ *       tools={[searchTool, calculatorTool]}
+ *     >
+ *       <ChatInterface />
+ *     </TamboV1Provider>
+ *   );
+ * }
+ * ```
+ */
+export declare function TamboV1Provider({ apiKey, tamboUrl, environment, userToken, components, tools, mcpServers, onCallUnregisteredTool, queryClient, children, }: PropsWithChildren<TamboV1ProviderProps>): React.JSX.Element;
+//# sourceMappingURL=tambo-v1-provider.d.ts.map

package/dist/v1/providers/tambo-v1-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-provider.d.ts","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAY,MAAM,OAAO,CAAC;AAChE,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,wBAAwB,EACxB,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,CACpD;IACC;;;OAGG;IACH,UAAU,CAAC,EAAE,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAEtD;;;OAGG;IACH,KAAK,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAE5C;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC;IAExC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,0BAA0B,CAAC,wBAAwB,CAAC,CAAC;IAE9E;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,QAAQ,EACR,WAAW,EACX,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,sBAAsB,EACtB,WAAW,EACX,QAAQ,GACT,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,qBAoCzC"}

package/dist/v1/providers/tambo-v1-provider.js

@@ -0,0 +1,110 @@
+"use strict";
+"use client";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TamboV1Provider = TamboV1Provider;
+/**
+ * TamboV1Provider - Main Provider for v1 API
+ *
+ * Composes the necessary providers for the v1 SDK:
+ * - TamboClientProvider: API client and authentication
+ * - TamboRegistryProvider: Component and tool registration
+ * - TamboV1StreamProvider: Streaming state management
+ *
+ * This provider should wrap your entire application or the portion
+ * that needs access to Tambo v1 functionality.
+ */
+const react_1 = __importStar(require("react"));
+const react_query_1 = require("@tanstack/react-query");
+const tambo_client_provider_1 = require("../../providers/tambo-client-provider");
+const tambo_registry_provider_1 = require("../../providers/tambo-registry-provider");
+const tambo_v1_stream_context_1 = require("./tambo-v1-stream-context");
+/**
+ * Main provider for the Tambo v1 SDK.
+ *
+ * Composes TamboClientProvider, TamboRegistryProvider, and TamboV1StreamProvider
+ * to provide a complete context for building AI-powered applications.
+ *
+ * Threads are managed dynamically through useTamboV1() hook functions:
+ * - startNewThread() - Begin a new conversation
+ * - switchThread(threadId) - Switch to an existing thread
+ * - initThread(threadId) - Initialize a thread for receiving events
+ * @param props - Provider configuration
+ * @param props.apiKey - Tambo API key for authentication
+ * @param props.tamboUrl - Optional custom Tambo API URL
+ * @param props.environment - Optional environment configuration
+ * @param props.userToken - Optional OAuth token for user authentication
+ * @param props.components - Components to register with the AI
+ * @param props.tools - Tools to register for client-side execution
+ * @param props.mcpServers - MCP servers to register for additional tools/resources
+ * @param props.onCallUnregisteredTool - Callback for handling unknown tool calls
+ * @param props.queryClient - Optional custom React Query client
+ * @param props.children - Child components
+ * @returns Provider component tree
+ * @example
+ * ```tsx
+ * import { TamboV1Provider } from '@tambo-ai/react/v1';
+ *
+ * function App() {
+ *   return (
+ *     <TamboV1Provider
+ *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
+ *       components={[WeatherCard, StockChart]}
+ *       tools={[searchTool, calculatorTool]}
+ *     >
+ *       <ChatInterface />
+ *     </TamboV1Provider>
+ *   );
+ * }
+ * ```
+ */
+function TamboV1Provider({ apiKey, tamboUrl, environment, userToken, components, tools, mcpServers, onCallUnregisteredTool, queryClient, children, }) {
+    // Create a stable default QueryClient if none provided.
+    // Using useState to avoid SSR issues with module-level singletons.
+    const [defaultQueryClient] = (0, react_1.useState)(() => new react_query_1.QueryClient({
+        defaultOptions: {
+            queries: {
+                staleTime: 1000,
+                retry: 1,
+            },
+        },
+    }));
+    const client = queryClient ?? defaultQueryClient;
+    return (react_1.default.createElement(react_query_1.QueryClientProvider, { client: client },
+        react_1.default.createElement(tambo_client_provider_1.TamboClientProvider, { apiKey: apiKey, tamboUrl: tamboUrl, environment: environment, userToken: userToken },
+            react_1.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, { components: components, tools: tools, mcpServers: mcpServers, onCallUnregisteredTool: onCallUnregisteredTool },
+                react_1.default.createElement(tambo_v1_stream_context_1.TamboV1StreamProvider, null, children)))));
+}
+//# sourceMappingURL=tambo-v1-provider.js.map

package/dist/v1/providers/tambo-v1-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-provider.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.tsx"],"names":[],"mappings":";AAAA,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6Gb,0CA+CC;AA1JD;;;;;;;;;;GAUG;AAEH,+CAAgE;AAChE,uDAAyE;AACzE,iFAG+C;AAC/C,qFAGiD;AAEjD,uEAAkE;AA6ClE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,SAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,QAAQ,EACR,WAAW,EACX,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,sBAAsB,EACtB,WAAW,EACX,QAAQ,GACgC;IACxC,wDAAwD;IACxD,mEAAmE;IACnE,MAAM,CAAC,kBAAkB,CAAC,GAAG,IAAA,gBAAQ,EACnC,GAAG,EAAE,CACH,IAAI,yBAAW,CAAC;QACd,cAAc,EAAE;YACd,OAAO,EAAE;gBACP,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,CAAC;aACT;SACF;KACF,CAAC,CACL,CAAC;IAEF,MAAM,MAAM,GAAG,WAAW,IAAI,kBAAkB,CAAC;IAEjD,OAAO,CACL,8BAAC,iCAAmB,IAAC,MAAM,EAAE,MAAM;QACjC,8BAAC,2CAAmB,IAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS;YAEpB,8BAAC,+CAAqB,IACpB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,UAAU,EACtB,sBAAsB,EAAE,sBAAsB;gBAE9C,8BAAC,+CAAqB,QAAE,QAAQ,CAAyB,CACnC,CACJ,CACF,CACvB,CAAC;AACJ,CAAC","sourcesContent":["\"use client\";\n\n/**\n * TamboV1Provider - Main Provider for v1 API\n *\n * Composes the necessary providers for the v1 SDK:\n * - TamboClientProvider: API client and authentication\n * - TamboRegistryProvider: Component and tool registration\n * - TamboV1StreamProvider: Streaming state management\n *\n * This provider should wrap your entire application or the portion\n * that needs access to Tambo v1 functionality.\n */\n\nimport React, { type PropsWithChildren, useState } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport {\n  TamboClientProvider,\n  type TamboClientProviderProps,\n} from \"../../providers/tambo-client-provider\";\nimport {\n  TamboRegistryProvider,\n  type TamboRegistryProviderProps,\n} from \"../../providers/tambo-registry-provider\";\nimport type { McpServerInfo } from \"../../model/mcp-server-info\";\nimport { TamboV1StreamProvider } from \"./tambo-v1-stream-context\";\n\n/**\n * Props for TamboV1Provider\n */\nexport interface TamboV1ProviderProps extends Pick<\n  TamboClientProviderProps,\n  \"apiKey\" | \"tamboUrl\" | \"environment\" | \"userToken\"\n> {\n  /**\n   * Components to register with the registry.\n   * These will be available for the AI to use in responses.\n   */\n  components?: TamboRegistryProviderProps[\"components\"];\n\n  /**\n   * Tools to register with the registry.\n   * These will be executed client-side when requested by the AI.\n   */\n  tools?: TamboRegistryProviderProps[\"tools\"];\n\n  /**\n   * MCP servers to register with the registry.\n   * These provide additional tools and resources from MCP-compatible servers.\n   */\n  mcpServers?: (McpServerInfo | string)[];\n\n  /**\n   * Callback function called when an unregistered tool is called.\n   * If not provided, an error will be thrown for unknown tools.\n   */\n  onCallUnregisteredTool?: TamboRegistryProviderProps[\"onCallUnregisteredTool\"];\n\n  /**\n   * Optional custom QueryClient instance.\n   * If not provided, a default client will be created.\n   */\n  queryClient?: QueryClient;\n\n  /**\n   * Children components\n   */\n  children: React.ReactNode;\n}\n\n/**\n * Main provider for the Tambo v1 SDK.\n *\n * Composes TamboClientProvider, TamboRegistryProvider, and TamboV1StreamProvider\n * to provide a complete context for building AI-powered applications.\n *\n * Threads are managed dynamically through useTamboV1() hook functions:\n * - startNewThread() - Begin a new conversation\n * - switchThread(threadId) - Switch to an existing thread\n * - initThread(threadId) - Initialize a thread for receiving events\n * @param props - Provider configuration\n * @param props.apiKey - Tambo API key for authentication\n * @param props.tamboUrl - Optional custom Tambo API URL\n * @param props.environment - Optional environment configuration\n * @param props.userToken - Optional OAuth token for user authentication\n * @param props.components - Components to register with the AI\n * @param props.tools - Tools to register for client-side execution\n * @param props.mcpServers - MCP servers to register for additional tools/resources\n * @param props.onCallUnregisteredTool - Callback for handling unknown tool calls\n * @param props.queryClient - Optional custom React Query client\n * @param props.children - Child components\n * @returns Provider component tree\n * @example\n * ```tsx\n * import { TamboV1Provider } from '@tambo-ai/react/v1';\n *\n * function App() {\n *   return (\n *     <TamboV1Provider\n *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}\n *       components={[WeatherCard, StockChart]}\n *       tools={[searchTool, calculatorTool]}\n *     >\n *       <ChatInterface />\n *     </TamboV1Provider>\n *   );\n * }\n * ```\n */\nexport function TamboV1Provider({\n  apiKey,\n  tamboUrl,\n  environment,\n  userToken,\n  components,\n  tools,\n  mcpServers,\n  onCallUnregisteredTool,\n  queryClient,\n  children,\n}: PropsWithChildren<TamboV1ProviderProps>) {\n  // Create a stable default QueryClient if none provided.\n  // Using useState to avoid SSR issues with module-level singletons.\n  const [defaultQueryClient] = useState(\n    () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: {\n            staleTime: 1000,\n            retry: 1,\n          },\n        },\n      }),\n  );\n\n  const client = queryClient ?? defaultQueryClient;\n\n  return (\n    <QueryClientProvider client={client}>\n      <TamboClientProvider\n        apiKey={apiKey}\n        tamboUrl={tamboUrl}\n        environment={environment}\n        userToken={userToken}\n      >\n        <TamboRegistryProvider\n          components={components}\n          tools={tools}\n          mcpServers={mcpServers}\n          onCallUnregisteredTool={onCallUnregisteredTool}\n        >\n          <TamboV1StreamProvider>{children}</TamboV1StreamProvider>\n        </TamboRegistryProvider>\n      </TamboClientProvider>\n    </QueryClientProvider>\n  );\n}\n"]}

package/dist/v1/providers/tambo-v1-provider.test.d.ts

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

package/dist/v1/providers/tambo-v1-provider.test.d.ts.map

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

package/dist/v1/providers/tambo-v1-provider.test.js

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_query_1 = require("@tanstack/react-query");
+const react_1 = require("@testing-library/react");
+const react_2 = __importDefault(require("react"));
+const zod_1 = require("zod");
+const tambo_client_provider_1 = require("../../providers/tambo-client-provider");
+const tambo_registry_provider_1 = require("../../providers/tambo-registry-provider");
+const tambo_v1_stream_context_1 = require("./tambo-v1-stream-context");
+const tambo_v1_provider_1 = require("./tambo-v1-provider");
+// Mock the client provider to capture the apiKey
+jest.mock("../../providers/tambo-client-provider", () => ({
+    useTamboClient: jest.fn(),
+    TamboClientProvider: ({ children }) => children,
+}));
+describe("TamboV1Provider", () => {
+    const mockClient = {
+        apiKey: "test-api-key",
+        threads: {},
+    };
+    beforeEach(() => {
+        jest.mocked(tambo_client_provider_1.useTamboClient).mockReturnValue(mockClient);
+    });
+    it("provides access to registry context", () => {
+        const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_provider_1.TamboV1Provider, { apiKey: "test-api-key" }, children));
+        const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+        expect(result.current.componentList).toBeDefined();
+        expect(result.current.toolRegistry).toBeDefined();
+        expect(typeof result.current.registerComponent).toBe("function");
+        expect(typeof result.current.registerTool).toBe("function");
+    });
+    it("provides access to stream context", () => {
+        const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_provider_1.TamboV1Provider, { apiKey: "test-api-key" }, children));
+        const { result } = (0, react_1.renderHook)(() => (0, tambo_v1_stream_context_1.useStreamState)(), { wrapper });
+        expect(result.current.threadMap).toBeDefined();
+        expect(result.current.currentThreadId).toBeNull();
+    });
+    it("manages threads via useThreadManagement", () => {
+        const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_provider_1.TamboV1Provider, { apiKey: "test-api-key" }, children));
+        const { result } = (0, react_1.renderHook)(() => ({
+            state: (0, tambo_v1_stream_context_1.useStreamState)(),
+            management: (0, tambo_v1_stream_context_1.useThreadManagement)(),
+        }), { wrapper });
+        // Initially no thread
+        expect(result.current.state.currentThreadId).toBeNull();
+        // Initialize and switch to a thread
+        (0, react_1.act)(() => {
+            result.current.management.initThread("thread_123");
+            result.current.management.switchThread("thread_123");
+        });
+        expect(result.current.state.currentThreadId).toBe("thread_123");
+        expect(result.current.state.threadMap.thread_123).toBeDefined();
+    });
+    it("provides access to query client", () => {
+        const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_provider_1.TamboV1Provider, { apiKey: "test-api-key" }, children));
+        const { result } = (0, react_1.renderHook)(() => (0, react_query_1.useQueryClient)(), { wrapper });
+        expect(result.current).toBeInstanceOf(react_query_1.QueryClient);
+    });
+    it("uses custom query client when provided", () => {
+        const customClient = new react_query_1.QueryClient();
+        const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_provider_1.TamboV1Provider, { apiKey: "test-api-key", queryClient: customClient }, children));
+        const { result } = (0, react_1.renderHook)(() => (0, react_query_1.useQueryClient)(), { wrapper });
+        expect(result.current).toBe(customClient);
+    });
+    it("registers components when provided", () => {
+        const TestComponent = () => react_2.default.createElement("div", null, "Test");
+        const propsSchema = zod_1.z.object({
+            title: zod_1.z.string().describe("The title"),
+        });
+        const components = [
+            {
+                name: "TestComponent",
+                description: "A test component",
+                component: TestComponent,
+                propsSchema,
+            },
+        ];
+        const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_provider_1.TamboV1Provider, { apiKey: "test-api-key", components: components }, children));
+        const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+        expect(result.current.componentList.TestComponent).toBeDefined();
+        expect(result.current.componentList.TestComponent.name).toBe("TestComponent");
+    });
+    it("registers tools when provided", () => {
+        const inputSchema = zod_1.z.object({
+            query: zod_1.z.string().describe("Search query"),
+        });
+        const outputSchema = zod_1.z.string().describe("Result string");
+        const tools = [
+            {
+                name: "testTool",
+                description: "A test tool",
+                tool: async () => "result",
+                inputSchema,
+                outputSchema,
+            },
+        ];
+        const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_provider_1.TamboV1Provider, { apiKey: "test-api-key", tools: tools }, children));
+        const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+        expect(result.current.toolRegistry.testTool).toBeDefined();
+        expect(result.current.toolRegistry.testTool.name).toBe("testTool");
+    });
+    it("registers MCP servers when provided", () => {
+        const mcpServers = [
+            { url: "https://mcp.example.com", name: "Example MCP" },
+        ];
+        const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_provider_1.TamboV1Provider, { apiKey: "test-api-key", mcpServers: mcpServers }, children));
+        const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+        expect(result.current.mcpServerInfos).toHaveLength(1);
+        expect(result.current.mcpServerInfos[0].url).toBe("https://mcp.example.com");
+    });
+    it("provides onCallUnregisteredTool to registry", () => {
+        const onCallUnregisteredTool = jest
+            .fn()
+            .mockResolvedValue("fallback result");
+        const wrapper = ({ children }) => (react_2.default.createElement(tambo_v1_provider_1.TamboV1Provider, { apiKey: "test-api-key", onCallUnregisteredTool: onCallUnregisteredTool }, children));
+        const { result } = (0, react_1.renderHook)(() => (0, tambo_registry_provider_1.useTamboRegistry)(), { wrapper });
+        expect(result.current.onCallUnregisteredTool).toBe(onCallUnregisteredTool);
+    });
+});
+//# sourceMappingURL=tambo-v1-provider.test.js.map

package/dist/v1/providers/tambo-v1-provider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-provider.test.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.test.tsx"],"names":[],"mappings":";;;;;AACA,uDAAoE;AACpE,kDAAyD;AACzD,kDAA0B;AAC1B,6BAAwB;AACxB,iFAAuE;AACvE,qFAA2E;AAC3E,uEAAgF;AAChF,2DAAsD;AAEtD,iDAAiD;AACjD,IAAI,CAAC,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE,CAAC,CAAC;IACxD,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE;IACzB,mBAAmB,EAAE,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CACnE,QAAQ;CACX,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,MAAM,UAAU,GAAG;QACjB,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,EAAE;KACU,CAAC;IAExB,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,MAAM,CAAC,sCAAc,CAAC,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,8BAAC,mCAAe,IAAC,MAAM,EAAC,cAAc,IAAE,QAAQ,CAAmB,CACpE,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,kBAAU,EAAC,GAAG,EAAE,CAAC,IAAA,0CAAgB,GAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAErE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjE,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,8BAAC,mCAAe,IAAC,MAAM,EAAC,cAAc,IAAE,QAAQ,CAAmB,CACpE,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,kBAAU,EAAC,GAAG,EAAE,CAAC,IAAA,wCAAc,GAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,8BAAC,mCAAe,IAAC,MAAM,EAAC,cAAc,IAAE,QAAQ,CAAmB,CACpE,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,kBAAU,EAC3B,GAAG,EAAE,CAAC,CAAC;YACL,KAAK,EAAE,IAAA,wCAAc,GAAE;YACvB,UAAU,EAAE,IAAA,6CAAmB,GAAE;SAClC,CAAC,EACF,EAAE,OAAO,EAAE,CACZ,CAAC;QAEF,sBAAsB;QACtB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC;QAExD,oCAAoC;QACpC,IAAA,WAAG,EAAC,GAAG,EAAE;YACP,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YACnD,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,8BAAC,mCAAe,IAAC,MAAM,EAAC,cAAc,IAAE,QAAQ,CAAmB,CACpE,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,kBAAU,EAAC,GAAG,EAAE,CAAC,IAAA,4BAAc,GAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,yBAAW,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,YAAY,GAAG,IAAI,yBAAW,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,8BAAC,mCAAe,IAAC,MAAM,EAAC,cAAc,EAAC,WAAW,EAAE,YAAY,IAC7D,QAAQ,CACO,CACnB,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,kBAAU,EAAC,GAAG,EAAE,CAAC,IAAA,4BAAc,GAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,kDAAe,CAAC;QAC5C,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;YAC3B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;SACxC,CAAC,CAAC;QACH,MAAM,UAAU,GAAG;YACjB;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,kBAAkB;gBAC/B,SAAS,EAAE,aAAa;gBACxB,WAAW;aACZ;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,8BAAC,mCAAe,IAAC,MAAM,EAAC,cAAc,EAAC,UAAU,EAAE,UAAU,IAC1D,QAAQ,CACO,CACnB,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,kBAAU,EAAC,GAAG,EAAE,CAAC,IAAA,0CAAgB,GAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAErE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QACjE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAC1D,eAAe,CAChB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;YAC3B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;SAC3C,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG;YACZ;gBACE,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,aAAa;gBAC1B,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,QAAQ;gBAC1B,WAAW;gBACX,YAAY;aACb;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,8BAAC,mCAAe,IAAC,MAAM,EAAC,cAAc,EAAC,KAAK,EAAE,KAAK,IAChD,QAAQ,CACO,CACnB,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,kBAAU,EAAC,GAAG,EAAE,CAAC,IAAA,0CAAgB,GAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAErE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,UAAU,GAAG;YACjB,EAAE,GAAG,EAAE,yBAAyB,EAAE,IAAI,EAAE,aAAa,EAAE;SACxD,CAAC;QAEF,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,8BAAC,mCAAe,IAAC,MAAM,EAAC,cAAc,EAAC,UAAU,EAAE,UAAU,IAC1D,QAAQ,CACO,CACnB,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,kBAAU,EAAC,GAAG,EAAE,CAAC,IAAA,0CAAgB,GAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAErE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAC/C,yBAAyB,CAC1B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,sBAAsB,GAAG,IAAI;aAChC,EAAE,EAAE;aACJ,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;QAExC,MAAM,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAiC,EAAE,EAAE,CAAC,CAC/D,8BAAC,mCAAe,IACd,MAAM,EAAC,cAAc,EACrB,sBAAsB,EAAE,sBAAsB,IAE7C,QAAQ,CACO,CACnB,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,kBAAU,EAAC,GAAG,EAAE,CAAC,IAAA,0CAAgB,GAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAErE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { QueryClient, useQueryClient } from \"@tanstack/react-query\";\nimport { renderHook, act } from \"@testing-library/react\";\nimport React from \"react\";\nimport { z } from \"zod\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport { useTamboRegistry } from \"../../providers/tambo-registry-provider\";\nimport { useStreamState, useThreadManagement } from \"./tambo-v1-stream-context\";\nimport { TamboV1Provider } from \"./tambo-v1-provider\";\n\n// Mock the client provider to capture the apiKey\njest.mock(\"../../providers/tambo-client-provider\", () => ({\n  useTamboClient: jest.fn(),\n  TamboClientProvider: ({ children }: { children: React.ReactNode }) =>\n    children,\n}));\n\ndescribe(\"TamboV1Provider\", () => {\n  const mockClient = {\n    apiKey: \"test-api-key\",\n    threads: {},\n  } as unknown as TamboAI;\n\n  beforeEach(() => {\n    jest.mocked(useTamboClient).mockReturnValue(mockClient);\n  });\n\n  it(\"provides access to registry context\", () => {\n    const wrapper = ({ children }: { children: React.ReactNode }) => (\n      <TamboV1Provider apiKey=\"test-api-key\">{children}</TamboV1Provider>\n    );\n\n    const { result } = renderHook(() => useTamboRegistry(), { wrapper });\n\n    expect(result.current.componentList).toBeDefined();\n    expect(result.current.toolRegistry).toBeDefined();\n    expect(typeof result.current.registerComponent).toBe(\"function\");\n    expect(typeof result.current.registerTool).toBe(\"function\");\n  });\n\n  it(\"provides access to stream context\", () => {\n    const wrapper = ({ children }: { children: React.ReactNode }) => (\n      <TamboV1Provider apiKey=\"test-api-key\">{children}</TamboV1Provider>\n    );\n\n    const { result } = renderHook(() => useStreamState(), { wrapper });\n\n    expect(result.current.threadMap).toBeDefined();\n    expect(result.current.currentThreadId).toBeNull();\n  });\n\n  it(\"manages threads via useThreadManagement\", () => {\n    const wrapper = ({ children }: { children: React.ReactNode }) => (\n      <TamboV1Provider apiKey=\"test-api-key\">{children}</TamboV1Provider>\n    );\n\n    const { result } = renderHook(\n      () => ({\n        state: useStreamState(),\n        management: useThreadManagement(),\n      }),\n      { wrapper },\n    );\n\n    // Initially no thread\n    expect(result.current.state.currentThreadId).toBeNull();\n\n    // Initialize and switch to a thread\n    act(() => {\n      result.current.management.initThread(\"thread_123\");\n      result.current.management.switchThread(\"thread_123\");\n    });\n\n    expect(result.current.state.currentThreadId).toBe(\"thread_123\");\n    expect(result.current.state.threadMap.thread_123).toBeDefined();\n  });\n\n  it(\"provides access to query client\", () => {\n    const wrapper = ({ children }: { children: React.ReactNode }) => (\n      <TamboV1Provider apiKey=\"test-api-key\">{children}</TamboV1Provider>\n    );\n\n    const { result } = renderHook(() => useQueryClient(), { wrapper });\n\n    expect(result.current).toBeInstanceOf(QueryClient);\n  });\n\n  it(\"uses custom query client when provided\", () => {\n    const customClient = new QueryClient();\n    const wrapper = ({ children }: { children: React.ReactNode }) => (\n      <TamboV1Provider apiKey=\"test-api-key\" queryClient={customClient}>\n        {children}\n      </TamboV1Provider>\n    );\n\n    const { result } = renderHook(() => useQueryClient(), { wrapper });\n\n    expect(result.current).toBe(customClient);\n  });\n\n  it(\"registers components when provided\", () => {\n    const TestComponent = () => <div>Test</div>;\n    const propsSchema = z.object({\n      title: z.string().describe(\"The title\"),\n    });\n    const components = [\n      {\n        name: \"TestComponent\",\n        description: \"A test component\",\n        component: TestComponent,\n        propsSchema,\n      },\n    ];\n\n    const wrapper = ({ children }: { children: React.ReactNode }) => (\n      <TamboV1Provider apiKey=\"test-api-key\" components={components}>\n        {children}\n      </TamboV1Provider>\n    );\n\n    const { result } = renderHook(() => useTamboRegistry(), { wrapper });\n\n    expect(result.current.componentList.TestComponent).toBeDefined();\n    expect(result.current.componentList.TestComponent.name).toBe(\n      \"TestComponent\",\n    );\n  });\n\n  it(\"registers tools when provided\", () => {\n    const inputSchema = z.object({\n      query: z.string().describe(\"Search query\"),\n    });\n    const outputSchema = z.string().describe(\"Result string\");\n    const tools = [\n      {\n        name: \"testTool\",\n        description: \"A test tool\",\n        tool: async () => \"result\",\n        inputSchema,\n        outputSchema,\n      },\n    ];\n\n    const wrapper = ({ children }: { children: React.ReactNode }) => (\n      <TamboV1Provider apiKey=\"test-api-key\" tools={tools}>\n        {children}\n      </TamboV1Provider>\n    );\n\n    const { result } = renderHook(() => useTamboRegistry(), { wrapper });\n\n    expect(result.current.toolRegistry.testTool).toBeDefined();\n    expect(result.current.toolRegistry.testTool.name).toBe(\"testTool\");\n  });\n\n  it(\"registers MCP servers when provided\", () => {\n    const mcpServers = [\n      { url: \"https://mcp.example.com\", name: \"Example MCP\" },\n    ];\n\n    const wrapper = ({ children }: { children: React.ReactNode }) => (\n      <TamboV1Provider apiKey=\"test-api-key\" mcpServers={mcpServers}>\n        {children}\n      </TamboV1Provider>\n    );\n\n    const { result } = renderHook(() => useTamboRegistry(), { wrapper });\n\n    expect(result.current.mcpServerInfos).toHaveLength(1);\n    expect(result.current.mcpServerInfos[0].url).toBe(\n      \"https://mcp.example.com\",\n    );\n  });\n\n  it(\"provides onCallUnregisteredTool to registry\", () => {\n    const onCallUnregisteredTool = jest\n      .fn()\n      .mockResolvedValue(\"fallback result\");\n\n    const wrapper = ({ children }: { children: React.ReactNode }) => (\n      <TamboV1Provider\n        apiKey=\"test-api-key\"\n        onCallUnregisteredTool={onCallUnregisteredTool}\n      >\n        {children}\n      </TamboV1Provider>\n    );\n\n    const { result } = renderHook(() => useTamboRegistry(), { wrapper });\n\n    expect(result.current.onCallUnregisteredTool).toBe(onCallUnregisteredTool);\n  });\n});\n"]}

package/dist/v1/providers/tambo-v1-stream-context.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Stream Context Provider for v1 API
+ *
+ * Manages streaming state using React Context and useReducer.
+ * Provides state and dispatch to child components via separate contexts
+ * following the split-context pattern for optimal re-render performance.
+ */
+import React, { type ReactNode, type Dispatch } from "react";
+import { type StreamState, type StreamAction } from "../utils/event-accumulator";
+import type { TamboV1Thread } from "../types/thread";
+/**
+ * Thread management functions exposed by the stream context.
+ */
+export interface ThreadManagement {
+    /**
+     * Initialize a new thread in the stream context.
+     * Use this before sending messages to a new thread.
+     * @param threadId - The thread ID to initialize
+     * @param initialThread - Optional initial thread data
+     */
+    initThread: (threadId: string, initialThread?: Partial<TamboV1Thread>) => void;
+    /**
+     * Switch the current active thread.
+     * Does not fetch thread data - use useTamboV1Thread for that.
+     * @param threadId - The thread ID to switch to, or null to clear
+     */
+    switchThread: (threadId: string | null) => void;
+    /**
+     * Start a new thread (generates a temporary ID).
+     * The actual thread ID will be assigned when the first message is sent.
+     * @returns The temporary thread ID
+     */
+    startNewThread: () => string;
+}
+/**
+ * Props for TamboV1StreamProvider
+ */
+export interface TamboV1StreamProviderProps {
+    children: ReactNode;
+    /**
+     * Initial thread state (optional).
+     * If not provided, an empty thread will be created.
+     */
+    initialThread?: Partial<TamboV1Thread>;
+    /**
+     * Thread ID for the stream context.
+     * Used to initialize the thread if initialThread is not provided.
+     */
+    threadId?: string;
+}
+/**
+ * Provider component for stream state management.
+ *
+ * Uses useReducer with streamReducer to accumulate AG-UI events into
+ * thread state. Provides state, dispatch, and thread management via separate contexts.
+ * @returns JSX element wrapping children with stream contexts
+ * @example
+ * ```tsx
+ * <TamboV1StreamProvider threadId="thread_123">
+ *   <ChatInterface />
+ * </TamboV1StreamProvider>
+ * ```
+ */
+export declare function TamboV1StreamProvider(props: TamboV1StreamProviderProps): React.JSX.Element;
+/**
+ * Hook to access stream state.
+ *
+ * Must be used within TamboV1StreamProvider.
+ * @returns Current stream state
+ * @throws {Error} if used outside TamboV1StreamProvider
+ * @example
+ * ```tsx
+ * function ChatMessages() {
+ *   const { thread, streaming } = useStreamState();
+ *
+ *   return (
+ *     <div>
+ *       {thread.messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *       {streaming.status === 'streaming' && <LoadingIndicator />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useStreamState(): StreamState;
+/**
+ * Hook to access stream dispatch function.
+ *
+ * Must be used within TamboV1StreamProvider.
+ * @returns Dispatch function for sending events to reducer
+ * @throws {Error} if used outside TamboV1StreamProvider
+ * @example
+ * ```tsx
+ * function StreamHandler() {
+ *   const dispatch = useStreamDispatch();
+ *
+ *   useEffect(() => {
+ *     async function handleStream() {
+ *       for await (const event of streamEvents) {
+ *         dispatch({ type: 'EVENT', event });
+ *       }
+ *     }
+ *     handleStream();
+ *   }, [dispatch]);
+ *
+ *   return null;
+ * }
+ * ```
+ */
+export declare function useStreamDispatch(): Dispatch<StreamAction>;
+/**
+ * Hook to access thread management functions.
+ *
+ * Must be used within TamboV1StreamProvider.
+ * @returns Thread management functions
+ * @throws {Error} if used outside TamboV1StreamProvider
+ * @example
+ * ```tsx
+ * function ThreadSwitcher() {
+ *   const { switchThread, startNewThread } = useThreadManagement();
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={() => switchThread('thread_123')}>
+ *         Load Thread
+ *       </button>
+ *       <button onClick={startNewThread}>
+ *         New Chat
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useThreadManagement(): ThreadManagement;
+//# sourceMappingURL=tambo-v1-stream-context.d.ts.map

package/dist/v1/providers/tambo-v1-stream-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-stream-context.d.ts","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-stream-context.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,EAMZ,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,OAAO,CAAC;AACf,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,UAAU,EAAE,CACV,QAAQ,EAAE,MAAM,EAChB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,KACnC,IAAI,CAAC;IAEV;;;;OAIG;IACH,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAEhD;;;;OAIG;IACH,cAAc,EAAE,MAAM,MAAM,CAAC;CAC9B;AAsBD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA0CD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,qBAkDtE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAQ5C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,IAAI,QAAQ,CAAC,YAAY,CAAC,CAU1D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAUtD"}