@tambo-ai/react 0.69.1 → 0.71.0

package/esm/util/tool-caller.js

@@ -1,4 +1,3 @@
-import { hasInputSchema } from "../schema";
 import { mapTamboToolToContextTool } from "./registry";
 /**
  * Process a message from the thread, invoking the appropriate tool and returning the result.
@@ -22,7 +21,7 @@ export const handleToolCall = async (toolCallRequest, toolRegistry, onCallUnregi
             throw new Error(`Tool ${toolCallRequest.toolName} not found in registry`);
         }
         return {
-            result: await runToolChoice(toolCallRequest, tool, tamboTool),
+            result: await runToolChoice(toolCallRequest, tool),
             tamboTool,
         };
     }
@@ -48,16 +47,10 @@ const findTool = (toolName, toolRegistry) => {
         tamboTool: registryTool,
     };
 };
-const runToolChoice = async (toolCallRequest, tool, tamboTool) => {
+const runToolChoice = async (toolCallRequest, tool) => {
     const parameters = toolCallRequest.parameters ?? [];
-    // New interface (inputSchema): pass single object argument
-    if (hasInputSchema(tamboTool)) {
-        // Reconstruct the object from parameter name-value pairs
-        const inputObject = Object.fromEntries(parameters.map((param) => [param.parameterName, param.parameterValue]));
-        return await tool.getComponentContext(inputObject);
-    }
-    // Deprecated interface (toolSchema): spread positional arguments
-    const parameterValues = parameters.map((param) => param.parameterValue);
-    return await tool.getComponentContext(...parameterValues);
+    // Reconstruct the object from parameter name-value pairs
+    const inputObject = Object.fromEntries(parameters.map((param) => [param.parameterName, param.parameterValue]));
+    return await tool.getComponentContext(inputObject);
 };
 //# sourceMappingURL=tool-caller.js.map

package/esm/util/tool-caller.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-caller.js","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,eAAwC,EACxC,YAA+B,EAC/B,sBAGoB,EAKnB,EAAE;IACH,IAAI,CAAC,eAAe,EAAE,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,CAClC,eAAe,CAAC,QAAQ,EACxB,YAAY,CACb,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,sBAAsB,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,eAAe,CAAC,QAAQ,EACxB,eAAe,CAAC,UAAU,CAC3B,CAAC;gBACF,OAAO;oBACL,MAAM;iBACP,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,QAAQ,eAAe,CAAC,QAAQ,wBAAwB,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,aAAa,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;YAC7D,SAAS;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,gCAAgC,eAAe,CAAC,QAAQ,kCAAkC,KAAK,0EAA0E;YACjL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CACf,QAAgB,EAChB,YAA+B,EAMG,EAAE;IACpC,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,WAAW,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI,EAAE;YACJ,mBAAmB,EAAE,YAAY,CAAC,IAAI;YACtC,UAAU,EAAE,WAAW;SACxB;QACD,SAAS,EAAE,YAAY;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,KAAK,EACzB,eAAwC,EACxC,IAA0B,EAC1B,SAA8C,EAC5B,EAAE;IACpB,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,IAAI,EAAE,CAAC;IAEpD,2DAA2D;IAC3D,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,yDAAyD;QACzD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CACpC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CACvE,CAAC;QACF,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IAED,iEAAiE;IACjE,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACxE,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,GAAG,eAAe,CAAC,CAAC;AAC5D,CAAC,CAAC","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport {\n  ComponentContextTool,\n  TamboTool,\n  TamboToolRegistry,\n  TamboToolWithToolSchema,\n} from \"../model/component-metadata\";\nimport { hasInputSchema } from \"../schema\";\nimport { mapTamboToolToContextTool } from \"./registry\";\n\n/**\n * Process a message from the thread, invoking the appropriate tool and returning the result.\n * @param toolCallRequest - The message to handle\n * @param toolRegistry - The tool registry\n * @returns The result of the tool call along with the tool definition\n */\nexport const handleToolCall = async (\n  toolCallRequest: TamboAI.ToolCallRequest,\n  toolRegistry: TamboToolRegistry,\n  onCallUnregisteredTool?: (\n    toolName: string,\n    args: TamboAI.ToolCallParameter[],\n  ) => Promise<string>,\n): Promise<{\n  result: unknown;\n  error?: string;\n  tamboTool?: TamboTool | TamboToolWithToolSchema;\n}> => {\n  if (!toolCallRequest?.toolName) {\n    throw new Error(\"Tool name is required\");\n  }\n\n  try {\n    const { tool, tamboTool } = findTool(\n      toolCallRequest.toolName,\n      toolRegistry,\n    );\n    if (!tool) {\n      if (onCallUnregisteredTool) {\n        const result = await onCallUnregisteredTool(\n          toolCallRequest.toolName,\n          toolCallRequest.parameters,\n        );\n        return {\n          result,\n        };\n      }\n      throw new Error(`Tool ${toolCallRequest.toolName} not found in registry`);\n    }\n    return {\n      result: await runToolChoice(toolCallRequest, tool, tamboTool),\n      tamboTool,\n    };\n  } catch (error) {\n    console.error(\"Error in calling tool: \", error);\n    return {\n      result: `When attempting to call tool ${toolCallRequest.toolName} the following error occurred: ${error}. Explain to the user that the tool call failed and try again if needed.`,\n      error: error instanceof Error ? error.message : \"Unknown error\",\n    };\n  }\n};\n\nconst findTool = (\n  toolName: string,\n  toolRegistry: TamboToolRegistry,\n):\n  | {\n      tool: ComponentContextTool;\n      tamboTool: TamboTool | TamboToolWithToolSchema;\n    }\n  | { tool: null; tamboTool: null } => {\n  const registryTool = toolRegistry[toolName];\n\n  if (!registryTool) {\n    return { tool: null, tamboTool: null };\n  }\n\n  const contextTool = mapTamboToolToContextTool(registryTool);\n  return {\n    tool: {\n      getComponentContext: registryTool.tool,\n      definition: contextTool,\n    },\n    tamboTool: registryTool,\n  };\n};\n\nconst runToolChoice = async (\n  toolCallRequest: TamboAI.ToolCallRequest,\n  tool: ComponentContextTool,\n  tamboTool: TamboTool | TamboToolWithToolSchema,\n): Promise<unknown> => {\n  const parameters = toolCallRequest.parameters ?? [];\n\n  // New interface (inputSchema): pass single object argument\n  if (hasInputSchema(tamboTool)) {\n    // Reconstruct the object from parameter name-value pairs\n    const inputObject = Object.fromEntries(\n      parameters.map((param) => [param.parameterName, param.parameterValue]),\n    );\n    return await tool.getComponentContext(inputObject);\n  }\n\n  // Deprecated interface (toolSchema): spread positional arguments\n  const parameterValues = parameters.map((param) => param.parameterValue);\n  return await tool.getComponentContext(...parameterValues);\n};\n"]}
+{"version":3,"file":"tool-caller.js","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,eAAwC,EACxC,YAA+B,EAC/B,sBAGoB,EAKnB,EAAE;IACH,IAAI,CAAC,eAAe,EAAE,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,CAClC,eAAe,CAAC,QAAQ,EACxB,YAAY,CACb,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,sBAAsB,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,eAAe,CAAC,QAAQ,EACxB,eAAe,CAAC,UAAU,CAC3B,CAAC;gBACF,OAAO;oBACL,MAAM;iBACP,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,QAAQ,eAAe,CAAC,QAAQ,wBAAwB,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,aAAa,CAAC,eAAe,EAAE,IAAI,CAAC;YAClD,SAAS;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO;YACL,MAAM,EAAE,gCAAgC,eAAe,CAAC,QAAQ,kCAAkC,KAAK,0EAA0E;YACjL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CACf,QAAgB,EAChB,YAA+B,EAMG,EAAE;IACpC,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,WAAW,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI,EAAE;YACJ,mBAAmB,EAAE,YAAY,CAAC,IAAI;YACtC,UAAU,EAAE,WAAW;SACxB;QACD,SAAS,EAAE,YAAY;KACxB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,KAAK,EACzB,eAAwC,EACxC,IAA0B,EACR,EAAE;IACpB,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,IAAI,EAAE,CAAC;IAEpD,yDAAyD;IACzD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CACpC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CACvE,CAAC;IACF,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;AACrD,CAAC,CAAC","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport {\n  ComponentContextTool,\n  TamboTool,\n  TamboToolRegistry,\n} from \"../model/component-metadata\";\nimport { mapTamboToolToContextTool } from \"./registry\";\n\n/**\n * Process a message from the thread, invoking the appropriate tool and returning the result.\n * @param toolCallRequest - The message to handle\n * @param toolRegistry - The tool registry\n * @returns The result of the tool call along with the tool definition\n */\nexport const handleToolCall = async (\n  toolCallRequest: TamboAI.ToolCallRequest,\n  toolRegistry: TamboToolRegistry,\n  onCallUnregisteredTool?: (\n    toolName: string,\n    args: TamboAI.ToolCallParameter[],\n  ) => Promise<string>,\n): Promise<{\n  result: unknown;\n  error?: string;\n  tamboTool?: TamboTool;\n}> => {\n  if (!toolCallRequest?.toolName) {\n    throw new Error(\"Tool name is required\");\n  }\n\n  try {\n    const { tool, tamboTool } = findTool(\n      toolCallRequest.toolName,\n      toolRegistry,\n    );\n    if (!tool) {\n      if (onCallUnregisteredTool) {\n        const result = await onCallUnregisteredTool(\n          toolCallRequest.toolName,\n          toolCallRequest.parameters,\n        );\n        return {\n          result,\n        };\n      }\n      throw new Error(`Tool ${toolCallRequest.toolName} not found in registry`);\n    }\n    return {\n      result: await runToolChoice(toolCallRequest, tool),\n      tamboTool,\n    };\n  } catch (error) {\n    console.error(\"Error in calling tool: \", error);\n    return {\n      result: `When attempting to call tool ${toolCallRequest.toolName} the following error occurred: ${error}. Explain to the user that the tool call failed and try again if needed.`,\n      error: error instanceof Error ? error.message : \"Unknown error\",\n    };\n  }\n};\n\nconst findTool = (\n  toolName: string,\n  toolRegistry: TamboToolRegistry,\n):\n  | {\n      tool: ComponentContextTool;\n      tamboTool: TamboTool;\n    }\n  | { tool: null; tamboTool: null } => {\n  const registryTool = toolRegistry[toolName];\n\n  if (!registryTool) {\n    return { tool: null, tamboTool: null };\n  }\n\n  const contextTool = mapTamboToolToContextTool(registryTool);\n  return {\n    tool: {\n      getComponentContext: registryTool.tool,\n      definition: contextTool,\n    },\n    tamboTool: registryTool,\n  };\n};\n\nconst runToolChoice = async (\n  toolCallRequest: TamboAI.ToolCallRequest,\n  tool: ComponentContextTool,\n): Promise<unknown> => {\n  const parameters = toolCallRequest.parameters ?? [];\n\n  // Reconstruct the object from parameter name-value pairs\n  const inputObject = Object.fromEntries(\n    parameters.map((param) => [param.parameterName, param.parameterValue]),\n  );\n  return await tool.getComponentContext(inputObject);\n};\n"]}

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

