@tambo-ai/react 0.69.1 → 0.71.0

package/esm/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/esm/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/esm/v1/hooks/use-tambo-v1.js

@@ -0,0 +1,84 @@
+"use client";
+/**
+ * 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.
+ */
+import { useContext, useMemo } from "react";
+import { useTamboClient } from "../../providers/tambo-client-provider";
+import { TamboRegistryContext, } from "../../providers/tambo-registry-provider";
+import { useStreamState, useStreamDispatch, useThreadManagement, } from "../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>
+ *   );
+ * }
+ * ```
+ */
+export function useTamboV1(threadId) {
+    const client = useTamboClient();
+    const streamState = useStreamState();
+    const dispatch = useStreamDispatch();
+    const registry = useContext(TamboRegistryContext);
+    const threadManagement = 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 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/esm/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;AAEb;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EACL,oBAAoB,GAErB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,sCAAsC,CAAC;AA+F9C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,UAAU,CAAC,QAAiB;IAC1C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAClD,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,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,OAAO,CAAC,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/esm/v1/hooks/use-tambo-v1.test.d.ts

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

package/esm/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/esm/v1/hooks/use-tambo-v1.test.js

@@ -0,0 +1,145 @@
+import { renderHook, act } from "@testing-library/react";
+import React from "react";
+import { useTamboClient } from "../../providers/tambo-client-provider";
+import { TamboRegistryContext, } from "../../providers/tambo-registry-provider";
+import { TamboV1StreamProvider } from "../providers/tambo-v1-stream-context";
+import { useTamboV1 } from "./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.createElement(TamboRegistryContext.Provider, { value: mockRegistry },
+            React.createElement(TamboV1StreamProvider, null, children)));
+    }
+    function TestWrapperWithThreadId({ children, }) {
+        return (React.createElement(TamboRegistryContext.Provider, { value: mockRegistry },
+            React.createElement(TamboV1StreamProvider, { threadId: "thread_123" }, children)));
+    }
+    beforeEach(() => {
+        jest.mocked(useTamboClient).mockReturnValue(mockTamboClient);
+        jest.clearAllMocks();
+    });
+    it("returns client from useTamboClient", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.client).toBe(mockTamboClient);
+    });
+    it("returns registry functions", () => {
+        const { result } = renderHook(() => 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 } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.thread).toBeUndefined();
+        expect(result.current.messages).toEqual([]);
+    });
+    it("returns thread state when threadId provided", () => {
+        const { result } = renderHook(() => 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 } = renderHook(() => 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 } = renderHook(() => 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 } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        expect(typeof result.current.dispatch).toBe("function");
+    });
+    it("provides thread management functions", () => {
+        const { result } = renderHook(() => 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 } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        // Initially no current thread
+        expect(result.current.currentThreadId).toBeNull();
+        expect(result.current.thread).toBeUndefined();
+        // Initialize a new thread
+        act(() => {
+            result.current.initThread("new_thread_1");
+        });
+        // Switch to the new thread
+        act(() => {
+            result.current.switchThread("new_thread_1");
+        });
+        expect(result.current.currentThreadId).toBe("new_thread_1");
+    });
+    it("starts new thread with generated ID", () => {
+        const { result } = renderHook(() => useTamboV1(), {
+            wrapper: TestWrapper,
+        });
+        let newThreadId;
+        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 } = renderHook(() => 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/esm/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/esm/v1/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * `@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.
+ *
+ * ## Quick Start
+ *
+ * ```tsx
+ * import {
+ *   TamboV1Provider,
+ *   useTamboV1,
+ *   useTamboV1SendMessage,
+ * } from '@tambo-ai/react/v1';
+ *
+ * function App() {
+ *   return (
+ *     <TamboV1Provider
+ *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
+ *       components={[WeatherCard]}
+ *       tools={[searchTool]}
+ *     >
+ *       <ChatInterface />
+ *     </TamboV1Provider>
+ *   );
+ * }
+ *
+ * function ChatInterface() {
+ *   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 { 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/esm/v1/index.d.ts.map

@@ -0,0 +1 @@
+{"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/esm/v1/index.js

@@ -0,0 +1,83 @@
+/**
+ * `@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.
+ *
+ * ## Quick Start
+ *
+ * ```tsx
+ * import {
+ *   TamboV1Provider,
+ *   useTamboV1,
+ *   useTamboV1SendMessage,
+ * } from '@tambo-ai/react/v1';
+ *
+ * function App() {
+ *   return (
+ *     <TamboV1Provider
+ *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}
+ *       components={[WeatherCard]}
+ *       tools={[searchTool]}
+ *     >
+ *       <ChatInterface />
+ *     </TamboV1Provider>
+ *   );
+ * }
+ *
+ * function ChatInterface() {
+ *   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'`
+ */
+// =============================================================================
+// Providers
+// =============================================================================
+export { TamboV1Provider, } from "./providers/tambo-v1-provider";
+export { TamboV1StreamProvider, useStreamState, useStreamDispatch, useThreadManagement, } from "./providers/tambo-v1-stream-context";
+// Re-export registry provider from beta SDK (works with v1)
+export { TamboRegistryProvider } from "../providers/tambo-registry-provider";
+// =============================================================================
+// Hooks
+// =============================================================================
+export { useTamboV1 } from "./hooks/use-tambo-v1";
+export { useTamboV1Messages, } from "./hooks/use-tambo-v1-messages";
+export { useTamboV1SendMessage, } from "./hooks/use-tambo-v1-send-message";
+export { useTamboV1Thread } from "./hooks/use-tambo-v1-thread";
+export { useTamboV1ThreadList } from "./hooks/use-tambo-v1-thread-list";
+// =============================================================================
+// Utilities
+// =============================================================================
+export { applyJsonPatch } from "./utils/json-patch";
+export { toAvailableComponent, toAvailableComponents, toAvailableTool, toAvailableTools, } from "./utils/registry-conversion";
+export { executeClientTool, executeAllPendingTools, } from "./utils/tool-executor";
+export { ToolCallTracker } from "./utils/tool-call-tracker";
+export { handleEventStream } from "./utils/stream-handler";
+//# sourceMappingURL=index.js.map

