@tambo-ai/react 0.65.2 → 0.66.0

package/dist/util/registry-validators.test.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const v3_1 = require("zod/v3");
+const registry_validators_1 = require("./registry-validators");
+describe("validateTool", () => {
+    it("should validate tool with valid name", () => {
+        const tool = {
+            name: "valid-tool-name",
+            description: "A valid tool",
+            tool: () => "result",
+            toolSchema: v3_1.z.function().args().returns(v3_1.z.string()),
+        };
+        expect(() => (0, registry_validators_1.validateTool)(tool)).not.toThrow();
+    });
+    it("should throw when tool name contains invalid characters", () => {
+        const tool = {
+            name: "invalid tool name",
+            description: "A tool",
+            tool: () => "result",
+            toolSchema: v3_1.z.function().args().returns(v3_1.z.string()),
+        };
+        expect(() => (0, registry_validators_1.validateTool)(tool)).toThrow('tool "invalid tool name" must only contain letters, numbers, underscores, and hyphens.');
+    });
+    it("should throw when tool name contains special characters", () => {
+        const tool = {
+            name: "tool@name",
+            description: "A tool",
+            tool: () => "result",
+            toolSchema: v3_1.z.function().args().returns(v3_1.z.string()),
+        };
+        expect(() => (0, registry_validators_1.validateTool)(tool)).toThrow('tool "tool@name" must only contain letters, numbers, underscores, and hyphens.');
+    });
+    it("should validate tool with valid Zod schema", () => {
+        const tool = {
+            name: "valid-tool",
+            description: "A tool",
+            tool: () => "result",
+            toolSchema: v3_1.z.function().args().returns(v3_1.z.string()),
+        };
+        expect(() => (0, registry_validators_1.validateTool)(tool)).not.toThrow();
+    });
+    it("should throw when tool schema contains z.record()", () => {
+        const tool = {
+            name: "invalid-tool",
+            description: "A tool",
+            tool: () => "result",
+            toolSchema: v3_1.z
+                .function()
+                .args(v3_1.z.object({
+                metadata: v3_1.z.record(v3_1.z.string()),
+            }))
+                .returns(v3_1.z.string()),
+        };
+        expect(() => (0, registry_validators_1.validateTool)(tool)).toThrow('Record types (objects with dynamic keys) are not supported in toolSchema of tool "invalid-tool".');
+    });
+    it("should allow tool with JSON Schema (non-Zod)", () => {
+        const tool = {
+            name: "tool-with-json-schema",
+            description: "A tool",
+            tool: () => "result",
+            toolSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string" },
+                },
+            },
+        };
+        expect(() => (0, registry_validators_1.validateTool)(tool)).not.toThrow();
+    });
+    it("should validate tool with inputSchema (new interface)", () => {
+        const tool = {
+            name: "tool-with-input-schema",
+            description: "A tool with input schema",
+            tool: (input) => input.query,
+            inputSchema: v3_1.z.object({
+                query: v3_1.z.string(),
+            }),
+            outputSchema: v3_1.z.string(),
+        };
+        expect(() => (0, registry_validators_1.validateTool)(tool)).not.toThrow();
+    });
+});
+describe("validateAndPrepareComponent", () => {
+    it("should validate component with propsSchema", () => {
+        const component = {
+            name: "valid-component",
+            description: "A valid component",
+            component: () => null,
+            propsSchema: v3_1.z.object({
+                title: v3_1.z.string(),
+                count: v3_1.z.number(),
+            }),
+        };
+        const result = (0, registry_validators_1.validateAndPrepareComponent)(component);
+        expect(result.props).toBeDefined();
+        expect(result.props.type).toBe("object");
+        expect(result.props.properties).toBeDefined();
+    });
+    it("should validate component with propsDefinition", () => {
+        const component = {
+            name: "valid-component",
+            description: "A valid component",
+            component: () => null,
+            propsDefinition: {
+                type: "object",
+                properties: {
+                    title: { type: "string" },
+                },
+            },
+        };
+        const result = (0, registry_validators_1.validateAndPrepareComponent)(component);
+        expect(result.props).toEqual(component.propsDefinition);
+    });
+    it("should throw when component name contains invalid characters", () => {
+        const component = {
+            name: "invalid component name",
+            description: "A component",
+            component: () => null,
+            propsSchema: v3_1.z.object({}),
+        };
+        expect(() => (0, registry_validators_1.validateAndPrepareComponent)(component)).toThrow('component "invalid component name" must only contain letters, numbers, underscores, and hyphens.');
+    });
+    it("should throw when neither propsSchema nor propsDefinition is provided", () => {
+        const component = {
+            name: "component-without-props",
+            description: "A component",
+            component: () => null,
+        };
+        expect(() => (0, registry_validators_1.validateAndPrepareComponent)(component)).toThrow("Component component-without-props must have either propsSchema (recommended) or propsDefinition defined");
+    });
+    it("should throw when both propsSchema and propsDefinition are provided", () => {
+        const component = {
+            name: "component-with-both",
+            description: "A component",
+            component: () => null,
+            propsSchema: v3_1.z.object({}),
+            propsDefinition: {
+                type: "object",
+                properties: {},
+            },
+        };
+        expect(() => (0, registry_validators_1.validateAndPrepareComponent)(component)).toThrow("Component component-with-both cannot have both propsSchema and propsDefinition defined. Use only one. We recommend using propsSchema.");
+    });
+    it("should throw when propsSchema contains z.record()", () => {
+        const component = {
+            name: "component-with-record",
+            description: "A component",
+            component: () => null,
+            propsSchema: v3_1.z.object({
+                metadata: v3_1.z.record(v3_1.z.string()),
+            }),
+        };
+        expect(() => (0, registry_validators_1.validateAndPrepareComponent)(component)).toThrow('Record types (objects with dynamic keys) are not supported in propsSchema of component "component-with-record".');
+    });
+    it("should convert Zod schema to JSON Schema", () => {
+        const component = {
+            name: "component-with-zod",
+            description: "A component",
+            component: () => null,
+            propsSchema: v3_1.z.object({
+                title: v3_1.z.string().describe("The title"),
+                count: v3_1.z.number().int().min(0),
+                tags: v3_1.z.array(v3_1.z.string()),
+            }),
+        };
+        const result = (0, registry_validators_1.validateAndPrepareComponent)(component);
+        expect(result.props).toBeDefined();
+        expect(result.props.type).toBe("object");
+        expect(result.props.properties).toBeDefined();
+        expect(result.props.properties.title).toBeDefined();
+        expect(result.props.properties.count).toBeDefined();
+        expect(result.props.properties.tags).toBeDefined();
+    });
+    it("should handle complex Zod schema", () => {
+        const component = {
+            name: "component-complex",
+            description: "A component",
+            component: () => null,
+            propsSchema: v3_1.z.object({
+                user: v3_1.z.object({
+                    name: v3_1.z.string(),
+                    age: v3_1.z.number(),
+                }),
+                items: v3_1.z.array(v3_1.z.object({
+                    id: v3_1.z.string(),
+                    value: v3_1.z.number(),
+                })),
+            }),
+        };
+        const result = (0, registry_validators_1.validateAndPrepareComponent)(component);
+        expect(result.props).toBeDefined();
+        expect(result.props.type).toBe("object");
+    });
+    it("should allow JSON Schema (non-Zod) without validation", () => {
+        const component = {
+            name: "component-json-schema",
+            description: "A component",
+            component: () => null,
+            propsSchema: {
+                type: "object",
+                properties: {
+                    title: { type: "string" },
+                },
+            },
+        };
+        const result = (0, registry_validators_1.validateAndPrepareComponent)(component);
+        expect(result.props).toEqual(component.propsSchema);
+    });
+});
+describe("validateToolAssociation", () => {
+    it("should validate valid tool association", () => {
+        expect(() => (0, registry_validators_1.validateToolAssociation)("valid-component", "valid-tool", true, true)).not.toThrow();
+    });
+    it("should throw when component name is invalid", () => {
+        expect(() => (0, registry_validators_1.validateToolAssociation)("invalid component", "valid-tool", true, true)).toThrow('component "invalid component" must only contain letters, numbers, underscores, and hyphens.');
+    });
+    it("should throw when tool name is invalid", () => {
+        expect(() => (0, registry_validators_1.validateToolAssociation)("valid-component", "invalid tool", true, true)).toThrow('tool "invalid tool" must only contain letters, numbers, underscores, and hyphens.');
+    });
+    it("should throw when component does not exist", () => {
+        expect(() => (0, registry_validators_1.validateToolAssociation)("missing-component", "valid-tool", false, true)).toThrow("Component missing-component not found in registry");
+    });
+    it("should throw when tool does not exist", () => {
+        expect(() => (0, registry_validators_1.validateToolAssociation)("valid-component", "missing-tool", true, false)).toThrow("Tool missing-tool not found in registry");
+    });
+    it("should throw when both component and tool do not exist", () => {
+        expect(() => {
+            (0, registry_validators_1.validateToolAssociation)("missing-component", "missing-tool", false, false);
+        }).toThrow("Component missing-component not found in registry");
+    });
+    it("should validate with valid names containing underscores and hyphens", () => {
+        expect(() => (0, registry_validators_1.validateToolAssociation)("my_component-123", "my_tool-456", true, true)).not.toThrow();
+    });
+});
+//# sourceMappingURL=registry-validators.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry-validators.test.js","sourceRoot":"","sources":["../../src/util/registry-validators.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod/v3\";\nimport type {\n  TamboComponent,\n  TamboTool,\n  TamboToolWithToolSchema,\n} from \"../model/component-metadata\";\nimport {\n  validateAndPrepareComponent,\n  validateTool,\n  validateToolAssociation,\n} from \"./registry-validators\";\n\ndescribe(\"validateTool\", () => {\n  it(\"should validate tool with valid name\", () => {\n    const tool: TamboToolWithToolSchema = {\n      name: \"valid-tool-name\",\n      description: \"A valid tool\",\n      tool: () => \"result\",\n      toolSchema: z.function().args().returns(z.string()),\n    };\n\n    expect(() => validateTool(tool)).not.toThrow();\n  });\n\n  it(\"should throw when tool name contains invalid characters\", () => {\n    const tool: TamboToolWithToolSchema = {\n      name: \"invalid tool name\",\n      description: \"A tool\",\n      tool: () => \"result\",\n      toolSchema: z.function().args().returns(z.string()),\n    };\n\n    expect(() => validateTool(tool)).toThrow(\n      'tool \"invalid tool name\" must only contain letters, numbers, underscores, and hyphens.',\n    );\n  });\n\n  it(\"should throw when tool name contains special characters\", () => {\n    const tool: TamboToolWithToolSchema = {\n      name: \"tool@name\",\n      description: \"A tool\",\n      tool: () => \"result\",\n      toolSchema: z.function().args().returns(z.string()),\n    };\n\n    expect(() => validateTool(tool)).toThrow(\n      'tool \"tool@name\" must only contain letters, numbers, underscores, and hyphens.',\n    );\n  });\n\n  it(\"should validate tool with valid Zod schema\", () => {\n    const tool: TamboToolWithToolSchema = {\n      name: \"valid-tool\",\n      description: \"A tool\",\n      tool: () => \"result\",\n      toolSchema: z.function().args().returns(z.string()),\n    };\n\n    expect(() => validateTool(tool)).not.toThrow();\n  });\n\n  it(\"should throw when tool schema contains z.record()\", () => {\n    const tool: TamboToolWithToolSchema = {\n      name: \"invalid-tool\",\n      description: \"A tool\",\n      tool: () => \"result\",\n      toolSchema: z\n        .function()\n        .args(\n          z.object({\n            metadata: z.record(z.string()),\n          }),\n        )\n        .returns(z.string()),\n    };\n\n    expect(() => validateTool(tool)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in toolSchema of tool \"invalid-tool\".',\n    );\n  });\n\n  it(\"should allow tool with JSON Schema (non-Zod)\", () => {\n    const tool: TamboToolWithToolSchema = {\n      name: \"tool-with-json-schema\",\n      description: \"A tool\",\n      tool: () => \"result\",\n      toolSchema: {\n        type: \"object\",\n        properties: {\n          query: { type: \"string\" },\n        },\n      },\n    };\n\n    expect(() => validateTool(tool)).not.toThrow();\n  });\n\n  it(\"should validate tool with inputSchema (new interface)\", () => {\n    const tool: TamboTool = {\n      name: \"tool-with-input-schema\",\n      description: \"A tool with input schema\",\n      tool: (input: { query: string }) => input.query,\n      inputSchema: z.object({\n        query: z.string(),\n      }),\n      outputSchema: z.string(),\n    };\n\n    expect(() => validateTool(tool)).not.toThrow();\n  });\n});\n\ndescribe(\"validateAndPrepareComponent\", () => {\n  it(\"should validate component with propsSchema\", () => {\n    const component: TamboComponent = {\n      name: \"valid-component\",\n      description: \"A valid component\",\n      component: () => null,\n      propsSchema: z.object({\n        title: z.string(),\n        count: z.number(),\n      }),\n    };\n\n    const result = validateAndPrepareComponent(component);\n\n    expect(result.props).toBeDefined();\n    expect(result.props.type).toBe(\"object\");\n    expect(result.props.properties).toBeDefined();\n  });\n\n  it(\"should validate component with propsDefinition\", () => {\n    const component: TamboComponent = {\n      name: \"valid-component\",\n      description: \"A valid component\",\n      component: () => null,\n      propsDefinition: {\n        type: \"object\",\n        properties: {\n          title: { type: \"string\" },\n        },\n      },\n    };\n\n    const result = validateAndPrepareComponent(component);\n\n    expect(result.props).toEqual(component.propsDefinition);\n  });\n\n  it(\"should throw when component name contains invalid characters\", () => {\n    const component: TamboComponent = {\n      name: \"invalid component name\",\n      description: \"A component\",\n      component: () => null,\n      propsSchema: z.object({}),\n    };\n\n    expect(() => validateAndPrepareComponent(component)).toThrow(\n      'component \"invalid component name\" must only contain letters, numbers, underscores, and hyphens.',\n    );\n  });\n\n  it(\"should throw when neither propsSchema nor propsDefinition is provided\", () => {\n    const component: TamboComponent = {\n      name: \"component-without-props\",\n      description: \"A component\",\n      component: () => null,\n    };\n\n    expect(() => validateAndPrepareComponent(component)).toThrow(\n      \"Component component-without-props must have either propsSchema (recommended) or propsDefinition defined\",\n    );\n  });\n\n  it(\"should throw when both propsSchema and propsDefinition are provided\", () => {\n    const component: TamboComponent = {\n      name: \"component-with-both\",\n      description: \"A component\",\n      component: () => null,\n      propsSchema: z.object({}),\n      propsDefinition: {\n        type: \"object\",\n        properties: {},\n      },\n    };\n\n    expect(() => validateAndPrepareComponent(component)).toThrow(\n      \"Component component-with-both cannot have both propsSchema and propsDefinition defined. Use only one. We recommend using propsSchema.\",\n    );\n  });\n\n  it(\"should throw when propsSchema contains z.record()\", () => {\n    const component: TamboComponent = {\n      name: \"component-with-record\",\n      description: \"A component\",\n      component: () => null,\n      propsSchema: z.object({\n        metadata: z.record(z.string()),\n      }),\n    };\n\n    expect(() => validateAndPrepareComponent(component)).toThrow(\n      'Record types (objects with dynamic keys) are not supported in propsSchema of component \"component-with-record\".',\n    );\n  });\n\n  it(\"should convert Zod schema to JSON Schema\", () => {\n    const component: TamboComponent = {\n      name: \"component-with-zod\",\n      description: \"A component\",\n      component: () => null,\n      propsSchema: z.object({\n        title: z.string().describe(\"The title\"),\n        count: z.number().int().min(0),\n        tags: z.array(z.string()),\n      }),\n    };\n\n    const result = validateAndPrepareComponent(component);\n\n    expect(result.props).toBeDefined();\n    expect(result.props.type).toBe(\"object\");\n    expect((result.props as any).properties).toBeDefined();\n    expect((result.props as any).properties.title).toBeDefined();\n    expect((result.props as any).properties.count).toBeDefined();\n    expect((result.props as any).properties.tags).toBeDefined();\n  });\n\n  it(\"should handle complex Zod schema\", () => {\n    const component: TamboComponent = {\n      name: \"component-complex\",\n      description: \"A component\",\n      component: () => null,\n      propsSchema: z.object({\n        user: z.object({\n          name: z.string(),\n          age: z.number(),\n        }),\n        items: z.array(\n          z.object({\n            id: z.string(),\n            value: z.number(),\n          }),\n        ),\n      }),\n    };\n\n    const result = validateAndPrepareComponent(component);\n\n    expect(result.props).toBeDefined();\n    expect(result.props.type).toBe(\"object\");\n  });\n\n  it(\"should allow JSON Schema (non-Zod) without validation\", () => {\n    const component: TamboComponent = {\n      name: \"component-json-schema\",\n      description: \"A component\",\n      component: () => null,\n      propsSchema: {\n        type: \"object\",\n        properties: {\n          title: { type: \"string\" },\n        },\n      },\n    };\n\n    const result = validateAndPrepareComponent(component);\n\n    expect(result.props).toEqual(component.propsSchema);\n  });\n});\n\ndescribe(\"validateToolAssociation\", () => {\n  it(\"should validate valid tool association\", () => {\n    expect(() =>\n      validateToolAssociation(\"valid-component\", \"valid-tool\", true, true),\n    ).not.toThrow();\n  });\n\n  it(\"should throw when component name is invalid\", () => {\n    expect(() =>\n      validateToolAssociation(\"invalid component\", \"valid-tool\", true, true),\n    ).toThrow(\n      'component \"invalid component\" must only contain letters, numbers, underscores, and hyphens.',\n    );\n  });\n\n  it(\"should throw when tool name is invalid\", () => {\n    expect(() =>\n      validateToolAssociation(\"valid-component\", \"invalid tool\", true, true),\n    ).toThrow(\n      'tool \"invalid tool\" must only contain letters, numbers, underscores, and hyphens.',\n    );\n  });\n\n  it(\"should throw when component does not exist\", () => {\n    expect(() =>\n      validateToolAssociation(\"missing-component\", \"valid-tool\", false, true),\n    ).toThrow(\"Component missing-component not found in registry\");\n  });\n\n  it(\"should throw when tool does not exist\", () => {\n    expect(() =>\n      validateToolAssociation(\"valid-component\", \"missing-tool\", true, false),\n    ).toThrow(\"Tool missing-tool not found in registry\");\n  });\n\n  it(\"should throw when both component and tool do not exist\", () => {\n    expect(() => {\n      validateToolAssociation(\n        \"missing-component\",\n        \"missing-tool\",\n        false,\n        false,\n      );\n    }).toThrow(\"Component missing-component not found in registry\");\n  });\n\n  it(\"should validate with valid names containing underscores and hyphens\", () => {\n    expect(() =>\n      validateToolAssociation(\"my_component-123\", \"my_tool-456\", true, true),\n    ).not.toThrow();\n  });\n});\n"]}

