@mastra/schema-compat 0.0.0-add-save-score-validation-on-stores-20250911031242

package/CHANGELOG.md

@@ -0,0 +1,177 @@
+# @mastra/schema-compat
+
+## 0.0.0-add-save-score-validation-on-stores-20250911031242
+
+### Patch Changes
+
+- Change SchemaCompat zodToJsonSchema ref strategy from none to relative, leading to less schema warnings and smaller converted schema sizes ([#7697](https://github.com/mastra-ai/mastra/pull/7697))
+
+## 0.11.2
+
+### Patch Changes
+
+- ab48c97: dependencies updates:
+  - Updated dependency [`zod-to-json-schema@^3.24.6` ↗︎](https://www.npmjs.com/package/zod-to-json-schema/v/3.24.6) (from `^3.24.5`, in `dependencies`)
+- 637f323: Fix issue with some compilers and calling zod v4's toJSONSchema function
+- de3cbc6: Update the `package.json` file to include additional fields like `repository`, `homepage` or `files`.
+- 45e4d39: Try fixing the `Attempted import error: 'z'.'toJSONSchema' is not exported from 'zod'` error by tricking the compiler
+
+## 0.11.2-alpha.3
+
+### Patch Changes
+
+- [#7350](https://github.com/mastra-ai/mastra/pull/7350) [`45e4d39`](https://github.com/mastra-ai/mastra/commit/45e4d391a2a09fc70c48e4d60f505586ada1ba0e) Thanks [@LekoArts](https://github.com/LekoArts)! - Try fixing the `Attempted import error: 'z'.'toJSONSchema' is not exported from 'zod'` error by tricking the compiler
+
+## 0.11.2-alpha.2
+
+### Patch Changes
+
+- [#7343](https://github.com/mastra-ai/mastra/pull/7343) [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e) Thanks [@LekoArts](https://github.com/LekoArts)! - Update the `package.json` file to include additional fields like `repository`, `homepage` or `files`.
+
+## 0.11.2-alpha.1
+
+### Patch Changes
+
+- [#5816](https://github.com/mastra-ai/mastra/pull/5816) [`ab48c97`](https://github.com/mastra-ai/mastra/commit/ab48c979098ea571faf998a55d3a00e7acd7a715) Thanks [@dane-ai-mastra](https://github.com/apps/dane-ai-mastra)! - dependencies updates:
+  - Updated dependency [`zod-to-json-schema@^3.24.6` ↗︎](https://www.npmjs.com/package/zod-to-json-schema/v/3.24.6) (from `^3.24.5`, in `dependencies`)
+
+## 0.11.2-alpha.0
+
+### Patch Changes
+
+- [#7121](https://github.com/mastra-ai/mastra/pull/7121) [`637f323`](https://github.com/mastra-ai/mastra/commit/637f32371d79a8f78c52c0d53411af0915fcec67) Thanks [@DanielSLew](https://github.com/DanielSLew)! - Fix issue with some compilers and calling zod v4's toJSONSchema function
+
+## 0.11.1
+
+### Patch Changes
+
+- [`c6113ed`](https://github.com/mastra-ai/mastra/commit/c6113ed7f9df297e130d94436ceee310273d6430) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix peerdpes for @mastra/core
+
+## 0.11.0
+
+### Minor Changes
+
+- [#7032](https://github.com/mastra-ai/mastra/pull/7032) [`1191ce9`](https://github.com/mastra-ai/mastra/commit/1191ce946b40ed291e7877a349f8388e3cff7e5c) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump zod peerdep to 3.25.0 to support both v3/v4
+
+### Patch Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix exportsmap
+
+- [#6982](https://github.com/mastra-ai/mastra/pull/6982) [`94e9f54`](https://github.com/mastra-ai/mastra/commit/94e9f547d66ef7cd01d9075ab53b5ca9a1cae100) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix AI peerdeps for NPM install
+
+- [#6944](https://github.com/mastra-ai/mastra/pull/6944) [`a93f3ba`](https://github.com/mastra-ai/mastra/commit/a93f3ba05eef4cf17f876d61d29cf0841a9e70b7) Thanks [@wardpeet](https://github.com/wardpeet)! - Add support for zod v4
+
+## 0.11.0-alpha.2
+
+### Minor Changes
+
+- [#7032](https://github.com/mastra-ai/mastra/pull/7032) [`1191ce9`](https://github.com/mastra-ai/mastra/commit/1191ce946b40ed291e7877a349f8388e3cff7e5c) Thanks [@wardpeet](https://github.com/wardpeet)! - Bump zod peerdep to 3.25.0 to support both v3/v4
+
+## 0.10.6-alpha.1
+
+### Patch Changes
+
+- [#7028](https://github.com/mastra-ai/mastra/pull/7028) [`da58ccc`](https://github.com/mastra-ai/mastra/commit/da58ccc1f2ac33da0cb97b00443fc6208b45bdec) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix exportsmap
+
+## 0.10.6-alpha.0
+
+### Patch Changes
+
+- [#6982](https://github.com/mastra-ai/mastra/pull/6982) [`94e9f54`](https://github.com/mastra-ai/mastra/commit/94e9f547d66ef7cd01d9075ab53b5ca9a1cae100) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix AI peerdeps for NPM install
+
+- [#6944](https://github.com/mastra-ai/mastra/pull/6944) [`a93f3ba`](https://github.com/mastra-ai/mastra/commit/a93f3ba05eef4cf17f876d61d29cf0841a9e70b7) Thanks [@wardpeet](https://github.com/wardpeet)! - Add support for zod v4
+
+## 0.10.7
+
+### Patch Changes
+
+- dd94a26: Dont rely on the full language model for schema compat
+- 2fff911: Fix vnext working memory tool schema when model is incompatible with schema
+- ae2eb63: Handle regex checks better, return description as a string rather than an object with pattern and flags.
+
+## 0.10.7-alpha.1
+
+### Patch Changes
+
+- ae2eb63: Handle regex checks better, return description as a string rather than an object with pattern and flags.
+
+## 0.10.7-alpha.0
+
+### Patch Changes
+
+- dd94a26: Dont rely on the full language model for schema compat
+- 2fff911: Fix vnext working memory tool schema when model is incompatible with schema
+
+## 0.10.6
+
+### Patch Changes
+
+- 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
+
+## 0.10.6-alpha.0
+
+### Patch Changes
+
+- 4a406ec: fixes TypeScript declaration file imports to ensure proper ESM compatibility
+
+## 0.10.5
+
+### Patch Changes
+
+- 4da943f: Fix Cannot read properties of undefined (reading 'typeName') in schema compat check
+
+## 0.10.5-alpha.0
+
+### Patch Changes
+
+- 4da943f: Fix Cannot read properties of undefined (reading 'typeName') in schema compat check
+
+## 0.10.4
+
+### Patch Changes
+
+- 0c85311: Fix Google models ZodNull tool schema handling
+
+## 0.10.4-alpha.0
+
+### Patch Changes
+
+- 0c85311: Fix Google models ZodNull tool schema handling
+
+## 0.10.3
+
+### Patch Changes
+
+- 98bbe5a: Claude cannot handle tuple schemas now.
+- a853c43: Allow for object.passthrough in schema compat (aka MCP tool support).
+
+## 0.10.3-alpha.1
+
+### Patch Changes
+
+- a853c43: Allow for object.passthrough in schema compat (aka MCP tool support).
+
+## 0.10.3-alpha.0
+
+### Patch Changes
+
+- 98bbe5a: Claude cannot handle tuple schemas now.
+
+## 0.10.2
+
+### Patch Changes
+
+- f6fd25f: Updates @mastra/schema-compat to allow all zod schemas. Uses @mastra/schema-compat to apply schema transformations to agent output schema.
+- f9816ae: Create @mastra/schema-compat package to extract the schema compatibility layer to be used outside of mastra
+
+## 0.10.2-alpha.3
+
+### Patch Changes
+
+- f6fd25f: Updates @mastra/schema-compat to allow all zod schemas. Uses @mastra/schema-compat to apply schema transformations to agent output schema.
+
+## 0.10.2-alpha.2
+
+### Patch Changes
+
+- f9816ae: Create @mastra/schema-compat package to extract the schema compatibility layer to be used outside of mastra

package/LICENSE.md

@@ -0,0 +1,15 @@
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,144 @@
+# @mastra/schema-compat
+
+Schema compatibility layer for Mastra.ai that provides compatibility fixes for different AI model providers when using Zod schemas with tools.
+
+## Installation
+
+```bash
+pnpm add @mastra/schema-compat
+```
+
+## Usage
+
+### Basic Usage
+
+The package provides a base `SchemaCompatLayer` class that you can extend to create custom compatibility layers for different AI model providers:
+
+```typescript
+import { SchemaCompatLayer } from '@mastra/schema-compat';
+import type { LanguageModelV1 } from 'ai';
+
+class MyCustomCompat extends SchemaCompatLayer {
+  constructor(model: LanguageModelV1) {
+    super(model);
+  }
+
+  shouldApply(): boolean {
+    return this.getModel().provider === 'my-provider';
+  }
+
+  getSchemaTarget() {
+    return 'jsonSchema7';
+  }
+
+  processZodType<T extends z.AnyZodObject>(value: z.ZodTypeAny): ShapeValue<T> {
+    // Your custom processing logic here
+    return value;
+  }
+}
+```
+
+### Schema Processing
+
+The package includes pre-built compatibility layers for popular AI providers:
+
+Use the `applyCompatLayer` function to automatically apply the right compatibility layer:
+
+```typescript
+import { applyCompatLayer, OpenAISchemaCompatLayer, AnthropicSchemaCompatLayer } from '@mastra/schema-compat';
+import { yourCustomCompatibilityLayer } from './customCompatibilityLayer';
+import { z } from 'zod';
+
+const schema = z.object({
+  name: z.string().email(),
+  preferences: z.array(z.string()).min(1),
+});
+
+const compatLayers = [
+  new OpenAISchemaCompatLayer(model),
+  new AnthropicSchemaCompatLayer(model),
+  new yourCustomCompatibilityLayer(model),
+];
+
+// Automatically applies the first matching compatibility
+const result = applyCompatLayer({
+  schema,
+  compatLayers,
+  mode: 'aiSdkSchema', // or 'jsonSchema'
+});
+```
+
+### Schema Building Utilities
+
+The package also provides utility functions for schema conversion:
+
+```typescript
+import { convertZodSchemaToAISDKSchema, convertSchemaToZod } from '@mastra/schema-compat';
+import { z } from 'zod';
+import { jsonSchema } from 'ai';
+
+const zodSchema = z.object({
+  name: z.string(),
+  age: z.number(),
+});
+
+// Convert Zod to AI SDK Schema
+const aiSchema = convertZodSchemaToAISDKSchema(zodSchema);
+
+// Convert AI SDK Schema back to Zod
+const aiSdkSchema = jsonSchema({
+  type: 'object',
+  properties: {
+    name: { type: 'string' },
+  },
+});
+const backToZod = convertSchemaToZod(aiSdkSchema);
+```
+
+## API Reference
+
+### Classes
+
+- `SchemaCompatLayer` - Base abstract class for creating compatibility layers
+- `AnthropicSchemaCompatLayer` - Compatibility for Anthropic Claude models
+- `OpenAISchemaCompatLayer` - Compatibility for OpenAI models (without structured outputs)
+- `OpenAIReasoningSchemaCompatLayer` - Compatibility for OpenAI reasoning models (o1 series)
+- `GoogleSchemaCompatLayer` - Compatibility for Google Gemini models
+- `DeepSeekSchemaCompatLayer` - Compatibility for DeepSeek models
+- `MetaSchemaCompatLayer` - Compatibility for Meta Llama models
+
+### Functions
+
+- `applyCompatLayer(options)` - Process schema with automatic compatibility detection
+- `convertZodSchemaToAISDKSchema(zodSchema, target?)` - Convert Zod schema to AI SDK Schema
+- `convertSchemaToZod(schema)` - Convert AI SDK Schema to Zod schema
+
+### Types and Constants
+
+- `StringCheckType`, `NumberCheckType`, `ArrayCheckType` - Check types for validation
+- `UnsupportedZodType`, `SupportedZodType`, `AllZodType` - Zod type classifications
+- `ZodShape`, `ShapeKey`, `ShapeValue` - Utility types for Zod schemas
+- `ALL_STRING_CHECKS`, `ALL_NUMBER_CHECKS`, `ALL_ARRAY_CHECKS` - Validation constraint arrays
+- `SUPPORTED_ZOD_TYPES`, `UNSUPPORTED_ZOD_TYPES` - Type classification arrays
+
+## Provider-Specific Behavior
+
+Different AI providers have varying levels of support for JSON Schema features. This package handles these differences automatically:
+
+- **OpenAI**: Removes certain string validations for models without structured outputs
+- **Anthropic**: Handles complex nested schemas with proper constraint descriptions
+- **Google**: Uses OpenAPI 3.0 schema format for better compatibility
+- **DeepSeek**: Converts advanced string patterns to descriptions
+- **Meta**: Optimizes array and union type handling
+
+## Testing
+
+The package includes comprehensive tests covering all functionality:
+
+```bash
+# Run tests
+pnpm test
+
+# Run tests in watch mode
+pnpm test --watch
+```

package/dist/chunk-7YUR5KZ5.cjs

@@ -0,0 +1,34 @@
+'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
+function zodToJsonSchema(zodSchema, target = "jsonSchema7", strategy = "relative") {
+  const fn = "toJSONSchema";
+  if (fn in zod.z) {
+    return zod.z[fn](zodSchema, {
+      unrepresentable: "any",
+      override: (ctx) => {
+        const def = ctx.zodSchema?._zod?.def;
+        if (def && 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-7YUR5KZ5.cjs.map
+//# sourceMappingURL=chunk-7YUR5KZ5.cjs.map

package/dist/chunk-7YUR5KZ5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/zod-to-json.ts"],"names":["z","zodToJsonSchemaOriginal"],"mappings":";;;;;;;;;;AAOO,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,OAAQA,KAAA,CAAU,EAAE,CAAA,CAAE,SAAA,EAAW;AAAA,MAC/B,eAAA,EAAiB,KAAA;AAAA,MACjB,QAAA,EAAU,CAAC,GAAA,KAAa;AAEtB,QAAA,MAAM,GAAA,GAAM,GAAA,CAAI,SAAA,EAAW,IAAA,EAAM,GAAA;AACjC,QAAA,IAAI,GAAA,IAAO,GAAA,CAAI,IAAA,KAAS,MAAA,EAAQ;AAC9B,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;AACL,IAAA,OAAOC,yCAAwB,SAAA,EAA0B;AAAA,MACvD,YAAA,EAAc,QAAA;AAAA,MACd;AAAA,KACD,CAAA;AAAA,EACH;AACF","file":"chunk-7YUR5KZ5.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\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    // Use dynamic property access to avoid import errors in Zod v3\n    return (z as any)[fn](zodSchema, {\n      unrepresentable: 'any',\n      override: (ctx: any) => {\n        // Safe access to handle cases where _zod might be undefined\n        const def = ctx.zodSchema?._zod?.def;\n        if (def && def.type === 'date') {\n          ctx.jsonSchema.type = 'string';\n          ctx.jsonSchema.format = 'date-time';\n        }\n      },\n    }) as JSONSchema7;\n  } else {\n    return zodToJsonSchemaOriginal(zodSchema as ZodSchemaV3, {\n      $refStrategy: strategy,\n      target,\n    }) as JSONSchema7;\n  }\n}\n"]}

package/dist/chunk-GWTUXMDD.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import zodToJsonSchemaOriginal from 'zod-to-json-schema';
+
+// src/zod-to-json.ts
+function zodToJsonSchema(zodSchema, target = "jsonSchema7", strategy = "relative") {
+  const fn = "toJSONSchema";
+  if (fn in z) {
+    return z[fn](zodSchema, {
+      unrepresentable: "any",
+      override: (ctx) => {
+        const def = ctx.zodSchema?._zod?.def;
+        if (def && def.type === "date") {
+          ctx.jsonSchema.type = "string";
+          ctx.jsonSchema.format = "date-time";
+        }
+      }
+    });
+  } else {
+    return zodToJsonSchemaOriginal(zodSchema, {
+      $refStrategy: strategy,
+      target
+    });
+  }
+}
+
+export { zodToJsonSchema };
+//# sourceMappingURL=chunk-GWTUXMDD.js.map
+//# sourceMappingURL=chunk-GWTUXMDD.js.map

package/dist/chunk-GWTUXMDD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/zod-to-json.ts"],"names":[],"mappings":";;;;AAOO,SAAS,eAAA,CACd,SAAA,EACA,MAAA,GAAkB,aAAA,EAClB,WAAkD,UAAA,EAClD;AACA,EAAA,MAAM,EAAA,GAAK,cAAA;AAEX,EAAA,IAAI,MAAM,CAAA,EAAG;AAEX,IAAA,OAAQ,CAAA,CAAU,EAAE,CAAA,CAAE,SAAA,EAAW;AAAA,MAC/B,eAAA,EAAiB,KAAA;AAAA,MACjB,QAAA,EAAU,CAAC,GAAA,KAAa;AAEtB,QAAA,MAAM,GAAA,GAAM,GAAA,CAAI,SAAA,EAAW,IAAA,EAAM,GAAA;AACjC,QAAA,IAAI,GAAA,IAAO,GAAA,CAAI,IAAA,KAAS,MAAA,EAAQ;AAC9B,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;AACL,IAAA,OAAO,wBAAwB,SAAA,EAA0B;AAAA,MACvD,YAAA,EAAc,QAAA;AAAA,MACd;AAAA,KACD,CAAA;AAAA,EACH;AACF","file":"chunk-GWTUXMDD.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\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    // Use dynamic property access to avoid import errors in Zod v3\n    return (z as any)[fn](zodSchema, {\n      unrepresentable: 'any',\n      override: (ctx: any) => {\n        // Safe access to handle cases where _zod might be undefined\n        const def = ctx.zodSchema?._zod?.def;\n        if (def && def.type === 'date') {\n          ctx.jsonSchema.type = 'string';\n          ctx.jsonSchema.format = 'date-time';\n        }\n      },\n    }) as JSONSchema7;\n  } else {\n    return zodToJsonSchemaOriginal(zodSchema as ZodSchemaV3, {\n      $refStrategy: strategy,\n      target,\n    }) as JSONSchema7;\n  }\n}\n"]}