@tambo-ai/react 0.70.0 → 0.71.0

package/dist/v1/utils/tool-executor.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Tool Executor for v1 API
+ *
+ * Handles automatic execution of client-side tools when the model
+ * requests them via `tambo.run.awaiting_input` events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeClientTool = executeClientTool;
+exports.executeAllPendingTools = executeAllPendingTools;
+/**
+ * Execute a single client-side tool and return the result.
+ * @param tool - The tool definition from the registry
+ * @param toolCallId - The ID of the tool call to respond to
+ * @param args - The parsed arguments for the tool
+ * @returns ToolResultContent with the execution result or error
+ */
+async function executeClientTool(tool, toolCallId, args) {
+    try {
+        const result = await tool.tool(args);
+        // Transform result to content if transformer provided
+        let content;
+        if (tool.transformToContent) {
+            // transformToContent may return content parts in beta format
+            // Convert to v1 format (TextContent | ResourceContent)
+            const transformed = await tool.transformToContent(result);
+            content = transformed.map((part) => {
+                if (part.type === "text" && "text" in part && part.text) {
+                    return { type: "text", text: part.text };
+                }
+                // For other types, stringify as text
+                return {
+                    type: "text",
+                    text: JSON.stringify(part),
+                };
+            });
+        }
+        else {
+            // Default: stringify result as text
+            content = [
+                {
+                    type: "text",
+                    text: typeof result === "string" ? result : JSON.stringify(result),
+                },
+            ];
+        }
+        return {
+            type: "tool_result",
+            toolUseId: toolCallId,
+            content,
+        };
+    }
+    catch (error) {
+        return {
+            type: "tool_result",
+            toolUseId: toolCallId,
+            content: [
+                {
+                    type: "text",
+                    text: error instanceof Error ? error.message : "Tool execution failed",
+                },
+            ],
+        };
+    }
+}
+/**
+ * Execute all pending tool calls and return their results.
+ * Tools are executed sequentially to avoid race conditions when
+ * tools may have side effects that depend on each other.
+ * @param toolCalls - Map of tool call IDs to their call details
+ * @param registry - Registry of tool names to their definitions (Map or Record)
+ * @returns Array of ToolResultContent for all executed tools
+ */
+async function executeAllPendingTools(toolCalls, registry) {
+    const results = [];
+    // Normalize registry to allow lookup regardless of Map or Record
+    const getTool = (name) => {
+        if (registry instanceof Map) {
+            return registry.get(name);
+        }
+        return registry[name];
+    };
+    for (const [toolCallId, { name, input }] of toolCalls) {
+        const tool = getTool(name);
+        if (!tool) {
+            results.push({
+                type: "tool_result",
+                toolUseId: toolCallId,
+                content: [
+                    {
+                        type: "text",
+                        text: `Tool "${name}" not found in registry`,
+                    },
+                ],
+            });
+            continue;
+        }
+        const result = await executeClientTool(tool, toolCallId, input);
+        results.push(result);
+    }
+    return results;
+}
+//# sourceMappingURL=tool-executor.js.map

