@tambo-ai/react 0.65.2 → 0.66.0

package/dist/util/registry.test.js

@@ -0,0 +1,204 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const v = __importStar(require("valibot"));
+const z3 = __importStar(require("zod/v3"));
+const z4 = __importStar(require("zod/v4"));
+const tools_1 = require("../testing/tools");
+const registry_1 = require("./registry");
+describe("getParametersFromToolSchema (via mapTamboToolToContextTool)", () => {
+    describe("Deprecated toolSchema interface (Zod function schemas)", () => {
+        it("should handle tool with toolSchema", () => {
+            const tool = (0, tools_1.createMockToolWithToolSchema)(z3.function().args(z3.string().describe("The name")).returns(z3.void()));
+            const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+            // Should have at least one parameter (either extracted or wrapped)
+            expect(result.parameters.length).toBeGreaterThanOrEqual(1);
+            expect(result.name).toBe("testTool");
+            expect(result.description).toBe("A test tool");
+        });
+        it("should handle toolSchema with multiple args", () => {
+            const tool = (0, tools_1.createMockToolWithToolSchema)(z3
+                .function()
+                .args(z3.string().describe("First name"), z3.number().describe("Age"), z3.boolean().describe("Is active"))
+                .returns(z3.void()));
+            const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+            // Should have parameters (extraction depends on JSON Schema conversion)
+            expect(result.parameters.length).toBeGreaterThanOrEqual(1);
+        });
+    });
+    describe("New inputSchema interface (object schemas)", () => {
+        describe("Zod 4 object schemas", () => {
+            it("should return single input param with object schema", () => {
+                const tool = (0, tools_1.createMockTool)({
+                    inputSchema: z4.object({
+                        name: z4.string().describe("User name"),
+                        age: z4.number().describe("User age"),
+                    }),
+                    outputSchema: z4.boolean(),
+                });
+                const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+                expect(result.parameters).toHaveLength(1);
+                expect(result.parameters[0].name).toBe("input");
+                expect(result.parameters[0].type).toBe("object");
+                expect(result.parameters).toMatchSnapshot();
+            });
+            it("should handle complex nested objects", () => {
+                const tool = (0, tools_1.createMockTool)({
+                    inputSchema: z4.object({
+                        point: z4.object({ x: z4.number(), y: z4.number() }),
+                        tags: z4.array(z4.string()),
+                        color: z4.enum(["red", "green", "blue"]),
+                    }),
+                    outputSchema: z4.void(),
+                });
+                const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+                expect(result.parameters).toHaveLength(1);
+                expect(result.parameters[0].name).toBe("input");
+                expect(result.parameters).toMatchSnapshot();
+            });
+        });
+        describe("Zod 3 object schemas", () => {
+            it("should return single input param with object schema", () => {
+                const tool = (0, tools_1.createMockTool)({
+                    inputSchema: z3.object({
+                        name: z3.string(),
+                        age: z3.number(),
+                    }),
+                    outputSchema: z3.boolean(),
+                });
+                const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+                expect(result.parameters).toHaveLength(1);
+                expect(result.parameters[0].name).toBe("input");
+                expect(result.parameters).toMatchSnapshot();
+            });
+        });
+        describe("Valibot object schemas", () => {
+            it("should return single input param with object schema", () => {
+                const tool = (0, tools_1.createMockTool)({
+                    inputSchema: v.object({
+                        name: v.string(),
+                        age: v.number(),
+                    }),
+                    outputSchema: v.boolean(),
+                });
+                const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+                expect(result.parameters).toHaveLength(1);
+                expect(result.parameters[0].name).toBe("input");
+                expect(result.parameters).toMatchSnapshot();
+            });
+            it("should handle complex nested objects", () => {
+                const tool = (0, tools_1.createMockTool)({
+                    inputSchema: v.object({
+                        point: v.pipe(v.object({ x: v.number(), y: v.number() }), v.description("Point")),
+                        tags: v.array(v.string()),
+                        color: v.picklist(["red", "green", "blue"]),
+                    }),
+                    outputSchema: v.undefined(),
+                });
+                const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+                expect(result.parameters).toHaveLength(1);
+                expect(result.parameters[0].name).toBe("input");
+                expect(result.parameters).toMatchSnapshot();
+            });
+        });
+        describe("JSON Schema object schemas", () => {
+            it("should return single input param with object schema", () => {
+                const schema = {
+                    type: "object",
+                    properties: {
+                        name: { type: "string" },
+                        age: { type: "number" },
+                    },
+                    required: ["name"],
+                    description: "User data",
+                };
+                const tool = (0, tools_1.createMockTool)({ inputSchema: schema, outputSchema: {} });
+                const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+                expect(result.parameters).toHaveLength(1);
+                expect(result.parameters[0].name).toBe("input");
+                expect(result.parameters[0].type).toBe("object");
+                expect(result.parameters[0].description).toBe("User data");
+                expect(result.parameters).toMatchSnapshot();
+            });
+        });
+    });
+    describe("Direct schema (shorthand for inputSchema)", () => {
+        it("should accept Zod 4 object schema directly", () => {
+            const tool = (0, tools_1.createMockTool)(z4.object({
+                name: z4.string(),
+                age: z4.number(),
+            }));
+            const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+            expect(result.parameters).toHaveLength(1);
+            expect(result.parameters[0].name).toBe("input");
+            expect(result.parameters).toMatchSnapshot();
+        });
+        it("should accept Zod 3 object schema directly", () => {
+            const tool = (0, tools_1.createMockTool)(z3.object({
+                name: z3.string(),
+                age: z3.number(),
+            }));
+            const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+            expect(result.parameters).toHaveLength(1);
+            expect(result.parameters[0].name).toBe("input");
+            expect(result.parameters).toMatchSnapshot();
+        });
+        it("should accept Valibot object schema directly", () => {
+            const tool = (0, tools_1.createMockTool)(v.object({
+                name: v.string(),
+                age: v.number(),
+            }));
+            const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+            expect(result.parameters).toHaveLength(1);
+            expect(result.parameters[0].name).toBe("input");
+            expect(result.parameters).toMatchSnapshot();
+        });
+        it("should accept JSON Schema object directly", () => {
+            const schema = {
+                type: "object",
+                properties: {
+                    name: { type: "string" },
+                    age: { type: "number" },
+                },
+            };
+            const tool = (0, tools_1.createMockTool)(schema);
+            const result = (0, registry_1.mapTamboToolToContextTool)(tool);
+            expect(result.parameters).toHaveLength(1);
+            expect(result.parameters[0].name).toBe("input");
+            expect(result.parameters).toMatchSnapshot();
+        });
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/util/registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.js","sourceRoot":"","sources":["../../src/util/registry.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tests for getParametersFromToolSchema via mapTamboToolToContextTool.\n *\n * These tests verify that tool schemas are correctly converted to parameter specifications:\n *\n * **New interface (inputSchema)**:\n * - inputSchema should be an object schema (Zod object, Valibot object, JSON Schema object)\n * - Returns a single \"input\" parameter representing the full object schema\n * - Tool function receives single object argument: tool({ name: \"...\", age: 30 })\n *\n * **Deprecated interface (toolSchema)**:\n * - toolSchema uses z.function().args(...) pattern\n * - Returns positional parameters: param1, param2, etc.\n * - Tool function receives spread arguments: tool(value1, value2)\n */\nimport type { JSONSchema7 } from \"json-schema\";\nimport * as v from \"valibot\";\nimport * as z3 from \"zod/v3\";\nimport * as z4 from \"zod/v4\";\nimport { createMockTool, createMockToolWithToolSchema } from \"../testing/tools\";\nimport { mapTamboToolToContextTool } from \"./registry\";\n\ndescribe(\"getParametersFromToolSchema (via mapTamboToolToContextTool)\", () => {\n  describe(\"Deprecated toolSchema interface (Zod function schemas)\", () => {\n    it(\"should handle tool with toolSchema\", () => {\n      const tool = createMockToolWithToolSchema(\n        z3.function().args(z3.string().describe(\"The name\")).returns(z3.void()),\n      );\n      const result = mapTamboToolToContextTool(tool);\n      // Should have at least one parameter (either extracted or wrapped)\n      expect(result.parameters.length).toBeGreaterThanOrEqual(1);\n      expect(result.name).toBe(\"testTool\");\n      expect(result.description).toBe(\"A test tool\");\n    });\n\n    it(\"should handle toolSchema with multiple args\", () => {\n      const tool = createMockToolWithToolSchema(\n        z3\n          .function()\n          .args(\n            z3.string().describe(\"First name\"),\n            z3.number().describe(\"Age\"),\n            z3.boolean().describe(\"Is active\"),\n          )\n          .returns(z3.void()),\n      );\n      const result = mapTamboToolToContextTool(tool);\n      // Should have parameters (extraction depends on JSON Schema conversion)\n      expect(result.parameters.length).toBeGreaterThanOrEqual(1);\n    });\n  });\n\n  describe(\"New inputSchema interface (object schemas)\", () => {\n    describe(\"Zod 4 object schemas\", () => {\n      it(\"should return single input param with object schema\", () => {\n        const tool = createMockTool({\n          inputSchema: z4.object({\n            name: z4.string().describe(\"User name\"),\n            age: z4.number().describe(\"User age\"),\n          }),\n          outputSchema: z4.boolean(),\n        });\n        const result = mapTamboToolToContextTool(tool);\n        expect(result.parameters).toHaveLength(1);\n        expect(result.parameters[0].name).toBe(\"input\");\n        expect(result.parameters[0].type).toBe(\"object\");\n        expect(result.parameters).toMatchSnapshot();\n      });\n\n      it(\"should handle complex nested objects\", () => {\n        const tool = createMockTool({\n          inputSchema: z4.object({\n            point: z4.object({ x: z4.number(), y: z4.number() }),\n            tags: z4.array(z4.string()),\n            color: z4.enum([\"red\", \"green\", \"blue\"]),\n          }),\n          outputSchema: z4.void(),\n        });\n        const result = mapTamboToolToContextTool(tool);\n        expect(result.parameters).toHaveLength(1);\n        expect(result.parameters[0].name).toBe(\"input\");\n        expect(result.parameters).toMatchSnapshot();\n      });\n    });\n\n    describe(\"Zod 3 object schemas\", () => {\n      it(\"should return single input param with object schema\", () => {\n        const tool = createMockTool({\n          inputSchema: z3.object({\n            name: z3.string(),\n            age: z3.number(),\n          }),\n          outputSchema: z3.boolean(),\n        });\n        const result = mapTamboToolToContextTool(tool);\n        expect(result.parameters).toHaveLength(1);\n        expect(result.parameters[0].name).toBe(\"input\");\n        expect(result.parameters).toMatchSnapshot();\n      });\n    });\n\n    describe(\"Valibot object schemas\", () => {\n      it(\"should return single input param with object schema\", () => {\n        const tool = createMockTool({\n          inputSchema: v.object({\n            name: v.string(),\n            age: v.number(),\n          }),\n          outputSchema: v.boolean(),\n        });\n        const result = mapTamboToolToContextTool(tool);\n        expect(result.parameters).toHaveLength(1);\n        expect(result.parameters[0].name).toBe(\"input\");\n        expect(result.parameters).toMatchSnapshot();\n      });\n\n      it(\"should handle complex nested objects\", () => {\n        const tool = createMockTool({\n          inputSchema: v.object({\n            point: v.pipe(\n              v.object({ x: v.number(), y: v.number() }),\n              v.description(\"Point\"),\n            ),\n            tags: v.array(v.string()),\n            color: v.picklist([\"red\", \"green\", \"blue\"]),\n          }),\n          outputSchema: v.undefined(),\n        });\n        const result = mapTamboToolToContextTool(tool);\n        expect(result.parameters).toHaveLength(1);\n        expect(result.parameters[0].name).toBe(\"input\");\n        expect(result.parameters).toMatchSnapshot();\n      });\n    });\n\n    describe(\"JSON Schema object schemas\", () => {\n      it(\"should return single input param with object schema\", () => {\n        const schema: JSONSchema7 = {\n          type: \"object\",\n          properties: {\n            name: { type: \"string\" },\n            age: { type: \"number\" },\n          },\n          required: [\"name\"],\n          description: \"User data\",\n        };\n        const tool = createMockTool({ inputSchema: schema, outputSchema: {} });\n        const result = mapTamboToolToContextTool(tool);\n        expect(result.parameters).toHaveLength(1);\n        expect(result.parameters[0].name).toBe(\"input\");\n        expect(result.parameters[0].type).toBe(\"object\");\n        expect(result.parameters[0].description).toBe(\"User data\");\n        expect(result.parameters).toMatchSnapshot();\n      });\n    });\n  });\n\n  describe(\"Direct schema (shorthand for inputSchema)\", () => {\n    it(\"should accept Zod 4 object schema directly\", () => {\n      const tool = createMockTool(\n        z4.object({\n          name: z4.string(),\n          age: z4.number(),\n        }),\n      );\n      const result = mapTamboToolToContextTool(tool);\n      expect(result.parameters).toHaveLength(1);\n      expect(result.parameters[0].name).toBe(\"input\");\n      expect(result.parameters).toMatchSnapshot();\n    });\n\n    it(\"should accept Zod 3 object schema directly\", () => {\n      const tool = createMockTool(\n        z3.object({\n          name: z3.string(),\n          age: z3.number(),\n        }),\n      );\n      const result = mapTamboToolToContextTool(tool);\n      expect(result.parameters).toHaveLength(1);\n      expect(result.parameters[0].name).toBe(\"input\");\n      expect(result.parameters).toMatchSnapshot();\n    });\n\n    it(\"should accept Valibot object schema directly\", () => {\n      const tool = createMockTool(\n        v.object({\n          name: v.string(),\n          age: v.number(),\n        }),\n      );\n      const result = mapTamboToolToContextTool(tool);\n      expect(result.parameters).toHaveLength(1);\n      expect(result.parameters[0].name).toBe(\"input\");\n      expect(result.parameters).toMatchSnapshot();\n    });\n\n    it(\"should accept JSON Schema object directly\", () => {\n      const schema: JSONSchema7 = {\n        type: \"object\",\n        properties: {\n          name: { type: \"string\" },\n          age: { type: \"number\" },\n        },\n      };\n      const tool = createMockTool(schema);\n      const result = mapTamboToolToContextTool(tool);\n      expect(result.parameters).toHaveLength(1);\n      expect(result.parameters[0].name).toBe(\"input\");\n      expect(result.parameters).toMatchSnapshot();\n    });\n  });\n});\n"]}

package/dist/util/resource-validators.d.ts

@@ -0,0 +1,16 @@
+import type { ListResourceItem, ResourceSource } from "../model/resource-info";
+/**
+ * Validates that a ResourceSource has both listResources and getResource defined,
+ * or neither defined. You cannot provide one without the other.
+ * @param listResources - The listResources function (or undefined)
+ * @param getResource - The getResource function (or undefined)
+ * @throws {Error} if only one of the functions is provided
+ */
+export declare function validateResourceSource(listResources: ResourceSource["listResources"] | undefined, getResource: ResourceSource["getResource"] | undefined): void;
+/**
+ * Validates that a resource has the required fields.
+ * @param resource - The resource to validate
+ * @throws {Error} if the resource is missing required fields
+ */
+export declare function validateResource(resource: ListResourceItem): void;
+//# sourceMappingURL=resource-validators.d.ts.map

package/dist/util/resource-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-validators.d.ts","sourceRoot":"","sources":["../../src/util/resource-validators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,cAAc,CAAC,eAAe,CAAC,GAAG,SAAS,EAC1D,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC,GAAG,SAAS,GACrD,IAAI,CAWN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAUjE"}

package/dist/util/resource-validators.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateResourceSource = validateResourceSource;
+exports.validateResource = validateResource;
+/**
+ * Validates that a ResourceSource has both listResources and getResource defined,
+ * or neither defined. You cannot provide one without the other.
+ * @param listResources - The listResources function (or undefined)
+ * @param getResource - The getResource function (or undefined)
+ * @throws {Error} if only one of the functions is provided
+ */
+function validateResourceSource(listResources, getResource) {
+    const hasListResources = listResources != null;
+    const hasGetResource = getResource != null;
+    if (hasListResources !== hasGetResource) {
+        throw new Error("Both listResources and getResource must be provided together, or neither should be provided. " +
+            `Got: listResources=${hasListResources ? "defined" : "undefined"}, ` +
+            `getResource=${hasGetResource ? "defined" : "undefined"}`);
+    }
+}
+/**
+ * Validates that a resource has the required fields.
+ * @param resource - The resource to validate
+ * @throws {Error} if the resource is missing required fields
+ */
+function validateResource(resource) {
+    if (!resource.uri) {
+        throw new Error("Resource must have a 'uri' field");
+    }
+    if (!resource.name) {
+        throw new Error(`Resource with URI '${resource.uri}' must have a 'name' field`);
+    }
+}
+//# sourceMappingURL=resource-validators.js.map

package/dist/util/resource-validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-validators.js","sourceRoot":"","sources":["../../src/util/resource-validators.ts"],"names":[],"mappings":";;AASA,wDAcC;AAOD,4CAUC;AAtCD;;;;;;GAMG;AACH,SAAgB,sBAAsB,CACpC,aAA0D,EAC1D,WAAsD;IAEtD,MAAM,gBAAgB,GAAG,aAAa,IAAI,IAAI,CAAC;IAC/C,MAAM,cAAc,GAAG,WAAW,IAAI,IAAI,CAAC;IAE3C,IAAI,gBAAgB,KAAK,cAAc,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,+FAA+F;YAC7F,sBAAsB,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,IAAI;YACpE,eAAe,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAC5D,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,QAA0B;IACzD,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,sBAAsB,QAAQ,CAAC,GAAG,4BAA4B,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import type { ListResourceItem, ResourceSource } from \"../model/resource-info\";\n\n/**\n * Validates that a ResourceSource has both listResources and getResource defined,\n * or neither defined. You cannot provide one without the other.\n * @param listResources - The listResources function (or undefined)\n * @param getResource - The getResource function (or undefined)\n * @throws {Error} if only one of the functions is provided\n */\nexport function validateResourceSource(\n  listResources: ResourceSource[\"listResources\"] | undefined,\n  getResource: ResourceSource[\"getResource\"] | undefined,\n): void {\n  const hasListResources = listResources != null;\n  const hasGetResource = getResource != null;\n\n  if (hasListResources !== hasGetResource) {\n    throw new Error(\n      \"Both listResources and getResource must be provided together, or neither should be provided. \" +\n        `Got: listResources=${hasListResources ? \"defined\" : \"undefined\"}, ` +\n        `getResource=${hasGetResource ? \"defined\" : \"undefined\"}`,\n    );\n  }\n}\n\n/**\n * Validates that a resource has the required fields.\n * @param resource - The resource to validate\n * @throws {Error} if the resource is missing required fields\n */\nexport function validateResource(resource: ListResourceItem): void {\n  if (!resource.uri) {\n    throw new Error(\"Resource must have a 'uri' field\");\n  }\n\n  if (!resource.name) {\n    throw new Error(\n      `Resource with URI '${resource.uri}' must have a 'name' field`,\n    );\n  }\n}\n"]}

