@tambo-ai/react 0.69.1 → 0.71.0

package/esm/v1/utils/registry-conversion.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-conversion.test.js","sourceRoot":"","sources":["../../../src/v1/utils/registry-conversion.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport type { TamboComponent, TamboTool } from \"../../model/component-metadata\";\nimport {\n  toAvailableComponent,\n  toAvailableComponents,\n  toAvailableTool,\n  toAvailableTools,\n} from \"./registry-conversion\";\n\ndescribe(\"registry-conversion\", () => {\n  describe(\"toAvailableComponent\", () => {\n    it(\"converts a component with propsSchema\", () => {\n      const component: TamboComponent = {\n        name: \"WeatherCard\",\n        description: \"Displays weather information\",\n        component: () => null,\n        propsSchema: z.object({\n          city: z.string(),\n          temperature: z.number(),\n        }),\n      };\n\n      const result = toAvailableComponent(component);\n\n      expect(result.name).toBe(\"WeatherCard\");\n      expect(result.description).toBe(\"Displays weather information\");\n      expect(result.propsSchema).toBeDefined();\n      expect((result.propsSchema as Record<string, unknown>).type).toBe(\n        \"object\",\n      );\n    });\n\n    it(\"throws when propsSchema is missing\", () => {\n      const component = {\n        name: \"BadComponent\",\n        description: \"Missing schema\",\n        component: () => null,\n      } as TamboComponent;\n\n      expect(() => toAvailableComponent(component)).toThrow(\n        'Component \"BadComponent\" missing propsSchema',\n      );\n    });\n  });\n\n  describe(\"toAvailableComponents\", () => {\n    it(\"converts a Record of components\", () => {\n      const components: Record<string, TamboComponent> = {\n        Card: {\n          name: \"Card\",\n          description: \"A card component\",\n          component: () => null,\n          propsSchema: z.object({ title: z.string() }),\n        },\n        Button: {\n          name: \"Button\",\n          description: \"A button component\",\n          component: () => null,\n          propsSchema: z.object({ label: z.string() }),\n        },\n      };\n\n      const result = toAvailableComponents(components);\n\n      expect(result).toHaveLength(2);\n      expect(result.map((c) => c.name)).toContain(\"Card\");\n      expect(result.map((c) => c.name)).toContain(\"Button\");\n    });\n\n    it(\"converts a Map of components\", () => {\n      const components = new Map<string, TamboComponent>([\n        [\n          \"Card\",\n          {\n            name: \"Card\",\n            description: \"A card\",\n            component: () => null,\n            propsSchema: z.object({ title: z.string() }),\n          },\n        ],\n      ]);\n\n      const result = toAvailableComponents(components);\n\n      expect(result).toHaveLength(1);\n      expect(result[0].name).toBe(\"Card\");\n    });\n\n    it(\"skips invalid components and logs warning\", () => {\n      const warnSpy = jest.spyOn(console, \"warn\").mockImplementation(() => {});\n\n      const components: Record<string, TamboComponent> = {\n        Valid: {\n          name: \"Valid\",\n          description: \"Valid component\",\n          component: () => null,\n          propsSchema: z.object({ x: z.string() }),\n        },\n        Invalid: {\n          name: \"Invalid\",\n          description: \"Missing schema\",\n          component: () => null,\n        } as TamboComponent,\n      };\n\n      const result = toAvailableComponents(components);\n\n      expect(result).toHaveLength(1);\n      expect(result[0].name).toBe(\"Valid\");\n      expect(warnSpy).toHaveBeenCalledWith(\n        expect.stringContaining('Skipping component \"Invalid\"'),\n      );\n\n      warnSpy.mockRestore();\n    });\n  });\n\n  describe(\"toAvailableTool\", () => {\n    it(\"converts a tool with inputSchema\", () => {\n      const tool: TamboTool = {\n        name: \"get_weather\",\n        description: \"Gets weather for a city\",\n        tool: async () => ({ temp: 72 }),\n        inputSchema: z.object({ city: z.string() }),\n        outputSchema: z.any(),\n      };\n\n      const result = toAvailableTool(tool);\n\n      expect(result.name).toBe(\"get_weather\");\n      expect(result.description).toBe(\"Gets weather for a city\");\n      expect(result.inputSchema).toBeDefined();\n      expect((result.inputSchema as Record<string, unknown>).type).toBe(\n        \"object\",\n      );\n    });\n\n    it(\"throws when schema is missing\", () => {\n      const tool = {\n        name: \"bad_tool\",\n        description: \"Missing schema\",\n        tool: async () => ({}),\n      } as unknown as TamboTool;\n\n      expect(() => toAvailableTool(tool)).toThrow(\n        'Tool \"bad_tool\" missing inputSchema or toolSchema',\n      );\n    });\n  });\n\n  describe(\"toAvailableTools\", () => {\n    it(\"converts a Record of tools\", () => {\n      const tools: Record<string, TamboTool> = {\n        search: {\n          name: \"search\",\n          description: \"Search the web\",\n          tool: async () => [],\n          inputSchema: z.object({ query: z.string() }),\n          outputSchema: z.any(),\n        },\n        calculate: {\n          name: \"calculate\",\n          description: \"Calculate expression\",\n          tool: async () => 0,\n          inputSchema: z.object({ expr: z.string() }),\n          outputSchema: z.any(),\n        },\n      };\n\n      const result = toAvailableTools(tools);\n\n      expect(result).toHaveLength(2);\n      expect(result.map((t) => t.name)).toContain(\"search\");\n      expect(result.map((t) => t.name)).toContain(\"calculate\");\n    });\n\n    it(\"converts a Map of tools\", () => {\n      const tools = new Map<string, TamboTool>([\n        [\n          \"fetch\",\n          {\n            name: \"fetch\",\n            description: \"Fetch data\",\n            tool: async () => null,\n            inputSchema: z.object({ url: z.string() }),\n            outputSchema: z.any(),\n          },\n        ],\n      ]);\n\n      const result = toAvailableTools(tools);\n\n      expect(result).toHaveLength(1);\n      expect(result[0].name).toBe(\"fetch\");\n    });\n\n    it(\"skips invalid tools and logs warning\", () => {\n      const warnSpy = jest.spyOn(console, \"warn\").mockImplementation(() => {});\n\n      const tools: Record<string, TamboTool> = {\n        valid: {\n          name: \"valid\",\n          description: \"Valid tool\",\n          tool: async () => null,\n          inputSchema: z.object({ x: z.number() }),\n          outputSchema: z.any(),\n        },\n        invalid: {\n          name: \"invalid\",\n          description: \"Missing schema\",\n          tool: async () => null,\n        } as unknown as TamboTool,\n      };\n\n      const result = toAvailableTools(tools);\n\n      expect(result).toHaveLength(1);\n      expect(result[0].name).toBe(\"valid\");\n      expect(warnSpy).toHaveBeenCalledWith(\n        expect.stringContaining('Skipping tool \"invalid\"'),\n      );\n\n      warnSpy.mockRestore();\n    });\n  });\n});\n"]}

