@one2x/playwright 1.57.0-alpha.1

package/lib/mcp/extension/cdpRelay.js

@@ -0,0 +1,351 @@
+"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 cdpRelay_exports = {};
+__export(cdpRelay_exports, {
+  CDPRelayServer: () => CDPRelayServer
+});
+module.exports = __toCommonJS(cdpRelay_exports);
+var import_child_process = require("child_process");
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var import_registry = require("playwright-core/lib/server/registry/index");
+var import_utils = require("playwright-core/lib/utils");
+var import_http2 = require("../sdk/http");
+var import_log = require("../log");
+var protocol = __toESM(require("./protocol"));
+const debugLogger = (0, import_utilsBundle.debug)("pw:mcp:relay");
+class CDPRelayServer {
+  constructor(server, browserChannel, userDataDir, executablePath) {
+    this._playwrightConnection = null;
+    this._extensionConnection = null;
+    this._nextSessionId = 1;
+    this._wsHost = (0, import_http2.httpAddressToString)(server.address()).replace(/^http/, "ws");
+    this._browserChannel = browserChannel;
+    this._userDataDir = userDataDir;
+    this._executablePath = executablePath;
+    const uuid = crypto.randomUUID();
+    this._cdpPath = `/cdp/${uuid}`;
+    this._extensionPath = `/extension/${uuid}`;
+    this._resetExtensionConnection();
+    this._wss = new import_utilsBundle.wsServer({ server });
+    this._wss.on("connection", this._onConnection.bind(this));
+  }
+  cdpEndpoint() {
+    return `${this._wsHost}${this._cdpPath}`;
+  }
+  extensionEndpoint() {
+    return `${this._wsHost}${this._extensionPath}`;
+  }
+  async ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, toolName) {
+    debugLogger("Ensuring extension connection for MCP context");
+    if (this._extensionConnection)
+      return;
+    this._connectBrowser(clientInfo, toolName);
+    debugLogger("Waiting for incoming extension connection");
+    await Promise.race([
+      this._extensionConnectionPromise,
+      new Promise((_, reject) => setTimeout(() => {
+        reject(new Error(`Extension connection timeout. Make sure the "Playwright MCP Bridge" extension is installed. See https://github.com/microsoft/playwright-mcp/blob/main/extension/README.md for installation instructions.`));
+      }, process.env.PWMCP_TEST_CONNECTION_TIMEOUT ? parseInt(process.env.PWMCP_TEST_CONNECTION_TIMEOUT, 10) : 5e3)),
+      new Promise((_, reject) => abortSignal.addEventListener("abort", reject))
+    ]);
+    debugLogger("Extension connection established");
+  }
+  _connectBrowser(clientInfo, toolName) {
+    const mcpRelayEndpoint = `${this._wsHost}${this._extensionPath}`;
+    const url = new URL("chrome-extension://jakfalbnbhgkpmoaakfflhflbfpkailf/connect.html");
+    url.searchParams.set("mcpRelayUrl", mcpRelayEndpoint);
+    const client = {
+      name: clientInfo.name,
+      version: clientInfo.version
+    };
+    url.searchParams.set("client", JSON.stringify(client));
+    url.searchParams.set("protocolVersion", process.env.PWMCP_TEST_PROTOCOL_VERSION ?? protocol.VERSION.toString());
+    if (toolName)
+      url.searchParams.set("newTab", String(toolName === "browser_navigate"));
+    const token = process.env.PLAYWRIGHT_MCP_EXTENSION_TOKEN;
+    if (token)
+      url.searchParams.set("token", token);
+    const href = url.toString();
+    let executablePath = this._executablePath;
+    if (!executablePath) {
+      const executableInfo = import_registry.registry.findExecutable(this._browserChannel);
+      if (!executableInfo)
+        throw new Error(`Unsupported channel: "${this._browserChannel}"`);
+      executablePath = executableInfo.executablePath("javascript");
+      if (!executablePath)
+        throw new Error(`"${this._browserChannel}" executable not found. Make sure it is installed at a standard location.`);
+    }
+    const args = [];
+    if (this._userDataDir)
+      args.push(`--user-data-dir=${this._userDataDir}`);
+    args.push(href);
+    (0, import_child_process.spawn)(executablePath, args, {
+      windowsHide: true,
+      detached: true,
+      shell: false,
+      stdio: "ignore"
+    });
+  }
+  stop() {
+    this.closeConnections("Server stopped");
+    this._wss.close();
+  }
+  closeConnections(reason) {
+    this._closePlaywrightConnection(reason);
+    this._closeExtensionConnection(reason);
+  }
+  _onConnection(ws2, request) {
+    const url = new URL(`http://localhost${request.url}`);
+    debugLogger(`New connection to ${url.pathname}`);
+    if (url.pathname === this._cdpPath) {
+      this._handlePlaywrightConnection(ws2);
+    } else if (url.pathname === this._extensionPath) {
+      this._handleExtensionConnection(ws2);
+    } else {
+      debugLogger(`Invalid path: ${url.pathname}`);
+      ws2.close(4004, "Invalid path");
+    }
+  }
+  _handlePlaywrightConnection(ws2) {
+    if (this._playwrightConnection) {
+      debugLogger("Rejecting second Playwright connection");
+      ws2.close(1e3, "Another CDP client already connected");
+      return;
+    }
+    this._playwrightConnection = ws2;
+    ws2.on("message", async (data) => {
+      try {
+        const message = JSON.parse(data.toString());
+        await this._handlePlaywrightMessage(message);
+      } catch (error) {
+        debugLogger(`Error while handling Playwright message
+${data.toString()}
+`, error);
+      }
+    });
+    ws2.on("close", () => {
+      if (this._playwrightConnection !== ws2)
+        return;
+      this._playwrightConnection = null;
+      this._closeExtensionConnection("Playwright client disconnected");
+      debugLogger("Playwright WebSocket closed");
+    });
+    ws2.on("error", (error) => {
+      debugLogger("Playwright WebSocket error:", error);
+    });
+    debugLogger("Playwright MCP connected");
+  }
+  _closeExtensionConnection(reason) {
+    this._extensionConnection?.close(reason);
+    this._extensionConnectionPromise.reject(new Error(reason));
+    this._resetExtensionConnection();
+  }
+  _resetExtensionConnection() {
+    this._connectedTabInfo = void 0;
+    this._extensionConnection = null;
+    this._extensionConnectionPromise = new import_utils.ManualPromise();
+    void this._extensionConnectionPromise.catch(import_log.logUnhandledError);
+  }
+  _closePlaywrightConnection(reason) {
+    if (this._playwrightConnection?.readyState === import_utilsBundle.ws.OPEN)
+      this._playwrightConnection.close(1e3, reason);
+    this._playwrightConnection = null;
+  }
+  _handleExtensionConnection(ws2) {
+    if (this._extensionConnection) {
+      ws2.close(1e3, "Another extension connection already established");
+      return;
+    }
+    this._extensionConnection = new ExtensionConnection(ws2);
+    this._extensionConnection.onclose = (c, reason) => {
+      debugLogger("Extension WebSocket closed:", reason, c === this._extensionConnection);
+      if (this._extensionConnection !== c)
+        return;
+      this._resetExtensionConnection();
+      this._closePlaywrightConnection(`Extension disconnected: ${reason}`);
+    };
+    this._extensionConnection.onmessage = this._handleExtensionMessage.bind(this);
+    this._extensionConnectionPromise.resolve();
+  }
+  _handleExtensionMessage(method, params) {
+    switch (method) {
+      case "forwardCDPEvent":
+        const sessionId = params.sessionId || this._connectedTabInfo?.sessionId;
+        this._sendToPlaywright({
+          sessionId,
+          method: params.method,
+          params: params.params
+        });
+        break;
+    }
+  }
+  async _handlePlaywrightMessage(message) {
+    debugLogger("\u2190 Playwright:", `${message.method} (id=${message.id})`);
+    const { id, sessionId, method, params } = message;
+    try {
+      const result = await this._handleCDPCommand(method, params, sessionId);
+      this._sendToPlaywright({ id, sessionId, result });
+    } catch (e) {
+      debugLogger("Error in the extension:", e);
+      this._sendToPlaywright({
+        id,
+        sessionId,
+        error: { message: e.message }
+      });
+    }
+  }
+  async _handleCDPCommand(method, params, sessionId) {
+    switch (method) {
+      case "Browser.getVersion": {
+        return {
+          protocolVersion: "1.3",
+          product: "Chrome/Extension-Bridge",
+          userAgent: "CDP-Bridge-Server/1.0.0"
+        };
+      }
+      case "Browser.setDownloadBehavior": {
+        return {};
+      }
+      case "Target.setAutoAttach": {
+        if (sessionId)
+          break;
+        const { targetInfo } = await this._extensionConnection.send("attachToTab", {});
+        this._connectedTabInfo = {
+          targetInfo,
+          sessionId: `pw-tab-${this._nextSessionId++}`
+        };
+        debugLogger("Simulating auto-attach");
+        this._sendToPlaywright({
+          method: "Target.attachedToTarget",
+          params: {
+            sessionId: this._connectedTabInfo.sessionId,
+            targetInfo: {
+              ...this._connectedTabInfo.targetInfo,
+              attached: true
+            },
+            waitingForDebugger: false
+          }
+        });
+        return {};
+      }
+      case "Target.getTargetInfo": {
+        return this._connectedTabInfo?.targetInfo;
+      }
+    }
+    return await this._forwardToExtension(method, params, sessionId);
+  }
+  async _forwardToExtension(method, params, sessionId) {
+    if (!this._extensionConnection)
+      throw new Error("Extension not connected");
+    if (this._connectedTabInfo?.sessionId === sessionId)
+      sessionId = void 0;
+    return await this._extensionConnection.send("forwardCDPCommand", { sessionId, method, params });
+  }
+  _sendToPlaywright(message) {
+    debugLogger("\u2192 Playwright:", `${message.method ?? `response(id=${message.id})`}`);
+    this._playwrightConnection?.send(JSON.stringify(message));
+  }
+}
+class ExtensionConnection {
+  constructor(ws2) {
+    this._callbacks = /* @__PURE__ */ new Map();
+    this._lastId = 0;
+    this._ws = ws2;
+    this._ws.on("message", this._onMessage.bind(this));
+    this._ws.on("close", this._onClose.bind(this));
+    this._ws.on("error", this._onError.bind(this));
+  }
+  async send(method, params) {
+    if (this._ws.readyState !== import_utilsBundle.ws.OPEN)
+      throw new Error(`Unexpected WebSocket state: ${this._ws.readyState}`);
+    const id = ++this._lastId;
+    this._ws.send(JSON.stringify({ id, method, params }));
+    const error = new Error(`Protocol error: ${method}`);
+    return new Promise((resolve, reject) => {
+      this._callbacks.set(id, { resolve, reject, error });
+    });
+  }
+  close(message) {
+    debugLogger("closing extension connection:", message);
+    if (this._ws.readyState === import_utilsBundle.ws.OPEN)
+      this._ws.close(1e3, message);
+  }
+  _onMessage(event) {
+    const eventData = event.toString();
+    let parsedJson;
+    try {
+      parsedJson = JSON.parse(eventData);
+    } catch (e) {
+      debugLogger(`<closing ws> Closing websocket due to malformed JSON. eventData=${eventData} e=${e?.message}`);
+      this._ws.close();
+      return;
+    }
+    try {
+      this._handleParsedMessage(parsedJson);
+    } catch (e) {
+      debugLogger(`<closing ws> Closing websocket due to failed onmessage callback. eventData=${eventData} e=${e?.message}`);
+      this._ws.close();
+    }
+  }
+  _handleParsedMessage(object) {
+    if (object.id && this._callbacks.has(object.id)) {
+      const callback = this._callbacks.get(object.id);
+      this._callbacks.delete(object.id);
+      if (object.error) {
+        const error = callback.error;
+        error.message = object.error;
+        callback.reject(error);
+      } else {
+        callback.resolve(object.result);
+      }
+    } else if (object.id) {
+      debugLogger("\u2190 Extension: unexpected response", object);
+    } else {
+      this.onmessage?.(object.method, object.params);
+    }
+  }
+  _onClose(event) {
+    debugLogger(`<ws closed> code=${event.code} reason=${event.reason}`);
+    this._dispose();
+    this.onclose?.(this, event.reason);
+  }
+  _onError(event) {
+    debugLogger(`<ws error> message=${event.message} type=${event.type} target=${event.target}`);
+    this._dispose();
+  }
+  _dispose() {
+    for (const callback of this._callbacks.values())
+      callback.reject(new Error("WebSocket closed"));
+    this._callbacks.clear();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CDPRelayServer
+});

