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/toZodfor 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/.defaultsemantics to LLM outputs and aligning downgrade notes with runtime validation failures.AxSignature.debugZodConversion,getZodConversionIssues, andreportZodConversionIssuesfor 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 fixseparately.