@tambo-ai/react 0.67.1 → 0.69.0

package/esm/schema/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC"}

package/esm/schema/index.js

@@ -1,4 +1,4 @@
-export { looksLikeJSONSchema } from "./json-schema";
+export { looksLikeJSONSchema, makeJsonSchemaPartial } from "./json-schema";
 export { getParametersFromToolSchema, hasInputSchema, safeSchemaToJsonSchema, schemaToJsonSchema, } from "./schema";
 export { isStandardSchema } from "./standard-schema";
 export { assertNoRecordSchema } from "./validate";

package/esm/schema/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,kBAAkB,GAEnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC","sourcesContent":["export { looksLikeJSONSchema } from \"./json-schema\";\nexport {\n  getParametersFromToolSchema,\n  hasInputSchema,\n  safeSchemaToJsonSchema,\n  schemaToJsonSchema,\n  type SupportedSchema,\n} from \"./schema\";\nexport { isStandardSchema } from \"./standard-schema\";\nexport { assertNoRecordSchema } from \"./validate\";\nexport { getZodFunctionArgs, getZodFunctionReturns } from \"./zod\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,kBAAkB,GAEnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,OAAO,CAAC","sourcesContent":["export { looksLikeJSONSchema, makeJsonSchemaPartial } from \"./json-schema\";\nexport {\n  getParametersFromToolSchema,\n  hasInputSchema,\n  safeSchemaToJsonSchema,\n  schemaToJsonSchema,\n  type SupportedSchema,\n} from \"./schema\";\nexport { isStandardSchema } from \"./standard-schema\";\nexport { assertNoRecordSchema } from \"./validate\";\nexport { getZodFunctionArgs, getZodFunctionReturns } from \"./zod\";\n"]}

package/esm/schema/json-schema.d.ts

@@ -32,4 +32,11 @@ export declare function isJsonSchemaTuple(schema: JSONSchema7Extended): schema i
  * @returns Array of item schemas, or undefined if not a tuple
  */
 export declare function getJsonSchemaTupleItems(schema: JSONSchema7Extended): JSONSchema7[] | undefined;
+/**
+ * Creates a partial version of a JSON Schema by removing required constraints.
+ * This allows LLM to provide only the properties it wants to update.
+ * @param schema - The JSON Schema to make partial
+ * @returns A new JSON Schema with the required constraint removed
+ */
+export declare function makeJsonSchemaPartial(schema: JSONSchema7): JSONSchema7;
 //# sourceMappingURL=json-schema.d.ts.map

package/esm/schema/json-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/schema/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAkD1C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAMpE;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC9C,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,GAC1B,MAAM,IAAI,mBAAmB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAgBnD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,mBAAmB,GAC1B,WAAW,EAAE,GAAG,SAAS,CAgB3B"}
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/schema/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAkD1C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAMpE;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC9C,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,GAC1B,MAAM,IAAI,mBAAmB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAgBnD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,mBAAmB,GAC1B,WAAW,EAAE,GAAG,SAAS,CAgB3B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAGtE"}

package/esm/schema/json-schema.js