package/lib/mcp/extension/cdpRelay.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/extension/cdpRelay.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * WebSocket server that bridges Playwright MCP and Chrome Extension\n *\n * Endpoints:\n * - /cdp/guid - Full CDP interface for Playwright MCP\n * - /extension/guid - Extension connection for chrome.debugger forwarding\n */\n\nimport { spawn } from 'child_process';\nimport http from 'http';\n\nimport { debug, ws, wsServer } from 'playwright-core/lib/utilsBundle';\nimport { registry } from 'playwright-core/lib/server/registry/index';\nimport { ManualPromise } from 'playwright-core/lib/utils';\n\nimport { httpAddressToString } from '../sdk/http';\nimport { logUnhandledError } from '../log';\nimport * as protocol from './protocol';\n\nimport type websocket from 'ws';\nimport type { ClientInfo } from '../sdk/server';\nimport type { ExtensionCommand, ExtensionEvents } from './protocol';\nimport type { WebSocket, WebSocketServer } from 'playwright-core/lib/utilsBundle';\n\n\nconst debugLogger = debug('pw:mcp:relay');\n\ntype CDPCommand = {\n  id: number;\n  sessionId?: string;\n  method: string;\n  params?: any;\n};\n\ntype CDPResponse = {\n  id?: number;\n  sessionId?: string;\n  method?: string;\n  params?: any;\n  result?: any;\n  error?: { code?: number; message: string };\n};\n\nexport class CDPRelayServer {\n  private _wsHost: string;\n  private _browserChannel: string;\n  private _userDataDir?: string;\n  private _executablePath?: string;\n  private _cdpPath: string;\n  private _extensionPath: string;\n  private _wss: WebSocketServer;\n  private _playwrightConnection: WebSocket | null = null;\n  private _extensionConnection: ExtensionConnection | null = null;\n  private _connectedTabInfo: {\n    targetInfo: any;\n    // Page sessionId that should be used by this connection.\n    sessionId: string;\n  } | undefined;\n  private _nextSessionId: number = 1;\n  private _extensionConnectionPromise!: ManualPromise<void>;\n\n  constructor(server: http.Server, browserChannel: string, userDataDir?: string, executablePath?: string) {\n    this._wsHost = httpAddressToString(server.address()).replace(/^http/, 'ws');\n    this._browserChannel = browserChannel;\n    this._userDataDir = userDataDir;\n    this._executablePath = executablePath;\n\n    const uuid = crypto.randomUUID();\n    this._cdpPath = `/cdp/${uuid}`;\n    this._extensionPath = `/extension/${uuid}`;\n\n    this._resetExtensionConnection();\n    this._wss = new wsServer({ server });\n    this._wss.on('connection', this._onConnection.bind(this));\n  }\n\n  cdpEndpoint() {\n    return `${this._wsHost}${this._cdpPath}`;\n  }\n\n  extensionEndpoint() {\n    return `${this._wsHost}${this._extensionPath}`;\n  }\n\n  async ensureExtensionConnectionForMCPContext(clientInfo: ClientInfo, abortSignal: AbortSignal, toolName: string | undefined) {\n    debugLogger('Ensuring extension connection for MCP context');\n    if (this._extensionConnection)\n      return;\n    this._connectBrowser(clientInfo, toolName);\n    debugLogger('Waiting for incoming extension connection');\n    await Promise.race([\n      this._extensionConnectionPromise,\n      new Promise((_, reject) => setTimeout(() => {\n        reject(new Error(`Extension connection timeout. Make sure the \"Playwright MCP Bridge\" extension is installed. See https://github.com/microsoft/playwright-mcp/blob/main/extension/README.md for installation instructions.`));\n      }, process.env.PWMCP_TEST_CONNECTION_TIMEOUT ? parseInt(process.env.PWMCP_TEST_CONNECTION_TIMEOUT, 10) : 5_000)),\n      new Promise((_, reject) => abortSignal.addEventListener('abort', reject))\n    ]);\n    debugLogger('Extension connection established');\n  }\n\n  private _connectBrowser(clientInfo: ClientInfo, toolName: string | undefined) {\n    const mcpRelayEndpoint = `${this._wsHost}${this._extensionPath}`;\n    // Need to specify \"key\" in the manifest.json to make the id stable when loading from file.\n    const url = new URL('chrome-extension://jakfalbnbhgkpmoaakfflhflbfpkailf/connect.html');\n    url.searchParams.set('mcpRelayUrl', mcpRelayEndpoint);\n    const client = {\n      name: clientInfo.name,\n      version: clientInfo.version,\n    };\n    url.searchParams.set('client', JSON.stringify(client));\n    url.searchParams.set('protocolVersion', process.env.PWMCP_TEST_PROTOCOL_VERSION ?? protocol.VERSION.toString());\n    if (toolName)\n      url.searchParams.set('newTab', String(toolName === 'browser_navigate'));\n    const token = process.env.PLAYWRIGHT_MCP_EXTENSION_TOKEN;\n    if (token)\n      url.searchParams.set('token', token);\n    const href = url.toString();\n\n    let executablePath = this._executablePath;\n    if (!executablePath) {\n      const executableInfo = registry.findExecutable(this._browserChannel);\n      if (!executableInfo)\n        throw new Error(`Unsupported channel: \"${this._browserChannel}\"`);\n      executablePath = executableInfo.executablePath('javascript');\n      if (!executablePath)\n        throw new Error(`\"${this._browserChannel}\" executable not found. Make sure it is installed at a standard location.`);\n    }\n\n    const args: string[] = [];\n    if (this._userDataDir)\n      args.push(`--user-data-dir=${this._userDataDir}`);\n    args.push(href);\n\n    spawn(executablePath, args, {\n      windowsHide: true,\n      detached: true,\n      shell: false,\n      stdio: 'ignore',\n    });\n  }\n\n  stop(): void {\n    this.closeConnections('Server stopped');\n    this._wss.close();\n  }\n\n  closeConnections(reason: string) {\n    this._closePlaywrightConnection(reason);\n    this._closeExtensionConnection(reason);\n  }\n\n  private _onConnection(ws: WebSocket, request: http.IncomingMessage): void {\n    const url = new URL(`http://localhost${request.url}`);\n    debugLogger(`New connection to ${url.pathname}`);\n    if (url.pathname === this._cdpPath) {\n      this._handlePlaywrightConnection(ws);\n    } else if (url.pathname === this._extensionPath) {\n      this._handleExtensionConnection(ws);\n    } else {\n      debugLogger(`Invalid path: ${url.pathname}`);\n      ws.close(4004, 'Invalid path');\n    }\n  }\n\n  private _handlePlaywrightConnection(ws: WebSocket): void {\n    if (this._playwrightConnection) {\n      debugLogger('Rejecting second Playwright connection');\n      ws.close(1000, 'Another CDP client already connected');\n      return;\n    }\n    this._playwrightConnection = ws;\n    ws.on('message', async data => {\n      try {\n        const message = JSON.parse(data.toString());\n        await this._handlePlaywrightMessage(message);\n      } catch (error: any) {\n        debugLogger(`Error while handling Playwright message\\n${data.toString()}\\n`, error);\n      }\n    });\n    ws.on('close', () => {\n      if (this._playwrightConnection !== ws)\n        return;\n      this._playwrightConnection = null;\n      this._closeExtensionConnection('Playwright client disconnected');\n      debugLogger('Playwright WebSocket closed');\n    });\n    ws.on('error', error => {\n      debugLogger('Playwright WebSocket error:', error);\n    });\n    debugLogger('Playwright MCP connected');\n  }\n\n  private _closeExtensionConnection(reason: string) {\n    this._extensionConnection?.close(reason);\n    this._extensionConnectionPromise.reject(new Error(reason));\n    this._resetExtensionConnection();\n  }\n\n  private _resetExtensionConnection() {\n    this._connectedTabInfo = undefined;\n    this._extensionConnection = null;\n    this._extensionConnectionPromise = new ManualPromise();\n    void this._extensionConnectionPromise.catch(logUnhandledError);\n  }\n\n  private _closePlaywrightConnection(reason: string) {\n    if (this._playwrightConnection?.readyState === ws.OPEN)\n      this._playwrightConnection.close(1000, reason);\n    this._playwrightConnection = null;\n  }\n\n  private _handleExtensionConnection(ws: WebSocket): void {\n    if (this._extensionConnection) {\n      ws.close(1000, 'Another extension connection already established');\n      return;\n    }\n    this._extensionConnection = new ExtensionConnection(ws);\n    this._extensionConnection.onclose = (c, reason) => {\n      debugLogger('Extension WebSocket closed:', reason, c === this._extensionConnection);\n      if (this._extensionConnection !== c)\n        return;\n      this._resetExtensionConnection();\n      this._closePlaywrightConnection(`Extension disconnected: ${reason}`);\n    };\n    this._extensionConnection.onmessage = this._handleExtensionMessage.bind(this);\n    this._extensionConnectionPromise.resolve();\n  }\n\n  private _handleExtensionMessage<M extends keyof ExtensionEvents>(method: M, params: ExtensionEvents[M]['params']) {\n    switch (method) {\n      case 'forwardCDPEvent':\n        const sessionId = params.sessionId || this._connectedTabInfo?.sessionId;\n        this._sendToPlaywright({\n          sessionId,\n          method: params.method,\n          params: params.params\n        });\n        break;\n    }\n  }\n\n  private async _handlePlaywrightMessage(message: CDPCommand): Promise<void> {\n    debugLogger('\u2190 Playwright:', `${message.method} (id=${message.id})`);\n    const { id, sessionId, method, params } = message;\n    try {\n      const result = await this._handleCDPCommand(method, params, sessionId);\n      this._sendToPlaywright({ id, sessionId, result });\n    } catch (e) {\n      debugLogger('Error in the extension:', e);\n      this._sendToPlaywright({\n        id,\n        sessionId,\n        error: { message: (e as Error).message }\n      });\n    }\n  }\n\n  private async _handleCDPCommand(method: string, params: any, sessionId: string | undefined): Promise<any> {\n    switch (method) {\n      case 'Browser.getVersion': {\n        return {\n          protocolVersion: '1.3',\n          product: 'Chrome/Extension-Bridge',\n          userAgent: 'CDP-Bridge-Server/1.0.0',\n        };\n      }\n      case 'Browser.setDownloadBehavior': {\n        return { };\n      }\n      case 'Target.setAutoAttach': {\n        // Forward child session handling.\n        if (sessionId)\n          break;\n        // Simulate auto-attach behavior with real target info\n        const { targetInfo } = await this._extensionConnection!.send('attachToTab', { });\n        this._connectedTabInfo = {\n          targetInfo,\n          sessionId: `pw-tab-${this._nextSessionId++}`,\n        };\n        debugLogger('Simulating auto-attach');\n        this._sendToPlaywright({\n          method: 'Target.attachedToTarget',\n          params: {\n            sessionId: this._connectedTabInfo.sessionId,\n            targetInfo: {\n              ...this._connectedTabInfo.targetInfo,\n              attached: true,\n            },\n            waitingForDebugger: false\n          }\n        });\n        return { };\n      }\n      case 'Target.getTargetInfo': {\n        return this._connectedTabInfo?.targetInfo;\n      }\n    }\n    return await this._forwardToExtension(method, params, sessionId);\n  }\n\n  private async _forwardToExtension(method: string, params: any, sessionId: string | undefined): Promise<any> {\n    if (!this._extensionConnection)\n      throw new Error('Extension not connected');\n    // Top level sessionId is only passed between the relay and the client.\n    if (this._connectedTabInfo?.sessionId === sessionId)\n      sessionId = undefined;\n    return await this._extensionConnection.send('forwardCDPCommand', { sessionId, method, params });\n  }\n\n  private _sendToPlaywright(message: CDPResponse): void {\n    debugLogger('\u2192 Playwright:', `${message.method ?? `response(id=${message.id})`}`);\n    this._playwrightConnection?.send(JSON.stringify(message));\n  }\n}\n\ntype ExtensionResponse = {\n  id?: number;\n  method?: string;\n  params?: any;\n  result?: any;\n  error?: string;\n};\n\nclass ExtensionConnection {\n  private readonly _ws: WebSocket;\n  private readonly _callbacks = new Map<number, { resolve: (o: any) => void, reject: (e: Error) => void, error: Error }>();\n  private _lastId = 0;\n\n  onmessage?: <M extends keyof ExtensionEvents>(method: M, params: ExtensionEvents[M]['params']) => void;\n  onclose?: (self: ExtensionConnection, reason: string) => void;\n\n  constructor(ws: WebSocket) {\n    this._ws = ws;\n    this._ws.on('message', this._onMessage.bind(this));\n    this._ws.on('close', this._onClose.bind(this));\n    this._ws.on('error', this._onError.bind(this));\n  }\n\n  async send<M extends keyof ExtensionCommand>(method: M, params: ExtensionCommand[M]['params']): Promise<any> {\n    if (this._ws.readyState !== ws.OPEN)\n      throw new Error(`Unexpected WebSocket state: ${this._ws.readyState}`);\n    const id = ++this._lastId;\n    this._ws.send(JSON.stringify({ id, method, params }));\n    const error = new Error(`Protocol error: ${method}`);\n    return new Promise((resolve, reject) => {\n      this._callbacks.set(id, { resolve, reject, error });\n    });\n  }\n\n  close(message: string) {\n    debugLogger('closing extension connection:', message);\n    if (this._ws.readyState === ws.OPEN)\n      this._ws.close(1000, message);\n  }\n\n  private _onMessage(event: websocket.RawData) {\n    const eventData = event.toString();\n    let parsedJson;\n    try {\n      parsedJson = JSON.parse(eventData);\n    } catch (e: any) {\n      debugLogger(`<closing ws> Closing websocket due to malformed JSON. eventData=${eventData} e=${e?.message}`);\n      this._ws.close();\n      return;\n    }\n    try {\n      this._handleParsedMessage(parsedJson);\n    } catch (e: any) {\n      debugLogger(`<closing ws> Closing websocket due to failed onmessage callback. eventData=${eventData} e=${e?.message}`);\n      this._ws.close();\n    }\n  }\n\n  private _handleParsedMessage(object: ExtensionResponse) {\n    if (object.id && this._callbacks.has(object.id)) {\n      const callback = this._callbacks.get(object.id)!;\n      this._callbacks.delete(object.id);\n      if (object.error) {\n        const error = callback.error;\n        error.message = object.error;\n        callback.reject(error);\n      } else {\n        callback.resolve(object.result);\n      }\n    } else if (object.id) {\n      debugLogger('\u2190 Extension: unexpected response', object);\n    } else {\n      this.onmessage?.(object.method! as keyof ExtensionEvents, object.params);\n    }\n  }\n\n  private _onClose(event: websocket.CloseEvent) {\n    debugLogger(`<ws closed> code=${event.code} reason=${event.reason}`);\n    this._dispose();\n    this.onclose?.(this, event.reason);\n  }\n\n  private _onError(event: websocket.ErrorEvent) {\n    debugLogger(`<ws error> message=${event.message} type=${event.type} target=${event.target}`);\n    this._dispose();\n  }\n\n  private _dispose() {\n    for (const callback of this._callbacks.values())\n      callback.reject(new Error('WebSocket closed'));\n    this._callbacks.clear();\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["import_http", "ws"]
+}

package/lib/mcp/extension/extensionContextFactory.js

@@ -0,0 +1,75 @@
+"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 extensionContextFactory_exports = {};
+__export(extensionContextFactory_exports, {
+  ExtensionContextFactory: () => ExtensionContextFactory
+});
+module.exports = __toCommonJS(extensionContextFactory_exports);
+var playwright = __toESM(require("playwright-core"));
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var import_http = require("../sdk/http");
+var import_cdpRelay = require("./cdpRelay");
+const debugLogger = (0, import_utilsBundle.debug)("pw:mcp:relay");
+class ExtensionContextFactory {
+  constructor(browserChannel, userDataDir, executablePath) {
+    this._browserChannel = browserChannel;
+    this._userDataDir = userDataDir;
+    this._executablePath = executablePath;
+  }
+  async createContext(clientInfo, abortSignal, toolName) {
+    const browser = await this._obtainBrowser(clientInfo, abortSignal, toolName);
+    return {
+      browserContext: browser.contexts()[0],
+      close: async () => {
+        debugLogger("close() called for browser context");
+        await browser.close();
+      }
+    };
+  }
+  async _obtainBrowser(clientInfo, abortSignal, toolName) {
+    const relay = await this._startRelay(abortSignal);
+    await relay.ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, toolName);
+    return await playwright.chromium.connectOverCDP(relay.cdpEndpoint());
+  }
+  async _startRelay(abortSignal) {
+    const httpServer = await (0, import_http.startHttpServer)({});
+    if (abortSignal.aborted) {
+      httpServer.close();
+      throw new Error(abortSignal.reason);
+    }
+    const cdpRelayServer = new import_cdpRelay.CDPRelayServer(httpServer, this._browserChannel, this._userDataDir, this._executablePath);
+    abortSignal.addEventListener("abort", () => cdpRelayServer.stop());
+    debugLogger(`CDP relay server started, extension endpoint: ${cdpRelayServer.extensionEndpoint()}.`);
+    return cdpRelayServer;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExtensionContextFactory
+});