package/dist/util/tool-caller.d.ts

@@ -1,5 +1,5 @@
 import TamboAI from "@tambo-ai/typescript-sdk";
-import { TamboTool, TamboToolRegistry } from "../model/component-metadata";
+import { TamboTool, TamboToolRegistry, TamboToolWithToolSchema } from "../model/component-metadata";
 /**
  * Process a message from the thread, invoking the appropriate tool and returning the result.
  * @param message - The message to handle
@@ -9,6 +9,6 @@ import { TamboTool, TamboToolRegistry } from "../model/component-metadata";
 export declare const handleToolCall: (message: TamboAI.Beta.Threads.ThreadMessage, toolRegistry: TamboToolRegistry, onCallUnregisteredTool?: (toolName: string, args: TamboAI.ToolCallParameter[]) => Promise<string>) => Promise<{
     result: unknown;
     error?: string;
-    tamboTool?: TamboTool;
+    tamboTool?: TamboTool | TamboToolWithToolSchema;
 }>;
 //# sourceMappingURL=tool-caller.d.ts.map

package/dist/util/tool-caller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-caller.d.ts","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAEL,SAAS,EACT,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAGrC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAC3C,cAAc,iBAAiB,EAC/B,yBAAyB,CACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,CAAC,iBAAiB,EAAE,KAC9B,OAAO,CAAC,MAAM,CAAC,KACnB,OAAO,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAmCA,CAAC"}
+{"version":3,"file":"tool-caller.d.ts","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAEL,SAAS,EACT,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AAIrC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAC3C,cAAc,iBAAiB,EAC/B,yBAAyB,CACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,CAAC,iBAAiB,EAAE,KAC9B,OAAO,CAAC,MAAM,CAAC,KACnB,OAAO,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,GAAG,uBAAuB,CAAC;CACjD,CAmCA,CAAC"}

package/dist/util/tool-caller.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleToolCall = void 0;
+const schema_1 = require("../schema");
 const registry_1 = require("./registry");
 /**
  * Process a message from the thread, invoking the appropriate tool and returning the result.
@@ -24,7 +25,7 @@ const handleToolCall = async (message, toolRegistry, onCallUnregisteredTool) =>
             throw new Error(`Tool ${message.toolCallRequest.toolName} not found in registry`);
         }
         return {
-            result: await runToolChoice(message.toolCallRequest, tool),
+            result: await runToolChoice(message.toolCallRequest, tool, tamboTool),
             tamboTool,
         };
     }
@@ -51,9 +52,16 @@ const findTool = (toolName, toolRegistry) => {
         tamboTool: registryTool,
     };
 };
-const runToolChoice = async (toolCallRequest, tool) => {
-    // Assumes parameters are in the order they are defined in the tool
-    const parameterValues = toolCallRequest.parameters?.map((param) => param.parameterValue) ?? [];
+const runToolChoice = async (toolCallRequest, tool, tamboTool) => {
+    const parameters = toolCallRequest.parameters ?? [];
+    // New interface (inputSchema): pass single object argument
+    if ((0, schema_1.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);
 };
 //# sourceMappingURL=tool-caller.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tool-caller.js","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":";;;AAMA,yCAAuD;AAEvD;;;;;GAKG;AACI,MAAM,cAAc,GAAG,KAAK,EACjC,OAA2C,EAC3C,YAA+B,EAC/B,sBAGoB,EAKnB,EAAE;IACH,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,CAClC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAChC,YAAY,CACb,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,sBAAsB,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAChC,OAAO,CAAC,eAAe,CAAC,UAAU,CACnC,CAAC;gBACF,OAAO;oBACL,MAAM;iBACP,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CACb,QAAQ,OAAO,CAAC,eAAe,CAAC,QAAQ,wBAAwB,CACjE,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,aAAa,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC;YAC1D,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,OAAO,CAAC,eAAe,CAAC,QAAQ,kCAAkC,KAAK,0EAA0E;YACzL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AA9CW,QAAA,cAAc,kBA8CzB;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,IAAA,oCAAyB,EAAC,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,EACZ,EAAE;IAChB,mEAAmE;IACnE,MAAM,eAAe,GACnB,eAAe,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAEzE,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} 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 message - 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  message: TamboAI.Beta.Threads.ThreadMessage,\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 (!message?.toolCallRequest?.toolName) {\n    throw new Error(\"Tool name is required\");\n  }\n\n  try {\n    const { tool, tamboTool } = findTool(\n      message.toolCallRequest.toolName,\n      toolRegistry,\n    );\n    if (!tool) {\n      if (onCallUnregisteredTool) {\n        const result = await onCallUnregisteredTool(\n          message.toolCallRequest.toolName,\n          message.toolCallRequest.parameters,\n        );\n        return {\n          result,\n        };\n      }\n      throw new Error(\n        `Tool ${message.toolCallRequest.toolName} not found in registry`,\n      );\n    }\n    return {\n      result: await runToolChoice(message.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 ${message.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<any> => {\n  // Assumes parameters are in the order they are defined in the tool\n  const parameterValues =\n    toolCallRequest.parameters?.map((param) => param.parameterValue) ?? [];\n\n  return await tool.getComponentContext(...parameterValues);\n};\n"]}
+{"version":3,"file":"tool-caller.js","sourceRoot":"","sources":["../../src/util/tool-caller.ts"],"names":[],"mappings":";;;AAOA,sCAA2C;AAC3C,yCAAuD;AAEvD;;;;;GAKG;AACI,MAAM,cAAc,GAAG,KAAK,EACjC,OAA2C,EAC3C,YAA+B,EAC/B,sBAGoB,EAKnB,EAAE;IACH,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,CAClC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAChC,YAAY,CACb,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,sBAAsB,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAChC,OAAO,CAAC,eAAe,CAAC,UAAU,CACnC,CAAC;gBACF,OAAO;oBACL,MAAM;iBACP,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CACb,QAAQ,OAAO,CAAC,eAAe,CAAC,QAAQ,wBAAwB,CACjE,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM,aAAa,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,EAAE,SAAS,CAAC;YACrE,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,OAAO,CAAC,eAAe,CAAC,QAAQ,kCAAkC,KAAK,0EAA0E;YACzL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AA9CW,QAAA,cAAc,kBA8CzB;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,IAAA,oCAAyB,EAAC,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,IAAA,uBAAc,EAAC,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 message - 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  message: TamboAI.Beta.Threads.ThreadMessage,\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 (!message?.toolCallRequest?.toolName) {\n    throw new Error(\"Tool name is required\");\n  }\n\n  try {\n    const { tool, tamboTool } = findTool(\n      message.toolCallRequest.toolName,\n      toolRegistry,\n    );\n    if (!tool) {\n      if (onCallUnregisteredTool) {\n        const result = await onCallUnregisteredTool(\n          message.toolCallRequest.toolName,\n          message.toolCallRequest.parameters,\n        );\n        return {\n          result,\n        };\n      }\n      throw new Error(\n        `Tool ${message.toolCallRequest.toolName} not found in registry`,\n      );\n    }\n    return {\n      result: await runToolChoice(message.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 ${message.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"]}

package/esm/context-helpers/context-helpers-provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers-provider.test.d.ts","sourceRoot":"","sources":["../../src/context-helpers/context-helpers-provider.test.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/esm/context-helpers/{__tests__/context-helpers-provider.test.js → context-helpers-provider.test.js}

@@ -13,8 +13,8 @@
  */
 import { act, renderHook } from "@testing-library/react";
 import React from "react";
