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

package/dist/v1/index.js

@@ -1,9 +1,9 @@
 "use strict";
 /**
- * `@tambo-ai/react/v1` - React SDK for Tambo v1 API
+ * `@tambo-ai/react` - React SDK for Tambo AI
  *
  * Provides React hooks and providers for building AI-powered applications
- * using the v1 streaming API with AG-UI protocol.
+ * using the streaming API with AG-UI protocol.
  *
  * ## Authentication & Thread Ownership
  *
@@ -17,28 +17,28 @@
  *
  * ```tsx
  * import {
- *   TamboV1Provider,
- *   useTamboV1,
- *   useTamboV1ThreadInput,
- * } from '@tambo-ai/react/v1';
+ *   TamboProvider,
+ *   useTambo,
+ *   useTamboThreadInput,
+ * } from '@tambo-ai/react';
  *
  * function App() {
  *   return (
- *     <TamboV1Provider
+ *     <TamboProvider
  *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
  *       userKey={currentUserId} // Required: identifies thread owner
  *       components={[WeatherCard]}
  *       tools={[searchTool]}
  *     >
  *       <ChatInterface />
- *     </TamboV1Provider>
+ *     </TamboProvider>
  *   );
  * }
  *
  * function ChatInterface() {
  *   const [threadId, setThreadId] = useState<string>();
- *   const { messages, isStreaming } = useTamboV1(threadId);
- *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);
+ *   const { messages, isStreaming } = useTambo();
+ *   const { value, setValue, submit, isPending } = useTamboThreadInput();
  *
  *   const handleSubmit = async (e: React.FormEvent) => {
  *     e.preventDefault();
@@ -59,65 +59,64 @@
  *
  * ## Type Imports
  *
- * Types are imported directly from specific files:
- * - Thread state: `import type { TamboV1Thread } from '@tambo-ai/react/v1/types/thread'`
- * - Messages: `import type { TamboV1Message } from '@tambo-ai/react/v1/types/message'`
- * - Custom events: `import type { ComponentStartEvent } from '@tambo-ai/react/v1/types/event'`
+ * Types are imported directly:
+ * - Thread state: `import type { TamboThread } from '@tambo-ai/react'`
+ * - Messages: `import type { TamboThreadMessage } from '@tambo-ai/react'`
  *
  * SDK types: `import type { ... } from '@tambo-ai/typescript-sdk'`
  * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useCurrentInteractablesSnapshot = exports.useTamboInteractable = exports.withTamboInteractable = exports.MCPTransport = exports.currentTimeContextHelper = exports.currentPageContextHelper = exports.defineTool = exports.useTamboVoice = exports.useMessageImages = exports.useTamboClient = exports.useTamboV1Suggestions = exports.useTamboV1StreamStatus = exports.useTamboV1ComponentState = exports.useTamboV1ThreadList = exports.useTamboV1Thread = exports.useTamboV1ThreadInput = exports.useTamboV1 = exports.V1ComponentRenderer = exports.TamboV1StubProvider = exports.TamboV1ThreadInputProvider = exports.useTamboContextAttachment = exports.useTamboContextHelpers = exports.TamboContextHelpersProvider = exports.useIsTamboTokenUpdating = exports.TamboClientProvider = exports.TamboRegistryProvider = exports.useTamboV1Config = exports.TamboV1Provider = void 0;
+exports.useCurrentInteractablesSnapshot = exports.useTamboInteractable = exports.withTamboInteractable = exports.useComponentContent = exports.ComponentContentProvider = exports.MCPTransport = exports.currentTimeContextHelper = exports.currentPageContextHelper = exports.defineTool = exports.useTamboCurrentComponent = exports.useTamboCurrentMessage = exports.TamboMessageProvider = exports.useTamboVoice = exports.useMessageImages = exports.useTamboClient = exports.useTamboSuggestions = exports.useTamboStreamStatus = exports.useTamboComponentState = exports.useTamboThreadList = exports.useTamboThread = exports.useTamboThreadInput = exports.useTambo = exports.ComponentRenderer = exports.TamboStubProvider = exports.TamboThreadInputProvider = exports.useTamboContextAttachment = exports.useTamboContextHelpers = exports.TamboContextHelpersProvider = exports.useIsTamboTokenUpdating = exports.TamboClientProvider = exports.TamboRegistryProvider = exports.useTamboConfig = exports.TamboProvider = void 0;
 // =============================================================================
 // Providers
 // =============================================================================
 var tambo_v1_provider_1 = require("./providers/tambo-v1-provider");
-Object.defineProperty(exports, "TamboV1Provider", { enumerable: true, get: function () { return tambo_v1_provider_1.TamboV1Provider; } });
-Object.defineProperty(exports, "useTamboV1Config", { enumerable: true, get: function () { return tambo_v1_provider_1.useTamboV1Config; } });
-// Re-export registry provider from beta SDK (works with v1)
+Object.defineProperty(exports, "TamboProvider", { enumerable: true, get: function () { return tambo_v1_provider_1.TamboProvider; } });
+Object.defineProperty(exports, "useTamboConfig", { enumerable: true, get: function () { return tambo_v1_provider_1.useTamboConfig; } });
+// Re-export registry provider
 var tambo_registry_provider_1 = require("../providers/tambo-registry-provider");
 Object.defineProperty(exports, "TamboRegistryProvider", { enumerable: true, get: function () { return tambo_registry_provider_1.TamboRegistryProvider; } });
-// Re-export client provider from beta SDK (works with v1)
+// Re-export client provider
 var tambo_client_provider_1 = require("../providers/tambo-client-provider");
 Object.defineProperty(exports, "TamboClientProvider", { enumerable: true, get: function () { return tambo_client_provider_1.TamboClientProvider; } });
 Object.defineProperty(exports, "useIsTamboTokenUpdating", { enumerable: true, get: function () { return tambo_client_provider_1.useIsTamboTokenUpdating; } });
-// Re-export context helpers from beta SDK (works with v1)
+// Re-export context helpers
 var tambo_context_helpers_provider_1 = require("../providers/tambo-context-helpers-provider");
 Object.defineProperty(exports, "TamboContextHelpersProvider", { enumerable: true, get: function () { return tambo_context_helpers_provider_1.TamboContextHelpersProvider; } });
 Object.defineProperty(exports, "useTamboContextHelpers", { enumerable: true, get: function () { return tambo_context_helpers_provider_1.useTamboContextHelpers; } });
-// Re-export context attachment hook from beta SDK (works with v1)
+// Re-export context attachment hook
 var tambo_context_attachment_provider_1 = require("../providers/tambo-context-attachment-provider");
 Object.defineProperty(exports, "useTamboContextAttachment", { enumerable: true, get: function () { return tambo_context_attachment_provider_1.useTamboContextAttachment; } });
-// Export v1 thread input provider for advanced composition
+// Export thread input provider for advanced composition
 var tambo_v1_thread_input_provider_1 = require("./providers/tambo-v1-thread-input-provider");
-Object.defineProperty(exports, "TamboV1ThreadInputProvider", { enumerable: true, get: function () { return tambo_v1_thread_input_provider_1.TamboV1ThreadInputProvider; } });
-// Export v1 stub provider for testing
+Object.defineProperty(exports, "TamboThreadInputProvider", { enumerable: true, get: function () { return tambo_v1_thread_input_provider_1.TamboThreadInputProvider; } });
+// Export stub provider for testing
 var tambo_v1_stub_provider_1 = require("./providers/tambo-v1-stub-provider");
-Object.defineProperty(exports, "TamboV1StubProvider", { enumerable: true, get: function () { return tambo_v1_stub_provider_1.TamboV1StubProvider; } });
+Object.defineProperty(exports, "TamboStubProvider", { enumerable: true, get: function () { return tambo_v1_stub_provider_1.TamboStubProvider; } });
 // =============================================================================
 // Components
 // =============================================================================
 var v1_component_renderer_1 = require("./components/v1-component-renderer");
-Object.defineProperty(exports, "V1ComponentRenderer", { enumerable: true, get: function () { return v1_component_renderer_1.V1ComponentRenderer; } });
+Object.defineProperty(exports, "ComponentRenderer", { enumerable: true, get: function () { return v1_component_renderer_1.ComponentRenderer; } });
 // =============================================================================
 // Hooks
 // =============================================================================
 var use_tambo_v1_1 = require("./hooks/use-tambo-v1");
-Object.defineProperty(exports, "useTamboV1", { enumerable: true, get: function () { return use_tambo_v1_1.useTamboV1; } });
+Object.defineProperty(exports, "useTambo", { enumerable: true, get: function () { return use_tambo_v1_1.useTambo; } });
 var use_tambo_v1_thread_input_1 = require("./hooks/use-tambo-v1-thread-input");
-Object.defineProperty(exports, "useTamboV1ThreadInput", { enumerable: true, get: function () { return use_tambo_v1_thread_input_1.useTamboV1ThreadInput; } });
+Object.defineProperty(exports, "useTamboThreadInput", { enumerable: true, get: function () { return use_tambo_v1_thread_input_1.useTamboThreadInput; } });
 var use_tambo_v1_thread_1 = require("./hooks/use-tambo-v1-thread");
-Object.defineProperty(exports, "useTamboV1Thread", { enumerable: true, get: function () { return use_tambo_v1_thread_1.useTamboV1Thread; } });
+Object.defineProperty(exports, "useTamboThread", { enumerable: true, get: function () { return use_tambo_v1_thread_1.useTamboThread; } });
 var use_tambo_v1_thread_list_1 = require("./hooks/use-tambo-v1-thread-list");
-Object.defineProperty(exports, "useTamboV1ThreadList", { enumerable: true, get: function () { return use_tambo_v1_thread_list_1.useTamboV1ThreadList; } });
+Object.defineProperty(exports, "useTamboThreadList", { enumerable: true, get: function () { return use_tambo_v1_thread_list_1.useTamboThreadList; } });
 var use_tambo_v1_component_state_1 = require("./hooks/use-tambo-v1-component-state");
-Object.defineProperty(exports, "useTamboV1ComponentState", { enumerable: true, get: function () { return use_tambo_v1_component_state_1.useTamboV1ComponentState; } });
+Object.defineProperty(exports, "useTamboComponentState", { enumerable: true, get: function () { return use_tambo_v1_component_state_1.useTamboComponentState; } });
 var use_tambo_v1_stream_status_1 = require("./hooks/use-tambo-v1-stream-status");
-Object.defineProperty(exports, "useTamboV1StreamStatus", { enumerable: true, get: function () { return use_tambo_v1_stream_status_1.useTamboV1StreamStatus; } });
+Object.defineProperty(exports, "useTamboStreamStatus", { enumerable: true, get: function () { return use_tambo_v1_stream_status_1.useTamboStreamStatus; } });
 var use_tambo_v1_suggestions_1 = require("./hooks/use-tambo-v1-suggestions");
-Object.defineProperty(exports, "useTamboV1Suggestions", { enumerable: true, get: function () { return use_tambo_v1_suggestions_1.useTamboV1Suggestions; } });
-// Re-export client hook from beta SDK (works with v1)
+Object.defineProperty(exports, "useTamboSuggestions", { enumerable: true, get: function () { return use_tambo_v1_suggestions_1.useTamboSuggestions; } });
+// Re-export client hook
 var tambo_client_provider_2 = require("../providers/tambo-client-provider");
 Object.defineProperty(exports, "useTamboClient", { enumerable: true, get: function () { return tambo_client_provider_2.useTamboClient; } });
 // Re-export image handling hook (pure React, API-agnostic)
@@ -127,7 +126,14 @@ Object.defineProperty(exports, "useMessageImages", { enumerable: true, get: func
 var use_tambo_voice_1 = require("../hooks/use-tambo-voice");
 Object.defineProperty(exports, "useTamboVoice", { enumerable: true, get: function () { return use_tambo_voice_1.useTamboVoice; } });
 // =============================================================================
-// Re-exports from Beta SDK (compatible with v1)
+// Message Context (for components rendered by the AI)
+// =============================================================================
+var use_tambo_current_message_1 = require("./hooks/use-tambo-current-message");
+Object.defineProperty(exports, "TamboMessageProvider", { enumerable: true, get: function () { return use_tambo_current_message_1.TamboMessageProvider; } });
+Object.defineProperty(exports, "useTamboCurrentMessage", { enumerable: true, get: function () { return use_tambo_current_message_1.useTamboCurrentMessage; } });
+Object.defineProperty(exports, "useTamboCurrentComponent", { enumerable: true, get: function () { return use_tambo_current_message_1.useTamboCurrentComponent; } });
+// =============================================================================
+// Re-exports from SDK
 // =============================================================================
 // Tool definition helper
 var registry_1 = require("../util/registry");
@@ -139,6 +145,10 @@ Object.defineProperty(exports, "currentTimeContextHelper", { enumerable: true, g
 // MCP server types
 var mcp_server_info_1 = require("../model/mcp-server-info");
 Object.defineProperty(exports, "MCPTransport", { enumerable: true, get: function () { return mcp_server_info_1.MCPTransport; } });
+// Component content context
+var component_renderer_1 = require("./utils/component-renderer");
+Object.defineProperty(exports, "ComponentContentProvider", { enumerable: true, get: function () { return component_renderer_1.ComponentContentProvider; } });
+Object.defineProperty(exports, "useComponentContent", { enumerable: true, get: function () { return component_renderer_1.useComponentContent; } });
 // =============================================================================
 // Interactable Components
 // =============================================================================

package/dist/v1/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;;;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,mEAKuC;AAJrC,oHAAA,eAAe,OAAA;AAEf,qHAAA,gBAAgB,OAAA;AAIlB,4DAA4D;AAC5D,gFAA6E;AAApE,gIAAA,qBAAqB,OAAA;AAE9B,0DAA0D;AAC1D,4EAG4C;AAF1C,4HAAA,mBAAmB,OAAA;AACnB,gIAAA,uBAAuB,OAAA;AAGzB,0DAA0D;AAC1D,8FAGqD;AAFnD,6IAAA,2BAA2B,OAAA;AAC3B,wIAAA,sBAAsB,OAAA;AAGxB,kEAAkE;AAClE,oGAA2F;AAAlF,8IAAA,yBAAyB,OAAA;AAElC,2DAA2D;AAC3D,6FAIoD;AAHlD,4IAAA,0BAA0B,OAAA;AAK5B,sCAAsC;AACtC,6EAG4C;AAF1C,6HAAA,mBAAmB,OAAA;AAIrB,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,4EAG4C;AAF1C,4HAAA,mBAAmB,OAAA;AAIrB,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,qDAAkD;AAAzC,0GAAA,UAAU,OAAA;AAMnB,+EAA0E;AAAjE,kIAAA,qBAAqB,OAAA;AAE9B,mEAA+D;AAAtD,uHAAA,gBAAgB,OAAA;AAEzB,6EAAwE;AAA/D,gIAAA,oBAAoB,OAAA;AAE7B,qFAAgF;AAAvE,wIAAA,wBAAwB,OAAA;AAEjC,iFAI4C;AAH1C,oIAAA,sBAAsB,OAAA;AAKxB,6EAK0C;AAJxC,iIAAA,qBAAqB,OAAA;AAMvB,sDAAsD;AACtD,4EAAoE;AAA3D,uHAAA,cAAc,OAAA;AAEvB,2DAA2D;AAC3D,kEAGqC;AAFnC,sHAAA,gBAAgB,OAAA;AAIlB,iEAAiE;AACjE,4DAAyD;AAAhD,gHAAA,aAAa,OAAA;AAEtB,gFAAgF;AAChF,gDAAgD;AAChD,gFAAgF;AAEhF,yBAAyB;AACzB,6CAA8C;AAArC,sGAAA,UAAU,OAAA;AAEnB,2BAA2B;AAC3B,sDAG4B;AAF1B,2HAAA,wBAAwB,OAAA;AACxB,2HAAA,wBAAwB,OAAA;AAqB1B,mBAAmB;AACnB,4DAAwD;AAA/C,+GAAA,YAAY,OAAA;AA+BrB,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,mDAAmD;AACnD,0EAIwC;AAHtC,gIAAA,qBAAqB,OAAA;AAKvB,8BAA8B;AAC9B,wFAGkD;AAFhD,mIAAA,oBAAoB,OAAA;AACpB,8IAAA,+BAA+B,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 * ## Authentication & Thread Ownership\n *\n * All thread operations require user identification. Provide ONE of:\n * - `userKey` - Direct user identifier (for server-side or trusted environments)\n * - `userToken` - OAuth bearer token containing the userKey (for client-side apps)\n *\n * Threads are scoped to the userKey - each user only sees their own threads.\n *\n * ## Quick Start\n *\n * ```tsx\n * import {\n *   TamboV1Provider,\n *   useTamboV1,\n *   useTamboV1ThreadInput,\n * } from '@tambo-ai/react/v1';\n *\n * function App() {\n *   return (\n *     <TamboV1Provider\n *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}\n *       userKey={currentUserId} // Required: identifies thread owner\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 { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);\n *\n *   const handleSubmit = async (e: React.FormEvent) => {\n *     e.preventDefault();\n *     const result = await submit();\n *     if (!threadId) setThreadId(result.threadId);\n *   };\n *\n *   return (\n *     <form onSubmit={handleSubmit}>\n *       {messages.map(msg => <Message key={msg.id} message={msg} />)}\n *       {isStreaming && <LoadingIndicator />}\n *       <input value={value} onChange={(e) => setValue(e.target.value)} />\n *       <button disabled={isPending}>Send</button>\n *     </form>\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  useTamboV1Config,\n  type TamboV1Config,\n} from \"./providers/tambo-v1-provider\";\n\n// Re-export registry provider from beta SDK (works with v1)\nexport { TamboRegistryProvider } from \"../providers/tambo-registry-provider\";\n\n// Re-export client provider from beta SDK (works with v1)\nexport {\n  TamboClientProvider,\n  useIsTamboTokenUpdating,\n} from \"../providers/tambo-client-provider\";\n\n// Re-export context helpers from beta SDK (works with v1)\nexport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"../providers/tambo-context-helpers-provider\";\n\n// Re-export context attachment hook from beta SDK (works with v1)\nexport { useTamboContextAttachment } from \"../providers/tambo-context-attachment-provider\";\n\n// Export v1 thread input provider for advanced composition\nexport {\n  TamboV1ThreadInputProvider,\n  type TamboV1ThreadInputContextProps,\n  type SubmitOptions,\n} from \"./providers/tambo-v1-thread-input-provider\";\n\n// Export v1 stub provider for testing\nexport {\n  TamboV1StubProvider,\n  type TamboV1StubProviderProps,\n} from \"./providers/tambo-v1-stub-provider\";\n\n// =============================================================================\n// Components\n// =============================================================================\n\nexport {\n  V1ComponentRenderer,\n  type V1ComponentRendererProps,\n} from \"./components/v1-component-renderer\";\n\n// =============================================================================\n// Hooks\n// =============================================================================\n\nexport { useTamboV1 } from \"./hooks/use-tambo-v1\";\n\nexport type { TamboV1AuthState } from \"./types/auth\";\n\nexport type { ToolChoice } from \"./types/tool-choice\";\n\nexport { useTamboV1ThreadInput } from \"./hooks/use-tambo-v1-thread-input\";\n\nexport { useTamboV1Thread } from \"./hooks/use-tambo-v1-thread\";\n\nexport { useTamboV1ThreadList } from \"./hooks/use-tambo-v1-thread-list\";\n\nexport { useTamboV1ComponentState } from \"./hooks/use-tambo-v1-component-state\";\n\nexport {\n  useTamboV1StreamStatus,\n  type StreamStatus,\n  type PropStatus,\n} from \"./hooks/use-tambo-v1-stream-status\";\n\nexport {\n  useTamboV1Suggestions,\n  type UseTamboV1SuggestionsOptions,\n  type UseTamboV1SuggestionsReturn,\n  type AcceptSuggestionOptions,\n} from \"./hooks/use-tambo-v1-suggestions\";\n\n// Re-export client hook from beta SDK (works with v1)\nexport { useTamboClient } from \"../providers/tambo-client-provider\";\n\n// Re-export image handling hook (pure React, API-agnostic)\nexport {\n  useMessageImages,\n  type StagedImage,\n} from \"../hooks/use-message-images\";\n\n// Re-export voice input hook (uses standalone transcription API)\nexport { useTamboVoice } from \"../hooks/use-tambo-voice\";\n\n// =============================================================================\n// Re-exports from Beta SDK (compatible with v1)\n// =============================================================================\n\n// Tool definition helper\nexport { defineTool } from \"../util/registry\";\n\n// Built-in context helpers\nexport {\n  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"../context-helpers\";\n\n// Context helper types\nexport type {\n  AdditionalContext,\n  ContextHelperFn,\n  ContextHelpers,\n} from \"../context-helpers\";\n\n// Component and tool types\nexport type {\n  ComponentContextToolMetadata,\n  ComponentRegistry,\n  ParameterSpec,\n  RegisteredComponent,\n  TamboComponent,\n  TamboTool,\n  ToolAnnotations,\n} from \"../model/component-metadata\";\n\n// MCP server types\nexport { MCPTransport } from \"../model/mcp-server-info\";\nexport type {\n  McpServerInfo,\n  NormalizedMcpServerInfo,\n} from \"../model/mcp-server-info\";\n\n// Resource types\nexport type {\n  ListResourceItem,\n  ReadResourceResult,\n  ResourceSource,\n} from \"../model/resource-info\";\n\n// Error types from Tambo TypeScript SDK\nexport type {\n  APIError,\n  RateLimitError,\n  TamboAIError,\n} from \"@tambo-ai/typescript-sdk\";\n\n// Suggestion types from Tambo TypeScript SDK\nexport type {\n  Suggestion,\n  SuggestionGenerateParams,\n  SuggestionGenerateResponse,\n  SuggestionListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/beta/threads/suggestions\";\n\n// V1 extended content types with computed state\nexport type { V1ToolUseContent, TamboToolDisplayProps } from \"./types/message\";\n\n// =============================================================================\n// Interactable Components\n// =============================================================================\n\n// HOC for making components interactable by the AI\nexport {\n  withTamboInteractable,\n  type InteractableConfig,\n  type WithTamboInteractableProps,\n} from \"../hoc/with-tambo-interactable\";\n\n// Interactable provider hooks\nexport {\n  useTamboInteractable,\n  useCurrentInteractablesSnapshot,\n} from \"../providers/tambo-interactable-provider\";\n\n// Interactable types\nexport type {\n  TamboInteractableComponent as InteractableComponent,\n  TamboInteractableContext,\n} from \"../model/tambo-interactable\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;;;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,mEAKuC;AAJrC,kHAAA,aAAa,OAAA;AAEb,mHAAA,cAAc,OAAA;AAIhB,8BAA8B;AAC9B,gFAA6E;AAApE,gIAAA,qBAAqB,OAAA;AAE9B,4BAA4B;AAC5B,4EAG4C;AAF1C,4HAAA,mBAAmB,OAAA;AACnB,gIAAA,uBAAuB,OAAA;AAGzB,4BAA4B;AAC5B,8FAGqD;AAFnD,6IAAA,2BAA2B,OAAA;AAC3B,wIAAA,sBAAsB,OAAA;AAGxB,oCAAoC;AACpC,oGAA2F;AAAlF,8IAAA,yBAAyB,OAAA;AAElC,wDAAwD;AACxD,6FAIoD;AAHlD,0IAAA,wBAAwB,OAAA;AAK1B,mCAAmC;AACnC,6EAG4C;AAF1C,2HAAA,iBAAiB,OAAA;AAInB,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,4EAG4C;AAF1C,0HAAA,iBAAiB,OAAA;AAInB,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,qDAAqE;AAA5D,wGAAA,QAAQ,OAAA;AAMjB,+EAAwE;AAA/D,gIAAA,mBAAmB,OAAA;AAE5B,mEAA6D;AAApD,qHAAA,cAAc,OAAA;AAEvB,6EAAsE;AAA7D,8HAAA,kBAAkB,OAAA;AAE3B,qFAA8E;AAArE,sIAAA,sBAAsB,OAAA;AAE/B,iFAI4C;AAH1C,kIAAA,oBAAoB,OAAA;AAKtB,6EAK0C;AAJxC,+HAAA,mBAAmB,OAAA;AAMrB,wBAAwB;AACxB,4EAAoE;AAA3D,uHAAA,cAAc,OAAA;AAEvB,2DAA2D;AAC3D,kEAGqC;AAFnC,sHAAA,gBAAgB,OAAA;AAIlB,iEAAiE;AACjE,4DAAyD;AAAhD,gHAAA,aAAa,OAAA;AAEtB,gFAAgF;AAChF,sDAAsD;AACtD,gFAAgF;AAEhF,+EAK2C;AAJzC,iIAAA,oBAAoB,OAAA;AACpB,mIAAA,sBAAsB,OAAA;AACtB,qIAAA,wBAAwB,OAAA;AAI1B,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,yBAAyB;AACzB,6CAA8C;AAArC,sGAAA,UAAU,OAAA;AAEnB,2BAA2B;AAC3B,sDAG4B;AAF1B,2HAAA,wBAAwB,OAAA;AACxB,2HAAA,wBAAwB,OAAA;AAqB1B,mBAAmB;AACnB,4DAAwD;AAA/C,+GAAA,YAAY,OAAA;AA8DrB,4BAA4B;AAC5B,iEAIoC;AAHlC,8HAAA,wBAAwB,OAAA;AACxB,yHAAA,mBAAmB,OAAA;AAIrB,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,mDAAmD;AACnD,0EAIwC;AAHtC,gIAAA,qBAAqB,OAAA;AAKvB,8BAA8B;AAC9B,wFAGkD;AAFhD,mIAAA,oBAAoB,OAAA;AACpB,8IAAA,+BAA+B,OAAA","sourcesContent":["/**\n * `@tambo-ai/react` - React SDK for Tambo AI\n *\n * Provides React hooks and providers for building AI-powered applications\n * using the streaming API with AG-UI protocol.\n *\n * ## Authentication & Thread Ownership\n *\n * All thread operations require user identification. Provide ONE of:\n * - `userKey` - Direct user identifier (for server-side or trusted environments)\n * - `userToken` - OAuth bearer token containing the userKey (for client-side apps)\n *\n * Threads are scoped to the userKey - each user only sees their own threads.\n *\n * ## Quick Start\n *\n * ```tsx\n * import {\n *   TamboProvider,\n *   useTambo,\n *   useTamboThreadInput,\n * } from '@tambo-ai/react';\n *\n * function App() {\n *   return (\n *     <TamboProvider\n *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}\n *       userKey={currentUserId} // Required: identifies thread owner\n *       components={[WeatherCard]}\n *       tools={[searchTool]}\n *     >\n *       <ChatInterface />\n *     </TamboProvider>\n *   );\n * }\n *\n * function ChatInterface() {\n *   const [threadId, setThreadId] = useState<string>();\n *   const { messages, isStreaming } = useTambo();\n *   const { value, setValue, submit, isPending } = useTamboThreadInput();\n *\n *   const handleSubmit = async (e: React.FormEvent) => {\n *     e.preventDefault();\n *     const result = await submit();\n *     if (!threadId) setThreadId(result.threadId);\n *   };\n *\n *   return (\n *     <form onSubmit={handleSubmit}>\n *       {messages.map(msg => <Message key={msg.id} message={msg} />)}\n *       {isStreaming && <LoadingIndicator />}\n *       <input value={value} onChange={(e) => setValue(e.target.value)} />\n *       <button disabled={isPending}>Send</button>\n *     </form>\n *   );\n * }\n * ```\n *\n * ## Type Imports\n *\n * Types are imported directly:\n * - Thread state: `import type { TamboThread } from '@tambo-ai/react'`\n * - Messages: `import type { TamboThreadMessage } from '@tambo-ai/react'`\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  TamboProvider,\n  type TamboProviderProps,\n  useTamboConfig,\n  type TamboConfig,\n} from \"./providers/tambo-v1-provider\";\n\n// Re-export registry provider\nexport { TamboRegistryProvider } from \"../providers/tambo-registry-provider\";\n\n// Re-export client provider\nexport {\n  TamboClientProvider,\n  useIsTamboTokenUpdating,\n} from \"../providers/tambo-client-provider\";\n\n// Re-export context helpers\nexport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"../providers/tambo-context-helpers-provider\";\n\n// Re-export context attachment hook\nexport { useTamboContextAttachment } from \"../providers/tambo-context-attachment-provider\";\n\n// Export thread input provider for advanced composition\nexport {\n  TamboThreadInputProvider,\n  type TamboThreadInputContextProps,\n  type SubmitOptions,\n} from \"./providers/tambo-v1-thread-input-provider\";\n\n// Export stub provider for testing\nexport {\n  TamboStubProvider,\n  type TamboStubProviderProps,\n} from \"./providers/tambo-v1-stub-provider\";\n\n// =============================================================================\n// Components\n// =============================================================================\n\nexport {\n  ComponentRenderer,\n  type ComponentRendererProps,\n} from \"./components/v1-component-renderer\";\n\n// =============================================================================\n// Hooks\n// =============================================================================\n\nexport { useTambo, type UseTamboReturn } from \"./hooks/use-tambo-v1\";\n\nexport type { TamboAuthState } from \"./types/auth\";\n\nexport type { ToolChoice } from \"./types/tool-choice\";\n\nexport { useTamboThreadInput } from \"./hooks/use-tambo-v1-thread-input\";\n\nexport { useTamboThread } from \"./hooks/use-tambo-v1-thread\";\n\nexport { useTamboThreadList } from \"./hooks/use-tambo-v1-thread-list\";\n\nexport { useTamboComponentState } from \"./hooks/use-tambo-v1-component-state\";\n\nexport {\n  useTamboStreamStatus,\n  type StreamStatus,\n  type PropStatus,\n} from \"./hooks/use-tambo-v1-stream-status\";\n\nexport {\n  useTamboSuggestions,\n  type UseTamboSuggestionsOptions,\n  type UseTamboSuggestionsReturn,\n  type AcceptSuggestionOptions,\n} from \"./hooks/use-tambo-v1-suggestions\";\n\n// Re-export client hook\nexport { useTamboClient } from \"../providers/tambo-client-provider\";\n\n// Re-export image handling hook (pure React, API-agnostic)\nexport {\n  useMessageImages,\n  type StagedImage,\n} from \"../hooks/use-message-images\";\n\n// Re-export voice input hook (uses standalone transcription API)\nexport { useTamboVoice } from \"../hooks/use-tambo-voice\";\n\n// =============================================================================\n// Message Context (for components rendered by the AI)\n// =============================================================================\n\nexport {\n  TamboMessageProvider,\n  useTamboCurrentMessage,\n  useTamboCurrentComponent,\n  type TamboCurrentComponent,\n} from \"./hooks/use-tambo-current-message\";\n\n// =============================================================================\n// Re-exports from SDK\n// =============================================================================\n\n// Tool definition helper\nexport { defineTool } from \"../util/registry\";\n\n// Built-in context helpers\nexport {\n  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"../context-helpers\";\n\n// Context helper types\nexport type {\n  AdditionalContext,\n  ContextHelperFn,\n  ContextHelpers,\n} from \"../context-helpers\";\n\n// Component and tool types\nexport type {\n  ComponentContextToolMetadata,\n  ComponentRegistry,\n  ParameterSpec,\n  RegisteredComponent,\n  TamboComponent,\n  TamboTool,\n  ToolAnnotations,\n} from \"../model/component-metadata\";\n\n// MCP server types\nexport { MCPTransport } from \"../model/mcp-server-info\";\nexport type {\n  McpServerInfo,\n  NormalizedMcpServerInfo,\n} from \"../model/mcp-server-info\";\n\n// Resource types\nexport type {\n  ListResourceItem,\n  ReadResourceResult,\n  ResourceSource,\n} from \"../model/resource-info\";\n\n// Error types from Tambo TypeScript SDK\nexport type {\n  APIError,\n  RateLimitError,\n  TamboAIError,\n} from \"@tambo-ai/typescript-sdk\";\n\n// Suggestion types from Tambo TypeScript SDK\nexport type {\n  Suggestion,\n  SuggestionGenerateParams,\n  SuggestionGenerateResponse,\n  SuggestionListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/beta/threads/suggestions\";\n\n// Extended content types with computed state\nexport type {\n  TamboToolUseContent,\n  TamboToolDisplayProps,\n} from \"./types/message\";\n\n// Thread message type\nexport type { TamboThreadMessage } from \"./types/message\";\n\n// Content types\nexport type {\n  Content,\n  TamboComponentContent,\n  ComponentStreamingState,\n  MessageRole,\n  TextContent,\n  ToolResultContent,\n  ResourceContent,\n  InputMessage,\n  InitialInputMessage,\n  MessageListResponse,\n  MessageGetResponse,\n} from \"./types/message\";\n\n// Thread types\nexport type {\n  TamboThread,\n  RunStatus,\n  StreamingState,\n  ThreadCreateResponse,\n  ThreadRetrieveResponse,\n  ThreadListResponse,\n} from \"./types/thread\";\n\n// Component content context\nexport {\n  ComponentContentProvider,\n  useComponentContent,\n  type ComponentContentContext,\n} from \"./utils/component-renderer\";\n\n// =============================================================================\n// Interactable Components\n// =============================================================================\n\n// HOC for making components interactable by the AI\nexport {\n  withTamboInteractable,\n  type InteractableConfig,\n  type WithTamboInteractableProps,\n} from \"../hoc/with-tambo-interactable\";\n\n// Interactable provider hooks\nexport {\n  useTamboInteractable,\n  useCurrentInteractablesSnapshot,\n} from \"../providers/tambo-interactable-provider\";\n\n// Interactable types\nexport type {\n  TamboInteractableComponent as InteractableComponent,\n  TamboInteractableContext,\n} from \"../model/tambo-interactable\";\n"]}

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

@@ -1,7 +1,7 @@
 /**
- * TamboV1Provider - Main Provider for v1 API
+ * TamboProvider - Main Provider
  *
- * Composes the necessary providers for the v1 SDK:
+ * Composes the necessary providers for the SDK:
  * - TamboClientProvider: API client and authentication
  * - TamboRegistryProvider: Component and tool registration
  * - TamboContextHelpersProvider: Context helper functions
@@ -9,10 +9,10 @@
  * - TamboMcpProvider: MCP server connections and tool discovery
  * - TamboContextAttachmentProvider: Single-message context attachments
  * - TamboInteractableProvider: Interactive component tracking
- * - TamboV1StreamProvider: Streaming state management
+ * - TamboStreamProvider: Streaming state management
  *
  * This provider should wrap your entire application or the portion
- * that needs access to Tambo v1 functionality.
+ * that needs access to Tambo functionality.
  */
 import React, { type PropsWithChildren } from "react";
 import { type TamboClientProviderProps } from "../../providers/tambo-client-provider";
