@tambo-ai/react 0.70.0 → 0.72.0

package/dist/v1/hooks/use-tambo-v1.test.js

@@ -0,0 +1,150 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = require("@testing-library/react");
+const react_2 = __importDefault(require("react"));
+const tambo_client_provider_1 = require("../../providers/tambo-client-provider");
+const tambo_registry_provider_1 = require("../../providers/tambo-registry-provider");
+const tambo_v1_stream_context_1 = require("../providers/tambo-v1-stream-context");
+const use_tambo_v1_1 = require("./use-tambo-v1");
+jest.mock("../../providers/tambo-client-provider", () => ({
+    useTamboClient: jest.fn(),
+}));
+describe("useTamboV1", () => {
+    const mockTamboClient = {
+        apiKey: "",
+        threads: {},
+    };
+    const mockRegistry = {
+        componentList: {},
+        toolRegistry: {},
+        componentToolAssociations: {},
+        mcpServerInfos: [],
+        resources: [],
+        resourceSource: null,
+        registerComponent: jest.fn(),
+        registerTool: jest.fn(),
+        registerTools: jest.fn(),
+        addToolAssociation: jest.fn(),
+        registerMcpServer: jest.fn(),
+        registerMcpServers: jest.fn(),
+        registerResource: jest.fn(),
+        registerResources: jest.fn(),
+        registerResourceSource: jest.fn(),
+    };
+    function TestWrapper({ children }) {
+        return (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryContext.Provider, { value: mockRegistry },
+            react_2.default.createElement(tambo_v1_stream_context_1.TamboV1StreamProvider, null, children)));
+    }
+    function TestWrapperWithThreadId({ children, }) {
+        return (react_2.default.createElement(tambo_registry_provider_1.TamboRegistryContext.Provider, { value: mockRegistry },
+            react_2.default.createElement(tambo_v1_stream_context_1.TamboV1StreamProvider, { threadId: "thread_123" }, children)));
+    }
+    beforeEach(() => {
+        jest.mocked(tambo_client_provider_1.useTamboClient).mockReturnValue(mockTamboClient);
+        jest.clearAllMocks();
+    });
+    it("returns client from useTamboClient", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.client).toBe(mockTamboClient);
+    });
+    it("returns registry functions", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.registerComponent).toBe(mockRegistry.registerComponent);
+        expect(result.current.registerTool).toBe(mockRegistry.registerTool);
+        expect(result.current.registerTools).toBe(mockRegistry.registerTools);
+        expect(result.current.componentList).toBe(mockRegistry.componentList);
+        expect(result.current.toolRegistry).toBe(mockRegistry.toolRegistry);
+    });
+    it("returns undefined thread when no threadId provided", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.thread).toBeUndefined();
+        expect(result.current.messages).toEqual([]);
+    });
+    it("returns thread state when threadId provided", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)("thread_123"), {
+            wrapper: TestWrapperWithThreadId,
+        });
+        expect(result.current.thread).toBeDefined();
+        expect(result.current.thread?.thread.id).toBe("thread_123");
+        expect(result.current.messages).toEqual([]);
+    });
+    it("returns default streaming state when thread not loaded", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.streamingState).toEqual({ status: "idle" });
+        expect(result.current.isIdle).toBe(true);
+        expect(result.current.isStreaming).toBe(false);
+        expect(result.current.isWaiting).toBe(false);
+    });
+    it("returns thread streaming state when thread loaded", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)("thread_123"), {
+            wrapper: TestWrapperWithThreadId,
+        });
+        expect(result.current.streamingState.status).toBe("idle");
+        expect(result.current.isIdle).toBe(true);
+        expect(result.current.isStreaming).toBe(false);
+        expect(result.current.isWaiting).toBe(false);
+    });
+    it("provides dispatch function for advanced usage", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)(), {
+            wrapper: TestWrapper,
+        });
+        expect(typeof result.current.dispatch).toBe("function");
+    });
+    it("provides thread management functions", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)(), {
+            wrapper: TestWrapper,
+        });
+        expect(typeof result.current.initThread).toBe("function");
+        expect(typeof result.current.switchThread).toBe("function");
+        expect(typeof result.current.startNewThread).toBe("function");
+    });
+    it("initializes and switches threads", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)(), {
+            wrapper: TestWrapper,
+        });
+        // Initially no current thread
+        expect(result.current.currentThreadId).toBeNull();
+        expect(result.current.thread).toBeUndefined();
+        // Initialize a new thread
+        (0, react_1.act)(() => {
+            result.current.initThread("new_thread_1");
+        });
+        // Switch to the new thread
+        (0, react_1.act)(() => {
+            result.current.switchThread("new_thread_1");
+        });
+        expect(result.current.currentThreadId).toBe("new_thread_1");
+    });
+    it("starts new thread with generated ID", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)(), {
+            wrapper: TestWrapper,
+        });
+        let newThreadId;
+        (0, react_1.act)(() => {
+            newThreadId = result.current.startNewThread();
+        });
+        expect(newThreadId).toMatch(/^temp_/);
+        expect(result.current.currentThreadId).toBe(newThreadId);
+        expect(result.current.thread).toBeDefined();
+    });
+    it("uses current thread when no threadId argument provided", () => {
+        const { result } = (0, react_1.renderHook)(() => (0, use_tambo_v1_1.useTamboV1)(), {
+            wrapper: TestWrapperWithThreadId,
+        });
+        // Should use current thread from context (thread_123)
+        expect(result.current.currentThreadId).toBe("thread_123");
+        expect(result.current.thread?.thread.id).toBe("thread_123");
+    });
+});
+//# sourceMappingURL=use-tambo-v1.test.js.map