-import { TamboContextHelpersProvider, useTamboContextHelpers, } from "../../providers/tambo-context-helpers-provider";
-import { currentPageContextHelper, currentTimeContextHelper, } from "../index";
+import { TamboContextHelpersProvider, useTamboContextHelpers, } from "../providers/tambo-context-helpers-provider";
+import { currentPageContextHelper, currentTimeContextHelper, } from "./index";
 /**
  * Test wrapper to provide the TamboContextHelpersProvider for hooks.
  * @param helpers - A dictionary of context helper functions.

package/esm/context-helpers/context-helpers-provider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers-provider.test.js","sourceRoot":"","sources":["../../src/context-helpers/context-helpers-provider.test.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tests for the Context Helpers API.\n *\n * The new API treats a context helper as a plain function that returns a value\n * to include in context, or null/undefined to skip. The provider wraps each\n * value with its key name as { name, context } before sending with messages.\n *\n * This test suite validates that:\n *  - Helper functions can return sync/async values.\n *  - Returning null/undefined causes the helper to be skipped.\n *  - Errors in helpers are caught and skipped.\n *  - The provider aggregates helpers passed in its props and returns AdditionalContext[].\n */\n\nimport { act, renderHook } from \"@testing-library/react\";\nimport React, { PropsWithChildren } from \"react\";\nimport {\n  TamboContextHelpersProvider,\n  useTamboContextHelpers,\n} from \"../providers/tambo-context-helpers-provider\";\nimport {\n  type AdditionalContext,\n  type ContextHelperFn,\n  currentPageContextHelper,\n  currentTimeContextHelper,\n} from \"./index\";\n\n/**\n * Test wrapper to provide the TamboContextHelpersProvider for hooks.\n * @param helpers - A dictionary of context helper functions.\n * @returns A wrapper component that provides the TamboContextHelpersProvider.\n */\nfunction wrapper(helpers?: Record<string, ContextHelperFn>) {\n  // eslint-disable-next-line react/display-name\n  return ({ children }: PropsWithChildren) =>\n    React.createElement(\n      TamboContextHelpersProvider,\n      {\n        contextHelpers: helpers,\n      },\n      children,\n    );\n}\n\ndescribe(\"Context Helpers API\", () => {\n  // Ensure the global registry doesn't leak state between tests\n  beforeEach(() => {\n    jest.clearAllMocks();\n  });\n\n  test(\"returns empty array when no helpers provided\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper(),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    expect(Array.isArray(contexts)).toBe(true);\n    expect(contexts).toHaveLength(0);\n  });\n\n  test(\"collects sync and async helper results\", async () => {\n    const syncHelper: ContextHelperFn = () => ({ a: 1 });\n    const asyncHelper: ContextHelperFn = async () => ({ b: 2 });\n\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper({\n        sync: syncHelper,\n        async: asyncHelper,\n      }),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n\n    // Validate shape and presence\n    const byName = new Map(contexts.map((c) => [c.name, c.context]));\n    expect(byName.get(\"sync\")).toEqual({ a: 1 });\n    expect(byName.get(\"async\")).toEqual({ b: 2 });\n  });\n\n  test(\"skips null and undefined results\", async () => {\n    const nullHelper: ContextHelperFn = () => null;\n    const undefinedHelper: ContextHelperFn = () => undefined;\n    const validHelper: ContextHelperFn = () => ({ ok: true });\n\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper({\n        nullHelper,\n        undefinedHelper,\n        validHelper,\n      }),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    const names = contexts.map((c) => c.name);\n\n    expect(names).toContain(\"validHelper\");\n    expect(names).not.toContain(\"nullHelper\");\n    expect(names).not.toContain(\"undefinedHelper\");\n  });\n\n  test(\"errors in helpers are caught and skipped\", async () => {\n    const consoleSpy = jest.spyOn(console, \"error\").mockImplementation(() => {\n      // silence expected error\n    });\n\n    const badHelper: ContextHelperFn = () => {\n      throw new Error(\"boom\");\n    };\n    const goodHelper: ContextHelperFn = () => ({ ok: 1 });\n\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper({ badHelper, goodHelper }),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n    expect(contexts).toHaveLength(1);\n    expect(contexts[0]).toEqual<AdditionalContext>({\n      name: \"goodHelper\",\n      context: { ok: 1 },\n    });\n\n    consoleSpy.mockRestore();\n  });\n\n  test(\"dynamic add/remove helpers works\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper(),\n    });\n\n    // Initially empty\n    expect(await result.current.getAdditionalContext()).toHaveLength(0);\n\n    // Add\n    act(() => {\n      result.current.addContextHelper(\"dyn\", () => ({ x: 10 }));\n    });\n\n    let contexts = await result.current.getAdditionalContext();\n    expect(contexts).toHaveLength(1);\n    expect(contexts[0]).toEqual<AdditionalContext>({\n      name: \"dyn\",\n      context: { x: 10 },\n    });\n\n    // Update\n    act(() => {\n      result.current.addContextHelper(\"dyn\", () => ({ x: 20 }));\n    });\n    contexts = await result.current.getAdditionalContext();\n    expect(contexts).toHaveLength(1);\n    expect(contexts[0]).toEqual<AdditionalContext>({\n      name: \"dyn\",\n      context: { x: 20 },\n    });\n\n    // Remove\n    act(() => {\n      result.current.removeContextHelper(\"dyn\");\n    });\n    contexts = await result.current.getAdditionalContext();\n    expect(contexts).toHaveLength(0);\n  });\n\n  test(\"prebuilt helpers can be passed directly\", async () => {\n    const { result } = renderHook(() => useTamboContextHelpers(), {\n      wrapper: wrapper({\n        userTime: currentTimeContextHelper,\n        userPage: currentPageContextHelper,\n      }),\n    });\n\n    const contexts = await result.current.getAdditionalContext();\n\n    // Should include both entries unless environment prevents userPage (SSR)\n    const names = contexts.map((c) => c.name);\n    expect(names).toContain(\"userTime\");\n    // userPage may be null on non-browser envs; allow either outcome:\n    // if present, ensure expected keys exist\n    if (names.includes(\"userPage\")) {\n      const userPage = contexts.find((c) => c.name === \"userPage\")!.context as {\n        url?: string;\n        title?: string;\n      };\n      expect(\n        typeof userPage.url === \"string\" || userPage.url === undefined,\n      ).toBe(true);\n      expect(\n        typeof userPage.title === \"string\" || userPage.title === undefined,\n      ).toBe(true);\n    }\n  });\n});\n"]}