package/lib/mcp/extension/extensionContextFactory.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/extension/extensionContextFactory.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as playwright from 'playwright-core';\nimport { debug } from 'playwright-core/lib/utilsBundle';\n\nimport { startHttpServer } from '../sdk/http';\nimport { CDPRelayServer } from './cdpRelay';\n\nimport type { BrowserContextFactory } from '../browser/browserContextFactory';\nimport type { ClientInfo } from '../sdk/server';\n\nconst debugLogger = debug('pw:mcp:relay');\n\nexport class ExtensionContextFactory implements BrowserContextFactory {\n  private _browserChannel: string;\n  private _userDataDir?: string;\n  private _executablePath?: string;\n\n  constructor(browserChannel: string, userDataDir: string | undefined, executablePath: string | undefined) {\n    this._browserChannel = browserChannel;\n    this._userDataDir = userDataDir;\n    this._executablePath = executablePath;\n  }\n\n  async createContext(clientInfo: ClientInfo, abortSignal: AbortSignal, toolName: string | undefined): Promise<{ browserContext: playwright.BrowserContext, close: () => Promise<void> }> {\n    const browser = await this._obtainBrowser(clientInfo, abortSignal, toolName);\n    return {\n      browserContext: browser.contexts()[0],\n      close: async () => {\n        debugLogger('close() called for browser context');\n        await browser.close();\n      }\n    };\n  }\n\n  private async _obtainBrowser(clientInfo: ClientInfo, abortSignal: AbortSignal, toolName: string | undefined): Promise<playwright.Browser> {\n    const relay = await this._startRelay(abortSignal);\n    await relay.ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, toolName);\n    return await playwright.chromium.connectOverCDP(relay.cdpEndpoint());\n  }\n\n  private async _startRelay(abortSignal: AbortSignal) {\n    const httpServer = await startHttpServer({});\n    if (abortSignal.aborted) {\n      httpServer.close();\n      throw new Error(abortSignal.reason);\n    }\n    const cdpRelayServer = new CDPRelayServer(httpServer, this._browserChannel, this._userDataDir, this._executablePath);\n    abortSignal.addEventListener('abort', () => cdpRelayServer.stop());\n    debugLogger(`CDP relay server started, extension endpoint: ${cdpRelayServer.extensionEndpoint()}.`);\n    return cdpRelayServer;\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,iBAA4B;AAC5B,yBAAsB;AAEtB,kBAAgC;AAChC,sBAA+B;AAK/B,MAAM,kBAAc,0BAAM,cAAc;AAEjC,MAAM,wBAAyD;AAAA,EAKpE,YAAY,gBAAwB,aAAiC,gBAAoC;AACvG,SAAK,kBAAkB;AACvB,SAAK,eAAe;AACpB,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEA,MAAM,cAAc,YAAwB,aAA0B,UAAkH;AACtL,UAAM,UAAU,MAAM,KAAK,eAAe,YAAY,aAAa,QAAQ;AAC3E,WAAO;AAAA,MACL,gBAAgB,QAAQ,SAAS,EAAE,CAAC;AAAA,MACpC,OAAO,YAAY;AACjB,oBAAY,oCAAoC;AAChD,cAAM,QAAQ,MAAM;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,eAAe,YAAwB,aAA0B,UAA2D;AACxI,UAAM,QAAQ,MAAM,KAAK,YAAY,WAAW;AAChD,UAAM,MAAM,uCAAuC,YAAY,aAAa,QAAQ;AACpF,WAAO,MAAM,WAAW,SAAS,eAAe,MAAM,YAAY,CAAC;AAAA,EACrE;AAAA,EAEA,MAAc,YAAY,aAA0B;AAClD,UAAM,aAAa,UAAM,6BAAgB,CAAC,CAAC;AAC3C,QAAI,YAAY,SAAS;AACvB,iBAAW,MAAM;AACjB,YAAM,IAAI,MAAM,YAAY,MAAM;AAAA,IACpC;AACA,UAAM,iBAAiB,IAAI,+BAAe,YAAY,KAAK,iBAAiB,KAAK,cAAc,KAAK,eAAe;AACnH,gBAAY,iBAAiB,SAAS,MAAM,eAAe,KAAK,CAAC;AACjE,gBAAY,iDAAiD,eAAe,kBAAkB,CAAC,GAAG;AAClG,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/lib/mcp/extension/protocol.js

@@ -0,0 +1,28 @@
+"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 protocol_exports = {};
+__export(protocol_exports, {
+  VERSION: () => VERSION
+});
+module.exports = __toCommonJS(protocol_exports);
+const VERSION = 1;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VERSION
+});

