@tambo-ai/react 0.73.0 → 0.74.0

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

@@ -1,11 +1,7 @@
 "use client";
-/**
- * Thread List Query Hook for v1 API
- *
- * React Query hook for fetching a list of threads.
- */
-import { useQuery } from "@tanstack/react-query";
-import { useTamboClient } from "../../providers/tambo-client-provider";
+import { useTamboClient } from "../../providers/tambo-client-provider.js";
+import { useTamboQuery } from "../../hooks/react-query-hooks.js";
+import { useTamboV1Config } from "../providers/tambo-v1-provider.js";
 /**
  * Hook to fetch a list of threads.
  *
@@ -22,7 +18,7 @@ import { useTamboClient } from "../../providers/tambo-client-provider";
  * function ThreadList({ userKey }: { userKey?: string }) {
  *   const { data, isLoading, isError } = useTamboV1ThreadList({
  *     userKey,
- *     limit: "20",
+ *     limit: 20,
  *   });
  *
  *   if (isLoading) return <Spinner />;
@@ -43,9 +39,14 @@ import { useTamboClient } from "../../providers/tambo-client-provider";
  */
 export function useTamboV1ThreadList(listOptions, queryOptions) {
     const client = useTamboClient();
-    return useQuery({
-        queryKey: ["v1-threads", "list", listOptions],
-        queryFn: async () => await client.threads.list(listOptions),
+    const { userKey: contextUserKey } = useTamboV1Config();
+    // Merge userKey from context with provided options (explicit option takes precedence)
+    const effectiveOptions = (listOptions?.userKey ?? contextUserKey)
+        ? { ...listOptions, userKey: listOptions?.userKey ?? contextUserKey }
+        : listOptions;
+    return useTamboQuery({
+        queryKey: ["v1-threads", "list", effectiveOptions],
+        queryFn: async () => await client.threads.list(effectiveOptions),
         staleTime: 5000, // Consider stale after 5s
         ...queryOptions,
     });

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

@@ -1 +1 @@
-{"version":3,"file":"use-tambo-v1-thread-list.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-thread-list.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAwB,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAwBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAA+B,EAC/B,YAGC;IAED,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAEhC,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC;QAC7C,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;QAC3D,SAAS,EAAE,IAAI,EAAE,0BAA0B;QAC3C,GAAG,YAAY;KAChB,CAAC,CAAC;AACL,CAAC","sourcesContent":["\"use client\";\n\n/**\n * Thread List Query Hook for v1 API\n *\n * React Query hook for fetching a list of threads.\n */\n\nimport { useQuery, type UseQueryOptions } from \"@tanstack/react-query\";\nimport type { ThreadListResponse } from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\n\n/**\n * Options for fetching thread list\n */\nexport interface ThreadListOptions {\n  /**\n   * User key to scope thread list.\n   * Only threads owned by this userKey will be returned.\n   * If not provided here, uses the userKey from TamboV1Provider context.\n   */\n  userKey?: string;\n\n  /**\n   * Maximum number of threads to return (as string per SDK)\n   */\n  limit?: string;\n\n  /**\n   * Pagination cursor for fetching next page\n   */\n  cursor?: string;\n}\n\n/**\n * Hook to fetch a list of threads.\n *\n * Uses React Query for caching and automatic refetching.\n * Threads are considered stale after 5 seconds.\n *\n * Returns the thread list directly from the SDK with no transformation.\n * Each thread includes runStatus, metadata, and all SDK fields.\n * @param listOptions - Filtering and pagination options\n * @param queryOptions - Additional React Query options\n * @returns React Query query object with thread list\n * @example\n * ```tsx\n * function ThreadList({ userKey }: { userKey?: string }) {\n *   const { data, isLoading, isError } = useTamboV1ThreadList({\n *     userKey,\n *     limit: \"20\",\n *   });\n *\n *   if (isLoading) return <Spinner />;\n *   if (isError) return <Error />;\n *\n *   return (\n *     <ul>\n *       {data.threads.map(thread => (\n *         <li key={thread.id}>\n *           {thread.id} - {thread.runStatus}\n *         </li>\n *       ))}\n *       {data.hasMore && <LoadMoreButton cursor={data.nextCursor} />}\n *     </ul>\n *   );\n * }\n * ```\n */\nexport function useTamboV1ThreadList(\n  listOptions?: ThreadListOptions,\n  queryOptions?: Omit<\n    UseQueryOptions<ThreadListResponse>,\n    \"queryKey\" | \"queryFn\"\n  >,\n) {\n  const client = useTamboClient();\n\n  return useQuery({\n    queryKey: [\"v1-threads\", \"list\", listOptions],\n    queryFn: async () => await client.threads.list(listOptions),\n    staleTime: 5000, // Consider stale after 5s\n    ...queryOptions,\n  });\n}\n"]}
+{"version":3,"file":"use-tambo-v1-thread-list.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-thread-list.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAab,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AASlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAA8B,EAC9B,YAGC;IAED,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAEvD,sFAAsF;IACtF,MAAM,gBAAgB,GACpB,CAAC,WAAW,EAAE,OAAO,IAAI,cAAc,CAAC;QACtC,CAAC,CAAC,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,cAAc,EAAE;QACrE,CAAC,CAAC,WAAW,CAAC;IAElB,OAAO,aAAa,CAAC;QACnB,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,CAAC;QAClD,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAChE,SAAS,EAAE,IAAI,EAAE,0BAA0B;QAC3C,GAAG,YAAY;KAChB,CAAC,CAAC;AACL,CAAC","sourcesContent":["\"use client\";\n\n/**\n * Thread List Query Hook for v1 API\n *\n * React Query hook for fetching a list of threads.\n */\n\nimport type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type {\n  ThreadListParams,\n  ThreadListResponse,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport { useTamboQuery } from \"../../hooks/react-query-hooks\";\nimport { useTamboV1Config } from \"../providers/tambo-v1-provider\";\n\n/**\n * Options for fetching thread list.\n * Re-exported from SDK for convenience.\n * Note: userKey can also be provided via TamboV1Provider context.\n */\nexport type { ThreadListParams as ThreadListOptions };\n\n/**\n * Hook to fetch a list of threads.\n *\n * Uses React Query for caching and automatic refetching.\n * Threads are considered stale after 5 seconds.\n *\n * Returns the thread list directly from the SDK with no transformation.\n * Each thread includes runStatus, metadata, and all SDK fields.\n * @param listOptions - Filtering and pagination options\n * @param queryOptions - Additional React Query options\n * @returns React Query query object with thread list\n * @example\n * ```tsx\n * function ThreadList({ userKey }: { userKey?: string }) {\n *   const { data, isLoading, isError } = useTamboV1ThreadList({\n *     userKey,\n *     limit: 20,\n *   });\n *\n *   if (isLoading) return <Spinner />;\n *   if (isError) return <Error />;\n *\n *   return (\n *     <ul>\n *       {data.threads.map(thread => (\n *         <li key={thread.id}>\n *           {thread.id} - {thread.runStatus}\n *         </li>\n *       ))}\n *       {data.hasMore && <LoadMoreButton cursor={data.nextCursor} />}\n *     </ul>\n *   );\n * }\n * ```\n */\nexport function useTamboV1ThreadList(\n  listOptions?: ThreadListParams,\n  queryOptions?: Omit<\n    UseQueryOptions<ThreadListResponse>,\n    \"queryKey\" | \"queryFn\"\n  >,\n) {\n  const client = useTamboClient();\n  const { userKey: contextUserKey } = useTamboV1Config();\n\n  // Merge userKey from context with provided options (explicit option takes precedence)\n  const effectiveOptions: ThreadListParams | undefined =\n    (listOptions?.userKey ?? contextUserKey)\n      ? { ...listOptions, userKey: listOptions?.userKey ?? contextUserKey }\n      : listOptions;\n\n  return useTamboQuery({\n    queryKey: [\"v1-threads\", \"list\", effectiveOptions],\n    queryFn: async () => await client.threads.list(effectiveOptions),\n    staleTime: 5000, // Consider stale after 5s\n    ...queryOptions,\n  });\n}\n"]}

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

@@ -1,10 +1,15 @@
 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";
+import { useTamboClient, useTamboQueryClient, } from "../../providers/tambo-client-provider.js";
+import { useTamboV1Config } from "../providers/tambo-v1-provider.js";
+import { useTamboV1ThreadList } from "./use-tambo-v1-thread-list.js";
 jest.mock("../../providers/tambo-client-provider", () => ({
     useTamboClient: jest.fn(),
+    useTamboQueryClient: jest.fn(),
+}));
+jest.mock("../providers/tambo-v1-provider", () => ({
+    useTamboV1Config: jest.fn(),
 }));
 describe("useTamboV1ThreadList", () => {
     const mockThreads = {
@@ -36,6 +41,8 @@ describe("useTamboV1ThreadList", () => {
             },
         });
         jest.mocked(useTamboClient).mockReturnValue(mockTamboAI);
+        jest.mocked(useTamboQueryClient).mockReturnValue(queryClient);
+        jest.mocked(useTamboV1Config).mockReturnValue({ userKey: undefined });
         mockThreadsApi.list.mockReset();
     });
     it("fetches thread list", async () => {
@@ -52,14 +59,14 @@ describe("useTamboV1ThreadList", () => {
         mockThreadsApi.list.mockResolvedValue(mockThreads);
         const { result } = renderHook(() => useTamboV1ThreadList({
             userKey: "test-context",
-            limit: "10",
+            limit: 10,
         }), { wrapper: TestWrapper });
         await waitFor(() => {
             expect(result.current.data).toEqual(mockThreads);
         });
         expect(mockThreadsApi.list).toHaveBeenCalledWith({
             userKey: "test-context",
-            limit: "10",
+            limit: 10,
         });
     });
     it("handles loading state", async () => {
@@ -89,5 +96,33 @@ describe("useTamboV1ThreadList", () => {
             expect(result.current.error).toBe(mockError);
         });
     });
+    it("uses userKey from config when not provided in options", async () => {
+        mockThreadsApi.list.mockResolvedValue(mockThreads);
+        jest
+            .mocked(useTamboV1Config)
+            .mockReturnValue({ userKey: "config-user-key" });
+        const { result } = renderHook(() => useTamboV1ThreadList(), {
+            wrapper: TestWrapper,
+        });
+        await waitFor(() => {
+            expect(result.current.data).toEqual(mockThreads);
+        });
+        expect(mockThreadsApi.list).toHaveBeenCalledWith({
+            userKey: "config-user-key",
+        });
+    });
+    it("prefers explicit userKey over config userKey", async () => {
+        mockThreadsApi.list.mockResolvedValue(mockThreads);
+        jest
+            .mocked(useTamboV1Config)
+            .mockReturnValue({ userKey: "config-user-key" });
+        const { result } = renderHook(() => useTamboV1ThreadList({ userKey: "explicit-user-key" }), { wrapper: TestWrapper });
+        await waitFor(() => {
+            expect(result.current.data).toEqual(mockThreads);
+        });
+        expect(mockThreadsApi.list).toHaveBeenCalledWith({
+            userKey: "explicit-user-key",
+        });
+    });
 });
 //# sourceMappingURL=use-tambo-v1-thread-list.test.js.map

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

@@ -1 +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          userKey: \"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      userKey: \"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"]}
+{"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 {\n  useTamboClient,\n  useTamboQueryClient,\n} from \"../../providers/tambo-client-provider\";\nimport { useTamboV1Config } from \"../providers/tambo-v1-provider\";\nimport { useTamboV1ThreadList } from \"./use-tambo-v1-thread-list\";\n\njest.mock(\"../../providers/tambo-client-provider\", () => ({\n  useTamboClient: jest.fn(),\n  useTamboQueryClient: jest.fn(),\n}));\n\njest.mock(\"../providers/tambo-v1-provider\", () => ({\n  useTamboV1Config: 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    jest.mocked(useTamboQueryClient).mockReturnValue(queryClient);\n    jest.mocked(useTamboV1Config).mockReturnValue({ userKey: undefined });\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          userKey: \"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      userKey: \"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  it(\"uses userKey from config when not provided in options\", async () => {\n    mockThreadsApi.list.mockResolvedValue(mockThreads);\n    jest\n      .mocked(useTamboV1Config)\n      .mockReturnValue({ userKey: \"config-user-key\" });\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({\n      userKey: \"config-user-key\",\n    });\n  });\n\n  it(\"prefers explicit userKey over config userKey\", async () => {\n    mockThreadsApi.list.mockResolvedValue(mockThreads);\n    jest\n      .mocked(useTamboV1Config)\n      .mockReturnValue({ userKey: \"config-user-key\" });\n\n    const { result } = renderHook(\n      () => useTamboV1ThreadList({ userKey: \"explicit-user-key\" }),\n      { wrapper: TestWrapper },\n    );\n\n    await waitFor(() => {\n      expect(result.current.data).toEqual(mockThreads);\n    });\n\n    expect(mockThreadsApi.list).toHaveBeenCalledWith({\n      userKey: \"explicit-user-key\",\n    });\n  });\n});\n"]}

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

