@tambo-ai/react 0.70.0 → 0.72.0

package/esm/v1/hooks/use-tambo-v1-thread-list.test.js

@@ -0,0 +1,93 @@
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { renderHook, waitFor } from "@testing-library/react";
+import React from "react";
+import { useTamboClient } from "../../providers/tambo-client-provider";
+import { useTamboV1ThreadList } from "./use-tambo-v1-thread-list";
+jest.mock("../../providers/tambo-client-provider", () => ({
+    useTamboClient: jest.fn(),
+}));
+describe("useTamboV1ThreadList", () => {
+    const mockThreads = {
+        threads: [
+            { id: "thread_1", runStatus: "idle" },
+            { id: "thread_2", runStatus: "complete" },
+        ],
+        hasMore: false,
+        nextCursor: undefined,
+    };
+    const mockThreadsApi = {
+        retrieve: jest.fn(),
+        list: jest.fn(),
+    };
+    const mockTamboAI = {
+        apiKey: "",
+        threads: mockThreadsApi,
+    };
+    let queryClient;
+    function TestWrapper({ children }) {
+        return (React.createElement(QueryClientProvider, { client: queryClient }, children));
+    }
+    beforeEach(() => {
+        queryClient = new QueryClient({
+            defaultOptions: {
+                queries: {
+                    retry: false,
+                },
+            },
+        });
+        jest.mocked(useTamboClient).mockReturnValue(mockTamboAI);
+        mockThreadsApi.list.mockReset();
+    });
+    it("fetches thread list", async () => {
+        mockThreadsApi.list.mockResolvedValue(mockThreads);
+        const { result } = renderHook(() => useTamboV1ThreadList(), {
+            wrapper: TestWrapper,
+        });
+        await waitFor(() => {
+            expect(result.current.data).toEqual(mockThreads);
+        });
+        expect(mockThreadsApi.list).toHaveBeenCalledWith(undefined);
+    });
+    it("passes list options to API", async () => {
+        mockThreadsApi.list.mockResolvedValue(mockThreads);
+        const { result } = renderHook(() => useTamboV1ThreadList({
+            contextKey: "test-context",
+            limit: "10",
+        }), { wrapper: TestWrapper });
+        await waitFor(() => {
+            expect(result.current.data).toEqual(mockThreads);
+        });
+        expect(mockThreadsApi.list).toHaveBeenCalledWith({
+            contextKey: "test-context",
+            limit: "10",
+        });
+    });
+    it("handles loading state", async () => {
+        let resolvePromise;
+        const promise = new Promise((resolve) => {
+            resolvePromise = resolve;
+        });
+        mockThreadsApi.list.mockReturnValue(promise);
+        const { result } = renderHook(() => useTamboV1ThreadList(), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.isLoading).toBe(true);
+        expect(result.current.data).toBeUndefined();
+        resolvePromise(mockThreads);
+        await waitFor(() => {
+            expect(result.current.isLoading).toBe(false);
+        });
+    });
+    it("handles error state", async () => {
+        const mockError = new Error("Failed to fetch threads");
+        mockThreadsApi.list.mockRejectedValue(mockError);
+        const { result } = renderHook(() => useTamboV1ThreadList(), {
+            wrapper: TestWrapper,
+        });
+        await waitFor(() => {
+            expect(result.current.isError).toBe(true);
+            expect(result.current.error).toBe(mockError);
+        });
+    });
+});
+//# sourceMappingURL=use-tambo-v1-thread-list.test.js.map