package/lib/mcp/extension/protocol.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/mcp/extension/protocol.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Whenever the commands/events change, the version must be updated. The latest\n// extension version should be compatible with the old MCP clients.\nexport const VERSION = 1;\n\nexport type ExtensionCommand = {\n  'attachToTab': {\n    params: {};\n  };\n  'forwardCDPCommand': {\n    params: {\n      method: string,\n      sessionId?: string\n      params?: any,\n    };\n  };\n};\n\nexport type ExtensionEvents = {\n  'forwardCDPEvent': {\n    params: {\n      method: string,\n      sessionId?: string\n      params?: any,\n    };\n  };\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBO,MAAM,UAAU;",
+  "names": []
+}

package/lib/mcp/index.js

@@ -0,0 +1,61 @@
+"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 mcp_exports = {};
+__export(mcp_exports, {
+  createConnection: () => createConnection
+});
+module.exports = __toCommonJS(mcp_exports);
+var import_browserServerBackend = require("./browser/browserServerBackend");
+var import_config = require("./browser/config");
+var import_browserContextFactory = require("./browser/browserContextFactory");
+var mcpServer = __toESM(require("./sdk/server"));
+const packageJSON = require("../../package.json");
+async function createConnection(userConfig = {}, contextGetter) {
+  const config = await (0, import_config.resolveConfig)(userConfig);
+  const factory = contextGetter ? new SimpleBrowserContextFactory(contextGetter) : (0, import_browserContextFactory.contextFactory)(config);
+  return mcpServer.createServer("Playwright", packageJSON.version, new import_browserServerBackend.BrowserServerBackend(config, factory), false);
+}
+class SimpleBrowserContextFactory {
+  constructor(contextGetter) {
+    this.name = "custom";
+    this.description = "Connect to a browser using a custom context getter";
+    this._contextGetter = contextGetter;
+  }
+  async createContext() {
+    const browserContext = await this._contextGetter();
+    return {
+      browserContext,
+      close: () => browserContext.close()
+    };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createConnection
+});