@@ -1,4 +1,4 @@
-import { z } from "./alias";
+import { z } from "zod/v4";
 const jsonSchemaType = z.union([
     z.literal("object"),
     z.literal("array"),
@@ -95,4 +95,14 @@ export function getJsonSchemaTupleItems(schema) {
     }
     return undefined;
 }
+/**
+ * Creates a partial version of a JSON Schema by removing required constraints.
+ * This allows LLM to provide only the properties it wants to update.
+ * @param schema - The JSON Schema to make partial
+ * @returns A new JSON Schema with the required constraint removed
+ */
+export function makeJsonSchemaPartial(schema) {
+    const { required: _required, ...rest } = schema;
+    return rest;
+}
 //# sourceMappingURL=json-schema.js.map

package/esm/schema/json-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../src/schema/json-schema.ts"],"names":[],"mappings":"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","sourcesContent":["import { JSONSchema7 } from \"json-schema\";\nimport { z } from \"./alias\";\n\nconst jsonSchemaType = z.union([\n  z.literal(\"object\"),\n  z.literal(\"array\"),\n  z.literal(\"string\"),\n  z.literal(\"number\"),\n  z.literal(\"integer\"),\n  z.literal(\"boolean\"),\n  z.literal(\"null\"),\n  z.array(\n    z.union([\n      z.literal(\"object\"),\n      z.literal(\"array\"),\n      z.literal(\"string\"),\n      z.literal(\"number\"),\n      z.literal(\"integer\"),\n      z.literal(\"boolean\"),\n      z.literal(\"null\"),\n    ]),\n  ),\n]);\n\nconst jsonSchemaTopLevel = z\n  .looseObject({\n    type: jsonSchemaType.optional(),\n    properties: z.record(z.string(), z.unknown()).optional(),\n    items: z.union([z.array(z.unknown()), z.unknown()]).optional(),\n    required: z.array(z.string()).optional(),\n    additionalProperties: z.union([z.boolean(), z.unknown()]).optional(),\n    enum: z.array(z.unknown()).optional(),\n    const: z.unknown().optional(),\n    $ref: z.string().optional(),\n    $id: z.string().optional(),\n    $schema: z.string().optional(),\n    title: z.string().optional(),\n    description: z.string().optional(),\n  })\n  .refine((value) => {\n    return (\n      value.type !== undefined ||\n      value.properties !== undefined ||\n      value.items !== undefined ||\n      value.enum !== undefined ||\n      value.const !== undefined ||\n      value.$ref !== undefined\n    );\n  });\n\n/**\n * Basic heuristic to check if an object looks like a JSON Schema at the top level.\n *\n * This uses a Zod schema to verify only top-level keys (type, properties, items,\n * etc.). It intentionally does not perform full JSON Schema validation; a more\n * thorough check should be done server-side.\n * @param obj - The value to check\n * @returns True if the value appears to be a JSON Schema\n */\nexport function looksLikeJSONSchema(obj: unknown): obj is JSONSchema7 {\n  if (obj === null || typeof obj !== \"object\") {\n    return false;\n  }\n\n  return jsonSchemaTopLevel.safeParse(obj).success;\n}\n\n/**\n * Extended JSON Schema type that includes draft 2020-12 features like prefixItems.\n * The json-schema package types are from draft-07 and don't include prefixItems.\n */\nexport type JSONSchema7Extended = JSONSchema7 & {\n  prefixItems?: JSONSchema7[];\n};\n\n/**\n * Checks if a JSON Schema represents a tuple (array with positional items).\n * Supports both draft-07 (items as array) and draft 2020-12 (prefixItems).\n * @param schema - The JSON Schema to check\n * @returns True if the schema represents a tuple\n */\nexport function isJsonSchemaTuple(\n  schema: JSONSchema7Extended,\n): schema is JSONSchema7Extended & { type: \"array\" } {\n  if (schema.type !== \"array\") {\n    return false;\n  }\n\n  // Draft 2020-12: prefixItems array\n  if (schema.prefixItems && Array.isArray(schema.prefixItems)) {\n    return true;\n  }\n\n  // Draft-07: items as array (not object)\n  if (Array.isArray(schema.items)) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Gets the tuple items from a JSON Schema.\n * Supports both draft-07 (items as array) and draft 2020-12 (prefixItems).\n * @param schema - The JSON Schema tuple\n * @returns Array of item schemas, or undefined if not a tuple\n */\nexport function getJsonSchemaTupleItems(\n  schema: JSONSchema7Extended,\n): JSONSchema7[] | undefined {\n  if (schema.type !== \"array\") {\n    return undefined;\n  }\n\n  // Draft 2020-12: prefixItems array\n  if (schema.prefixItems && Array.isArray(schema.prefixItems)) {\n    return schema.prefixItems;\n  }\n\n  // Draft-07: items as array\n  if (Array.isArray(schema.items)) {\n    return schema.items as JSONSchema7[];\n  }\n\n  return undefined;\n}\n"]}
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../src/schema/json-schema.ts"],"names":[],"mappings":"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","sourcesContent":["import { JSONSchema7 } from \"json-schema\";\nimport { z } from \"zod/v4\";\n\nconst jsonSchemaType = z.union([\n  z.literal(\"object\"),\n  z.literal(\"array\"),\n  z.literal(\"string\"),\n  z.literal(\"number\"),\n  z.literal(\"integer\"),\n  z.literal(\"boolean\"),\n  z.literal(\"null\"),\n  z.array(\n    z.union([\n      z.literal(\"object\"),\n      z.literal(\"array\"),\n      z.literal(\"string\"),\n      z.literal(\"number\"),\n      z.literal(\"integer\"),\n      z.literal(\"boolean\"),\n      z.literal(\"null\"),\n    ]),\n  ),\n]);\n\nconst jsonSchemaTopLevel = z\n  .looseObject({\n    type: jsonSchemaType.optional(),\n    properties: z.record(z.string(), z.unknown()).optional(),\n    items: z.union([z.array(z.unknown()), z.unknown()]).optional(),\n    required: z.array(z.string()).optional(),\n    additionalProperties: z.union([z.boolean(), z.unknown()]).optional(),\n    enum: z.array(z.unknown()).optional(),\n    const: z.unknown().optional(),\n    $ref: z.string().optional(),\n    $id: z.string().optional(),\n    $schema: z.string().optional(),\n    title: z.string().optional(),\n    description: z.string().optional(),\n  })\n  .refine((value) => {\n    return (\n      value.type !== undefined ||\n      value.properties !== undefined ||\n      value.items !== undefined ||\n      value.enum !== undefined ||\n      value.const !== undefined ||\n      value.$ref !== undefined\n    );\n  });\n\n/**\n * Basic heuristic to check if an object looks like a JSON Schema at the top level.\n *\n * This uses a Zod schema to verify only top-level keys (type, properties, items,\n * etc.). It intentionally does not perform full JSON Schema validation; a more\n * thorough check should be done server-side.\n * @param obj - The value to check\n * @returns True if the value appears to be a JSON Schema\n */\nexport function looksLikeJSONSchema(obj: unknown): obj is JSONSchema7 {\n  if (obj === null || typeof obj !== \"object\") {\n    return false;\n  }\n\n  return jsonSchemaTopLevel.safeParse(obj).success;\n}\n\n/**\n * Extended JSON Schema type that includes draft 2020-12 features like prefixItems.\n * The json-schema package types are from draft-07 and don't include prefixItems.\n */\nexport type JSONSchema7Extended = JSONSchema7 & {\n  prefixItems?: JSONSchema7[];\n};\n\n/**\n * Checks if a JSON Schema represents a tuple (array with positional items).\n * Supports both draft-07 (items as array) and draft 2020-12 (prefixItems).\n * @param schema - The JSON Schema to check\n * @returns True if the schema represents a tuple\n */\nexport function isJsonSchemaTuple(\n  schema: JSONSchema7Extended,\n): schema is JSONSchema7Extended & { type: \"array\" } {\n  if (schema.type !== \"array\") {\n    return false;\n  }\n\n  // Draft 2020-12: prefixItems array\n  if (schema.prefixItems && Array.isArray(schema.prefixItems)) {\n    return true;\n  }\n\n  // Draft-07: items as array (not object)\n  if (Array.isArray(schema.items)) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Gets the tuple items from a JSON Schema.\n * Supports both draft-07 (items as array) and draft 2020-12 (prefixItems).\n * @param schema - The JSON Schema tuple\n * @returns Array of item schemas, or undefined if not a tuple\n */\nexport function getJsonSchemaTupleItems(\n  schema: JSONSchema7Extended,\n): JSONSchema7[] | undefined {\n  if (schema.type !== \"array\") {\n    return undefined;\n  }\n\n  // Draft 2020-12: prefixItems array\n  if (schema.prefixItems && Array.isArray(schema.prefixItems)) {\n    return schema.prefixItems;\n  }\n\n  // Draft-07: items as array\n  if (Array.isArray(schema.items)) {\n    return schema.items as JSONSchema7[];\n  }\n\n  return undefined;\n}\n\n/**\n * Creates a partial version of a JSON Schema by removing required constraints.\n * This allows LLM to provide only the properties it wants to update.\n * @param schema - The JSON Schema to make partial\n * @returns A new JSON Schema with the required constraint removed\n */\nexport function makeJsonSchemaPartial(schema: JSONSchema7): JSONSchema7 {\n  const { required: _required, ...rest } = schema;\n  return rest;\n}\n"]}

