@tambo-ai/react 0.74.1 → 1.0.0-rc.3

package/esm/v1/index.js

@@ -1,8 +1,8 @@
 /**
- * `@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
  *
@@ -16,28 +16,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();
@@ -58,10 +58,9 @@
  *
  * ## 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'`
@@ -69,39 +68,45 @@
 // =============================================================================
 // Providers
 // =============================================================================
-export { TamboV1Provider, useTamboV1Config, } from "./providers/tambo-v1-provider.js";
-// Re-export registry provider from beta SDK (works with v1)
+export { TamboProvider, useTamboConfig, } from "./providers/tambo-v1-provider.js";
+// Re-export registry provider
 export { TamboRegistryProvider } from "../providers/tambo-registry-provider.js";
-// Re-export client provider from beta SDK (works with v1)
+// Re-export client provider
 export { TamboClientProvider, useIsTamboTokenUpdating, } from "../providers/tambo-client-provider.js";
-// Re-export context helpers from beta SDK (works with v1)
+// Re-export context helpers
 export { TamboContextHelpersProvider, useTamboContextHelpers, } from "../providers/tambo-context-helpers-provider.js";
-// Export v1 thread input provider for advanced composition
-export { TamboV1ThreadInputProvider, } from "./providers/tambo-v1-thread-input-provider.js";
-// Export v1 stub provider for testing
-export { TamboV1StubProvider, } from "./providers/tambo-v1-stub-provider.js";
+// Re-export context attachment hook
+export { useTamboContextAttachment } from "../providers/tambo-context-attachment-provider.js";
+// Export thread input provider for advanced composition
+export { TamboThreadInputProvider, } from "./providers/tambo-v1-thread-input-provider.js";
+// Export stub provider for testing
+export { TamboStubProvider, } from "./providers/tambo-v1-stub-provider.js";
 // =============================================================================
 // Components
 // =============================================================================
-export { V1ComponentRenderer, } from "./components/v1-component-renderer.js";
+export { ComponentRenderer, } from "./components/v1-component-renderer.js";
 // =============================================================================
 // Hooks
 // =============================================================================
-export { useTamboV1 } from "./hooks/use-tambo-v1.js";
-export { useTamboV1ThreadInput } from "./hooks/use-tambo-v1-thread-input.js";
-export { useTamboV1Thread } from "./hooks/use-tambo-v1-thread.js";
-export { useTamboV1ThreadList } from "./hooks/use-tambo-v1-thread-list.js";
-export { useTamboV1ComponentState } from "./hooks/use-tambo-v1-component-state.js";
-export { useTamboV1StreamStatus, } from "./hooks/use-tambo-v1-stream-status.js";
-export { useTamboV1Suggestions, } from "./hooks/use-tambo-v1-suggestions.js";
-// Re-export client hook from beta SDK (works with v1)
+export { useTambo } from "./hooks/use-tambo-v1.js";
+export { useTamboThreadInput } from "./hooks/use-tambo-v1-thread-input.js";
+export { useTamboThread } from "./hooks/use-tambo-v1-thread.js";
+export { useTamboThreadList } from "./hooks/use-tambo-v1-thread-list.js";
+export { useTamboComponentState } from "./hooks/use-tambo-v1-component-state.js";
+export { useTamboStreamStatus, } from "./hooks/use-tambo-v1-stream-status.js";
+export { useTamboSuggestions, } from "./hooks/use-tambo-v1-suggestions.js";
+// Re-export client hook
 export { useTamboClient } from "../providers/tambo-client-provider.js";
 // Re-export image handling hook (pure React, API-agnostic)
 export { useMessageImages, } from "../hooks/use-message-images.js";
 // Re-export voice input hook (uses standalone transcription API)
 export { useTamboVoice } from "../hooks/use-tambo-voice.js";
 // =============================================================================
-// Re-exports from Beta SDK (compatible with v1)
+// Message Context (for components rendered by the AI)
+// =============================================================================
+export { TamboMessageProvider, useTamboCurrentMessage, useTamboCurrentComponent, } from "./hooks/use-tambo-current-message.js";
+// =============================================================================
+// Re-exports from SDK
 // =============================================================================
 // Tool definition helper
 export { defineTool } from "../util/registry.js";
@@ -109,11 +114,13 @@ export { defineTool } from "../util/registry.js";
 export { currentPageContextHelper, currentTimeContextHelper, } from "../context-helpers/index.js";
 // MCP server types
 export { MCPTransport } from "../model/mcp-server-info.js";
+// Component content context
+export { ComponentContentProvider, useComponentContent, } from "./utils/component-renderer.js";
 // =============================================================================
 // Interactable Components
 // =============================================================================
 // HOC for making components interactable by the AI
-export { withTamboInteractable as withInteractable, } from "../hoc/with-tambo-interactable.js";
+export { withTamboInteractable, } from "../hoc/with-tambo-interactable.js";
 // Interactable provider hooks
 export { useTamboInteractable, useCurrentInteractablesSnapshot, } from "../providers/tambo-interactable-provider.js";
 //# sourceMappingURL=index.js.map

package/esm/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,OAAO,EACL,eAAe,EAEf,gBAAgB,GAEjB,MAAM,+BAA+B,CAAC;AAEvC,4DAA4D;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,0DAA0D;AAC1D,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAE5C,0DAA0D;AAC1D,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,6CAA6C,CAAC;AAErD,2DAA2D;AAC3D,OAAO,EACL,0BAA0B,GAG3B,MAAM,4CAA4C,CAAC;AAEpD,sCAAsC;AACtC,OAAO,EACL,mBAAmB,GAEpB,MAAM,oCAAoC,CAAC;AAE5C,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,OAAO,EACL,mBAAmB,GAEpB,MAAM,oCAAoC,CAAC;AAE5C,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,EACL,sBAAsB,GAGvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,qBAAqB,GAItB,MAAM,kCAAkC,CAAC;AAE1C,sDAAsD;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,2DAA2D;AAC3D,OAAO,EACL,gBAAgB,GAEjB,MAAM,6BAA6B,CAAC;AAErC,iEAAiE;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,gFAAgF;AAChF,gDAAgD;AAChD,gFAAgF;AAEhF,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,2BAA2B;AAC3B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAoB5B,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA+BxD,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,mDAAmD;AACnD,OAAO,EACL,qBAAqB,IAAI,gBAAgB,GAG1C,MAAM,gCAAgC,CAAC;AAExC,8BAA8B;AAC9B,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,0CAA0C,CAAC","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// 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 { 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 as withInteractable,\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,OAAO,EACL,aAAa,EAEb,cAAc,GAEf,MAAM,+BAA+B,CAAC;AAEvC,8BAA8B;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,4BAA4B;AAC5B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAE5C,4BAA4B;AAC5B,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,6CAA6C,CAAC;AAErD,oCAAoC;AACpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAE3F,wDAAwD;AACxD,OAAO,EACL,wBAAwB,GAGzB,MAAM,4CAA4C,CAAC;AAEpD,mCAAmC;AACnC,OAAO,EACL,iBAAiB,GAElB,MAAM,oCAAoC,CAAC;AAE5C,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,GAElB,MAAM,oCAAoC,CAAC;AAE5C,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAuB,MAAM,sBAAsB,CAAC;AAMrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,OAAO,EACL,oBAAoB,GAGrB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,mBAAmB,GAIpB,MAAM,kCAAkC,CAAC;AAE1C,wBAAwB;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,2DAA2D;AAC3D,OAAO,EACL,gBAAgB,GAEjB,MAAM,6BAA6B,CAAC;AAErC,iEAAiE;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,gFAAgF;AAChF,sDAAsD;AACtD,gFAAgF;AAEhF,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,GAEzB,MAAM,mCAAmC,CAAC;AAE3C,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,2BAA2B;AAC3B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAoB5B,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA8DxD,4BAA4B;AAC5B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GAEpB,MAAM,4BAA4B,CAAC;AAEpC,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,mDAAmD;AACnD,OAAO,EACL,qBAAqB,GAGtB,MAAM,gCAAgC,CAAC;AAExC,8BAA8B;AAC9B,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,0CAA0C,CAAC","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/esm/v1/providers/tambo-v1-provider.d.ts

@@ -1,15 +1,18 @@
 /**
- * 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
+ * - TamboMcpTokenProvider: MCP access token management
+ * - 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.js";
@@ -17,33 +20,39 @@ import { type TamboRegistryProviderProps } from "../../providers/tambo-registry-
 import type { ContextHelpers } from "../../context-helpers/index.js";
 import type { McpServerInfo } from "../../model/mcp-server-info.js";
 import type { ListResourceItem, ResourceSource } from "../../model/resource-info.js";
+import type { InitialInputMessage } from "../types/message.js";
 /**
- * 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. */
     autoGenerateThreadName?: boolean;
     /** The message count threshold at which the thread name will be auto-generated. Defaults to 3. */
     autoGenerateNameThreshold?: number;