package/dist/v1/hooks/use-tambo-v1.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1.test.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { renderHook, act } from \"@testing-library/react\";\nimport React from \"react\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport {\n  TamboRegistryContext,\n  type TamboRegistryContext as TamboRegistryContextType,\n} from \"../../providers/tambo-registry-provider\";\nimport { TamboV1StreamProvider } from \"../providers/tambo-v1-stream-context\";\nimport { useTamboV1 } from \"./use-tambo-v1\";\n\njest.mock(\"../../providers/tambo-client-provider\", () => ({\n  useTamboClient: jest.fn(),\n}));\n\ndescribe(\"useTamboV1\", () => {\n  const mockTamboClient = {\n    apiKey: \"\",\n    threads: {},\n  } as unknown as TamboAI;\n\n  const mockRegistry: TamboRegistryContextType = {\n    componentList: {},\n    toolRegistry: {},\n    componentToolAssociations: {},\n    mcpServerInfos: [],\n    resources: [],\n    resourceSource: null,\n    registerComponent: jest.fn(),\n    registerTool: jest.fn(),\n    registerTools: jest.fn(),\n    addToolAssociation: jest.fn(),\n    registerMcpServer: jest.fn(),\n    registerMcpServers: jest.fn(),\n    registerResource: jest.fn(),\n    registerResources: jest.fn(),\n    registerResourceSource: jest.fn(),\n  };\n\n  function TestWrapper({ children }: { children: React.ReactNode }) {\n    return (\n      <TamboRegistryContext.Provider value={mockRegistry}>\n        <TamboV1StreamProvider>{children}</TamboV1StreamProvider>\n      </TamboRegistryContext.Provider>\n    );\n  }\n\n  function TestWrapperWithThreadId({\n    children,\n  }: {\n    children: React.ReactNode;\n  }) {\n    return (\n      <TamboRegistryContext.Provider value={mockRegistry}>\n        <TamboV1StreamProvider threadId=\"thread_123\">\n          {children}\n        </TamboV1StreamProvider>\n      </TamboRegistryContext.Provider>\n    );\n  }\n\n  beforeEach(() => {\n    jest.mocked(useTamboClient).mockReturnValue(mockTamboClient);\n    jest.clearAllMocks();\n  });\n\n  it(\"returns client from useTamboClient\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.client).toBe(mockTamboClient);\n  });\n\n  it(\"returns registry functions\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.registerComponent).toBe(\n      mockRegistry.registerComponent,\n    );\n    expect(result.current.registerTool).toBe(mockRegistry.registerTool);\n    expect(result.current.registerTools).toBe(mockRegistry.registerTools);\n    expect(result.current.componentList).toBe(mockRegistry.componentList);\n    expect(result.current.toolRegistry).toBe(mockRegistry.toolRegistry);\n  });\n\n  it(\"returns undefined thread when no threadId provided\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.thread).toBeUndefined();\n    expect(result.current.messages).toEqual([]);\n  });\n\n  it(\"returns thread state when threadId provided\", () => {\n    const { result } = renderHook(() => useTamboV1(\"thread_123\"), {\n      wrapper: TestWrapperWithThreadId,\n    });\n\n    expect(result.current.thread).toBeDefined();\n    expect(result.current.thread?.thread.id).toBe(\"thread_123\");\n    expect(result.current.messages).toEqual([]);\n  });\n\n  it(\"returns default streaming state when thread not loaded\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.streamingState).toEqual({ status: \"idle\" });\n    expect(result.current.isIdle).toBe(true);\n    expect(result.current.isStreaming).toBe(false);\n    expect(result.current.isWaiting).toBe(false);\n  });\n\n  it(\"returns thread streaming state when thread loaded\", () => {\n    const { result } = renderHook(() => useTamboV1(\"thread_123\"), {\n      wrapper: TestWrapperWithThreadId,\n    });\n\n    expect(result.current.streamingState.status).toBe(\"idle\");\n    expect(result.current.isIdle).toBe(true);\n    expect(result.current.isStreaming).toBe(false);\n    expect(result.current.isWaiting).toBe(false);\n  });\n\n  it(\"provides dispatch function for advanced usage\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(typeof result.current.dispatch).toBe(\"function\");\n  });\n\n  it(\"provides thread management functions\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(typeof result.current.initThread).toBe(\"function\");\n    expect(typeof result.current.switchThread).toBe(\"function\");\n    expect(typeof result.current.startNewThread).toBe(\"function\");\n  });\n\n  it(\"initializes and switches threads\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    // Initially no current thread\n    expect(result.current.currentThreadId).toBeNull();\n    expect(result.current.thread).toBeUndefined();\n\n    // Initialize a new thread\n    act(() => {\n      result.current.initThread(\"new_thread_1\");\n    });\n\n    // Switch to the new thread\n    act(() => {\n      result.current.switchThread(\"new_thread_1\");\n    });\n\n    expect(result.current.currentThreadId).toBe(\"new_thread_1\");\n  });\n\n  it(\"starts new thread with generated ID\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapper,\n    });\n\n    let newThreadId: string;\n    act(() => {\n      newThreadId = result.current.startNewThread();\n    });\n\n    expect(newThreadId!).toMatch(/^temp_/);\n    expect(result.current.currentThreadId).toBe(newThreadId!);\n    expect(result.current.thread).toBeDefined();\n  });\n\n  it(\"uses current thread when no threadId argument provided\", () => {\n    const { result } = renderHook(() => useTamboV1(), {\n      wrapper: TestWrapperWithThreadId,\n    });\n\n    // Should use current thread from context (thread_123)\n    expect(result.current.currentThreadId).toBe(\"thread_123\");\n    expect(result.current.thread?.thread.id).toBe(\"thread_123\");\n  });\n});\n"]}