package/esm/v1/utils/stream-handler.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Stream Handler for v1 Streaming API
+ *
+ * Provides utilities for handling event streams from the TypeScript SDK.
+ * The SDK's client.threads.runs.run() already returns an async iterable,
+ * so this module just adds optional debug logging.
+ */
+import type { AGUIEvent } from "@ag-ui/core";
+/**
+ * Options for stream handling.
+ */
+export interface StreamHandlerOptions {
+    /**
+     * Enable debug logging (development mode only).
+     * Logs all events to console.
+     */
+    debug?: boolean;
+}
+/**
+ * Handle an event stream from the TypeScript SDK and yield AG-UI event types.
+ *
+ * The TypeScript SDK's client.threads.runs.run() and client.threads.runs.create()
+ * return async iterables that yield events compatible with AG-UI's AGUIEvent.
+ * This function wraps the stream to add optional debug logging and ensures
+ * proper typing.
+ *
+ * Note: SDK events have `type: string` rather than `type: EventType` enum,
+ * but the values are compatible with AG-UI event types.
+ * @param stream - Async iterable of events from SDK
+ * @param options - Optional configuration for stream handling
+ * @yields {AGUIEvent} AG-UI event types from the stream
+ * @returns Async iterable of AG-UI event types
+ * @example
+ * ```typescript
+ * const stream = await client.threads.runs.run(threadId, {
+ *   message: { role: "user", content: [{ type: "text", text: "hello" }] },
+ * });
+ *
+ * for await (const event of handleEventStream(stream, { debug: true })) {
+ *   dispatch({ type: 'EVENT', event }); // Send to reducer
+ * }
+ * ```
+ */
+export declare function handleEventStream(stream: AsyncIterable<unknown>, options?: StreamHandlerOptions): AsyncIterable<AGUIEvent>;
+//# sourceMappingURL=stream-handler.d.ts.map

