@tambo-ai/react 1.0.0-rc.3 → 1.0.0-rc.5

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":"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","sourcesContent":["\"use client\";\n\n/**\n * useTambo - Main Hook\n *\n * Combines all 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 { useTamboConfig } from \"../providers/tambo-v1-provider\";\nimport { useTamboAuthState } from \"./use-tambo-v1-auth-state\";\nimport type { TamboAuthState } from \"../types/auth\";\nimport {\n  TamboRegistryContext,\n  type TamboRegistryContext as TamboRegistryContextType,\n} from \"../../providers/tambo-registry-provider\";\nimport { ComponentRenderer } 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  TamboThreadMessage,\n  TamboToolUseContent,\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 useTambo hook\n */\nexport interface UseTamboReturn {\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: TamboThreadMessage[];\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   * Current authentication state.\n   * Use this to show auth-related UI or conditionally render features.\n   */\n  authState: TamboAuthState;\n\n  /**\n   * Shorthand for `authState.status === \"identified\"`.\n   * When true, the SDK is ready to make API calls.\n   */\n  isIdentified: boolean;\n}\n\n/**\n * Main hook for accessing Tambo 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 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 *   } = useTambo('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 useTambo(): UseTamboReturn {\n  const client = useTamboClient();\n  const { userKey } = useTamboConfig();\n  const streamState = useStreamState();\n  const dispatch = useStreamDispatch();\n  const registry = useContext(TamboRegistryContext);\n  const threadManagement = useThreadManagement();\n  const authState = useTamboAuthState();\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, userKey });\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    userKey,\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): TamboThreadMessage => {\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: TamboToolUseContent = {\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(ComponentRenderer, {\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      authState,\n      isIdentified: authState.status === \"identified\",\n    };\n  }, [\n    cancelRun,\n    client,\n    threadState,\n    registry,\n    streamState.currentThreadId,\n    threadManagement,\n    dispatch,\n    authState,\n  ]);\n}\n"]}
+{"version":3,"file":"use-tambo-v1.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1.ts"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * useTambo - Main Hook\n *\n * Combines all 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 {\n  useTamboClient,\n  useTamboQueryClient,\n} from \"../../providers/tambo-client-provider\";\nimport { useTamboConfig } from \"../providers/tambo-v1-provider\";\nimport { useTamboAuthState } from \"./use-tambo-v1-auth-state\";\nimport type { TamboAuthState } from \"../types/auth\";\nimport {\n  TamboRegistryContext,\n  type TamboRegistryContext as TamboRegistryContextType,\n} from \"../../providers/tambo-registry-provider\";\nimport { ComponentRenderer } 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  TamboThreadMessage,\n  TamboToolUseContent,\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 useTambo hook\n */\nexport interface UseTamboReturn {\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: TamboThreadMessage[];\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   * Current authentication state.\n   * Use this to show auth-related UI or conditionally render features.\n   */\n  authState: TamboAuthState;\n\n  /**\n   * Shorthand for `authState.status === \"identified\"`.\n   * When true, the SDK is ready to make API calls.\n   */\n  isIdentified: boolean;\n\n  /**\n   * Update a thread's name.\n   * Useful for implementing manual thread renaming UI in history sidebars.\n   * Cache invalidation is best-effort; failures will be logged and won't reject.\n   * @param threadId - ID of the thread to rename\n   * @param name - New name for the thread\n   * @returns Promise that resolves when the update completes\n   */\n  updateThreadName: (threadId: string, name: string) => Promise<void>;\n}\n\n/**\n * Main hook for accessing Tambo 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 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 *   } = useTambo('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 useTambo(): UseTamboReturn {\n  const client = useTamboClient();\n  const queryClient = useTamboQueryClient();\n  const { userKey } = useTamboConfig();\n  const streamState = useStreamState();\n  const dispatch = useStreamDispatch();\n  const registry = useContext(TamboRegistryContext);\n  const threadManagement = useThreadManagement();\n  const authState = useTamboAuthState();\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  // Keep a live snapshot of the threadMap for callbacks without forcing them to\n  // re-create on every stream state update.\n  const threadMapRef = useRef(streamState.threadMap);\n  threadMapRef.current = streamState.threadMap;\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, userKey });\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    userKey,\n    streamState.currentThreadId,\n    threadState?.streaming.runId,\n    dispatch,\n  ]);\n\n  // Update a thread's name\n  const updateThreadName = useCallback(\n    async (threadId: string, name: string) => {\n      await client.threads.update(threadId, { name });\n\n      if (threadMapRef.current[threadId]) {\n        dispatch({\n          type: \"UPDATE_THREAD_NAME\",\n          threadId,\n          name: name,\n        });\n      }\n\n      try {\n        await Promise.all([\n          queryClient.invalidateQueries({\n            queryKey: [\"v1-threads\", \"list\"],\n          }),\n          queryClient.invalidateQueries({\n            queryKey: [\"v1-threads\", threadId],\n          }),\n        ]);\n      } catch (error) {\n        console.warn(\n          \"[useTambo] Failed to invalidate thread queries after rename:\",\n          error,\n        );\n      }\n    },\n    [client, dispatch, queryClient],\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): TamboThreadMessage => {\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_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: TamboToolUseContent = {\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(ComponentRenderer, {\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      authState,\n      isIdentified: authState.status === \"identified\",\n      updateThreadName,\n    };\n  }, [\n    cancelRun,\n    updateThreadName,\n    client,\n    threadState,\n    registry,\n    streamState.currentThreadId,\n    threadManagement,\n    dispatch,\n    authState,\n  ]);\n}\n"]}

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

