@aeye/core 0.5.3 → 0.6.0

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

@@ -0,0 +1,64 @@
+import type { DescriptorFamily } from './descriptor';
+/**
+ * Format specification for JSON Schema generation
+ */
+/**
+ * Family name for `ToJSONSchemaOptions.format`. Alias of `DescriptorFamily`
+ * — the three built-in dialects (`'openai'`, `'anthropic'`, `'google'`)
+ * plus any string registered via `registerDescriptor`.
+ *
+ * @deprecated Prefer `DescriptorFamily`. Both refer to the same widened type.
+ */
+export type JSONSchemaFormat = DescriptorFamily;
+/**
+ * Options for toJSONSchema
+ */
+export interface ToJSONSchemaOptions {
+    /**
+     * Whether to use strict mode (all fields required, additionalProperties: false)
+     */
+    strict: boolean;
+    /**
+     * The target format for the JSON Schema. Resolves to a named FormatDescriptor.
+     * Built-in (`'openai'` / `'anthropic'` / `'google'`) or any string
+     * registered via `registerDescriptor`.
+     */
+    format?: DescriptorFamily;
+}
+export type JSONSchemaType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'null' | 'integer';
+/**
+ * JSON Schema type definition
+ */
+export interface JSONSchema {
+    type?: JSONSchemaType | JSONSchemaType[];
+    properties?: Record<string, JSONSchema>;
+    items?: JSONSchema;
+    prefixItems?: JSONSchema[];
+    required?: string[];
+    additionalProperties?: boolean | JSONSchema;
+    propertyNames?: JSONSchema;
+    enum?: any[];
+    anyOf?: JSONSchema[];
+    allOf?: JSONSchema[];
+    additionalItems?: boolean | JSONSchema;
+    not?: JSONSchema;
+    $ref?: string;
+    description?: string;
+    default?: any;
+    pattern?: string;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    minItems?: number;
+    maxItems?: number;
+    const?: any;
+    title?: string;
+    $defs?: Record<string, JSONSchema>;
+    /** Gemini-specific: deterministic property emission order for strict mode. */
+    propertyOrdering?: string[];
+    [metadata: string]: unknown;
+}
+//# sourceMappingURL=json-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/schema/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;GAEG;AACH;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvG;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACvC,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B"}

package/dist/schema/json-schema.js

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

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

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

package/dist/schema/registry.d.ts

