Fix #187 Agent outputType type error with zod@3.25.68+ (#342)

seratch · ianduvall · web-flow · commit f825f71f7e3c · 2025-08-15T20:55:12.000+09:00
* fix: make zod a peerDependency to dedupe installed versions
* Replace zod/v3 with zod in packages
---------
Co-authored-by: Ian Duvall &lt;iduvall@umich.edu&gt;
diff --git a/.changeset/spotty-nights-tell.md b/.changeset/spotty-nights-tell.md
@@ -0,0 +1,9 @@
+---
+'@openai/agents-extensions': patch
+'@openai/agents-realtime': patch
+'@openai/agents-openai': patch
+'@openai/agents-core': patch
+'@openai/agents': patch
+---
+
+Fix #187 Agent outputType type error with zod@3.25.68+
diff --git a/docs/package-lock.json b/docs/package-lock.json
diff --git a/examples/agent-patterns/package.json b/examples/agent-patterns/package.json
@@ -4,7 +4,7 @@
   "dependencies": {
     "@openai/agents": "workspace:*",
     "chalk": "^5.4.1",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/examples/ai-sdk/package.json b/examples/ai-sdk/package.json
@@ -5,7 +5,7 @@
     "@openai/agents": "workspace:*",
     "@openai/agents-extensions": "workspace:*",
     "@ai-sdk/openai": "^1.1.3",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/examples/basic/package.json b/examples/basic/package.json
@@ -3,7 +3,7 @@
   "name": "basic",
   "dependencies": {
     "@openai/agents": "workspace:*",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/examples/customer-service/package.json b/examples/customer-service/package.json
@@ -4,7 +4,7 @@
   "dependencies": {
     "@openai/agents": "workspace:*",
     "@openai/agents-core": "workspace:*",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/examples/docs/package.json b/examples/docs/package.json
@@ -9,7 +9,7 @@
     "@openai/agents-realtime": "workspace:*",
     "openai": "^5.10.1",
     "server-only": "^0.0.1",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit"
diff --git a/examples/financial-research-agent/package.json b/examples/financial-research-agent/package.json
@@ -3,7 +3,7 @@
   "name": "financial-research-agent",
   "dependencies": {
     "@openai/agents": "workspace:*",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/examples/handoffs/package.json b/examples/handoffs/package.json
@@ -4,7 +4,7 @@
   "dependencies": {
     "@openai/agents": "workspace:*",
     "@openai/agents-core": "workspace:*",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/examples/mcp/package.json b/examples/mcp/package.json
@@ -4,7 +4,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
     "@openai/agents": "workspace:*",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/examples/model-providers/package.json b/examples/model-providers/package.json
@@ -3,7 +3,7 @@
   "name": "model-providers",
   "dependencies": {
     "@openai/agents": "workspace:*",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/examples/nextjs/package.json b/examples/nextjs/package.json
@@ -21,7 +21,7 @@
     "react-dom": "^19.0.0",
     "tailwind-merge": "^3.3.1",
     "wavtools": "^0.1.5",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4",
diff --git a/examples/realtime-next/package.json b/examples/realtime-next/package.json
@@ -18,7 +18,7 @@
     "react-dom": "^19.0.0",
     "tailwind-merge": "^3.3.0",
     "wavtools": "^0.1.5",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4",
diff --git a/examples/realtime-twilio/package.json b/examples/realtime-twilio/package.json
@@ -9,7 +9,7 @@
     "dotenv": "^16.5.0",
     "fastify": "^5.3.3",
     "ws": "^8.18.1",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/examples/research-bot/package.json b/examples/research-bot/package.json
@@ -3,7 +3,7 @@
   "name": "research-bot",
   "dependencies": {
     "@openai/agents": "workspace:*",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/examples/tools/package.json b/examples/tools/package.json
@@ -4,7 +4,7 @@
   "dependencies": {
     "@openai/agents": "workspace:*",
     "playwright": "^1.52.0",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "scripts": {
     "build-check": "tsc --noEmit",
diff --git a/packages/agents-core/package.json b/packages/agents-core/package.json
@@ -88,12 +88,11 @@
     "@modelcontextprotocol/sdk": "^1.17.2"
   },
   "dependencies": {
-    "@openai/zod": "npm:zod@3.25.40 - 3.25.67",
     "debug": "^4.4.0",
     "openai": "^5.10.1"
   },
   "peerDependencies": {
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "peerDependenciesMeta": {
     "zod": {
@@ -121,7 +120,7 @@
   },
   "devDependencies": {
     "@types/debug": "^4.1.12",
-    "zod": "3.25.40 - 3.25.67"
+    "zod": "^3.25.40"
   },
   "files": [
     "dist"
diff --git a/packages/agents-core/src/agent.ts b/packages/agents-core/src/agent.ts
@@ -1,4 +1,4 @@
-import type { ZodObject } from 'zod/v3';
+import type { ZodObject } from 'zod';
 
 import type { InputGuardrail, OutputGuardrail } from './guardrail';
 import { AgentHooks } from './lifecycle';
diff --git a/packages/agents-core/src/mcp.ts b/packages/agents-core/src/mcp.ts
@@ -8,7 +8,7 @@ import {
 import { getCurrentSpan, withMCPListToolsSpan } from './tracing';
 import { logger as globalLogger, getLogger, Logger } from './logger';
 import debug from 'debug';
-import { z } from '@openai/zod/v3';
+import { z } from 'zod';
 import {
   JsonObjectSchema,
   JsonObjectSchemaNonStrict,
diff --git a/packages/agents-core/src/metadata.ts b/packages/agents-core/src/metadata.ts
@@ -6,7 +6,6 @@ export const METADATA = {
   "version": "0.0.16",
   "versions": {
     "@openai/agents-core": "0.0.16",
-    "@openai/zod": "npm:zod@3.25.40 - 3.25.67",
     "openai": "^5.10.1"
   }
 };
diff --git a/packages/agents-core/src/runImplementation.ts b/packages/agents-core/src/runImplementation.ts
@@ -31,7 +31,7 @@ import { safeExecute } from './utils/safeExecute';
 import { addErrorToCurrentSpan } from './tracing/context';
 import { RunItemStreamEvent, RunItemStreamEventName } from './events';
 import { StreamedRunResult } from './result';
-import { z } from '@openai/zod/v3';
+import { z } from 'zod';
 import { toSmartString } from './utils/smartString';
 import * as protocol from './types/protocol';
 import { Computer } from './computer';
diff --git a/packages/agents-core/src/runState.ts b/packages/agents-core/src/runState.ts
@@ -1,4 +1,4 @@
-import { z } from '@openai/zod/v3';
+import { z } from 'zod';
 import { Agent } from './agent';
 import {
   RunMessageOutputItem,
diff --git a/packages/agents-core/src/tool.ts b/packages/agents-core/src/tool.ts
@@ -1,5 +1,5 @@
 import type { Computer } from './computer';
-import type { infer as zInfer, ZodObject } from 'zod/v3';
+import type { infer as zInfer, ZodObject } from 'zod';
 import {
   JsonObjectSchema,
   JsonObjectSchemaNonStrict,
diff --git a/packages/agents-core/src/types/helpers.ts b/packages/agents-core/src/types/helpers.ts
@@ -1,4 +1,4 @@
-import type { ZodObject, infer as zInfer } from 'zod/v3';
+import type { ZodObject, infer as zInfer } from 'zod';
 import { Agent, AgentOutputType } from '../agent';
 import { ToolInputParameters } from '../tool';
 import { Handoff } from '../handoff';
diff --git a/packages/agents-core/src/types/protocol.ts b/packages/agents-core/src/types/protocol.ts
@@ -1,4 +1,4 @@
-import { z } from '@openai/zod/v3';
+import { z } from 'zod';
 
 // ----------------------------
 // Shared base types
diff --git a/packages/agents-core/src/utils/typeGuards.ts b/packages/agents-core/src/utils/typeGuards.ts
@@ -1,4 +1,4 @@
-import type { ZodObject } from 'zod/v3';
+import type { ZodObject } from 'zod';
 
 /**
  * Verifies that an input is a ZodObject without needing to have Zod at runtime since it's an
diff --git a/packages/agents-core/test/agent.test.ts b/packages/agents-core/test/agent.test.ts
@@ -2,7 +2,7 @@ import { describe, it, expect } from 'vitest';
 import { Agent } from '../src/agent';
 import { RunContext } from '../src/runContext';
 import { Handoff, handoff } from '../src/handoff';
-import { z } from 'zod/v3';
+import { z } from 'zod';
 import { JsonSchemaDefinition, setDefaultModelProvider } from '../src';
 import { FakeModelProvider } from './stubs';
 
diff --git a/packages/agents-core/test/handoff.test.ts b/packages/agents-core/test/handoff.test.ts
@@ -2,7 +2,7 @@ import { describe, it, expect, vi } from 'vitest';
 import { Agent } from '../src/agent';
 import { handoff, getHandoff, Handoff } from '../src/handoff';
 import { ModelBehaviorError, UserError } from '../src/errors';
-import { z } from 'zod/v3';
+import { z } from 'zod';
 
 const agent = new Agent({ name: 'A' });
 
diff --git a/packages/agents-core/test/handoffs.test.ts b/packages/agents-core/test/handoffs.test.ts
@@ -5,7 +5,7 @@ import {
   setDefaultModelProvider,
   setTracingDisabled,
 } from '../src/index';
-import { z } from 'zod/v3';
+import { z } from 'zod';
 import { FakeModelProvider } from './stubs';
 import { getTransferMessage, handoff } from '../src/handoff';
 
diff --git a/packages/agents-core/test/run.test.ts b/packages/agents-core/test/run.test.ts
@@ -1,5 +1,5 @@
 import { beforeAll, describe, expect, expectTypeOf, it, vi } from 'vitest';
-import { z } from 'zod/v3';
+import { z } from 'zod';
 import {
   Agent,
   MaxTurnsExceededError,
diff --git a/packages/agents-core/test/runImplementation.test.ts b/packages/agents-core/test/runImplementation.test.ts
@@ -1,5 +1,5 @@
 import { describe, expect, it, vi, beforeEach, beforeAll } from 'vitest';
-import { z } from 'zod/v3';
+import { z } from 'zod';
 
 import { Agent } from '../src/agent';
 import {
diff --git a/packages/agents-core/test/stubs.ts b/packages/agents-core/test/stubs.ts
@@ -1,4 +1,4 @@
-import { z } from 'zod/v3';
+import { z } from 'zod';
 import { Agent } from '../src/agent';
 import {
   Model,
diff --git a/packages/agents-core/test/tool.test.ts b/packages/agents-core/test/tool.test.ts
@@ -1,6 +1,6 @@
 import { describe, it, expect } from 'vitest';
 import { computerTool, hostedMcpTool, tool } from '../src/tool';
-import { z } from 'zod/v3';
+import { z } from 'zod';
 import { Computer } from '../src';
 import { RunContext } from '../src/runContext';
 
diff --git a/packages/agents-core/test/utils/tools.test.ts b/packages/agents-core/test/utils/tools.test.ts
@@ -3,7 +3,7 @@ import {
   toFunctionToolName,
   getSchemaAndParserFromInputType,
 } from '../../src/utils/tools';
-import { z } from 'zod/v3';
+import { z } from 'zod';
 import { UserError } from '../../src/errors';
 import { JsonObjectSchema, JsonSchemaDefinitionEntry } from '../../src/types';
 
diff --git a/packages/agents-core/test/utils/typeGuards.test.ts b/packages/agents-core/test/utils/typeGuards.test.ts
@@ -1,6 +1,6 @@
 import { describe, it, expect } from 'vitest';
 import { isZodObject, isAgentToolInput } from '../../src/utils/typeGuards';
-import { z } from 'zod/v3';
+import { z } from 'zod';
 
 describe('type guards', () => {
   it('isZodObject detects zod objects', () => {
diff --git a/packages/agents-extensions/package.json b/packages/agents-extensions/package.json
@@ -14,7 +14,6 @@
   },
   "dependencies": {
     "@ai-sdk/provider": "^1.1.3",
-    "@openai/zod": "npm:zod@3.25.40 - 3.25.67",
     "@types/ws": "^8.18.1",
     "debug": "^4.4.0"
   },
@@ -30,7 +29,8 @@
   },
   "peerDependencies": {
     "@openai/agents": "workspace:*",
-    "ws": "^8.18.1"
+    "ws": "^8.18.1",
+    "zod": "^3.25.40"
   },
   "keywords": [
     "openai",
@@ -42,7 +42,8 @@
   "devDependencies": {
     "@openai/agents": "workspace:*",
     "@types/debug": "^4.1.12",
-    "ws": "^8.18.1"
+    "ws": "^8.18.1",
+    "zod": "^3.25.40"
   },
   "files": [
     "dist"
diff --git a/packages/agents-extensions/src/metadata.ts b/packages/agents-extensions/src/metadata.ts
@@ -5,8 +5,7 @@ export const METADATA = {
   "name": "@openai/agents-extensions",
   "version": "0.0.16",
   "versions": {
-    "@openai/agents-extensions": "0.0.16",
-    "@openai/zod": "npm:zod@3.25.40 - 3.25.67"
+    "@openai/agents-extensions": "0.0.16"
   }
 };
 
diff --git a/packages/agents-openai/package.json b/packages/agents-openai/package.json
@@ -19,7 +19,6 @@
   },
   "dependencies": {
     "@openai/agents-core": "workspace:*",
-    "@openai/zod": "npm:zod@3.25.40 - 3.25.67",
     "debug": "^4.4.0",
     "openai": "^5.10.1"
   },
@@ -35,9 +34,13 @@
     "agentic"
   ],
   "license": "MIT",
+  "peerDependencies": {
+    "zod": "^3.25.40"
+  },
   "devDependencies": {
     "@ai-sdk/provider": "^1.1.3",
-    "@types/debug": "^4.1.12"
+    "@types/debug": "^4.1.12",
+    "zod": "^3.25.40"
   },
   "files": [
     "dist"
diff --git a/packages/agents-openai/src/metadata.ts b/packages/agents-openai/src/metadata.ts
@@ -7,7 +7,6 @@ export const METADATA = {
   "versions": {
     "@openai/agents-openai": "0.0.16",
     "@openai/agents-core": "workspace:*",
-    "@openai/zod": "npm:zod@3.25.40 - 3.25.67",
     "openai": "^5.10.1"
   }
 };
diff --git a/packages/agents-openai/src/openaiResponsesModel.ts b/packages/agents-openai/src/openaiResponsesModel.ts
@@ -25,7 +25,7 @@ import {
   ToolChoiceOptions,
   ToolChoiceTypes,
 } from 'openai/resources/responses/responses';
-import { z } from '@openai/zod/v3';
+import { z } from 'zod';
 import { HEADERS } from './defaults';
 import {
   CodeInterpreterStatus,
diff --git a/packages/agents-openai/src/tools.ts b/packages/agents-openai/src/tools.ts
@@ -1,6 +1,6 @@
 import { HostedTool } from '@openai/agents-core';
 import type OpenAI from 'openai';
-import { z } from '@openai/zod/v3';
+import { z } from 'zod';
 import * as ProviderData from './types/providerData';
 
 // -----------------------------------------------------
diff --git a/packages/agents-realtime/package.json b/packages/agents-realtime/package.json
diff --git a/packages/agents-realtime/src/items.ts b/packages/agents-realtime/src/items.ts
diff --git a/packages/agents-realtime/src/metadata.ts b/packages/agents-realtime/src/metadata.ts
diff --git a/packages/agents-realtime/src/openaiRealtimeEvents.ts b/packages/agents-realtime/src/openaiRealtimeEvents.ts
diff --git a/packages/agents-realtime/test/stubs.ts b/packages/agents-realtime/test/stubs.ts
diff --git a/packages/agents/package.json b/packages/agents/package.json
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
