@cotestdev/mcp_playwright 0.0.28 → 0.0.29

package/lib/mcp/browser/browserContextFactory.js

@@ -141,7 +141,10 @@ class CdpContextFactory extends BaseContextFactory {
     super("cdp", config);
   }
   async _doObtainBrowser() {
-    return playwright.chromium.connectOverCDP(this.config.browser.cdpEndpoint, { headers: this.config.browser.cdpHeaders });
+    return playwright.chromium.connectOverCDP(this.config.browser.cdpEndpoint, {
+      headers: this.config.browser.cdpHeaders,
+      timeout: this.config.browser.cdpTimeout
+    });
   }
   async _doCreateContext(browser) {
     return this.config.browser.isolated ? await browser.newContext() : browser.contexts()[0];
@@ -199,7 +202,12 @@ class PersistentContextFactory {
       } 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")) {
+        if (error.message.includes("cannot open shared object file: No such file or directory")) {
+          const browserName = launchOptions.channel ?? this.config.browser.browserName;
+          throw new Error(`Missing system dependencies required to run browser ${browserName}. Install them with: sudo npx playwright install-deps ${browserName}`);
+        }
+        if (error.message.includes("ProcessSingleton") || // On Windows the process exits silently with code 21 when the profile is in use.
+        error.message.includes("exitCode=21")) {
           await new Promise((resolve) => setTimeout(resolve, 1e3));
           continue;
         }

package/lib/mcp/browser/tab.js

@@ -237,7 +237,9 @@ class Tab extends import_events.EventEmitter {
     await this._initializedPromise;
     return Promise.all(params.map(async (param) => {
       try {
-        const locator = this.page.locator(`aria-ref=${param.ref}`).describe(param.element);
+        let locator = this.page.locator(`aria-ref=${param.ref}`);
+        if (param.element)
+          locator = locator.describe(param.element);
         const { resolvedSelector } = await locator._resolveSelector();
         return { locator, resolved: (0, import_utils.asLocator)("javascript", resolvedSelector) };
       } catch (e) {

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

@@ -74,7 +74,7 @@ const runCode = (0, import_tool.defineTabTool)({
     });
   }
 });
-const scriptSchema = import_mcpBundle.z.object({
+const scriptSchema = import_common.baseSchema.extend({
   code: import_mcpBundle.z.string().describe(`A Typescript function containing Playwright code to execute. It will be invoked with a single argument, page, which you can use for any page interaction. For example: \`async (page) => { await page.getByRole('button', { name: 'Submit' }).click(); return await page.title(); }\``),
   params: import_mcpBundle.z.record(import_mcpBundle.z.any()).optional().describe("Parameters to pass to the script.")
 });
@@ -89,7 +89,6 @@ const runScript = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
-    response.addCode(`await (${params.code})(page);`);
     const __end__ = new import_utils.ManualPromise();
     const context = {
       page: tab.page,

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

@@ -61,7 +61,7 @@ const snapshot = (0, import_tool.defineTool)({
   }
 });
 const elementSchema = import_common.baseSchema.extend({
-  element: import_mcpBundle.z.string().describe("Human-readable element description used to obtain permission to interact with the element"),
+  element: import_mcpBundle.z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
   ref: import_mcpBundle.z.string().describe("Exact target element reference from the page snapshot")
 });
 const clickSchema = elementSchema.extend({

package/lib/mcp/program.js

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

package/lib/mcp/sdk/tool.js

@@ -28,7 +28,7 @@ function toMcpTool(tool) {
   return {
     name: tool.name,
     description: tool.description,
-    inputSchema: (0, import_mcpBundle.zodToJsonSchema)(tool.inputSchema, { strictUnions: true }),
+    inputSchema: import_mcpBundle.z.toJSONSchema(tool.inputSchema),
     annotations: {
       title: tool.title,
       readOnlyHint: readOnly,

package/lib/mcp/terminal/cli.js

@@ -0,0 +1,219 @@
+"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 __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 import_child_process = require("child_process");
+var import_fs = __toESM(require("fs"));
+var import_net = __toESM(require("net"));
+var import_os = __toESM(require("os"));
+var import_path = __toESM(require("path"));
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var import_socketConnection = require("./socketConnection");
+const debugCli = (0, import_utilsBundle.debug)("pw:cli");
+const packageJSON = require("../../../package.json");
+import_utilsBundle.program.version("Version " + (process.env.PW_CLI_DISPLAY_VERSION || packageJSON.version)).name("playwright-command");
+function addCommand(name, description, action) {
+  import_utilsBundle.program.command(name).description(description).action(action);
+}
+addCommand("navigate <url>", "open url in the browser", async (url) => {
+  await runMcpCommand("browser_navigate", { url });
+});
+addCommand("close", "close the browser", async () => {
+  await runMcpCommand("browser_close", {});
+});
+addCommand("click <ref>", "click an element using a ref from a snapshot, e.g. e67", async (ref) => {
+  await runMcpCommand("browser_click", { ref });
+});
+addCommand("snapshot", "get accessible snapshot of the current page", async () => {
+  await runMcpCommand("browser_snapshot", {});
+});
+addCommand("drag <startRef> <endRef>", "drag from one element to another", async (startRef, endRef) => {
+  await runMcpCommand("browser_drag", { startRef, endRef });
+});
+addCommand("hover <ref>", "hover over an element", async (ref) => {
+  await runMcpCommand("browser_hover", { ref });
+});
+addCommand("select <ref> <values...>", "select option(s) in a dropdown", async (ref, values) => {
+  await runMcpCommand("browser_select_option", { ref, values });
+});
+addCommand("locator <ref>", "generate a locator for an element", async (ref) => {
+  await runMcpCommand("browser_generate_locator", { ref });
+});
+addCommand("press <key>", "press a key on the keyboard", async (key) => {
+  await runMcpCommand("browser_press_key", { key });
+});
+addCommand("type <ref> <text>", "type text into an element", async (ref, text) => {
+  await runMcpCommand("browser_type", { ref, text });
+});
+addCommand("back", "go back to the previous page", async () => {
+  await runMcpCommand("browser_navigate_back", {});
+});
+addCommand("wait <time>", "wait for a specified time in seconds", async (time) => {
+  await runMcpCommand("browser_wait_for", { time: parseFloat(time) });
+});
+addCommand("wait-for-text <text>", "wait for text to appear", async (text) => {
+  await runMcpCommand("browser_wait_for", { text });
+});
+addCommand("dialog-accept [promptText]", "accept a dialog", async (promptText) => {
+  await runMcpCommand("browser_handle_dialog", { accept: true, promptText });
+});
+addCommand("dialog-dismiss", "dismiss a dialog", async () => {
+  await runMcpCommand("browser_handle_dialog", { accept: false });
+});
+addCommand("screenshot [filename]", "take a screenshot of the current page", async (filename) => {
+  await runMcpCommand("browser_take_screenshot", { filename });
+});
+addCommand("resize <width> <height>", "resize the browser window", async (width, height) => {
+  await runMcpCommand("browser_resize", { width: parseInt(width, 10), height: parseInt(height, 10) });
+});
+addCommand("upload <paths...>", "upload files", async (paths) => {
+  await runMcpCommand("browser_file_upload", { paths });
+});
+addCommand("tabs", "list all browser tabs", async () => {
+  await runMcpCommand("browser_tabs", { action: "list" });
+});
+addCommand("tab-new", "create a new browser tab", async () => {
+  await runMcpCommand("browser_tabs", { action: "new" });
+});
+addCommand("tab-close [index]", "close a browser tab", async (index) => {
+  await runMcpCommand("browser_tabs", { action: "close", index: index !== void 0 ? parseInt(index, 10) : void 0 });
+});
+addCommand("tab-select <index>", "select a browser tab", async (index) => {
+  await runMcpCommand("browser_tabs", { action: "select", index: parseInt(index, 10) });
+});
+async function runMcpCommand(name, args) {
+  const session = await connectToDaemon();
+  const result = await session.callTool(name, args);
+  printResult(result);
+  session.dispose();
+}
+function printResult(result) {
+  for (const content of result.content) {
+    if (content.type === "text")
+      console.log(content.text);
+    else
+      console.log(`<${content.type} content>`);
+  }
+}
+async function socketExists(socketPath) {
+  try {
+    const stat = await import_fs.default.promises.stat(socketPath);
+    if (stat?.isSocket())
+      return true;
+  } catch (e) {
+  }
+  return false;
+}
+class SocketSession {
+  constructor(connection) {
+    this._nextMessageId = 1;
+    this._callbacks = /* @__PURE__ */ new Map();
+    this._connection = connection;
+    this._connection.onmessage = (message) => this._onMessage(message);
+    this._connection.onclose = () => this.dispose();
+  }
+  async callTool(name, args) {
+    return this._send(name, args);
+  }
+  async _send(method, params = {}) {
+    const messageId = this._nextMessageId++;
+    const message = {
+      id: messageId,
+      method,
+      params
+    };
+    await this._connection.send(message);
+    return new Promise((resolve, reject) => {
+      this._callbacks.set(messageId, { resolve, reject, error: new Error(`Error in method: ${method}`) });
+    });
+  }
+  dispose() {
+    for (const callback of this._callbacks.values())
+      callback.reject(callback.error);
+    this._callbacks.clear();
+    this._connection.close();
+  }
+  _onMessage(object) {
+    if (object.id && this._callbacks.has(object.id)) {
+      const callback = this._callbacks.get(object.id);
+      this._callbacks.delete(object.id);
+      if (object.error) {
+        callback.error.cause = new Error(object.error);
+        callback.reject(callback.error);
+      } else {
+        callback.resolve(object.result);
+      }
+    } else if (object.id) {
+      throw new Error(`Unexpected message id: ${object.id}`);
+    } else {
+      throw new Error(`Unexpected message without id: ${JSON.stringify(object)}`);
+    }
+  }
+}
+function daemonSocketPath() {
+  if (import_os.default.platform() === "win32")
+    return import_path.default.join("\\\\.\\pipe", "pw-daemon.sock");
+  return import_path.default.join(import_os.default.homedir(), ".playwright", "pw-daemon.sock");
+}
+async function connectToDaemon() {
+  const socketPath = daemonSocketPath();
+  debugCli(`Connecting to daemon at ${socketPath}`);
+  if (await socketExists(socketPath)) {
+    debugCli(`Socket file exists, attempting to connect...`);
+    try {
+      return await connectToSocket(socketPath);
+    } catch (e) {
+      import_fs.default.unlinkSync(socketPath);
+    }
+  }
+  const cliPath = import_path.default.join(__dirname, "../../../cli.js");
+  debugCli(`Will launch daemon process: ${cliPath}`);
+  const child = (0, import_child_process.spawn)(process.execPath, [cliPath, "run-mcp-server", `--daemon=${socketPath}`], {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+  const maxRetries = 50;
+  const retryDelay = 100;
+  for (let i = 0; i < maxRetries; i++) {
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    try {
+      return await connectToSocket(socketPath);
+    } catch (e) {
+      if (e.code !== "ENOENT")
+        throw e;
+      debugCli(`Retrying to connect to daemon at ${socketPath} (${i + 1}/${maxRetries})`);
+    }
+  }
+  throw new Error(`Failed to connect to daemon at ${socketPath} after ${maxRetries * retryDelay}ms`);
+}
+async function connectToSocket(socketPath) {
+  const socket = await new Promise((resolve, reject) => {
+    const socket2 = import_net.default.createConnection(socketPath, () => {
+      debugCli(`Connected to daemon at ${socketPath}`);
+      resolve(socket2);
+    });
+    socket2.on("error", reject);
+  });
+  return new SocketSession(new import_socketConnection.SocketConnection(socket));
+}
+void import_utilsBundle.program.parseAsync(process.argv);

package/lib/mcp/terminal/daemon.js

@@ -0,0 +1,114 @@
+"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 daemon_exports = {};
+__export(daemon_exports, {
+  startMcpDaemonServer: () => startMcpDaemonServer
+});
+module.exports = __toCommonJS(daemon_exports);
+var import_promises = __toESM(require("fs/promises"));
+var import_net = __toESM(require("net"));
+var import_os = __toESM(require("os"));
+var import_path = __toESM(require("path"));
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+var import_socketConnection = require("./socketConnection");
+const daemonDebug = (0, import_utilsBundle.debug)("pw:daemon");
+function normalizeSocketPath(path2) {
+  if (import_os.default.platform() === "win32") {
+    if (path2.startsWith("\\\\.\\pipe\\"))
+      return path2;
+    const name = path2.replace(/[^a-zA-Z0-9]/g, "-");
+    return `\\\\.\\pipe\\${name}`;
+  }
+  return path2;
+}
+async function socketExists(socketPath) {
+  try {
+    const stat = await import_promises.default.stat(socketPath);
+    if (stat?.isSocket())
+      return true;
+  } catch (e) {
+  }
+  return false;
+}
+async function startMcpDaemonServer(socketPath, serverBackendFactory) {
+  const normalizedPath = normalizeSocketPath(socketPath);
+  if (import_os.default.platform() !== "win32" && await socketExists(normalizedPath)) {
+    daemonDebug(`Socket already exists, removing: ${normalizedPath}`);
+    try {
+      await import_promises.default.unlink(normalizedPath);
+    } catch (error) {
+      daemonDebug(`Failed to remove existing socket: ${error}`);
+      throw error;
+    }
+  }
+  const backend = serverBackendFactory.create();
+  await backend.initialize?.({
+    name: "mcp-daemon",
+    version: "1.0.0",
+    roots: [],
+    timestamp: Date.now()
+  });
+  await import_promises.default.mkdir(import_path.default.dirname(normalizedPath), { recursive: true });
+  const server = import_net.default.createServer((socket) => {
+    daemonDebug("new client connection");
+    const connection = new import_socketConnection.SocketConnection(socket);
+    connection.onclose = () => {
+      daemonDebug("client disconnected");
+    };
+    connection.onmessage = async (message) => {
+      const { id, method, params } = message;
+      try {
+        daemonDebug("received command", method);
+        const response = await backend.callTool(method, params, () => {
+        });
+        daemonDebug("sending response", !!response);
+        if (response)
+          await connection.send({ id, result: response });
+      } catch (e) {
+        daemonDebug("command failed", e);
+        await connection.send({ id, error: e.message });
+        daemonDebug("error handling message", e);
+      }
+    };
+  });
+  return new Promise((resolve, reject) => {
+    server.on("error", (error) => {
+      daemonDebug(`server error: ${error.message}`);
+      reject(error);
+    });
+    server.listen(normalizedPath, () => {
+      daemonDebug(`daemon server listening on ${normalizedPath}`);
+      resolve(normalizedPath);
+    });
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  startMcpDaemonServer
+});

package/lib/mcp/terminal/socketConnection.js

@@ -0,0 +1,80 @@
+"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 socketConnection_exports = {};
+__export(socketConnection_exports, {
+  SocketConnection: () => SocketConnection
+});
+module.exports = __toCommonJS(socketConnection_exports);
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
+const daemonDebug = (0, import_utilsBundle.debug)("pw:daemon");
+class SocketConnection {
+  constructor(socket) {
+    this._pendingBuffers = [];
+    this._socket = socket;
+    socket.on("data", (buffer) => this._onData(buffer));
+    socket.on("close", () => {
+      this.onclose?.();
+    });
+    socket.on("error", (e) => daemonDebug(`error: ${e.message}`));
+  }
+  async send(message) {
+    await new Promise((resolve, reject) => {
+      this._socket.write(`${JSON.stringify(message)}
+`, (error) => {
+        if (error)
+          reject(error);
+        else
+          resolve(void 0);
+      });
+    });
+  }
+  close() {
+    this._socket.destroy();
+  }
+  _onData(buffer) {
+    let end = buffer.indexOf("\n");
+    if (end === -1) {
+      this._pendingBuffers.push(buffer);
+      return;
+    }
+    this._pendingBuffers.push(buffer.slice(0, end));
+    const message = Buffer.concat(this._pendingBuffers).toString();
+    this._dispatchMessage(message);
+    let start = end + 1;
+    end = buffer.indexOf("\n", start);
+    while (end !== -1) {
+      const message2 = buffer.toString(void 0, start, end);
+      this._dispatchMessage(message2);
+      start = end + 1;
+      end = buffer.indexOf("\n", start);
+    }
+    this._pendingBuffers = [buffer.slice(start)];
+  }
+  _dispatchMessage(message) {
+    try {
+      this.onmessage?.(JSON.parse(message));
+    } catch (e) {
+      daemonDebug("failed to dispatch message", e);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SocketConnection
+});