package/dist/util/registry.d.ts

@@ -1,5 +1,5 @@
 import TamboAI from "@tambo-ai/typescript-sdk";
-import { ComponentContextToolMetadata, ComponentRegistry, RegisteredComponent, TamboTool, TamboToolAssociations, TamboToolRegistry } from "../model/component-metadata";
+import { ComponentContextToolMetadata, ComponentRegistry, DefineToolFn, RegisteredComponent, TamboTool, TamboToolAssociations, TamboToolRegistry, TamboToolWithToolSchema } from "../model/component-metadata";
 /**
  * Get all the available components from the component registry
  * @param componentRegistry - The component registry
@@ -14,13 +14,19 @@ export declare const getAvailableComponents: (componentRegistry: ComponentRegist
  * @param toolAssociations - The tool associations
  * @returns The tools that are not associated with any component
  */
-export declare const getUnassociatedTools: (toolRegistry: TamboToolRegistry, toolAssociations: TamboToolAssociations) => TamboTool[];
+export declare const getUnassociatedTools: (toolRegistry: TamboToolRegistry, toolAssociations: TamboToolAssociations) => (TamboTool | TamboToolWithToolSchema)[];
 /**
- * Helper function to convert component props from Zod schema to JSON Schema
+ * Helper function to convert component props from Standard Schema or JSON Schema
  * @param component - The component to convert
- * @returns The converted props
+ * @returns The converted props as JSON Schema
  */
