@mastra/schema-compat 0.11.5 → 0.11.6-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @mastra/schema-compat
 
+## 0.11.6-alpha.0
+
+### Patch Changes
+
+- Fix Zod v4 toJSONSchema bug with z.record() single-argument form ([#9355](https://github.com/mastra-ai/mastra/pull/9355))
+
+  Zod v4 has a bug in the single-argument form of `z.record(valueSchema)` where it incorrectly assigns the value schema to `keyType` instead of `valueType`, leaving `valueType` undefined. This causes `toJSONSchema()` to throw "Cannot read properties of undefined (reading '\_zod')" when processing schemas containing `z.record()` fields.
+
+  This fix patches affected schemas before conversion by detecting records with missing `valueType` and correctly assigning the schema to `valueType` while setting `keyType` to `z.string()` (the default). The patch recursively handles nested schemas including those wrapped in `.optional()`, `.nullable()`, arrays, unions, and objects.
+
+- Improved reliability of string field types in tool schema compatibility ([#9362](https://github.com/mastra-ai/mastra/pull/9362))
+
 ## 0.11.5
 
 ### Patch Changes

package/dist/chunk-5WM4A32G.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+var zod = require('zod');
+var zodToJsonSchemaOriginal = require('zod-to-json-schema');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var zodToJsonSchemaOriginal__default = /*#__PURE__*/_interopDefault(zodToJsonSchemaOriginal);
+
+// src/zod-to-json.ts
+var PATCHED = Symbol("__mastra_patched__");
+function patchRecordSchemas(schema) {
+  if (!schema || typeof schema !== "object") return schema;
+  if (schema[PATCHED]) return schema;
+  schema[PATCHED] = true;
+  const def = schema._zod?.def;
+  if (def?.type === "record" && def.keyType && !def.valueType) {
+    def.valueType = def.keyType;
+    def.keyType = zod.z.string();
+  }
+  if (!def) return schema;
+  if (def.type === "object" && def.shape) {
+    const shape = typeof def.shape === "function" ? def.shape() : def.shape;
+    for (const key of Object.keys(shape)) {
+      patchRecordSchemas(shape[key]);
+    }
+  }
+  if (def.type === "array" && def.element) {
+    patchRecordSchemas(def.element);
+  }
+  if (def.type === "union" && def.options) {
+    def.options.forEach(patchRecordSchemas);
+  }
+  if (def.type === "record") {
+    if (def.keyType) patchRecordSchemas(def.keyType);
+    if (def.valueType) patchRecordSchemas(def.valueType);
+  }
+  if (def.type === "intersection") {
+    if (def.left) patchRecordSchemas(def.left);
+    if (def.right) patchRecordSchemas(def.right);
+  }
+  if (def.type === "lazy") {
+    if (def.getter && typeof def.getter === "function") {
+      const originalGetter = def.getter;
+      def.getter = function() {
+        const innerSchema = originalGetter();
+        if (innerSchema) {
+          patchRecordSchemas(innerSchema);
+        }
+        return innerSchema;
+      };
+    }
+  }
+  if (def.innerType) {
+    patchRecordSchemas(def.innerType);
+  }
+  return schema;
+}
+function zodToJsonSchema(zodSchema, target = "jsonSchema7", strategy = "relative") {
+  const fn = "toJSONSchema";
+  if (fn in zod.z) {
+    patchRecordSchemas(zodSchema);
+    return zod.z[fn](zodSchema, {
+      unrepresentable: "any",
+      override: (ctx) => {
+        const def = ctx.zodSchema?._def || ctx.zodSchema?._zod?.def;
+        if (def && (def.typeName === "ZodDate" || def.type === "date")) {
+          ctx.jsonSchema.type = "string";
+          ctx.jsonSchema.format = "date-time";
+        }
+      }
+    });
+  } else {
+    return zodToJsonSchemaOriginal__default.default(zodSchema, {
+      $refStrategy: strategy,
+      target
+    });
+  }
+}
+
+exports.zodToJsonSchema = zodToJsonSchema;
+//# sourceMappingURL=chunk-5WM4A32G.cjs.map
+//# sourceMappingURL=chunk-5WM4A32G.cjs.map

package/dist/chunk-5WM4A32G.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/zod-to-json.ts"],"names":["z","zodToJsonSchemaOriginal"],"mappings":";;;;;;;;;;AAQA,IAAM,OAAA,GAAU,OAAO,oBAAoB,CAAA;AAO3C,SAAS,mBAAmB,MAAA,EAAkB;AAC5C,EAAA,IAAI,CAAC,MAAA,IAAU,OAAO,MAAA,KAAW,UAAU,OAAO,MAAA;AAGlD,EAAA,IAAK,MAAA,CAAe,OAAO,CAAA,EAAG,OAAO,MAAA;AACrC,EAAC,MAAA,CAAe,OAAO,CAAA,GAAI,IAAA;AAG3B,EAAA,MAAM,GAAA,GAAM,OAAO,IAAA,EAAM,GAAA;AAGzB,EAAA,IAAI,KAAK,IAAA,KAAS,QAAA,IAAY,IAAI,OAAA,IAAW,CAAC,IAAI,SAAA,EAAW;AAG3D,IAAA,GAAA,CAAI,YAAY,GAAA,CAAI,OAAA;AACpB,IAAA,GAAA,CAAI,OAAA,GAAWA,MAAU,MAAA,EAAO;AAAA,EAClC;AAGA,EAAA,IAAI,CAAC,KAAK,OAAO,MAAA;AAEjB,EAAA,IAAI,GAAA,CAAI,IAAA,KAAS,QAAA,IAAY,GAAA,CAAI,KAAA,EAAO;AACtC,IAAA,MAAM,KAAA,GAAQ,OAAO,GAAA,CAAI,KAAA,KAAU,aAAa,GAAA,CAAI,KAAA,KAAU,GAAA,CAAI,KAAA;AAClE,IAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,EAAG;AACpC,MAAA,kBAAA,CAAmB,KAAA,CAAM,GAAG,CAAC,CAAA;AAAA,IAC/B;AAAA,EACF;AAEA,EAAA,IAAI,GAAA,CAAI,IAAA,KAAS,OAAA,IAAW,GAAA,CAAI,OAAA,EAAS;AACvC,IAAA,kBAAA,CAAmB,IAAI,OAAO,CAAA;AAAA,EAChC;AAEA,EAAA,IAAI,GAAA,CAAI,IAAA,KAAS,OAAA,IAAW,GAAA,CAAI,OAAA,EAAS;AACvC,IAAA,GAAA,CAAI,OAAA,CAAQ,QAAQ,kBAAkB,CAAA;AAAA,EACxC;AAEA,EAAA,IAAI,GAAA,CAAI,SAAS,QAAA,EAAU;AACzB,IAAA,IAAI,GAAA,CAAI,OAAA,EAAS,kBAAA,CAAmB,GAAA,CAAI,OAAO,CAAA;AAC/C,IAAA,IAAI,GAAA,CAAI,SAAA,EAAW,kBAAA,CAAmB,GAAA,CAAI,SAAS,CAAA;AAAA,EACrD;AAGA,EAAA,IAAI,GAAA,CAAI,SAAS,cAAA,EAAgB;AAC/B,IAAA,IAAI,GAAA,CAAI,IAAA,EAAM,kBAAA,CAAmB,GAAA,CAAI,IAAI,CAAA;AACzC,IAAA,IAAI,GAAA,CAAI,KAAA,EAAO,kBAAA,CAAmB,GAAA,CAAI,KAAK,CAAA;AAAA,EAC7C;AAGA,EAAA,IAAI,GAAA,CAAI,SAAS,MAAA,EAAQ;AAGvB,IAAA,IAAI,GAAA,CAAI,MAAA,IAAU,OAAO,GAAA,CAAI,WAAW,UAAA,EAAY;AAClD,MAAA,MAAM,iBAAiB,GAAA,CAAI,MAAA;AAC3B,MAAA,GAAA,CAAI,SAAS,WAAY;AACvB,QAAA,MAAM,cAAc,cAAA,EAAe;AACnC,QAAA,IAAI,WAAA,EAAa;AACf,UAAA,kBAAA,CAAmB,WAAW,CAAA;AAAA,QAChC;AACA,QAAA,OAAO,WAAA;AAAA,MACT,CAAA;AAAA,IACF;AAAA,EACF;AAIA,EAAA,IAAI,IAAI,SAAA,EAAW;AACjB,IAAA,kBAAA,CAAmB,IAAI,SAAS,CAAA;AAAA,EAClC;AAEA,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,eAAA,CACd,SAAA,EACA,MAAA,GAAkB,aAAA,EAClB,WAAkD,UAAA,EAClD;AACA,EAAA,MAAM,EAAA,GAAK,cAAA;AAEX,EAAA,IAAI,MAAMA,KAAA,EAAG;AAEX,IAAA,kBAAA,CAAmB,SAAS,CAAA;AAE5B,IAAA,OAAQA,KAAA,CAAU,EAAE,CAAA,CAAE,SAAA,EAAW;AAAA,MAC/B,eAAA,EAAiB,KAAA;AAAA,MACjB,QAAA,EAAU,CAAC,GAAA,KAAa;AAEtB,QAAA,MAAM,MAAM,GAAA,CAAI,SAAA,EAAW,IAAA,IAAQ,GAAA,CAAI,WAAW,IAAA,EAAM,GAAA;AAExD,QAAA,IAAI,QAAQ,GAAA,CAAI,QAAA,KAAa,SAAA,IAAa,GAAA,CAAI,SAAS,MAAA,CAAA,EAAS;AAC9D,UAAA,GAAA,CAAI,WAAW,IAAA,GAAO,QAAA;AACtB,UAAA,GAAA,CAAI,WAAW,MAAA,GAAS,WAAA;AAAA,QAC1B;AAAA,MACF;AAAA,KACD,CAAA;AAAA,EACH,CAAA,MAAO;AAEL,IAAA,OAAOC,yCAAwB,SAAA,EAA0B;AAAA,MACvD,YAAA,EAAc,QAAA;AAAA,MACd;AAAA,KACD,CAAA;AAAA,EACH;AACF","file":"chunk-5WM4A32G.cjs","sourcesContent":["import type { JSONSchema7 } from 'json-schema';\nimport { z } from 'zod';\nimport type { ZodSchema as ZodSchemaV3 } from 'zod/v3';\nimport type { ZodType as ZodSchemaV4 } from 'zod/v4';\nimport type { Targets } from 'zod-to-json-schema';\nimport zodToJsonSchemaOriginal from 'zod-to-json-schema';\n\n// Symbol to mark schemas as already patched (for idempotency)\nconst PATCHED = Symbol('__mastra_patched__');\n\n/**\n * Recursively patch Zod v4 record schemas that are missing valueType.\n * This fixes a bug in Zod v4 where z.record(valueSchema) doesn't set def.valueType.\n * The single-arg form should set valueType but instead only sets keyType.\n */\nfunction patchRecordSchemas(schema: any): any {\n  if (!schema || typeof schema !== 'object') return schema;\n\n  // Skip if already patched (idempotency check)\n  if ((schema as any)[PATCHED]) return schema;\n  (schema as any)[PATCHED] = true;\n\n  // Check the _zod.def location (v4 structure)\n  const def = schema._zod?.def;\n\n  // Fix record schemas with missing valueType\n  if (def?.type === 'record' && def.keyType && !def.valueType) {\n    // The bug: z.record(valueSchema) puts the value in keyType instead of valueType\n    // Fix: move it to valueType and set keyType to string (the default)\n    def.valueType = def.keyType;\n    def.keyType = (z as any).string();\n  }\n\n  // Recursively patch nested schemas\n  if (!def) return schema;\n\n  if (def.type === 'object' && def.shape) {\n    const shape = typeof def.shape === 'function' ? def.shape() : def.shape;\n    for (const key of Object.keys(shape)) {\n      patchRecordSchemas(shape[key]);\n    }\n  }\n\n  if (def.type === 'array' && def.element) {\n    patchRecordSchemas(def.element);\n  }\n\n  if (def.type === 'union' && def.options) {\n    def.options.forEach(patchRecordSchemas);\n  }\n\n  if (def.type === 'record') {\n    if (def.keyType) patchRecordSchemas(def.keyType);\n    if (def.valueType) patchRecordSchemas(def.valueType);\n  }\n\n  // Handle intersection types\n  if (def.type === 'intersection') {\n    if (def.left) patchRecordSchemas(def.left);\n    if (def.right) patchRecordSchemas(def.right);\n  }\n\n  // Handle lazy types - patch the schema returned by the getter\n  if (def.type === 'lazy') {\n    // For lazy schemas, we need to patch the schema when it's accessed\n    // Store the original getter and wrap it\n    if (def.getter && typeof def.getter === 'function') {\n      const originalGetter = def.getter;\n      def.getter = function () {\n        const innerSchema = originalGetter();\n        if (innerSchema) {\n          patchRecordSchemas(innerSchema);\n        }\n        return innerSchema;\n      };\n    }\n  }\n\n  // Handle wrapper types that have innerType\n  // This covers: optional, nullable, default, catch, nullish, and any other wrappers\n  if (def.innerType) {\n    patchRecordSchemas(def.innerType);\n  }\n\n  return schema;\n}\n\nexport function zodToJsonSchema(\n  zodSchema: ZodSchemaV3 | ZodSchemaV4,\n  target: Targets = 'jsonSchema7',\n  strategy: 'none' | 'seen' | 'root' | 'relative' = 'relative',\n) {\n  const fn = 'toJSONSchema';\n\n  if (fn in z) {\n    // Zod v4 path - patch record schemas before converting\n    patchRecordSchemas(zodSchema);\n\n    return (z as any)[fn](zodSchema, {\n      unrepresentable: 'any',\n      override: (ctx: any) => {\n        // Handle both Zod v4 structures: _def directly or nested in _zod\n        const def = ctx.zodSchema?._def || ctx.zodSchema?._zod?.def;\n        // Check for date type using both possible property names\n        if (def && (def.typeName === 'ZodDate' || def.type === 'date')) {\n          ctx.jsonSchema.type = 'string';\n          ctx.jsonSchema.format = 'date-time';\n        }\n      },\n    }) as JSONSchema7;\n  } else {\n    // Zod v3 path - use the original converter\n    return zodToJsonSchemaOriginal(zodSchema as ZodSchemaV3, {\n      $refStrategy: strategy,\n      target,\n    }) as JSONSchema7;\n  }\n}\n"]}

package/dist/chunk-U2HXWNAF.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+import zodToJsonSchemaOriginal from 'zod-to-json-schema';
+
+// src/zod-to-json.ts
+var PATCHED = Symbol("__mastra_patched__");
+function patchRecordSchemas(schema) {
+  if (!schema || typeof schema !== "object") return schema;
+  if (schema[PATCHED]) return schema;
+  schema[PATCHED] = true;
+  const def = schema._zod?.def;
+  if (def?.type === "record" && def.keyType && !def.valueType) {
+    def.valueType = def.keyType;
+    def.keyType = z.string();
+  }
+  if (!def) return schema;
+  if (def.type === "object" && def.shape) {
+    const shape = typeof def.shape === "function" ? def.shape() : def.shape;
+    for (const key of Object.keys(shape)) {
+      patchRecordSchemas(shape[key]);
+    }
+  }
+  if (def.type === "array" && def.element) {
+    patchRecordSchemas(def.element);
+  }
+  if (def.type === "union" && def.options) {
+    def.options.forEach(patchRecordSchemas);
+  }
+  if (def.type === "record") {
+    if (def.keyType) patchRecordSchemas(def.keyType);
+    if (def.valueType) patchRecordSchemas(def.valueType);
+  }
+  if (def.type === "intersection") {
+    if (def.left) patchRecordSchemas(def.left);
+    if (def.right) patchRecordSchemas(def.right);
+  }
+  if (def.type === "lazy") {
+    if (def.getter && typeof def.getter === "function") {
+      const originalGetter = def.getter;
+      def.getter = function() {
+        const innerSchema = originalGetter();
+        if (innerSchema) {
+          patchRecordSchemas(innerSchema);
+        }
+        return innerSchema;
+      };
+    }
+  }
+  if (def.innerType) {
+    patchRecordSchemas(def.innerType);
+  }
+  return schema;
+}
+function zodToJsonSchema(zodSchema, target = "jsonSchema7", strategy = "relative") {
+  const fn = "toJSONSchema";
+  if (fn in z) {
+    patchRecordSchemas(zodSchema);
+    return z[fn](zodSchema, {
+      unrepresentable: "any",
+      override: (ctx) => {
+        const def = ctx.zodSchema?._def || ctx.zodSchema?._zod?.def;
+        if (def && (def.typeName === "ZodDate" || def.type === "date")) {
+          ctx.jsonSchema.type = "string";
+          ctx.jsonSchema.format = "date-time";
+        }
+      }
+    });
+  } else {
+    return zodToJsonSchemaOriginal(zodSchema, {
+      $refStrategy: strategy,
+      target
+    });
+  }
+}
+
+export { zodToJsonSchema };
+//# sourceMappingURL=chunk-U2HXWNAF.js.map
+//# sourceMappingURL=chunk-U2HXWNAF.js.map

package/dist/chunk-U2HXWNAF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/zod-to-json.ts"],"names":[],"mappings":"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","file":"chunk-U2HXWNAF.js","sourcesContent":["import type { JSONSchema7 } from 'json-schema';\nimport { z } from 'zod';\nimport type { ZodSchema as ZodSchemaV3 } from 'zod/v3';\nimport type { ZodType as ZodSchemaV4 } from 'zod/v4';\nimport type { Targets } from 'zod-to-json-schema';\nimport zodToJsonSchemaOriginal from 'zod-to-json-schema';\n\n// Symbol to mark schemas as already patched (for idempotency)\nconst PATCHED = Symbol('__mastra_patched__');\n\n/**\n * Recursively patch Zod v4 record schemas that are missing valueType.\n * This fixes a bug in Zod v4 where z.record(valueSchema) doesn't set def.valueType.\n * The single-arg form should set valueType but instead only sets keyType.\n */\nfunction patchRecordSchemas(schema: any): any {\n  if (!schema || typeof schema !== 'object') return schema;\n\n  // Skip if already patched (idempotency check)\n  if ((schema as any)[PATCHED]) return schema;\n  (schema as any)[PATCHED] = true;\n\n  // Check the _zod.def location (v4 structure)\n  const def = schema._zod?.def;\n\n  // Fix record schemas with missing valueType\n  if (def?.type === 'record' && def.keyType && !def.valueType) {\n    // The bug: z.record(valueSchema) puts the value in keyType instead of valueType\n    // Fix: move it to valueType and set keyType to string (the default)\n    def.valueType = def.keyType;\n    def.keyType = (z as any).string();\n  }\n\n  // Recursively patch nested schemas\n  if (!def) return schema;\n\n  if (def.type === 'object' && def.shape) {\n    const shape = typeof def.shape === 'function' ? def.shape() : def.shape;\n    for (const key of Object.keys(shape)) {\n      patchRecordSchemas(shape[key]);\n    }\n  }\n\n  if (def.type === 'array' && def.element) {\n    patchRecordSchemas(def.element);\n  }\n\n  if (def.type === 'union' && def.options) {\n    def.options.forEach(patchRecordSchemas);\n  }\n\n  if (def.type === 'record') {\n    if (def.keyType) patchRecordSchemas(def.keyType);\n    if (def.valueType) patchRecordSchemas(def.valueType);\n  }\n\n  // Handle intersection types\n  if (def.type === 'intersection') {\n    if (def.left) patchRecordSchemas(def.left);\n    if (def.right) patchRecordSchemas(def.right);\n  }\n\n  // Handle lazy types - patch the schema returned by the getter\n  if (def.type === 'lazy') {\n    // For lazy schemas, we need to patch the schema when it's accessed\n    // Store the original getter and wrap it\n    if (def.getter && typeof def.getter === 'function') {\n      const originalGetter = def.getter;\n      def.getter = function () {\n        const innerSchema = originalGetter();\n        if (innerSchema) {\n          patchRecordSchemas(innerSchema);\n        }\n        return innerSchema;\n      };\n    }\n  }\n\n  // Handle wrapper types that have innerType\n  // This covers: optional, nullable, default, catch, nullish, and any other wrappers\n  if (def.innerType) {\n    patchRecordSchemas(def.innerType);\n  }\n\n  return schema;\n}\n\nexport function zodToJsonSchema(\n  zodSchema: ZodSchemaV3 | ZodSchemaV4,\n  target: Targets = 'jsonSchema7',\n  strategy: 'none' | 'seen' | 'root' | 'relative' = 'relative',\n) {\n  const fn = 'toJSONSchema';\n\n  if (fn in z) {\n    // Zod v4 path - patch record schemas before converting\n    patchRecordSchemas(zodSchema);\n\n    return (z as any)[fn](zodSchema, {\n      unrepresentable: 'any',\n      override: (ctx: any) => {\n        // Handle both Zod v4 structures: _def directly or nested in _zod\n        const def = ctx.zodSchema?._def || ctx.zodSchema?._zod?.def;\n        // Check for date type using both possible property names\n        if (def && (def.typeName === 'ZodDate' || def.type === 'date')) {\n          ctx.jsonSchema.type = 'string';\n          ctx.jsonSchema.format = 'date-time';\n        }\n      },\n    }) as JSONSchema7;\n  } else {\n    // Zod v3 path - use the original converter\n    return zodToJsonSchemaOriginal(zodSchema as ZodSchemaV3, {\n      $refStrategy: strategy,\n      target,\n    }) as JSONSchema7;\n  }\n}\n"]}

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk7YUR5KZ5_cjs = require('./chunk-7YUR5KZ5.cjs');
+var chunk5WM4A32G_cjs = require('./chunk-5WM4A32G.cjs');
 var zod = require('zod');
 var ai = require('ai');
 var zodFromJsonSchema = require('zod-from-json-schema');
@@ -8,7 +8,7 @@ var zodFromJsonSchemaV3 = require('zod-from-json-schema-v3');
 var v4 = require('zod/v4');
 
 function convertZodSchemaToAISDKSchema(zodSchema, target = "jsonSchema7") {
-  const jsonSchemaToUse = chunk7YUR5KZ5_cjs.zodToJsonSchema(zodSchema, target);
+  const jsonSchemaToUse = chunk5WM4A32G_cjs.zodToJsonSchema(zodSchema, target);
   return ai.jsonSchema(jsonSchemaToUse, {
     validate: (value) => {
       const result = zodSchema.safeParse(value);
@@ -55,7 +55,7 @@ function applyCompatLayer({
     }
   }
   if (mode === "jsonSchema") {
-    return chunk7YUR5KZ5_cjs.zodToJsonSchema(zodSchema, "jsonSchema7");
+    return chunk5WM4A32G_cjs.zodToJsonSchema(zodSchema, "jsonSchema7");
   } else {
     return convertZodSchemaToAISDKSchema(zodSchema);
   }
@@ -231,8 +231,8 @@ var SchemaCompatLayer = class {
    * @returns The updated description with constraints, or undefined if no constraints
    */
   mergeParameterDescription(description, constraints) {
-    if (Object.keys(constraints).length > 0) {
-      return (description ? description + "\n" : "") + JSON.stringify(constraints);
+    if (constraints.length > 0) {
+      return (description ? description + "\n" : "") + `constraints: ${constraints.join(`, `)}`;
     } else {
       return description;
     }
@@ -262,24 +262,24 @@ var SchemaCompatLayer = class {
     const zodArrayDef = value._def;
     const processedType = this.processZodType(zodArrayDef.type);
     let result = zod.z.array(processedType);
-    const constraints = {};
+    const constraints = [];
     if (zodArrayDef.minLength?.value !== void 0) {
       if (handleChecks.includes("min")) {
-        constraints.minLength = zodArrayDef.minLength.value;
+        constraints.push(`minimum length ${zodArrayDef.minLength.value}`);
       } else {
         result = result.min(zodArrayDef.minLength.value);
       }
     }
     if (zodArrayDef.maxLength?.value !== void 0) {
       if (handleChecks.includes("max")) {
-        constraints.maxLength = zodArrayDef.maxLength.value;
+        constraints.push(`maximum length ${zodArrayDef.maxLength.value}`);
       } else {
         result = result.max(zodArrayDef.maxLength.value);
       }
     }
     if (zodArrayDef.exactLength?.value !== void 0) {
       if (handleChecks.includes("length")) {
-        constraints.exactLength = zodArrayDef.exactLength.value;
+        constraints.push(`exact length ${zodArrayDef.exactLength.value}`);
       } else {
         result = result.length(zodArrayDef.exactLength.value);
       }
@@ -314,7 +314,7 @@ var SchemaCompatLayer = class {
    * @returns The processed Zod string
    */
   defaultZodStringHandler(value, handleChecks = ALL_STRING_CHECKS) {
-    const constraints = {};
+    const constraints = [];
     const checks = value._def.checks || [];
     const newChecks = [];
     for (const check of checks) {
@@ -322,38 +322,20 @@ var SchemaCompatLayer = class {
         if (handleChecks.includes(check.kind)) {
           switch (check.kind) {
             case "regex": {
-              constraints.regex = {
-                pattern: check.regex.source,
-                flags: check.regex.flags
-              };
-              break;
-            }
-            case "emoji": {
-              constraints.emoji = true;
-              break;
-            }
-            case "email": {
-              constraints.email = true;
-              break;
-            }
-            case "url": {
-              constraints.url = true;
-              break;
-            }
-            case "uuid": {
-              constraints.uuid = true;
+              constraints.push(`input must match this regex ${check.regex.source}`);
               break;
             }
+            case "emoji":
+            case "email":
+            case "url":
+            case "uuid":
             case "cuid": {
-              constraints.cuid = true;
-              break;
-            }
-            case "min": {
-              constraints.minLength = check.value;
+              constraints.push(`a valid ${check.kind}`);
               break;
             }
+            case "min":
             case "max": {
-              constraints.maxLength = check.value;
+              constraints.push(`${check.kind}imum length ${check.value}`);
               break;
             }
           }
@@ -380,7 +362,7 @@ var SchemaCompatLayer = class {
    * @returns The processed Zod number
    */
   defaultZodNumberHandler(value, handleChecks = ALL_NUMBER_CHECKS) {
-    const constraints = {};
+    const constraints = [];
     const checks = value._def.checks || [];
     const newChecks = [];
     for (const check of checks) {
@@ -389,20 +371,20 @@ var SchemaCompatLayer = class {
           switch (check.kind) {
             case "min":
               if (check.inclusive) {
-                constraints.gte = check.value;
+                constraints.push(`greater than or equal to ${check.value}`);
               } else {
-                constraints.gt = check.value;
+                constraints.push(`greater than ${check.value}`);
               }
               break;
             case "max":
               if (check.inclusive) {
-                constraints.lte = check.value;
+                constraints.push(`lower than or equal to ${check.value}`);
               } else {
-                constraints.lt = check.value;
+                constraints.push(`lower than ${check.value}`);
               }
               break;
             case "multipleOf": {
-              constraints.multipleOf = check.value;
+              constraints.push(`multiple of ${check.value}`);
               break;
             }
           }
@@ -437,7 +419,7 @@ var SchemaCompatLayer = class {
    * @returns A Zod string schema representing the date in ISO format
    */
   defaultZodDateHandler(value) {
-    const constraints = {};
+    const constraints = [];
     const checks = value._def.checks || [];
     for (const check of checks) {
       if ("kind" in check) {
@@ -445,19 +427,19 @@ var SchemaCompatLayer = class {
           case "min":
             const minDate = new Date(check.value);
             if (!isNaN(minDate.getTime())) {
-              constraints.minDate = minDate.toISOString();
+              constraints.push(`Date must be newer than ${minDate.toISOString()} (ISO)`);
             }
             break;
           case "max":
             const maxDate = new Date(check.value);
             if (!isNaN(maxDate.getTime())) {
-              constraints.maxDate = maxDate.toISOString();
+              constraints.push(`Date must be older than ${maxDate.toISOString()} (ISO)`);
             }
             break;
         }
       }
     }
-    constraints.dateFormat = "date-time";
+    constraints.push(`Date format is date-time`);
     let result = zod.z.string().describe("date-time");
     const description = this.mergeParameterDescription(value.description, constraints);
     if (description) {
@@ -665,8 +647,8 @@ var SchemaCompatLayer2 = class {
    * @returns The updated description with constraints, or undefined if no constraints
    */
   mergeParameterDescription(description, constraints) {
-    if (Object.keys(constraints).length > 0) {
-      return (description ? description + "\n" : "") + JSON.stringify(constraints);
+    if (constraints.length > 0) {
+      return (description ? description + "\n" : "") + `constraints: ${constraints.join(`, `)}`;
     } else {
       return description;
     }
@@ -696,26 +678,26 @@ var SchemaCompatLayer2 = class {
     const zodArrayDef = value._zod.def;
     const processedType = this.processZodType(zodArrayDef.element);
     let result = v4.z.array(processedType);
-    const constraints = {};
+    const constraints = [];
     if (zodArrayDef.checks) {
       for (const check of zodArrayDef.checks) {
         if (check._zod.def.check === "min_length") {
           if (handleChecks.includes("min")) {
-            constraints.minLength = check._zod.def.minimum;
+            constraints.push(`minimum length ${check._zod.def.minimum}`);
           } else {
             result = result.min(check._zod.def.minimum);
           }
         }
         if (check._zod.def.check === "max_length") {
           if (handleChecks.includes("max")) {
-            constraints.maxLength = check._zod.def.maximum;
+            constraints.push(`maximum length ${check._zod.def.maximum}`);
           } else {
             result = result.max(check._zod.def.maximum);
           }
         }
         if (check._zod.def.check === "length_equals") {
           if (handleChecks.includes("length")) {
-            constraints.exactLength = check._zod.def.length;
+            constraints.push(`exact length ${check._zod.def.length}`);
           } else {
             result = result.length(check._zod.def.length);
           }
@@ -754,7 +736,7 @@ var SchemaCompatLayer2 = class {
    * @returns The processed Zod string
    */
   defaultZodStringHandler(value, handleChecks = ALL_STRING_CHECKS2) {
-    const constraints = {};
+    const constraints = [];
     const checks = value._zod.def.checks || [];
     const newChecks = [];
     if (checks) {
@@ -762,36 +744,23 @@ var SchemaCompatLayer2 = class {
         if (handleChecks.includes(check._zod.def.check)) {
           switch (check._zod.def.check) {
             case "min_length":
-              constraints.minLength = check._zod.def.minimum;
+              constraints.push(`minimum length ${check._zod.def.minimum}`);
               break;
             case "max_length":
-              constraints.maxLength = check._zod.def.maximum;
+              constraints.push(`maximum length ${check._zod.def.maximum}`);
               break;
             case "string_format":
               {
                 switch (check._zod.def.format) {
                   case "email":
-                    constraints.email = true;
-                    break;
                   case "url":
-                    constraints.url = true;
-                    break;
                   case "emoji":
-                    constraints.emoji = true;
-                    break;
                   case "uuid":
-                    constraints.uuid = true;
-                    break;
                   case "cuid":
-                    constraints.cuid = true;
+                    constraints.push(`a valid ${check._zod.def.format}`);
                     break;
                   case "regex":
-                    constraints.regex = {
-                      // @ts-expect-error - fix later
-                      pattern: check._zod.def.pattern,
-                      // @ts-expect-error - fix later
-                      flags: check._zod.def.flags
-                    };
+                    constraints.push(`input must match this regex ${check._zod.def.pattern}`);
                     break;
                 }
               }
@@ -822,7 +791,7 @@ var SchemaCompatLayer2 = class {
    * @returns The processed Zod number
    */
   defaultZodNumberHandler(value, handleChecks = ALL_NUMBER_CHECKS2) {
-    const constraints = {};
+    const constraints = [];
     const checks = value._zod.def.checks || [];
     const newChecks = [];
     if (checks) {
@@ -831,20 +800,20 @@ var SchemaCompatLayer2 = class {
           switch (check._zod.def.check) {
             case "greater_than":
               if (check._zod.def.inclusive) {
-                constraints.gte = check._zod.def.value;
+                constraints.push(`greater than or equal to ${check._zod.def.value}`);
               } else {
-                constraints.gt = check._zod.def.value;
+                constraints.push(`greater than ${check._zod.def.value}`);
               }
               break;
             case "less_than":
               if (check._zod.def.inclusive) {
-                constraints.lte = check._zod.def.value;
+                constraints.push(`lower than or equal to ${check._zod.def.value}`);
               } else {
-                constraints.lt = check._zod.def.value;
+                constraints.push(`lower than ${check._zod.def.value}`);
               }
               break;
             case "multiple_of": {
-              constraints.multipleOf = check._zod.def.value;
+              constraints.push(`multiple of ${check._zod.def.value}`);
               break;
             }
           }
@@ -881,7 +850,7 @@ var SchemaCompatLayer2 = class {
    * @returns A Zod string schema representing the date in ISO format
    */
   defaultZodDateHandler(value) {
-    const constraints = {};
+    const constraints = [];
     const checks = value._zod.def.checks || [];
     if (checks) {
       for (const check of checks) {
@@ -889,19 +858,19 @@ var SchemaCompatLayer2 = class {
           case "less_than":
             const minDate = new Date(check._zod.def.value);
             if (!isNaN(minDate.getTime())) {
-              constraints.minDate = minDate.toISOString();
+              constraints.push(`Date must be newer than ${minDate.toISOString()} (ISO)`);
             }
             break;
           case "greater_than":
             const maxDate = new Date(check._zod.def.value);
             if (!isNaN(maxDate.getTime())) {
-              constraints.maxDate = maxDate.toISOString();
+              constraints.push(`Date must be older than ${maxDate.toISOString()} (ISO)`);
             }
             break;
         }
       }
     }
-    constraints.dateFormat = "date-time";
+    constraints.push(`Date format is date-time`);
     let result = v4.z.string().describe("date-time");
     const description = this.mergeParameterDescription(value.description, constraints);
     if (description) {
@@ -1370,9 +1339,9 @@ var OpenAIReasoningSchemaCompatLayer = class extends SchemaCompatLayer3 {
       const defaultDef = value._def;
       const innerType = defaultDef.innerType;
       const defaultValue = typeof defaultDef.defaultValue === "function" ? defaultDef.defaultValue() : defaultDef.defaultValue;
-      const constraints = {};
+      const constraints = [];
       if (defaultValue !== void 0) {
-        constraints.defaultValue = defaultValue;
+        constraints.push(`the default value is ${defaultValue}`);
       }
       const description = this.mergeParameterDescription(value.description, constraints);
       let result = this.processZodType(innerType);