+    /**
+     * Initial messages to seed new threads with.
+     * These are displayed in the UI immediately and sent to the API on first message.
+     */
+    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.
@@ -107,18 +116,24 @@ export interface TamboV1ProviderProps extends Pick<TamboClientProviderProps, "ap
      * Defaults to 3.
      */
     autoGenerateNameThreshold?: number;
+    /**
+     * Initial messages to seed new threads with.
+     * These are displayed in the UI immediately (before the first API call)
+     * and sent to the API when the first message is sent to create the thread.
+     */
+    initialMessages?: InitialInputMessage[];
     /**
      * Children components
      */
     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
@@ -142,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, 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/esm/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;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,EAGZ,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAC;AACf,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,yCAAyC,CAAC;AAGjD,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;AAInC;;;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;CACpC;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;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,QAAQ,GACT,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,qBAsCzC"}
+{"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/esm/v1/providers/tambo-v1-provider.js

@@ -1,48 +1,80 @@
 "use client";
 /**
- * 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
+ * - TamboMcpTokenProvider: MCP access token management
+ * - 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, { createContext, useContext, } from "react";
+import React, { createContext, useContext, useEffect, } from "react";
+import { useTamboAuthState } from "../hooks/use-tambo-v1-auth-state.js";
 import { TamboClientProvider, } from "../../providers/tambo-client-provider.js";
 import { TamboRegistryProvider, } from "../../providers/tambo-registry-provider.js";
+import { TamboContextAttachmentProvider } from "../../providers/tambo-context-attachment-provider.js";
 import { TamboContextHelpersProvider } from "../../providers/tambo-context-helpers-provider.js";
 import { TamboInteractableProvider } from "../../providers/tambo-interactable-provider.js";
-import { TamboV1StreamProvider } from "./tambo-v1-stream-context.js";
-import { TamboV1ThreadInputProvider } from "./tambo-v1-thread-input-provider.js";
+import { TamboMcpTokenProvider } from "../../providers/tambo-mcp-token-provider.js";
+import { TamboMcpProvider } from "../../mcp/tambo-mcp-provider.js";
+import { TamboStreamProvider } from "./tambo-v1-stream-context.js";
+import { TamboThreadInputProvider } from "./tambo-v1-thread-input-provider.js";
 /**
- * Context for v1 SDK configuration.
+ * Context for SDK configuration.
  * @internal
  */
-export const TamboV1ConfigContext = createContext(null);
+export const TamboConfigContext = 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
  */
-export function useTamboV1Config() {
-    const config = useContext(TamboV1ConfigContext);
+export function useTamboConfig() {
+    const config = useContext(TamboConfigContext);
     if (!config) {
-        throw new Error("useTamboV1Config must be used within TamboV1Provider");
+        throw new Error("useTamboConfig must be used within TamboProvider");
     }
     return config;
 }
 /**
- * Main provider for the Tambo v1 SDK.
+ * Internal component that emits console warnings for auth misconfiguration.
+ * Rendered inside the provider tree so both TamboClientContext and
+ * TamboConfigContext are available.
+ */
+function TamboAuthWarnings() {
+    const authState = useTamboAuthState();
+    const authError = authState.status === "error" ? authState.error : null;
+    useEffect(() => {
+        switch (authState.status) {
+            case "unauthenticated":
+                console.warn("[TamboProvider] Neither userKey nor userToken provided. " +
+                    "API requests will be blocked until authentication is configured.");
+                break;
+            case "invalid":
+                console.warn("[TamboProvider] Both userKey and userToken were provided. " +
+                    "You must provide one or the other, not both.");
+                break;
+            case "error":
+                console.warn("[TamboProvider] Token exchange failed:", authError);
+                break;
+        }
+    }, [authState.status, authError]);
+    return null;
+}
+/**
+ * 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
@@ -66,34 +98,39 @@ export function useTamboV1Config() {
  * @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 function TamboV1Provider({ apiKey, tamboUrl, environment, userToken, components, tools, mcpServers, onCallUnregisteredTool, resources, listResources, getResource, contextHelpers, userKey, autoGenerateThreadName, autoGenerateNameThreshold, children, }) {
+export 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,
         autoGenerateThreadName,
         autoGenerateNameThreshold,
+        initialMessages,
     };
-    return (React.createElement(TamboClientProvider, { apiKey: apiKey, tamboUrl: tamboUrl, environment: environment, userToken: userToken },
+    return (React.createElement(TamboClientProvider, { apiKey: apiKey, tamboUrl: tamboUrl, environment: environment, userToken: userToken, userKey: userKey },
         React.createElement(TamboRegistryProvider, { components: components, tools: tools, mcpServers: mcpServers, onCallUnregisteredTool: onCallUnregisteredTool, resources: resources, listResources: listResources, getResource: getResource },
             React.createElement(TamboContextHelpersProvider, { contextHelpers: contextHelpers },
-                React.createElement(TamboInteractableProvider, null,
-                    React.createElement(TamboV1ConfigContext.Provider, { value: config },
-                        React.createElement(TamboV1StreamProvider, null,
-                            React.createElement(TamboV1ThreadInputProvider, null, children))))))));
+                React.createElement(TamboMcpTokenProvider, null,
+                    React.createElement(TamboMcpProvider, null,
+                        React.createElement(TamboContextAttachmentProvider, null,
+                            React.createElement(TamboInteractableProvider, null,
+                                React.createElement(TamboConfigContext.Provider, { value: config },
+                                    React.createElement(TamboAuthWarnings, null),
+                                    React.createElement(TamboStreamProvider, { initialMessages: initialMessages },
+                                        React.createElement(TamboThreadInputProvider, null, children)))))))))));
 }
 //# sourceMappingURL=tambo-v1-provider.js.map

package/esm/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":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,EACZ,aAAa,EACb,UAAU,GAEX,MAAM,OAAO,CAAC;AACf,OAAO,EACL,mBAAmB,GAEpB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,qBAAqB,GAEtB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AAOxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAe9E;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAuB,IAAI,CAAC,CAAC;AAE9E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAyFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,UAAU,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,QAAQ,GACgC;IACxC,oDAAoD;IACpD,MAAM,MAAM,GAAkB;QAC5B,OAAO;QACP,sBAAsB;QACtB,yBAAyB;KAC1B,CAAC;IAEF,OAAO,CACL,oBAAC,mBAAmB,IAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS;QAEpB,oBAAC,qBAAqB,IACpB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,UAAU,EACtB,sBAAsB,EAAE,sBAAsB,EAC9C,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW;YAExB,oBAAC,2BAA2B,IAAC,cAAc,EAAE,cAAc;gBACzD,oBAAC,yBAAyB;oBACxB,oBAAC,oBAAoB,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM;wBAC1C,oBAAC,qBAAqB;4BACpB,oBAAC,0BAA0B,QACxB,QAAQ,CACkB,CACP,CACM,CACN,CACA,CACR,CACJ,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 * - TamboContextHelpersProvider: Context helper functions\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  type PropsWithChildren,\n} from \"react\";\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 { TamboContextHelpersProvider } from \"../../providers/tambo-context-helpers-provider\";\nimport { TamboInteractableProvider } from \"../../providers/tambo-interactable-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 { 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\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   * 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.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  children,\n}: PropsWithChildren<TamboV1ProviderProps>) {\n  // Config is static - created once and never changes\n  const config: TamboV1Config = {\n    userKey,\n    autoGenerateThreadName,\n    autoGenerateNameThreshold,\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          <TamboInteractableProvider>\n            <TamboV1ConfigContext.Provider value={config}>\n              <TamboV1StreamProvider>\n                <TamboV1ThreadInputProvider>\n                  {children}\n                </TamboV1ThreadInputProvider>\n              </TamboV1StreamProvider>\n            </TamboV1ConfigContext.Provider>\n          </TamboInteractableProvider>\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":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,EACZ,aAAa,EACb,UAAU,EACV,SAAS,GAEV,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EACL,mBAAmB,GAEpB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,qBAAqB,GAEtB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,2BAA2B,EAAE,MAAM,gDAAgD,CAAC;AAC7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAQhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAoB5E;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAgGD;;;;GAIG;AACH,SAAS,iBAAiB;IACxB,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAExE,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC;YACzB,KAAK,iBAAiB;gBACpB,OAAO,CAAC,IAAI,CACV,0DAA0D;oBACxD,kEAAkE,CACrE,CAAC;gBACF,MAAM;YACR,KAAK,SAAS;gBACZ,OAAO,CAAC,IAAI,CACV,4DAA4D;oBAC1D,8CAA8C,CACjD,CAAC;gBACF,MAAM;YACR,KAAK,OAAO;gBACV,OAAO,CAAC,IAAI,CAAC,wCAAwC,EAAE,SAAS,CAAC,CAAC;gBAClE,MAAM;QACV,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAElC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,UAAU,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,GAC8B;IACtC,oDAAoD;IACpD,MAAM,MAAM,GAAgB;QAC1B,OAAO;QACP,sBAAsB;QACtB,yBAAyB;QACzB,eAAe;KAChB,CAAC;IAEF,OAAO,CACL,oBAAC,mBAAmB,IAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO;QAEhB,oBAAC,qBAAqB,IACpB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,UAAU,EACtB,sBAAsB,EAAE,sBAAsB,EAC9C,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW;YAExB,oBAAC,2BAA2B,IAAC,cAAc,EAAE,cAAc;gBACzD,oBAAC,qBAAqB;oBACpB,oBAAC,gBAAgB;wBACf,oBAAC,8BAA8B;4BAC7B,oBAAC,yBAAyB;gCACxB,oBAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM;oCACxC,oBAAC,iBAAiB,OAAG;oCACrB,oBAAC,mBAAmB,IAAC,eAAe,EAAE,eAAe;wCACnD,oBAAC,wBAAwB,QACtB,QAAQ,CACgB,CACP,CACM,CACJ,CACG,CAChB,CACG,CACI,CACR,CACJ,CACvB,CAAC;AACJ,CAAC","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"]}