@@ -0,0 +1,73 @@
+import type { DescriptorFamily, FormatDescriptor } from './descriptor';
+import type { ToJSONSchemaOptions } from './json-schema';
+/**
+ * Register a custom `FormatDescriptor` so it can be looked up by `id` or
+ * by `(family, strict)`. Useful for adding support for a new provider
+ * dialect or for registering a tweaked variant of an existing family.
+ *
+ * The descriptor's `id` and `family` become the lookup keys. If a
+ * descriptor with the same id is already registered, the new one
+ * replaces it. The family slot tracks one strict and one lenient
+ * variant; registering a third variant overwrites the matching slot.
+ *
+ * Built-in descriptors (`OPENAI_STRICT`, `LENIENT`, etc.) are seeded at
+ * module load — you don't need to register them manually. They CAN be
+ * overridden by registering a same-id descriptor afterwards, but doing
+ * so is generally a sign that you should pick a different id.
+ *
+ * @example
+ * ```ts
+ * import { registerDescriptor, OPENAI_STRICT } from '@aeye/core';
+ *
+ * // A tighter OpenAI-flavored descriptor: same wire shape but with
+ * // pattern support disabled (some downstream tools choke on regex).
+ * registerDescriptor({
+ *   ...OPENAI_STRICT,
+ *   id: 'openai-no-regex',
+ *   family: 'openai-no-regex',
+ *   allowPattern: false,
+ *   allowMultiplePatterns: false,
+ * });
+ *
+ * // Now resolvable:
+ * getDescriptor('openai-no-regex', true);   // → the registered descriptor
+ * getDescriptorById('openai-no-regex');     // → same
+ * ```
+ *
+ * A descriptor that contradicts itself (see `checkDescriptorConsistency`) is
+ * still registered — the caller may know something we don't — but each
+ * problem is warned once at registration, because the alternative is finding
+ * out from a provider's HTTP 400.
+ */
+export declare function registerDescriptor(descriptor: FormatDescriptor): void;
+/**
+ * Resolve a descriptor by family + strictness.
+ *
+ * Built-in families (`'openai'`, `'anthropic'`, `'google'`) always
+ * resolve. Custom families registered via `registerDescriptor` resolve
+ * once they're registered. Unknown families fall back to `LENIENT`
+ * (safe default — strict mode silently degrades for unrecognized models).
+ *
+ * @param family - provider family (built-in or registered)
+ * @param strict - whether the strict variant is wanted
+ */
+export declare function getDescriptor(family: DescriptorFamily, strict: boolean): FormatDescriptor;
+/**
+ * Look up a descriptor by id. Returns LENIENT for unknown ids (safe default).
+ * Custom descriptors registered via `registerDescriptor` are reachable here
+ * by their `id`.
+ */
+export declare function getDescriptorById(id: string | undefined): FormatDescriptor;
+/**
+ * True if `family` has at least one registered descriptor (strict or
+ * lenient). Used by `@aeye/ai`'s `resolveStrictFormat` fallback chain to
+ * decide whether a model id prefix or provider name is a recognized
+ * dialect.
+ */
+export declare function hasDescriptorFamily(family: string | undefined): boolean;
+/**
+ * Resolve descriptor from various input shapes (boolean, options object, or descriptor).
+ * Used by `toJSONSchema` to support its overloaded signature.
+ */
+export declare function resolveDescriptor(input: FormatDescriptor | ToJSONSchemaOptions | boolean | undefined): FormatDescriptor;
+//# sourceMappingURL=registry.d.ts.map

package/dist/schema/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/schema/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAuCzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAKrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAOzF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAG1E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAGvE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,OAAO,GAAG,SAAS,GAClE,gBAAgB,CAMlB"}

package/dist/schema/registry.js