package/dist/v1/utils/tool-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.js","sourceRoot":"","sources":["../../../src/v1/utils/tool-executor.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAwBH,8CAoDC;AAUD,wDAmCC;AAxGD;;;;;;GAMG;AACI,KAAK,UAAU,iBAAiB,CACrC,IAAe,EACf,UAAkB,EAClB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAErC,sDAAsD;QACtD,IAAI,OAA0C,CAAC;QAC/C,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,6DAA6D;YAC7D,uDAAuD;YACvD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAC1D,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACjC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACxD,OAAO,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACpD,CAAC;gBACD,qCAAqC;gBACrC,OAAO;oBACL,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;iBAC3B,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,OAAO,GAAG;gBACR;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;iBACnE;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,UAAU;YACrB,OAAO;SACR,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EACF,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB;iBACnE;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,sBAAsB,CAC1C,SAAuC,EACvC,QAA4D;IAE5D,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,iEAAiE;IACjE,MAAM,OAAO,GAAG,CAAC,IAAY,EAAyB,EAAE;QACtD,IAAI,QAAQ,YAAY,GAAG,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,UAAU;gBACrB,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,SAAS,IAAI,yBAAyB;qBAC7C;iBACF;aACF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * Tool Executor for v1 API\n *\n * Handles automatic execution of client-side tools when the model\n * requests them via `tambo.run.awaiting_input` events.\n */\n\nimport type { TamboTool } from \"../../model/component-metadata\";\nimport type {\n  ToolResultContent,\n  TextContent,\n  ResourceContent,\n} from \"@tambo-ai/typescript-sdk/resources/threads/threads\";\n\n/**\n * Pending tool call from the stream accumulator\n */\nexport interface PendingToolCall {\n  name: string;\n  input: Record<string, unknown>;\n}\n\n/**\n * Execute a single client-side tool and return the result.\n * @param tool - The tool definition from the registry\n * @param toolCallId - The ID of the tool call to respond to\n * @param args - The parsed arguments for the tool\n * @returns ToolResultContent with the execution result or error\n */\nexport async function executeClientTool(\n  tool: TamboTool,\n  toolCallId: string,\n  args: Record<string, unknown>,\n): Promise<ToolResultContent> {\n  try {\n    const result = await tool.tool(args);\n\n    // Transform result to content if transformer provided\n    let content: (TextContent | ResourceContent)[];\n    if (tool.transformToContent) {\n      // transformToContent may return content parts in beta format\n      // Convert to v1 format (TextContent | ResourceContent)\n      const transformed = await tool.transformToContent(result);\n      content = transformed.map((part) => {\n        if (part.type === \"text\" && \"text\" in part && part.text) {\n          return { type: \"text\" as const, text: part.text };\n        }\n        // For other types, stringify as text\n        return {\n          type: \"text\" as const,\n          text: JSON.stringify(part),\n        };\n      });\n    } else {\n      // Default: stringify result as text\n      content = [\n        {\n          type: \"text\" as const,\n          text: typeof result === \"string\" ? result : JSON.stringify(result),\n        },\n      ];\n    }\n\n    return {\n      type: \"tool_result\",\n      toolUseId: toolCallId,\n      content,\n    };\n  } catch (error) {\n    return {\n      type: \"tool_result\",\n      toolUseId: toolCallId,\n      content: [\n        {\n          type: \"text\" as const,\n          text:\n            error instanceof Error ? error.message : \"Tool execution failed\",\n        },\n      ],\n    };\n  }\n}\n\n/**\n * Execute all pending tool calls and return their results.\n * Tools are executed sequentially to avoid race conditions when\n * tools may have side effects that depend on each other.\n * @param toolCalls - Map of tool call IDs to their call details\n * @param registry - Registry of tool names to their definitions (Map or Record)\n * @returns Array of ToolResultContent for all executed tools\n */\nexport async function executeAllPendingTools(\n  toolCalls: Map<string, PendingToolCall>,\n  registry: Map<string, TamboTool> | Record<string, TamboTool>,\n): Promise<ToolResultContent[]> {\n  const results: ToolResultContent[] = [];\n\n  // Normalize registry to allow lookup regardless of Map or Record\n  const getTool = (name: string): TamboTool | undefined => {\n    if (registry instanceof Map) {\n      return registry.get(name);\n    }\n    return registry[name];\n  };\n\n  for (const [toolCallId, { name, input }] of toolCalls) {\n    const tool = getTool(name);\n    if (!tool) {\n      results.push({\n        type: \"tool_result\",\n        toolUseId: toolCallId,\n        content: [\n          {\n            type: \"text\" as const,\n            text: `Tool \"${name}\" not found in registry`,\n          },\n        ],\n      });\n      continue;\n    }\n\n    const result = await executeClientTool(tool, toolCallId, input);\n    results.push(result);\n  }\n\n  return results;\n}\n"]}