package/esm/schema/json-schema.test.d.ts

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

package/esm/schema/json-schema.test.d.ts.map

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

package/esm/schema/json-schema.test.js

@@ -0,0 +1,202 @@
+import { getJsonSchemaTupleItems, isJsonSchemaTuple, looksLikeJSONSchema, makeJsonSchemaPartial, } from "./json-schema";
+describe("looksLikeJSONSchema", () => {
+    it("should return true for a valid object schema", () => {
+        const schema = {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+            },
+        };
+        expect(looksLikeJSONSchema(schema)).toBe(true);
+    });
+    it("should return true for a schema with only properties", () => {
+        const schema = {
+            properties: {
+                name: { type: "string" },
+            },
+        };
+        expect(looksLikeJSONSchema(schema)).toBe(true);
+    });
+    it("should return true for a schema with items (array)", () => {
+        const schema = {
+            type: "array",
+            items: { type: "string" },
+        };
+        expect(looksLikeJSONSchema(schema)).toBe(true);
+    });
+    it("should return true for a schema with enum", () => {
+        const schema = {
+            enum: ["a", "b", "c"],
+        };
+        expect(looksLikeJSONSchema(schema)).toBe(true);
+    });
+    it("should return true for a schema with const", () => {
+        const schema = {
+            const: "fixed-value",
+        };
+        expect(looksLikeJSONSchema(schema)).toBe(true);
+    });
+    it("should return true for a schema with $ref", () => {
+        const schema = {
+            $ref: "#/definitions/Person",
+        };
+        expect(looksLikeJSONSchema(schema)).toBe(true);
+    });
+    it("should return false for null", () => {
+        expect(looksLikeJSONSchema(null)).toBe(false);
+    });
+    it("should return false for non-object", () => {
+        expect(looksLikeJSONSchema("string")).toBe(false);
+        expect(looksLikeJSONSchema(123)).toBe(false);
+        expect(looksLikeJSONSchema(undefined)).toBe(false);
+    });
+    it("should return false for empty object", () => {
+        expect(looksLikeJSONSchema({})).toBe(false);
+    });
+    it("should return false for object without schema keys", () => {
+        const notSchema = {
+            foo: "bar",
+            baz: 123,
+        };
+        expect(looksLikeJSONSchema(notSchema)).toBe(false);
+    });
+});
+describe("isJsonSchemaTuple", () => {
+    it("should return true for draft-07 tuple (items as array)", () => {
+        const schema = {
+            type: "array",
+            items: [{ type: "string" }, { type: "number" }],
+        };
+        expect(isJsonSchemaTuple(schema)).toBe(true);
+    });
+    it("should return true for draft 2020-12 tuple (prefixItems)", () => {
+        const schema = {
+            type: "array",
+            prefixItems: [{ type: "string" }, { type: "number" }],
+        };
+        expect(isJsonSchemaTuple(schema)).toBe(true);
+    });
+    it("should return false for regular array schema (items as object)", () => {
+        const schema = {
+            type: "array",
+            items: { type: "string" },
+        };
+        expect(isJsonSchemaTuple(schema)).toBe(false);
+    });
+    it("should return false for non-array schema", () => {
+        const schema = {
+            type: "object",
+            properties: {},
+        };
+        expect(isJsonSchemaTuple(schema)).toBe(false);
+    });
+    it("should return false for array without items or prefixItems", () => {
+        const schema = {
+            type: "array",
+        };
+        expect(isJsonSchemaTuple(schema)).toBe(false);
+    });
+});
+describe("getJsonSchemaTupleItems", () => {
+    it("should return items for draft-07 tuple", () => {
+        const items = [{ type: "string" }, { type: "number" }];
+        const schema = {
+            type: "array",
+            items: items,
+        };
+        expect(getJsonSchemaTupleItems(schema)).toEqual(items);
+    });
+    it("should return prefixItems for draft 2020-12 tuple", () => {
+        const prefixItems = [{ type: "string" }, { type: "number" }];
+        const schema = {
+            type: "array",
+            prefixItems: prefixItems,
+        };
+        expect(getJsonSchemaTupleItems(schema)).toEqual(prefixItems);
+    });
+    it("should return undefined for non-array schema", () => {
+        const schema = {
+            type: "object",
+        };
+        expect(getJsonSchemaTupleItems(schema)).toBeUndefined();
+    });
+    it("should return undefined for array without tuple items", () => {
+        const schema = {
+            type: "array",
+            items: { type: "string" },
+        };
+        expect(getJsonSchemaTupleItems(schema)).toBeUndefined();
+    });
+    it("should prefer prefixItems over items when both present", () => {
+        const prefixItems = [{ type: "boolean" }];
+        const items = [{ type: "string" }];
+        const schema = {
+            type: "array",
+            prefixItems: prefixItems,
+            items: items,
+        };
+        expect(getJsonSchemaTupleItems(schema)).toEqual(prefixItems);
+    });
+});
+describe("makeJsonSchemaPartial", () => {
+    it("should remove required array from schema", () => {
+        const schema = {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+                age: { type: "number" },
+            },
+            required: ["name", "age"],
+        };
+        const partial = makeJsonSchemaPartial(schema);
+        expect(partial.required).toBeUndefined();
+        expect(partial.type).toBe("object");
+        expect(partial.properties).toEqual(schema.properties);
+    });
+    it("should preserve all other properties", () => {
+        const schema = {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "The name" },
+            },
+            required: ["name"],
+            additionalProperties: false,
+            description: "A person schema",
+            title: "Person",
+        };
+        const partial = makeJsonSchemaPartial(schema);
+        expect(partial.required).toBeUndefined();
+        expect(partial.type).toBe("object");
+        expect(partial.properties).toEqual(schema.properties);
+        expect(partial.additionalProperties).toBe(false);
+        expect(partial.description).toBe("A person schema");
+        expect(partial.title).toBe("Person");
+    });
+    it("should handle schema without required array", () => {
+        const schema = {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+            },
+        };
+        const partial = makeJsonSchemaPartial(schema);
+        expect(partial.required).toBeUndefined();
+        expect(partial.type).toBe("object");
+        expect(partial.properties).toEqual(schema.properties);
+    });
+    it("should not mutate the original schema", () => {
+        const schema = {
+            type: "object",
+            properties: {
+                name: { type: "string" },
+            },
+            required: ["name"],
+        };
+        const partial = makeJsonSchemaPartial(schema);
+        // Original should be unchanged
+        expect(schema.required).toEqual(["name"]);
+        // Partial should not have required
+        expect(partial.required).toBeUndefined();
+    });
+});
+//# sourceMappingURL=json-schema.test.js.map