@@ -0,0 +1,135 @@
+import { checkDescriptorConsistency } from './consistency';
+import { LENIENT } from './dialects/lenient';
+import { OPENAI_STRICT, OPENAI_NON_STRICT } from './dialects/openai';
+import { ANTHROPIC_STRICT, ANTHROPIC_NON_STRICT } from './dialects/anthropic';
+import { GOOGLE_STRICT, GOOGLE_NON_STRICT } from './dialects/google';
+import { XAI_STRICT, XAI_NON_STRICT } from './dialects/xai';
+// ============================================================================
+// Descriptor registry — mutable lookup tables for built-in + user-registered
+// descriptors. `registerDescriptor` adds to both maps; `getDescriptor` /
+// `getDescriptorById` consult them on every lookup so newly-registered
+// descriptors are immediately addressable by family or id.
+// ============================================================================
+const DESCRIPTORS_BY_ID = new Map();
+// Keyed by family name. Each family slot holds its strict and lenient variants.
+// `'lenient'` always points to `LENIENT` for both keys.
+const DESCRIPTORS_BY_FAMILY = new Map();
+function indexDescriptor(d) {
+    DESCRIPTORS_BY_ID.set(d.id, d);
+    const slot = DESCRIPTORS_BY_FAMILY.get(d.family) ?? {};
+    if (d.strict)
+        slot.strict = d;
+    else
+        slot.lenient = d;
+    DESCRIPTORS_BY_FAMILY.set(d.family, slot);
+}
+// Seed the registry with built-ins.
+for (const d of [
+    LENIENT,
+    OPENAI_STRICT, OPENAI_NON_STRICT,
+    ANTHROPIC_STRICT, ANTHROPIC_NON_STRICT,
+    GOOGLE_STRICT, GOOGLE_NON_STRICT,
+    XAI_STRICT, XAI_NON_STRICT,
+]) {
+    indexDescriptor(d);
+}
+/**
+ * Register a custom `FormatDescriptor` so it can be looked up by `id` or
+ * by `(family, strict)`. Useful for adding support for a new provider
+ * dialect or for registering a tweaked variant of an existing family.
+ *
+ * The descriptor's `id` and `family` become the lookup keys. If a
+ * descriptor with the same id is already registered, the new one
+ * replaces it. The family slot tracks one strict and one lenient
+ * variant; registering a third variant overwrites the matching slot.
+ *
+ * Built-in descriptors (`OPENAI_STRICT`, `LENIENT`, etc.) are seeded at
+ * module load — you don't need to register them manually. They CAN be
+ * overridden by registering a same-id descriptor afterwards, but doing
+ * so is generally a sign that you should pick a different id.
+ *
+ * @example
+ * ```ts
+ * import { registerDescriptor, OPENAI_STRICT } from '@aeye/core';
+ *
+ * // A tighter OpenAI-flavored descriptor: same wire shape but with
+ * // pattern support disabled (some downstream tools choke on regex).
+ * registerDescriptor({
+ *   ...OPENAI_STRICT,
+ *   id: 'openai-no-regex',
+ *   family: 'openai-no-regex',
+ *   allowPattern: false,
+ *   allowMultiplePatterns: false,
+ * });
+ *
+ * // Now resolvable:
+ * getDescriptor('openai-no-regex', true);   // → the registered descriptor
+ * getDescriptorById('openai-no-regex');     // → same
+ * ```
+ *
+ * A descriptor that contradicts itself (see `checkDescriptorConsistency`) is
+ * still registered — the caller may know something we don't — but each
+ * problem is warned once at registration, because the alternative is finding
+ * out from a provider's HTTP 400.
+ */
+export function registerDescriptor(descriptor) {
+    for (const problem of checkDescriptorConsistency(descriptor)) {
+        console.warn(`FormatDescriptor '${descriptor.id}' is inconsistent: ${problem}`);
+    }
+    indexDescriptor(descriptor);
+}
+/**
+ * Resolve a descriptor by family + strictness.
+ *
+ * Built-in families (`'openai'`, `'anthropic'`, `'google'`) always
+ * resolve. Custom families registered via `registerDescriptor` resolve
+ * once they're registered. Unknown families fall back to `LENIENT`
+ * (safe default — strict mode silently degrades for unrecognized models).
+ *
+ * @param family - provider family (built-in or registered)
+ * @param strict - whether the strict variant is wanted
+ */
+export function getDescriptor(family, strict) {
+    if (!strict) {
+        const slot = DESCRIPTORS_BY_FAMILY.get(family);
+        return slot?.lenient ?? LENIENT;
+    }
+    const slot = DESCRIPTORS_BY_FAMILY.get(family);
+    return slot?.strict ?? LENIENT;
+}
+/**
+ * Look up a descriptor by id. Returns LENIENT for unknown ids (safe default).
+ * Custom descriptors registered via `registerDescriptor` are reachable here
+ * by their `id`.
+ */
+export function getDescriptorById(id) {
+    if (!id)
+        return LENIENT;
+    return DESCRIPTORS_BY_ID.get(id) ?? LENIENT;
+}
+/**
+ * True if `family` has at least one registered descriptor (strict or
+ * lenient). Used by `@aeye/ai`'s `resolveStrictFormat` fallback chain to
+ * decide whether a model id prefix or provider name is a recognized
+ * dialect.
+ */
+export function hasDescriptorFamily(family) {
+    if (family === undefined)
+        return false;
+    return DESCRIPTORS_BY_FAMILY.has(family);
+}
+/**
+ * Resolve descriptor from various input shapes (boolean, options object, or descriptor).
+ * Used by `toJSONSchema` to support its overloaded signature.
+ */
+export function resolveDescriptor(input) {
+    if (input === undefined)
+        return OPENAI_STRICT;
+    if (typeof input === 'boolean')
+        return input ? OPENAI_STRICT : LENIENT;
+    if ('id' in input && 'family' in input)
+        return input;
+    const opts = input;
+    return getDescriptor(opts.format ?? 'openai', opts.strict);
+}
+//# sourceMappingURL=registry.js.map

