@tambo-ai/react 0.70.0 → 0.71.0

package/dist/v1/hooks/use-tambo-v1.d.ts

@@ -0,0 +1,107 @@
+import type TamboAI from "@tambo-ai/typescript-sdk";
+import { type TamboRegistryContext as TamboRegistryContextType } from "../../providers/tambo-registry-provider";
+import { useStreamDispatch, type ThreadManagement } from "../providers/tambo-v1-stream-context";
+import type { StreamingState } from "../types/thread";
+import type { TamboV1Message } from "../types/message";
+import type { ThreadState } from "../utils/event-accumulator";
+/**
+ * Return type for useTamboV1 hook
+ */
+export interface UseTamboV1Return {
+    /**
+     * The Tambo API client instance
+     */
+    client: TamboAI;
+    /**
+     * Current thread state for the given threadId, or undefined if not loaded
+     */
+    thread: ThreadState | undefined;
+    /**
+     * Messages in the current thread
+     */
+    messages: TamboV1Message[];
+    /**
+     * Current streaming state
+     */
+    streamingState: StreamingState;
+    /**
+     * Whether the thread is currently streaming a response
+     */
+    isStreaming: boolean;
+    /**
+     * Whether the thread is waiting for the AI to start responding
+     */
+    isWaiting: boolean;
+    /**
+     * Whether the thread is idle (not streaming or waiting)
+     */
+    isIdle: boolean;
+    /**
+     * Register a component with the registry
+     */
+    registerComponent: TamboRegistryContextType["registerComponent"];
+    /**
+     * Register a tool with the registry
+     */
+    registerTool: TamboRegistryContextType["registerTool"];
+    /**
+     * Register multiple tools with the registry
+     */
+    registerTools: TamboRegistryContextType["registerTools"];
+    /**
+     * The component registry (Map of name -> component definition)
+     */
+    componentList: TamboRegistryContextType["componentList"];
+    /**
+     * The tool registry (Map of name -> tool definition)
+     */
+    toolRegistry: TamboRegistryContextType["toolRegistry"];
+    /**
+     * Current thread ID (may be null if no thread is active)
+     */
+    currentThreadId: string | null;
+    /**
+     * Initialize a new thread in the stream context
+     */
+    initThread: ThreadManagement["initThread"];
+    /**
+     * Switch the current active thread
+     */
+    switchThread: ThreadManagement["switchThread"];
+    /**
+     * Start a new thread (generates a temporary ID)
+     */
+    startNewThread: ThreadManagement["startNewThread"];
+    /**
+     * Dispatch function for stream events (advanced usage)
+     */
+    dispatch: ReturnType<typeof useStreamDispatch>;
+}
+/**
+ * Main hook for accessing Tambo v1 functionality.
+ *
+ * Combines thread state, streaming status, registry, and client
+ * into a single convenient hook.
+ * @param threadId - Optional thread ID to get state for
+ * @returns Combined v1 context with thread state and utilities
+ * @example
+ * ```tsx
+ * function ChatInterface() {
+ *   const {
+ *     thread,
+ *     messages,
+ *     isStreaming,
+ *     registerComponent,
+ *   } = useTamboV1('thread_123');
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *       {isStreaming && <LoadingIndicator />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useTamboV1(threadId?: string): UseTamboV1Return;
+//# sourceMappingURL=use-tambo-v1.d.ts.map

package/dist/v1/hooks/use-tambo-v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1.d.ts","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAEL,KAAK,oBAAoB,IAAI,wBAAwB,EACtD,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAEL,iBAAiB,EAEjB,KAAK,gBAAgB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAEhC;;OAEG;IACH,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B;;OAEG;IACH,cAAc,EAAE,cAAc,CAAC;IAE/B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,iBAAiB,EAAE,wBAAwB,CAAC,mBAAmB,CAAC,CAAC;IAEjE;;OAEG;IACH,YAAY,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAAC;IAEvD;;OAEG;IACH,aAAa,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAEzD;;OAEG;IACH,aAAa,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAEzD;;OAEG;IACH,YAAY,EAAE,wBAAwB,CAAC,cAAc,CAAC,CAAC;IAEvD;;OAEG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,UAAU,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAE3C;;OAEG;IACH,YAAY,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAE/C;;OAEG;IACH,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAEnD;;OAEG;IACH,QAAQ,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAgD9D"}

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

@@ -0,0 +1,87 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTamboV1 = useTamboV1;
+/**
+ * useTamboV1 - Main Hook for v1 API
+ *
+ * Combines all v1 contexts into a single hook for convenient access
+ * to thread state, streaming status, registry, and client.
+ */
+const react_1 = 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");
+/**
+ * Main hook for accessing Tambo v1 functionality.
+ *
+ * Combines thread state, streaming status, registry, and client
+ * into a single convenient hook.
+ * @param threadId - Optional thread ID to get state for
+ * @returns Combined v1 context with thread state and utilities
+ * @example
+ * ```tsx
+ * function ChatInterface() {
+ *   const {
+ *     thread,
+ *     messages,
+ *     isStreaming,
+ *     registerComponent,
+ *   } = useTamboV1('thread_123');
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *       {isStreaming && <LoadingIndicator />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function useTamboV1(threadId) {
+    const client = (0, tambo_client_provider_1.useTamboClient)();
+    const streamState = (0, tambo_v1_stream_context_1.useStreamState)();
+    const dispatch = (0, tambo_v1_stream_context_1.useStreamDispatch)();
+    const registry = (0, react_1.useContext)(tambo_registry_provider_1.TamboRegistryContext);
+    const threadManagement = (0, tambo_v1_stream_context_1.useThreadManagement)();
+    // Get thread state for the given threadId (or current thread if not specified)
+    const effectiveThreadId = threadId ?? streamState.currentThreadId;
+    const threadState = effectiveThreadId
+        ? streamState.threadMap[effectiveThreadId]
+        : undefined;
+    // Memoize the return object to prevent unnecessary re-renders
+    return (0, react_1.useMemo)(() => {
+        const thread = threadState;
+        const messages = thread?.thread.messages ?? [];
+        const streamingState = thread?.streaming ?? {
+            status: "idle",
+        };
+        return {
+            client,
+            thread,
+            messages,
+            streamingState,
+            isStreaming: streamingState.status === "streaming",
+            isWaiting: streamingState.status === "waiting",
+            isIdle: streamingState.status === "idle",
+            registerComponent: registry.registerComponent,
+            registerTool: registry.registerTool,
+            registerTools: registry.registerTools,
+            componentList: registry.componentList,
+            toolRegistry: registry.toolRegistry,
+            currentThreadId: streamState.currentThreadId,
+            initThread: threadManagement.initThread,
+            switchThread: threadManagement.switchThread,
+            startNewThread: threadManagement.startNewThread,
+            dispatch,
+        };
+    }, [
+        client,
+        threadState,
+        registry,
+        streamState.currentThreadId,
+        threadManagement,
+        dispatch,
+    ]);
+}
+//# sourceMappingURL=use-tambo-v1.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1.ts"],"names":[],"mappings":";AAAA,YAAY,CAAC;;AA8Ib,gCAgDC;AA5LD;;;;;GAKG;AAEH,iCAA4C;AAE5C,iFAAuE;AACvE,qFAGiD;AACjD,kFAK8C;AA+F9C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,UAAU,CAAC,QAAiB;IAC1C,MAAM,MAAM,GAAG,IAAA,sCAAc,GAAE,CAAC;IAChC,MAAM,WAAW,GAAG,IAAA,wCAAc,GAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAA,2CAAiB,GAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAA,kBAAU,EAAC,8CAAoB,CAAC,CAAC;IAClD,MAAM,gBAAgB,GAAG,IAAA,6CAAmB,GAAE,CAAC;IAE/C,+EAA+E;IAC/E,MAAM,iBAAiB,GAAG,QAAQ,IAAI,WAAW,CAAC,eAAe,CAAC;IAClE,MAAM,WAAW,GAAG,iBAAiB;QACnC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,iBAAiB,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;IAEd,8DAA8D;IAC9D,OAAO,IAAA,eAAO,EAAC,GAAG,EAAE;QAClB,MAAM,MAAM,GAAG,WAAW,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC/C,MAAM,cAAc,GAAmB,MAAM,EAAE,SAAS,IAAI;YAC1D,MAAM,EAAE,MAAe;SACxB,CAAC;QAEF,OAAO;YACL,MAAM;YACN,MAAM;YACN,QAAQ;YACR,cAAc;YACd,WAAW,EAAE,cAAc,CAAC,MAAM,KAAK,WAAW;YAClD,SAAS,EAAE,cAAc,CAAC,MAAM,KAAK,SAAS;YAC9C,MAAM,EAAE,cAAc,CAAC,MAAM,KAAK,MAAM;YACxC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;YAC7C,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,eAAe,EAAE,WAAW,CAAC,eAAe;YAC5C,UAAU,EAAE,gBAAgB,CAAC,UAAU;YACvC,YAAY,EAAE,gBAAgB,CAAC,YAAY;YAC3C,cAAc,EAAE,gBAAgB,CAAC,cAAc;YAC/C,QAAQ;SACT,CAAC;IACJ,CAAC,EAAE;QACD,MAAM;QACN,WAAW;QACX,QAAQ;QACR,WAAW,CAAC,eAAe;QAC3B,gBAAgB;QAChB,QAAQ;KACT,CAAC,CAAC;AACL,CAAC","sourcesContent":["\"use client\";\n\n/**\n * useTamboV1 - Main Hook for v1 API\n *\n * Combines all v1 contexts into a single hook for convenient access\n * to thread state, streaming status, registry, and client.\n */\n\nimport { useContext, useMemo } from \"react\";\nimport type TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport {\n  TamboRegistryContext,\n  type TamboRegistryContext as TamboRegistryContextType,\n} from \"../../providers/tambo-registry-provider\";\nimport {\n  useStreamState,\n  useStreamDispatch,\n  useThreadManagement,\n  type ThreadManagement,\n} from \"../providers/tambo-v1-stream-context\";\nimport type { StreamingState } from \"../types/thread\";\nimport type { TamboV1Message } from \"../types/message\";\nimport type { ThreadState } from \"../utils/event-accumulator\";\n\n/**\n * Return type for useTamboV1 hook\n */\nexport interface UseTamboV1Return {\n  /**\n   * The Tambo API client instance\n   */\n  client: TamboAI;\n\n  /**\n   * Current thread state for the given threadId, or undefined if not loaded\n   */\n  thread: ThreadState | undefined;\n\n  /**\n   * Messages in the current thread\n   */\n  messages: TamboV1Message[];\n\n  /**\n   * Current streaming state\n   */\n  streamingState: StreamingState;\n\n  /**\n   * Whether the thread is currently streaming a response\n   */\n  isStreaming: boolean;\n\n  /**\n   * Whether the thread is waiting for the AI to start responding\n   */\n  isWaiting: boolean;\n\n  /**\n   * Whether the thread is idle (not streaming or waiting)\n   */\n  isIdle: boolean;\n\n  /**\n   * Register a component with the registry\n   */\n  registerComponent: TamboRegistryContextType[\"registerComponent\"];\n\n  /**\n   * Register a tool with the registry\n   */\n  registerTool: TamboRegistryContextType[\"registerTool\"];\n\n  /**\n   * Register multiple tools with the registry\n   */\n  registerTools: TamboRegistryContextType[\"registerTools\"];\n\n  /**\n   * The component registry (Map of name -> component definition)\n   */\n  componentList: TamboRegistryContextType[\"componentList\"];\n\n  /**\n   * The tool registry (Map of name -> tool definition)\n   */\n  toolRegistry: TamboRegistryContextType[\"toolRegistry\"];\n\n  /**\n   * Current thread ID (may be null if no thread is active)\n   */\n  currentThreadId: string | null;\n\n  /**\n   * Initialize a new thread in the stream context\n   */\n  initThread: ThreadManagement[\"initThread\"];\n\n  /**\n   * Switch the current active thread\n   */\n  switchThread: ThreadManagement[\"switchThread\"];\n\n  /**\n   * Start a new thread (generates a temporary ID)\n   */\n  startNewThread: ThreadManagement[\"startNewThread\"];\n\n  /**\n   * Dispatch function for stream events (advanced usage)\n   */\n  dispatch: ReturnType<typeof useStreamDispatch>;\n}\n\n/**\n * Main hook for accessing Tambo v1 functionality.\n *\n * Combines thread state, streaming status, registry, and client\n * into a single convenient hook.\n * @param threadId - Optional thread ID to get state for\n * @returns Combined v1 context with thread state and utilities\n * @example\n * ```tsx\n * function ChatInterface() {\n *   const {\n *     thread,\n *     messages,\n *     isStreaming,\n *     registerComponent,\n *   } = useTamboV1('thread_123');\n *\n *   return (\n *     <div>\n *       {messages.map(msg => <Message key={msg.id} message={msg} />)}\n *       {isStreaming && <LoadingIndicator />}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useTamboV1(threadId?: string): UseTamboV1Return {\n  const client = useTamboClient();\n  const streamState = useStreamState();\n  const dispatch = useStreamDispatch();\n  const registry = useContext(TamboRegistryContext);\n  const threadManagement = useThreadManagement();\n\n  // Get thread state for the given threadId (or current thread if not specified)\n  const effectiveThreadId = threadId ?? streamState.currentThreadId;\n  const threadState = effectiveThreadId\n    ? streamState.threadMap[effectiveThreadId]\n    : undefined;\n\n  // Memoize the return object to prevent unnecessary re-renders\n  return useMemo(() => {\n    const thread = threadState;\n    const messages = thread?.thread.messages ?? [];\n    const streamingState: StreamingState = thread?.streaming ?? {\n      status: \"idle\" as const,\n    };\n\n    return {\n      client,\n      thread,\n      messages,\n      streamingState,\n      isStreaming: streamingState.status === \"streaming\",\n      isWaiting: streamingState.status === \"waiting\",\n      isIdle: streamingState.status === \"idle\",\n      registerComponent: registry.registerComponent,\n      registerTool: registry.registerTool,\n      registerTools: registry.registerTools,\n      componentList: registry.componentList,\n      toolRegistry: registry.toolRegistry,\n      currentThreadId: streamState.currentThreadId,\n      initThread: threadManagement.initThread,\n      switchThread: threadManagement.switchThread,\n      startNewThread: threadManagement.startNewThread,\n      dispatch,\n    };\n  }, [\n    client,\n    threadState,\n    registry,\n    streamState.currentThreadId,\n    threadManagement,\n    dispatch,\n  ]);\n}\n"]}

