playwright 1.56.0-alpha-1758061937000 → 1.56.0-alpha-2025-09-18

package/lib/agents/generateAgents.js

@@ -29,10 +29,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var generateAgents_exports = {};
 __export(generateAgents_exports, {
   initClaudeCodeRepo: () => initClaudeCodeRepo,
-  initOpencodeRepo: () => initOpencodeRepo
+  initOpencodeRepo: () => initOpencodeRepo,
+  initVSCodeRepo: () => initVSCodeRepo
 });
 module.exports = __toCommonJS(generateAgents_exports);
-var import_crypto = __toESM(require("crypto"));
 var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
@@ -88,22 +88,28 @@ const claudeToolMap = /* @__PURE__ */ new Map([
   ["ls", ["Glob"]],
   ["grep", ["Grep"]],
   ["read", ["Read"]],
-  ["edit", ["Edit", "MultiEdit", "NotebookEdit"]],
+  ["edit", ["Edit", "MultiEdit"]],
   ["write", ["Write"]]
 ]);
+const commonMcpServers = {
+  playwrightTest: {
+    type: "local",
+    command: "npx",
+    args: ["playwright", "run-test-mcp-server"]
+  }
+};
 function saveAsClaudeCode(agent) {
-  function asClaudeTool(hash2, tool) {
+  function asClaudeTool(tool) {
     const [first, second] = tool.split("/");
     if (!second)
       return (claudeToolMap.get(first) || [first]).join(", ");
-    return `mcp__${first}-${hash2}__${second}`;
+    return `mcp__${first}__${second}`;
   }
-  const hash = shortHash(agent.header.name);
   const lines = [];
   lines.push(`---`);
   lines.push(`name: ${agent.header.name}`);
   lines.push(`description: ${agent.header.description}. Examples: ${agent.examples.map((example) => `<example>${example}</example>`).join("")}`);
-  lines.push(`tools: ${agent.header.tools.map((tool) => asClaudeTool(hash, tool)).join(", ")}`);
+  lines.push(`tools: ${agent.header.tools.map((tool) => asClaudeTool(tool)).join(", ")}`);
   lines.push(`model: ${agent.header.model}`);
   lines.push(`color: ${agent.header.color}`);
   lines.push(`---`);
@@ -119,13 +125,13 @@ const opencodeToolMap = /* @__PURE__ */ new Map([
   ["write", ["write"]]
 ]);
 function saveAsOpencodeJson(agents) {
-  function asOpencodeTool(tools, hash, tool) {
+  function asOpencodeTool(tools, tool) {
     const [first, second] = tool.split("/");
     if (!second) {
       for (const tool2 of opencodeToolMap.get(first) || [first])
         tools[tool2] = true;
     } else {
-      tools[`${first}-${hash}*${second}`] = true;
+      tools[`${first}*${second}`] = true;
     }
   }
   const result = {};
@@ -136,7 +142,6 @@ function saveAsOpencodeJson(agents) {
   };
   result["agent"] = {};
   for (const agent of agents) {
-    const hash = shortHash(agent.header.name);
     const tools = {};
     result["agent"][agent.header.name] = {
       description: agent.header.description,
@@ -145,20 +150,16 @@ function saveAsOpencodeJson(agents) {
       tools
     };
     for (const tool of agent.header.tools)
-      asOpencodeTool(tools, hash, tool);
-    for (const [name, mcp] of Object.entries(agent.header["mcp-servers"])) {
-      result["mcp"][name + "-" + hash] = {
-        type: mcp.type,
-        command: [mcp.command, ...mcp.args],
-        enabled: true
-      };
-    }
+      asOpencodeTool(tools, tool);
   }
+  const server = commonMcpServers.playwrightTest;
+  result["mcp"]["playwright-test"] = {
+    type: server.type,
+    command: [server.command, ...server.args],
+    enabled: true
+  };
   return JSON.stringify(result, null, 2);
 }
-function shortHash(str) {
-  return import_crypto.default.createHash("sha256").update(str).digest("hex").slice(0, 4);
-}
 async function loadAgents() {
   const files = await import_fs.default.promises.readdir(__dirname);
   return Promise.all(files.filter((file) => file.endsWith(".md")).map((file) => AgentParser.parseFile(import_path.default.join(__dirname, file))));
@@ -172,18 +173,62 @@ async function initClaudeCodeRepo() {
   await import_fs.default.promises.mkdir(".claude/agents", { recursive: true });
   for (const agent of agents)
     await writeFile(`.claude/agents/${agent.header.name}.md`, saveAsClaudeCode(agent));
-  const mcpServers = {};
-  for (const agent of agents) {
-    const hash = shortHash(agent.header.name);
-    for (const [name, mcp] of Object.entries(agent.header["mcp-servers"])) {
-      const entry = {
-        command: mcp.command,
-        args: mcp.args
-      };
-      mcpServers[name + "-" + hash] = entry;
+  await writeFile(".mcp.json", JSON.stringify({
+    mcpServers: {
+      "playwright-test": {
+        command: commonMcpServers.playwrightTest.command,
+        args: commonMcpServers.playwrightTest.args
+      }
     }
+  }, null, 2));
+}
+const vscodeToolMap = /* @__PURE__ */ new Map([
+  ["ls", ["listDirectory", "fileSearch"]],
+  ["grep", ["textSearch"]],
+  ["read", ["readFile"]],
+  ["edit", ["editFiles"]],
+  ["write", ["createFile", "createDirectory"]]
+]);
+function saveAsVSCodeChatmode(agent) {
+  function asVscodeTool(tool) {
+    const [first, second] = tool.split("/");
+    if (second)
+      return second;
+    return vscodeToolMap.get(first) || first;
   }
-  await writeFile(".mcp.json", JSON.stringify({ mcpServers }, null, 2));
+  const tools = agent.header.tools.map(asVscodeTool).flat().map((tool) => `'${tool}'`).join(", ");
+  const lines = [];
+  lines.push(`---`);
+  lines.push(`description: ${agent.header.description}. Examples: ${agent.examples.map((example) => `<example>${example}</example>`).join("")}`);
+  lines.push(`tools: [${tools}]`);
+  lines.push(`---`);
+  lines.push("");
+  lines.push(agent.instructions);
+  return lines.join("\n");
+}
+async function initVSCodeRepo() {
+  const agents = await loadAgents();
+  await import_fs.default.promises.mkdir(".github/chatmodes", { recursive: true });
+  for (const agent of agents)
+    await writeFile(`.github/chatmodes/${agent.header.name}.chatmode.md`, saveAsVSCodeChatmode(agent));
+  await import_fs.default.promises.mkdir(".vscode", { recursive: true });
+  const mcpJsonPath = ".vscode/mcp.json";
+  let mcpJson = {
+    servers: {},
+    inputs: []
+  };
+  try {
+    mcpJson = JSON.parse(import_fs.default.readFileSync(mcpJsonPath, "utf8"));
+  } catch {
+  }
+  if (!mcpJson.servers)
+    mcpJson.servers = {};
+  mcpJson.servers["playwright-test"] = {
+    type: "stdio",
+    command: commonMcpServers.playwrightTest.command,
+    args: commonMcpServers.playwrightTest.args
+  };
+  await writeFile(mcpJsonPath, JSON.stringify(mcpJson, null, 2));
 }
 async function initOpencodeRepo() {
   const agents = await loadAgents();
@@ -199,5 +244,6 @@ async function initOpencodeRepo() {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   initClaudeCodeRepo,
-  initOpencodeRepo
+  initOpencodeRepo,
+  initVSCodeRepo
 });

package/lib/agents/generator.md

@@ -8,28 +8,23 @@ tools:
   - grep
   - read
   - write
-  - playwright/browser_click
-  - playwright/browser_drag
-  - playwright/browser_evaluate
-  - playwright/browser_file_upload
-  - playwright/browser_handle_dialog
-  - playwright/browser_hover
-  - playwright/browser_navigate
-  - playwright/browser_press_key
-  - playwright/browser_select_option
-  - playwright/browser_snapshot
-  - playwright/browser_type
-  - playwright/browser_verify_element_visible
-  - playwright/browser_verify_list_visible
-  - playwright/browser_verify_text_visible
-  - playwright/browser_verify_value
-  - playwright/browser_wait_for
-  - playwright/test_setup_page
-mcp-servers:
-  playwright:
-    type: 'local'
-    command: 'npx'
-    args: ['playwright', 'run-test-mcp-server']
+  - playwright-test/browser_click
+  - playwright-test/browser_drag
+  - playwright-test/browser_evaluate
+  - playwright-test/browser_file_upload
+  - playwright-test/browser_handle_dialog
+  - playwright-test/browser_hover
+  - playwright-test/browser_navigate
+  - playwright-test/browser_press_key
+  - playwright-test/browser_select_option
+  - playwright-test/browser_snapshot
+  - playwright-test/browser_type
+  - playwright-test/browser_verify_element_visible
+  - playwright-test/browser_verify_list_visible
+  - playwright-test/browser_verify_text_visible
+  - playwright-test/browser_verify_value
+  - playwright-test/browser_wait_for
+  - playwright-test/test_setup_page
 ---
 
 You are a Playwright Test Generator, an expert in browser automation and end-to-end testing. Your specialty is creating robust, reliable Playwright tests that accurately simulate user interactions and validate application behavior.

package/lib/agents/{fixer.md → healer.md}

@@ -1,5 +1,5 @@
 ---
-name: playwright-test-fixer
+name: playwright-test-healer
 description: Use this agent when you need to debug and fix failing Playwright tests
 color: red
 model: sonnet
@@ -9,21 +9,15 @@ tools:
   - read
   - write
   - edit
-  - playwright/browser_evaluate
-  - playwright/browser_generate_locator
-  - playwright/browser_snapshot
-  - playwright/test_debug
-  - playwright/test_list
-  - playwright/test_run
-  - playwright/test_setup_page
-mcp-servers:
-  playwright:
-    type: 'local'
-    command: 'npx'
-    args: ['playwright', 'run-test-mcp-server']
+  - playwright-test/browser_evaluate
+  - playwright-test/browser_generate_locator
+  - playwright-test/browser_snapshot
+  - playwright-test/test_debug
+  - playwright-test/test_list
+  - playwright-test/test_run
 ---
 
-You are the Playwright Test Fixer, an expert test automation engineer specializing in debugging and
+You are the Playwright Test Healer, an expert test automation engineer specializing in debugging and
 resolving Playwright test failures. Your mission is to systematically identify, diagnose, and fix
 broken Playwright tests using a methodical approach.
 
@@ -43,7 +37,7 @@ Your workflow:
    - Updating selectors to match current application state
    - Fixing assertions and expected values
    - Improving test reliability and maintainability
-   - For inherently dynamic data, utilize regular expressions to produce resilient locators 
+   - For inherently dynamic data, utilize regular expressions to produce resilient locators
 6. **Verification**: Restart the test after each fix to validate the changes
 7. **Iteration**: Repeat the investigation and fixing process until the test passes cleanly
 
@@ -62,19 +56,19 @@ Key principles:
 <example>
   Context: A developer has a failing Playwright test that needs to be debugged and fixed.
   user: 'The login test is failing, can you fix it?'
-  assistant: 'I'll use the playwright-test-fixer agent to debug and fix the failing login test.'
+  assistant: 'I'll use the playwright-test-healer agent to debug and fix the failing login test.'
   <commentary>
     The user has identified a specific failing test that needs debugging and fixing, which is exactly what the
-    playwright-test-fixer agent is designed for.
+    playwright-test-healer agent is designed for.
   </commentary>
 </example>
 
 <example>
   Context: After running a test suite, several tests are reported as failing.
   user: 'Test user-registration.spec.ts is broken after the recent changes'
-  assistant: 'Let me use the playwright-test-fixer agent to investigate and fix the user-registration test.'
+  assistant: 'Let me use the playwright-test-healer agent to investigate and fix the user-registration test.'
   <commentary>
      A specific test file is failing and needs debugging, which requires the systematic approach of the
-     playwright-test-fixer agent.
+     playwright-test-healer agent.
   </commentary>
 </example>

package/lib/agents/planner.md

@@ -8,36 +8,31 @@ tools:
   - grep
   - read
   - write
-  - playwright/browser_click
-  - playwright/browser_close
-  - playwright/browser_console_messages
-  - playwright/browser_drag
-  - playwright/browser_evaluate
-  - playwright/browser_file_upload
-  - playwright/browser_handle_dialog
-  - playwright/browser_hover
-  - playwright/browser_navigate
-  - playwright/browser_navigate_back
-  - playwright/browser_network_requests
-  - playwright/browser_press_key
-  - playwright/browser_select_option
-  - playwright/browser_snapshot
-  - playwright/browser_take_screenshot
-  - playwright/browser_type
-  - playwright/browser_wait_for
-  - playwright/test_setup_page
-mcp-servers:
-  playwright:
-    type: 'local'
-    command: 'npx'
-    args: ['playwright', 'run-test-mcp-server']
+  - playwright-test/browser_click
+  - playwright-test/browser_close
+  - playwright-test/browser_console_messages
+  - playwright-test/browser_drag
+  - playwright-test/browser_evaluate
+  - playwright-test/browser_file_upload
+  - playwright-test/browser_handle_dialog
+  - playwright-test/browser_hover
+  - playwright-test/browser_navigate
+  - playwright-test/browser_navigate_back
+  - playwright-test/browser_network_requests
+  - playwright-test/browser_press_key
+  - playwright-test/browser_select_option
+  - playwright-test/browser_snapshot
+  - playwright-test/browser_take_screenshot
+  - playwright-test/browser_type
+  - playwright-test/browser_wait_for
+  - playwright-test/test_setup_page
 ---
 
 You are an expert web test planner with extensive experience in quality assurance, user experience testing, and test scenario design. Your expertise includes functional testing, usability testing, edge case identification, and comprehensive test coverage planning.
 
 When given a target web page or application, you will:
 
-1. **Navigate and Explore**: 
+1. **Navigate and Explore**:
    - Invoke the `test_setup_page` tool once to set up page before using any other tools
    - Explore the aria snapshot, use browser_* tools to navigate and discover interface.
    - Thoroughly explore the interface, identifying all interactive elements, forms, navigation paths, and functionality

package/lib/mcp/browser/browserContextFactory.js

@@ -38,9 +38,9 @@ var import_path = __toESM(require("path"));
 var playwright = __toESM(require("playwright-core"));
 var import_registry = require("playwright-core/lib/server/registry/index");
 var import_server = require("playwright-core/lib/server");
-var import_processUtils = require("./processUtils");
 var import_log = require("../log");
 var import_config = require("./config");
+var import_server2 = require("../sdk/server");
 function contextFactory(config) {
   if (config.browser.remoteEndpoint)
     return new RemoteContextFactory(config);
@@ -99,7 +99,7 @@ class IsolatedContextFactory extends BaseContextFactory {
   async _doObtainBrowser(clientInfo) {
     await injectCdpPort(this.config.browser);
     const browserType = playwright[this.config.browser.browserName];
-    const tracesDir = await (0, import_config.outputFile)(this.config, clientInfo.rootPath, `traces`);
+    const tracesDir = await (0, import_config.outputFile)(this.config, clientInfo, `traces`);
     if (this.config.saveTrace)
       await startTraceServer(this.config, tracesDir);
     return browserType.launch({
@@ -153,40 +153,40 @@ class PersistentContextFactory {
   async createContext(clientInfo) {
     await injectCdpPort(this.config.browser);
     (0, import_log.testDebug)("create browser context (persistent)");
-    const userDataDir = this.config.browser.userDataDir ?? await this._createUserDataDir(clientInfo.rootPath);
-    const tracesDir = await (0, import_config.outputFile)(this.config, clientInfo.rootPath, `traces`);
+    const userDataDir = this.config.browser.userDataDir ?? await this._createUserDataDir(clientInfo);
+    const tracesDir = await (0, import_config.outputFile)(this.config, clientInfo, `traces`);
     if (this.config.saveTrace)
       await startTraceServer(this.config, tracesDir);
     this._userDataDirs.add(userDataDir);
     (0, import_log.testDebug)("lock user data dir", userDataDir);
     const browserType = playwright[this.config.browser.browserName];
     for (let i = 0; i < 5; i++) {
-      if (!await alreadyRunning(this.config, browserType, userDataDir))
-        break;
-      await new Promise((resolve) => setTimeout(resolve, 1e3));
-    }
-    const launchOptions = {
-      tracesDir,
-      ...this.config.browser.launchOptions,
-      ...this.config.browser.contextOptions,
-      handleSIGINT: false,
-      handleSIGTERM: false,
-      ignoreDefaultArgs: [
-        "--disable-extensions"
-      ],
-      assistantMode: true
-    };
-    try {
-      const browserContext = await browserType.launchPersistentContext(userDataDir, launchOptions);
-      const close = () => this._closeBrowserContext(browserContext, userDataDir);
-      return { browserContext, close };
-    } catch (error) {
-      if (error.message.includes("Executable doesn't exist"))
-        throw new Error(`Browser specified in your config is not installed. Either install it (likely) or change the config.`);
-      if (error.message.includes("ProcessSingleton") || error.message.includes("Invalid URL"))
-        throw new Error(`Browser is already in use for ${userDataDir}, use --isolated to run multiple instances of the same browser`);
-      throw error;
+      const launchOptions = {
+        tracesDir,
+        ...this.config.browser.launchOptions,
+        ...this.config.browser.contextOptions,
+        handleSIGINT: false,
+        handleSIGTERM: false,
+        ignoreDefaultArgs: [
+          "--disable-extensions"
+        ],
+        assistantMode: true
+      };
+      try {
+        const browserContext = await browserType.launchPersistentContext(userDataDir, launchOptions);
+        const close = () => this._closeBrowserContext(browserContext, userDataDir);
+        return { browserContext, close };
+      } catch (error) {
+        if (error.message.includes("Executable doesn't exist"))
+          throw new Error(`Browser specified in your config is not installed. Either install it (likely) or change the config.`);
+        if (error.message.includes("ProcessSingleton") || error.message.includes("Invalid URL")) {
+          await new Promise((resolve) => setTimeout(resolve, 1e3));
+          continue;
+        }
+        throw error;
+      }
     }
+    throw new Error(`Browser is already in use for ${userDataDir}, use --isolated to run multiple instances of the same browser`);
   }
   async _closeBrowserContext(browserContext, userDataDir) {
     (0, import_log.testDebug)("close browser context (persistent)");
@@ -196,21 +196,16 @@ class PersistentContextFactory {
     this._userDataDirs.delete(userDataDir);
     (0, import_log.testDebug)("close browser context complete (persistent)");
   }
-  async _createUserDataDir(rootPath) {
+  async _createUserDataDir(clientInfo) {
     const dir = process.env.PWMCP_PROFILES_DIR_FOR_TEST ?? import_registry.registryDirectory;
     const browserToken = this.config.browser.launchOptions?.channel ?? this.config.browser?.browserName;
+    const rootPath = (0, import_server2.firstRootPath)(clientInfo);
     const rootPathToken = rootPath ? `-${createHash(rootPath)}` : "";
     const result = import_path.default.join(dir, `mcp-${browserToken}${rootPathToken}`);
     await import_fs.default.promises.mkdir(result, { recursive: true });
     return result;
   }
 }
-async function alreadyRunning(config, browserType, userDataDir) {
-  const execPath = config.browser.launchOptions.executablePath ?? (0, import_processUtils.getBrowserExecPath)(config.browser.launchOptions.channel ?? browserType.name());
-  if (!execPath)
-    return false;
-  return !!(0, import_processUtils.findBrowserProcess)(execPath, userDataDir);
-}
 async function injectCdpPort(browserConfig) {
   if (browserConfig.browserName === "chromium")
     browserConfig.launchOptions.cdpPort = await findFreePort();

package/lib/mcp/browser/browserServerBackend.js

@@ -21,7 +21,6 @@ __export(browserServerBackend_exports, {
   BrowserServerBackend: () => BrowserServerBackend
 });
 module.exports = __toCommonJS(browserServerBackend_exports);
-var import_url = require("url");
 var import_context = require("./context");
 var import_log = require("../log");
 var import_response = require("./response");
@@ -34,19 +33,13 @@ class BrowserServerBackend {
     this._browserContextFactory = factory;
     this._tools = (0, import_tools.filteredTools)(config);
   }
-  async initialize(server, clientVersion, roots) {
-    let rootPath;
-    if (roots.length > 0) {
-      const firstRootUri = roots[0]?.uri;
-      const url = firstRootUri ? new URL(firstRootUri) : void 0;
-      rootPath = url ? (0, import_url.fileURLToPath)(url) : void 0;
-    }
-    this._sessionLog = this._config.saveSession ? await import_sessionLog.SessionLog.create(this._config, rootPath) : void 0;
+  async initialize(server, clientInfo) {
+    this._sessionLog = this._config.saveSession ? await import_sessionLog.SessionLog.create(this._config, clientInfo) : void 0;
     this._context = new import_context.Context({
       config: this._config,
       browserContextFactory: this._browserContextFactory,
       sessionLog: this._sessionLog,
-      clientInfo: { ...clientVersion, rootPath }
+      clientInfo
     });
   }
   async listTools() {

package/lib/mcp/browser/config.js

@@ -45,6 +45,7 @@ var import_os = __toESM(require("os"));
 var import_path = __toESM(require("path"));
 var import_playwright_core = require("playwright-core");
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var import_server = require("../sdk/server");
 const defaultConfig = {
   browser: {
     browserName: "chromium",
@@ -215,8 +216,9 @@ async function loadConfig(configFile) {
     throw new Error(`Failed to load config file: ${configFile}, ${error}`);
   }
 }
-async function outputFile(config, rootPath, name) {
-  const outputDir = config.outputDir ?? (rootPath ? import_path.default.join(rootPath, ".playwright-mcp") : void 0) ?? import_path.default.join(import_os.default.tmpdir(), "playwright-mcp-output", sanitizeForFilePath((/* @__PURE__ */ new Date()).toISOString()));
+async function outputFile(config, clientInfo, name) {
+  const rootPath = (0, import_server.firstRootPath)(clientInfo);
+  const outputDir = config.outputDir ?? (rootPath ? import_path.default.join(rootPath, ".playwright-mcp") : void 0) ?? import_path.default.join(process.env.PW_TMPDIR_FOR_TEST ?? import_os.default.tmpdir(), "playwright-mcp-output", String(clientInfo.timestamp));
   await import_fs.default.promises.mkdir(outputDir, { recursive: true });
   const fileName = sanitizeForFilePath(name);
   return import_path.default.join(outputDir, fileName);

package/lib/mcp/browser/context.js

@@ -96,7 +96,7 @@ class Context {
     return url;
   }
   async outputFile(name) {
-    return (0, import_config.outputFile)(this.config, this._clientInfo.rootPath, name);
+    return (0, import_config.outputFile)(this.config, this._clientInfo, name);
   }
   _onPageCreated(page) {
     const tab = new import_tab.Tab(this, page, (tab2) => this._onPageClosed(tab2));

package/lib/mcp/browser/sessionLog.js

@@ -43,8 +43,8 @@ class SessionLog {
     this._folder = sessionFolder;
     this._file = import_path.default.join(this._folder, "session.md");
   }
-  static async create(config, rootPath) {
-    const sessionFolder = await (0, import_config.outputFile)(config, rootPath, `session-${Date.now()}`);
+  static async create(config, clientInfo) {
+    const sessionFolder = await (0, import_config.outputFile)(config, clientInfo, `session-${Date.now()}`);
     await import_fs.default.promises.mkdir(sessionFolder, { recursive: true });
     console.error(`Session: ${sessionFolder}`);
     return new SessionLog(sessionFolder);

package/lib/mcp/sdk/mdb.js

@@ -48,9 +48,9 @@ class MDBBackend {
     this._stack = [];
     this._topLevelBackend = topLevelBackend;
   }
-  async initialize(server, clientVersion, roots) {
-    if (!this._roots)
-      this._roots = roots;
+  async initialize(server, clientInfo) {
+    if (!this._clientInfo)
+      this._clientInfo = clientInfo;
   }
   async listTools() {
     const client = await this._client();
@@ -103,8 +103,8 @@ class MDBBackend {
   }
   async _pushClient(transport, introMessage) {
     mdbDebug("pushing client to the stack");
-    const client = new mcpBundle.Client({ name: "Internal client", version: "0.0.0" }, { capabilities: { roots: {} } });
-    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._roots || [] }));
+    const client = new mcpBundle.Client({ name: "Pushing client", version: "0.0.0" }, { capabilities: { roots: {} } });
+    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._clientInfo?.roots || [] }));
     client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
     await client.connect(transport);
     mdbDebug("connected to the new client");
@@ -155,7 +155,7 @@ async function runOnPauseBackendLoop(backend, introMessage) {
   const httpServer = await mcpHttp.startHttpServer({ port: 0 });
   await mcpHttp.installHttpTransport(httpServer, factory);
   const url = mcpHttp.httpAddressToString(httpServer.address());
-  const client = new mcpBundle.Client({ name: "Internal client", version: "0.0.0" });
+  const client = new mcpBundle.Client({ name: "On-pause client", version: "0.0.0" });
   client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
   const transport = new mcpBundle.StreamableHTTPClientTransport(new URL(process.env.PLAYWRIGHT_DEBUGGER_MCP));
   await client.connect(transport);
@@ -183,8 +183,8 @@ class ServerBackendWithCloseListener {
     this._serverClosedPromise = new import_utils.ManualPromise();
     this._backend = backend;
   }
-  async initialize(server, clientVersion, roots) {
-    await this._backend.initialize?.(server, clientVersion, roots);
+  async initialize(server, clientInfo) {
+    await this._backend.initialize?.(server, clientInfo);
   }
   async listTools() {
     return this._backend.listTools();

package/lib/mcp/sdk/proxyBackend.js

@@ -37,12 +37,11 @@ const errorsDebug = (0, import_utilsBundle.debug)("pw:mcp:errors");
 const { z, zodToJsonSchema } = mcpBundle;
 class ProxyBackend {
   constructor(mcpProviders) {
-    this._roots = [];
     this._mcpProviders = mcpProviders;
     this._contextSwitchTool = this._defineContextSwitchTool();
   }
-  async initialize(server, clientVersion, roots) {
-    this._roots = roots;
+  async initialize(server, clientInfo) {
+    this._clientInfo = clientInfo;
   }
   async listTools() {
     const currentClient = await this._ensureCurrentClient();
@@ -115,7 +114,7 @@ Error: ${error}
         listRoots: true
       }
     });
-    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._roots }));
+    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._clientInfo?.roots || [] }));
     client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
     const transport = await factory.connect();
     await client.connect(transport);

package/lib/mcp/sdk/server.js

@@ -30,10 +30,12 @@ var server_exports = {};
 __export(server_exports, {
   connect: () => connect,
   createServer: () => createServer,
+  firstRootPath: () => firstRootPath,
   start: () => start,
   wrapInProcess: () => wrapInProcess
 });
 module.exports = __toCommonJS(server_exports);
+var import_url = require("url");
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
 var mcpBundle = __toESM(require("./bundle"));
 var import_http = require("./http");
@@ -83,8 +85,13 @@ const initializeServer = async (server, backend, runHeartbeat) => {
     const { roots } = await server.listRoots();
     clientRoots = roots;
   }
-  const clientVersion = server.getClientVersion() ?? { name: "unknown", version: "unknown" };
-  await backend.initialize?.(server, clientVersion, clientRoots);
+  const clientInfo = {
+    name: server.getClientVersion()?.name ?? "unknown",
+    version: server.getClientVersion()?.version ?? "unknown",
+    roots: clientRoots,
+    timestamp: Date.now()
+  };
+  await backend.initialize?.(server, clientInfo);
   if (runHeartbeat)
     startHeartbeat(server);
 };
@@ -128,10 +135,18 @@ async function start(serverBackendFactory, options) {
   ].join("\n");
   console.error(message);
 }
+function firstRootPath(clientInfo) {
+  if (clientInfo.roots.length === 0)
+    return void 0;
+  const firstRootUri = clientInfo.roots[0]?.uri;
+  const url = firstRootUri ? new URL(firstRootUri) : void 0;
+  return url ? (0, import_url.fileURLToPath)(url) : void 0;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   connect,
   createServer,
+  firstRootPath,
   start,
   wrapInProcess
 });

package/lib/mcp/test/testBackend.js

@@ -31,7 +31,6 @@ __export(testBackend_exports, {
   TestServerBackend: () => TestServerBackend
 });
 module.exports = __toCommonJS(testBackend_exports);
-var import_url = require("url");
 var mcp = __toESM(require("../sdk/exports"));
 var import_testContext = require("./testContext");
 var import_testTools = require("./testTools.js");
@@ -45,19 +44,15 @@ class TestServerBackend {
     this._context = new import_testContext.TestContext(options);
     this._configOption = configOption;
   }
-  async initialize(server, clientVersion, roots) {
+  async initialize(server, clientInfo) {
     if (this._configOption) {
       this._context.setConfigLocation((0, import_configLoader.resolveConfigLocation)(this._configOption));
       return;
     }
-    if (roots.length > 0) {
-      const firstRootUri = roots[0]?.uri;
-      const url = firstRootUri ? new URL(firstRootUri) : void 0;
-      const folder = url ? (0, import_url.fileURLToPath)(url) : void 0;
-      if (folder) {
-        this._context.setConfigLocation((0, import_configLoader.resolveConfigLocation)(folder));
-        return;
-      }
+    const rootPath = mcp.firstRootPath(clientInfo);
+    if (rootPath) {
+      this._context.setConfigLocation((0, import_configLoader.resolveConfigLocation)(rootPath));
+      return;
     }
     throw new Error("No config option or MCP root path provided");
   }

package/lib/mcp/vscode/host.js

@@ -50,12 +50,10 @@ class VSCodeProxyBackend {
     this._defaultTransportFactory = _defaultTransportFactory;
     this.name = "Playwright MCP Client Switcher";
     this.version = packageJSON.version;
-    this._roots = [];
     this._contextSwitchTool = this._defineContextSwitchTool();
   }
-  async initialize(server, clientVersion, roots) {
-    this._clientVersion = clientVersion;
-    this._roots = roots;
+  async initialize(server, clientInfo) {
+    this._clientInfo = clientInfo;
     const transport = await this._defaultTransportFactory(this);
     await this._setCurrentClient(transport);
   }
@@ -147,13 +145,13 @@ class VSCodeProxyBackend {
   async _setCurrentClient(transport) {
     await this._currentClient?.close();
     this._currentClient = void 0;
-    const client = new mcpBundle.Client(this._clientVersion);
+    const client = new mcpBundle.Client({ name: this._clientInfo.name, version: this._clientInfo.version });
     client.registerCapabilities({
       roots: {
         listRoots: true
       }
     });
-    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._roots }));
+    client.setRequestHandler(mcpBundle.ListRootsRequestSchema, () => ({ roots: this._clientInfo.roots }));
     client.setRequestHandler(mcpBundle.PingRequestSchema, () => ({}));
     await client.connect(transport);
     this._currentClient = client;

package/lib/program.js

@@ -175,9 +175,12 @@ function addInitAgentsCommand(program3) {
   command.description("Initialize repository agents for the Claude Code");
   command.option("--claude", "Initialize repository agents for the Claude Code");
   command.option("--opencode", "Initialize repository agents for the Opencode");
+  command.option("--vscode", "Initialize repository agents for the VS Code Copilot");
   command.action(async (opts) => {
     if (opts.opencode)
       await (0, import_generateAgents.initOpencodeRepo)();
+    else if (opts.vscode)
+      await (0, import_generateAgents.initVSCodeRepo)();
     else
       await (0, import_generateAgents.initClaudeCodeRepo)();
   });

package/lib/reporters/html.js

@@ -113,7 +113,17 @@ class HtmlReporter {
     else if (process.env.PLAYWRIGHT_HTML_NO_SNIPPETS)
       noSnippets = true;
     noSnippets = noSnippets || this._options.noSnippets;
-    const builder = new HtmlBuilder(this.config, this._outputFolder, this._attachmentsBaseURL, process.env.PLAYWRIGHT_HTML_TITLE || this._options.title, noSnippets);
+    let noCopyPrompt;
+    if (process.env.PLAYWRIGHT_HTML_NO_COPY_PROMPT === "false" || process.env.PLAYWRIGHT_HTML_NO_COPY_PROMPT === "0")
+      noCopyPrompt = false;
+    else if (process.env.PLAYWRIGHT_HTML_NO_COPY_PROMPT)
+      noCopyPrompt = true;
+    noCopyPrompt = noCopyPrompt || this._options.noCopyPrompt;
+    const builder = new HtmlBuilder(this.config, this._outputFolder, this._attachmentsBaseURL, {
+      title: process.env.PLAYWRIGHT_HTML_TITLE || this._options.title,
+      noSnippets,
+      noCopyPrompt
+    });
     this._buildResult = await builder.build(this.config.metadata, projectSuites, result, this._topLevelErrors);
   }
   async onExit() {
@@ -197,16 +207,15 @@ function startHtmlReportServer(folder) {
   return server;
 }
 class HtmlBuilder {
-  constructor(config, outputDir, attachmentsBaseURL, title, noSnippets = false) {
+  constructor(config, outputDir, attachmentsBaseURL, options) {
     this._stepsInFile = new import_utils.MultiMap();
     this._hasTraces = false;
     this._config = config;
     this._reportFolder = outputDir;
-    this._noSnippets = noSnippets;
+    this._options = options;
     import_fs.default.mkdirSync(this._reportFolder, { recursive: true });
     this._dataZipFile = new import_zipBundle.yazl.ZipFile();
     this._attachmentsBaseURL = attachmentsBaseURL;
-    this._title = title;
   }
   async build(metadata, projectSuites, result, topLevelErrors) {
     const data = /* @__PURE__ */ new Map();
@@ -231,7 +240,7 @@ class HtmlBuilder {
         }
       }
     }
-    if (!this._noSnippets)
+    if (!this._options.noSnippets)
       createSnippets(this._stepsInFile);
     let ok = true;
     for (const [fileId, { testFile, testFileSummary }] of data) {
@@ -260,13 +269,13 @@ class HtmlBuilder {
     }
     const htmlReport = {
       metadata,
-      title: this._title,
       startTime: result.startTime.getTime(),
       duration: result.duration,
       files: [...data.values()].map((e) => e.testFileSummary),
       projectNames: projectSuites.map((r) => r.project().name),
       stats: { ...[...data.values()].reduce((a, e) => addStats(a, e.testFileSummary.stats), emptyStats()) },
-      errors: topLevelErrors.map((error) => (0, import_base.formatError)(import_base.internalScreen, error).message)
+      errors: topLevelErrors.map((error) => (0, import_base.formatError)(import_base.internalScreen, error).message),
+      options: this._options
     };
     htmlReport.files.sort((f1, f2) => {
       const w1 = f1.stats.unexpected * 1e3 + f1.stats.flaky;

package/package.json

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

package/types/test.d.ts

@@ -22,7 +22,16 @@ export type BlobReporterOptions = { outputDir?: string, fileName?: string };
 export type ListReporterOptions = { printSteps?: boolean };
 export type JUnitReporterOptions = { outputFile?: string, stripANSIControlSequences?: boolean, includeProjectInTestName?: boolean };
 export type JsonReporterOptions = { outputFile?: string };
-export type HtmlReporterOptions = { outputFolder?: string, open?: 'always' | 'never' | 'on-failure', host?: string, port?: number, attachmentsBaseURL?: string, title?: string, noSnippets?: boolean };
+export type HtmlReporterOptions = {
+  outputFolder?: string;
+  open?: 'always' | 'never' | 'on-failure';
+  host?: string;
+  port?: number;
+  attachmentsBaseURL?: string;
+  title?: string;
+  noSnippets?: boolean;
+  noCopyPrompt?: boolean;
+};
 
 export type ReporterDescription = Readonly<
   ['blob'] | ['blob', BlobReporterOptions] |

package/lib/mcp/browser/processUtils.js

@@ -1,102 +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 processUtils_exports = {};
-__export(processUtils_exports, {
-  findBrowserProcess: () => findBrowserProcess,
-  getBrowserExecPath: () => getBrowserExecPath
-});
-module.exports = __toCommonJS(processUtils_exports);
-var import_child_process = __toESM(require("child_process"));
-var import_fs = __toESM(require("fs"));
-var import_registry = require("playwright-core/lib/server/registry/index");
-function getBrowserExecPath(channelOrName) {
-  return import_registry.registry.findExecutable(channelOrName)?.executablePath("javascript");
-}
-function findBrowserProcess(execPath, arg) {
-  const predicate = (line) => line.includes(execPath) && line.includes(arg) && !line.includes("--type");
-  try {
-    switch (process.platform) {
-      case "darwin":
-        return findProcessMacos(predicate);
-      case "linux":
-        return findProcessLinux(predicate);
-      case "win32":
-        return findProcessWindows(execPath, arg, predicate);
-      default:
-        return void 0;
-    }
-  } catch {
-    return void 0;
-  }
-}
-function findProcessLinux(predicate) {
-  const procDirs = import_fs.default.readdirSync("/proc").filter((name) => /^\d+$/.test(name));
-  for (const pid of procDirs) {
-    try {
-      const cmdlineBuffer = import_fs.default.readFileSync(`/proc/${pid}/cmdline`);
-      const cmdline = cmdlineBuffer.toString().replace(/\0/g, " ").trim();
-      if (predicate(cmdline))
-        return `${pid} ${cmdline}`;
-    } catch {
-      continue;
-    }
-  }
-  return void 0;
-}
-function findProcessMacos(predicate) {
-  const result = import_child_process.default.spawnSync("/bin/ps", ["-axo", "pid=,command="]);
-  if (result.status !== 0 || !result.stdout)
-    return void 0;
-  return findMatchingLine(result.stdout.toString(), predicate);
-}
-function findProcessWindows(execPath, arg, predicate) {
-  const psEscape = (path) => `'${path.replaceAll("'", "''")}'`;
-  const filter = `$_.ExecutablePath -eq ${psEscape(execPath)} -and $_.CommandLine.Contains(${psEscape(arg)}) -and $_.CommandLine -notmatch '--type'`;
-  const ps = import_child_process.default.spawnSync(
-    "powershell.exe",
-    [
-      "-NoProfile",
-      "-Command",
-      `Get-CimInstance Win32_Process | Where-Object { ${filter} } | Select-Object -Property ProcessId,CommandLine | ForEach-Object { "$($_.ProcessId) $($_.CommandLine)" }`
-    ],
-    { encoding: "utf8" }
-  );
-  if (ps.status !== 0 || !ps.stdout)
-    return void 0;
-  return findMatchingLine(ps.stdout.toString(), predicate);
-}
-function findMatchingLine(psOutput, predicate) {
-  const lines = psOutput.split("\n").map((l) => l.trim()).filter(Boolean);
-  return lines.find(predicate);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  findBrowserProcess,
-  getBrowserExecPath
-});