package/dist/schema/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/schema/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE5D,+EAA+E;AAC/E,6EAA6E;AAC7E,yEAAyE;AACzE,uEAAuE;AACvE,2DAA2D;AAC3D,+EAA+E;AAE/E,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA4B,CAAC;AAC9D,gFAAgF;AAChF,wDAAwD;AACxD,MAAM,qBAAqB,GAAG,IAAI,GAAG,EAAqE,CAAC;AAE3G,SAAS,eAAe,CAAC,CAAmB;IAC1C,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACvD,IAAI,CAAC,CAAC,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;;QACzB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACtB,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,oCAAoC;AACpC,KAAK,MAAM,CAAC,IAAI;IACd,OAAO;IACP,aAAa,EAAE,iBAAiB;IAChC,gBAAgB,EAAE,oBAAoB;IACtC,aAAa,EAAE,iBAAiB;IAChC,UAAU,EAAE,cAAc;CAC3B,EAAE,CAAC;IACF,eAAe,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA4B;IAC7D,KAAK,MAAM,OAAO,IAAI,0BAA0B,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,qBAAqB,UAAU,CAAC,EAAE,sBAAsB,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,eAAe,CAAC,UAAU,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,MAAwB,EAAE,MAAe;IACrE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,IAAI,EAAE,OAAO,IAAI,OAAO,CAAC;IAClC,CAAC;IACD,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAsB;IACtD,IAAI,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC;IACxB,OAAO,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC5D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAmE;IAEnE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC;IAC9C,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;IACvE,IAAI,IAAI,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK;QAAE,OAAO,KAAyB,CAAC;IACzE,MAAM,IAAI,GAAG,KAA4B,CAAC;IAC1C,OAAO,aAAa,CAAC,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7D,CAAC"}

package/dist/schema/strictify.d.ts

@@ -0,0 +1,19 @@
+import z from 'zod';
+import type { FormatDescriptor } from './descriptor';
+/**
+ * Recursively transforms a Zod schema to a target dialect.
+ *
+ * For LENIENT, returns the input schema unchanged (no rewrites). For strict
+ * descriptors, installs preprocesses that accept the dialect's wire shape
+ * (e.g. array-of-pairs records, numeric-key tuple objects) and normalize them
+ * back to the natural Zod shape before validation.
+ *
+ * Repeated calls with the same `(schema, descriptor)` return the cached
+ * transformed schema. Different descriptors share the same outer entry but
+ * map to different inner values — bounded by the small descriptor count.
+ *
+ * @param schema - input Zod schema
+ * @param descriptor - target dialect descriptor (defaults to OPENAI_STRICT)
+ */
+export declare function strictify<S extends z.ZodType>(schema: S, descriptor?: FormatDescriptor): S;
+//# sourceMappingURL=strictify.d.ts.map

package/dist/schema/strictify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strictify.d.ts","sourceRoot":"","sources":["../../src/schema/strictify.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAcrD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAE,gBAAgC,GAAG,CAAC,CAezG"}

package/dist/schema/strictify.js

