playwright 1.58.0-alpha-2025-12-17 → 1.58.0-alpha-2025-12-19

package/lib/common/config.js

@@ -87,14 +87,15 @@ class FullConfigInternal {
       maxFailures: takeFirst(configCLIOverrides.debug ? 1 : void 0, configCLIOverrides.maxFailures, userConfig.maxFailures, 0),
       metadata: metadata ?? userConfig.metadata,
       preserveOutput: takeFirst(userConfig.preserveOutput, "always"),
+      projects: [],
+      quiet: takeFirst(configCLIOverrides.quiet, userConfig.quiet, false),
       reporter: takeFirst(configCLIOverrides.reporter, resolveReporters(userConfig.reporter, configDir), [[defaultReporter]]),
       reportSlowTests: takeFirst(userConfig.reportSlowTests, {
         max: 5,
         threshold: 3e5
         /* 5 minutes */
       }),
-      quiet: takeFirst(configCLIOverrides.quiet, userConfig.quiet, false),
-      projects: [],
+      runAgents: takeFirst(configCLIOverrides.runAgents, userConfig.runAgents, false),
       shard: takeFirst(configCLIOverrides.shard, userConfig.shard, null),
       tags: globalTags,
       updateSnapshots: takeFirst(configCLIOverrides.updateSnapshots, userConfig.updateSnapshots, "missing"),

package/lib/index.js

@@ -111,7 +111,6 @@ const playwrightFixtures = {
     await browser.close({ reason: "Test ended." });
   }, { scope: "worker", timeout: 0 }],
   acceptDownloads: [({ contextOptions }, use) => use(contextOptions.acceptDownloads ?? true), { option: true, box: true }],
-  agent: [({ contextOptions }, use) => use(contextOptions.agent), { option: true, box: true }],
   bypassCSP: [({ contextOptions }, use) => use(contextOptions.bypassCSP ?? false), { option: true, box: true }],
   colorScheme: [({ contextOptions }, use) => use(contextOptions.colorScheme === void 0 ? "light" : contextOptions.colorScheme), { option: true, box: true }],
   deviceScaleFactor: [({ contextOptions }, use) => use(contextOptions.deviceScaleFactor), { option: true, box: true }],
@@ -139,9 +138,9 @@ const playwrightFixtures = {
   }, { option: true, box: true }],
   serviceWorkers: [({ contextOptions }, use) => use(contextOptions.serviceWorkers ?? "allow"), { option: true, box: true }],
   contextOptions: [{}, { option: true, box: true }],