package/esm/context-helpers/context-helpers.test.d.ts.map

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

package/esm/context-helpers/{__tests__/context-helpers.test.js → context-helpers.test.js}

@@ -1,4 +1,4 @@
-import { currentPageContextHelper, currentTimeContextHelper } from "../index";
+import { currentPageContextHelper, currentTimeContextHelper } from "./index";
 /**
  * Tests for prebuilt context helper functions.
  *

package/esm/context-helpers/context-helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers.test.js","sourceRoot":"","sources":["../../src/context-helpers/context-helpers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAE7E;;;;;GAKG;AACH,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAC;YAE3C,kCAAkC;YAClC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAE/B,+BAA+B;YAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YAC5C,MAAM,CAAC,OAAO,OAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEjD,iCAAiC;YACjC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,OAAQ,CAAC,SAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;YAClE,MAAM,OAAO,GAAG,wBAAwB,EAAE,CAAC;YAE3C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,sDAAsD;gBACtD,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC3B,OAAO;YACT,CAAC;YAED,wCAAwC;YACxC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAExC,MAAM,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { currentPageContextHelper, currentTimeContextHelper } from \"./index\";\n\n/**\n * Tests for prebuilt context helper functions.\n *\n * These helpers now return raw values (or null) instead of { name, context }.\n * The provider is responsible for wrapping values as { name, context }.\n */\ndescribe(\"Context Helpers (prebuilt functions)\", () => {\n  describe(\"currentTimeContextHelper\", () => {\n    it(\"should return user time context with required fields\", () => {\n      const context = currentTimeContextHelper();\n\n      // Should not be null (error case)\n      expect(context).not.toBeNull();\n\n      // Shape: { timestamp: string }\n      expect(context).toHaveProperty(\"timestamp\");\n      expect(typeof context!.timestamp).toBe(\"string\");\n\n      // Verify timestamp string parses\n      expect(() => new Date(context!.timestamp as string)).not.toThrow();\n    });\n  });\n\n  describe(\"currentPageContextHelper\", () => {\n    it(\"should return page context in browser, or null otherwise\", () => {\n      const context = currentPageContextHelper();\n\n      if (context === null) {\n        // Non-browser environments should return null to skip\n        expect(context).toBeNull();\n        return;\n      }\n\n      // Shape: { url: string, title: string }\n      expect(context).toHaveProperty(\"url\");\n      expect(context).toHaveProperty(\"title\");\n\n      expect(typeof context.url).toBe(\"string\");\n      expect(typeof context.title).toBe(\"string\");\n    });\n  });\n});\n"]}