package/esm/v1/hooks/use-tambo-v1-thread-list.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-thread-list.test.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-thread-list.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport { renderHook, waitFor } from \"@testing-library/react\";\nimport React from \"react\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport { useTamboV1ThreadList } from \"./use-tambo-v1-thread-list\";\n\njest.mock(\"../../providers/tambo-client-provider\", () => ({\n  useTamboClient: jest.fn(),\n}));\n\ndescribe(\"useTamboV1ThreadList\", () => {\n  const mockThreads = {\n    threads: [\n      { id: \"thread_1\", runStatus: \"idle\" },\n      { id: \"thread_2\", runStatus: \"complete\" },\n    ],\n    hasMore: false,\n    nextCursor: undefined,\n  };\n\n  const mockThreadsApi = {\n    retrieve: jest.fn(),\n    list: jest.fn(),\n  };\n\n  const mockTamboAI = {\n    apiKey: \"\",\n    threads: mockThreadsApi,\n  } as unknown as TamboAI;\n\n  let queryClient: QueryClient;\n\n  function TestWrapper({ children }: { children: React.ReactNode }) {\n    return (\n      <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>\n    );\n  }\n\n  beforeEach(() => {\n    queryClient = new QueryClient({\n      defaultOptions: {\n        queries: {\n          retry: false,\n        },\n      },\n    });\n    jest.mocked(useTamboClient).mockReturnValue(mockTamboAI);\n    mockThreadsApi.list.mockReset();\n  });\n\n  it(\"fetches thread list\", async () => {\n    mockThreadsApi.list.mockResolvedValue(mockThreads);\n\n    const { result } = renderHook(() => useTamboV1ThreadList(), {\n      wrapper: TestWrapper,\n    });\n\n    await waitFor(() => {\n      expect(result.current.data).toEqual(mockThreads);\n    });\n\n    expect(mockThreadsApi.list).toHaveBeenCalledWith(undefined);\n  });\n\n  it(\"passes list options to API\", async () => {\n    mockThreadsApi.list.mockResolvedValue(mockThreads);\n\n    const { result } = renderHook(\n      () =>\n        useTamboV1ThreadList({\n          contextKey: \"test-context\",\n          limit: \"10\",\n        }),\n      { wrapper: TestWrapper },\n    );\n\n    await waitFor(() => {\n      expect(result.current.data).toEqual(mockThreads);\n    });\n\n    expect(mockThreadsApi.list).toHaveBeenCalledWith({\n      contextKey: \"test-context\",\n      limit: \"10\",\n    });\n  });\n\n  it(\"handles loading state\", async () => {\n    let resolvePromise: (value: unknown) => void;\n    const promise = new Promise((resolve) => {\n      resolvePromise = resolve;\n    });\n    mockThreadsApi.list.mockReturnValue(promise);\n\n    const { result } = renderHook(() => useTamboV1ThreadList(), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.isLoading).toBe(true);\n    expect(result.current.data).toBeUndefined();\n\n    resolvePromise!(mockThreads);\n    await waitFor(() => {\n      expect(result.current.isLoading).toBe(false);\n    });\n  });\n\n  it(\"handles error state\", async () => {\n    const mockError = new Error(\"Failed to fetch threads\");\n    mockThreadsApi.list.mockRejectedValue(mockError);\n\n    const { result } = renderHook(() => useTamboV1ThreadList(), {\n      wrapper: TestWrapper,\n    });\n\n    await waitFor(() => {\n      expect(result.current.isError).toBe(true);\n      expect(result.current.error).toBe(mockError);\n    });\n  });\n});\n"]}