-export declare const convertPropsToJsonSchema: (component: RegisteredComponent) => any;
+export declare const convertPropsToJsonSchema: (component: RegisteredComponent) => unknown;
+/**
+ * Adapt a Tambo tool defined with function schema to a standard Tambo tool
+ * @param tool - The Tambo tool with function schema
+ * @returns The adapted Tambo tool
+ */
+export declare function adaptToolFromFnSchema(tool: TamboTool | TamboToolWithToolSchema): TamboTool;
 /**
  * Get a component by name from the component registry
  * @param componentName - The name of the component to get
@@ -30,8 +36,30 @@ export declare const convertPropsToJsonSchema: (component: RegisteredComponent)
 export declare const getComponentFromRegistry: (componentName: string, componentRegistry: ComponentRegistry) => RegisteredComponent;
 /**
  * Map a Tambo tool to a context tool
- * @param tool - The tool to map
+ * @param tool - The tool to map (supports both new inputSchema and deprecated toolSchema interfaces)
  * @returns The context tool
  */
-export declare const mapTamboToolToContextTool: (tool: TamboTool) => ComponentContextToolMetadata;
+export declare const mapTamboToolToContextTool: (tool: TamboTool | TamboToolWithToolSchema) => ComponentContextToolMetadata;
+/**
+ * Provides type safety for defining a Tambo Tool.
+ *
+ * Tambo uses the [standard-schema.dev](https://standard-schema.dev) spec which means you can use any Standard Schema
+ * compliant validator (Zod, Valibot, ArkType, etc.). This ensures the tool function args and output types are correctly
+ * inferred from the provided schemas.
+ * @example
+ * ```typescript
+ * import { z } from "zod/v4";
+ *
+ * const myTool = defineTamboTool({
+ *   inputSchema: z.tuple([z.string()]),
+ *   outputSchema: z.number(),
+ *   tool: yourToolFunction,
+ *   // ^-- (input: [string]) => number | Promise<number>
+ *   // Types are inferred from and must match inputSchema/outputSchema definitions
+ * });
+ * ```
+ * @param tool The tool definition to register
+ * @returns The registered tool definition
+ */
+export declare const defineTool: DefineToolFn;
 //# sourceMappingURL=registry.d.ts.map

