@mastra/schema-compat 0.0.0-ai-v5-20250801192614 → 0.0.0-allow-to-pass-a-mastra-url-instance-20251105224938

package/dist/schema-compatibility-v4.d.ts

@@ -0,0 +1,278 @@
+import { z, ZodOptional, ZodObject, ZodArray, ZodUnion, ZodString, ZodNumber, ZodDate, ZodDefault, ZodNull } from 'zod/v4';
+import type { ZodAny, ZodType } from 'zod/v4';
+import type { Targets } from 'zod-to-json-schema';
+import type { JSONSchema7 } from './json-schema.js';
+import type { SchemaCompatLayer as ParentSchemaCompatLayer } from './schema-compatibility.js';
+import type { Schema, ModelInformation } from './types.js';
+/**
+ * All supported string validation check types that can be processed or converted to descriptions.
+ * @constant
+ */
+export declare const ALL_STRING_CHECKS: readonly ["regex", "emoji", "email", "url", "uuid", "cuid", "min_length", "max_length", "string_format"];
+/**
+ * All supported number validation check types that can be processed or converted to descriptions.
+ * @constant
+ */
+export declare const ALL_NUMBER_CHECKS: readonly ["greater_than", "less_than", "multiple_of"];
+/**
+ * All supported array validation check types that can be processed or converted to descriptions.
+ * @constant
+ */
+export declare const ALL_ARRAY_CHECKS: readonly ["min", "max", "length"];
+/**
+ * Zod types that are not supported by most AI model providers and should be avoided.
+ * @constant
+ */
+export declare const UNSUPPORTED_ZOD_TYPES: readonly ["ZodIntersection", "ZodNever", "ZodNull", "ZodTuple", "ZodUndefined"];
+/**
+ * Zod types that are generally supported by AI model providers.
+ * @constant
+ */
+export declare const SUPPORTED_ZOD_TYPES: readonly ["ZodObject", "ZodArray", "ZodUnion", "ZodString", "ZodNumber", "ZodDate", "ZodAny", "ZodDefault"];
+/**
+ * All Zod types (both supported and unsupported).
+ * @constant
+ */
+export declare const ALL_ZOD_TYPES: readonly ["ZodObject", "ZodArray", "ZodUnion", "ZodString", "ZodNumber", "ZodDate", "ZodAny", "ZodDefault", "ZodIntersection", "ZodNever", "ZodNull", "ZodTuple", "ZodUndefined"];
+/**
+ * Type representing string validation checks.
+ */
+export type StringCheckType = (typeof ALL_STRING_CHECKS)[number];
+/**
+ * Type representing number validation checks.
+ */
+export type NumberCheckType = (typeof ALL_NUMBER_CHECKS)[number];
+/**
+ * Type representing array validation checks.
+ */
+export type ArrayCheckType = (typeof ALL_ARRAY_CHECKS)[number];
+/**
+ * Type representing unsupported Zod schema types.
+ */
+export type UnsupportedZodType = (typeof UNSUPPORTED_ZOD_TYPES)[number];
+/**
+ * Type representing supported Zod schema types.
+ */
+export type SupportedZodType = (typeof SUPPORTED_ZOD_TYPES)[number];
+/**
+ * Type representing all Zod schema types (supported and unsupported).
+ */
+export type AllZodType = (typeof ALL_ZOD_TYPES)[number];
+/**
+ * Utility type to extract the shape of a Zod object schema.
+ */
+export type ZodShape<T extends z.ZodObject<any, any>> = T['shape'];
+/**
+ * Utility type to extract the keys from a Zod object shape.
+ */
+export type ShapeKey<T extends z.ZodObject<any, any>> = keyof ZodShape<T>;
+/**
+ * Utility type to extract the value types from a Zod object shape.
+ */
+export type ShapeValue<T extends z.ZodObject<any, any>> = ZodShape<T>[ShapeKey<T>];
+type ConstraintHelperText = string[];
+/**
+ * Abstract base class for creating schema compatibility layers for different AI model providers.
+ *
+ * This class provides a framework for transforming Zod schemas to work with specific AI model
+ * provider requirements and limitations. Each provider may have different support levels for
+ * JSON Schema features, validation constraints, and data types.
+ *
+ *
+ * @example
+ * ```typescript
+ * import { SchemaCompatLayer } from '@mastra/schema-compat';
+ * import type { LanguageModelV1 } from 'ai';
+ *
+ * class CustomProviderCompat extends SchemaCompatLayer {
+ *   constructor(model: LanguageModelV1) {
+ *     super(model);
+ *   }
+ *
+ *   shouldApply(): boolean {
+ *     return this.getModel().provider === 'custom-provider';
+ *   }
+ *
+ *   getSchemaTarget() {
+ *     return 'jsonSchema7';
+ *   }
+ *
+ *   processZodType<T extends z.AnyZodObject>(value: z.ZodAny): ShapeValue<T> {
+ *     // Custom processing logic for this provider
+ *     switch (value._def.typeName) {
+ *       case 'ZodString':
+ *         return this.defaultZodStringHandler(value, ['email', 'url']);
+ *       default:
+ *         return this.defaultUnsupportedZodTypeHandler(value);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class SchemaCompatLayer {
+    private model;
+    private parent;
+    /**
+     * Creates a new schema compatibility instance.
+     *
+     * @param model - The language model this compatibility layer applies to
+     */
+    constructor(model: ModelInformation, parent: ParentSchemaCompatLayer);
+    /**
+     * Gets the language model associated with this compatibility layer.
+     *
+     * @returns The language model instance
+     */
+    getModel(): ModelInformation;
+    getUnsupportedZodTypes(): readonly string[];
+    /**
+     * Type guard for optional Zod types
+     */
+    isOptional(v: ZodAny | ZodOptional<any>): v is ZodOptional<any>;
+    /**
+     * Type guard for object Zod types
+     */
+    isObj(v: ZodAny | ZodObject<any, any>): v is ZodObject<any, any>;
+    /**
+     * Type guard for null Zod types
+     */
+    isNull(v: ZodAny | ZodNull): v is ZodNull;
+    /**
+     * Type guard for array Zod types
+     */
+    isArr(v: ZodAny | ZodArray<any>): v is ZodArray<any>;
+    /**
+     * Type guard for union Zod types
+     */
+    isUnion(v: ZodAny | ZodUnion<[ZodAny, ...ZodAny[]]>): v is ZodUnion<[ZodAny, ...ZodAny[]]>;
+    /**
+     * Type guard for string Zod types
+     */
+    isString(v: ZodAny | ZodString): v is ZodString;
+    /**
+     * Type guard for number Zod types
+     */
+    isNumber(v: ZodAny | ZodNumber): v is ZodNumber;
+    /**
+     * Type guard for date Zod types
+     */
+    isDate(v: ZodAny | ZodDate): v is ZodDate;
+    /**
+     * Type guard for default Zod types
+     */
+    isDefault(v: ZodAny | ZodDefault<any>): v is ZodDefault<any>;
+    /**
+     * Determines whether this compatibility layer should be applied for the current model.
+     *
+     * @returns True if this compatibility layer should be used, false otherwise
+     * @abstract
+     */
+    shouldApply(): boolean;
+    /**
+     * Returns the JSON Schema target format for this provider.
+     *
+     * @returns The schema target format, or undefined to use the default 'jsonSchema7'
+     * @abstract
+     */
+    getSchemaTarget(): Targets | undefined;
+    /**
+     * Processes a specific Zod type according to the provider's requirements.
+     *
+     * @param value - The Zod type to process
+     * @returns The processed Zod type
+     * @abstract
+     */
+    processZodType(value: ZodType): ZodType;
+    /**
+     * Default handler for Zod object types. Recursively processes all properties in the object.
+     *
+     * @param value - The Zod object to process
+     * @returns The processed Zod object
+     */
+    defaultZodObjectHandler(value: ZodObject<any, any>, options?: {
+        passthrough?: boolean;
+    }): ZodObject<any, any>;
+    /**
+     * Merges validation constraints into a parameter description.
+     *
+     * This helper method converts validation constraints that may not be supported
+     * by a provider into human-readable descriptions.
+     *
+     * @param description - The existing parameter description
+     * @param constraints - The validation constraints to merge
+     * @returns The updated description with constraints, or undefined if no constraints
+     */
+    mergeParameterDescription(description: string | undefined, constraints: ConstraintHelperText): string | undefined;
+    /**
+     * Default handler for unsupported Zod types. Throws an error for specified unsupported types.
+     *
+     * @param value - The Zod type to check
+     * @param throwOnTypes - Array of type names to throw errors for
+     * @returns The original value if not in the throw list
+     * @throws Error if the type is in the unsupported list
+     */
+    defaultUnsupportedZodTypeHandler<T extends z.ZodObject<any, any>>(value: z.ZodAny, throwOnTypes?: readonly UnsupportedZodType[]): ShapeValue<T>;
+    /**
+     * Default handler for Zod array types. Processes array constraints according to provider support.
+     *
+     * @param value - The Zod array to process
+     * @param handleChecks - Array constraints to convert to descriptions vs keep as validation
+     * @returns The processed Zod array
+     */
+    defaultZodArrayHandler(value: ZodArray<any>, handleChecks?: readonly ArrayCheckType[]): ZodArray<any>;
+    /**
+     * Default handler for Zod union types. Processes all union options.
+     *
+     * @param value - The Zod union to process
+     * @returns The processed Zod union
+     * @throws Error if union has fewer than 2 options
+     */
+    defaultZodUnionHandler(value: ZodUnion<[ZodAny, ...ZodAny[]]>): ZodAny;
+    /**
+     * Default handler for Zod string types. Processes string validation constraints.
+     *
+     * @param value - The Zod string to process
+     * @param handleChecks - String constraints to convert to descriptions vs keep as validation
+     * @returns The processed Zod string
+     */
+    defaultZodStringHandler(value: ZodString, handleChecks?: readonly StringCheckType[]): ZodString;
+    /**
+     * Default handler for Zod number types. Processes number validation constraints.
+     *
+     * @param value - The Zod number to process
+     * @param handleChecks - Number constraints to convert to descriptions vs keep as validation
+     * @returns The processed Zod number
+     */
+    defaultZodNumberHandler(value: ZodNumber, handleChecks?: readonly NumberCheckType[]): ZodNumber;
+    /**
+     * Default handler for Zod date types. Converts dates to ISO strings with constraint descriptions.
+     *
+     * @param value - The Zod date to process
+     * @returns A Zod string schema representing the date in ISO format
+     */
+    defaultZodDateHandler(value: ZodDate): ZodString;
+    /**
+     * Default handler for Zod optional types. Processes the inner type and maintains optionality.
+     *
+     * @param value - The Zod optional to process
+     * @param handleTypes - Types that should be processed vs passed through
+     * @returns The processed Zod optional
+     */
+    defaultZodOptionalHandler(value: ZodOptional<any>, handleTypes?: readonly AllZodType[]): ZodType;
+    /**
+     * Processes a Zod object schema and converts it to an AI SDK Schema.
+     *
+     * @param zodSchema - The Zod object schema to process
+     * @returns An AI SDK Schema with provider-specific compatibility applied
+     */
+    processToAISDKSchema(zodSchema: ZodType): Schema;
+    /**
+     * Processes a Zod object schema and converts it to a JSON Schema.
+     *
+     * @param zodSchema - The Zod object schema to process
+     * @returns A JSONSchema7 object with provider-specific compatibility applied
+     */
+    processToJSONSchema(zodSchema: ZodType): JSONSchema7;
+}
+export {};
+//# sourceMappingURL=schema-compatibility-v4.d.ts.map