package/dist/v1/index.d.ts

@@ -1,35 +1,84 @@
 /**
- * @tambo-ai/react/v1 - React SDK for Tambo v1 API
+ * `@tambo-ai/react/v1` - React SDK for Tambo v1 API
  *
  * Provides React hooks and providers for building AI-powered applications
  * using the v1 streaming API with AG-UI protocol.
  *
- * Types are not re-exported. Import directly from specific type files:
- * - Custom events: import from '@tambo-ai/react/v1/types/event'
- * - Thread state: import from '@tambo-ai/react/v1/types/thread'
- * - Messages: import from '@tambo-ai/react/v1/types/message'
- * - Components: import from '@tambo-ai/react/v1/types/component'
- * - Tools: import from '@tambo-ai/react/v1/types/tool'
+ * ## Quick Start
  *
- * SDK types: import directly from @tambo-ai/typescript-sdk
- * AG-UI events: import directly from @ag-ui/core
- * @example
- * ```typescript
- * import { TamboV1Provider, useTamboV1 } from '@tambo-ai/react/v1';
+ * ```tsx
+ * import {
+ *   TamboV1Provider,
+ *   useTamboV1,
+ *   useTamboV1ThreadInput,
+ * } from '@tambo-ai/react/v1';
  *
  * function App() {
  *   return (
- *     <TamboV1Provider apiKey="your-api-key">
+ *     <TamboV1Provider
+ *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
+ *       components={[WeatherCard]}
+ *       tools={[searchTool]}
+ *     >
  *       <ChatInterface />
  *     </TamboV1Provider>
  *   );
  * }
  *
  * function ChatInterface() {
- *   const { thread, sendMessage, isStreaming } = useTamboV1();
- *   // ... implementation
+ *   const [threadId, setThreadId] = useState<string>();
+ *   const { messages, isStreaming } = useTamboV1(threadId);
+ *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);
+ *
+ *   const handleSubmit = async (e: React.FormEvent) => {
+ *     e.preventDefault();
+ *     const result = await submit();
+ *     if (!threadId) setThreadId(result.threadId);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       {messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *       {isStreaming && <LoadingIndicator />}
+ *       <input value={value} onChange={(e) => setValue(e.target.value)} />
+ *       <button disabled={isPending}>Send</button>
+ *     </form>
+ *   );
  * }
  * ```
+ *
+ * ## 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'`
+ *
+ * SDK types: `import type { ... } from '@tambo-ai/typescript-sdk'`
+ * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`
  */