@@ -22,10 +22,10 @@ import type { McpServerInfo } from "../../model/mcp-server-info";
 import type { ListResourceItem, ResourceSource } from "../../model/resource-info";
 import type { InitialInputMessage } from "../types/message";
 /**
- * Configuration values for v1 SDK.
+ * Configuration values for the SDK.
  * These are static values that don't change during the session.
  */
-export interface TamboV1Config {
+export interface TamboConfig {
     /** User key for thread ownership and scoping */
     userKey?: string;
     /** Whether to automatically generate thread names after a threshold of messages. Defaults to true. */
@@ -39,20 +39,20 @@ export interface TamboV1Config {
     initialMessages?: InitialInputMessage[];
 }
 /**
- * Context for v1 SDK configuration.
+ * Context for SDK configuration.
  * @internal
  */
-export declare const TamboV1ConfigContext: React.Context<TamboV1Config | null>;
+export declare const TamboConfigContext: React.Context<TamboConfig | null>;
 /**
- * Hook to access v1 SDK configuration.
+ * Hook to access SDK configuration.
  * @returns Configuration values including userKey
- * @throws {Error} If used outside TamboV1Provider
+ * @throws {Error} If used outside TamboProvider
  */
-export declare function useTamboV1Config(): TamboV1Config;
+export declare function useTamboConfig(): TamboConfig;
 /**
- * Props for TamboV1Provider
+ * Props for TamboProvider
  */
-export interface TamboV1ProviderProps extends Pick<TamboClientProviderProps, "apiKey" | "tamboUrl" | "environment" | "userToken"> {
+export interface TamboProviderProps extends Pick<TamboClientProviderProps, "apiKey" | "tamboUrl" | "environment" | "userToken"> {
     /**
      * Components to register with the registry.
      * These will be available for the AI to use in responses.
@@ -128,12 +128,12 @@ export interface TamboV1ProviderProps extends Pick<TamboClientProviderProps, "ap
     children: React.ReactNode;
 }
 /**
- * Main provider for the Tambo v1 SDK.
+ * Main provider for the Tambo SDK.
  *
- * Composes TamboClientProvider, TamboRegistryProvider, and TamboV1StreamProvider
+ * Composes TamboClientProvider, TamboRegistryProvider, and TamboStreamProvider
  * to provide a complete context for building AI-powered applications.
  *
- * Threads are managed dynamically through useTamboV1() hook functions:
+ * Threads are managed dynamically through useTambo() hook functions:
  * - startNewThread() - Begin a new conversation
  * - switchThread(threadId) - Switch to an existing thread
  * - initThread(threadId) - Initialize a thread for receiving events
@@ -157,20 +157,20 @@ export interface TamboV1ProviderProps extends Pick<TamboClientProviderProps, "ap
  * @returns Provider component tree
  * @example
  * ```tsx
- * import { TamboV1Provider } from '@tambo-ai/react/v1';
+ * import { TamboProvider } from '@tambo-ai/react';
  *
  * function App() {
  *   return (
- *     <TamboV1Provider
+ *     <TamboProvider
  *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
  *       components={[WeatherCard, StockChart]}
  *       tools={[searchTool, calculatorTool]}
  *     >
  *       <ChatInterface />
- *     </TamboV1Provider>
+ *     </TamboProvider>
  *   );
  * }
  * ```
  */
-export declare function TamboV1Provider({ apiKey, tamboUrl, environment, userToken, components, tools, mcpServers, onCallUnregisteredTool, resources, listResources, getResource, contextHelpers, userKey, autoGenerateThreadName, autoGenerateNameThreshold, initialMessages, children, }: PropsWithChildren<TamboV1ProviderProps>): React.JSX.Element;
+export declare function TamboProvider({ apiKey, tamboUrl, environment, userToken, components, tools, mcpServers, onCallUnregisteredTool, resources, listResources, getResource, contextHelpers, userKey, autoGenerateThreadName, autoGenerateNameThreshold, initialMessages, children, }: PropsWithChildren<TamboProviderProps>): React.JSX.Element;
 //# sourceMappingURL=tambo-v1-provider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tambo-v1-provider.d.ts","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,EAIZ,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,yCAAyC,CAAC;AAMjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAI5D;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sGAAsG;IACtG,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,kGAAkG;IAClG,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACzC;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,qCAA4C,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAMhD;AAED;;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,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE/B;;;;OAIG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IAEhD;;;;OAIG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAE5C;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAExC;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,QAAQ,EACR,WAAW,EACX,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,WAAW,EACX,cAAc,EACd,OAAO,EACP,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,QAAQ,GACT,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,qBA8CzC"}
+{"version":3,"file":"tambo-v1-provider.d.ts","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,EAIZ,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,yCAAyC,CAAC;AAMjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAI5D;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sGAAsG;IACtG,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,kGAAkG;IAClG,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;;OAGG;IACH,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACzC;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,mCAA0C,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAM5C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAC9C,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,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE/B;;;;OAIG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IAEhD;;;;OAIG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAE5C;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC;;;;OAIG;IACH,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAExC;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,WAAW,EACX,SAAS,EACT,UAAU,EACV,KAAK,EACL,UAAU,EACV,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,WAAW,EACX,cAAc,EACd,OAAO,EACP,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EACf,QAAQ,GACT,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,qBA+CvC"}

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

@@ -34,13 +34,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TamboV1ConfigContext = void 0;
-exports.useTamboV1Config = useTamboV1Config;
-exports.TamboV1Provider = TamboV1Provider;
+exports.TamboConfigContext = void 0;
+exports.useTamboConfig = useTamboConfig;
+exports.TamboProvider = TamboProvider;
 /**
- * TamboV1Provider - Main Provider for v1 API
+ * TamboProvider - Main Provider
  *
- * Composes the necessary providers for the v1 SDK:
+ * Composes the necessary providers for the SDK:
  * - TamboClientProvider: API client and authentication
  * - TamboRegistryProvider: Component and tool registration
  * - TamboContextHelpersProvider: Context helper functions
@@ -48,10 +48,10 @@ exports.TamboV1Provider = TamboV1Provider;
  * - TamboMcpProvider: MCP server connections and tool discovery
  * - TamboContextAttachmentProvider: Single-message context attachments
  * - TamboInteractableProvider: Interactive component tracking
- * - TamboV1StreamProvider: Streaming state management
+ * - TamboStreamProvider: Streaming state management
  *
  * This provider should wrap your entire application or the portion
- * that needs access to Tambo v1 functionality.
+ * that needs access to Tambo functionality.
  */
 const react_1 = __importStar(require("react"));
 const use_tambo_v1_auth_state_1 = require("../hooks/use-tambo-v1-auth-state");
@@ -65,54 +65,54 @@ const tambo_mcp_provider_1 = require("../../mcp/tambo-mcp-provider");
 const tambo_v1_stream_context_1 = require("./tambo-v1-stream-context");
 const tambo_v1_thread_input_provider_1 = require("./tambo-v1-thread-input-provider");
 /**
- * Context for v1 SDK configuration.
+ * Context for SDK configuration.
  * @internal
  */
-exports.TamboV1ConfigContext = (0, react_1.createContext)(null);
+exports.TamboConfigContext = (0, react_1.createContext)(null);
 /**
- * Hook to access v1 SDK configuration.
+ * Hook to access SDK configuration.
  * @returns Configuration values including userKey
- * @throws {Error} If used outside TamboV1Provider
+ * @throws {Error} If used outside TamboProvider
  */
-function useTamboV1Config() {
-    const config = (0, react_1.useContext)(exports.TamboV1ConfigContext);
+function useTamboConfig() {
+    const config = (0, react_1.useContext)(exports.TamboConfigContext);
     if (!config) {
-        throw new Error("useTamboV1Config must be used within TamboV1Provider");
+        throw new Error("useTamboConfig must be used within TamboProvider");
     }
     return config;
 }
 /**
  * Internal component that emits console warnings for auth misconfiguration.
  * Rendered inside the provider tree so both TamboClientContext and
- * TamboV1ConfigContext are available.
+ * TamboConfigContext are available.
  */
-function TamboV1AuthWarnings() {
-    const authState = (0, use_tambo_v1_auth_state_1.useTamboV1AuthState)();
+function TamboAuthWarnings() {
+    const authState = (0, use_tambo_v1_auth_state_1.useTamboAuthState)();
     const authError = authState.status === "error" ? authState.error : null;
     (0, react_1.useEffect)(() => {
         switch (authState.status) {
             case "unauthenticated":
-                console.warn("[TamboV1Provider] Neither userKey nor userToken provided. " +
+                console.warn("[TamboProvider] Neither userKey nor userToken provided. " +
                     "API requests will be blocked until authentication is configured.");
                 break;
             case "invalid":
-                console.warn("[TamboV1Provider] Both userKey and userToken were provided. " +
+                console.warn("[TamboProvider] Both userKey and userToken were provided. " +
                     "You must provide one or the other, not both.");
                 break;
             case "error":
-                console.warn("[TamboV1Provider] Token exchange failed:", authError);
+                console.warn("[TamboProvider] Token exchange failed:", authError);
                 break;
         }
     }, [authState.status, authError]);
     return null;
 }
 /**
- * Main provider for the Tambo v1 SDK.
+ * Main provider for the Tambo SDK.
  *
- * Composes TamboClientProvider, TamboRegistryProvider, and TamboV1StreamProvider
+ * Composes TamboClientProvider, TamboRegistryProvider, and TamboStreamProvider
  * to provide a complete context for building AI-powered applications.
  *
- * Threads are managed dynamically through useTamboV1() hook functions:
+ * Threads are managed dynamically through useTambo() hook functions:
  * - startNewThread() - Begin a new conversation
  * - switchThread(threadId) - Switch to an existing thread
  * - initThread(threadId) - Initialize a thread for receiving events
@@ -136,22 +136,22 @@ function TamboV1AuthWarnings() {
  * @returns Provider component tree
  * @example
  * ```tsx
- * import { TamboV1Provider } from '@tambo-ai/react/v1';
+ * import { TamboProvider } from '@tambo-ai/react';
  *
  * function App() {
  *   return (
- *     <TamboV1Provider
+ *     <TamboProvider
  *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
  *       components={[WeatherCard, StockChart]}
  *       tools={[searchTool, calculatorTool]}
  *     >
  *       <ChatInterface />
- *     </TamboV1Provider>
+ *     </TamboProvider>
  *   );
  * }
  * ```
  */
-function TamboV1Provider({ apiKey, tamboUrl, environment, userToken, components, tools, mcpServers, onCallUnregisteredTool, resources, listResources, getResource, contextHelpers, userKey, autoGenerateThreadName, autoGenerateNameThreshold, initialMessages, children, }) {
+function TamboProvider({ apiKey, tamboUrl, environment, userToken, components, tools, mcpServers, onCallUnregisteredTool, resources, listResources, getResource, contextHelpers, userKey, autoGenerateThreadName, autoGenerateNameThreshold, initialMessages, children, }) {
     // Config is static - created once and never changes
     const config = {
         userKey,
@@ -159,16 +159,16 @@ function TamboV1Provider({ apiKey, tamboUrl, environment, userToken, components,
         autoGenerateNameThreshold,
         initialMessages,
     };
-    return (react_1.default.createElement(tambo_client_provider_1.TamboClientProvider, { apiKey: apiKey, tamboUrl: tamboUrl, environment: environment, userToken: userToken },
+    return (react_1.default.createElement(tambo_client_provider_1.TamboClientProvider, { apiKey: apiKey, tamboUrl: tamboUrl, environment: environment, userToken: userToken, userKey: userKey },
         react_1.default.createElement(tambo_registry_provider_1.TamboRegistryProvider, { components: components, tools: tools, mcpServers: mcpServers, onCallUnregisteredTool: onCallUnregisteredTool, resources: resources, listResources: listResources, getResource: getResource },
             react_1.default.createElement(tambo_context_helpers_provider_1.TamboContextHelpersProvider, { contextHelpers: contextHelpers },
                 react_1.default.createElement(tambo_mcp_token_provider_1.TamboMcpTokenProvider, null,
                     react_1.default.createElement(tambo_mcp_provider_1.TamboMcpProvider, null,
                         react_1.default.createElement(tambo_context_attachment_provider_1.TamboContextAttachmentProvider, null,
                             react_1.default.createElement(tambo_interactable_provider_1.TamboInteractableProvider, null,
-                                react_1.default.createElement(exports.TamboV1ConfigContext.Provider, { value: config },
-                                    react_1.default.createElement(TamboV1AuthWarnings, null),
-                                    react_1.default.createElement(tambo_v1_stream_context_1.TamboV1StreamProvider, { initialMessages: initialMessages },
-                                        react_1.default.createElement(tambo_v1_thread_input_provider_1.TamboV1ThreadInputProvider, null, children)))))))))));
+                                react_1.default.createElement(exports.TamboConfigContext.Provider, { value: config },
+                                    react_1.default.createElement(TamboAuthWarnings, null),
+                                    react_1.default.createElement(tambo_v1_stream_context_1.TamboStreamProvider, { initialMessages: initialMessages },
+                                        react_1.default.createElement(tambo_v1_thread_input_provider_1.TamboThreadInputProvider, null, children)))))))))));
 }
 //# sourceMappingURL=tambo-v1-provider.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tambo-v1-provider.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.tsx"],"names":[],"mappings":"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","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 * - TamboContextHelpersProvider: Context helper functions\n * - TamboMcpTokenProvider: MCP access token management\n * - TamboMcpProvider: MCP server connections and tool discovery\n * - TamboContextAttachmentProvider: Single-message context attachments\n * - TamboInteractableProvider: Interactive component tracking\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, {\n  createContext,\n  useContext,\n  useEffect,\n  type PropsWithChildren,\n} from \"react\";\nimport { useTamboV1AuthState } from \"../hooks/use-tambo-v1-auth-state\";\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 { TamboContextAttachmentProvider } from \"../../providers/tambo-context-attachment-provider\";\nimport { TamboContextHelpersProvider } from \"../../providers/tambo-context-helpers-provider\";\nimport { TamboInteractableProvider } from \"../../providers/tambo-interactable-provider\";\nimport { TamboMcpTokenProvider } from \"../../providers/tambo-mcp-token-provider\";\nimport { TamboMcpProvider } from \"../../mcp/tambo-mcp-provider\";\nimport type { ContextHelpers } from \"../../context-helpers\";\nimport type { McpServerInfo } from \"../../model/mcp-server-info\";\nimport type {\n  ListResourceItem,\n  ResourceSource,\n} from \"../../model/resource-info\";\nimport type { InitialInputMessage } from \"../types/message\";\nimport { TamboV1StreamProvider } from \"./tambo-v1-stream-context\";\nimport { TamboV1ThreadInputProvider } from \"./tambo-v1-thread-input-provider\";\n\n/**\n * Configuration values for v1 SDK.\n * These are static values that don't change during the session.\n */\nexport interface TamboV1Config {\n  /** User key for thread ownership and scoping */\n  userKey?: string;\n  /** Whether to automatically generate thread names after a threshold of messages. Defaults to true. */\n  autoGenerateThreadName?: boolean;\n  /** The message count threshold at which the thread name will be auto-generated. Defaults to 3. */\n  autoGenerateNameThreshold?: number;\n  /**\n   * Initial messages to seed new threads with.\n   * These are displayed in the UI immediately and sent to the API on first message.\n   */\n  initialMessages?: InitialInputMessage[];\n}\n\n/**\n * Context for v1 SDK configuration.\n * @internal\n */\nexport const TamboV1ConfigContext = createContext<TamboV1Config | null>(null);\n\n/**\n * Hook to access v1 SDK configuration.\n * @returns Configuration values including userKey\n * @throws {Error} If used outside TamboV1Provider\n */\nexport function useTamboV1Config(): TamboV1Config {\n  const config = useContext(TamboV1ConfigContext);\n  if (!config) {\n    throw new Error(\"useTamboV1Config must be used within TamboV1Provider\");\n  }\n  return config;\n}\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   * Static resources to register with the registry.\n   * These will be available for the AI to access.\n   */\n  resources?: ListResourceItem[];\n\n  /**\n   * Dynamic resource search function.\n   * Must be paired with getResource.\n   * Called when searching for resources dynamically.\n   */\n  listResources?: ResourceSource[\"listResources\"];\n\n  /**\n   * Dynamic resource fetch function.\n   * Must be paired with listResources.\n   * Called when fetching a specific resource by URI.\n   */\n  getResource?: ResourceSource[\"getResource\"];\n\n  /**\n   * Configuration for context helpers.\n   * A dictionary of functions that provide additional context to the AI.\n   * Each key becomes the context name, and the function returns the value.\n   */\n  contextHelpers?: ContextHelpers;\n\n  /**\n   * User key for thread ownership and scoping.\n   *\n   * **Required**: You must provide either `userKey` OR `userToken` (which contains a userKey).\n   * All thread operations (create, list, fetch) only return threads owned by this userKey.\n   *\n   * - Use `userKey` for server-side or trusted environments where you control the user identity\n   * - Use `userToken` (OAuth bearer token) for client-side apps where the token contains the userKey\n   */\n  userKey?: string;\n\n  /**\n   * Whether to automatically generate thread names after a threshold of messages.\n   * Defaults to true.\n   */\n  autoGenerateThreadName?: boolean;\n\n  /**\n   * The message count threshold at which the thread name will be auto-generated.\n   * Defaults to 3.\n   */\n  autoGenerateNameThreshold?: number;\n\n  /**\n   * Initial messages to seed new threads with.\n   * These are displayed in the UI immediately (before the first API call)\n   * and sent to the API when the first message is sent to create the thread.\n   */\n  initialMessages?: InitialInputMessage[];\n\n  /**\n   * Children components\n   */\n  children: React.ReactNode;\n}\n\n/**\n * Internal component that emits console warnings for auth misconfiguration.\n * Rendered inside the provider tree so both TamboClientContext and\n * TamboV1ConfigContext are available.\n */\nfunction TamboV1AuthWarnings(): null {\n  const authState = useTamboV1AuthState();\n  const authError = authState.status === \"error\" ? authState.error : null;\n\n  useEffect(() => {\n    switch (authState.status) {\n      case \"unauthenticated\":\n        console.warn(\n          \"[TamboV1Provider] Neither userKey nor userToken provided. \" +\n            \"API requests will be blocked until authentication is configured.\",\n        );\n        break;\n      case \"invalid\":\n        console.warn(\n          \"[TamboV1Provider] Both userKey and userToken were provided. \" +\n            \"You must provide one or the other, not both.\",\n        );\n        break;\n      case \"error\":\n        console.warn(\"[TamboV1Provider] Token exchange failed:\", authError);\n        break;\n    }\n  }, [authState.status, authError]);\n\n  return null;\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.resources - Static resources to register with the AI\n * @param props.listResources - Dynamic resource search function (must be paired with getResource)\n * @param props.getResource - Dynamic resource fetch function (must be paired with listResources)\n * @param props.contextHelpers - Configuration for context helper functions\n * @param props.userKey - User key for thread ownership (required if not using userToken)\n * @param props.autoGenerateThreadName - Whether to automatically generate thread names. Defaults to true.\n * @param props.autoGenerateNameThreshold - The message count threshold at which the thread name will be auto-generated. Defaults to 3.\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  resources,\n  listResources,\n  getResource,\n  contextHelpers,\n  userKey,\n  autoGenerateThreadName,\n  autoGenerateNameThreshold,\n  initialMessages,\n  children,\n}: PropsWithChildren<TamboV1ProviderProps>) {\n  // Config is static - created once and never changes\n  const config: TamboV1Config = {\n    userKey,\n    autoGenerateThreadName,\n    autoGenerateNameThreshold,\n    initialMessages,\n  };\n\n  return (\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        resources={resources}\n        listResources={listResources}\n        getResource={getResource}\n      >\n        <TamboContextHelpersProvider contextHelpers={contextHelpers}>\n          <TamboMcpTokenProvider>\n            <TamboMcpProvider>\n              <TamboContextAttachmentProvider>\n                <TamboInteractableProvider>\n                  <TamboV1ConfigContext.Provider value={config}>\n                    <TamboV1AuthWarnings />\n                    <TamboV1StreamProvider initialMessages={initialMessages}>\n                      <TamboV1ThreadInputProvider>\n                        {children}\n                      </TamboV1ThreadInputProvider>\n                    </TamboV1StreamProvider>\n                  </TamboV1ConfigContext.Provider>\n                </TamboInteractableProvider>\n              </TamboContextAttachmentProvider>\n            </TamboMcpProvider>\n          </TamboMcpTokenProvider>\n        </TamboContextHelpersProvider>\n      </TamboRegistryProvider>\n    </TamboClientProvider>\n  );\n}\n"]}
+{"version":3,"file":"tambo-v1-provider.js","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * TamboProvider - Main Provider\n *\n * Composes the necessary providers for the SDK:\n * - TamboClientProvider: API client and authentication\n * - TamboRegistryProvider: Component and tool registration\n * - TamboContextHelpersProvider: Context helper functions\n * - TamboMcpTokenProvider: MCP access token management\n * - TamboMcpProvider: MCP server connections and tool discovery\n * - TamboContextAttachmentProvider: Single-message context attachments\n * - TamboInteractableProvider: Interactive component tracking\n * - TamboStreamProvider: Streaming state management\n *\n * This provider should wrap your entire application or the portion\n * that needs access to Tambo functionality.\n */\n\nimport React, {\n  createContext,\n  useContext,\n  useEffect,\n  type PropsWithChildren,\n} from \"react\";\nimport { useTamboAuthState } from \"../hooks/use-tambo-v1-auth-state\";\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 { TamboContextAttachmentProvider } from \"../../providers/tambo-context-attachment-provider\";\nimport { TamboContextHelpersProvider } from \"../../providers/tambo-context-helpers-provider\";\nimport { TamboInteractableProvider } from \"../../providers/tambo-interactable-provider\";\nimport { TamboMcpTokenProvider } from \"../../providers/tambo-mcp-token-provider\";\nimport { TamboMcpProvider } from \"../../mcp/tambo-mcp-provider\";\nimport type { ContextHelpers } from \"../../context-helpers\";\nimport type { McpServerInfo } from \"../../model/mcp-server-info\";\nimport type {\n  ListResourceItem,\n  ResourceSource,\n} from \"../../model/resource-info\";\nimport type { InitialInputMessage } from \"../types/message\";\nimport { TamboStreamProvider } from \"./tambo-v1-stream-context\";\nimport { TamboThreadInputProvider } from \"./tambo-v1-thread-input-provider\";\n\n/**\n * Configuration values for the SDK.\n * These are static values that don't change during the session.\n */\nexport interface TamboConfig {\n  /** User key for thread ownership and scoping */\n  userKey?: string;\n  /** Whether to automatically generate thread names after a threshold of messages. Defaults to true. */\n  autoGenerateThreadName?: boolean;\n  /** The message count threshold at which the thread name will be auto-generated. Defaults to 3. */\n  autoGenerateNameThreshold?: number;\n  /**\n   * Initial messages to seed new threads with.\n   * These are displayed in the UI immediately and sent to the API on first message.\n   */\n  initialMessages?: InitialInputMessage[];\n}\n\n/**\n * Context for SDK configuration.\n * @internal\n */\nexport const TamboConfigContext = createContext<TamboConfig | null>(null);\n\n/**\n * Hook to access SDK configuration.\n * @returns Configuration values including userKey\n * @throws {Error} If used outside TamboProvider\n */\nexport function useTamboConfig(): TamboConfig {\n  const config = useContext(TamboConfigContext);\n  if (!config) {\n    throw new Error(\"useTamboConfig must be used within TamboProvider\");\n  }\n  return config;\n}\n\n/**\n * Props for TamboProvider\n */\nexport interface TamboProviderProps 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   * Static resources to register with the registry.\n   * These will be available for the AI to access.\n   */\n  resources?: ListResourceItem[];\n\n  /**\n   * Dynamic resource search function.\n   * Must be paired with getResource.\n   * Called when searching for resources dynamically.\n   */\n  listResources?: ResourceSource[\"listResources\"];\n\n  /**\n   * Dynamic resource fetch function.\n   * Must be paired with listResources.\n   * Called when fetching a specific resource by URI.\n   */\n  getResource?: ResourceSource[\"getResource\"];\n\n  /**\n   * Configuration for context helpers.\n   * A dictionary of functions that provide additional context to the AI.\n   * Each key becomes the context name, and the function returns the value.\n   */\n  contextHelpers?: ContextHelpers;\n\n  /**\n   * User key for thread ownership and scoping.\n   *\n   * **Required**: You must provide either `userKey` OR `userToken` (which contains a userKey).\n   * All thread operations (create, list, fetch) only return threads owned by this userKey.\n   *\n   * - Use `userKey` for server-side or trusted environments where you control the user identity\n   * - Use `userToken` (OAuth bearer token) for client-side apps where the token contains the userKey\n   */\n  userKey?: string;\n\n  /**\n   * Whether to automatically generate thread names after a threshold of messages.\n   * Defaults to true.\n   */\n  autoGenerateThreadName?: boolean;\n\n  /**\n   * The message count threshold at which the thread name will be auto-generated.\n   * Defaults to 3.\n   */\n  autoGenerateNameThreshold?: number;\n\n  /**\n   * Initial messages to seed new threads with.\n   * These are displayed in the UI immediately (before the first API call)\n   * and sent to the API when the first message is sent to create the thread.\n   */\n  initialMessages?: InitialInputMessage[];\n\n  /**\n   * Children components\n   */\n  children: React.ReactNode;\n}\n\n/**\n * Internal component that emits console warnings for auth misconfiguration.\n * Rendered inside the provider tree so both TamboClientContext and\n * TamboConfigContext are available.\n */\nfunction TamboAuthWarnings(): null {\n  const authState = useTamboAuthState();\n  const authError = authState.status === \"error\" ? authState.error : null;\n\n  useEffect(() => {\n    switch (authState.status) {\n      case \"unauthenticated\":\n        console.warn(\n          \"[TamboProvider] Neither userKey nor userToken provided. \" +\n            \"API requests will be blocked until authentication is configured.\",\n        );\n        break;\n      case \"invalid\":\n        console.warn(\n          \"[TamboProvider] Both userKey and userToken were provided. \" +\n            \"You must provide one or the other, not both.\",\n        );\n        break;\n      case \"error\":\n        console.warn(\"[TamboProvider] Token exchange failed:\", authError);\n        break;\n    }\n  }, [authState.status, authError]);\n\n  return null;\n}\n\n/**\n * Main provider for the Tambo SDK.\n *\n * Composes TamboClientProvider, TamboRegistryProvider, and TamboStreamProvider\n * to provide a complete context for building AI-powered applications.\n *\n * Threads are managed dynamically through useTambo() 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.resources - Static resources to register with the AI\n * @param props.listResources - Dynamic resource search function (must be paired with getResource)\n * @param props.getResource - Dynamic resource fetch function (must be paired with listResources)\n * @param props.contextHelpers - Configuration for context helper functions\n * @param props.userKey - User key for thread ownership (required if not using userToken)\n * @param props.autoGenerateThreadName - Whether to automatically generate thread names. Defaults to true.\n * @param props.autoGenerateNameThreshold - The message count threshold at which the thread name will be auto-generated. Defaults to 3.\n * @param props.children - Child components\n * @returns Provider component tree\n * @example\n * ```tsx\n * import { TamboProvider } from '@tambo-ai/react';\n *\n * function App() {\n *   return (\n *     <TamboProvider\n *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}\n *       components={[WeatherCard, StockChart]}\n *       tools={[searchTool, calculatorTool]}\n *     >\n *       <ChatInterface />\n *     </TamboProvider>\n *   );\n * }\n * ```\n */\nexport function TamboProvider({\n  apiKey,\n  tamboUrl,\n  environment,\n  userToken,\n  components,\n  tools,\n  mcpServers,\n  onCallUnregisteredTool,\n  resources,\n  listResources,\n  getResource,\n  contextHelpers,\n  userKey,\n  autoGenerateThreadName,\n  autoGenerateNameThreshold,\n  initialMessages,\n  children,\n}: PropsWithChildren<TamboProviderProps>) {\n  // Config is static - created once and never changes\n  const config: TamboConfig = {\n    userKey,\n    autoGenerateThreadName,\n    autoGenerateNameThreshold,\n    initialMessages,\n  };\n\n  return (\n    <TamboClientProvider\n      apiKey={apiKey}\n      tamboUrl={tamboUrl}\n      environment={environment}\n      userToken={userToken}\n      userKey={userKey}\n    >\n      <TamboRegistryProvider\n        components={components}\n        tools={tools}\n        mcpServers={mcpServers}\n        onCallUnregisteredTool={onCallUnregisteredTool}\n        resources={resources}\n        listResources={listResources}\n        getResource={getResource}\n      >\n        <TamboContextHelpersProvider contextHelpers={contextHelpers}>\n          <TamboMcpTokenProvider>\n            <TamboMcpProvider>\n              <TamboContextAttachmentProvider>\n                <TamboInteractableProvider>\n                  <TamboConfigContext.Provider value={config}>\n                    <TamboAuthWarnings />\n                    <TamboStreamProvider initialMessages={initialMessages}>\n                      <TamboThreadInputProvider>\n                        {children}\n                      </TamboThreadInputProvider>\n                    </TamboStreamProvider>\n                  </TamboConfigContext.Provider>\n                </TamboInteractableProvider>\n              </TamboContextAttachmentProvider>\n            </TamboMcpProvider>\n          </TamboMcpTokenProvider>\n        </TamboContextHelpersProvider>\n      </TamboRegistryProvider>\n    </TamboClientProvider>\n  );\n}\n"]}