@@ -0,0 +1,58 @@
+import type { TamboV1Message } from "../types/message";
+/**
+ * Return type for useTamboV1Messages hook
+ */
+export interface UseTamboV1MessagesReturn {
+    /**
+     * All messages in the thread
+     */
+    messages: TamboV1Message[];
+    /**
+     * The most recent message (last in the list)
+     */
+    lastMessage: TamboV1Message | undefined;
+    /**
+     * User messages only
+     */
+    userMessages: TamboV1Message[];
+    /**
+     * Assistant messages only
+     */
+    assistantMessages: TamboV1Message[];
+    /**
+     * Whether there are any messages
+     */
+    hasMessages: boolean;
+    /**
+     * Total message count
+     */
+    messageCount: number;
+}
+/**
+ * Hook to access messages in a thread.
+ *
+ * Provides filtered views of messages (user-only, assistant-only)
+ * and metadata about the message list.
+ * @param threadId - Thread ID to get messages for
+ * @returns Message list and utilities
+ * @example
+ * ```tsx
+ * function MessageList({ threadId }: { threadId: string }) {
+ *   const { messages, hasMessages, lastMessage } = useTamboV1Messages(threadId);
+ *
+ *   if (!hasMessages) {
+ *     return <EmptyState />;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => (
+ *         <Message key={msg.id} message={msg} />
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useTamboV1Messages(threadId: string): UseTamboV1MessagesReturn;
+//# sourceMappingURL=use-tambo-v1-messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-messages.d.ts","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-messages.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B;;OAEG;IACH,WAAW,EAAE,cAAc,GAAG,SAAS,CAAC;IAExC;;OAEG;IACH,YAAY,EAAE,cAAc,EAAE,CAAC;IAE/B;;OAEG;IACH,iBAAiB,EAAE,cAAc,EAAE,CAAC;IAEpC;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CAgB7E"}

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

@@ -0,0 +1,51 @@
+"use client";
+/**
+ * useTamboV1Messages - Messages Hook for v1 API
+ *
+ * Provides access to messages in a thread with streaming state awareness.
+ * Messages are accumulated from AG-UI events during streaming.
+ */
+import { useMemo } from "react";
+import { useStreamState } from "../providers/tambo-v1-stream-context";
+/**
+ * Hook to access messages in a thread.
+ *
+ * Provides filtered views of messages (user-only, assistant-only)
+ * and metadata about the message list.
+ * @param threadId - Thread ID to get messages for
+ * @returns Message list and utilities
+ * @example
+ * ```tsx
+ * function MessageList({ threadId }: { threadId: string }) {
+ *   const { messages, hasMessages, lastMessage } = useTamboV1Messages(threadId);
+ *
+ *   if (!hasMessages) {
+ *     return <EmptyState />;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       {messages.map(msg => (
+ *         <Message key={msg.id} message={msg} />
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useTamboV1Messages(threadId) {
+    const streamState = useStreamState();
+    const threadState = streamState.threadMap[threadId];
+    return useMemo(() => {
+        const messages = threadState?.thread.messages ?? [];
+        return {
+            messages,
+            lastMessage: messages[messages.length - 1],
+            userMessages: messages.filter((m) => m.role === "user"),
+            assistantMessages: messages.filter((m) => m.role === "assistant"),
+            hasMessages: messages.length > 0,
+            messageCount: messages.length,
+        };
+    }, [threadState?.thread.messages]);
+}
+//# sourceMappingURL=use-tambo-v1-messages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-messages.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-messages.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAsCtE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEpD,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,QAAQ,GAAG,WAAW,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;QAEpD,OAAO;YACL,QAAQ;YACR,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;YACvD,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;YACjE,WAAW,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC;YAChC,YAAY,EAAE,QAAQ,CAAC,MAAM;SAC9B,CAAC;IACJ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrC,CAAC","sourcesContent":["\"use client\";\n\n/**\n * useTamboV1Messages - Messages Hook for v1 API\n *\n * Provides access to messages in a thread with streaming state awareness.\n * Messages are accumulated from AG-UI events during streaming.\n */\n\nimport { useMemo } from \"react\";\nimport { useStreamState } from \"../providers/tambo-v1-stream-context\";\nimport type { TamboV1Message } from \"../types/message\";\n\n/**\n * Return type for useTamboV1Messages hook\n */\nexport interface UseTamboV1MessagesReturn {\n  /**\n   * All messages in the thread\n   */\n  messages: TamboV1Message[];\n\n  /**\n   * The most recent message (last in the list)\n   */\n  lastMessage: TamboV1Message | undefined;\n\n  /**\n   * User messages only\n   */\n  userMessages: TamboV1Message[];\n\n  /**\n   * Assistant messages only\n   */\n  assistantMessages: TamboV1Message[];\n\n  /**\n   * Whether there are any messages\n   */\n  hasMessages: boolean;\n\n  /**\n   * Total message count\n   */\n  messageCount: number;\n}\n\n/**\n * Hook to access messages in a thread.\n *\n * Provides filtered views of messages (user-only, assistant-only)\n * and metadata about the message list.\n * @param threadId - Thread ID to get messages for\n * @returns Message list and utilities\n * @example\n * ```tsx\n * function MessageList({ threadId }: { threadId: string }) {\n *   const { messages, hasMessages, lastMessage } = useTamboV1Messages(threadId);\n *\n *   if (!hasMessages) {\n *     return <EmptyState />;\n *   }\n *\n *   return (\n *     <div>\n *       {messages.map(msg => (\n *         <Message key={msg.id} message={msg} />\n *       ))}\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useTamboV1Messages(threadId: string): UseTamboV1MessagesReturn {\n  const streamState = useStreamState();\n  const threadState = streamState.threadMap[threadId];\n\n  return useMemo(() => {\n    const messages = threadState?.thread.messages ?? [];\n\n    return {\n      messages,\n      lastMessage: messages[messages.length - 1],\n      userMessages: messages.filter((m) => m.role === \"user\"),\n      assistantMessages: messages.filter((m) => m.role === \"assistant\"),\n      hasMessages: messages.length > 0,\n      messageCount: messages.length,\n    };\n  }, [threadState?.thread.messages]);\n}\n"]}

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

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

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

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

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