package/esm/schema/json-schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.test.js","sourceRoot":"","sources":["../../src/schema/json-schema.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { JSONSchema7 } from \"json-schema\";\nimport {\n  getJsonSchemaTupleItems,\n  isJsonSchemaTuple,\n  JSONSchema7Extended,\n  looksLikeJSONSchema,\n  makeJsonSchemaPartial,\n} from \"./json-schema\";\n\ndescribe(\"looksLikeJSONSchema\", () => {\n  it(\"should return true for a valid object schema\", () => {\n    const schema = {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\" },\n      },\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return true for a schema with only properties\", () => {\n    const schema = {\n      properties: {\n        name: { type: \"string\" },\n      },\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return true for a schema with items (array)\", () => {\n    const schema = {\n      type: \"array\",\n      items: { type: \"string\" },\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return true for a schema with enum\", () => {\n    const schema = {\n      enum: [\"a\", \"b\", \"c\"],\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return true for a schema with const\", () => {\n    const schema = {\n      const: \"fixed-value\",\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return true for a schema with $ref\", () => {\n    const schema = {\n      $ref: \"#/definitions/Person\",\n    };\n    expect(looksLikeJSONSchema(schema)).toBe(true);\n  });\n\n  it(\"should return false for null\", () => {\n    expect(looksLikeJSONSchema(null)).toBe(false);\n  });\n\n  it(\"should return false for non-object\", () => {\n    expect(looksLikeJSONSchema(\"string\")).toBe(false);\n    expect(looksLikeJSONSchema(123)).toBe(false);\n    expect(looksLikeJSONSchema(undefined)).toBe(false);\n  });\n\n  it(\"should return false for empty object\", () => {\n    expect(looksLikeJSONSchema({})).toBe(false);\n  });\n\n  it(\"should return false for object without schema keys\", () => {\n    const notSchema = {\n      foo: \"bar\",\n      baz: 123,\n    };\n    expect(looksLikeJSONSchema(notSchema)).toBe(false);\n  });\n});\n\ndescribe(\"isJsonSchemaTuple\", () => {\n  it(\"should return true for draft-07 tuple (items as array)\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      items: [{ type: \"string\" }, { type: \"number\" }],\n    };\n    expect(isJsonSchemaTuple(schema)).toBe(true);\n  });\n\n  it(\"should return true for draft 2020-12 tuple (prefixItems)\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      prefixItems: [{ type: \"string\" }, { type: \"number\" }],\n    };\n    expect(isJsonSchemaTuple(schema)).toBe(true);\n  });\n\n  it(\"should return false for regular array schema (items as object)\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      items: { type: \"string\" },\n    };\n    expect(isJsonSchemaTuple(schema)).toBe(false);\n  });\n\n  it(\"should return false for non-array schema\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"object\",\n      properties: {},\n    };\n    expect(isJsonSchemaTuple(schema)).toBe(false);\n  });\n\n  it(\"should return false for array without items or prefixItems\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n    };\n    expect(isJsonSchemaTuple(schema)).toBe(false);\n  });\n});\n\ndescribe(\"getJsonSchemaTupleItems\", () => {\n  it(\"should return items for draft-07 tuple\", () => {\n    const items = [{ type: \"string\" }, { type: \"number\" }];\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      items: items as JSONSchema7[],\n    };\n    expect(getJsonSchemaTupleItems(schema)).toEqual(items);\n  });\n\n  it(\"should return prefixItems for draft 2020-12 tuple\", () => {\n    const prefixItems = [{ type: \"string\" }, { type: \"number\" }];\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      prefixItems: prefixItems as JSONSchema7[],\n    };\n    expect(getJsonSchemaTupleItems(schema)).toEqual(prefixItems);\n  });\n\n  it(\"should return undefined for non-array schema\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"object\",\n    };\n    expect(getJsonSchemaTupleItems(schema)).toBeUndefined();\n  });\n\n  it(\"should return undefined for array without tuple items\", () => {\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      items: { type: \"string\" },\n    };\n    expect(getJsonSchemaTupleItems(schema)).toBeUndefined();\n  });\n\n  it(\"should prefer prefixItems over items when both present\", () => {\n    const prefixItems = [{ type: \"boolean\" }];\n    const items = [{ type: \"string\" }];\n    const schema: JSONSchema7Extended = {\n      type: \"array\",\n      prefixItems: prefixItems as JSONSchema7[],\n      items: items as JSONSchema7[],\n    };\n    expect(getJsonSchemaTupleItems(schema)).toEqual(prefixItems);\n  });\n});\n\ndescribe(\"makeJsonSchemaPartial\", () => {\n  it(\"should remove required array from schema\", () => {\n    const schema: JSONSchema7 = {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\" },\n        age: { type: \"number\" },\n      },\n      required: [\"name\", \"age\"],\n    };\n\n    const partial = makeJsonSchemaPartial(schema);\n\n    expect(partial.required).toBeUndefined();\n    expect(partial.type).toBe(\"object\");\n    expect(partial.properties).toEqual(schema.properties);\n  });\n\n  it(\"should preserve all other properties\", () => {\n    const schema: JSONSchema7 = {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\", description: \"The name\" },\n      },\n      required: [\"name\"],\n      additionalProperties: false,\n      description: \"A person schema\",\n      title: \"Person\",\n    };\n\n    const partial = makeJsonSchemaPartial(schema);\n\n    expect(partial.required).toBeUndefined();\n    expect(partial.type).toBe(\"object\");\n    expect(partial.properties).toEqual(schema.properties);\n    expect(partial.additionalProperties).toBe(false);\n    expect(partial.description).toBe(\"A person schema\");\n    expect(partial.title).toBe(\"Person\");\n  });\n\n  it(\"should handle schema without required array\", () => {\n    const schema: JSONSchema7 = {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\" },\n      },\n    };\n\n    const partial = makeJsonSchemaPartial(schema);\n\n    expect(partial.required).toBeUndefined();\n    expect(partial.type).toBe(\"object\");\n    expect(partial.properties).toEqual(schema.properties);\n  });\n\n  it(\"should not mutate the original schema\", () => {\n    const schema: JSONSchema7 = {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\" },\n      },\n      required: [\"name\"],\n    };\n\n    const partial = makeJsonSchemaPartial(schema);\n\n    // Original should be unchanged\n    expect(schema.required).toEqual([\"name\"]);\n    // Partial should not have required\n    expect(partial.required).toBeUndefined();\n  });\n});\n"]}