package/esm/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAEH,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EACL,eAAe,GAEhB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GAEpB,MAAM,qCAAqC,CAAC;AAE7C,4DAA4D;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAyB,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EACL,kBAAkB,GAEnB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,qBAAqB,GAEtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,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,GAEvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["/**\n * `@tambo-ai/react/v1` - React SDK for Tambo v1 API\n *\n * Provides React hooks and providers for building AI-powered applications\n * using the v1 streaming API with AG-UI protocol.\n *\n * ## Quick Start\n *\n * ```tsx\n * import {\n *   TamboV1Provider,\n *   useTamboV1,\n *   useTamboV1SendMessage,\n * } from '@tambo-ai/react/v1';\n *\n * function App() {\n *   return (\n *     <TamboV1Provider\n *       apiKey={process.env.NEXT_PUBLIC_TAMBO_API_KEY!}\n *       components={[WeatherCard]}\n *       tools={[searchTool]}\n *     >\n *       <ChatInterface />\n *     </TamboV1Provider>\n *   );\n * }\n *\n * function ChatInterface() {\n *   const [threadId, setThreadId] = useState<string>();\n *   const { messages, isStreaming } = useTamboV1(threadId);\n *   const sendMessage = useTamboV1SendMessage(threadId);\n *\n *   const handleSend = async (text: string) => {\n *     const result = await sendMessage.mutateAsync({\n *       message: { role: 'user', content: [{ type: 'text', text }] },\n *     });\n *     if (!threadId) setThreadId(result.threadId);\n *   };\n *\n *   return (\n *     <div>\n *       {messages.map(msg => <Message key={msg.id} message={msg} />)}\n *       {isStreaming && <LoadingIndicator />}\n *       <MessageInput onSend={handleSend} />\n *     </div>\n *   );\n * }\n * ```\n *\n * ## Type Imports\n *\n * Types are imported directly from specific files:\n * - Thread state: `import type { TamboV1Thread } from '@tambo-ai/react/v1/types/thread'`\n * - Messages: `import type { TamboV1Message } from '@tambo-ai/react/v1/types/message'`\n * - Custom events: `import type { ComponentStartEvent } from '@tambo-ai/react/v1/types/event'`\n *\n * SDK types: `import type { ... } from '@tambo-ai/typescript-sdk'`\n * AG-UI events: `import { EventType, type BaseEvent } from '@ag-ui/core'`\n */\n\n// =============================================================================\n// Providers\n// =============================================================================\n\nexport {\n  TamboV1Provider,\n  type TamboV1ProviderProps,\n} from \"./providers/tambo-v1-provider\";\n\nexport {\n  TamboV1StreamProvider,\n  useStreamState,\n  useStreamDispatch,\n  useThreadManagement,\n  type ThreadManagement,\n} from \"./providers/tambo-v1-stream-context\";\n\n// Re-export registry provider from beta SDK (works with v1)\nexport { TamboRegistryProvider } from \"../providers/tambo-registry-provider\";\n\n// =============================================================================\n// Hooks\n// =============================================================================\n\nexport { useTamboV1, type UseTamboV1Return } from \"./hooks/use-tambo-v1\";\n\nexport {\n  useTamboV1Messages,\n  type UseTamboV1MessagesReturn,\n} from \"./hooks/use-tambo-v1-messages\";\n\nexport {\n  useTamboV1SendMessage,\n  type SendMessageOptions,\n} from \"./hooks/use-tambo-v1-send-message\";\n\nexport { useTamboV1Thread } from \"./hooks/use-tambo-v1-thread\";\n\nexport { useTamboV1ThreadList } from \"./hooks/use-tambo-v1-thread-list\";\n\n// =============================================================================\n// Utilities\n// =============================================================================\n\nexport { applyJsonPatch } from \"./utils/json-patch\";\n\nexport {\n  toAvailableComponent,\n  toAvailableComponents,\n  toAvailableTool,\n  toAvailableTools,\n} from \"./utils/registry-conversion\";\n\nexport {\n  executeClientTool,\n  executeAllPendingTools,\n  type PendingToolCall,\n} from \"./utils/tool-executor\";\n\nexport { ToolCallTracker } from \"./utils/tool-call-tracker\";\n\nexport { handleEventStream } from \"./utils/stream-handler\";\n"]}