package/esm/v1/utils/stream-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-handler.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/stream-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAuB,iBAAiB,CACtC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAAC,SAAS,CAAC,CAY1B"}

package/esm/v1/utils/stream-handler.js

@@ -0,0 +1,44 @@
+/**
+ * Stream Handler for v1 Streaming API
+ *
+ * Provides utilities for handling event streams from the TypeScript SDK.
+ * The SDK's client.threads.runs.run() already returns an async iterable,
+ * so this module just adds optional debug logging.
+ */
+/**
+ * Handle an event stream from the TypeScript SDK and yield AG-UI event types.
+ *
+ * The TypeScript SDK's client.threads.runs.run() and client.threads.runs.create()
+ * return async iterables that yield events compatible with AG-UI's AGUIEvent.
+ * This function wraps the stream to add optional debug logging and ensures
+ * proper typing.
+ *
+ * Note: SDK events have `type: string` rather than `type: EventType` enum,
+ * but the values are compatible with AG-UI event types.
+ * @param stream - Async iterable of events from SDK
+ * @param options - Optional configuration for stream handling
+ * @yields {AGUIEvent} AG-UI event types from the stream
+ * @returns Async iterable of AG-UI event types
+ * @example
+ * ```typescript
+ * const stream = await client.threads.runs.run(threadId, {
+ *   message: { role: "user", content: [{ type: "text", text: "hello" }] },
+ * });
+ *
+ * for await (const event of handleEventStream(stream, { debug: true })) {
+ *   dispatch({ type: 'EVENT', event }); // Send to reducer
+ * }
+ * ```
+ */
+export async function* handleEventStream(stream, options) {
+    const { debug = false } = options ?? {};
+    for await (const event of stream) {
+        if (debug && process.env.NODE_ENV !== "production") {
+            // eslint-disable-next-line no-console
+            console.log("[StreamHandler] Event:", event);
+        }
+        // SDK events are compatible with AG-UI AGUIEvent discriminated union
+        yield event;
+    }
+}
+//# sourceMappingURL=stream-handler.js.map

package/esm/v1/utils/stream-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-handler.js","sourceRoot":"","sources":["../../../src/v1/utils/stream-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,iBAAiB,CACtC,MAA8B,EAC9B,OAA8B;IAE9B,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAExC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,IAAI,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACnD,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;QAED,qEAAqE;QACrE,MAAM,KAAkB,CAAC;IAC3B,CAAC;AACH,CAAC","sourcesContent":["/**\n * Stream Handler for v1 Streaming API\n *\n * Provides utilities for handling event streams from the TypeScript SDK.\n * The SDK's client.threads.runs.run() already returns an async iterable,\n * so this module just adds optional debug logging.\n */\n\nimport type { AGUIEvent } from \"@ag-ui/core\";\n\n/**\n * Options for stream handling.\n */\nexport interface StreamHandlerOptions {\n  /**\n   * Enable debug logging (development mode only).\n   * Logs all events to console.\n   */\n  debug?: boolean;\n}\n\n/**\n * Handle an event stream from the TypeScript SDK and yield AG-UI event types.\n *\n * The TypeScript SDK's client.threads.runs.run() and client.threads.runs.create()\n * return async iterables that yield events compatible with AG-UI's AGUIEvent.\n * This function wraps the stream to add optional debug logging and ensures\n * proper typing.\n *\n * Note: SDK events have `type: string` rather than `type: EventType` enum,\n * but the values are compatible with AG-UI event types.\n * @param stream - Async iterable of events from SDK\n * @param options - Optional configuration for stream handling\n * @yields {AGUIEvent} AG-UI event types from the stream\n * @returns Async iterable of AG-UI event types\n * @example\n * ```typescript\n * const stream = await client.threads.runs.run(threadId, {\n *   message: { role: \"user\", content: [{ type: \"text\", text: \"hello\" }] },\n * });\n *\n * for await (const event of handleEventStream(stream, { debug: true })) {\n *   dispatch({ type: 'EVENT', event }); // Send to reducer\n * }\n * ```\n */\nexport async function* handleEventStream(\n  stream: AsyncIterable<unknown>,\n  options?: StreamHandlerOptions,\n): AsyncIterable<AGUIEvent> {\n  const { debug = false } = options ?? {};\n\n  for await (const event of stream) {\n    if (debug && process.env.NODE_ENV !== \"production\") {\n      // eslint-disable-next-line no-console\n      console.log(\"[StreamHandler] Event:\", event);\n    }\n\n    // SDK events are compatible with AG-UI AGUIEvent discriminated union\n    yield event as AGUIEvent;\n  }\n}\n"]}

