feat: #561 support both zod3 and zod4 (#609)

Author: seratch

.changeset/goofy-llamas-listen.md

@@ -0,0 +1,9 @@
+---
+'@openai/agents-extensions': minor
+'@openai/agents-realtime': minor
+'@openai/agents-openai': minor
+'@openai/agents-core': minor
+'@openai/agents': minor
+---
+
+feat: #561 support both zod3 and zod4

integration-tests/deno.test.ts

@@ -13,7 +13,7 @@ describe('Deno', () => {
     await execa`deno install`;
   }, 60000);
 
-  test('should be able to run', async () => {
+  test('should be able to run', { timeout: 60000 }, async () => {
     const { stdout } = await execa`deno --allow-net --allow-env main.ts`;
     expect(stdout).toContain('[RESPONSE]Hello there![/RESPONSE]');
   });

integration-tests/node-zod3.test.ts

@@ -0,0 +1,32 @@
+import { describe, test, expect, beforeAll } from 'vitest';
+import { execa as execaBase } from 'execa';
+
+const execa = execaBase({
+  cwd: './integration-tests/node-zod3',
+  env: {
+    ...process.env,
+    NODE_OPTIONS: '',
+    TS_NODE_PROJECT: '',
+    TS_NODE_COMPILER_OPTIONS: '',
+  },
+});
+
+describe('Node.js', () => {
+  beforeAll(async () => {
+    // remove lock file to avoid errors
+    console.log('[node] Removing node_modules');
+    await execa`rm -rf node_modules`;
+    console.log('[node] Installing dependencies');
+    await execa`npm install`;
+  }, 60000);
+
+  test('should be able to run using CommonJS', async () => {
+    const { stdout } = await execa`npm run start:cjs`;
+    expect(stdout).toContain('[RESPONSE]Hello there![/RESPONSE]');
+  });
+
+  test('should be able to run using ESM', async () => {
+    const { stdout } = await execa`npm run start:esm`;
+    expect(stdout).toContain('[RESPONSE]Hello there![/RESPONSE]');
+  });
+});

integration-tests/node-zod3/.npmrc

@@ -0,0 +1,2 @@
+@openai:registry=http://localhost:4873
+package-lock=false

integration-tests/node-zod3/index.cjs

@@ -0,0 +1,37 @@
+// @ts-check
+
+const {
+  Agent,
+  run,
+  tool,
+  setTraceProcessors,
+  ConsoleSpanExporter,
+  BatchTraceProcessor,
+} = require('@openai/agents');
+
+const { z } = require('zod');
+
+setTraceProcessors([new BatchTraceProcessor(new ConsoleSpanExporter())]);
+
+const getWeatherTool = tool({
+  name: 'get_weather',
+  description: 'Get the weather for a given city',
+  parameters: z.object({ city: z.string() }),
+  execute: async (input) => {
+    return `The weather in ${input.city} is sunny`;
+  },
+});
+
+const agent = new Agent({
+  name: 'Test Agent',
+  instructions:
+    'You will always only respond with "Hello there!". Not more not less.',
+  tools: [getWeatherTool],
+});
+
+async function main() {
+  const result = await run(agent, 'Hey there!');
+  console.log(`[RESPONSE]${result.finalOutput}[/RESPONSE]`);
+}
+
+main().catch(console.error);

integration-tests/node-zod3/index.mjs

@@ -0,0 +1,33 @@
+// @ts-check
+
+import { z } from 'zod';
+
+import {
+  Agent,
+  run,
+  tool,
+  setTraceProcessors,
+  ConsoleSpanExporter,
+  BatchTraceProcessor,
+} from '@openai/agents';
+
+setTraceProcessors([new BatchTraceProcessor(new ConsoleSpanExporter())]);
+
+const getWeatherTool = tool({
+  name: 'get_weather',
+  description: 'Get the weather for a given city',
+  parameters: z.object({ city: z.string() }),
+  execute: async (input) => {
+    return `The weather in ${input.city} is sunny`;
+  },
+});
+
+const agent = new Agent({
+  name: 'Test Agent',
+  instructions:
+    'You will always only respond with "Hello there!". Not more not less.',
+  tools: [getWeatherTool],
+});
+
+const result = await run(agent, 'What is the weather in San Francisco?');
+console.log(`[RESPONSE]${result.finalOutput}[/RESPONSE]`);

integration-tests/node-zod3/package.json

@@ -0,0 +1,13 @@
+{
+  "private": true,
+  "type": "commonjs",
+  "scripts": {
+    "start:cjs": "node --no-experimental-require-module index.cjs",
+    "start:esm": "node --no-experimental-require-module index.mjs"
+  },
+  "dependencies": {
+    "@openai/agents": "latest",
+    "typescript": "^5.9.3",
+    "zod": "^3.25.40"
+  }
+}

integration-tests/node-zod4.test.ts

@@ -0,0 +1,32 @@
+import { describe, test, expect, beforeAll } from 'vitest';
+import { execa as execaBase } from 'execa';
+
+const execa = execaBase({
+  cwd: './integration-tests/node-zod4',
+  env: {
+    ...process.env,
+    NODE_OPTIONS: '',
+    TS_NODE_PROJECT: '',
+    TS_NODE_COMPILER_OPTIONS: '',
+  },
+});
+
+describe('Node.js', () => {
+  beforeAll(async () => {
+    // remove lock file to avoid errors
+    console.log('[node] Removing node_modules');
+    await execa`rm -rf node_modules`;
+    console.log('[node] Installing dependencies');
+    await execa`npm install`;
+  }, 60000);
+
+  test('should be able to run using CommonJS', async () => {
+    const { stdout } = await execa`npm run start:cjs`;
+    expect(stdout).toContain('[RESPONSE]Hello there![/RESPONSE]');
+  });
+
+  test('should be able to run using ESM', async () => {
+    const { stdout } = await execa`npm run start:esm`;
+    expect(stdout).toContain('[RESPONSE]Hello there![/RESPONSE]');
+  });
+});

integration-tests/node-zod4/.npmrc

@@ -0,0 +1,2 @@
+@openai:registry=http://localhost:4873
+package-lock=false

integration-tests/node-zod4/index.cjs

@@ -0,0 +1,37 @@
+// @ts-check
+
+const {
+  Agent,
+  run,
+  tool,
+  setTraceProcessors,
+  ConsoleSpanExporter,
+  BatchTraceProcessor,
+} = require('@openai/agents');
+
+const { z } = require('zod');
+
+setTraceProcessors([new BatchTraceProcessor(new ConsoleSpanExporter())]);
+
+const getWeatherTool = tool({
+  name: 'get_weather',
+  description: 'Get the weather for a given city',
+  parameters: z.object({ city: z.string() }),
+  execute: async (input) => {
+    return `The weather in ${input.city} is sunny`;
+  },
+});
+
+const agent = new Agent({
+  name: 'Test Agent',
+  instructions:
+    'You will always only respond with "Hello there!". Not more not less.',
+  tools: [getWeatherTool],
+});
+
+async function main() {
+  const result = await run(agent, 'Hey there!');
+  console.log(`[RESPONSE]${result.finalOutput}[/RESPONSE]`);
+}
+
+main().catch(console.error);