@@ -0,0 +1,237 @@
+import z from 'zod';
+import { LENIENT } from './dialects/lenient';
+import { OPENAI_STRICT } from './dialects/openai';
+/**
+ * Module-scope cache. Per-source-schema entry survives only as long as the
+ * source schema does — the WeakMap entry is gc'd with it, so all per-format
+ * strictified clones go with it. The inner Map is keyed by descriptor.id
+ * (small bounded set) so it cannot grow unboundedly.
+ */
+const strictifyCache = new WeakMap();
+/**
+ * Recursively transforms a Zod schema to a target dialect.
+ *
+ * For LENIENT, returns the input schema unchanged (no rewrites). For strict
+ * descriptors, installs preprocesses that accept the dialect's wire shape
+ * (e.g. array-of-pairs records, numeric-key tuple objects) and normalize them
+ * back to the natural Zod shape before validation.
+ *
+ * Repeated calls with the same `(schema, descriptor)` return the cached
+ * transformed schema. Different descriptors share the same outer entry but
+ * map to different inner values — bounded by the small descriptor count.
+ *
+ * @param schema - input Zod schema
+ * @param descriptor - target dialect descriptor (defaults to OPENAI_STRICT)
+ */
+export function strictify(schema, descriptor = OPENAI_STRICT) {
+    // LENIENT is a no-op: same reference, no cache entry needed.
+    if (descriptor.id === LENIENT.id)
+        return schema;
+    let perSchema = strictifyCache.get(schema);
+    if (!perSchema) {
+        perSchema = new Map();
+        strictifyCache.set(schema, perSchema);
+    }
+    const cached = perSchema.get(descriptor.id);
+    if (cached)
+        return cached;
+    const result = strictifyWithDescriptor(schema, descriptor);
+    perSchema.set(descriptor.id, result);
+    return result;
+}
+function strictifyWithDescriptor(schema, descriptor) {
+    // Per-call cycle map. Same scheme as before: cache lazy-thunks for in-flight
+    // schemas so recursive references emit a `z.lazy(() => result)` rather than
+    // recursing forever.
+    const map = new Map();
+    const transform = (s) => {
+        const cached = map.get(s);
+        if (cached) {
+            if (typeof cached === 'function') {
+                return z.lazy(cached);
+            }
+            else {
+                return cached;
+            }
+        }
+        let result;
+        map.set(s, () => result);
+        result = strictifySimple(s, transform, descriptor);
+        map.set(s, result);
+        return result;
+    };
+    return transform(schema);
+}
+/**
+* Transfer description and metadata from source Zod schema to target Zod schema.
+*
+* A declared `id` moves to `aid`: zod's global registry refuses a second schema
+* with the same `id` ("ID X already exists in the registry"), and the clone is
+* that second schema. `aid` names the same definition everywhere an `id` does.
+*/
+function transferMetadata(target, source) {
+    if (source.description) {
+        target = target.describe(source.description);
+    }
+    const meta = source.meta();
+    if (meta) {
+        const { id, ...rest } = meta;
+        target = target.meta(id === undefined ? meta : { ...rest, aid: rest.aid ?? id });
+    }
+    return target;
+}
+/**
+ * Per-node strictify dispatch. Each branch consults the descriptor to decide
+ * whether to install the dialect-specific preprocess.
+ */
+function strictifySimple(schema, transform, descriptor) {
+    // Handle ZodOptional
+    if (schema instanceof z.ZodOptional) {
+        const innerSchema = schema.unwrap();
+        const transformed = transform(innerSchema);
+        // Only install the null→undefined preprocess for dialects that rewrite
+        // optional to nullable on the wire (OpenAI strict). For other dialects,
+        // optional stays optional and the preprocess is unnecessary.
+        if (!descriptor.optionalAsNullable) {
+            return transferMetadata(transformed.optional(), schema);
+        }
+        const isNullable = innerSchema instanceof z.ZodNullable;
+        return transferMetadata(z.preprocess((val) => (!isNullable && val === null) ? undefined : val, transformed.optional()), schema);
+    }
+    // Handle ZodObject
+    if (schema instanceof z.ZodObject) {
+        const transformedShape = {};
+        for (const key in schema.shape) {
+            transformedShape[key] = transform(schema.shape[key]);
+        }
+        // Carry the catchall through. `z.object(shape)` alone DROPS it, so every
+        // `.catchall(...)` / `z.looseObject(...)` / `z.strictObject(...)` schema
+        // silently lost its open (or explicitly closed) tail the moment a strict
+        // dialect was selected — while `toJSONSchema` kept emitting that same
+        // catchall as `additionalProperties` and `analyzeSchema` kept walking it.
+        // strictify and the emitter were describing different schemas, and the
+        // mismatch surfaced only as keys stripped at validation time.
+        //
+        // Dialects that close objects (`objectClosedByDefault`: OpenAI/Anthropic
+        // strict) still emit `additionalProperties: false` regardless, so no wire
+        // shape changes for them — this restores the open tail exactly where the
+        // dialect permits one (Google).
+        const catchall = schema.def.catchall;
+        return transferMetadata(catchall
+            ? z.object(transformedShape).catchall(transform(catchall))
+            : z.object(transformedShape), schema);
+    }
+    // Handle ZodCodec
+    if (schema instanceof z.ZodCodec) {
+        return transferMetadata(z.codec(transform(schema.def.in), transform(schema.def.out), {
+            decode: schema.def.transform,
+            encode: schema.def.reverseTransform,
+        }), schema);
+    }
+    // Handle ZodPipe
+    if (schema instanceof z.ZodPipe) {
+        return transferMetadata(z.pipe(transform(schema.def.in), transform(schema.def.out)), schema);
+    }
+    // Handle ZodNullable
+    if (schema instanceof z.ZodNullable) {
+        return transferMetadata(transform(schema.unwrap()).nullable(), schema);
+    }
+    // Handle ZodArray
+    if (schema instanceof z.ZodArray) {
+        return transferMetadata(z.array(transform(schema.element)), schema);
+    }
+    // Handle ZodRecord
+    // Strict-mode JSON Schema represents records as `array of {key, value}` —
+    // OpenAI's structured outputs has no native pattern for open records, so
+    // we rewrite. Previously this used `z.codec(arrayIn, recordOut, decode)`,
+    // but z.codec proved fragile inside recursive lazy unions: the inner
+    // codec's transform doesn't always run when validation traverses a
+    // sibling branch, leaving the data in array form when later code expects
+    // record form (and vice-versa) — surfacing as "expected array, received
+    // object" union failures.
+    //
+    // `z.preprocess` is more robust here: it normalizes the input to record
+    // shape BEFORE the record schema sees it. Either array-of-pairs (from a
+    // strict-mode model) or already-a-record (when the schema is reused
+    // outside strict context) is accepted; both arrive at the record schema
+    // as a record.
+    //
+    // Only installed when the descriptor wants the array-of-pairs encoding.
+    if (schema instanceof z.ZodRecord) {
+        const keyTransformed = schema.keyType ? transform(schema.keyType) : z.string();
+        const valueTransformed = transform(schema.valueType);
+        if (descriptor.recordEncoding !== 'array-of-pairs') {
+            return transferMetadata(z.record(keyTransformed, valueTransformed), schema);
+        }
+        return transferMetadata(z.preprocess((val) => {
+            if (Array.isArray(val)) {
+                const record = {};
+                for (const entry of val) {
+                    if (entry && typeof entry === 'object' && 'key' in entry && 'value' in entry) {
+                        record[entry.key] = entry.value;
+                    }
+                }
+                return record;
+            }
+            return val;
+        }, z.record(keyTransformed, valueTransformed)), schema);
+    }
+    // Handle ZodUnion
+    if (schema instanceof z.ZodUnion) {
+        return transferMetadata(z.union(schema.options.map(transform)), schema);
+    }
+    // Handle ZodDiscriminatedUnion
+    if (schema instanceof z.ZodDiscriminatedUnion) {
+        return transferMetadata(z.discriminatedUnion(schema.def.discriminator, schema.options.map(transform)), schema);
+    }
+    // Handle ZodIntersection
+    if (schema instanceof z.ZodIntersection) {
+        return transferMetadata(z.intersection(transform(schema.def.left), transform(schema.def.right)), schema);
+    }
+    // Handle ZodTuple
+    // Strict-mode JSON Schema represents tuples as an object with numeric
+    // string keys (`{"0": <T0>, "1": <T1>, ...}`) — OpenAI's structured
+    // outputs has no positional `prefixItems` support and would otherwise
+    // collapse a `[string, number, bool]` to an array of `(string|number|bool)`,
+    // losing the per-position type. Encoding as an object preserves it.
+    // The strictified schema accepts EITHER form: an object with "0".."n-1"
+    // keys (what a strict-mode model produces) or an array (what a callsite
+    // outside strict context would pass). Both arrive at the tuple schema as
+    // an array.
+    //
+    // Only installed when the descriptor wants the numeric-keys encoding.
+    if (schema instanceof z.ZodTuple) {
+        const items = schema.def.items.map(transform);
+        const rest = schema.def.rest ? transform(schema.def.rest) : undefined;
+        const tupleSchema = rest ? z.tuple(items, rest) : z.tuple(items);
+        if (descriptor.tupleEncoding !== 'object-numeric-keys') {
+            return transferMetadata(tupleSchema, schema);
+        }
+        return transferMetadata(z.preprocess((val) => {
+            if (val && typeof val === 'object' && !Array.isArray(val)) {
+                const obj = val;
+                const keys = Object.keys(obj);
+                if (keys.length > 0 && keys.every((k) => /^\d+$/.test(k))) {
+                    const indices = keys.map((k) => parseInt(k, 10));
+                    const len = Math.max(...indices) + 1;
+                    const arr = new Array(len);
+                    for (const k of keys)
+                        arr[parseInt(k, 10)] = obj[k];
+                    return arr;
+                }
+            }
+            return val;
+        }, tupleSchema), schema);
+    }
+    // Handle ZodDefault
+    if (schema instanceof z.ZodDefault) {
+        return z.preprocess((val) => val === null ? undefined : val, transferMetadata(transform(schema.def.innerType).default(schema.def.defaultValue), schema));
+    }
+    // Handle ZodLazy
+    if (schema instanceof z.ZodLazy) {
+        return transferMetadata(z.lazy(() => transform(schema.def.getter())), schema);
+    }
+    // For all other types (primitives, etc.), return as-is
+    return schema;
+}
+//# sourceMappingURL=strictify.js.map

