chore: zod 4

package.json

@@ -98,7 +98,6 @@
     "ws": "^8.17.1",
     "xml2js": "^0.5.0",
     "yaml": "2.6.0",
-    "zod": "^3.25.76",
-    "zod-to-json-schema": "^3.25.1"
+    "zod": "^4.3.5"
   }
 }

packages/playwright-client/types/types.d.ts

@@ -28,9 +28,11 @@ type ElementHandleWaitForSelectorOptionsNotHidden = ElementHandleWaitForSelector
 };
 
 // @ts-ignore this will be any if zod is not installed
-type ZodTypeAny = import('zod').ZodTypeAny;
+import { ZodTypeAny, z } from 'zod';
 // @ts-ignore this will be any if zod is not installed
-type ZodInfer<T extends ZodTypeAny> = import('zod').infer<T>;
+import * as z3 from 'zod/v3';
+type ZodSchema = ZodTypeAny | z3.ZodTypeAny;
+type InferZodSchema<T extends ZodSchema> = T extends z3.ZodTypeAny ? z3.infer<T> : T extends ZodTypeAny ? z.infer<T> : never;
 
 /**
  * Page provides methods to interact with a single tab in a [Browser](https://playwright.dev/docs/api/class-browser),
@@ -5305,7 +5307,7 @@ export interface PageAgent {
    * @param schema
    * @param options
    */
-  extract<Schema extends ZodTypeAny>(query: string, schema: Schema): Promise<{ result: ZodInfer<Schema>, usage: { turns: number, inputTokens: number, outputTokens: number } }>;
+  extract<Schema extends ZodSchema>(query: string, schema: Schema): Promise<{ result: InferZodSchema<Schema>, usage: { turns: number, inputTokens: number, outputTokens: number } }>;
   /**
    * Emitted when the agent makes a turn.
    */

packages/playwright-core/ThirdPartyNotices.txt