package/dist/util/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/util/registry.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAG/C,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EAGjB,mBAAmB,EACnB,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,mBAAmB,iBAAiB,EACpC,cAAc,iBAAiB,EAC/B,kBAAkB,qBAAqB,KACtC,OAAO,CAAC,kBAAkB,EAuB5B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,iBAAiB,EAC/B,kBAAkB,qBAAqB,KACtC,SAAS,EAKX,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,WAAW,mBAAmB,KAC7B,GAYF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,eAAe,MAAM,EACrB,mBAAmB,iBAAiB,KACnC,mBAUF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,SAAS,KACd,4BAQF,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/util/registry.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EACL,4BAA4B,EAC5B,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,6BAA6B,CAAC;AASrC;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,mBAAmB,iBAAiB,EACpC,cAAc,iBAAiB,EAC/B,kBAAkB,qBAAqB,KACtC,OAAO,CAAC,kBAAkB,EAuB5B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,iBAAiB,EAC/B,kBAAkB,qBAAqB,KACtC,CAAC,SAAS,GAAG,uBAAuB,CAAC,EAKvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,WAAW,mBAAmB,KAC7B,OAYF,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,GAAG,uBAAuB,GACxC,SAAS,CAYX;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,eAAe,MAAM,EACrB,mBAAmB,iBAAiB,KACnC,mBAUF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GACpC,MAAM,SAAS,GAAG,uBAAuB,KACxC,4BAQF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,UAAU,EAAE,YAExB,CAAC"}