package/lib/mcp/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/mcp/index.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { BrowserServerBackend } from './browser/browserServerBackend';\nimport { resolveConfig } from './browser/config';\nimport { contextFactory } from './browser/browserContextFactory';\nimport * as mcpServer from './sdk/server';\n\nimport type { Config } from './config';\nimport type { BrowserContext } from 'playwright';\nimport type { BrowserContextFactory } from './browser/browserContextFactory';\nimport type { Server } from '@modelcontextprotocol/sdk/server/index.js';\n\nconst packageJSON = require('../../package.json');\n\nexport async function createConnection(userConfig: Config = {}, contextGetter?: () => Promise<BrowserContext>): Promise<Server> {\n  const config = await resolveConfig(userConfig);\n  const factory = contextGetter ? new SimpleBrowserContextFactory(contextGetter) : contextFactory(config);\n  return mcpServer.createServer('Playwright', packageJSON.version, new BrowserServerBackend(config, factory), false);\n}\n\nclass SimpleBrowserContextFactory implements BrowserContextFactory {\n  name = 'custom';\n  description = 'Connect to a browser using a custom context getter';\n\n  private readonly _contextGetter: () => Promise<BrowserContext>;\n\n  constructor(contextGetter: () => Promise<BrowserContext>) {\n    this._contextGetter = contextGetter;\n  }\n\n  async createContext(): Promise<{ browserContext: BrowserContext, close: () => Promise<void> }> {\n    const browserContext = await this._contextGetter();\n    return {\n      browserContext,\n      close: () => browserContext.close()\n    };\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,kCAAqC;AACrC,oBAA8B;AAC9B,mCAA+B;AAC/B,gBAA2B;AAO3B,MAAM,cAAc,QAAQ,oBAAoB;AAEhD,eAAsB,iBAAiB,aAAqB,CAAC,GAAG,eAAgE;AAC9H,QAAM,SAAS,UAAM,6BAAc,UAAU;AAC7C,QAAM,UAAU,gBAAgB,IAAI,4BAA4B,aAAa,QAAI,6CAAe,MAAM;AACtG,SAAO,UAAU,aAAa,cAAc,YAAY,SAAS,IAAI,iDAAqB,QAAQ,OAAO,GAAG,KAAK;AACnH;AAEA,MAAM,4BAA6D;AAAA,EAMjE,YAAY,eAA8C;AAL1D,gBAAO;AACP,uBAAc;AAKZ,SAAK,iBAAiB;AAAA,EACxB;AAAA,EAEA,MAAM,gBAAyF;AAC7F,UAAM,iBAAiB,MAAM,KAAK,eAAe;AACjD,WAAO;AAAA,MACL;AAAA,MACA,OAAO,MAAM,eAAe,MAAM;AAAA,IACpC;AAAA,EACF;AACF;",
+  "names": []
+}

package/lib/mcp/log.js

@@ -0,0 +1,35 @@
+"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 log_exports = {};
+__export(log_exports, {
+  logUnhandledError: () => logUnhandledError,
+  testDebug: () => testDebug
+});
+module.exports = __toCommonJS(log_exports);
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+const errorDebug = (0, import_utilsBundle.debug)("pw:mcp:error");
+function logUnhandledError(error) {
+  errorDebug(error);
+}
+const testDebug = (0, import_utilsBundle.debug)("pw:mcp:test");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  logUnhandledError,
+  testDebug
+});

package/lib/mcp/log.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/mcp/log.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) Microsoft Corporation.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { debug } from 'playwright-core/lib/utilsBundle';\n\nconst errorDebug = debug('pw:mcp:error');\n\nexport function logUnhandledError(error: unknown) {\n  errorDebug(error);\n}\n\nexport const testDebug = debug('pw:mcp:test');\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,yBAAsB;AAEtB,MAAM,iBAAa,0BAAM,cAAc;AAEhC,SAAS,kBAAkB,OAAgB;AAChD,aAAW,KAAK;AAClB;AAEO,MAAM,gBAAY,0BAAM,aAAa;",
+  "names": []
+}