package/esm/v1/hooks/use-tambo-v1-thread.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Thread Query Hook for v1 API
+ *
+ * React Query hook for fetching a single thread.
+ */
+import { type UseQueryOptions } from "@tanstack/react-query";
+import type { ThreadRetrieveResponse } from "@tambo-ai/typescript-sdk/resources/threads/threads";
+/**
+ * Hook to fetch a single thread by ID.
+ *
+ * Uses React Query for caching and automatic refetching.
+ * Thread data is considered stale after 1 second (real-time data).
+ *
+ * Returns the thread with all its messages and current run status directly
+ * from the SDK with no transformation.
+ * @param threadId - Thread ID to fetch
+ * @param options - Additional React Query options
+ * @returns React Query query object with thread data
+ * @example
+ * ```tsx
+ * function ThreadView({ threadId }: { threadId: string }) {
+ *   const { data: thread, isLoading, isError } = useTamboV1Thread(threadId);
+ *
+ *   if (isLoading) return <Spinner />;
+ *   if (isError) return <Error />;
+ *
+ *   return (
+ *     <div>
+ *       <div>Status: {thread.runStatus}</div>
+ *       {thread.messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useTamboV1Thread(threadId: string, options?: Omit<UseQueryOptions<ThreadRetrieveResponse>, "queryKey" | "queryFn">): import("@tanstack/react-query").UseQueryResult<ThreadRetrieveResponse, Error>;
+//# sourceMappingURL=use-tambo-v1-thread.d.ts.map

package/esm/v1/hooks/use-tambo-v1-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-thread.d.ts","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-thread.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AAGjG;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,IAAI,CACZ,eAAe,CAAC,sBAAsB,CAAC,EACvC,UAAU,GAAG,SAAS,CACvB,iFAUF"}

package/esm/v1/hooks/use-tambo-v1-thread.js

@@ -0,0 +1,46 @@
+"use client";
+/**
+ * Thread Query Hook for v1 API
+ *
+ * React Query hook for fetching a single thread.
+ */
+import { useQuery } from "@tanstack/react-query";
+import { useTamboClient } from "../../providers/tambo-client-provider";
+/**
+ * Hook to fetch a single thread by ID.
+ *
+ * Uses React Query for caching and automatic refetching.
+ * Thread data is considered stale after 1 second (real-time data).
+ *
+ * Returns the thread with all its messages and current run status directly
+ * from the SDK with no transformation.
+ * @param threadId - Thread ID to fetch
+ * @param options - Additional React Query options
+ * @returns React Query query object with thread data
+ * @example
+ * ```tsx
+ * function ThreadView({ threadId }: { threadId: string }) {
+ *   const { data: thread, isLoading, isError } = useTamboV1Thread(threadId);
+ *
+ *   if (isLoading) return <Spinner />;
+ *   if (isError) return <Error />;
+ *
+ *   return (
+ *     <div>
+ *       <div>Status: {thread.runStatus}</div>
+ *       {thread.messages.map(msg => <Message key={msg.id} message={msg} />)}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useTamboV1Thread(threadId, options) {
+    const client = useTamboClient();
+    return useQuery({
+        queryKey: ["v1-threads", threadId],
+        queryFn: async () => await client.threads.retrieve(threadId),
+        staleTime: 1000, // Consider stale after 1s (real-time data)
+        ...options,
+    });
+}
+//# sourceMappingURL=use-tambo-v1-thread.js.map

package/esm/v1/hooks/use-tambo-v1-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-thread.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-thread.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAwB,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,OAGC;IAED,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAEhC,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC;QAClC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC5D,SAAS,EAAE,IAAI,EAAE,2CAA2C;QAC5D,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC","sourcesContent":["\"use client\";\n\n/**\n * Thread Query Hook for v1 API\n *\n * React Query hook for fetching a single thread.\n */\n\nimport { useQuery, type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { ThreadRetrieveResponse } from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\n\n/**\n * Hook to fetch a single thread by ID.\n *\n * Uses React Query for caching and automatic refetching.\n * Thread data is considered stale after 1 second (real-time data).\n *\n * Returns the thread with all its messages and current run status directly\n * from the SDK with no transformation.\n * @param threadId - Thread ID to fetch\n * @param options - Additional React Query options\n * @returns React Query query object with thread data\n * @example\n * ```tsx\n * function ThreadView({ threadId }: { threadId: string }) {\n *   const { data: thread, isLoading, isError } = useTamboV1Thread(threadId);\n *\n *   if (isLoading) return <Spinner />;\n *   if (isError) return <Error />;\n *\n *   return (\n *     <div>\n *       <div>Status: {thread.runStatus}</div>\n *       {thread.messages.map(msg => <Message key={msg.id} message={msg} />)}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useTamboV1Thread(\n  threadId: string,\n  options?: Omit<\n    UseQueryOptions<ThreadRetrieveResponse>,\n    \"queryKey\" | \"queryFn\"\n  >,\n) {\n  const client = useTamboClient();\n\n  return useQuery({\n    queryKey: [\"v1-threads\", threadId],\n    queryFn: async () => await client.threads.retrieve(threadId),\n    staleTime: 1000, // Consider stale after 1s (real-time data)\n    ...options,\n  });\n}\n"]}

package/esm/v1/hooks/use-tambo-v1-thread.test.d.ts

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

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

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

package/esm/v1/hooks/use-tambo-v1-thread.test.js

@@ -0,0 +1,78 @@
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { renderHook, waitFor } from "@testing-library/react";
+import React from "react";
+import { useTamboClient } from "../../providers/tambo-client-provider";
+import { useTamboV1Thread } from "./use-tambo-v1-thread";
+jest.mock("../../providers/tambo-client-provider", () => ({
+    useTamboClient: jest.fn(),
+}));
+describe("useTamboV1Thread", () => {
+    const mockThread = {
+        id: "thread_123",
+        runStatus: "idle",
+        messages: [],
+        createdAt: "2024-01-01T00:00:00.000Z",
+        updatedAt: "2024-01-01T00:00:00.000Z",
+    };
+    const mockThreadsApi = {
+        retrieve: jest.fn(),
+        list: jest.fn(),
+    };
+    const mockTamboAI = {
+        apiKey: "",
+        threads: mockThreadsApi,
+    };
+    let queryClient;
+    function TestWrapper({ children }) {
+        return (React.createElement(QueryClientProvider, { client: queryClient }, children));
+    }
+    beforeEach(() => {
+        queryClient = new QueryClient({
+            defaultOptions: {
+                queries: {
+                    retry: false,
+                },
+            },
+        });
+        jest.mocked(useTamboClient).mockReturnValue(mockTamboAI);
+        mockThreadsApi.retrieve.mockReset();
+    });
+    it("fetches thread by ID", async () => {
+        mockThreadsApi.retrieve.mockResolvedValue(mockThread);
+        const { result } = renderHook(() => useTamboV1Thread("thread_123"), {
+            wrapper: TestWrapper,
+        });
+        await waitFor(() => {
+            expect(result.current.data).toEqual(mockThread);
+        });
+        expect(mockThreadsApi.retrieve).toHaveBeenCalledWith("thread_123");
+    });
+    it("handles loading state", async () => {
+        let resolvePromise;
+        const promise = new Promise((resolve) => {
+            resolvePromise = resolve;
+        });
+        mockThreadsApi.retrieve.mockReturnValue(promise);
+        const { result } = renderHook(() => useTamboV1Thread("thread_123"), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.isLoading).toBe(true);
+        expect(result.current.data).toBeUndefined();
+        resolvePromise(mockThread);
+        await waitFor(() => {
+            expect(result.current.isLoading).toBe(false);
+        });
+    });
+    it("handles error state", async () => {
+        const mockError = new Error("Thread not found");
+        mockThreadsApi.retrieve.mockRejectedValue(mockError);
+        const { result } = renderHook(() => useTamboV1Thread("thread_123"), {
+            wrapper: TestWrapper,
+        });
+        await waitFor(() => {
+            expect(result.current.isError).toBe(true);
+            expect(result.current.error).toBe(mockError);
+        });
+    });
+});
+//# sourceMappingURL=use-tambo-v1-thread.test.js.map

package/esm/v1/hooks/use-tambo-v1-thread.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-thread.test.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-thread.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport { renderHook, waitFor } from \"@testing-library/react\";\nimport React from \"react\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport { useTamboV1Thread } from \"./use-tambo-v1-thread\";\n\njest.mock(\"../../providers/tambo-client-provider\", () => ({\n  useTamboClient: jest.fn(),\n}));\n\ndescribe(\"useTamboV1Thread\", () => {\n  const mockThread = {\n    id: \"thread_123\",\n    runStatus: \"idle\",\n    messages: [],\n    createdAt: \"2024-01-01T00:00:00.000Z\",\n    updatedAt: \"2024-01-01T00:00:00.000Z\",\n  };\n\n  const mockThreadsApi = {\n    retrieve: jest.fn(),\n    list: jest.fn(),\n  };\n\n  const mockTamboAI = {\n    apiKey: \"\",\n    threads: mockThreadsApi,\n  } as unknown as TamboAI;\n\n  let queryClient: QueryClient;\n\n  function TestWrapper({ children }: { children: React.ReactNode }) {\n    return (\n      <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>\n    );\n  }\n\n  beforeEach(() => {\n    queryClient = new QueryClient({\n      defaultOptions: {\n        queries: {\n          retry: false,\n        },\n      },\n    });\n    jest.mocked(useTamboClient).mockReturnValue(mockTamboAI);\n    mockThreadsApi.retrieve.mockReset();\n  });\n\n  it(\"fetches thread by ID\", async () => {\n    mockThreadsApi.retrieve.mockResolvedValue(mockThread);\n\n    const { result } = renderHook(() => useTamboV1Thread(\"thread_123\"), {\n      wrapper: TestWrapper,\n    });\n\n    await waitFor(() => {\n      expect(result.current.data).toEqual(mockThread);\n    });\n\n    expect(mockThreadsApi.retrieve).toHaveBeenCalledWith(\"thread_123\");\n  });\n\n  it(\"handles loading state\", async () => {\n    let resolvePromise: (value: unknown) => void;\n    const promise = new Promise((resolve) => {\n      resolvePromise = resolve;\n    });\n    mockThreadsApi.retrieve.mockReturnValue(promise);\n\n    const { result } = renderHook(() => useTamboV1Thread(\"thread_123\"), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.isLoading).toBe(true);\n    expect(result.current.data).toBeUndefined();\n\n    resolvePromise!(mockThread);\n    await waitFor(() => {\n      expect(result.current.isLoading).toBe(false);\n    });\n  });\n\n  it(\"handles error state\", async () => {\n    const mockError = new Error(\"Thread not found\");\n    mockThreadsApi.retrieve.mockRejectedValue(mockError);\n\n    const { result } = renderHook(() => useTamboV1Thread(\"thread_123\"), {\n      wrapper: TestWrapper,\n    });\n\n    await waitFor(() => {\n      expect(result.current.isError).toBe(true);\n      expect(result.current.error).toBe(mockError);\n    });\n  });\n});\n"]}

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":""}