package/dist/v1/utils/tool-executor.test.d.ts

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

package/dist/v1/utils/tool-executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.test.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/tool-executor.test.ts"],"names":[],"mappings":""}

package/dist/v1/utils/tool-executor.test.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const tool_executor_1 = require("./tool-executor");
+describe("tool-executor", () => {
+    describe("executeClientTool", () => {
+        it("executes a tool and returns text result", async () => {
+            const tool = {
+                name: "get_weather",
+                description: "Gets weather",
+                tool: async ({ city }) => `Weather in ${city} is sunny`,
+                inputSchema: zod_1.z.object({ city: zod_1.z.string() }),
+                outputSchema: zod_1.z.string(),
+            };
+            const result = await (0, tool_executor_1.executeClientTool)(tool, "call-1", {
+                city: "Seattle",
+            });
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-1",
+                content: [{ type: "text", text: "Weather in Seattle is sunny" }],
+            });
+        });
+        it("stringifies non-string results", async () => {
+            const tool = {
+                name: "get_data",
+                description: "Gets data",
+                tool: async () => ({ value: 42 }),
+                inputSchema: zod_1.z.object({}),
+                outputSchema: zod_1.z.object({ value: zod_1.z.number() }),
+            };
+            const result = await (0, tool_executor_1.executeClientTool)(tool, "call-2", {});
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-2",
+                content: [{ type: "text", text: '{"value":42}' }],
+            });
+        });
+        it("uses transformToContent when provided", async () => {
+            const tool = {
+                name: "custom_tool",
+                description: "Custom tool",
+                tool: async () => "custom result",
+                inputSchema: zod_1.z.object({}),
+                outputSchema: zod_1.z.string(),
+                transformToContent: (result) => [
+                    { type: "text", text: `Transformed: ${result}` },
+                ],
+            };
+            const result = await (0, tool_executor_1.executeClientTool)(tool, "call-3", {});
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-3",
+                content: [{ type: "text", text: "Transformed: custom result" }],
+            });
+        });
+        it("handles transformToContent with non-text types by stringifying", async () => {
+            const tool = {
+                name: "image_tool",
+                description: "Image tool",
+                tool: async () => "image data",
+                inputSchema: zod_1.z.object({}),
+                outputSchema: zod_1.z.string(),
+                transformToContent: () => [
+                    {
+                        type: "image_url",
+                        image_url: { url: "https://example.com/image.png" },
+                    },
+                ],
+            };
+            const result = await (0, tool_executor_1.executeClientTool)(tool, "call-4", {});
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-4",
+                content: [
+                    {
+                        type: "text",
+                        text: '{"type":"image_url","image_url":{"url":"https://example.com/image.png"}}',
+                    },
+                ],
+            });
+        });
+        it("handles tool execution errors gracefully", async () => {
+            const tool = {
+                name: "failing_tool",
+                description: "A tool that fails",
+                tool: async () => {
+                    throw new Error("Tool failed!");
+                },
+                inputSchema: zod_1.z.object({}),
+                outputSchema: zod_1.z.void(),
+            };
+            const result = await (0, tool_executor_1.executeClientTool)(tool, "call-5", {});
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-5",
+                content: [{ type: "text", text: "Tool failed!" }],
+            });
+        });
+        it("handles non-Error throws gracefully", async () => {
+            const tool = {
+                name: "throwing_tool",
+                description: "A tool that throws a string",
+                tool: async () => {
+                    throw "string error";
+                },
+                inputSchema: zod_1.z.object({}),
+                outputSchema: zod_1.z.void(),
+            };
+            const result = await (0, tool_executor_1.executeClientTool)(tool, "call-6", {});
+            expect(result).toEqual({
+                type: "tool_result",
+                toolUseId: "call-6",
+                content: [{ type: "text", text: "Tool execution failed" }],
+            });
+        });
+    });
+    describe("executeAllPendingTools", () => {
+        it("executes multiple tools with Map registry", async () => {
+            const registry = new Map([
+                [
+                    "add",
+                    {
+                        name: "add",
+                        description: "Adds numbers",
+                        tool: async ({ a, b }) => a + b,
+                        inputSchema: zod_1.z.object({ a: zod_1.z.number(), b: zod_1.z.number() }),
+                        outputSchema: zod_1.z.number(),
+                    },
+                ],
+                [
+                    "multiply",
+                    {
+                        name: "multiply",
+                        description: "Multiplies numbers",
+                        tool: async ({ a, b }) => a * b,
+                        inputSchema: zod_1.z.object({ a: zod_1.z.number(), b: zod_1.z.number() }),
+                        outputSchema: zod_1.z.number(),
+                    },
+                ],
+            ]);
+            const toolCalls = new Map([
+                ["call-1", { name: "add", input: { a: 2, b: 3 } }],
+                ["call-2", { name: "multiply", input: { a: 4, b: 5 } }],
+            ]);
+            const results = await (0, tool_executor_1.executeAllPendingTools)(toolCalls, registry);
+            expect(results).toHaveLength(2);
+            expect(results[0]).toEqual({
+                type: "tool_result",
+                toolUseId: "call-1",
+                content: [{ type: "text", text: "5" }],
+            });
+            expect(results[1]).toEqual({
+                type: "tool_result",
+                toolUseId: "call-2",
+                content: [{ type: "text", text: "20" }],
+            });
+        });
+        it("executes tools with Record registry", async () => {
+            const registry = {
+                greet: {
+                    name: "greet",
+                    description: "Greets user",
+                    tool: async ({ name }) => `Hello, ${name}!`,
+                    inputSchema: zod_1.z.object({ name: zod_1.z.string() }),
+                    outputSchema: zod_1.z.string(),
+                },
+            };
+            const toolCalls = new Map([
+                ["call-1", { name: "greet", input: { name: "World" } }],
+            ]);
+            const results = await (0, tool_executor_1.executeAllPendingTools)(toolCalls, registry);
+            expect(results).toHaveLength(1);
+            expect(results[0]).toEqual({
+                type: "tool_result",
+                toolUseId: "call-1",
+                content: [{ type: "text", text: "Hello, World!" }],
+            });
+        });
+        it("returns error result for unknown tools", async () => {
+            const registry = new Map();
+            const toolCalls = new Map([
+                ["call-1", { name: "unknown_tool", input: {} }],
+            ]);
+            const results = await (0, tool_executor_1.executeAllPendingTools)(toolCalls, registry);
+            expect(results).toHaveLength(1);
+            expect(results[0]).toEqual({
+                type: "tool_result",
+                toolUseId: "call-1",
+                content: [
+                    { type: "text", text: 'Tool "unknown_tool" not found in registry' },
+                ],
+            });
+        });
+        it("handles mixed known and unknown tools", async () => {
+            const registry = new Map([
+                [
+                    "known",
+                    {
+                        name: "known",
+                        description: "Known tool",
+                        tool: async () => "success",
+                        inputSchema: zod_1.z.object({}),
+                        outputSchema: zod_1.z.string(),
+                    },
+                ],
+            ]);
+            const toolCalls = new Map([
+                ["call-1", { name: "known", input: {} }],
+                ["call-2", { name: "unknown", input: {} }],
+            ]);
+            const results = await (0, tool_executor_1.executeAllPendingTools)(toolCalls, registry);
+            expect(results).toHaveLength(2);
+            expect(results[0].content[0]).toEqual({ type: "text", text: "success" });
+            expect(results[1].content[0]).toEqual({
+                type: "text",
+                text: 'Tool "unknown" not found in registry',
+            });
+        });
+    });
+});
+//# sourceMappingURL=tool-executor.test.js.map