package/esm/schema/schema.test.js

@@ -1,7 +1,7 @@
 import * as z3 from "zod/v3";
 import * as z4 from "zod/v4";
 import { looksLikeJSONSchema } from "./json-schema";
-import { getParametersFromToolSchema } from "./schema";
+import { getParametersFromToolSchema, hasInputSchema, safeSchemaToJsonSchema, schemaToJsonSchema, } from "./schema";
 import { isStandardSchema } from "./standard-schema";
 describe("schema utilities", () => {
     describe("looksLikeJSONSchema", () => {
@@ -288,6 +288,243 @@ describe("schema utilities", () => {
                 expect(params.length).toBeGreaterThanOrEqual(1);
                 expect(params[0].name).toBe("param1");
             });
+            it("handles toolSchema with JSON Schema directly", () => {
+                const tool = {
+                    name: "test-tool",
+                    description: "Test tool",
+                    tool: jest.fn(),
+                    toolSchema: {
+                        type: "object",
+                        properties: {
+                            query: { type: "string", description: "Search query" },
+                        },
+                        required: ["query"],
+                    },
+                };
+                const params = getParametersFromToolSchema(tool);
+                // JSON Schema in toolSchema should return params wrapped
+                expect(params.length).toBeGreaterThanOrEqual(1);
+            });
+        });
+        describe("edge cases and error handling", () => {
+            it("returns empty params when inputSchema is unknown type", () => {
+                // Create a tool with an invalid inputSchema that isn't Standard Schema or JSON Schema
+                const tool = {
+                    name: "test-tool",
+                    description: "Test tool",
+                    tool: jest.fn(),
+                    inputSchema: "invalid-schema", // Not a valid schema
+                    outputSchema: z4.void(),
+                };
+                const consoleSpy = jest.spyOn(console, "warn").mockImplementation();
+                const params = getParametersFromToolSchema(tool);
+                consoleSpy.mockRestore();
+                expect(params).toEqual([]);
+            });
+            it("throws when toolSchema is undefined", () => {
+                // Create a tool with toolSchema that has undefined toolSchema
+                const tool = {
+                    name: "test-tool",
+                    description: "Test tool",
+                    tool: jest.fn(),
+                    toolSchema: undefined,
+                };
+                expect(() => getParametersFromToolSchema(tool)).toThrow("Unable to determine parameters from zod function schema");
+            });
+            it("throws when toolSchema args are not recognized", () => {
+                // Create a tool with toolSchema that is not a function schema or JSON schema
+                // This causes getArgsFromToolSchema to attempt extraction but fail
+                const tool = {
+                    name: "test-tool",
+                    description: "Test tool",
+                    tool: jest.fn(),
+                    toolSchema: { notASchema: true },
+                };
+                // This throws because it's not a Zod function schema
+                expect(() => getParametersFromToolSchema(tool)).toThrow("Unable to determine parameters from zod function schema");
+            });
+        });
+        describe("toolSchema with JSON Schema tuple", () => {
+            it("handles toolSchema with JSON Schema array/tuple directly", () => {
+                const tool = {
+                    name: "test-tool",
+                    description: "Test tool",
+                    tool: jest.fn(),
+                    // JSON Schema tuple format
+                    toolSchema: {
+                        type: "array",
+                        items: [
+                            { type: "string", description: "First param" },
+                            { type: "number", description: "Second param" },
+                        ],
+                    },
+                };
+                const params = getParametersFromToolSchema(tool);
+                // JSON Schema tuples should be extracted as positional params
+                expect(params).toHaveLength(2);
+                expect(params[0].name).toBe("param1");
+                expect(params[0].type).toBe("string");
+                expect(params[0].description).toBe("First param");
+                expect(params[1].name).toBe("param2");
+                expect(params[1].type).toBe("number");
+            });
+            it("handles toolSchema with JSON Schema prefixItems (2020-12 format)", () => {
+                const tool = {
+                    name: "test-tool",
+                    description: "Test tool",
+                    tool: jest.fn(),
+                    // JSON Schema 2020-12 tuple format
+                    toolSchema: {
+                        type: "array",
+                        prefixItems: [
+                            { type: "boolean", description: "Flag" },
+                            { type: "string" },
+                        ],
+                    },
+                };
+                const params = getParametersFromToolSchema(tool);
+                expect(params).toHaveLength(2);
+                expect(params[0].name).toBe("param1");
+                expect(params[0].type).toBe("boolean");
+                expect(params[0].description).toBe("Flag");
+                expect(params[1].name).toBe("param2");
+                expect(params[1].type).toBe("string");
+            });
+            it("handles toolSchema with non-tuple JSON Schema (fallback)", () => {
+                const tool = {
+                    name: "test-tool",
+                    description: "Test tool",
+                    tool: jest.fn(),
+                    // Non-tuple JSON Schema - should be wrapped as single param
+                    toolSchema: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string" },
+                        },
+                    },
+                };
+                const params = getParametersFromToolSchema(tool);
+                // Non-tuple schemas should be wrapped as a single param
+                expect(params).toHaveLength(1);
+                expect(params[0].name).toBe("param1");
+                expect(params[0].type).toBe("object");
+            });
+        });
+    });
+    describe("schemaToJsonSchema", () => {
+        it("returns JSON Schema as-is when already a JSON Schema", () => {
+            const jsonSchema = {
+                type: "object",
+                properties: {
+                    name: { type: "string" },
+                },
+            };
+            const result = schemaToJsonSchema(jsonSchema);
+            expect(result).toBe(jsonSchema); // Same reference
+        });
+        it("converts Zod 4 schema to JSON Schema", () => {
+            const zodSchema = z4.object({
+                name: z4.string(),
+                count: z4.number(),
+            });
+            const result = schemaToJsonSchema(zodSchema);
+            expect(result).toEqual(expect.objectContaining({
+                type: "object",
+                properties: expect.objectContaining({
+                    name: expect.objectContaining({ type: "string" }),
+                    count: expect.objectContaining({ type: "number" }),
+                }),
+            }));
+        });
+        it("converts Zod 3 schema to JSON Schema", () => {
+            const zodSchema = z3.object({
+                title: z3.string(),
+            });
+            const result = schemaToJsonSchema(zodSchema);
+            expect(result).toEqual(expect.objectContaining({
+                type: "object",
+                properties: expect.objectContaining({
+                    title: expect.objectContaining({ type: "string" }),
+                }),
+            }));
+        });
+    });
+    describe("safeSchemaToJsonSchema", () => {
+        it("returns undefined for null schema", () => {
+            expect(safeSchemaToJsonSchema(null)).toBeUndefined();
+        });
+        it("returns undefined for undefined schema", () => {
+            expect(safeSchemaToJsonSchema(undefined)).toBeUndefined();
+        });
+        it("converts valid schema successfully", () => {
+            const zodSchema = z4.object({ name: z4.string() });
+            const result = safeSchemaToJsonSchema(zodSchema);
+            expect(result).toEqual(expect.objectContaining({
+                type: "object",
+                properties: expect.objectContaining({
+                    name: expect.objectContaining({ type: "string" }),
+                }),
+            }));
+        });
+        it("returns undefined and calls onError for invalid schema", () => {
+            // Create something that looks like a Standard Schema but will fail conversion
+            const brokenSchema = {
+                "~standard": {
+                    version: 1,
+                    vendor: "broken",
+                    validate: () => ({ value: {} }),
+                },
+            };
+            const onError = jest.fn();
+            const consoleSpy = jest.spyOn(console, "error").mockImplementation();
+            const result = safeSchemaToJsonSchema(brokenSchema, onError);
+            consoleSpy.mockRestore();
+            expect(result).toBeUndefined();
+            expect(onError).toHaveBeenCalled();
+        });
+        it("logs error to console when conversion fails", () => {
+            const brokenSchema = {
+                "~standard": {
+                    version: 1,
+                    vendor: "broken",
+                    validate: () => ({ value: {} }),
+                },
+            };
+            const consoleSpy = jest.spyOn(console, "error").mockImplementation();
+            safeSchemaToJsonSchema(brokenSchema);
+            expect(consoleSpy).toHaveBeenCalledWith("Error converting schema to JSON Schema:", expect.any(Error));
+            consoleSpy.mockRestore();
+        });
+    });
+    describe("hasInputSchema", () => {
+        it("returns true for tool with inputSchema", () => {
+            const tool = {
+                name: "test",
+                description: "test",
+                tool: jest.fn(),
+                inputSchema: z4.object({ a: z4.string() }),
+                outputSchema: z4.void(),
+            };
+            expect(hasInputSchema(tool)).toBe(true);
+        });
+        it("returns false for tool with toolSchema (deprecated)", () => {
+            const tool = {
+                name: "test",
+                description: "test",
+                tool: jest.fn(),
+                toolSchema: z3.function().args(z3.string()).returns(z3.void()),
+            };
+            expect(hasInputSchema(tool)).toBe(false);
+        });
+        it("returns false for tool with null inputSchema", () => {
+            const tool = {
+                name: "test",
+                description: "test",
+                tool: jest.fn(),
+                inputSchema: null,
+                outputSchema: z4.void(),
+            };
+            expect(hasInputSchema(tool)).toBe(false);
         });
     });
 });