-export {};
+export { TamboV1Provider, useContextKey, type TamboV1ProviderProps, } from "./providers/tambo-v1-provider";
+export { TamboV1StreamProvider, useStreamState, useStreamDispatch, useThreadManagement, type ThreadManagement, } from "./providers/tambo-v1-stream-context";
+export { TamboRegistryProvider } from "../providers/tambo-registry-provider";
+export { TamboContextHelpersProvider, useTamboContextHelpers, } from "../providers/tambo-context-helpers-provider";
+export { useTamboV1, type UseTamboV1Return } from "./hooks/use-tambo-v1";
+export { useTamboV1ThreadInput, type UseTamboV1ThreadInputReturn, type SubmitOptions, } from "./hooks/use-tambo-v1-thread-input";
+export { useTamboV1Thread } from "./hooks/use-tambo-v1-thread";
+export { useTamboV1ThreadList } from "./hooks/use-tambo-v1-thread-list";
+export { useTamboV1ComponentState, type UseTamboV1ComponentStateReturn, } from "./hooks/use-tambo-v1-component-state";
+export { useTamboClient } from "../providers/tambo-client-provider";
+export { useTamboRegistry } from "../providers/tambo-registry-provider";
+export { useV1ComponentContent, useV1ComponentContentOptional, renderComponentContent, renderMessageContent, renderMessageComponents, isComponentContent, type V1ComponentContentContext, type RenderComponentOptions, } from "./utils/component-renderer";
+export { applyJsonPatch } from "./utils/json-patch";
+export { toAvailableComponent, toAvailableComponents, toAvailableTool, toAvailableTools, } from "./utils/registry-conversion";
+export { executeClientTool, executeAllPendingTools, type PendingToolCall, } from "./utils/tool-executor";
+export { ToolCallTracker } from "./utils/tool-call-tracker";
+export { handleEventStream } from "./utils/stream-handler";
+export { defineTool } from "../util/registry";
+export { currentPageContextHelper, currentTimeContextHelper, } from "../context-helpers";
+export type { AdditionalContext, ContextHelperFn, ContextHelpers, } from "../context-helpers";
+export type { ComponentContextToolMetadata, ComponentRegistry, ParameterSpec, RegisteredComponent, TamboTool, ToolAnnotations, } from "../model/component-metadata";
+export { MCPTransport } from "../model/mcp-server-info";
+export type { McpServerInfo, NormalizedMcpServerInfo, } from "../model/mcp-server-info";
+export type { ListResourceItem, ReadResourceResult, ResourceSource, } from "../model/resource-info";
 //# sourceMappingURL=index.d.ts.map

package/dist/v1/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAMH,OAAO,EACL,eAAe,EACf,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,6CAA6C,CAAC;AAMrD,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,KAAK,aAAa,GACnB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EACL,wBAAwB,EACxB,KAAK,8BAA8B,GACpC,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAMxE,OAAO,EACL,qBAAqB,EACrB,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,GAC5B,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAO3D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,4BAA4B,EAC5B,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EACV,aAAa,EACb,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,wBAAwB,CAAC"}

package/dist/v1/index.js