package/dist/util/registry.js

@@ -1,10 +1,8 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapTamboToolToContextTool = exports.getComponentFromRegistry = exports.convertPropsToJsonSchema = exports.getUnassociatedTools = exports.getAvailableComponents = void 0;
-const zod_to_json_schema_1 = __importDefault(require("zod-to-json-schema"));
+exports.defineTool = exports.mapTamboToolToContextTool = exports.getComponentFromRegistry = exports.convertPropsToJsonSchema = exports.getUnassociatedTools = exports.getAvailableComponents = void 0;
+exports.adaptToolFromFnSchema = adaptToolFromFnSchema;
+const schema_1 = require("../schema");
 /**
  * Get all the available components from the component registry
  * @param componentRegistry - The component registry
@@ -16,14 +14,14 @@ const getAvailableComponents = (componentRegistry, toolRegistry, toolAssociation
     const availableComponents = [];
     for (const [name, componentEntry] of Object.entries(componentRegistry)) {
         const associatedToolNames = toolAssociations[name] || [];
-        const contextTools = [
-            ...associatedToolNames.map((toolName) => {
-                const tool = toolRegistry[toolName];
-                if (!tool)
-                    return null;
-                return (0, exports.mapTamboToolToContextTool)(tool);
-            }),
-        ].filter((tool) => tool !== null);
+        const contextTools = associatedToolNames
+            .map((toolName) => {
+            const tool = toolRegistry[toolName];
+            if (!tool)
+                return null;
+            return (0, exports.mapTamboToolToContextTool)(tool);
+        })
+            .filter((tool) => tool !== null);
         availableComponents.push({
             name: componentEntry.name,
             description: componentEntry.description,
@@ -48,22 +46,39 @@ const getUnassociatedTools = (toolRegistry, toolAssociations) => {
 };
 exports.getUnassociatedTools = getUnassociatedTools;
 /**
- * Helper function to convert component props from Zod schema to JSON Schema
+ * Helper function to convert component props from Standard Schema or JSON Schema
  * @param component - The component to convert
- * @returns The converted props
+ * @returns The converted props as JSON Schema
  */
 const convertPropsToJsonSchema = (component) => {
     if (!component.props) {
         return component.props;
     }
-    // Check if props is a Zod schema (we can't directly check the type, so we check for _def)
-    if (component.props._def && typeof component.props.parse === "function") {
-        // Use two-step type assertion for safety
-        return (0, zod_to_json_schema_1.default)(component.props);
+    // Check if props is a Standard Schema (Zod, Valibot, ArkType, etc.)
+    if ((0, schema_1.isStandardSchema)(component.props)) {
+        return (0, schema_1.schemaToJsonSchema)(component.props);
     }
+    // Already JSON Schema or unknown format - return as-is
     return component.props;
 };
 exports.convertPropsToJsonSchema = convertPropsToJsonSchema;
+/**
+ * Adapt a Tambo tool defined with function schema to a standard Tambo tool
+ * @param tool - The Tambo tool with function schema
+ * @returns The adapted Tambo tool
+ */
+function adaptToolFromFnSchema(tool) {
+    if (!("toolSchema" in tool)) {
+        return tool;
+    }
+    return {
+        name: tool.name,
+        description: tool.description,
+        tool: tool.tool,
+        inputSchema: (0, schema_1.getZodFunctionArgs)(tool.toolSchema),
+        outputSchema: (0, schema_1.getZodFunctionReturns)(tool.toolSchema),
+    };
+}
 /**
  * Get a component by name from the component registry
  * @param componentName - The name of the component to get
@@ -80,11 +95,11 @@ const getComponentFromRegistry = (componentName, componentRegistry) => {
 exports.getComponentFromRegistry = getComponentFromRegistry;
 /**
  * Map a Tambo tool to a context tool
- * @param tool - The tool to map
+ * @param tool - The tool to map (supports both new inputSchema and deprecated toolSchema interfaces)
  * @returns The context tool
  */
 const mapTamboToolToContextTool = (tool) => {
-    const parameters = getParametersFromZodFunction(tool.toolSchema);
+    const parameters = (0, schema_1.getParametersFromToolSchema)(tool);
     return {
         name: tool.name,
         description: tool.description,
@@ -92,61 +107,29 @@ const mapTamboToolToContextTool = (tool) => {
     };
 };
 exports.mapTamboToolToContextTool = mapTamboToolToContextTool;
-function isJsonSchema(schema) {
-    return (typeof schema === "object" &&
-        schema !== null &&
-        "type" in schema &&
-        typeof schema.type === "string" &&
-        schema.type === "object");
-}
-const getParametersFromZodFunction = (schema) => {
-    if (isJsonSchema(schema)) {
-        return [
-            {
-                name: "args",
-                type: "object",
-                description: schema.description ?? "",
-                isRequired: true,
-                schema: schema,
-            },
-        ];
-    }
-    const parameters = schema.parameters();
-    return parameters.items.map((param, index) => {
-        const name = `param${index + 1}`;
-        const type = getZodBaseType(param);
-        const description = param.description ?? "";
-        const isRequired = !param.isOptional();
-        const schema = (0, zod_to_json_schema_1.default)(param);
-        return {
-            name,
-            type,
-            description,
-            isRequired,
-            schema,
-        };
-    });
-};
-const getZodBaseType = (schema) => {
-    const typeName = schema._def.typeName;
-    switch (typeName) {
-        case "ZodString":
-            return "string";
-        case "ZodNumber":
-            return "number";
-        case "ZodBoolean":
-            return "boolean";
-        case "ZodArray":
-            return "array";
-        case "ZodEnum":
-            return "enum";
-        case "ZodDate":
-            return "date";
-        case "ZodObject":
-            return "object";
-        default:
-            console.warn("falling back to string for", typeName);
-            return "string";
-    }
+/**
+ * Provides type safety for defining a Tambo Tool.
+ *
+ * Tambo uses the [standard-schema.dev](https://standard-schema.dev) spec which means you can use any Standard Schema
+ * compliant validator (Zod, Valibot, ArkType, etc.). This ensures the tool function args and output types are correctly
+ * inferred from the provided schemas.
+ * @example
+ * ```typescript
+ * import { z } from "zod/v4";
+ *
+ * const myTool = defineTamboTool({
+ *   inputSchema: z.tuple([z.string()]),
+ *   outputSchema: z.number(),
+ *   tool: yourToolFunction,
+ *   // ^-- (input: [string]) => number | Promise<number>
+ *   // Types are inferred from and must match inputSchema/outputSchema definitions
+ * });
+ * ```
+ * @param tool The tool definition to register
+ * @returns The registered tool definition
+ */
+const defineTool = (tool) => {
+    return tool;
 };
+exports.defineTool = defineTool;
 //# sourceMappingURL=registry.js.map

package/dist/util/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/util/registry.ts"],"names":[],"mappings":";;;;;;AAEA,4EAAiD;AAYjD;;;;;;GAMG;AACI,MAAM,sBAAsB,GAAG,CACpC,iBAAoC,EACpC,YAA+B,EAC/B,gBAAuC,EACT,EAAE;IAChC,MAAM,mBAAmB,GAAiC,EAAE,CAAC;IAE7D,KAAK,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACvE,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAEzD,MAAM,YAAY,GAAG;YACnB,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACtC,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACpC,IAAI,CAAC,IAAI;oBAAE,OAAO,IAAI,CAAC;gBACvB,OAAO,IAAA,iCAAyB,EAAC,IAAI,CAAC,CAAC;YACzC,CAAC,CAAC;SACH,CAAC,MAAM,CAAC,CAAC,IAAI,EAAwC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAExE,mBAAmB,CAAC,IAAI,CAAC;YACvB,IAAI,EAAE,cAAc,CAAC,IAAI;YACzB,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,KAAK,EAAE,cAAc,CAAC,KAAK;YAC3B,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED,OAAO,mBAAmB,CAAC;AAC7B,CAAC,CAAC;AA3BW,QAAA,sBAAsB,0BA2BjC;AAEF;;;;;GAKG;AACI,MAAM,oBAAoB,GAAG,CAClC,YAA+B,EAC/B,gBAAuC,EAC1B,EAAE;IACf,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACjD,yEAAyE;QACzE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AARW,QAAA,oBAAoB,wBAQ/B;AAEF;;;;GAIG;AACI,MAAM,wBAAwB,GAAG,CACtC,SAA8B,EACzB,EAAE;IACP,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC,KAAK,CAAC;IACzB,CAAC;IAED,0FAA0F;IAC1F,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACxE,yCAAyC;QACzC,OAAO,IAAA,4BAAe,EAAC,SAAS,CAAC,KAAgC,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,SAAS,CAAC,KAAK,CAAC;AACzB,CAAC,CAAC;AAdW,QAAA,wBAAwB,4BAcnC;AAEF;;;;;GAKG;AACI,MAAM,wBAAwB,GAAG,CACtC,aAAqB,EACrB,iBAAoC,EACf,EAAE;IACvB,MAAM,cAAc,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAExD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,gCAAgC,aAAa,yBAAyB,CACvE,CAAC;IACJ,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC,CAAC;AAbW,QAAA,wBAAwB,4BAanC;AAEF;;;;GAIG;AACI,MAAM,yBAAyB,GAAG,CACvC,IAAe,EACe,EAAE;IAChC,MAAM,UAAU,GAAG,4BAA4B,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEjE,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU;KACX,CAAC;AACJ,CAAC,CAAC;AAVW,QAAA,yBAAyB,6BAUpC;AAEF,SAAS,YAAY,CACnB,MAAe;IAEf,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,MAAM,IAAI,MAAM;QAChB,OAAQ,MAA4B,CAAC,IAAI,KAAK,QAAQ;QACrD,MAA2B,CAAC,IAAI,KAAK,QAAQ,CAC/C,CAAC;AACJ,CAAC;AAED,MAAM,4BAA4B,GAAG,CACnC,MAAgD,EAC/B,EAAE;IACnB,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;gBACrC,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,MAAM;aACf;SACF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAe,MAAM,CAAC,UAAU,EAAE,CAAC;IACnD,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAiB,EAAE;QAC1D,MAAM,IAAI,GAAG,QAAQ,KAAK,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,IAAA,4BAAe,EAAC,KAAK,CAAC,CAAC;QAEtC,OAAO;YACL,IAAI;YACJ,IAAI;YACJ,WAAW;YACX,UAAU;YACV,MAAM;SACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,MAAoB,EAAU,EAAE;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;IACtC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW;YACd,OAAO,QAAQ,CAAC;QAClB,KAAK,YAAY;YACf,OAAO,SAAS,CAAC;QACnB,KAAK,UAAU;YACb,OAAO,OAAO,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,WAAW;YACd,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAC;YACrD,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC,CAAC","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport { z } from \"zod\";\nimport zodToJsonSchema from \"zod-to-json-schema\";\nimport {\n  ComponentContextToolMetadata,\n  ComponentRegistry,\n  JSONSchemaLite,\n  ParameterSpec,\n  RegisteredComponent,\n  TamboTool,\n  TamboToolAssociations,\n  TamboToolRegistry,\n} from \"../model/component-metadata\";\n\n/**\n * Get all the available components from the component registry\n * @param componentRegistry - The component registry\n * @param toolRegistry - The tool registry\n * @param toolAssociations - The tool associations\n * @returns The available components\n */\nexport const getAvailableComponents = (\n  componentRegistry: ComponentRegistry,\n  toolRegistry: TamboToolRegistry,\n  toolAssociations: TamboToolAssociations,\n): TamboAI.AvailableComponent[] => {\n  const availableComponents: TamboAI.AvailableComponent[] = [];\n\n  for (const [name, componentEntry] of Object.entries(componentRegistry)) {\n    const associatedToolNames = toolAssociations[name] || [];\n\n    const contextTools = [\n      ...associatedToolNames.map((toolName) => {\n        const tool = toolRegistry[toolName];\n        if (!tool) return null;\n        return mapTamboToolToContextTool(tool);\n      }),\n    ].filter((tool): tool is ComponentContextToolMetadata => tool !== null);\n\n    availableComponents.push({\n      name: componentEntry.name,\n      description: componentEntry.description,\n      props: componentEntry.props,\n      contextTools,\n    });\n  }\n\n  return availableComponents;\n};\n\n/**\n * Get tools from tool registry that are not associated with any component\n * @param toolRegistry - The tool registry\n * @param toolAssociations - The tool associations\n * @returns The tools that are not associated with any component\n */\nexport const getUnassociatedTools = (\n  toolRegistry: TamboToolRegistry,\n  toolAssociations: TamboToolAssociations,\n): TamboTool[] => {\n  return Object.values(toolRegistry).filter((tool) => {\n    // Check if the tool's name appears in any of the tool association arrays\n    return !Object.values(toolAssociations).flat().includes(tool.name);\n  });\n};\n\n/**\n * Helper function to convert component props from Zod schema to JSON Schema\n * @param component - The component to convert\n * @returns The converted props\n */\nexport const convertPropsToJsonSchema = (\n  component: RegisteredComponent,\n): any => {\n  if (!component.props) {\n    return component.props;\n  }\n\n  // Check if props is a Zod schema (we can't directly check the type, so we check for _def)\n  if (component.props._def && typeof component.props.parse === \"function\") {\n    // Use two-step type assertion for safety\n    return zodToJsonSchema(component.props as unknown as z.ZodTypeAny);\n  }\n\n  return component.props;\n};\n\n/**\n * Get a component by name from the component registry\n * @param componentName - The name of the component to get\n * @param componentRegistry - The component registry\n * @returns The component registration information\n */\nexport const getComponentFromRegistry = (\n  componentName: string,\n  componentRegistry: ComponentRegistry,\n): RegisteredComponent => {\n  const componentEntry = componentRegistry[componentName];\n\n  if (!componentEntry) {\n    throw new Error(\n      `Tambo tried to use Component ${componentName}, but it was not found.`,\n    );\n  }\n\n  return componentEntry;\n};\n\n/**\n * Map a Tambo tool to a context tool\n * @param tool - The tool to map\n * @returns The context tool\n */\nexport const mapTamboToolToContextTool = (\n  tool: TamboTool,\n): ComponentContextToolMetadata => {\n  const parameters = getParametersFromZodFunction(tool.toolSchema);\n\n  return {\n    name: tool.name,\n    description: tool.description,\n    parameters,\n  };\n};\n\nfunction isJsonSchema(\n  schema: unknown,\n): schema is ReturnType<typeof zodToJsonSchema> {\n  return (\n    typeof schema === \"object\" &&\n    schema !== null &&\n    \"type\" in schema &&\n    typeof (schema as { type: unknown }).type === \"string\" &&\n    (schema as { type: string }).type === \"object\"\n  );\n}\n\nconst getParametersFromZodFunction = (\n  schema: z.ZodFunction<any, any> | JSONSchemaLite,\n): ParameterSpec[] => {\n  if (isJsonSchema(schema)) {\n    return [\n      {\n        name: \"args\",\n        type: \"object\",\n        description: schema.description ?? \"\",\n        isRequired: true,\n        schema: schema,\n      },\n    ];\n  }\n\n  const parameters: z.ZodTuple = schema.parameters();\n  return parameters.items.map((param, index): ParameterSpec => {\n    const name = `param${index + 1}`;\n    const type = getZodBaseType(param);\n    const description = param.description ?? \"\";\n    const isRequired = !param.isOptional();\n    const schema = zodToJsonSchema(param);\n\n    return {\n      name,\n      type,\n      description,\n      isRequired,\n      schema,\n    };\n  });\n};\n\nconst getZodBaseType = (schema: z.ZodTypeAny): string => {\n  const typeName = schema._def.typeName;\n  switch (typeName) {\n    case \"ZodString\":\n      return \"string\";\n    case \"ZodNumber\":\n      return \"number\";\n    case \"ZodBoolean\":\n      return \"boolean\";\n    case \"ZodArray\":\n      return \"array\";\n    case \"ZodEnum\":\n      return \"enum\";\n    case \"ZodDate\":\n      return \"date\";\n    case \"ZodObject\":\n      return \"object\";\n    default:\n      console.warn(\"falling back to string for\", typeName);\n      return \"string\";\n  }\n};\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/util/registry.ts"],"names":[],"mappings":"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","sourcesContent":["import TamboAI from \"@tambo-ai/typescript-sdk\";\nimport {\n  ComponentContextToolMetadata,\n  ComponentRegistry,\n  DefineToolFn,\n  RegisteredComponent,\n  TamboTool,\n  TamboToolAssociations,\n  TamboToolRegistry,\n  TamboToolWithToolSchema,\n} from \"../model/component-metadata\";\nimport {\n  getParametersFromToolSchema,\n  getZodFunctionArgs,\n  getZodFunctionReturns,\n  isStandardSchema,\n  schemaToJsonSchema,\n} from \"../schema\";\n\n/**\n * Get all the available components from the component registry\n * @param componentRegistry - The component registry\n * @param toolRegistry - The tool registry\n * @param toolAssociations - The tool associations\n * @returns The available components\n */\nexport const getAvailableComponents = (\n  componentRegistry: ComponentRegistry,\n  toolRegistry: TamboToolRegistry,\n  toolAssociations: TamboToolAssociations,\n): TamboAI.AvailableComponent[] => {\n  const availableComponents: TamboAI.AvailableComponent[] = [];\n\n  for (const [name, componentEntry] of Object.entries(componentRegistry)) {\n    const associatedToolNames = toolAssociations[name] || [];\n\n    const contextTools = associatedToolNames\n      .map((toolName) => {\n        const tool = toolRegistry[toolName];\n        if (!tool) return null;\n        return mapTamboToolToContextTool(tool);\n      })\n      .filter((tool): tool is ComponentContextToolMetadata => tool !== null);\n\n    availableComponents.push({\n      name: componentEntry.name,\n      description: componentEntry.description,\n      props: componentEntry.props,\n      contextTools,\n    });\n  }\n\n  return availableComponents;\n};\n\n/**\n * Get tools from tool registry that are not associated with any component\n * @param toolRegistry - The tool registry\n * @param toolAssociations - The tool associations\n * @returns The tools that are not associated with any component\n */\nexport const getUnassociatedTools = (\n  toolRegistry: TamboToolRegistry,\n  toolAssociations: TamboToolAssociations,\n): (TamboTool | TamboToolWithToolSchema)[] => {\n  return Object.values(toolRegistry).filter((tool) => {\n    // Check if the tool's name appears in any of the tool association arrays\n    return !Object.values(toolAssociations).flat().includes(tool.name);\n  });\n};\n\n/**\n * Helper function to convert component props from Standard Schema or JSON Schema\n * @param component - The component to convert\n * @returns The converted props as JSON Schema\n */\nexport const convertPropsToJsonSchema = (\n  component: RegisteredComponent,\n): unknown => {\n  if (!component.props) {\n    return component.props;\n  }\n\n  // Check if props is a Standard Schema (Zod, Valibot, ArkType, etc.)\n  if (isStandardSchema(component.props)) {\n    return schemaToJsonSchema(component.props);\n  }\n\n  // Already JSON Schema or unknown format - return as-is\n  return component.props;\n};\n\n/**\n * Adapt a Tambo tool defined with function schema to a standard Tambo tool\n * @param tool - The Tambo tool with function schema\n * @returns The adapted Tambo tool\n */\nexport function adaptToolFromFnSchema(\n  tool: TamboTool | TamboToolWithToolSchema,\n): TamboTool {\n  if (!(\"toolSchema\" in tool)) {\n    return tool;\n  }\n\n  return {\n    name: tool.name,\n    description: tool.description,\n    tool: tool.tool,\n    inputSchema: getZodFunctionArgs(tool.toolSchema),\n    outputSchema: getZodFunctionReturns(tool.toolSchema),\n  };\n}\n\n/**\n * Get a component by name from the component registry\n * @param componentName - The name of the component to get\n * @param componentRegistry - The component registry\n * @returns The component registration information\n */\nexport const getComponentFromRegistry = (\n  componentName: string,\n  componentRegistry: ComponentRegistry,\n): RegisteredComponent => {\n  const componentEntry = componentRegistry[componentName];\n\n  if (!componentEntry) {\n    throw new Error(\n      `Tambo tried to use Component ${componentName}, but it was not found.`,\n    );\n  }\n\n  return componentEntry;\n};\n\n/**\n * Map a Tambo tool to a context tool\n * @param tool - The tool to map (supports both new inputSchema and deprecated toolSchema interfaces)\n * @returns The context tool\n */\nexport const mapTamboToolToContextTool = (\n  tool: TamboTool | TamboToolWithToolSchema,\n): ComponentContextToolMetadata => {\n  const parameters = getParametersFromToolSchema(tool);\n\n  return {\n    name: tool.name,\n    description: tool.description,\n    parameters,\n  };\n};\n\n/**\n * Provides type safety for defining a Tambo Tool.\n *\n * Tambo uses the [standard-schema.dev](https://standard-schema.dev) spec which means you can use any Standard Schema\n * compliant validator (Zod, Valibot, ArkType, etc.). This ensures the tool function args and output types are correctly\n * inferred from the provided schemas.\n * @example\n * ```typescript\n * import { z } from \"zod/v4\";\n *\n * const myTool = defineTamboTool({\n *   inputSchema: z.tuple([z.string()]),\n *   outputSchema: z.number(),\n *   tool: yourToolFunction,\n *   // ^-- (input: [string]) => number | Promise<number>\n *   // Types are inferred from and must match inputSchema/outputSchema definitions\n * });\n * ```\n * @param tool The tool definition to register\n * @returns The registered tool definition\n */\nexport const defineTool: DefineToolFn = (tool: any) => {\n  return tool;\n};\n"]}

package/dist/util/registry.test.d.ts

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

package/dist/util/registry.test.d.ts.map

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