@@ -0,0 +1,132 @@
+import { EventType, } from "@ag-ui/core";
+import { renderHook, act } from "@testing-library/react";
+import React from "react";
+import { TamboV1StreamProvider, useStreamDispatch, } from "../providers/tambo-v1-stream-context";
+import { useTamboV1Messages } from "./use-tambo-v1-messages";
+describe("useTamboV1Messages", () => {
+    function TestWrapper({ children }) {
+        return (React.createElement(TamboV1StreamProvider, { threadId: "thread_123" }, children));
+    }
+    it("returns empty messages when thread has no messages", () => {
+        const { result } = renderHook(() => useTamboV1Messages("thread_123"), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.messages).toEqual([]);
+        expect(result.current.hasMessages).toBe(false);
+        expect(result.current.messageCount).toBe(0);
+        expect(result.current.lastMessage).toBeUndefined();
+        expect(result.current.userMessages).toEqual([]);
+        expect(result.current.assistantMessages).toEqual([]);
+    });
+    it("returns messages after events are dispatched", () => {
+        const { result } = renderHook(() => ({
+            messages: useTamboV1Messages("thread_123"),
+            dispatch: useStreamDispatch(),
+        }), { wrapper: TestWrapper });
+        // Simulate a text message being received
+        act(() => {
+            result.current.dispatch({
+                type: "EVENT",
+                event: {
+                    type: EventType.TEXT_MESSAGE_START,
+                    messageId: "msg_1",
+                    role: "assistant",
+                },
+                threadId: "thread_123",
+            });
+        });
+        act(() => {
+            result.current.dispatch({
+                type: "EVENT",
+                event: {
+                    type: EventType.TEXT_MESSAGE_CONTENT,
+                    messageId: "msg_1",
+                    delta: "Hello",
+                },
+                threadId: "thread_123",
+            });
+        });
+        act(() => {
+            result.current.dispatch({
+                type: "EVENT",
+                event: {
+                    type: EventType.TEXT_MESSAGE_END,
+                    messageId: "msg_1",
+                },
+                threadId: "thread_123",
+            });
+        });
+        expect(result.current.messages.messages.length).toBe(1);
+        expect(result.current.messages.hasMessages).toBe(true);
+        expect(result.current.messages.messageCount).toBe(1);
+        expect(result.current.messages.lastMessage?.id).toBe("msg_1");
+        expect(result.current.messages.lastMessage?.role).toBe("assistant");
+        expect(result.current.messages.assistantMessages.length).toBe(1);
+        expect(result.current.messages.userMessages.length).toBe(0);
+    });
+    it("filters user and assistant messages correctly", () => {
+        const { result } = renderHook(() => ({
+            messages: useTamboV1Messages("thread_123"),
+            dispatch: useStreamDispatch(),
+        }), { wrapper: TestWrapper });
+        // Add user message
+        act(() => {
+            result.current.dispatch({
+                type: "EVENT",
+                event: {
+                    type: EventType.TEXT_MESSAGE_START,
+                    messageId: "msg_user",
+                    role: "user",
+                },
+                threadId: "thread_123",
+            });
+        });
+        act(() => {
+            result.current.dispatch({
+                type: "EVENT",
+                event: {
+                    type: EventType.TEXT_MESSAGE_END,
+                    messageId: "msg_user",
+                },
+                threadId: "thread_123",
+            });
+        });
+        // Add assistant message
+        act(() => {
+            result.current.dispatch({
+                type: "EVENT",
+                event: {
+                    type: EventType.TEXT_MESSAGE_START,
+                    messageId: "msg_assistant",
+                    role: "assistant",
+                },
+                threadId: "thread_123",
+            });
+        });
+        act(() => {
+            result.current.dispatch({
+                type: "EVENT",
+                event: {
+                    type: EventType.TEXT_MESSAGE_END,
+                    messageId: "msg_assistant",
+                },
+                threadId: "thread_123",
+            });
+        });
+        expect(result.current.messages.messageCount).toBe(2);
+        expect(result.current.messages.userMessages.length).toBe(1);
+        expect(result.current.messages.userMessages[0].id).toBe("msg_user");
+        expect(result.current.messages.assistantMessages.length).toBe(1);
+        expect(result.current.messages.assistantMessages[0].id).toBe("msg_assistant");
+        expect(result.current.messages.lastMessage?.id).toBe("msg_assistant");
+    });
+    it("returns empty messages when threadId does not exist in threadMap", () => {
+        const { result } = renderHook(() => useTamboV1Messages("nonexistent_thread"), {
+            wrapper: TestWrapper,
+        });
+        expect(result.current.messages).toEqual([]);
+        expect(result.current.hasMessages).toBe(false);
+        expect(result.current.messageCount).toBe(0);
+    });
+});
+//# sourceMappingURL=use-tambo-v1-messages.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-messages.test.js","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-messages.test.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  EventType,\n  type TextMessageStartEvent,\n  type TextMessageContentEvent,\n  type TextMessageEndEvent,\n} from \"@ag-ui/core\";\nimport { renderHook, act } from \"@testing-library/react\";\nimport React from \"react\";\nimport {\n  TamboV1StreamProvider,\n  useStreamDispatch,\n} from \"../providers/tambo-v1-stream-context\";\nimport { useTamboV1Messages } from \"./use-tambo-v1-messages\";\n\ndescribe(\"useTamboV1Messages\", () => {\n  function TestWrapper({ children }: { children: React.ReactNode }) {\n    return (\n      <TamboV1StreamProvider threadId=\"thread_123\">\n        {children}\n      </TamboV1StreamProvider>\n    );\n  }\n\n  it(\"returns empty messages when thread has no messages\", () => {\n    const { result } = renderHook(() => useTamboV1Messages(\"thread_123\"), {\n      wrapper: TestWrapper,\n    });\n\n    expect(result.current.messages).toEqual([]);\n    expect(result.current.hasMessages).toBe(false);\n    expect(result.current.messageCount).toBe(0);\n    expect(result.current.lastMessage).toBeUndefined();\n    expect(result.current.userMessages).toEqual([]);\n    expect(result.current.assistantMessages).toEqual([]);\n  });\n\n  it(\"returns messages after events are dispatched\", () => {\n    const { result } = renderHook(\n      () => ({\n        messages: useTamboV1Messages(\"thread_123\"),\n        dispatch: useStreamDispatch(),\n      }),\n      { wrapper: TestWrapper },\n    );\n\n    // Simulate a text message being received\n    act(() => {\n      result.current.dispatch({\n        type: \"EVENT\",\n        event: {\n          type: EventType.TEXT_MESSAGE_START,\n          messageId: \"msg_1\",\n          role: \"assistant\",\n        } as TextMessageStartEvent,\n        threadId: \"thread_123\",\n      });\n    });\n\n    act(() => {\n      result.current.dispatch({\n        type: \"EVENT\",\n        event: {\n          type: EventType.TEXT_MESSAGE_CONTENT,\n          messageId: \"msg_1\",\n          delta: \"Hello\",\n        } as TextMessageContentEvent,\n        threadId: \"thread_123\",\n      });\n    });\n\n    act(() => {\n      result.current.dispatch({\n        type: \"EVENT\",\n        event: {\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: \"msg_1\",\n        } as TextMessageEndEvent,\n        threadId: \"thread_123\",\n      });\n    });\n\n    expect(result.current.messages.messages.length).toBe(1);\n    expect(result.current.messages.hasMessages).toBe(true);\n    expect(result.current.messages.messageCount).toBe(1);\n    expect(result.current.messages.lastMessage?.id).toBe(\"msg_1\");\n    expect(result.current.messages.lastMessage?.role).toBe(\"assistant\");\n    expect(result.current.messages.assistantMessages.length).toBe(1);\n    expect(result.current.messages.userMessages.length).toBe(0);\n  });\n\n  it(\"filters user and assistant messages correctly\", () => {\n    const { result } = renderHook(\n      () => ({\n        messages: useTamboV1Messages(\"thread_123\"),\n        dispatch: useStreamDispatch(),\n      }),\n      { wrapper: TestWrapper },\n    );\n\n    // Add user message\n    act(() => {\n      result.current.dispatch({\n        type: \"EVENT\",\n        event: {\n          type: EventType.TEXT_MESSAGE_START,\n          messageId: \"msg_user\",\n          role: \"user\",\n        } as TextMessageStartEvent,\n        threadId: \"thread_123\",\n      });\n    });\n\n    act(() => {\n      result.current.dispatch({\n        type: \"EVENT\",\n        event: {\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: \"msg_user\",\n        } as TextMessageEndEvent,\n        threadId: \"thread_123\",\n      });\n    });\n\n    // Add assistant message\n    act(() => {\n      result.current.dispatch({\n        type: \"EVENT\",\n        event: {\n          type: EventType.TEXT_MESSAGE_START,\n          messageId: \"msg_assistant\",\n          role: \"assistant\",\n        } as TextMessageStartEvent,\n        threadId: \"thread_123\",\n      });\n    });\n\n    act(() => {\n      result.current.dispatch({\n        type: \"EVENT\",\n        event: {\n          type: EventType.TEXT_MESSAGE_END,\n          messageId: \"msg_assistant\",\n        } as TextMessageEndEvent,\n        threadId: \"thread_123\",\n      });\n    });\n\n    expect(result.current.messages.messageCount).toBe(2);\n    expect(result.current.messages.userMessages.length).toBe(1);\n    expect(result.current.messages.userMessages[0].id).toBe(\"msg_user\");\n    expect(result.current.messages.assistantMessages.length).toBe(1);\n    expect(result.current.messages.assistantMessages[0].id).toBe(\n      \"msg_assistant\",\n    );\n    expect(result.current.messages.lastMessage?.id).toBe(\"msg_assistant\");\n  });\n\n  it(\"returns empty messages when threadId does not exist in threadMap\", () => {\n    const { result } = renderHook(\n      () => useTamboV1Messages(\"nonexistent_thread\"),\n      {\n        wrapper: TestWrapper,\n      },\n    );\n\n    expect(result.current.messages).toEqual([]);\n    expect(result.current.hasMessages).toBe(false);\n    expect(result.current.messageCount).toBe(0);\n  });\n});\n"]}