package/{dist/providers → esm}/hoc/with-tambo-interactable.d.ts

@@ -1,9 +1,9 @@
 import React from "react";
-import { z } from "zod";
+import { SupportedSchema } from "../schema";
 export interface InteractableConfig {
     componentName: string;
     description: string;
-    propsSchema?: z.ZodTypeAny;
+    propsSchema?: SupportedSchema;
 }
 export interface WithTamboInteractableProps {
     interactableId?: string;

package/esm/hoc/with-tambo-interactable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-tambo-interactable.d.ts","sourceRoot":"","sources":["../../src/hoc/with-tambo-interactable.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAIxE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EACxC,MAAM,EAAE,kBAAkB,4CAgH3B"}

package/esm/{providers/hoc → hoc}/with-tambo-interactable.js

@@ -1,7 +1,8 @@
 // react-sdk/src/providers/with-interactable.tsx
 "use client";
 import React, { useCallback, useEffect, useRef, useState } from "react";
-import { useTamboInteractable } from "../tambo-interactable-provider";
+import { TamboMessageProvider } from "../hooks/use-current-message";
+import { useTamboInteractable } from "../providers/tambo-interactable-provider";
 /**
  * Higher-Order Component that makes any component interactable by tambo.
  * @param WrappedComponent - The component to make interactable
@@ -75,7 +76,33 @@ export function withTamboInteractable(WrappedComponent, config) {
             updateInteractableComponentProps,
             onPropsUpdate,
         ]);
-        return React.createElement(WrappedComponent, { ...effectiveProps });
+        // If the interactable ID is not yet set, render the component without provider
+        if (!interactableId) {
+            return React.createElement(WrappedComponent, { ...effectiveProps });
+        }
+        // Create a minimal message with interactable metadata
+        // This allows useTamboCurrentComponent to work with standalone interactable components
+        const minimalMessage = {
+            id: interactableId,
+            role: "assistant",
+            content: [],
+            threadId: "",
+            createdAt: new Date().toISOString(),
+            component: {
+                componentName: config.componentName,
+                componentState: {},
+                message: "",
+                props: effectiveProps,
+            },
+            componentState: {},
+        };
+        // Wrap with TamboMessageProvider including interactable metadata
+        return (React.createElement(TamboMessageProvider, { message: minimalMessage, interactableMetadata: {
+                id: interactableId,
+                componentName: config.componentName,
+                description: config.description,
+            } },
+            React.createElement(WrappedComponent, { ...effectiveProps })));
     };
     TamboInteractableWrapper.displayName = `withTamboInteractable(${displayName})`;
     return TamboInteractableWrapper;

package/esm/hoc/with-tambo-interactable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-tambo-interactable.js","sourceRoot":"","sources":["../../src/hoc/with-tambo-interactable.tsx"],"names":[],"mappings":"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","sourcesContent":["// react-sdk/src/providers/with-interactable.tsx\n\"use client\";\nimport React, { useCallback, useEffect, useRef, useState } from \"react\";\nimport { TamboMessageProvider } from \"../hooks/use-current-message\";\nimport { TamboThreadMessage } from \"../model/generate-component-response\";\nimport { useTamboInteractable } from \"../providers/tambo-interactable-provider\";\nimport { SupportedSchema } from \"../schema\";\n\nexport interface InteractableConfig {\n  componentName: string;\n  description: string;\n  propsSchema?: SupportedSchema;\n}\n\nexport interface WithTamboInteractableProps {\n  interactableId?: string;\n  onInteractableReady?: (id: string) => void;\n  onPropsUpdate?: (newProps: Record<string, any>) => void;\n}\n\n/**\n * Higher-Order Component that makes any component interactable by tambo.\n * @param WrappedComponent - The component to make interactable\n * @param config - Configuration for the interactable component\n * @returns A new component that is automatically registered as interactable\n * @example\n * ```tsx\n * const MyInteractableNote = withTamboInteractable(MyNote, {\n *   componentName: \"MyNote\",\n *   description: \"A note component\",\n *   propsSchema: z.object({\n *     title: z.string(),\n *     content: z.string(),\n *   }),\n * });\n *\n * // Usage\n * <MyInteractableNote title=\"My Note\" content=\"This is my note\" />\n * ```\n */\nexport function withTamboInteractable<P extends object>(\n  WrappedComponent: React.ComponentType<P>,\n  config: InteractableConfig,\n) {\n  const displayName =\n    WrappedComponent.displayName ?? WrappedComponent.name ?? \"Component\";\n\n  const TamboInteractableWrapper: React.FC<P & WithTamboInteractableProps> = (\n    props,\n  ) => {\n    const {\n      addInteractableComponent,\n      updateInteractableComponentProps,\n      getInteractableComponent,\n    } = useTamboInteractable();\n\n    const [interactableId, setInteractableId] = useState<string | null>(null);\n    const isInitialized = useRef(false);\n    const lastParentProps = useRef<Record<string, any>>({});\n\n    // Extract interactable-specific props\n    const { onInteractableReady, onPropsUpdate, ...componentProps } = props;\n\n    // Get the current interactable component to track prop updates\n    const currentInteractable = interactableId\n      ? getInteractableComponent(interactableId)\n      : null;\n\n    // Use the props from the interactable component if available, otherwise use the passed props\n    // We need to be careful not to create a loop, so we only use stored props if they're different from passed props\n    const effectiveProps = currentInteractable?.props ?? componentProps;\n\n    // Memoize the registration function\n    const registerComponent = useCallback(() => {\n      if (!isInitialized.current) {\n        const id = addInteractableComponent({\n          name: config.componentName,\n          description: config.description,\n          component: WrappedComponent,\n          props: componentProps,\n          propsSchema: config.propsSchema,\n        });\n\n        setInteractableId(id);\n        onInteractableReady?.(id);\n        isInitialized.current = true;\n      }\n    }, [addInteractableComponent, componentProps, onInteractableReady]);\n\n    // Register the component as interactable on mount (only once)\n    useEffect(() => {\n      registerComponent();\n    }, [registerComponent]);\n\n    // Update the interactable component when props change from parent\n    useEffect(() => {\n      if (interactableId && isInitialized.current) {\n        // Only update if the props are different from what we last sent\n        const lastPropsString = JSON.stringify(lastParentProps.current);\n        const currentPropsString = JSON.stringify(componentProps);\n\n        if (lastPropsString !== currentPropsString) {\n          updateInteractableComponentProps(interactableId, componentProps);\n          onPropsUpdate?.(componentProps);\n          lastParentProps.current = componentProps;\n        }\n      }\n    }, [\n      interactableId,\n      componentProps,\n      updateInteractableComponentProps,\n      onPropsUpdate,\n    ]);\n\n    // If the interactable ID is not yet set, render the component without provider\n    if (!interactableId) {\n      return <WrappedComponent {...(effectiveProps as P)} />;\n    }\n\n    // Create a minimal message with interactable metadata\n    // This allows useTamboCurrentComponent to work with standalone interactable components\n    const minimalMessage: TamboThreadMessage = {\n      id: interactableId,\n      role: \"assistant\" as const,\n      content: [],\n      threadId: \"\",\n      createdAt: new Date().toISOString(),\n      component: {\n        componentName: config.componentName,\n        componentState: {},\n        message: \"\",\n        props: effectiveProps,\n      },\n      componentState: {},\n    };\n\n    // Wrap with TamboMessageProvider including interactable metadata\n    return (\n      <TamboMessageProvider\n        message={minimalMessage}\n        interactableMetadata={{\n          id: interactableId,\n          componentName: config.componentName,\n          description: config.description,\n        }}\n      >\n        <WrappedComponent {...(effectiveProps as P)} />\n      </TamboMessageProvider>\n    );\n  };\n\n  TamboInteractableWrapper.displayName = `withTamboInteractable(${displayName})`;\n\n  return TamboInteractableWrapper;\n}\n"]}

package/esm/hoc/with-tambo-interactable.test.d.ts

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

package/esm/hoc/with-tambo-interactable.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-tambo-interactable.test.d.ts","sourceRoot":"","sources":["../../src/hoc/with-tambo-interactable.test.tsx"],"names":[],"mappings":""}