@tambo-ai/react 0.65.2 → 0.66.0

package/esm/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/esm/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/esm/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/esm/util/registry.js

@@ -1,4 +1,4 @@
-import zodToJsonSchema from "zod-to-json-schema";
+import { getParametersFromToolSchema, getZodFunctionArgs, getZodFunctionReturns, isStandardSchema, schemaToJsonSchema, } from "../schema";
 /**
  * Get all the available components from the component registry
  * @param componentRegistry - The component registry
@@ -10,14 +10,14 @@ export const getAvailableComponents = (componentRegistry, toolRegistry, toolAsso
     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 mapTamboToolToContextTool(tool);
-            }),
-        ].filter((tool) => tool !== null);
+        const contextTools = associatedToolNames
+            .map((toolName) => {
+            const tool = toolRegistry[toolName];
+            if (!tool)
+                return null;
+            return mapTamboToolToContextTool(tool);
+        })
+            .filter((tool) => tool !== null);
         availableComponents.push({
             name: componentEntry.name,
             description: componentEntry.description,
@@ -40,21 +40,38 @@ export const getUnassociatedTools = (toolRegistry, toolAssociations) => {
     });
 };
 /**
- * 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 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 zodToJsonSchema(component.props);
+    // Check if props is a Standard Schema (Zod, Valibot, ArkType, etc.)
+    if (isStandardSchema(component.props)) {
+        return schemaToJsonSchema(component.props);
     }
+    // Already JSON Schema or unknown format - return as-is
     return component.props;
 };
+/**
+ * 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 function adaptToolFromFnSchema(tool) {
+    if (!("toolSchema" in tool)) {
+        return tool;
+    }
+    return {
+        name: tool.name,
+        description: tool.description,
+        tool: tool.tool,
+        inputSchema: getZodFunctionArgs(tool.toolSchema),
+        outputSchema: getZodFunctionReturns(tool.toolSchema),
+    };
+}
 /**
  * Get a component by name from the component registry
  * @param componentName - The name of the component to get
@@ -70,72 +87,39 @@ export const getComponentFromRegistry = (componentName, componentRegistry) => {
 };
 /**
  * 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 const mapTamboToolToContextTool = (tool) => {
-    const parameters = getParametersFromZodFunction(tool.toolSchema);
+    const parameters = getParametersFromToolSchema(tool);
     return {
         name: tool.name,
         description: tool.description,
         parameters,
     };
 };
-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 = zodToJsonSchema(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
+ */
+export const defineTool = (tool) => {
+    return tool;
 };
 //# sourceMappingURL=registry.js.map

package/esm/util/registry.js.map

@@ -1 +1 @@
-{"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 { 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/esm/util/registry.test.d.ts

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

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

package/esm/util/registry.test.js

@@ -0,0 +1,169 @@
+import * as v from "valibot";
+import * as z3 from "zod/v3";
+import * as z4 from "zod/v4";
+import { createMockTool, createMockToolWithToolSchema } from "../testing/tools";
+import { mapTamboToolToContextTool } from "./registry";
+describe("getParametersFromToolSchema (via mapTamboToolToContextTool)", () => {
+    describe("Deprecated toolSchema interface (Zod function schemas)", () => {
+        it("should handle tool with toolSchema", () => {
+            const tool = createMockToolWithToolSchema(z3.function().args(z3.string().describe("The name")).returns(z3.void()));
+            const result = 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 = createMockToolWithToolSchema(z3
+                .function()
+                .args(z3.string().describe("First name"), z3.number().describe("Age"), z3.boolean().describe("Is active"))
+                .returns(z3.void()));
+            const result = 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 = createMockTool({
+                    inputSchema: z4.object({
+                        name: z4.string().describe("User name"),
+                        age: z4.number().describe("User age"),
+                    }),
+                    outputSchema: z4.boolean(),
+                });
+                const result = 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 = 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 = 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 = createMockTool({
+                    inputSchema: z3.object({
+                        name: z3.string(),
+                        age: z3.number(),
+                    }),
+                    outputSchema: z3.boolean(),
+                });
+                const result = 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 = createMockTool({
+                    inputSchema: v.object({
+                        name: v.string(),
+                        age: v.number(),
+                    }),
+                    outputSchema: v.boolean(),
+                });
+                const result = 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 = 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 = 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 = createMockTool({ inputSchema: schema, outputSchema: {} });
+                const result = 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 = createMockTool(z4.object({
+                name: z4.string(),
+                age: z4.number(),
+            }));
+            const result = 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 = createMockTool(z3.object({
+                name: z3.string(),
+                age: z3.number(),
+            }));
+            const result = 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 = createMockTool(v.object({
+                name: v.string(),
+                age: v.number(),
+            }));
+            const result = 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 = createMockTool(schema);
+            const result = mapTamboToolToContextTool(tool);
+            expect(result.parameters).toHaveLength(1);
+            expect(result.parameters[0].name).toBe("input");
+            expect(result.parameters).toMatchSnapshot();
+        });
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/esm/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/esm/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/esm/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/esm/util/resource-validators.js

@@ -0,0 +1,30 @@
+/**
+ * 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 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
+ */
+export 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/esm/util/resource-validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-validators.js","sourceRoot":"","sources":["../../src/util/resource-validators.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,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,MAAM,UAAU,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"]}