package/esm/v1/hooks/use-tambo-v1-send-message.d.ts

@@ -0,0 +1,96 @@
+import type TamboAI from "@tambo-ai/typescript-sdk";
+import type { Stream } from "@tambo-ai/typescript-sdk/core/streaming";
+import { type TamboRegistryContext as TamboRegistry } from "../../providers/tambo-registry-provider";
+import type { InputMessage } from "../types/message";
+/**
+ * Options for sending a message
+ */
+export interface SendMessageOptions {
+    /**
+     * The message to send
+     */
+    message: InputMessage;
+    /**
+     * Enable debug logging for the stream
+     */
+    debug?: boolean;
+}
+/**
+ * Parameters for creating a run stream
+ */
+export interface CreateRunStreamParams {
+    client: TamboAI;
+    threadId: string | undefined;
+    message: InputMessage;
+    registry: TamboRegistry;
+}
+/**
+ * Stream types from the SDK
+ */
+type RunStream = Stream<TamboAI.Threads.Runs.RunRunResponse>;
+type CreateStream = Stream<TamboAI.Threads.Runs.RunCreateResponse>;
+/**
+ * Result from creating a run stream
+ */
+export interface CreateRunStreamResult {
+    stream: RunStream | CreateStream;
+    initialThreadId: string | undefined;
+}
+/**
+ * Creates a run stream by calling the appropriate API method.
+ *
+ * If threadId is provided, runs on existing thread via client.threads.runs.run().
+ * If no threadId, creates new thread via client.threads.runs.create().
+ * @param params - The parameters for creating the run stream
+ * @returns The stream and initial thread ID (undefined if creating new thread)
+ */
+export declare function createRunStream(params: CreateRunStreamParams): Promise<CreateRunStreamResult>;
+/**
+ * Hook to send a message and handle streaming responses.
+ *
+ * This hook handles two scenarios:
+ * - If threadId provided: runs on existing thread via client.threads.runs.run()
+ * - If no threadId: creates new thread via client.threads.runs.create()
+ *
+ * The hook:
+ * - Sends a user message to the API
+ * - Streams AG-UI events in real-time
+ * - Dispatches events to the stream reducer
+ * - Extracts threadId from events when creating new thread
+ * - Handles tool execution (Phase 6)
+ * - Invalidates thread queries on completion
+ * @param threadId - Optional thread ID to send message to. If not provided, creates new thread
+ * @returns React Query mutation object with threadId in mutation result
+ * @example
+ * ```tsx
+ * function ChatInput({ threadId }: { threadId?: string }) {
+ *   const sendMessage = useTamboV1SendMessage(threadId);
+ *
+ *   const handleSubmit = async (text: string) => {
+ *     const result = await sendMessage.mutateAsync({
+ *       message: {
+ *         role: "user",
+ *         content: [{ type: "text", text }],
+ *       },
+ *     });
+ *
+ *     // If threadId wasn't provided, a new thread was created
+ *     if (!threadId) {
+ *       console.log("Created thread:", result.threadId);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input onSubmit={handleSubmit} />
+ *       {sendMessage.isPending && <Spinner />}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useTamboV1SendMessage(threadId?: string): import("@tanstack/react-query").UseMutationResult<{
+    threadId: string | undefined;
+}, Error, SendMessageOptions, unknown>;
+export {};
+//# sourceMappingURL=use-tambo-v1-send-message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-tambo-v1-send-message.d.ts","sourceRoot":"","sources":["../../../src/v1/hooks/use-tambo-v1-send-message.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yCAAyC,CAAC;AAEtE,OAAO,EAEL,KAAK,oBAAoB,IAAI,aAAa,EAC3C,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AASrD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED;;GAEG;AACH,KAAK,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAC7D,KAAK,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,GAAG,YAAY,CAAC;IACjC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAoDD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAyBhC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM;;uCAqHtD"}