@@ -1,47 +1,140 @@
 "use strict";
 /**
- * @tambo-ai/react/v1 - React SDK for Tambo v1 API
+ * `@tambo-ai/react/v1` - React SDK for Tambo v1 API
  *
  * Provides React hooks and providers for building AI-powered applications
  * using the v1 streaming API with AG-UI protocol.
  *
- * Types are not re-exported. Import directly from specific type files:
- * - Custom events: import from '@tambo-ai/react/v1/types/event'
- * - Thread state: import from '@tambo-ai/react/v1/types/thread'
- * - Messages: import from '@tambo-ai/react/v1/types/message'
- * - Components: import from '@tambo-ai/react/v1/types/component'
- * - Tools: import from '@tambo-ai/react/v1/types/tool'
+ * ## Quick Start
  *
- * SDK types: import directly from @tambo-ai/typescript-sdk
- * AG-UI events: import directly from @ag-ui/core
- * @example
- * ```typescript
- * import { TamboV1Provider, useTamboV1 } from '@tambo-ai/react/v1';
+ * ```tsx
+ * import {
+ *   TamboV1Provider,
+ *   useTamboV1,
+ *   useTamboV1ThreadInput,
+ * } from '@tambo-ai/react/v1';
  *
  * function App() {
  *   return (
- *     <TamboV1Provider apiKey="your-api-key">
+ *     <TamboV1Provider
+ *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
+ *       components={[WeatherCard]}
+ *       tools={[searchTool]}
+ *     >
  *       <ChatInterface />
  *     </TamboV1Provider>
  *   );
  * }
  *
  * function ChatInterface() {
- *   const { thread, sendMessage, isStreaming } = useTamboV1();
- *   // ... implementation
+ *   const [threadId, setThreadId] = useState<string>();
+ *   const { messages, isStreaming } = useTamboV1(threadId);
+ *   const { value, setValue, submit, isPending } = useTamboV1ThreadInput(threadId);
+ *
+ *   const handleSubmit = async (e: React.FormEvent) => {
+ *     e.preventDefault();
+ *     const result = await submit();
+ *     if (!threadId) setThreadId(result.threadId);
+ *   };
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       {messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *       {isStreaming && <LoadingIndicator />}
+ *       <input value={value} onChange={(e) => setValue(e.target.value)} />
+ *       <button disabled={isPending}>Send</button>
+ *     </form>
+ *   );
  * }
  * ```
+ *
+ * ## 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'`
+ *
+ * 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 });
-// Providers (TODO: implement in Phase 7)
-// export { TamboV1Provider } from './providers/tambo-v1-provider';
-// export { TamboRegistryProvider } from '../providers/tambo-registry-provider'; // Reused from beta
-// Hooks (TODO: implement in Phase 7)
-// export { useTamboV1 } from './hooks/use-tambo-v1';
-// export { useTamboV1Thread } from './hooks/use-tambo-v1-thread';
-// export { useTamboV1Messages } from './hooks/use-tambo-v1-messages';
-// export { useTamboV1SendMessage } from './hooks/use-tambo-v1-send-message';
-// export { useTamboV1ComponentState } from './hooks/use-tambo-v1-component-state';
-// Utilities (TODO: implement in Phase 2-3)
-// export { applyJsonPatch } from './utils/json-patch';
+exports.MCPTransport = exports.currentTimeContextHelper = exports.currentPageContextHelper = exports.defineTool = exports.handleEventStream = exports.ToolCallTracker = exports.executeAllPendingTools = exports.executeClientTool = exports.toAvailableTools = exports.toAvailableTool = exports.toAvailableComponents = exports.toAvailableComponent = exports.applyJsonPatch = exports.isComponentContent = exports.renderMessageComponents = exports.renderMessageContent = exports.renderComponentContent = exports.useV1ComponentContentOptional = exports.useV1ComponentContent = exports.useTamboRegistry = exports.useTamboClient = exports.useTamboV1ComponentState = exports.useTamboV1ThreadList = exports.useTamboV1Thread = exports.useTamboV1ThreadInput = exports.useTamboV1 = exports.useTamboContextHelpers = exports.TamboContextHelpersProvider = exports.TamboRegistryProvider = exports.useThreadManagement = exports.useStreamDispatch = exports.useStreamState = exports.TamboV1StreamProvider = exports.useContextKey = exports.TamboV1Provider = 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, "useContextKey", { enumerable: true, get: function () { return tambo_v1_provider_1.useContextKey; } });
+var tambo_v1_stream_context_1 = require("./providers/tambo-v1-stream-context");
+Object.defineProperty(exports, "TamboV1StreamProvider", { enumerable: true, get: function () { return tambo_v1_stream_context_1.TamboV1StreamProvider; } });
+Object.defineProperty(exports, "useStreamState", { enumerable: true, get: function () { return tambo_v1_stream_context_1.useStreamState; } });
+Object.defineProperty(exports, "useStreamDispatch", { enumerable: true, get: function () { return tambo_v1_stream_context_1.useStreamDispatch; } });
+Object.defineProperty(exports, "useThreadManagement", { enumerable: true, get: function () { return tambo_v1_stream_context_1.useThreadManagement; } });
+// Re-export registry provider from beta SDK (works with v1)
+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 context helpers from beta SDK (works with v1)
+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; } });
+// =============================================================================
+// 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; } });
+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; } });
+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; } });
+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; } });
+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; } });
+// Re-export client hook from beta SDK (works with v1)
+var tambo_client_provider_1 = require("../providers/tambo-client-provider");
+Object.defineProperty(exports, "useTamboClient", { enumerable: true, get: function () { return tambo_client_provider_1.useTamboClient; } });
+// Re-export registry hook from beta SDK (works with v1)
+var tambo_registry_provider_2 = require("../providers/tambo-registry-provider");
+Object.defineProperty(exports, "useTamboRegistry", { enumerable: true, get: function () { return tambo_registry_provider_2.useTamboRegistry; } });
+// =============================================================================
+// Component Rendering
+// =============================================================================
+var component_renderer_1 = require("./utils/component-renderer");
+Object.defineProperty(exports, "useV1ComponentContent", { enumerable: true, get: function () { return component_renderer_1.useV1ComponentContent; } });
+Object.defineProperty(exports, "useV1ComponentContentOptional", { enumerable: true, get: function () { return component_renderer_1.useV1ComponentContentOptional; } });
+Object.defineProperty(exports, "renderComponentContent", { enumerable: true, get: function () { return component_renderer_1.renderComponentContent; } });
+Object.defineProperty(exports, "renderMessageContent", { enumerable: true, get: function () { return component_renderer_1.renderMessageContent; } });
+Object.defineProperty(exports, "renderMessageComponents", { enumerable: true, get: function () { return component_renderer_1.renderMessageComponents; } });
+Object.defineProperty(exports, "isComponentContent", { enumerable: true, get: function () { return component_renderer_1.isComponentContent; } });
+// =============================================================================
+// Utilities
+// =============================================================================
+var json_patch_1 = require("./utils/json-patch");
+Object.defineProperty(exports, "applyJsonPatch", { enumerable: true, get: function () { return json_patch_1.applyJsonPatch; } });
+var registry_conversion_1 = require("./utils/registry-conversion");
+Object.defineProperty(exports, "toAvailableComponent", { enumerable: true, get: function () { return registry_conversion_1.toAvailableComponent; } });
+Object.defineProperty(exports, "toAvailableComponents", { enumerable: true, get: function () { return registry_conversion_1.toAvailableComponents; } });
+Object.defineProperty(exports, "toAvailableTool", { enumerable: true, get: function () { return registry_conversion_1.toAvailableTool; } });
+Object.defineProperty(exports, "toAvailableTools", { enumerable: true, get: function () { return registry_conversion_1.toAvailableTools; } });
+var tool_executor_1 = require("./utils/tool-executor");
+Object.defineProperty(exports, "executeClientTool", { enumerable: true, get: function () { return tool_executor_1.executeClientTool; } });
+Object.defineProperty(exports, "executeAllPendingTools", { enumerable: true, get: function () { return tool_executor_1.executeAllPendingTools; } });
+var tool_call_tracker_1 = require("./utils/tool-call-tracker");
+Object.defineProperty(exports, "ToolCallTracker", { enumerable: true, get: function () { return tool_call_tracker_1.ToolCallTracker; } });
+var stream_handler_1 = require("./utils/stream-handler");
+Object.defineProperty(exports, "handleEventStream", { enumerable: true, get: function () { return stream_handler_1.handleEventStream; } });
+// =============================================================================
+// Re-exports from Beta SDK (compatible with v1)
+// =============================================================================
+// Tool definition helper
+var registry_1 = require("../util/registry");
+Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return registry_1.defineTool; } });
+// Built-in context helpers
+var context_helpers_1 = require("../context-helpers");
+Object.defineProperty(exports, "currentPageContextHelper", { enumerable: true, get: function () { return context_helpers_1.currentPageContextHelper; } });
+Object.defineProperty(exports, "currentTimeContextHelper", { enumerable: true, get: function () { return context_helpers_1.currentTimeContextHelper; } });
+// 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; } });
 //# sourceMappingURL=index.js.map

package/dist/v1/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;AAEH,yCAAyC;AACzC,mEAAmE;AACnE,oGAAoG;AAEpG,qCAAqC;AACrC,qDAAqD;AACrD,kEAAkE;AAClE,sEAAsE;AACtE,6EAA6E;AAC7E,mFAAmF;AAEnF,2CAA2C;AAC3C,uDAAuD","sourcesContent":["/**\n * @tambo-ai/react/v1 - React SDK for Tambo v1 API\n *\n * Provides React hooks and providers for building AI-powered applications\n * using the v1 streaming API with AG-UI protocol.\n *\n * Types are not re-exported. Import directly from specific type files:\n * - Custom events: import from '@tambo-ai/react/v1/types/event'\n * - Thread state: import from '@tambo-ai/react/v1/types/thread'\n * - Messages: import from '@tambo-ai/react/v1/types/message'\n * - Components: import from '@tambo-ai/react/v1/types/component'\n * - Tools: import from '@tambo-ai/react/v1/types/tool'\n *\n * SDK types: import directly from @tambo-ai/typescript-sdk\n * AG-UI events: import directly from @ag-ui/core\n * @example\n * ```typescript\n * import { TamboV1Provider, useTamboV1 } from '@tambo-ai/react/v1';\n *\n * function App() {\n *   return (\n *     <TamboV1Provider apiKey=\"your-api-key\">\n *       <ChatInterface />\n *     </TamboV1Provider>\n *   );\n * }\n *\n * function ChatInterface() {\n *   const { thread, sendMessage, isStreaming } = useTamboV1();\n *   // ... implementation\n * }\n * ```\n */\n\n// Providers (TODO: implement in Phase 7)\n// export { TamboV1Provider } from './providers/tambo-v1-provider';\n// export { TamboRegistryProvider } from '../providers/tambo-registry-provider'; // Reused from beta\n\n// Hooks (TODO: implement in Phase 7)\n// export { useTamboV1 } from './hooks/use-tambo-v1';\n// export { useTamboV1Thread } from './hooks/use-tambo-v1-thread';\n// export { useTamboV1Messages } from './hooks/use-tambo-v1-messages';\n// export { useTamboV1SendMessage } from './hooks/use-tambo-v1-send-message';\n// export { useTamboV1ComponentState } from './hooks/use-tambo-v1-component-state';\n\n// Utilities (TODO: implement in Phase 2-3)\n// export { applyJsonPatch } from './utils/json-patch';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;;;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,mEAIuC;AAHrC,oHAAA,eAAe,OAAA;AACf,kHAAA,aAAa,OAAA;AAIf,+EAM6C;AAL3C,gIAAA,qBAAqB,OAAA;AACrB,yHAAA,cAAc,OAAA;AACd,4HAAA,iBAAiB,OAAA;AACjB,8HAAA,mBAAmB,OAAA;AAIrB,4DAA4D;AAC5D,gFAA6E;AAApE,gIAAA,qBAAqB,OAAA;AAE9B,0DAA0D;AAC1D,8FAGqD;AAFnD,6IAAA,2BAA2B,OAAA;AAC3B,wIAAA,sBAAsB,OAAA;AAGxB,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,qDAAyE;AAAhE,0GAAA,UAAU,OAAA;AAEnB,+EAI2C;AAHzC,kIAAA,qBAAqB,OAAA;AAKvB,mEAA+D;AAAtD,uHAAA,gBAAgB,OAAA;AAEzB,6EAAwE;AAA/D,gIAAA,oBAAoB,OAAA;AAE7B,qFAG8C;AAF5C,wIAAA,wBAAwB,OAAA;AAI1B,sDAAsD;AACtD,4EAAoE;AAA3D,uHAAA,cAAc,OAAA;AAEvB,wDAAwD;AACxD,gFAAwE;AAA/D,2HAAA,gBAAgB,OAAA;AAEzB,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,iEASoC;AARlC,2HAAA,qBAAqB,OAAA;AACrB,mIAAA,6BAA6B,OAAA;AAC7B,4HAAA,sBAAsB,OAAA;AACtB,0HAAA,oBAAoB,OAAA;AACpB,6HAAA,uBAAuB,OAAA;AACvB,wHAAA,kBAAkB,OAAA;AAKpB,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,iDAAoD;AAA3C,4GAAA,cAAc,OAAA;AAEvB,mEAKqC;AAJnC,2HAAA,oBAAoB,OAAA;AACpB,4HAAA,qBAAqB,OAAA;AACrB,sHAAA,eAAe,OAAA;AACf,uHAAA,gBAAgB,OAAA;AAGlB,uDAI+B;AAH7B,kHAAA,iBAAiB,OAAA;AACjB,uHAAA,sBAAsB,OAAA;AAIxB,+DAA4D;AAAnD,oHAAA,eAAe,OAAA;AAExB,yDAA2D;AAAlD,mHAAA,iBAAiB,OAAA;AAE1B,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;AAoB1B,mBAAmB;AACnB,4DAAwD;AAA/C,+GAAA,YAAY,OAAA","sourcesContent":["/**\n * `@tambo-ai/react/v1` - React SDK for Tambo v1 API\n *\n * Provides React hooks and providers for building AI-powered applications\n * using the v1 streaming API with AG-UI protocol.\n *\n * ## Quick Start\n *\n * ```tsx\n * import {\n *   TamboV1Provider,\n *   useTamboV1,\n *   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 *       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  useContextKey,\n  type TamboV1ProviderProps,\n} from \"./providers/tambo-v1-provider\";\n\nexport {\n  TamboV1StreamProvider,\n  useStreamState,\n  useStreamDispatch,\n  useThreadManagement,\n  type ThreadManagement,\n} from \"./providers/tambo-v1-stream-context\";\n\n// Re-export registry provider from beta SDK (works with v1)\nexport { TamboRegistryProvider } from \"../providers/tambo-registry-provider\";\n\n// Re-export context helpers from beta SDK (works with v1)\nexport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"../providers/tambo-context-helpers-provider\";\n\n// =============================================================================\n// Hooks\n// =============================================================================\n\nexport { useTamboV1, type UseTamboV1Return } from \"./hooks/use-tambo-v1\";\n\nexport {\n  useTamboV1ThreadInput,\n  type UseTamboV1ThreadInputReturn,\n  type SubmitOptions,\n} 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 {\n  useTamboV1ComponentState,\n  type UseTamboV1ComponentStateReturn,\n} from \"./hooks/use-tambo-v1-component-state\";\n\n// Re-export client hook from beta SDK (works with v1)\nexport { useTamboClient } from \"../providers/tambo-client-provider\";\n\n// Re-export registry hook from beta SDK (works with v1)\nexport { useTamboRegistry } from \"../providers/tambo-registry-provider\";\n\n// =============================================================================\n// Component Rendering\n// =============================================================================\n\nexport {\n  useV1ComponentContent,\n  useV1ComponentContentOptional,\n  renderComponentContent,\n  renderMessageContent,\n  renderMessageComponents,\n  isComponentContent,\n  type V1ComponentContentContext,\n  type RenderComponentOptions,\n} from \"./utils/component-renderer\";\n\n// =============================================================================\n// Utilities\n// =============================================================================\n\nexport { applyJsonPatch } from \"./utils/json-patch\";\n\nexport {\n  toAvailableComponent,\n  toAvailableComponents,\n  toAvailableTool,\n  toAvailableTools,\n} from \"./utils/registry-conversion\";\n\nexport {\n  executeClientTool,\n  executeAllPendingTools,\n  type PendingToolCall,\n} from \"./utils/tool-executor\";\n\nexport { ToolCallTracker } from \"./utils/tool-call-tracker\";\n\nexport { handleEventStream } from \"./utils/stream-handler\";\n\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  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"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tambo-v1-provider.d.ts","sourceRoot":"","sources":["../../../src/v1/providers/tambo-v1-provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,EAGZ,KAAK,iBAAiB,EAEvB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,WAAW,EAAuB,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,yCAAyC,CAAC;AAEjD,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;AAQnC;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,SAAS,CAElD;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;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;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,UAAU,EACV,WAAW,EACX,QAAQ,GACT,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,qBA2CzC"}