package/esm/v1/utils/stream-handler.test.d.ts

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

package/esm/v1/utils/stream-handler.test.d.ts.map

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

package/esm/v1/utils/stream-handler.test.js

@@ -0,0 +1,72 @@
+import { EventType } from "@ag-ui/core";
+import { handleEventStream } from "./stream-handler";
+describe("handleEventStream", () => {
+    it("yields events from the stream", async () => {
+        const mockEvents = [
+            { type: EventType.RUN_STARTED, runId: "run_1", threadId: "thread_1" },
+            {
+                type: EventType.TEXT_MESSAGE_START,
+                messageId: "msg_1",
+                role: "assistant",
+            },
+            { type: EventType.RUN_FINISHED, runId: "run_1", threadId: "thread_1" },
+        ];
+        async function* mockStream() {
+            for (const event of mockEvents) {
+                yield event;
+            }
+        }
+        const result = [];
+        for await (const event of handleEventStream(mockStream())) {
+            result.push(event);
+        }
+        expect(result).toHaveLength(3);
+        expect(result[0]).toEqual(mockEvents[0]);
+        expect(result[1]).toEqual(mockEvents[1]);
+        expect(result[2]).toEqual(mockEvents[2]);
+    });
+    it("handles empty stream", async () => {
+        async function* emptyStream() {
+            // yields nothing
+        }
+        const result = [];
+        for await (const event of handleEventStream(emptyStream())) {
+            result.push(event);
+        }
+        expect(result).toHaveLength(0);
+    });
+    it("logs events when debug is enabled in non-production", async () => {
+        const originalEnv = process.env.NODE_ENV;
+        process.env.NODE_ENV = "development";
+        const logSpy = jest.spyOn(console, "log").mockImplementation(() => { });
+        const mockEvents = [{ type: EventType.RUN_STARTED, runId: "run_1" }];
+        async function* mockStream() {
+            for (const event of mockEvents) {
+                yield event;
+            }
+        }
+        const result = [];
+        for await (const event of handleEventStream(mockStream(), {
+            debug: true,
+        })) {
+            result.push(event);
+        }
+        expect(logSpy).toHaveBeenCalledWith("[StreamHandler] Event:", expect.objectContaining({ type: EventType.RUN_STARTED }));
+        logSpy.mockRestore();
+        process.env.NODE_ENV = originalEnv;
+    });
+    it("does not log when debug is false", async () => {
+        const logSpy = jest.spyOn(console, "log").mockImplementation(() => { });
+        async function* mockStream() {
+            yield { type: EventType.RUN_STARTED };
+        }
+        for await (const _event of handleEventStream(mockStream(), {
+            debug: false,
+        })) {
+            // consume stream
+        }
+        expect(logSpy).not.toHaveBeenCalled();
+        logSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=stream-handler.test.js.map

package/esm/v1/utils/stream-handler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-handler.test.js","sourceRoot":"","sources":["../../../src/v1/utils/stream-handler.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,UAAU,GAAG;YACjB,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE;YACrE;gBACE,IAAI,EAAE,SAAS,CAAC,kBAAkB;gBAClC,SAAS,EAAE,OAAO;gBAClB,IAAI,EAAE,WAAW;aAClB;YACD,EAAE,IAAI,EAAE,SAAS,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE;SACvE,CAAC;QAEF,KAAK,SAAS,CAAC,CAAC,UAAU;YACxB,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,iBAAiB,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QACpC,KAAK,SAAS,CAAC,CAAC,WAAW;YACzB,iBAAiB;QACnB,CAAC;QAED,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,iBAAiB,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,aAAa,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEvE,MAAM,UAAU,GAAG,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAErE,KAAK,SAAS,CAAC,CAAC,UAAU;YACxB,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,iBAAiB,CAAC,UAAU,EAAE,EAAE;YACxD,KAAK,EAAE,IAAI;SACZ,CAAC,EAAE,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,CAAC,oBAAoB,CACjC,wBAAwB,EACxB,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,CACzD,CAAC;QAEF,MAAM,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,WAAW,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEvE,KAAK,SAAS,CAAC,CAAC,UAAU;YACxB,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC;QACxC,CAAC;QAED,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,iBAAiB,CAAC,UAAU,EAAE,EAAE;YACzD,KAAK,EAAE,KAAK;SACb,CAAC,EAAE,CAAC;YACH,iBAAiB;QACnB,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACtC,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { EventType } from \"@ag-ui/core\";\nimport { handleEventStream } from \"./stream-handler\";\n\ndescribe(\"handleEventStream\", () => {\n  it(\"yields events from the stream\", async () => {\n    const mockEvents = [\n      { type: EventType.RUN_STARTED, runId: \"run_1\", threadId: \"thread_1\" },\n      {\n        type: EventType.TEXT_MESSAGE_START,\n        messageId: \"msg_1\",\n        role: \"assistant\",\n      },\n      { type: EventType.RUN_FINISHED, runId: \"run_1\", threadId: \"thread_1\" },\n    ];\n\n    async function* mockStream() {\n      for (const event of mockEvents) {\n        yield event;\n      }\n    }\n\n    const result: unknown[] = [];\n    for await (const event of handleEventStream(mockStream())) {\n      result.push(event);\n    }\n\n    expect(result).toHaveLength(3);\n    expect(result[0]).toEqual(mockEvents[0]);\n    expect(result[1]).toEqual(mockEvents[1]);\n    expect(result[2]).toEqual(mockEvents[2]);\n  });\n\n  it(\"handles empty stream\", async () => {\n    async function* emptyStream() {\n      // yields nothing\n    }\n\n    const result: unknown[] = [];\n    for await (const event of handleEventStream(emptyStream())) {\n      result.push(event);\n    }\n\n    expect(result).toHaveLength(0);\n  });\n\n  it(\"logs events when debug is enabled in non-production\", async () => {\n    const originalEnv = process.env.NODE_ENV;\n    process.env.NODE_ENV = \"development\";\n    const logSpy = jest.spyOn(console, \"log\").mockImplementation(() => {});\n\n    const mockEvents = [{ type: EventType.RUN_STARTED, runId: \"run_1\" }];\n\n    async function* mockStream() {\n      for (const event of mockEvents) {\n        yield event;\n      }\n    }\n\n    const result: unknown[] = [];\n    for await (const event of handleEventStream(mockStream(), {\n      debug: true,\n    })) {\n      result.push(event);\n    }\n\n    expect(logSpy).toHaveBeenCalledWith(\n      \"[StreamHandler] Event:\",\n      expect.objectContaining({ type: EventType.RUN_STARTED }),\n    );\n\n    logSpy.mockRestore();\n    process.env.NODE_ENV = originalEnv;\n  });\n\n  it(\"does not log when debug is false\", async () => {\n    const logSpy = jest.spyOn(console, \"log\").mockImplementation(() => {});\n\n    async function* mockStream() {\n      yield { type: EventType.RUN_STARTED };\n    }\n\n    for await (const _event of handleEventStream(mockStream(), {\n      debug: false,\n    })) {\n      // consume stream\n    }\n\n    expect(logSpy).not.toHaveBeenCalled();\n    logSpy.mockRestore();\n  });\n});\n"]}

package/esm/v1/utils/tool-call-tracker.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Tool Call Tracker for v1 API
+ *
+ * Tracks tool calls during streaming, accumulating arguments until complete.
+ * Used by the send message hook to collect tool call state for execution.
+ */
+import { type AGUIEvent } from "@ag-ui/core";
+import type { PendingToolCall } from "./tool-executor";
+/**
+ * Tracks tool calls during streaming, accumulating arguments until complete.
+ *
+ * Tool calls arrive as a sequence of events:
+ * 1. TOOL_CALL_START - initializes the tool call with name
+ * 2. TOOL_CALL_ARGS (multiple) - streams JSON argument fragments
+ * 3. TOOL_CALL_END - marks the tool call as complete, triggers JSON parsing
+ *
+ * This class accumulates these events and provides the complete tool call
+ * data when requested for execution.
+ */
+export declare class ToolCallTracker {
+    private pendingToolCalls;
+    private accumulatingArgs;
+    /**
+     * Handles a streaming event, tracking tool call state as needed.
+     * @param event - The streaming event to process
+     * @throws {Error} If JSON parsing fails on TOOL_CALL_END (fail-fast, no silent fallback)
+     */
+    handleEvent(event: AGUIEvent): void;
+    /**
+     * Gets tool calls for the given IDs, filtered to only those that exist.
+     * @param toolCallIds - IDs of tool calls to retrieve
+     * @returns Map of tool call ID to pending tool call
+     */
+    getToolCallsById(toolCallIds: string[]): Map<string, PendingToolCall>;
+    /**
+     * Clears tracked tool calls for the given IDs.
+     * @param toolCallIds - IDs of tool calls to clear
+     */
+    clearToolCalls(toolCallIds: string[]): void;
+}
+//# sourceMappingURL=tool-call-tracker.d.ts.map

package/esm/v1/utils/tool-call-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-tracker.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/tool-call-tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,gBAAgB,CAAsC;IAC9D,OAAO,CAAC,gBAAgB,CAA6B;IAErD;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAyCnC;;;;OAIG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAWrE;;;OAGG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI;CAM5C"}

package/esm/v1/utils/tool-call-tracker.js

@@ -0,0 +1,86 @@
+/**
+ * Tool Call Tracker for v1 API
+ *
+ * Tracks tool calls during streaming, accumulating arguments until complete.
+ * Used by the send message hook to collect tool call state for execution.
+ */
+import { EventType } from "@ag-ui/core";
+/**
+ * Tracks tool calls during streaming, accumulating arguments until complete.
+ *
+ * Tool calls arrive as a sequence of events:
+ * 1. TOOL_CALL_START - initializes the tool call with name
+ * 2. TOOL_CALL_ARGS (multiple) - streams JSON argument fragments
+ * 3. TOOL_CALL_END - marks the tool call as complete, triggers JSON parsing
+ *
+ * This class accumulates these events and provides the complete tool call
+ * data when requested for execution.
+ */
+export class ToolCallTracker {
+    pendingToolCalls = new Map();
+    accumulatingArgs = new Map();
+    /**
+     * Handles a streaming event, tracking tool call state as needed.
+     * @param event - The streaming event to process
+     * @throws {Error} If JSON parsing fails on TOOL_CALL_END (fail-fast, no silent fallback)
+     */
+    handleEvent(event) {
+        switch (event.type) {
+            case EventType.TOOL_CALL_START:
+                this.pendingToolCalls.set(event.toolCallId, {
+                    name: event.toolCallName,
+                    input: {},
+                });
+                this.accumulatingArgs.set(event.toolCallId, "");
+                break;
+            case EventType.TOOL_CALL_ARGS: {
+                const current = this.accumulatingArgs.get(event.toolCallId);
+                this.accumulatingArgs.set(event.toolCallId, (current ?? "") + event.delta);
+                break;
+            }
+            case EventType.TOOL_CALL_END: {
+                const jsonStr = this.accumulatingArgs.get(event.toolCallId);
+                const toolCall = this.pendingToolCalls.get(event.toolCallId);
+                if (toolCall && jsonStr) {
+                    try {
+                        toolCall.input = JSON.parse(jsonStr);
+                    }
+                    catch (error) {
+                        // Fail-fast: don't silently continue with empty input
+                        throw new Error(`Failed to parse tool call arguments for ${event.toolCallId}: ${error instanceof Error ? error.message : "Unknown error"}. JSON: ${jsonStr.slice(0, 100)}${jsonStr.length > 100 ? "..." : ""}`);
+                    }
+                }
+                break;
+            }
+            default:
+                // Other event types are ignored - only tool call events are tracked
+                break;
+        }
+    }
+    /**
+     * Gets tool calls for the given IDs, filtered to only those that exist.
+     * @param toolCallIds - IDs of tool calls to retrieve
+     * @returns Map of tool call ID to pending tool call
+     */
+    getToolCallsById(toolCallIds) {
+        const result = new Map();
+        for (const id of toolCallIds) {
+            const toolCall = this.pendingToolCalls.get(id);
+            if (toolCall) {
+                result.set(id, toolCall);
+            }
+        }
+        return result;
+    }
+    /**
+     * Clears tracked tool calls for the given IDs.
+     * @param toolCallIds - IDs of tool calls to clear
+     */
+    clearToolCalls(toolCallIds) {
+        for (const id of toolCallIds) {
+            this.pendingToolCalls.delete(id);
+            this.accumulatingArgs.delete(id);
+        }
+    }
+}
+//# sourceMappingURL=tool-call-tracker.js.map

package/esm/v1/utils/tool-call-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-tracker.js","sourceRoot":"","sources":["../../../src/v1/utils/tool-call-tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAkB,MAAM,aAAa,CAAC;AAGxD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,eAAe;IAClB,gBAAgB,GAAG,IAAI,GAAG,EAA2B,CAAC;IACtD,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD;;;;OAIG;IACH,WAAW,CAAC,KAAgB;QAC1B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,SAAS,CAAC,eAAe;gBAC5B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE;oBAC1C,IAAI,EAAE,KAAK,CAAC,YAAY;oBACxB,KAAK,EAAE,EAAE;iBACV,CAAC,CAAC;gBACH,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBAChD,MAAM;YAER,KAAK,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;gBAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC5D,IAAI,CAAC,gBAAgB,CAAC,GAAG,CACvB,KAAK,CAAC,UAAU,EAChB,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAC9B,CAAC;gBACF,MAAM;YACR,CAAC;YAED,KAAK,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;gBAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC7D,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;oBACxB,IAAI,CAAC;wBACH,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;oBAClE,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,sDAAsD;wBACtD,MAAM,IAAI,KAAK,CACb,2CAA2C,KAAK,CAAC,UAAU,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,WAAW,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/L,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,CAAC;YAED;gBACE,oEAAoE;gBACpE,MAAM;QACV,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,WAAqB;QACpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;QAClD,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,WAAqB;QAClC,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF","sourcesContent":["/**\n * Tool Call Tracker for v1 API\n *\n * Tracks tool calls during streaming, accumulating arguments until complete.\n * Used by the send message hook to collect tool call state for execution.\n */\n\nimport { EventType, type AGUIEvent } from \"@ag-ui/core\";\nimport type { PendingToolCall } from \"./tool-executor\";\n\n/**\n * Tracks tool calls during streaming, accumulating arguments until complete.\n *\n * Tool calls arrive as a sequence of events:\n * 1. TOOL_CALL_START - initializes the tool call with name\n * 2. TOOL_CALL_ARGS (multiple) - streams JSON argument fragments\n * 3. TOOL_CALL_END - marks the tool call as complete, triggers JSON parsing\n *\n * This class accumulates these events and provides the complete tool call\n * data when requested for execution.\n */\nexport class ToolCallTracker {\n  private pendingToolCalls = new Map<string, PendingToolCall>();\n  private accumulatingArgs = new Map<string, string>();\n\n  /**\n   * Handles a streaming event, tracking tool call state as needed.\n   * @param event - The streaming event to process\n   * @throws {Error} If JSON parsing fails on TOOL_CALL_END (fail-fast, no silent fallback)\n   */\n  handleEvent(event: AGUIEvent): void {\n    switch (event.type) {\n      case EventType.TOOL_CALL_START:\n        this.pendingToolCalls.set(event.toolCallId, {\n          name: event.toolCallName,\n          input: {},\n        });\n        this.accumulatingArgs.set(event.toolCallId, \"\");\n        break;\n\n      case EventType.TOOL_CALL_ARGS: {\n        const current = this.accumulatingArgs.get(event.toolCallId);\n        this.accumulatingArgs.set(\n          event.toolCallId,\n          (current ?? \"\") + event.delta,\n        );\n        break;\n      }\n\n      case EventType.TOOL_CALL_END: {\n        const jsonStr = this.accumulatingArgs.get(event.toolCallId);\n        const toolCall = this.pendingToolCalls.get(event.toolCallId);\n        if (toolCall && jsonStr) {\n          try {\n            toolCall.input = JSON.parse(jsonStr) as Record<string, unknown>;\n          } catch (error) {\n            // Fail-fast: don't silently continue with empty input\n            throw new Error(\n              `Failed to parse tool call arguments for ${event.toolCallId}: ${error instanceof Error ? error.message : \"Unknown error\"}. JSON: ${jsonStr.slice(0, 100)}${jsonStr.length > 100 ? \"...\" : \"\"}`,\n            );\n          }\n        }\n        break;\n      }\n\n      default:\n        // Other event types are ignored - only tool call events are tracked\n        break;\n    }\n  }\n\n  /**\n   * Gets tool calls for the given IDs, filtered to only those that exist.\n   * @param toolCallIds - IDs of tool calls to retrieve\n   * @returns Map of tool call ID to pending tool call\n   */\n  getToolCallsById(toolCallIds: string[]): Map<string, PendingToolCall> {\n    const result = new Map<string, PendingToolCall>();\n    for (const id of toolCallIds) {\n      const toolCall = this.pendingToolCalls.get(id);\n      if (toolCall) {\n        result.set(id, toolCall);\n      }\n    }\n    return result;\n  }\n\n  /**\n   * Clears tracked tool calls for the given IDs.\n   * @param toolCallIds - IDs of tool calls to clear\n   */\n  clearToolCalls(toolCallIds: string[]): void {\n    for (const id of toolCallIds) {\n      this.pendingToolCalls.delete(id);\n      this.accumulatingArgs.delete(id);\n    }\n  }\n}\n"]}