+  agent: [({}, use) => use(void 0), { option: true, box: true }],
   _combinedContextOptions: [async ({
     acceptDownloads,
-    agent,
     bypassCSP,
     clientCertificates,
     colorScheme,
@@ -168,8 +167,6 @@ const playwrightFixtures = {
     const options = {};
     if (acceptDownloads !== void 0)
       options.acceptDownloads = acceptDownloads;
-    if (agent !== void 0)
-      options.agent = agent;
     if (bypassCSP !== void 0)
       options.bypassCSP = bypassCSP;
     if (colorScheme !== void 0)
@@ -612,19 +609,24 @@ class ArtifactsRecorder {
     }
   }
   async _cloneAgentCache(options) {
-    if (!this._agent || this._agent.cacheMode === "ignore")
+    if (!this._agent)
       return;
-    if (!this._agent.cacheFile && !this._agent.cachePathTemplate)
-      return;
-    const cacheFile = this._agent.cacheFile ?? this._testInfo._applyPathTemplate(this._agent.cachePathTemplate, "cache", ".json");
-    const workerFile = await this._testInfo._cloneStorage(cacheFile);
-    if (this._agent && workerFile)
-      options.agent = { ...this._agent, cacheFile: workerFile };
+    const cachePathTemplate = this._agent.cachePathTemplate ?? "{testDir}/{testFilePath}-cache.json";
+    this._agentCacheFile = this._testInfo._applyPathTemplate(cachePathTemplate, "", ".json");
+    this._agentCacheOutFile = import_path.default.join(this._testInfo.artifactsDir(), "agent-cache-" + (0, import_utils.createGuid)() + ".json");
+    const cacheFile = this._testInfo.config.runAgents ? void 0 : await this._testInfo._cloneStorage(this._agentCacheFile);
+    options.agent = {
+      ...this._agent,
+      cacheFile,
+      cacheOutFile: this._agentCacheOutFile
+    };
   }
   async _upstreamAgentCache(context) {
-    const agent = context._options.agent;
-    if (this._testInfo.status === "passed" && agent?.cacheFile)
-      await this._testInfo._upstreamStorage(agent.cacheFile);
+    if (!this._agentCacheFile || !this._agentCacheOutFile)
+      return;
+    if (this._testInfo.status !== "passed")
+      return;
+    await this._testInfo._upstreamStorage(this._agentCacheFile, this._agentCacheOutFile);
   }
   async didCreateRequestContext(context) {
     await this._startTraceChunkOnContextCreation(context, context._tracing);

package/lib/isomorphic/teleReceiver.js

@@ -460,6 +460,7 @@ const baseFullConfig = {
   tags: [],
   updateSnapshots: "missing",
   updateSourceMethod: "patch",
+  runAgents: false,
   version: "",
   workers: 0,
   webServer: null

package/lib/mcp/browser/browserContextFactory.js

@@ -134,7 +134,7 @@ class IsolatedContextFactory extends BaseContextFactory {
     });
   }
   async _doCreateContext(browser) {
-    return browser.newContext(this.config.browser.contextOptions);
+    return browser.newContext(browserContextOptionsFromConfig(this.config));
   }
 }
 class CdpContextFactory extends BaseContextFactory {
@@ -184,7 +184,7 @@ class PersistentContextFactory {
       const launchOptions = {
         tracesDir,
         ...this.config.browser.launchOptions,
-        ...this.config.browser.contextOptions,
+        ...browserContextOptionsFromConfig(this.config),
         handleSIGINT: false,
         handleSIGTERM: false,
         ignoreDefaultArgs: [
@@ -303,6 +303,16 @@ async function computeTracesDir(config, clientInfo) {
     return;
   return await (0, import_config.outputFile)(config, clientInfo, `traces`, { origin: "code", reason: "Collecting trace" });
 }
+function browserContextOptionsFromConfig(config) {
+  const result = { ...config.browser.contextOptions };
+  if (config.saveVideo) {
+    result.recordVideo = {
+      dir: (0, import_config.tmpDir)(),
+      size: config.saveVideo
+    };
+  }
+  return result;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SharedContextFactory,

package/lib/mcp/browser/config.js

@@ -40,7 +40,8 @@ __export(config_exports, {
   resolutionParser: () => resolutionParser,
   resolveCLIConfig: () => resolveCLIConfig,
   resolveConfig: () => resolveConfig,
-  semicolonSeparatedList: () => semicolonSeparatedList
+  semicolonSeparatedList: () => semicolonSeparatedList,
+  tmpDir: () => tmpDir
 });
 module.exports = __toCommonJS(config_exports);
 var import_fs = __toESM(require("fs"));
@@ -161,13 +162,6 @@ function configFromCLIOptions(cliOptions) {
     contextOptions.serviceWorkers = "block";
   if (cliOptions.grantPermissions)
     contextOptions.permissions = cliOptions.grantPermissions;
-  if (cliOptions.saveVideo) {
-    contextOptions.recordVideo = {
-      // Videos are moved to output directory on saveAs.
-      dir: tmpDir(),
-      size: cliOptions.saveVideo
-    };
-  }
   const result = {
     browser: {
       browserName,
@@ -419,5 +413,6 @@ function sanitizeForFilePath(s) {
   resolutionParser,
   resolveCLIConfig,
   resolveConfig,
-  semicolonSeparatedList
+  semicolonSeparatedList,
+  tmpDir
 });

package/lib/mcp/browser/tab.js

@@ -154,18 +154,16 @@ class Tab extends import_events.EventEmitter {
   async navigate(url) {
     await this._initializedPromise;
     this._clearCollectedArtifacts();
-    const downloadEvent = (0, import_utils2.callOnPageNoTrace)(this.page, (page) => page.waitForEvent("download").catch(import_log.logUnhandledError));
+    const { promise: downloadEvent, abort: abortDownloadEvent } = (0, import_utils2.eventWaiter)(this.page, "download", 3e3);
     try {
       await this.page.goto(url, { waitUntil: "domcontentloaded" });
+      abortDownloadEvent();
     } catch (_e) {
       const e = _e;
       const mightBeDownload = e.message.includes("net::ERR_ABORTED") || e.message.includes("Download is starting");
       if (!mightBeDownload)
         throw e;
-      const download = await Promise.race([
-        downloadEvent,
-        new Promise((resolve) => setTimeout(resolve, 3e3))
-      ]);
+      const download = await downloadEvent;
       if (!download)
         throw e;
       await new Promise((resolve) => setTimeout(resolve, 500));

package/lib/mcp/browser/tools/utils.js

@@ -20,6 +20,7 @@ var utils_exports = {};
 __export(utils_exports, {
   callOnPageNoTrace: () => callOnPageNoTrace,
   dateAsFileName: () => dateAsFileName,
+  eventWaiter: () => eventWaiter,
   waitForCompletion: () => waitForCompletion
 });
 module.exports = __toCommonJS(utils_exports);
@@ -65,9 +66,29 @@ function dateAsFileName(extension) {
   const date = /* @__PURE__ */ new Date();
   return `page-${date.toISOString().replace(/[:.]/g, "-")}.${extension}`;
 }
+function eventWaiter(page, event, timeout) {
+  const disposables = [];
+  const eventPromise = new Promise((resolve, reject) => {
+    page.on(event, resolve);
+    disposables.push(() => page.off(event, resolve));
+  });
+  let abort;
+  const abortPromise = new Promise((resolve, reject) => {
+    abort = () => resolve(void 0);
+  });
+  const timeoutPromise = new Promise((f) => {
+    const timeoutId = setTimeout(() => f(void 0), timeout);
+    disposables.push(() => clearTimeout(timeoutId));
+  });
+  return {
+    promise: Promise.race([eventPromise, abortPromise, timeoutPromise]).finally(() => disposables.forEach((dispose) => dispose())),
+    abort
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   callOnPageNoTrace,
   dateAsFileName,
+  eventWaiter,
   waitForCompletion
 });

package/lib/mcp/extension/extensionContextFactory.js

@@ -55,7 +55,7 @@ class ExtensionContextFactory {
   async _obtainBrowser(clientInfo, abortSignal, toolName) {
     const relay = await this._startRelay(abortSignal);
     await relay.ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, toolName);
-    return await playwright.chromium.connectOverCDP(relay.cdpEndpoint());
+    return await playwright.chromium.connectOverCDP(relay.cdpEndpoint(), { isLocal: true });
   }
   async _startRelay(abortSignal) {
     const httpServer = await (0, import_http.startHttpServer)({});

package/lib/mcp/program.js

@@ -38,11 +38,10 @@ var mcpServer = __toESM(require("./sdk/server"));
 var import_config = require("./browser/config");
 var import_watchdog = require("./browser/watchdog");
 var import_browserContextFactory = require("./browser/browserContextFactory");
-var import_proxyBackend = require("./sdk/proxyBackend");
 var import_browserServerBackend = require("./browser/browserServerBackend");
 var import_extensionContextFactory = require("./extension/extensionContextFactory");
 function decorateCommand(command, version) {
-  command.option("--allowed-hosts <hosts...>", "comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.", import_config.commaSeparatedList).option("--allowed-origins <origins>", "semicolon-separated list of TRUSTED origins to allow the browser to request. Default is to allow all.\nImportant: *does not* serve as a security boundary and *does not* affect redirects. ", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.\nImportant: *does not* serve as a security boundary and *does not* affect redirects.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--cdp-header <headers...>", "CDP headers to send with the connect request, multiple can be specified.", import_config.headerParser).option("--config <path>", "path to the configuration file.").option("--console-level <level>", 'level of console messages to return: "error", "warning", "info", "debug". Each level includes the messages of more severe levels.', import_config.enumParser.bind(null, "--console-level", ["error", "warning", "info", "debug"])).option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--grant-permissions <permissions...>", 'List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".', import_config.commaSeparatedList).option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--init-page <path...>", "path to TypeScript file to evaluate on Playwright page object").option("--init-script <path...>", "path to JavaScript file to add as an initialization script. The script will be evaluated in every page before any of the page's scripts. Can be specified multiple times.").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".', import_config.enumParser.bind(null, "--image-responses", ["allow", "omit"])).option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--save-video <size>", 'Whether to save the video of the session into the output directory. For example "--save-video=800x600"', import_config.resolutionParser.bind(null, "--save-video")).option("--secrets <path>", "path to a file containing secrets in the dotenv format", import_config.dotenvFileLoader).option("--shared-browser-context", "reuse the same browser context between all connected HTTP clients.").option("--snapshot-mode <mode>", 'when taking snapshots for responses, specifies the mode to use. Can be "incremental", "full", or "none". Default is incremental.').option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--test-id-attribute <attribute>", 'specify the attribute to use for test ids, defaults to "data-testid"').option("--timeout-action <timeout>", "specify action timeout in milliseconds, defaults to 5000ms", import_config.numberParser).option("--timeout-navigation <timeout>", "specify navigation timeout in milliseconds, defaults to 60000ms", import_config.numberParser).option("--user-agent <ua string>", "specify user agent string").option("--user-data-dir <path>", "path to the user data directory. If not specified, a temporary directory will be created.").option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280x720"', import_config.resolutionParser.bind(null, "--viewport-size")).addOption(new import_utilsBundle.ProgramOption("--connect-tool", "Allow to switch between different browser connection methods.").hideHelp()).addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
+  command.option("--allowed-hosts <hosts...>", "comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.", import_config.commaSeparatedList).option("--allowed-origins <origins>", "semicolon-separated list of TRUSTED origins to allow the browser to request. Default is to allow all.\nImportant: *does not* serve as a security boundary and *does not* affect redirects. ", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.\nImportant: *does not* serve as a security boundary and *does not* affect redirects.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--cdp-header <headers...>", "CDP headers to send with the connect request, multiple can be specified.", import_config.headerParser).option("--config <path>", "path to the configuration file.").option("--console-level <level>", 'level of console messages to return: "error", "warning", "info", "debug". Each level includes the messages of more severe levels.', import_config.enumParser.bind(null, "--console-level", ["error", "warning", "info", "debug"])).option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--grant-permissions <permissions...>", 'List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".', import_config.commaSeparatedList).option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--init-page <path...>", "path to TypeScript file to evaluate on Playwright page object").option("--init-script <path...>", "path to JavaScript file to add as an initialization script. The script will be evaluated in every page before any of the page's scripts. Can be specified multiple times.").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".', import_config.enumParser.bind(null, "--image-responses", ["allow", "omit"])).option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--save-video <size>", 'Whether to save the video of the session into the output directory. For example "--save-video=800x600"', import_config.resolutionParser.bind(null, "--save-video")).option("--secrets <path>", "path to a file containing secrets in the dotenv format", import_config.dotenvFileLoader).option("--shared-browser-context", "reuse the same browser context between all connected HTTP clients.").option("--snapshot-mode <mode>", 'when taking snapshots for responses, specifies the mode to use. Can be "incremental", "full", or "none". Default is incremental.').option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--test-id-attribute <attribute>", 'specify the attribute to use for test ids, defaults to "data-testid"').option("--timeout-action <timeout>", "specify action timeout in milliseconds, defaults to 5000ms", import_config.numberParser).option("--timeout-navigation <timeout>", "specify navigation timeout in milliseconds, defaults to 60000ms", import_config.numberParser).option("--user-agent <ua string>", "specify user agent string").option("--user-data-dir <path>", "path to the user data directory. If not specified, a temporary directory will be created.").option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280x720"', import_config.resolutionParser.bind(null, "--viewport-size")).addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
     (0, import_watchdog.setupExitWatchdog)();
     if (options.vision) {
       console.error("The --vision option is deprecated, use --caps=vision instead");
@@ -71,28 +70,6 @@ Please run the command below. It will install a local copy of ffmpeg and will no
       await mcpServer.start(serverBackendFactory, config.server);
       return;
     }
-    if (options.connectTool) {
-      const providers = [
-        {
-          name: "default",
-          description: "Starts standalone browser",
-          connect: () => mcpServer.wrapInProcess(new import_browserServerBackend.BrowserServerBackend(config, browserContextFactory))
-        },
-        {
-          name: "extension",
-          description: "Connect to a browser using the Playwright MCP extension",
-          connect: () => mcpServer.wrapInProcess(new import_browserServerBackend.BrowserServerBackend(config, extensionContextFactory))
-        }
-      ];
-      const factory2 = {
-        name: "Playwright w/ switch",
-        nameInConfig: "playwright-switch",
-        version,
-        create: () => new import_proxyBackend.ProxyBackend(providers)
-      };
-      await mcpServer.start(factory2, config.server);
-      return;
-    }
     const factory = {
       name: "Playwright",
       nameInConfig: "playwright",

package/lib/mcp/sdk/exports.js

@@ -16,14 +16,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var exports_exports = {};
 module.exports = __toCommonJS(exports_exports);
 __reExport(exports_exports, require("./inProcessTransport"), module.exports);
-__reExport(exports_exports, require("./proxyBackend"), module.exports);
 __reExport(exports_exports, require("./server"), module.exports);
 __reExport(exports_exports, require("./tool"), module.exports);
 __reExport(exports_exports, require("./http"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./inProcessTransport"),
-  ...require("./proxyBackend"),
   ...require("./server"),
   ...require("./tool"),
   ...require("./http")

package/lib/program.js

@@ -287,6 +287,7 @@ function overridesFromOptions(options) {
     ignoreSnapshots: options.ignoreSnapshots ? !!options.ignoreSnapshots : void 0,
     updateSnapshots: options.updateSnapshots,
     updateSourceMethod: options.updateSourceMethod,
+    runAgents: options.runAgents,
     workers: options.workers
   };
   if (options.browser) {
@@ -374,6 +375,7 @@ const testOptions = [
   ["--repeat-each <N>", { description: `Run each test N times (default: 1)` }],
   ["--reporter <reporter>", { description: `Reporter to use, comma-separated, can be ${import_config.builtInReporters.map((name) => `"${name}"`).join(", ")} (default: "${import_config.defaultReporter}")` }],
   ["--retries <retries>", { description: `Maximum retry count for flaky tests, zero for no retries (default: no retries)` }],
+  ["--run-agents", { description: `Run agents to generate the code for page.perform` }],
   ["--shard <shard>", { description: `Shard tests and execute only the selected shard, specify in the form "current/all", 1-based, for example "3/5"` }],
   ["--test-list <file>", { description: `Path to a file containing a list of tests to run. See https://playwright.dev/docs/test-cli for more details.` }],
   ["--test-list-invert <file>", { description: `Path to a file containing a list of tests to skip. See https://playwright.dev/docs/test-cli for more details.` }],

package/lib/runner/dispatcher.js

@@ -199,10 +199,10 @@ class Dispatcher {
       this._producedEnvByProjectId.set(testGroup.projectId, { ...producedEnv, ...worker.producedEnv() });
     });
     worker.onRequest("cloneStorage", async (params) => {
-      return await import_storage.Storage.clone(params.storageFile, worker.artifactsDir());
+      return await import_storage.Storage.clone(params.storageFile, outputDir);
     });
     worker.onRequest("upstreamStorage", async (params) => {
-      await import_storage.Storage.upstream(params.workerFile);
+      await import_storage.Storage.upstream(params.storageFile, params.storageOutFile);
     });
     return worker;
   }

package/lib/runner/storage.js

@@ -35,68 +35,55 @@ var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
 var import_utils = require("playwright-core/lib/utils");
 class Storage {
-  constructor(fileName) {
-    this._writeChain = Promise.resolve();
-    this._fileName = fileName;
-  }
   static {
     this._storages = /* @__PURE__ */ new Map();
   }
   static {
-    this._workerFiles = /* @__PURE__ */ new Map();
+    this._serializeQueue = Promise.resolve();
   }
-  static async clone(storageFile, artifactsDir) {
-    const workerFile = await this._storage(storageFile)._clone(artifactsDir);
-    const stat = await import_fs.default.promises.stat(workerFile);
-    const lastModified = stat.mtime.getTime();
-    Storage._workerFiles.set(workerFile, { storageFile, lastModified });
-    return workerFile;
+  static clone(storageFile, outputDir) {
+    return Storage._withStorage(storageFile, (storage) => storage._clone(outputDir));
   }
-  static async upstream(workerFile) {
-    const entry = Storage._workerFiles.get(workerFile);
-    if (!entry)
-      return;
-    const { storageFile, lastModified } = entry;
-    const stat = await import_fs.default.promises.stat(workerFile);
-    const newLastModified = stat.mtime.getTime();
-    if (lastModified !== newLastModified)
-      await this._storage(storageFile)._upstream(workerFile);
-    Storage._workerFiles.delete(workerFile);
+  static upstream(storageFile, storageOutFile) {
+    return Storage._withStorage(storageFile, (storage) => storage._upstream(storageOutFile));
   }
-  static _storage(fileName) {
-    if (!Storage._storages.has(fileName))
-      Storage._storages.set(fileName, new Storage(fileName));
-    return Storage._storages.get(fileName);
+  static _withStorage(fileName, runnable) {
+    this._serializeQueue = this._serializeQueue.then(() => {
+      let storage = Storage._storages.get(fileName);
+      if (!storage) {
+        storage = new Storage(fileName);
+        Storage._storages.set(fileName, storage);
+      }
+      return runnable(storage);
+    });
+    return this._serializeQueue;
   }
-  async _clone(artifactsDir) {
+  constructor(fileName) {
+    this._fileName = fileName;
+  }
+  async _clone(outputDir) {
     const entries = await this._load();
-    const workerFile = import_path.default.join(artifactsDir, `pw-storage-${(0, import_utils.createGuid)()}.json`);
-    await import_fs.default.promises.writeFile(workerFile, JSON.stringify(entries, null, 2)).catch(() => {
+    if (this._lastSnapshotFileName)
+      return this._lastSnapshotFileName;
+    const snapshotFile = import_path.default.join(outputDir, `pw-storage-${(0, import_utils.createGuid)()}.json`);
+    await import_fs.default.promises.writeFile(snapshotFile, JSON.stringify(entries, null, 2)).catch(() => {
     });
-    return workerFile;
+    this._lastSnapshotFileName = snapshotFile;
+    return snapshotFile;
   }
-  async _upstream(workerFile) {
+  async _upstream(storageOutFile) {
     const entries = await this._load();
-    const newEntries = await import_fs.default.promises.readFile(workerFile, "utf8").then(JSON.parse).catch(() => ({}));
-    for (const [key, newValue] of Object.entries(newEntries)) {
-      const existing = entries[key];
-      if (!existing || existing.timestamp < newValue.timestamp)
-        entries[key] = newValue;
-    }
-    await this._writeFile(entries);
+    const newEntries = await import_fs.default.promises.readFile(storageOutFile, "utf8").then(JSON.parse).catch(() => ({}));
+    for (const [key, newValue] of Object.entries(newEntries))
+      entries[key] = newValue;
+    this._lastSnapshotFileName = void 0;
+    await import_fs.default.promises.writeFile(this._fileName, JSON.stringify(entries, null, 2));
   }
   async _load() {
     if (!this._entriesPromise)
       this._entriesPromise = import_fs.default.promises.readFile(this._fileName, "utf8").then(JSON.parse).catch(() => ({}));
     return this._entriesPromise;
   }
-  _writeFile(entries) {
-    this._writeChain = this._writeChain.then(() => import_fs.default.promises.writeFile(this._fileName, JSON.stringify(entries, null, 2)));
-    return this._writeChain;
-  }
-  async flush() {
-    await this._writeChain;
-  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/runner/testRunner.js

@@ -258,6 +258,7 @@ class TestRunner extends import_events.default {
       },
       ...params.updateSnapshots ? { updateSnapshots: params.updateSnapshots } : {},
       ...params.updateSourceMethod ? { updateSourceMethod: params.updateSourceMethod } : {},
+      ...params.runAgents ? { runAgents: params.runAgents } : {},
       ...params.workers ? { workers: params.workers } : {}
     };
     const config = await this._loadConfigOrReportError(new import_internalReporter.InternalReporter([userReporter]), overrides);

package/lib/worker/testInfo.js

@@ -31,7 +31,8 @@ __export(testInfo_exports, {
   StepSkipError: () => StepSkipError,
   TestInfoImpl: () => TestInfoImpl,
   TestSkipError: () => TestSkipError,
-  TestStepInfoImpl: () => TestStepInfoImpl
+  TestStepInfoImpl: () => TestStepInfoImpl,
+  emtpyTestInfoCallbacks: () => emtpyTestInfoCallbacks
 });
 module.exports = __toCommonJS(testInfo_exports);
 var import_fs = __toESM(require("fs"));
@@ -43,6 +44,17 @@ var import_testTracing = require("./testTracing");
 var import_util2 = require("./util");
 var import_transform = require("../transform/transform");
 var import_babelHighlightUtils = require("../transform/babelHighlightUtils");
+const emtpyTestInfoCallbacks = {
+  onStepBegin: () => {
+  },
+  onStepEnd: () => {
+  },
+  onAttach: () => {
+  },
+  onTestPaused: () => Promise.reject(new Error("TestInfoImpl not initialized")),
+  onCloneStorage: () => Promise.reject(new Error("TestInfoImpl not initialized")),
+  onUpstreamStorage: () => Promise.resolve()
+};
 class TestInfoImpl {
   constructor(configInternal, projectInternal, workerParams, test, retry, callbacks) {
     this._snapshotNames = { lastAnonymousSnapshotIndex: 0, lastNamedSnapshotIndex: {} };
@@ -238,7 +250,7 @@ ${(0, import_utils.stringifyStackFrames)(step.boxedStack).join("\n")}`;
             suggestedRebaseline: result.suggestedRebaseline,
             annotations: step.info.annotations
           };
-          this._callbacks.onStepEnd?.(payload);
+          this._callbacks.onStepEnd(payload);
         }
         if (step.group !== "internal") {
           const errorForTrace = step.error ? { name: "", message: step.error.message || "", stack: step.error.stack } : void 0;
@@ -260,7 +272,7 @@ ${(0, import_utils.stringifyStackFrames)(step.boxedStack).join("\n")}`;
         wallTime: Date.now(),
         location: step.location
       };
-      this._callbacks.onStepBegin?.(payload);
+      this._callbacks.onStepBegin(payload);
     }
     if (step.group !== "internal") {
       this._tracing.appendBeforeActionForStep({
@@ -387,7 +399,7 @@ ${(0, import_utils.stringifyStackFrames)(step.boxedStack).join("\n")}`;
       this._tracing.appendBeforeActionForStep({ stepId: stepId2, title: `Attach ${(0, import_utils.escapeWithQuotes)(attachment.name, '"')}`, category: "test.attach", stack: [] });
       this._tracing.appendAfterActionForStep(stepId2, void 0, [attachment]);
     }
-    this._callbacks.onAttach?.({
+    this._callbacks.onAttach({
       testId: this.testId,
       name: attachment.name,
       contentType: attachment.contentType,
@@ -481,12 +493,14 @@ ${(0, import_utils.stringifyStackFrames)(step.boxedStack).join("\n")}`;
   setTimeout(timeout) {
     this._timeoutManager.setTimeout(timeout);
   }
-  async _cloneStorage(cacheFileTemplate) {
-    const storageFile = this._applyPathTemplate(cacheFileTemplate, "cache", ".json");
-    return await this._callbacks.onCloneStorage?.({ storageFile });
+  async _cloneStorage(storageFile) {
+    return await this._callbacks.onCloneStorage({ storageFile });
+  }
+  async _upstreamStorage(storageFile, storageOutFile) {
+    await this._callbacks.onUpstreamStorage({ storageFile, storageOutFile });
   }
-  async _upstreamStorage(workerFile) {
-    await this._callbacks.onUpstreamStorage?.({ workerFile });
+  artifactsDir() {
+    return this._workerParams.artifactsDir;
   }
 }
 class TestStepInfoImpl {
@@ -538,5 +552,6 @@ const stepSymbol = Symbol("step");
   StepSkipError,
   TestInfoImpl,
   TestSkipError,
-  TestStepInfoImpl
+  TestStepInfoImpl,
+  emtpyTestInfoCallbacks
 });

package/lib/worker/workerMain.js

@@ -95,7 +95,7 @@ class WorkerMain extends import_process.ProcessRunner {
       if (!this._config) {
         return;
       }
-      const fakeTestInfo = new import_testInfo.TestInfoImpl(this._config, this._project, this._params, void 0, 0, {});
+      const fakeTestInfo = new import_testInfo.TestInfoImpl(this._config, this._project, this._params, void 0, 0, import_testInfo.emtpyTestInfoCallbacks);
       const runnable = { type: "teardown" };
       await fakeTestInfo._runWithTimeout(runnable, () => this._loadIfNeeded()).catch(() => {
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright",
-  "version": "1.58.0-alpha-2025-12-17",
+  "version": "1.58.0-alpha-2025-12-19",
   "description": "A high-level API to automate web browsers",
   "repository": {
     "type": "git",
@@ -64,7 +64,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "playwright-core": "1.58.0-alpha-2025-12-17"
+    "playwright-core": "1.58.0-alpha-2025-12-19"
   },
   "optionalDependencies": {
     "fsevents": "2.3.2"

package/test.mjs

@@ -25,6 +25,7 @@ export const errors = playwright.errors;
 export const request = playwright.request;
 export const _electron = playwright._electron;
 export const _android = playwright._android;
+export const _baseTest = playwright._baseTest;
 export const test = playwright.test;
 export const expect = playwright.expect;
 export const defineConfig = playwright.defineConfig;

package/types/test.d.ts

@@ -1611,6 +1611,12 @@ interface TestConfig<TestArgs = {}, WorkerArgs = {}> {
    */
   retries?: number;
 
+  /**
+   * Run agents to generate the code for
+   * [page.perform(task[, options])](https://playwright.dev/docs/api/class-page#page-perform) and similar.
+   */
+  runAgents?: boolean;
+
   /**
    * Shard tests and execute only the selected shard. Specify in the one-based form like `{ total: 5, current: 2 }`.
    *
@@ -2067,6 +2073,12 @@ export interface FullConfig<TestArgs = {}, WorkerArgs = {}> {
    */
   rootDir: string;
 
+  /**
+   * Run agents to generate the code for
+   * [page.perform(task[, options])](https://playwright.dev/docs/api/class-page#page-perform) and similar.
+   */
+  runAgents: boolean;
+
   /**
    * See [testConfig.shard](https://playwright.dev/docs/api/class-testconfig#test-config-shard).
    */
@@ -6644,7 +6656,6 @@ export type Fixtures<T extends {} = {}, W extends {} = {}, PT extends {} = {}, P
   [K in Exclude<keyof T, keyof PW | keyof PT>]?: TestFixtureValue<T[K], T & W & PT & PW> | [TestFixtureValue<T[K], T & W & PT & PW>, { scope?: 'test', auto?: boolean, option?: boolean, timeout?: number | undefined, title?: string, box?: boolean | 'self' }];
 };
 
-type Agent = Exclude<BrowserContextOptions['agent'], undefined> & { cachePathTemplate?: string } | undefined;
 type BrowserName = 'chromium' | 'firefox' | 'webkit';
 type BrowserChannel = Exclude<LaunchOptions['channel'], undefined>;
 type ColorScheme = Exclude<BrowserContextOptions['colorScheme'], undefined>;
@@ -6935,6 +6946,15 @@ export interface PlaywrightWorkerOptions {
 export type ScreenshotMode = 'off' | 'on' | 'only-on-failure' | 'on-first-failure';
 export type TraceMode = 'off' | 'on' | 'retain-on-failure' | 'on-first-retry' | 'on-all-retries' | 'retain-on-first-failure';
 export type VideoMode = 'off' | 'on' | 'retain-on-failure' | 'on-first-retry';
+export type Agent = {
+  provider: string;
+  model: string;
+  cachePathTemplate?: string;
+  maxTurns?: number;
+  maxTokens?: number;
+  runAgents?: boolean;
+  secrets?: { [key: string]: string };
+};
 
 /**
  * Playwright Test provides many options to configure test environment,
@@ -6975,11 +6995,7 @@ export type VideoMode = 'off' | 'on' | 'retain-on-failure' | 'on-first-retry';
  *
  */
 export interface PlaywrightTestOptions {
-  /**
-   * Agent settings for [page.perform(task[, options])](https://playwright.dev/docs/api/class-page#page-perform) and
-   * [page.extract(query, schema[, options])](https://playwright.dev/docs/api/class-page#page-extract).
-   */
-  agent: Agent;
+  agent: Agent | undefined;
   /**
    * Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
    *

package/lib/mcp/sdk/proxyBackend.js

@@ -1,128 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var proxyBackend_exports = {};
-__export(proxyBackend_exports, {
-  ProxyBackend: () => ProxyBackend
-});
-module.exports = __toCommonJS(proxyBackend_exports);
-var import_utilsBundle = require("playwright-core/lib/utilsBundle");
-var mcpBundle = __toESM(require("playwright-core/lib/mcpBundle"));
-const errorsDebug = (0, import_utilsBundle.debug)("pw:mcp:errors");
-const { z, zodToJsonSchema } = mcpBundle;
-class ProxyBackend {
-  constructor(mcpProviders) {
-    this._mcpProviders = mcpProviders;
-    this._contextSwitchTool = this._defineContextSwitchTool();
-  }
-  async initialize(clientInfo) {
-    this._clientInfo = clientInfo;
-  }
-  async listTools() {
-    const currentClient = await this._ensureCurrentClient();
-    const response = await currentClient.listTools();
-    if (this._mcpProviders.length === 1)
-      return response.tools;
-    return [
-      ...response.tools,
-      this._contextSwitchTool
-    ];
-  }
-  async callTool(name, args) {
-    if (name === this._contextSwitchTool.name)
-      return this._callContextSwitchTool(args);
-    const currentClient = await this._ensureCurrentClient();
-    return await currentClient.callTool({
-      name,
-      arguments: args
-    });
-  }
-  serverClosed() {
-    void this._currentClient?.close().catch(errorsDebug);
-  }
-  async _callContextSwitchTool(params) {
-    try {
-      const factory = this._mcpProviders.find((factory2) => factory2.name === params.name);
-      if (!factory)
-        throw new Error("Unknown connection method: " + params.name);
-      await this._setCurrentClient(factory);
-      return {
-        content: [{ type: "text", text: "### Result\nSuccessfully changed connection method.\n" }]
-      };
-    } catch (error) {
-      return {
-        content: [{ type: "text", text: `### Result
-Error: ${error}
-` }],
-        isError: true
-      };
-    }
-  }
-  _defineContextSwitchTool() {
-    return {
-      name: "browser_connect",
-      description: [
-        "Connect to a browser using one of the available methods:",
-        ...this._mcpProviders.map((factory) => `- "${factory.name}": ${factory.description}`)
-      ].join("\n"),
-      inputSchema: zodToJsonSchema(z.object({
-        name: z.enum(this._mcpProviders.map((factory) => factory.name)).default(this._mcpProviders[0].name).describe("The method to use to connect to the browser")
-      }), { strictUnions: true }),
-      annotations: {
-        title: "Connect to a browser context",
-        readOnlyHint: true,
-        openWorldHint: false
-      }
-    };
-  }
-  async _ensureCurrentClient() {
-    if (this._currentClient)
-      return this._currentClient;
-    return await this._setCurrentClient(this._mcpProviders[0]);
-  }
-  async _setCurrentClient(factory) {
-    await this._currentClient?.close();
-    this._currentClient = void 0;
-    const client = new mcpBundle.Client({ name: "Playwright MCP Proxy", version: "0.0.0" });
-    client.registerCapabilities({
-      roots: {
-        listRoots: true
-      }
-    });
-    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._clientInfo?.roots || [] }));
-    client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
-    const transport = factory.connect();
-    await client.connect(transport);
-    this._currentClient = client;
-    return client;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ProxyBackend
-});