package/dist/schema-compatibility-v4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-compatibility-v4.d.ts","sourceRoot":"","sources":["../src/schema-compatibility-v4.ts"],"names":[],"mappings":"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"}

package/dist/schema-compatibility.d.ts

@@ -1,167 +1,73 @@
-import type { Schema, LanguageModel } from 'ai';
-import type { JSONSchema7 } from 'json-schema';
-import { z, ZodOptional, ZodObject, ZodArray, ZodUnion, ZodString, ZodNumber, ZodDate, ZodDefault, ZodNull } from 'zod';
-import type { ZodTypeAny } from 'zod';
+import type { z as zV3 } from 'zod/v3';
+import type { z as zV4, ZodType } from 'zod/v4';
 import type { Targets } from 'zod-to-json-schema';
-export type SchemaCompatModel = Exclude<LanguageModel, string>;
-/**
- * All supported string validation check types that can be processed or converted to descriptions.
- * @constant
- */
-export declare const ALL_STRING_CHECKS: readonly ["regex", "emoji", "email", "url", "uuid", "cuid", "min", "max"];
-/**
- * All supported number validation check types that can be processed or converted to descriptions.
- * @constant
- */
-export declare const ALL_NUMBER_CHECKS: readonly ["min", "max", "multipleOf"];
-/**
- * All supported array validation check types that can be processed or converted to descriptions.
- * @constant
- */
-export declare const ALL_ARRAY_CHECKS: readonly ["min", "max", "length"];
-export declare const isOptional: (v: ZodTypeAny) => v is ZodOptional<any>;
-export declare const isObj: (v: ZodTypeAny) => v is ZodObject<any, any, any>;
-export declare const isNull: (v: ZodTypeAny) => v is ZodNull;
-export declare const isArr: (v: ZodTypeAny) => v is ZodArray<any, any>;
-export declare const isUnion: (v: ZodTypeAny) => v is ZodUnion<[ZodTypeAny, ...ZodTypeAny[]]>;
-export declare const isString: (v: ZodTypeAny) => v is ZodString;
-export declare const isNumber: (v: ZodTypeAny) => v is ZodNumber;
-export declare const isDate: (v: ZodTypeAny) => v is ZodDate;
-export declare const isDefault: (v: ZodTypeAny) => v is ZodDefault<any>;
-/**
- * Zod types that are not supported by most AI model providers and should be avoided.
- * @constant
- */
-export declare const UNSUPPORTED_ZOD_TYPES: readonly ["ZodIntersection", "ZodNever", "ZodNull", "ZodTuple", "ZodUndefined"];
-/**
- * Zod types that are generally supported by AI model providers.
- * @constant
- */
-export declare const SUPPORTED_ZOD_TYPES: readonly ["ZodObject", "ZodArray", "ZodUnion", "ZodString", "ZodNumber", "ZodDate", "ZodAny", "ZodDefault"];
-/**
- * All Zod types (both supported and unsupported).
- * @constant
- */
-export declare const ALL_ZOD_TYPES: readonly ["ZodObject", "ZodArray", "ZodUnion", "ZodString", "ZodNumber", "ZodDate", "ZodAny", "ZodDefault", "ZodIntersection", "ZodNever", "ZodNull", "ZodTuple", "ZodUndefined"];
-/**
- * Type representing string validation checks.
- */
-export type StringCheckType = (typeof ALL_STRING_CHECKS)[number];
-/**
- * Type representing number validation checks.
- */
-export type NumberCheckType = (typeof ALL_NUMBER_CHECKS)[number];
-/**
- * Type representing array validation checks.
- */
-export type ArrayCheckType = (typeof ALL_ARRAY_CHECKS)[number];
-/**
- * Type representing unsupported Zod schema types.
- */
-export type UnsupportedZodType = (typeof UNSUPPORTED_ZOD_TYPES)[number];
-/**
- * Type representing supported Zod schema types.
- */
-export type SupportedZodType = (typeof SUPPORTED_ZOD_TYPES)[number];
-/**
- * Type representing all Zod schema types (supported and unsupported).
- */
-export type AllZodType = (typeof ALL_ZOD_TYPES)[number];
-/**
- * Utility type to extract the shape of a Zod object schema.
- */
-export type ZodShape<T extends z.AnyZodObject> = T['shape'];
-/**
- * Utility type to extract the keys from a Zod object shape.
- */
-export type ShapeKey<T extends z.AnyZodObject> = keyof ZodShape<T>;
-/**
- * Utility type to extract the value types from a Zod object shape.
- */
-export type ShapeValue<T extends z.AnyZodObject> = ZodShape<T>[ShapeKey<T>];
-type StringConstraints = {
-    minLength?: number;
-    maxLength?: number;
-    email?: boolean;
-    url?: boolean;
-    uuid?: boolean;
-    cuid?: boolean;
-    emoji?: boolean;
-    regex?: {
-        pattern: string;
-        flags?: string;
-    };
-};
-type NumberConstraints = {
-    gt?: number;
-    gte?: number;
-    lt?: number;
-    lte?: number;
-    multipleOf?: number;
-};
-type ArrayConstraints = {
-    minLength?: number;
-    maxLength?: number;
-    exactLength?: number;
-};
-type DateConstraints = {
-    minDate?: string;
-    maxDate?: string;
-    dateFormat?: string;
-};
-/**
- * Abstract base class for creating schema compatibility layers for different AI model providers.
- *
- * This class provides a framework for transforming Zod schemas to work with specific AI model
- * provider requirements and limitations. Each provider may have different support levels for
- * JSON Schema features, validation constraints, and data types.
- *
- * @abstract
- *
- * @example
- * ```typescript
- * import { SchemaCompatLayer } from '@mastra/schema-compat';
- * import type { LanguageModelV1 } from 'ai';
- *
- * class CustomProviderCompat extends SchemaCompatLayer {
- *   constructor(model: LanguageModelV1) {
- *     super(model);
- *   }
- *
- *   shouldApply(): boolean {
- *     return this.getModel().provider === 'custom-provider';
- *   }
- *
- *   getSchemaTarget() {
- *     return 'jsonSchema7';
- *   }
- *
- *   processZodType<T extends z.AnyZodObject>(value: z.ZodTypeAny): ShapeValue<T> {
- *     // Custom processing logic for this provider
- *     switch (value._def.typeName) {
- *       case 'ZodString':
- *         return this.defaultZodStringHandler(value, ['email', 'url']);
- *       default:
- *         return this.defaultUnsupportedZodTypeHandler(value);
- *     }
- *   }
- * }
- * ```
- */
+import type { JSONSchema7 } from './json-schema.js';
+import type { UnsupportedZodType as UnsupportedZodTypeV3, ShapeValue as ShapeValueV3, StringCheckType, NumberCheckType, ArrayCheckType, AllZodType as AllZodTypeV3 } from './schema-compatibility-v3.js';
+import type { UnsupportedZodType as UnsupportedZodTypeV4, ShapeValue as ShapeValueV4, AllZodType as AllZodTypeV4 } from './schema-compatibility-v4.js';
+import type { Schema, ModelInformation } from './types.js';
+type ConstraintHelperText = string[];
 export declare abstract class SchemaCompatLayer {
     private model;
+    private v3Layer;
+    private v4Layer;
     /**
      * Creates a new schema compatibility instance.
      *
      * @param model - The language model this compatibility layer applies to
      */
-    constructor(model: SchemaCompatModel);
+    constructor(model: ModelInformation);
     /**
      * Gets the language model associated with this compatibility layer.
      *
      * @returns The language model instance
      */
-    getModel(): SchemaCompatModel;
+    getModel(): ModelInformation;
+    getUnsupportedZodTypes(v: ZodType): readonly string[];
+    /**
+     * Type guard for optional Zod types
+     */
+    isOptional(v: zV4.ZodType): v is zV4.ZodOptional<any>;
+    isOptional(v: zV3.ZodType): v is zV3.ZodOptional<any>;
+    /**
+     * Type guard for object Zod types
+     */
+    isObj(v: zV4.ZodType): v is zV4.ZodObject<any, any>;
+    isObj(v: zV3.ZodType): v is zV3.ZodObject<any, any, any, any, any>;
+    /**
+     * Type guard for null Zod types
+     */
+    isNull(v: zV4.ZodType): v is zV4.ZodNull;
+    isNull(v: zV3.ZodType): v is zV3.ZodNull;
+    /**
+     * Type guard for array Zod types
+     */
+    isArr(v: zV4.ZodType): v is zV4.ZodArray<any>;
+    isArr(v: zV3.ZodType): v is zV3.ZodArray<any, any>;
+    /**
+     * Type guard for union Zod types
+     */
+    isUnion(v: zV4.ZodType): v is zV4.ZodUnion<[zV4.ZodType, ...zV4.ZodType[]]>;
+    isUnion(v: zV3.ZodType): v is zV3.ZodUnion<[zV3.ZodType, ...zV3.ZodType[]]>;
+    /**
+     * Type guard for string Zod types
+     */
+    isString(v: zV4.ZodType): v is zV4.ZodString;
+    isString(v: zV3.ZodType): v is zV3.ZodString;
+    /**
+     * Type guard for number Zod types
+     */
+    isNumber(v: zV4.ZodType): v is zV4.ZodNumber;
+    isNumber(v: zV3.ZodType): v is zV3.ZodNumber;
+    /**
+     * Type guard for date Zod types
+     */
+    isDate(v: zV4.ZodType): v is zV4.ZodDate;
+    isDate(v: zV3.ZodType): v is zV3.ZodDate;
+    /**
+     * Type guard for default Zod types
+     */
+    isDefault(v: zV4.ZodType): v is zV4.ZodDefault<any>;
+    isDefault(v: zV3.ZodType): v is zV3.ZodDefault<any>;
     /**
      * Determines whether this compatibility layer should be applied for the current model.
      *
@@ -183,16 +89,21 @@ export declare abstract class SchemaCompatLayer {
      * @returns The processed Zod type
      * @abstract
      */
-    abstract processZodType(value: ZodTypeAny): ZodTypeAny;
+    abstract processZodType(value: zV4.ZodType): zV4.ZodType;
+    abstract processZodType(value: zV3.ZodType): zV3.ZodType;
+    abstract processZodType(value: zV4.ZodType | zV3.ZodType): zV4.ZodType | zV3.ZodType;
     /**
      * Default handler for Zod object types. Recursively processes all properties in the object.
      *
      * @param value - The Zod object to process
      * @returns The processed Zod object
      */
-    defaultZodObjectHandler(value: ZodObject<any, any, any>, options?: {
+    defaultZodObjectHandler(value: zV4.ZodObject<any, any>, options?: {
+        passthrough?: boolean;
+    }): zV4.ZodObject<any, any>;
+    defaultZodObjectHandler(value: zV3.ZodObject<any, any>, options?: {
         passthrough?: boolean;
-    }): ZodObject<any, any, any>;
+    }): zV3.ZodObject<any, any>;
     /**
      * Merges validation constraints into a parameter description.
      *
@@ -203,9 +114,7 @@ export declare abstract class SchemaCompatLayer {
      * @param constraints - The validation constraints to merge
      * @returns The updated description with constraints, or undefined if no constraints
      */
-    mergeParameterDescription(description: string | undefined, constraints: NumberConstraints | StringConstraints | ArrayConstraints | DateConstraints | {
-        defaultValue?: unknown;
-    }): string | undefined;
+    mergeParameterDescription(description: string | undefined, constraints: ConstraintHelperText): string | undefined;
     /**
      * Default handler for unsupported Zod types. Throws an error for specified unsupported types.
      *
@@ -214,7 +123,7 @@ export declare abstract class SchemaCompatLayer {
      * @returns The original value if not in the throw list
      * @throws Error if the type is in the unsupported list
      */
-    defaultUnsupportedZodTypeHandler<T extends z.AnyZodObject>(value: z.ZodTypeAny, throwOnTypes?: readonly UnsupportedZodType[]): ShapeValue<T>;
+    defaultUnsupportedZodTypeHandler<T extends zV4.ZodObject | zV3.AnyZodObject>(value: T, throwOnTypes?: T extends zV4.ZodObject ? UnsupportedZodTypeV4[] : T extends zV3.AnyZodObject ? UnsupportedZodTypeV3[] : never): T extends zV4.ZodObject ? ShapeValueV4<T> : T extends zV3.AnyZodObject ? ShapeValueV3<T> : never;
     /**
      * Default handler for Zod array types. Processes array constraints according to provider support.
      *
@@ -222,7 +131,8 @@ export declare abstract class SchemaCompatLayer {
      * @param handleChecks - Array constraints to convert to descriptions vs keep as validation
      * @returns The processed Zod array
      */
-    defaultZodArrayHandler(value: ZodArray<any, any>, handleChecks?: readonly ArrayCheckType[]): ZodArray<any, any>;
+    defaultZodArrayHandler(value: zV4.ZodArray<any>, handleChecks?: readonly ArrayCheckType[]): zV4.ZodArray<any>;
+    defaultZodArrayHandler(value: zV3.ZodArray<any, any>, handleChecks?: readonly ArrayCheckType[]): zV3.ZodArray<any, any>;
     /**
      * Default handler for Zod union types. Processes all union options.
      *
@@ -230,7 +140,8 @@ export declare abstract class SchemaCompatLayer {
      * @returns The processed Zod union
      * @throws Error if union has fewer than 2 options
      */
-    defaultZodUnionHandler(value: ZodUnion<[ZodTypeAny, ...ZodTypeAny[]]>): ZodTypeAny;
+    defaultZodUnionHandler(value: zV4.ZodUnion<[zV4.ZodType, ...zV4.ZodType[]]>): zV4.ZodType;
+    defaultZodUnionHandler(value: zV3.ZodUnion<[zV3.ZodType, ...zV3.ZodType[]]>): zV3.ZodType;
     /**
      * Default handler for Zod string types. Processes string validation constraints.
      *
@@ -238,7 +149,8 @@ export declare abstract class SchemaCompatLayer {
      * @param handleChecks - String constraints to convert to descriptions vs keep as validation
      * @returns The processed Zod string
      */
-    defaultZodStringHandler(value: ZodString, handleChecks?: readonly StringCheckType[]): ZodString;
+    defaultZodStringHandler(value: zV4.ZodString, handleChecks?: readonly StringCheckType[]): zV4.ZodString;
+    defaultZodStringHandler(value: zV3.ZodString, handleChecks?: readonly StringCheckType[]): zV3.ZodString;
     /**
      * Default handler for Zod number types. Processes number validation constraints.
      *
@@ -246,14 +158,16 @@ export declare abstract class SchemaCompatLayer {
      * @param handleChecks - Number constraints to convert to descriptions vs keep as validation
      * @returns The processed Zod number
      */
-    defaultZodNumberHandler(value: ZodNumber, handleChecks?: readonly NumberCheckType[]): ZodNumber;
+    defaultZodNumberHandler(value: zV4.ZodNumber, handleChecks?: readonly NumberCheckType[]): zV4.ZodNumber;
+    defaultZodNumberHandler(value: zV3.ZodNumber, handleChecks?: readonly NumberCheckType[]): zV3.ZodNumber;
     /**
      * Default handler for Zod date types. Converts dates to ISO strings with constraint descriptions.
      *
      * @param value - The Zod date to process
      * @returns A Zod string schema representing the date in ISO format
      */
-    defaultZodDateHandler(value: ZodDate): ZodString;
+    defaultZodDateHandler(value: zV4.ZodDate): zV4.ZodString;
+    defaultZodDateHandler(value: zV3.ZodDate): zV3.ZodString;
     /**
      * Default handler for Zod optional types. Processes the inner type and maintains optionality.
      *
@@ -261,21 +175,22 @@ export declare abstract class SchemaCompatLayer {
      * @param handleTypes - Types that should be processed vs passed through
      * @returns The processed Zod optional
      */
-    defaultZodOptionalHandler(value: ZodOptional<any>, handleTypes?: readonly AllZodType[]): ZodTypeAny;
+    defaultZodOptionalHandler(value: zV4.ZodOptional<any>, handleTypes?: readonly AllZodTypeV4[]): zV4.ZodType;
+    defaultZodOptionalHandler(value: zV3.ZodOptional<any>, handleTypes?: readonly AllZodTypeV3[]): zV3.ZodType;
     /**
      * Processes a Zod object schema and converts it to an AI SDK Schema.
      *
      * @param zodSchema - The Zod object schema to process
      * @returns An AI SDK Schema with provider-specific compatibility applied
      */
-    processToAISDKSchema(zodSchema: z.ZodSchema): Schema;
+    processToAISDKSchema(zodSchema: zV3.ZodSchema | zV4.ZodType): Schema;
     /**
      * Processes a Zod object schema and converts it to a JSON Schema.
      *
      * @param zodSchema - The Zod object schema to process
      * @returns A JSONSchema7 object with provider-specific compatibility applied
      */
-    processToJSONSchema(zodSchema: z.ZodSchema): JSONSchema7;
+    processToJSONSchema(zodSchema: zV3.ZodSchema | zV4.ZodType): JSONSchema7;
 }
 export {};
 //# sourceMappingURL=schema-compatibility.d.ts.map