playwright 1.58.0-alpha-2025-12-06 → 1.58.0-alpha-2025-12-07

package/index.js

@@ -14,4 +14,7 @@
  * limitations under the License.
  */
 
-module.exports = require('playwright-core');
+const playwright = require('playwright-core');
+const { decoratePage } = require('./lib/agents/pageDecorator');
+decoratePage(playwright);
+module.exports = playwright;

package/lib/agents/pageDecorator.js

@@ -0,0 +1,91 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var pageDecorator_exports = {};
+__export(pageDecorator_exports, {
+  decoratePage: () => decoratePage
+});
+module.exports = __toCommonJS(pageDecorator_exports);
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var import_mcpBundle = require("playwright-core/lib/mcpBundle");
+var import_browserContextFactory = require("../mcp/browser/browserContextFactory");
+var import_browserServerBackend = require("../mcp/browser/browserServerBackend");
+var import_config = require("../mcp/browser/config");
+var import_server = require("../mcp/sdk/server");
+function decoratePage(playwright) {
+  playwright._instrumentation.addListener({
+    onPage: (page) => {
+      page.perform = pagePerform.bind(null, page);
+      page.extract = pageExtract.bind(null, page);
+    }
+  });
+}
+async function pagePerform(page, userTask, options = {}) {
+  const resultSchema = {
+    type: "object",
+    properties: {
+      code: { type: "string" }
+    },
+    required: ["code"]
+  };
+  await perform(page, userTask, resultSchema, options);
+}
+async function pageExtract(page, query, schema, options = {}) {
+  const task = `
+### Instructions
+Extract the following information from the page. Do not perform any actions, just extract the information.
+
+### Query
+${query}`;
+  return await perform(page, task, (0, import_mcpBundle.zodToJsonSchema)(schema), options);
+}
+async function perform(page, userTask, resultSchema, options = {}) {
+  const context = page.context();
+  if (!context._options.agent)
+    throw new Error(`page.perform() and page.extract() require the agent to be set on the browser context`);
+  const { full } = await page._snapshotForAI();
+  const backend = new import_browserServerBackend.BrowserServerBackend(import_config.defaultConfig, (0, import_browserContextFactory.identityBrowserContextFactory)(context));
+  const client = await (0, import_server.wrapInClient)(backend, { name: "Internal", version: "0.0.0" });
+  const callTool = async (params) => {
+    return await client.callTool(params);
+  };
+  const loop = new import_mcpBundle.Loop(context._options.agent.provider, {
+    model: context._options.agent.model,
+    summarize: true,
+    debug: import_utilsBundle.debug,
+    callTool,
+    tools: await backend.listTools(),
+    ...options
+  });
+  const task = `${userTask}
+
+### Page snapshot
+${full}
+`;
+  try {
+    return await loop.run(task, {
+      resultSchema
+    });
+  } finally {
+    await client.close();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  decoratePage
+});

package/lib/index.js

@@ -33,7 +33,6 @@ __export(index_exports, {
   expect: () => import_expect.expect,
   mergeExpects: () => import_expect2.mergeExpects,
   mergeTests: () => import_testType2.mergeTests,
-  performCache: () => import_performTask2.performCache,
   test: () => test
 });
 module.exports = __toCommonJS(index_exports);
@@ -44,12 +43,10 @@ var import_utils = require("playwright-core/lib/utils");
 var import_globals = require("./common/globals");
 var import_testType = require("./common/testType");
 var import_browserBackend = require("./mcp/test/browserBackend");
-var import_performTask = require("./agents/performTask");
 var import_expect = require("./matchers/expect");
 var import_configLoader = require("./common/configLoader");
 var import_testType2 = require("./common/testType");
 var import_expect2 = require("./matchers/expect");