package/esm/v1/utils/tool-executor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tool Executor for v1 API
+ *
+ * Handles automatic execution of client-side tools when the model
+ * requests them via `tambo.run.awaiting_input` events.
+ */
+import type { TamboTool } from "../../model/component-metadata";
+import type { ToolResultContent } from "@tambo-ai/typescript-sdk/resources/threads/threads";
+/**
+ * Pending tool call from the stream accumulator
+ */
+export interface PendingToolCall {
+    name: string;
+    input: Record<string, unknown>;
+}
+/**
+ * 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
+ */
+export declare function executeClientTool(tool: TamboTool, toolCallId: string, args: Record<string, unknown>): Promise<ToolResultContent>;
+/**
+ * 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
+ */
+export declare function executeAllPendingTools(toolCalls: Map<string, PendingToolCall>, registry: Map<string, TamboTool> | Record<string, TamboTool>): Promise<ToolResultContent[]>;
+//# sourceMappingURL=tool-executor.d.ts.map

package/esm/v1/utils/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../../src/v1/utils/tool-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,oDAAoD,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAgD5B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACvC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC3D,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgC9B"}

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

@@ -0,0 +1,99 @@
+/**
+ * Tool Executor for v1 API
+ *
+ * Handles automatic execution of client-side tools when the model
+ * requests them via `tambo.run.awaiting_input` events.
+ */
+/**
+ * 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
+ */
+export 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
+ */
+export 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/esm/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":"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","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/esm/v1/utils/tool-executor.test.d.ts

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

package/esm/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":""}