feat: deepen Zod integration in Ax #394
Open
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What kind of change does this PR introduce?
Feature — foundational Zod schema integration across Ax signatures, runtime validation, and developer tooling.
What is the current behavior? (You can also link to an open issue here)
Signatures must be authored manually. Existing Zod schemas are not reusable inside Ax, Zod validations never run during generation, and there’s minimal telemetry when features are downgraded. This gap is highlighted in feat: add comprehensive zod schema support #388 and issue Standard Schema for Signature Input/Output? #348 (“Standard Schema for Signature Input/Output?”).
What is the new behavior (if this is a feature change)?
AxSignature.fromZod
/toZod
for bidirectional conversion with downgrade telemetry, strict-mode enforcement, and metadata captured inAxZodRegistry
.AxProgram
,AxGen
,template.ax
, etc.) to accept raw Zod schemas, wiring options such as parsing mode, assertion level, and streaming intent throughAxZodSignatureOptions
..parse
/.safeParse
/.catch
/.default
semantics to LLM outputs and aligning downgrade notes with runtime validation failures.AxSignature.debugZodConversion
,getZodConversionIssues
, andreportZodConversionIssues
for auditing schema fidelity.docs/ZOD_INTEGRATION.md
), SIGNATURES guide updates, and deterministic examples (OpenAI generation, runtime repair, round-trip stories) to demonstrate migration paths and workflows without API keys.Other information:
npm install
, which triggers lint, format, type-check, unit, and spelling tasks) pass locally.npm audit fix
separately.