package/dist/v1/utils/tool-executor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.test.js","sourceRoot":"","sources":["../../../src/v1/utils/tool-executor.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport type { TamboTool } from \"../../model/component-metadata\";\nimport {\n  executeClientTool,\n  executeAllPendingTools,\n  type PendingToolCall,\n} from \"./tool-executor\";\n\ndescribe(\"tool-executor\", () => {\n  describe(\"executeClientTool\", () => {\n    it(\"executes a tool and returns text result\", async () => {\n      const tool: TamboTool = {\n        name: \"get_weather\",\n        description: \"Gets weather\",\n        tool: async ({ city }: { city: string }) =>\n          `Weather in ${city} is sunny`,\n        inputSchema: z.object({ city: z.string() }),\n        outputSchema: z.string(),\n      };\n\n      const result = await executeClientTool(tool, \"call-1\", {\n        city: \"Seattle\",\n      });\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-1\",\n        content: [{ type: \"text\", text: \"Weather in Seattle is sunny\" }],\n      });\n    });\n\n    it(\"stringifies non-string results\", async () => {\n      const tool: TamboTool = {\n        name: \"get_data\",\n        description: \"Gets data\",\n        tool: async () => ({ value: 42 }),\n        inputSchema: z.object({}),\n        outputSchema: z.object({ value: z.number() }),\n      };\n\n      const result = await executeClientTool(tool, \"call-2\", {});\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-2\",\n        content: [{ type: \"text\", text: '{\"value\":42}' }],\n      });\n    });\n\n    it(\"uses transformToContent when provided\", async () => {\n      const tool: TamboTool = {\n        name: \"custom_tool\",\n        description: \"Custom tool\",\n        tool: async () => \"custom result\",\n        inputSchema: z.object({}),\n        outputSchema: z.string(),\n        transformToContent: (result) => [\n          { type: \"text\", text: `Transformed: ${result}` },\n        ],\n      };\n\n      const result = await executeClientTool(tool, \"call-3\", {});\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-3\",\n        content: [{ type: \"text\", text: \"Transformed: custom result\" }],\n      });\n    });\n\n    it(\"handles transformToContent with non-text types by stringifying\", async () => {\n      const tool: TamboTool = {\n        name: \"image_tool\",\n        description: \"Image tool\",\n        tool: async () => \"image data\",\n        inputSchema: z.object({}),\n        outputSchema: z.string(),\n        transformToContent: () => [\n          {\n            type: \"image_url\",\n            image_url: { url: \"https://example.com/image.png\" },\n          },\n        ],\n      };\n\n      const result = await executeClientTool(tool, \"call-4\", {});\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-4\",\n        content: [\n          {\n            type: \"text\",\n            text: '{\"type\":\"image_url\",\"image_url\":{\"url\":\"https://example.com/image.png\"}}',\n          },\n        ],\n      });\n    });\n\n    it(\"handles tool execution errors gracefully\", async () => {\n      const tool: TamboTool = {\n        name: \"failing_tool\",\n        description: \"A tool that fails\",\n        tool: async () => {\n          throw new Error(\"Tool failed!\");\n        },\n        inputSchema: z.object({}),\n        outputSchema: z.void(),\n      };\n\n      const result = await executeClientTool(tool, \"call-5\", {});\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-5\",\n        content: [{ type: \"text\", text: \"Tool failed!\" }],\n      });\n    });\n\n    it(\"handles non-Error throws gracefully\", async () => {\n      const tool: TamboTool = {\n        name: \"throwing_tool\",\n        description: \"A tool that throws a string\",\n        tool: async () => {\n          throw \"string error\";\n        },\n        inputSchema: z.object({}),\n        outputSchema: z.void(),\n      };\n\n      const result = await executeClientTool(tool, \"call-6\", {});\n\n      expect(result).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-6\",\n        content: [{ type: \"text\", text: \"Tool execution failed\" }],\n      });\n    });\n  });\n\n  describe(\"executeAllPendingTools\", () => {\n    it(\"executes multiple tools with Map registry\", async () => {\n      const registry = new Map<string, TamboTool>([\n        [\n          \"add\",\n          {\n            name: \"add\",\n            description: \"Adds numbers\",\n            tool: async ({ a, b }: { a: number; b: number }) => a + b,\n            inputSchema: z.object({ a: z.number(), b: z.number() }),\n            outputSchema: z.number(),\n          },\n        ],\n        [\n          \"multiply\",\n          {\n            name: \"multiply\",\n            description: \"Multiplies numbers\",\n            tool: async ({ a, b }: { a: number; b: number }) => a * b,\n            inputSchema: z.object({ a: z.number(), b: z.number() }),\n            outputSchema: z.number(),\n          },\n        ],\n      ]);\n\n      const toolCalls = new Map<string, PendingToolCall>([\n        [\"call-1\", { name: \"add\", input: { a: 2, b: 3 } }],\n        [\"call-2\", { name: \"multiply\", input: { a: 4, b: 5 } }],\n      ]);\n\n      const results = await executeAllPendingTools(toolCalls, registry);\n\n      expect(results).toHaveLength(2);\n      expect(results[0]).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-1\",\n        content: [{ type: \"text\", text: \"5\" }],\n      });\n      expect(results[1]).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-2\",\n        content: [{ type: \"text\", text: \"20\" }],\n      });\n    });\n\n    it(\"executes tools with Record registry\", async () => {\n      const registry: Record<string, TamboTool> = {\n        greet: {\n          name: \"greet\",\n          description: \"Greets user\",\n          tool: async ({ name }: { name: string }) => `Hello, ${name}!`,\n          inputSchema: z.object({ name: z.string() }),\n          outputSchema: z.string(),\n        },\n      };\n\n      const toolCalls = new Map<string, PendingToolCall>([\n        [\"call-1\", { name: \"greet\", input: { name: \"World\" } }],\n      ]);\n\n      const results = await executeAllPendingTools(toolCalls, registry);\n\n      expect(results).toHaveLength(1);\n      expect(results[0]).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-1\",\n        content: [{ type: \"text\", text: \"Hello, World!\" }],\n      });\n    });\n\n    it(\"returns error result for unknown tools\", async () => {\n      const registry = new Map<string, TamboTool>();\n\n      const toolCalls = new Map<string, PendingToolCall>([\n        [\"call-1\", { name: \"unknown_tool\", input: {} }],\n      ]);\n\n      const results = await executeAllPendingTools(toolCalls, registry);\n\n      expect(results).toHaveLength(1);\n      expect(results[0]).toEqual({\n        type: \"tool_result\",\n        toolUseId: \"call-1\",\n        content: [\n          { type: \"text\", text: 'Tool \"unknown_tool\" not found in registry' },\n        ],\n      });\n    });\n\n    it(\"handles mixed known and unknown tools\", async () => {\n      const registry = new Map<string, TamboTool>([\n        [\n          \"known\",\n          {\n            name: \"known\",\n            description: \"Known tool\",\n            tool: async () => \"success\",\n            inputSchema: z.object({}),\n            outputSchema: z.string(),\n          },\n        ],\n      ]);\n\n      const toolCalls = new Map<string, PendingToolCall>([\n        [\"call-1\", { name: \"known\", input: {} }],\n        [\"call-2\", { name: \"unknown\", input: {} }],\n      ]);\n\n      const results = await executeAllPendingTools(toolCalls, registry);\n\n      expect(results).toHaveLength(2);\n      expect(results[0].content[0]).toEqual({ type: \"text\", text: \"success\" });\n      expect(results[1].content[0]).toEqual({\n        type: \"text\",\n        text: 'Tool \"unknown\" not found in registry',\n      });\n    });\n  });\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