package/dist/v1/hooks/use-tambo-v1.test.d.ts

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

package/dist/v1/hooks/use-tambo-v1.test.d.ts.map

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

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,73 @@
 /**
- * @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,
+ *   useTamboV1SendMessage,
+ * } 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 sendMessage = useTamboV1SendMessage(threadId);
+ *
+ *   const handleSend = async (text: string) => {
+ *     const result = await sendMessage.mutateAsync({
+ *       message: { role: 'user', content: [{ type: 'text', text }] },
+ *     });
+ *     if (!threadId) setThreadId(result.threadId);
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *       {isStreaming && <LoadingIndicator />}
+ *       <MessageInput onSend={handleSend} />
+ *     </div>
+ *   );
  * }
  * ```
+ *
+ * ## 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, 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 { useTamboV1, type UseTamboV1Return } from "./hooks/use-tambo-v1";
+export { useTamboV1Messages, type UseTamboV1MessagesReturn, } from "./hooks/use-tambo-v1-messages";
+export { useTamboV1SendMessage, type SendMessageOptions, } from "./hooks/use-tambo-v1-send-message";
+export { useTamboV1Thread } from "./hooks/use-tambo-v1-thread";
+export { useTamboV1ThreadList } from "./hooks/use-tambo-v1-thread-list";
+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";
 //# 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,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;AAM7E,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,EACrB,KAAK,kBAAkB,GACxB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAMxE,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"}

package/dist/v1/index.js

@@ -1,47 +1,106 @@
 "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,
+ *   useTamboV1SendMessage,
+ * } 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 sendMessage = useTamboV1SendMessage(threadId);
+ *
+ *   const handleSend = async (text: string) => {
+ *     const result = await sendMessage.mutateAsync({
+ *       message: { role: 'user', content: [{ type: 'text', text }] },
+ *     });
+ *     if (!threadId) setThreadId(result.threadId);
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *       {isStreaming && <LoadingIndicator />}
+ *       <MessageInput onSend={handleSend} />
+ *     </div>
+ *   );
  * }
  * ```
+ *
+ * ## 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.handleEventStream = exports.ToolCallTracker = exports.executeAllPendingTools = exports.executeClientTool = exports.toAvailableTools = exports.toAvailableTool = exports.toAvailableComponents = exports.toAvailableComponent = exports.applyJsonPatch = exports.useTamboV1ThreadList = exports.useTamboV1Thread = exports.useTamboV1SendMessage = exports.useTamboV1Messages = exports.useTamboV1 = exports.TamboRegistryProvider = exports.useThreadManagement = exports.useStreamDispatch = exports.useStreamState = exports.TamboV1StreamProvider = 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; } });
+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; } });
+// =============================================================================
+// 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_messages_1 = require("./hooks/use-tambo-v1-messages");
+Object.defineProperty(exports, "useTamboV1Messages", { enumerable: true, get: function () { return use_tambo_v1_messages_1.useTamboV1Messages; } });
+var use_tambo_v1_send_message_1 = require("./hooks/use-tambo-v1-send-message");
+Object.defineProperty(exports, "useTamboV1SendMessage", { enumerable: true, get: function () { return use_tambo_v1_send_message_1.useTamboV1SendMessage; } });
+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; } });
+// =============================================================================
+// 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; } });
 //# sourceMappingURL=index.js.map