brianyin/ajs-309-support-zod-v4

[toubatbrian]

Description

This PR adds seamless support for both Zod v3 and v4, allowing users to use either version without any code changes. The key feature is full support for .optional() fields - resolving the TypeScript error that users reported when using .optional() on Zod schema fields.

Changes Made

New Files

• agents/src/llm/zod-utils.ts: Core utilities for dual-version support
  • isZod4Schema(): Detects Zod version via _zod property check
  • zodSchemaToJsonSchema(): Converts schemas to JSON Schema (handles both v3 and v4)
  • parseZodSchema(): Parses values with version-aware APIs

Updated Files

• agents/src/llm/tool_context.ts:
  • Removed strict JSONObject constraint from ToolInputSchema<T> to support .optional() fields
  • Replaced instanceof ZodObject checks with isZodSchema() and isZodObjectSchema() helpers
  • Enhanced type inference with InferToolInput<T> helper (adapted from Vercel AI SDK)
• agents/src/llm/utils.ts: Updated toJsonSchema() to use new zodSchemaToJsonSchema() helper
• agents/src/voice/generation.ts: Replaced instanceof checks with version-agnostic helpers
• agents/src/llm/tool_context.test.ts: Added comprehensive test for .optional() fields
• agents/src/llm/zod-utils.test.ts: Full test suite with snapshot testing for schema conversions

Dependencies

• agents/package.json: Updated peer dependency to "zod": "^3.25.76 || ^4.1.8"
• examples/package.json: Updated to use Zod v4 (^4.1.12) by default
• plugins/test/package.json: Updated peer dependency to match

Pre-Review Checklist

• Build passes: All builds (lint, typecheck, tests) pass locally
• AI-generated code reviewed: Code quality ensured, attribution comments added for Vercel AI SDK patterns
• Changes explained: All changes documented with clear rationale
• Scope appropriate: All changes relate to Zod v4 support and .optional() fix

[changeset-bot]

🦋 Changeset detected

Latest commit: 29fdd37

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 14 packages

Name	Type
@livekit/agents-plugins-test	Patch
@livekit/agents	Patch
@livekit/agents-plugin-anam	Patch
@livekit/agents-plugin-cartesia	Patch
@livekit/agents-plugin-deepgram	Patch
@livekit/agents-plugin-elevenlabs	Patch
@livekit/agents-plugin-google	Patch
@livekit/agents-plugin-neuphonic	Patch
@livekit/agents-plugin-openai	Patch
@livekit/agents-plugin-resemble	Patch
@livekit/agents-plugin-rime	Patch
@livekit/agents-plugin-bey	Patch
@livekit/agents-plugin-livekit	Patch
@livekit/agents-plugin-silero	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[toubatbrian]

Should resolve #733