package/dist/schema/strictify.js.map

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

package/dist/schema/to-json-schema.d.ts

@@ -0,0 +1,29 @@
+import z from 'zod';
+import type { FormatDescriptor } from './descriptor';
+import type { JSONSchema, ToJSONSchemaOptions } from './json-schema';
+/**
+ * Converts a Zod schema to JSON Schema with support for different provider dialects.
+ *
+ * Accepts either a boolean (legacy: true = OPENAI_STRICT, false = LENIENT),
+ * an options object `{ strict, format? }`, or a `FormatDescriptor` directly.
+ *
+ * @param schema - The Zod schema to convert
+ * @param options - Configuration options for the conversion
+ * @returns JSON Schema object compatible with the resolved dialect
+ *
+ * @example
+ * ```typescript
+ * const schema = z.object({
+ *   name: z.string(),
+ *   age: z.number().optional(),
+ * });
+ *
+ * // For OpenAI strict mode
+ * const jsonSchema = toJSONSchema(schema, { strict: true, format: 'openai' });
+ *
+ * // For Anthropic strict mode
+ * const anthropic = toJSONSchema(schema, ANTHROPIC_STRICT);
+ * ```
+ */
+export declare function toJSONSchema(schema: z.ZodType, options: ToJSONSchemaOptions | boolean | FormatDescriptor): JSONSchema;
+//# sourceMappingURL=to-json-schema.d.ts.map

package/dist/schema/to-json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-json-schema.d.ts","sourceRoot":"","sources":["../../src/schema/to-json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAyBrE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,CAAC,CAAC,OAAO,EACjB,OAAO,EAAE,mBAAmB,GAAG,OAAO,GAAG,gBAAgB,GACxD,UAAU,CAqBZ"}