-var import_performTask2 = require("./agents/performTask");
 const _baseTest = import_testType.rootTestType.test;
 (0, import_utils.setBoxedStackPrefixes)([import_path.default.dirname(require.resolve("../package.json"))]);
 if (process["__pw_initiator__"]) {
@@ -114,6 +111,7 @@ 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 }],
@@ -143,6 +141,7 @@ const playwrightFixtures = {
   contextOptions: [{}, { option: true, box: true }],
   _combinedContextOptions: [async ({
     acceptDownloads,
+    agent,
     bypassCSP,
     clientCertificates,
     colorScheme,
@@ -169,6 +168,8 @@ 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)
@@ -418,11 +419,6 @@ const playwrightFixtures = {
     } else {
       await request.dispose();
     }
-  },
-  _perform: async ({ context }, use, testInfo) => {
-    await use(async (task, options) => {
-      await (0, import_performTask.performTask)(testInfo, context, task, options ?? {});
-    });
   }
 };
 function normalizeVideoMode(video) {
@@ -686,6 +682,5 @@ const test = _baseTest.extend(playwrightFixtures);
   expect,
   mergeExpects,
   mergeTests,
-  performCache,
   test
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playwright",
-  "version": "1.58.0-alpha-2025-12-06",
+  "version": "1.58.0-alpha-2025-12-07",
   "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-06"
+    "playwright-core": "1.58.0-alpha-2025-12-07"
   },
   "optionalDependencies": {
     "fsevents": "2.3.2"

package/types/test.d.ts

@@ -6644,6 +6644,7 @@ 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> | undefined;
 type BrowserName = 'chromium' | 'firefox' | 'webkit';
 type BrowserChannel = Exclude<LaunchOptions['channel'], undefined>;
 type ColorScheme = Exclude<BrowserContextOptions['colorScheme'], undefined>;
@@ -6974,6 +6975,11 @@ 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;
   /**
    * Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
    *

package/lib/agents/performTask.js

@@ -1,163 +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 performTask_exports = {};
-__export(performTask_exports, {
-  performCache: () => performCache,
-  performTask: () => performTask
-});
-module.exports = __toCommonJS(performTask_exports);
-var import_fs = __toESM(require("fs"));
-var import_path = __toESM(require("path"));
-var import_utilsBundle = require("playwright-core/lib/utilsBundle");
-var import_mcpBundle = require("playwright-core/lib/mcpBundle");
-var import_browserContextFactory = require("../mcp/browser/browserContextFactory");
-var import_browserServerBackend = require("../mcp/browser/browserServerBackend");
-var import_config = require("../mcp/browser/config");
-var import_server = require("../mcp/sdk/server");
-const resultSchema = import_mcpBundle.z.object({
-  code: import_mcpBundle.z.string().optional().describe(`
-Generated code to perform the task using Playwright API.
-Check out the <code> blocks and combine them. Should be presented in the following form:
-
-perform(async ({ page }) => {
-  // generated code here.
-});
-`),
-  error: import_mcpBundle.z.string().optional().describe("The error that occurred if execution failed.").optional()
-});
-async function performTask(testInfo, context, userTask, options) {
-  const cacheStatus = await performTaskFromCache(testInfo, context, userTask);
-  if (cacheStatus === "success")
-    return;
-  const backend = new import_browserServerBackend.BrowserServerBackend(import_config.defaultConfig, (0, import_browserContextFactory.identityBrowserContextFactory)(context));
-  const client = await (0, import_server.wrapInClient)(backend, { name: "Internal", version: "0.0.0" });
-  const callTool = async (params) => {
-    return await client.callTool(params);
-  };
-  const loop = new import_mcpBundle.Loop(options.provider ?? "github", {
-    model: options.model ?? "claude-sonnet-4.5",
-    reasoning: options.reasoning,
-    temperature: options.temperature,
-    maxTokens: options.maxTokens,
-    summarize: true,
-    debug: import_utilsBundle.debug,
-    callTool,
-    tools: await backend.listTools()
-  });
-  try {
-    const result = await loop.run(userTask, { resultSchema: (0, import_mcpBundle.zodToJsonSchema)(resultSchema) });
-    if (result.code)
-      await updatePerformFile(testInfo, userTask, result.code, options);
-  } finally {
-    await client.close();
-  }
-}
-async function updatePerformFile(testInfo, userTask, taskCode, options) {
-  const relativeFile = import_path.default.relative(testInfo.project.testDir, testInfo.file);
-  const promptCacheFile = testInfo.file.replace(".spec.ts", ".cache.ts");
-  const testTitle = testInfo.title;
-  const loop = new import_mcpBundle.Loop(options.provider ?? "github", {
-    model: options.model ?? "claude-sonnet-4.5",
-    reasoning: options.reasoning,
-    temperature: options.temperature,
-    maxTokens: options.maxTokens,
-    summarize: true,
-    debug: import_utilsBundle.debug,
-    callTool: async () => ({ content: [] }),
-    tools: []
-  });
-  const resultSchema2 = import_mcpBundle.z.object({
-    code: import_mcpBundle.z.string().optional().describe(`
-Generated code with all the perofrm routines combined or updated into the following format:
-
-import { performCache } from '@playwright/test';
-
-performCache({
-  file: 'tests/page/perform-task.spec.ts',
-  test: 'perform task',
-  task: 'Click the learn more button',
-  code: async ({ page }) => {
-    await page.getByRole('link', { name: 'Learn more' }).click();
-  },
-});
-`)
-  });
-  const existingCode = await import_fs.default.promises.readFile(promptCacheFile, "utf8").catch(() => "");
-  const task = `
-- Create or update a perform file to include performCache block for the given task and code.
-- Dedupe items with the same file, test, and task.
-- Should produce code in the following format
-
-import { performCache } from '@playwright/test';
-
-performCache({
-  file: '<file>',
-  test: '<test>',
-  task: '<task>',
-  code: async ({ page }) => {
-    <code>
-  },
-});
-
-performCache({
-...
-
-## Params for the new or updated performCache block
-<file-content>${existingCode}</file-content>
-<file>${relativeFile}</file>
-<test>${testTitle}</test>
-<task>${userTask}</task>
-<code>${taskCode}</code>
-`;
-  const result = await loop.run(task, { resultSchema: (0, import_mcpBundle.zodToJsonSchema)(resultSchema2) });
-  if (result.code)
-    await import_fs.default.promises.writeFile(promptCacheFile, result.code);
-}
-const performCacheMap = /* @__PURE__ */ new Map();
-function performCache(entry) {
-  performCacheMap.set(JSON.stringify({ ...entry, code: void 0 }), entry);
-}
-async function performTaskFromCache(testInfo, context, userTask) {
-  const relativeFile = import_path.default.relative(testInfo.project.testDir, testInfo.file);
-  const key = JSON.stringify({ file: relativeFile, test: testInfo.title, task: userTask });
-  const entry = performCacheMap.get(key);
-  if (!entry)
-    return "cache-miss";
-  try {
-    await entry.code({ page: context.pages()[0] });
-    return "success";
-  } catch (error) {
-    return error;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  performCache,
-  performTask
-});