@@ -136,7 +136,7 @@ This project incorporates components from the projects listed below. The origina
 -	yauzl@3.2.0 (https://github.com/thejoshwolfe/yauzl)
 -	yazl@2.5.1 (https://github.com/thejoshwolfe/yazl)
 -	zod-to-json-schema@3.25.1 (https://github.com/StefanTerdell/zod-to-json-schema)
--	zod@3.25.76 (https://github.com/colinhacks/zod)
+-	zod@4.3.5 (https://github.com/colinhacks/zod)
 
 %% @hono/node-server@1.19.8 NOTICES AND INFORMATION BEGIN HERE
 =========================================
@@ -4043,7 +4043,7 @@ OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 =========================================
 END OF zod-to-json-schema@3.25.1 AND INFORMATION
 
-%% zod@3.25.76 NOTICES AND INFORMATION BEGIN HERE
+%% zod@4.3.5 NOTICES AND INFORMATION BEGIN HERE
 =========================================
 MIT License
 
@@ -4067,7 +4067,7 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 =========================================
-END OF zod@3.25.76 AND INFORMATION
+END OF zod@4.3.5 AND INFORMATION
 
 SUMMARY BEGIN HERE
 =========================================

packages/playwright-core/bundles/mcp/package.json

@@ -5,7 +5,7 @@
   "dependencies": {
     "@lowire/loop": "^0.0.23",
     "@modelcontextprotocol/sdk": "^1.25.2",
-    "zod": "^3.25.76",
+    "zod": "^4.3.5",
     "zod-to-json-schema": "^3.25.1"
   }
 }

packages/playwright-core/bundles/mcp/src/mcpBundleImpl.ts

@@ -24,5 +24,5 @@ export { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/
 export { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 export { CallToolRequestSchema, ListRootsRequestSchema, ListToolsRequestSchema, PingRequestSchema, ProgressNotificationSchema } from '@modelcontextprotocol/sdk/types.js';
 export { Loop } from '@lowire/loop';
-export { z } from 'zod';
+export * as z from 'zod';
 export { zodToJsonSchema } from 'zod-to-json-schema';

packages/playwright-core/bundles/utils/package.json

@@ -21,8 +21,7 @@
     "signal-exit": "3.0.7",
     "socks-proxy-agent": "8.0.5",
     "ws": "8.17.1",
-    "yaml": "^2.6.0",
-    "zod": "^3.25.76"
+    "yaml": "^2.6.0"
   },
   "devDependencies": {
     "@types/debug": "^4.1.7",

packages/playwright-core/bundles/utils/src/utilsBundleImpl.ts

@@ -66,6 +66,3 @@ export const wsSender = Sender;
 
 import yamlLibrary from 'yaml';
 export const yaml = yamlLibrary;
-
-import zodLibrary from 'zod';
-export const zod = zodLibrary;

packages/playwright-core/src/client/pageAgent.ts

@@ -20,7 +20,6 @@ import { Events } from './events';
 import { Page } from './page';
 
 import type * as api from '../../types/types';
-import type z from 'zod';
 import type * as channels from '@protocol/channels';
 
 type PageAgentOptions = {
@@ -51,7 +50,7 @@ export class PageAgent extends ChannelOwner<channels.PageAgentChannel> implement
     return { usage };
   }
 
-  async extract<Schema extends z.ZodTypeAny>(query: string, schema: Schema, options: PageAgentOptions = {}): Promise<{ result: z.infer<Schema>, usage: channels.AgentUsage }> {
+  async extract<Schema extends any>(query: string, schema: Schema, options: PageAgentOptions = {}): Promise<{ result: any, usage: channels.AgentUsage }> {
     const { result, usage } = await this._channel.extract({ query, schema: this._page._platform.zodToJsonSchema(schema), ...options });
     return { result, usage };
   }

packages/playwright-core/src/server/agent/actions.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { zod } from '../../utilsBundle';
-import type z from 'zod';
+import { z as zod } from '../../mcpBundle';
+import type * as z from 'zod';
 
 const modifiersSchema = zod.array(
     zod.enum(['Alt', 'Control', 'ControlOrMeta', 'Meta', 'Shift'])
@@ -139,7 +139,7 @@ const actionWithCodeSchema = actionSchema.and(zod.object({
 }));
 export type ActionWithCode = z.infer<typeof actionWithCodeSchema>;
 
-export const cachedActionsSchema = zod.record(zod.object({
+export const cachedActionsSchema = zod.record(zod.string(), zod.object({
   actions: zod.array(actionWithCodeSchema),
 }));
 export type CachedActions = z.infer<typeof cachedActionsSchema>;

packages/playwright-core/src/server/agent/pageAgent.ts

@@ -19,7 +19,7 @@ import path from 'path';
 
 import { toolsForLoop } from './tool';
 import { debug } from '../../utilsBundle';
-import { Loop } from '../../mcpBundle';
+import { Loop, z as zod } from '../../mcpBundle';
 import { runAction } from './actionRunner';
 import { Context } from './context';
 import performTools from './performTools';
@@ -205,7 +205,7 @@ async function cachedActions(cacheFile: string): Promise<Cache> {
     const text = await fs.promises.readFile(cacheFile, 'utf-8').catch(() => '{}');
     const parsed = actions.cachedActionsSchema.safeParse(JSON.parse(text));
     if (parsed.error)
-      throw new Error(`Failed to parse cache file ${cacheFile}: ${parsed.error.issues.map(issue => issue.message).join(', ')}`);
+      throw new Error(`Failed to parse cache file ${cacheFile}:\n${zod.prettifyError(parsed.error)}`);
     cache = { actions: parsed.data, newActions: {} };
     allCaches.set(cacheFile, cache);
   }

packages/playwright-core/src/server/agent/tool.ts

@@ -14,8 +14,7 @@
  * limitations under the License.
  */
 
-import { zodToJsonSchema } from '../../mcpBundle';
-
+import { z } from '../../mcpBundle';
 import type zod from 'zod';
 import type * as loopTypes from '@lowire/loop';
 import type { Context } from './context';
@@ -40,7 +39,7 @@ export function toolsForLoop(progress: Progress, context: Context, toolDefinitio
     const result: loopTypes.Tool = {
       name: tool.schema.name,
       description: tool.schema.description,
-      inputSchema: zodToJsonSchema(tool.schema.inputSchema) as loopTypes.Schema,
+      inputSchema: z.toJSONSchema(tool.schema.inputSchema) as loopTypes.Schema,
     };
     return result;
   });

packages/playwright-core/src/server/utils/nodePlatform.ts

@@ -25,7 +25,9 @@ import { colors } from '../../utilsBundle';
 import { debugLogger } from './debugLogger';
 import { currentZone, emptyZone } from './zones';
 import { debugMode, isUnderTest } from './debug';
-import { zodToJsonSchema } from '../../mcpBundle';
+import { zodToJsonSchema as zodToJsonSchemaV3, z } from '../../mcpBundle';
+import type zod3 from 'zod/v3';
+import type zod4 from 'zod';
 
 import type { Platform, Zone } from '../../client/platform';
 import type { Zone as ZoneImpl } from './zones';
@@ -124,7 +126,12 @@ export const nodePlatform: Platform = {
     return new WritableStreamImpl(channel);
   },
 
-  zodToJsonSchema,
+  zodToJsonSchema: (schema: zod3.Schema | zod4.Schema): any => {
+    // https://zod.dev/library-authors?id=how-to-support-zod-3-and-zod-4-simultaneously
+    if ('_zod' in schema)
+      return z.toJSONSchema(schema);
+    return zodToJsonSchemaV3(schema);
+  },
 
   zones: {
     current: () => new NodeZone(currentZone()),

packages/playwright-core/src/utilsBundle.ts

@@ -36,7 +36,6 @@ export const wsReceiver = require('./utilsBundleImpl').wsReceiver;
 export const wsSender = require('./utilsBundleImpl').wsSender;
 export const yaml: typeof import('../bundles/utils/node_modules/yaml') = require('./utilsBundleImpl').yaml;
 export type { Range as YAMLRange, Scalar as YAMLScalar, YAMLError, YAMLMap, YAMLSeq } from '../bundles/utils/node_modules/yaml';
-export const zod: typeof import('../bundles/utils/node_modules/zod') = require('./utilsBundleImpl').zod;
 export type { Command } from '../bundles/utils/node_modules/commander';
 export type { EventEmitter as WebSocketEventEmitter, RawData as WebSocketRawData, WebSocket, WebSocketServer } from '../bundles/utils/node_modules/@types/ws';
 

packages/playwright-core/types/types.d.ts

@@ -28,9 +28,11 @@ type ElementHandleWaitForSelectorOptionsNotHidden = ElementHandleWaitForSelector
 };
 
 // @ts-ignore this will be any if zod is not installed
-type ZodTypeAny = import('zod').ZodTypeAny;
+import { ZodTypeAny, z } from 'zod';
 // @ts-ignore this will be any if zod is not installed
-type ZodInfer<T extends ZodTypeAny> = import('zod').infer<T>;
+import * as z3 from 'zod/v3';
+type ZodSchema = ZodTypeAny | z3.ZodTypeAny;
+type InferZodSchema<T extends ZodSchema> = T extends z3.ZodTypeAny ? z3.infer<T> : T extends ZodTypeAny ? z.infer<T> : never;
 
 /**
  * Page provides methods to interact with a single tab in a [Browser](https://playwright.dev/docs/api/class-browser),
@@ -5305,7 +5307,7 @@ export interface PageAgent {
    * @param schema
    * @param options
    */
-  extract<Schema extends ZodTypeAny>(query: string, schema: Schema): Promise<{ result: ZodInfer<Schema>, usage: { turns: number, inputTokens: number, outputTokens: number } }>;
+  extract<Schema extends ZodSchema>(query: string, schema: Schema): Promise<{ result: InferZodSchema<Schema>, usage: { turns: number, inputTokens: number, outputTokens: number } }>;
   /**
    * Emitted when the agent makes a turn.
    */

packages/playwright/src/common/validators.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { zod } from 'playwright-core/lib/utilsBundle';
+import { z as zod } from 'playwright-core/lib/mcpBundle';
 
 import type { TestAnnotation, TestDetailsAnnotation } from '../../types/test';
 import type { Location } from '../../types/testReporter';

packages/playwright/src/mcp/browser/browserServerBackend.ts

@@ -58,7 +58,7 @@ export class BrowserServerBackend implements ServerBackend {
     const tool = this._tools.find(tool => tool.schema.name === name)!;
     if (!tool)
       throw new Error(`Tool "${name}" not found`);
-    const parsedArguments = tool.schema.inputSchema.parse(rawArguments || {});
+    const parsedArguments = tool.schema.inputSchema.parse(rawArguments || {}) as any;
     const context = this._context!;
     const response = new Response(context, name, parsedArguments);
     response.logBegin();

packages/playwright/src/mcp/sdk/tool.ts

@@ -14,8 +14,7 @@
  * limitations under the License.
  */
 
-import { zodToJsonSchema } from 'playwright-core/lib/mcpBundle';
-
+import { z as zod } from 'playwright-core/lib/mcpBundle';
 import type { z } from 'zod';
 import type * as mcpServer from './server';
 
@@ -32,7 +31,7 @@ export function toMcpTool(tool: ToolSchema<any>): mcpServer.Tool {
   return {
     name: tool.name,
     description: tool.description,
-    inputSchema: zodToJsonSchema(tool.inputSchema, { strictUnions: true }) as mcpServer.Tool['inputSchema'],
+    inputSchema: zod.toJSONSchema(tool.inputSchema) as mcpServer.Tool['inputSchema'],
     annotations: {
       title: tool.title,
       readOnlyHint: readOnly,