@@ -68,9 +68,12 @@ describe("useTambo", () => {
         };
     }
     // Wrapper that uses the real reducer so state updates properly
-    function createWrapperWithRealReducer(initialState) {
+    function createWrapperWithRealReducer(initialState, stateRef) {
         return function WrapperWithRealReducer({ children, }) {
             const [state, dispatch] = useReducer(streamReducer, initialState);
+            if (stateRef) {
+                stateRef.current = state;
+            }
             return (React.createElement(QueryClientProvider, { client: queryClient },
                 React.createElement(TamboRegistryContext.Provider, { value: mockRegistry },
                     React.createElement(TamboStreamProvider, { state: state, dispatch: dispatch }, children))));
@@ -85,6 +88,7 @@ describe("useTambo", () => {
         jest.mocked(useTamboClient).mockReturnValue(mockTamboClient);
         jest.mocked(useTamboQueryClient).mockReturnValue(queryClient);
         jest.clearAllMocks();
+        delete mockTamboClient.threads.update;
     });
     it("returns client from useTamboClient", () => {
         const { result } = renderHook(() => useTambo(), {
@@ -700,7 +704,6 @@ describe("useTambo", () => {
                                                 units: "celsius",
                                                 _tambo_statusMessage: "Fetching...",
                                                 _tambo_completionStatusMessage: "Done",
-                                                _tambo_displayMessage: "Weather lookup",
                                             },
                                         },
                                     ],
@@ -727,7 +730,6 @@ describe("useTambo", () => {
             expect(content.input).toEqual({ location: "NYC", units: "celsius" });
             expect(content.input._tambo_statusMessage).toBeUndefined();
             expect(content.input._tambo_completionStatusMessage).toBeUndefined();
-            expect(content.input._tambo_displayMessage).toBeUndefined();
         });
         it("handles tool_use with empty input", () => {
             const state = {
@@ -1015,5 +1017,122 @@ describe("useTambo", () => {
             consoleWarnSpy.mockRestore();
         });
     });
+    describe("updateThreadName", () => {
+        it("updates local thread name and invalidates caches on success", async () => {
+            const mockUpdate = jest.fn().mockResolvedValue({});
+            // TypeScript SDK will be updated to include this method
+            mockTamboClient.threads.update = mockUpdate;
+            const invalidateQueriesSpy = jest.spyOn(queryClient, "invalidateQueries");
+            const initialState = {
+                threadMap: {
+                    thread_456: {
+                        thread: {
+                            id: "thread_456",
+                            messages: [],
+                            status: "idle",
+                            createdAt: new Date().toISOString(),
+                            updatedAt: new Date().toISOString(),
+                            lastRunCancelled: false,
+                            name: "Old Name",
+                        },
+                        streaming: { status: "idle" },
+                        accumulatingToolArgs: new Map(),
+                    },
+                },
+                currentThreadId: "thread_456",
+            };
+            const { result } = renderHook(() => useTambo(), {
+                wrapper: createWrapperWithRealReducer(initialState),
+            });
+            await act(async () => {
+                await result.current.updateThreadName("thread_456", "My New Thread");
+            });
+            expect(mockUpdate).toHaveBeenCalledWith("thread_456", {
+                name: "My New Thread",
+            });
+            expect(result.current.thread?.thread.name).toBe("My New Thread");
+            const invalidatedKeys = invalidateQueriesSpy.mock.calls
+                .map(([arg]) => arg.queryKey)
+                .filter(Boolean);
+            expect(invalidatedKeys).toContainEqual(["v1-threads", "list"]);
+            expect(invalidatedKeys).toContainEqual(["v1-threads", "thread_456"]);
+        });
+        it("does not create local thread state when thread isn't loaded", async () => {
+            const mockUpdate = jest.fn().mockResolvedValue({});
+            // TypeScript SDK will be updated to include this method
+            mockTamboClient.threads.update = mockUpdate;
+            const invalidateQueriesSpy = jest.spyOn(queryClient, "invalidateQueries");
+            // Track the internal StreamState from the real reducer so we can assert we
+            // don't create a local thread entry for threads that haven't been loaded.
+            const stateRef = {
+                current: undefined,
+            };
+            const initialState = {
+                threadMap: {},
+                currentThreadId: "placeholder",
+            };
+            const { result } = renderHook(() => useTambo(), {
+                wrapper: createWrapperWithRealReducer(initialState, stateRef),
+            });
+            await act(async () => {
+                await result.current.updateThreadName("thread_789", "New Title");
+            });
+            expect(mockUpdate).toHaveBeenCalledWith("thread_789", {
+                name: "New Title",
+            });
+            const invalidatedKeys = invalidateQueriesSpy.mock.calls
+                .map(([arg]) => arg.queryKey)
+                .filter(Boolean);
+            expect(invalidatedKeys).toContainEqual(["v1-threads", "list"]);
+            expect(invalidatedKeys).toContainEqual(["v1-threads", "thread_789"]);
+            expect(stateRef.current?.threadMap.thread_789).toBeUndefined();
+            act(() => {
+                result.current.switchThread("thread_789");
+            });
+            expect(result.current.thread).toBeUndefined();
+        });
+        it("propagates errors and does not update local state", async () => {
+            const mockUpdate = jest
+                .fn()
+                .mockRejectedValue(new Error("Network error"));
+            // TypeScript SDK will be updated to include this method
+            mockTamboClient.threads.update = mockUpdate;
+            const invalidateQueriesSpy = jest.spyOn(queryClient, "invalidateQueries");
+            const initialState = {
+                threadMap: {
+                    thread_456: {
+                        thread: {
+                            id: "thread_456",
+                            messages: [],
+                            status: "idle",
+                            createdAt: new Date().toISOString(),
+                            updatedAt: new Date().toISOString(),
+                            lastRunCancelled: false,
+                            name: "Old Name",
+                        },
+                        streaming: { status: "idle" },
+                        accumulatingToolArgs: new Map(),
+                    },
+                },
+                currentThreadId: "thread_456",
+            };
+            const { result } = renderHook(() => useTambo(), {
+                wrapper: createWrapperWithRealReducer(initialState),
+            });
+            let caughtError;
+            await act(async () => {
+                try {
+                    await result.current.updateThreadName("thread_456", "My New Thread");
+                }
+                catch (error) {
+                    caughtError = error;
+                }
+            });
+            expect(caughtError).toBeInstanceOf(Error);
+            expect(caughtError.message).toBe("Network error");
+            expect(result.current.thread?.thread.name).toBe("Old Name");
+            expect(invalidateQueriesSpy).not.toHaveBeenCalled();
+        });
+    });
 });
 //# sourceMappingURL=use-tambo-v1.test.js.map