@@ -3,7 +3,7 @@
  *
  * React Query hook for fetching a single thread.
  */
-import { type UseQueryOptions } from "@tanstack/react-query";
+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.

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

@@ -1 +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"}
+{"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,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AAIjG;;;;;;;;;;;;;;;;;;;;;;;;;;;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

@@ -1,11 +1,6 @@
 "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";
+import { useTamboClient } from "../../providers/tambo-client-provider.js";
+import { useTamboQuery } from "../../hooks/react-query-hooks.js";
 /**
  * Hook to fetch a single thread by ID.
  *
@@ -36,7 +31,7 @@ import { useTamboClient } from "../../providers/tambo-client-provider";
  */
 export function useTamboV1Thread(threadId, options) {
     const client = useTamboClient();
-    return useQuery({
+    return useTamboQuery({
         queryKey: ["v1-threads", threadId],
         queryFn: async () => await client.threads.retrieve(threadId),
         staleTime: 1000, // Consider stale after 1s (real-time data)

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

@@ -1 +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"]}
+{"version":3,"file":"use-tambo-v1-thread.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-thread.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAUb,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,OAGC;IAED,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAEhC,OAAO,aAAa,CAAC;QACnB,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 type { UseQueryOptions } from \"@tanstack/react-query\";\nimport type { ThreadRetrieveResponse } from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport { useTamboQuery } from \"../../hooks/react-query-hooks\";\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 useTamboQuery({\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.js

@@ -1,10 +1,11 @@
 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";
+import { useTamboClient, useTamboQueryClient, } from "../../providers/tambo-client-provider.js";
+import { useTamboV1Thread } from "./use-tambo-v1-thread.js";
 jest.mock("../../providers/tambo-client-provider", () => ({
     useTamboClient: jest.fn(),
+    useTamboQueryClient: jest.fn(),
 }));
 describe("useTamboV1Thread", () => {
     const mockThread = {
@@ -35,6 +36,7 @@ describe("useTamboV1Thread", () => {
             },
         });
         jest.mocked(useTamboClient).mockReturnValue(mockTamboAI);
+        jest.mocked(useTamboQueryClient).mockReturnValue(queryClient);
         mockThreadsApi.retrieve.mockReset();
     });
     it("fetches thread by ID", async () => {

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

@@ -1 +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"]}
+{"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 {\n  useTamboClient,\n  useTamboQueryClient,\n} from \"../../providers/tambo-client-provider\";\nimport { useTamboV1Thread } from \"./use-tambo-v1-thread\";\n\njest.mock(\"../../providers/tambo-client-provider\", () => ({\n  useTamboClient: jest.fn(),\n  useTamboQueryClient: 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    jest.mocked(useTamboQueryClient).mockReturnValue(queryClient);\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

@@ -1,9 +1,9 @@
 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";
+import { type TamboRegistryContext as TamboRegistryContextType } from "../../providers/tambo-registry-provider.js";
+import { useStreamDispatch, type ThreadManagement } from "../providers/tambo-v1-stream-context.js";
+import type { TamboV1Message } from "../types/message.js";
+import type { StreamingState } from "../types/thread.js";
+import { type ThreadState } from "../utils/event-accumulator.js";
 /**
  * Return type for useTamboV1 hook
  */
@@ -57,9 +57,9 @@ export interface UseTamboV1Return {
      */
     toolRegistry: TamboRegistryContextType["toolRegistry"];
     /**
-     * Current thread ID (may be null if no thread is active)
+     * Current thread ID (always available - uses "placeholder" for new threads)
      */
-    currentThreadId: string | null;
+    currentThreadId: string;
     /**
      * Initialize a new thread in the stream context
      */
@@ -76,32 +76,16 @@ export interface UseTamboV1Return {
      * Dispatch function for stream events (advanced usage)
      */
     dispatch: ReturnType<typeof useStreamDispatch>;
+    /**
+     * Cancel the current run on this thread.
+     * Optimistically updates local state and sends cancellation request to the API.
+     * No-op if there's no active run or thread is a placeholder.
+     */
+    cancelRun: () => Promise<void>;
 }
 /**
- * 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>
- *   );
- * }
- * ```
+ * @returns The combined Tambo context
  */
-export declare function useTamboV1(threadId?: string): UseTamboV1Return;
+export declare function useTamboV1(): UseTamboV1Return;
 //# sourceMappingURL=use-tambo-v1.d.ts.map

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

@@ -1 +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"}
+{"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;AASpD,OAAO,EAEL,KAAK,oBAAoB,IAAI,wBAAwB,EACtD,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EACL,iBAAiB,EAGjB,KAAK,gBAAgB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAGV,cAAc,EAEf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,4BAA4B,CAAC;AAEpC;;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,CAAC;IAExB;;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;IAE/C;;;;OAIG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAwCD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,gBAAgB,CA2L7C"}

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

@@ -5,54 +5,152 @@
  * 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";
+import { EventType } from "@ag-ui/core";
+import React, { useCallback, useContext, useMemo, useRef, } from "react";
+import { useTamboClient } from "../../providers/tambo-client-provider.js";
+import { TamboRegistryContext, } from "../../providers/tambo-registry-provider.js";
+import { V1ComponentRenderer } from "../components/v1-component-renderer.js";
+import { useStreamDispatch, useStreamState, useThreadManagement, } from "../providers/tambo-v1-stream-context.js";
+import { isPlaceholderThreadId, } from "../utils/event-accumulator.js";
 /**
- * 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>
- *   );
- * }
- * ```
+ * @returns The combined Tambo context
  */
-export function useTamboV1(threadId) {
+export function useTamboV1() {
     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;
+    // Cache for rendered component wrappers - maintains stable element references
+    // across renders when props haven't changed
+    const componentCacheRef = useRef(new Map());
+    // Get thread state for the current thread
+    const threadState = streamState.threadMap[streamState.currentThreadId];
+    // Cancel the current run on this thread
+    const cancelRun = useCallback(async () => {
+        const runId = threadState?.streaming.runId;
+        const threadId = streamState.currentThreadId;
+        // No-op if there's no active run or thread is a placeholder
+        if (!runId || isPlaceholderThreadId(threadId)) {
+            return;
+        }
+        // Optimistically update local state with RUN_ERROR event
+        dispatch({
+            type: "EVENT",
+            threadId,
+            event: {
+                type: EventType.RUN_ERROR,
+                message: "Run cancelled",
+                code: "CANCELLED",
+                timestamp: Date.now(),
+            },
+        });
+        // Call API to cancel the run
+        try {
+            await client.threads.runs.delete(runId, { threadId });
+        }
+        catch (error) {
+            // Log but don't rethrow - local state is already updated
+            console.warn("Failed to cancel run on server:", error);
+        }
+    }, [
+        client,
+        streamState.currentThreadId,
+        threadState?.streaming.runId,
+        dispatch,
+    ]);
     // Memoize the return object to prevent unnecessary re-renders
     return useMemo(() => {
         const thread = threadState;
-        const messages = thread?.thread.messages ?? [];
+        const rawMessages = thread?.thread.messages ?? [];
         const streamingState = thread?.streaming ?? {
             status: "idle",
         };
+        // Build a set of tool_use IDs that have completed (have a matching tool_result)
+        // We need to look across all messages since tool_result might be in a different message
+        const completedToolIds = new Set();
+        for (const msg of rawMessages) {
+            for (const content of msg.content) {
+                if (content.type === "tool_result") {
+                    completedToolIds.add(content.toolUseId);
+                }
+            }
+        }
+        // Transform messages to add computed properties to content blocks
+        const messages = rawMessages.map((message) => {
+            const transformedContent = message.content.map((content) => {
+                // Transform tool_use content to add computed state
+                if (content.type === "tool_use") {
+                    const hasCompleted = completedToolIds.has(content.id);
+                    const input = content.input ?? {};
+                    // Extract Tambo display props from input
+                    const tamboDisplayProps = {
+                        _tambo_displayMessage: typeof input._tambo_displayMessage === "string"
+                            ? input._tambo_displayMessage
+                            : undefined,
+                        _tambo_statusMessage: typeof input._tambo_statusMessage === "string"
+                            ? input._tambo_statusMessage
+                            : undefined,
+                        _tambo_completionStatusMessage: typeof input._tambo_completionStatusMessage === "string"
+                            ? input._tambo_completionStatusMessage
+                            : undefined,
+                    };
+                    // Compute status message based on completion state
+                    const statusMessage = hasCompleted
+                        ? (tamboDisplayProps._tambo_completionStatusMessage ??
+                            `Called ${content.name}`)
+                        : (tamboDisplayProps._tambo_statusMessage ??
+                            `Calling ${content.name}`);
+                    // Filter out _tambo_* properties from input - consumers only see actual tool params
+                    const cleanInput = {};
+                    for (const [key, value] of Object.entries(input)) {
+                        if (!key.startsWith("_tambo_")) {
+                            cleanInput[key] = value;
+                        }
+                    }
+                    const v1Content = {
+                        ...content,
+                        input: cleanInput,
+                        hasCompleted,
+                        statusMessage,
+                        tamboDisplayProps,
+                    };
+                    return v1Content;
+                }
+                if (content.type !== "component") {
+                    return content;
+                }
+                const componentContent = content;
+                const propsJson = JSON.stringify(componentContent.props ?? {});
+                const cache = componentCacheRef.current;
+                const cached = cache.get(componentContent.id);
+                // Return cached element if props haven't changed
+                if (cached?.propsJson === propsJson) {
+                    return {
+                        ...componentContent,
+                        renderedComponent: cached.element,
+                    };
+                }
+                // Create new wrapper element
+                const element = React.createElement(V1ComponentRenderer, {
+                    key: componentContent.id,
+                    content: componentContent,
+                    threadId: streamState.currentThreadId,
+                    messageId: message.id,
+                });
+                // Update cache
+                cache.set(componentContent.id, { element, propsJson });
+                return {
+                    ...componentContent,
+                    renderedComponent: element,
+                };
+            });
+            return {
+                ...message,
+                content: transformedContent,
+            };
+        });
         return {
             client,
             thread,
@@ -71,8 +169,10 @@ export function useTamboV1(threadId) {
             switchThread: threadManagement.switchThread,
             startNewThread: threadManagement.startNewThread,
             dispatch,
+            cancelRun,
         };
     }, [
+        cancelRun,
         client,
         threadState,
         registry,

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

@@ -1 +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"]}
+{"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,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,KAAK,EAAE,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,MAAM,GAEP,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EACL,oBAAoB,GAErB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,GAEpB,MAAM,sCAAsC,CAAC;AAQ9C,OAAO,EACL,qBAAqB,GAEtB,MAAM,4BAA4B,CAAC;AAyIpC;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,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,8EAA8E;IAC9E,4CAA4C;IAC5C,MAAM,iBAAiB,GAAG,MAAM,CAAmC,IAAI,GAAG,EAAE,CAAC,CAAC;IAE9E,0CAA0C;IAC1C,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAEvE,wCAAwC;IACxC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACvC,MAAM,KAAK,GAAG,WAAW,EAAE,SAAS,CAAC,KAAK,CAAC;QAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,eAAe,CAAC;QAE7C,4DAA4D;QAC5D,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,yDAAyD;QACzD,QAAQ,CAAC;YACP,IAAI,EAAE,OAAO;YACb,QAAQ;YACR,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS,CAAC,SAAS;gBACzB,OAAO,EAAE,eAAe;gBACxB,IAAI,EAAE,WAAW;gBACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB;SACF,CAAC,CAAC;QAEH,6BAA6B;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yDAAyD;YACzD,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,EAAE;QACD,MAAM;QACN,WAAW,CAAC,eAAe;QAC3B,WAAW,EAAE,SAAS,CAAC,KAAK;QAC5B,QAAQ;KACT,CAAC,CAAC;IAEH,8DAA8D;IAC9D,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,MAAM,GAAG,WAAW,CAAC;QAC3B,MAAM,WAAW,GAAG,MAAM,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QAClD,MAAM,cAAc,GAAmB,MAAM,EAAE,SAAS,IAAI;YAC1D,MAAM,EAAE,MAAe;SACxB,CAAC;QAEF,gFAAgF;QAChF,wFAAwF;QACxF,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC9B,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAClC,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACnC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAED,kEAAkE;QAClE,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAkB,EAAE;YAC3D,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAW,EAAE;gBAClE,mDAAmD;gBACnD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBAChC,MAAM,YAAY,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;oBACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;oBAElC,yCAAyC;oBACzC,MAAM,iBAAiB,GAA0B;wBAC/C,qBAAqB,EACnB,OAAO,KAAK,CAAC,qBAAqB,KAAK,QAAQ;4BAC7C,CAAC,CAAC,KAAK,CAAC,qBAAqB;4BAC7B,CAAC,CAAC,SAAS;wBACf,oBAAoB,EAClB,OAAO,KAAK,CAAC,oBAAoB,KAAK,QAAQ;4BAC5C,CAAC,CAAC,KAAK,CAAC,oBAAoB;4BAC5B,CAAC,CAAC,SAAS;wBACf,8BAA8B,EAC5B,OAAO,KAAK,CAAC,8BAA8B,KAAK,QAAQ;4BACtD,CAAC,CAAC,KAAK,CAAC,8BAA8B;4BACtC,CAAC,CAAC,SAAS;qBAChB,CAAC;oBAEF,mDAAmD;oBACnD,MAAM,aAAa,GAAG,YAAY;wBAChC,CAAC,CAAC,CAAC,iBAAiB,CAAC,8BAA8B;4BACjD,UAAU,OAAO,CAAC,IAAI,EAAE,CAAC;wBAC3B,CAAC,CAAC,CAAC,iBAAiB,CAAC,oBAAoB;4BACvC,WAAW,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;oBAE/B,oFAAoF;oBACpF,MAAM,UAAU,GAA4B,EAAE,CAAC;oBAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;wBACjD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;4BAC/B,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;wBAC1B,CAAC;oBACH,CAAC;oBAED,MAAM,SAAS,GAAqB;wBAClC,GAAG,OAAO;wBACV,KAAK,EAAE,UAAU;wBACjB,YAAY;wBACZ,aAAa;wBACb,iBAAiB;qBAClB,CAAC;oBACF,OAAO,SAAS,CAAC;gBACnB,CAAC;gBAED,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBACjC,OAAO,OAAO,CAAC;gBACjB,CAAC;gBAED,MAAM,gBAAgB,GAAG,OAAO,CAAC;gBACjC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBAC/D,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC;gBACxC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;gBAE9C,iDAAiD;gBACjD,IAAI,MAAM,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;oBACpC,OAAO;wBACL,GAAG,gBAAgB;wBACnB,iBAAiB,EAAE,MAAM,CAAC,OAAO;qBAClC,CAAC;gBACJ,CAAC;gBAED,6BAA6B;gBAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,mBAAmB,EAAE;oBACvD,GAAG,EAAE,gBAAgB,CAAC,EAAE;oBACxB,OAAO,EAAE,gBAAgB;oBACzB,QAAQ,EAAE,WAAW,CAAC,eAAe;oBACrC,SAAS,EAAE,OAAO,CAAC,EAAE;iBACtB,CAAC,CAAC;gBAEH,eAAe;gBACf,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;gBAEvD,OAAO;oBACL,GAAG,gBAAgB;oBACnB,iBAAiB,EAAE,OAAO;iBAC3B,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,GAAG,OAAO;gBACV,OAAO,EAAE,kBAAkB;aAC5B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,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;YACR,SAAS;SACV,CAAC;IACJ,CAAC,EAAE;QACD,SAAS;QACT,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 { EventType } from \"@ag-ui/core\";\nimport type TamboAI from \"@tambo-ai/typescript-sdk\";\nimport React, {\n  useCallback,\n  useContext,\n  useMemo,\n  useRef,\n  type ReactElement,\n} from \"react\";\nimport { useTamboClient } from \"../../providers/tambo-client-provider\";\nimport {\n  TamboRegistryContext,\n  type TamboRegistryContext as TamboRegistryContextType,\n} from \"../../providers/tambo-registry-provider\";\nimport { V1ComponentRenderer } from \"../components/v1-component-renderer\";\nimport {\n  useStreamDispatch,\n  useStreamState,\n  useThreadManagement,\n  type ThreadManagement,\n} from \"../providers/tambo-v1-stream-context\";\nimport type {\n  Content,\n  TamboToolDisplayProps,\n  TamboV1Message,\n  V1ToolUseContent,\n} from \"../types/message\";\nimport type { StreamingState } from \"../types/thread\";\nimport {\n  isPlaceholderThreadId,\n  type ThreadState,\n} 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 (always available - uses \"placeholder\" for new threads)\n   */\n  currentThreadId: string;\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   * Cancel the current run on this thread.\n   * Optimistically updates local state and sends cancellation request to the API.\n   * No-op if there's no active run or thread is a placeholder.\n   */\n  cancelRun: () => Promise<void>;\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 *\n * Messages returned include renderedComponent on component content blocks,\n * allowing direct rendering via {content.renderedComponent}.\n * @param threadId - Optional thread ID to get state for\n * @returns Combined v1 context with thread state, messages, 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 */\n/**\n * Cache entry for a rendered component wrapper.\n * Stores the element and the props JSON used to create it.\n */\ninterface ComponentCacheEntry {\n  element: ReactElement;\n  propsJson: string;\n}\n\n/**\n *\n * @returns The combined Tambo context\n */\nexport function useTamboV1(): UseTamboV1Return {\n  const client = useTamboClient();\n  const streamState = useStreamState();\n  const dispatch = useStreamDispatch();\n  const registry = useContext(TamboRegistryContext);\n  const threadManagement = useThreadManagement();\n\n  // Cache for rendered component wrappers - maintains stable element references\n  // across renders when props haven't changed\n  const componentCacheRef = useRef<Map<string, ComponentCacheEntry>>(new Map());\n\n  // Get thread state for the current thread\n  const threadState = streamState.threadMap[streamState.currentThreadId];\n\n  // Cancel the current run on this thread\n  const cancelRun = useCallback(async () => {\n    const runId = threadState?.streaming.runId;\n    const threadId = streamState.currentThreadId;\n\n    // No-op if there's no active run or thread is a placeholder\n    if (!runId || isPlaceholderThreadId(threadId)) {\n      return;\n    }\n\n    // Optimistically update local state with RUN_ERROR event\n    dispatch({\n      type: \"EVENT\",\n      threadId,\n      event: {\n        type: EventType.RUN_ERROR,\n        message: \"Run cancelled\",\n        code: \"CANCELLED\",\n        timestamp: Date.now(),\n      },\n    });\n\n    // Call API to cancel the run\n    try {\n      await client.threads.runs.delete(runId, { threadId });\n    } catch (error) {\n      // Log but don't rethrow - local state is already updated\n      console.warn(\"Failed to cancel run on server:\", error);\n    }\n  }, [\n    client,\n    streamState.currentThreadId,\n    threadState?.streaming.runId,\n    dispatch,\n  ]);\n\n  // Memoize the return object to prevent unnecessary re-renders\n  return useMemo(() => {\n    const thread = threadState;\n    const rawMessages = thread?.thread.messages ?? [];\n    const streamingState: StreamingState = thread?.streaming ?? {\n      status: \"idle\" as const,\n    };\n\n    // Build a set of tool_use IDs that have completed (have a matching tool_result)\n    // We need to look across all messages since tool_result might be in a different message\n    const completedToolIds = new Set<string>();\n    for (const msg of rawMessages) {\n      for (const content of msg.content) {\n        if (content.type === \"tool_result\") {\n          completedToolIds.add(content.toolUseId);\n        }\n      }\n    }\n\n    // Transform messages to add computed properties to content blocks\n    const messages = rawMessages.map((message): TamboV1Message => {\n      const transformedContent = message.content.map((content): Content => {\n        // Transform tool_use content to add computed state\n        if (content.type === \"tool_use\") {\n          const hasCompleted = completedToolIds.has(content.id);\n          const input = content.input ?? {};\n\n          // Extract Tambo display props from input\n          const tamboDisplayProps: TamboToolDisplayProps = {\n            _tambo_displayMessage:\n              typeof input._tambo_displayMessage === \"string\"\n                ? input._tambo_displayMessage\n                : undefined,\n            _tambo_statusMessage:\n              typeof input._tambo_statusMessage === \"string\"\n                ? input._tambo_statusMessage\n                : undefined,\n            _tambo_completionStatusMessage:\n              typeof input._tambo_completionStatusMessage === \"string\"\n                ? input._tambo_completionStatusMessage\n                : undefined,\n          };\n\n          // Compute status message based on completion state\n          const statusMessage = hasCompleted\n            ? (tamboDisplayProps._tambo_completionStatusMessage ??\n              `Called ${content.name}`)\n            : (tamboDisplayProps._tambo_statusMessage ??\n              `Calling ${content.name}`);\n\n          // Filter out _tambo_* properties from input - consumers only see actual tool params\n          const cleanInput: Record<string, unknown> = {};\n          for (const [key, value] of Object.entries(input)) {\n            if (!key.startsWith(\"_tambo_\")) {\n              cleanInput[key] = value;\n            }\n          }\n\n          const v1Content: V1ToolUseContent = {\n            ...content,\n            input: cleanInput,\n            hasCompleted,\n            statusMessage,\n            tamboDisplayProps,\n          };\n          return v1Content;\n        }\n\n        if (content.type !== \"component\") {\n          return content;\n        }\n\n        const componentContent = content;\n        const propsJson = JSON.stringify(componentContent.props ?? {});\n        const cache = componentCacheRef.current;\n        const cached = cache.get(componentContent.id);\n\n        // Return cached element if props haven't changed\n        if (cached?.propsJson === propsJson) {\n          return {\n            ...componentContent,\n            renderedComponent: cached.element,\n          };\n        }\n\n        // Create new wrapper element\n        const element = React.createElement(V1ComponentRenderer, {\n          key: componentContent.id,\n          content: componentContent,\n          threadId: streamState.currentThreadId,\n          messageId: message.id,\n        });\n\n        // Update cache\n        cache.set(componentContent.id, { element, propsJson });\n\n        return {\n          ...componentContent,\n          renderedComponent: element,\n        };\n      });\n\n      return {\n        ...message,\n        content: transformedContent,\n      };\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      cancelRun,\n    };\n  }, [\n    cancelRun,\n    client,\n    threadState,\n    registry,\n    streamState.currentThreadId,\n    threadManagement,\n    dispatch,\n  ]);\n}\n"]}