@cotestdev/mcp_playwright 0.0.50 → 0.0.52

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

@@ -0,0 +1,223 @@
+"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 webstorage_exports = {};
+__export(webstorage_exports, {
+  default: () => webstorage_default
+});
+module.exports = __toCommonJS(webstorage_exports);
+var import_mcpBundle = require("../../../mcpBundle");
+var import_tool = require("./tool");
+const localStorageList = (0, import_tool.defineTabTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_localstorage_list",
+    title: "List localStorage",
+    description: "List all localStorage key-value pairs",
+    inputSchema: import_mcpBundle.z.object({}),
+    type: "readOnly"
+  },
+  handle: async (tab, params, response) => {
+    const items = await tab.page.evaluate(() => {
+      const result = [];
+      for (let i = 0; i < localStorage.length; i++) {
+        const key = localStorage.key(i);
+        if (key !== null)
+          result.push({ key, value: localStorage.getItem(key) || "" });
+      }
+      return result;
+    });
+    if (items.length === 0)
+      response.addTextResult("No localStorage items found");
+    else
+      response.addTextResult(items.map((item) => `${item.key}=${item.value}`).join("\n"));
+    response.addCode(`await page.evaluate(() => ({ ...localStorage }));`);
+  }
+});
+const localStorageGet = (0, import_tool.defineTabTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_localstorage_get",
+    title: "Get localStorage item",
+    description: "Get a localStorage item by key",
+    inputSchema: import_mcpBundle.z.object({
+      key: import_mcpBundle.z.string().describe("Key to get")
+    }),
+    type: "readOnly"
+  },
+  handle: async (tab, params, response) => {
+    const value = await tab.page.evaluate((key) => localStorage.getItem(key), params.key);
+    if (value === null)
+      response.addTextResult(`localStorage key '${params.key}' not found`);
+    else
+      response.addTextResult(`${params.key}=${value}`);
+    response.addCode(`await page.evaluate(() => localStorage.getItem('${params.key}'));`);
+  }
+});
+const localStorageSet = (0, import_tool.defineTabTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_localstorage_set",
+    title: "Set localStorage item",
+    description: "Set a localStorage item",
+    inputSchema: import_mcpBundle.z.object({
+      key: import_mcpBundle.z.string().describe("Key to set"),
+      value: import_mcpBundle.z.string().describe("Value to set")
+    }),
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    await tab.page.evaluate(({ key, value }) => localStorage.setItem(key, value), params);
+    response.addCode(`await page.evaluate(() => localStorage.setItem('${params.key}', '${params.value}'));`);
+  }
+});
+const localStorageDelete = (0, import_tool.defineTabTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_localstorage_delete",
+    title: "Delete localStorage item",
+    description: "Delete a localStorage item",
+    inputSchema: import_mcpBundle.z.object({
+      key: import_mcpBundle.z.string().describe("Key to delete")
+    }),
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    await tab.page.evaluate((key) => localStorage.removeItem(key), params.key);
+    response.addCode(`await page.evaluate(() => localStorage.removeItem('${params.key}'));`);
+  }
+});
+const localStorageClear = (0, import_tool.defineTabTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_localstorage_clear",
+    title: "Clear localStorage",
+    description: "Clear all localStorage",
+    inputSchema: import_mcpBundle.z.object({}),
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    await tab.page.evaluate(() => localStorage.clear());
+    response.addCode(`await page.evaluate(() => localStorage.clear());`);
+  }
+});
+const sessionStorageList = (0, import_tool.defineTabTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_sessionstorage_list",
+    title: "List sessionStorage",
+    description: "List all sessionStorage key-value pairs",
+    inputSchema: import_mcpBundle.z.object({}),
+    type: "readOnly"
+  },
+  handle: async (tab, params, response) => {
+    const items = await tab.page.evaluate(() => {
+      const result = [];
+      for (let i = 0; i < sessionStorage.length; i++) {
+        const key = sessionStorage.key(i);
+        if (key !== null)
+          result.push({ key, value: sessionStorage.getItem(key) || "" });
+      }
+      return result;
+    });
+    if (items.length === 0)
+      response.addTextResult("No sessionStorage items found");
+    else
+      response.addTextResult(items.map((item) => `${item.key}=${item.value}`).join("\n"));
+    response.addCode(`await page.evaluate(() => ({ ...sessionStorage }));`);
+  }
+});
+const sessionStorageGet = (0, import_tool.defineTabTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_sessionstorage_get",
+    title: "Get sessionStorage item",
+    description: "Get a sessionStorage item by key",
+    inputSchema: import_mcpBundle.z.object({
+      key: import_mcpBundle.z.string().describe("Key to get")
+    }),
+    type: "readOnly"
+  },
+  handle: async (tab, params, response) => {
+    const value = await tab.page.evaluate((key) => sessionStorage.getItem(key), params.key);
+    if (value === null)
+      response.addTextResult(`sessionStorage key '${params.key}' not found`);
+    else
+      response.addTextResult(`${params.key}=${value}`);
+    response.addCode(`await page.evaluate(() => sessionStorage.getItem('${params.key}'));`);
+  }
+});
+const sessionStorageSet = (0, import_tool.defineTabTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_sessionstorage_set",
+    title: "Set sessionStorage item",
+    description: "Set a sessionStorage item",
+    inputSchema: import_mcpBundle.z.object({
+      key: import_mcpBundle.z.string().describe("Key to set"),
+      value: import_mcpBundle.z.string().describe("Value to set")
+    }),
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    await tab.page.evaluate(({ key, value }) => sessionStorage.setItem(key, value), params);
+    response.addCode(`await page.evaluate(() => sessionStorage.setItem('${params.key}', '${params.value}'));`);
+  }
+});
+const sessionStorageDelete = (0, import_tool.defineTabTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_sessionstorage_delete",
+    title: "Delete sessionStorage item",
+    description: "Delete a sessionStorage item",
+    inputSchema: import_mcpBundle.z.object({
+      key: import_mcpBundle.z.string().describe("Key to delete")
+    }),
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    await tab.page.evaluate((key) => sessionStorage.removeItem(key), params.key);
+    response.addCode(`await page.evaluate(() => sessionStorage.removeItem('${params.key}'));`);
+  }
+});
+const sessionStorageClear = (0, import_tool.defineTabTool)({
+  capability: "storage",
+  schema: {
+    name: "browser_sessionstorage_clear",
+    title: "Clear sessionStorage",
+    description: "Clear all sessionStorage",
+    inputSchema: import_mcpBundle.z.object({}),
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    await tab.page.evaluate(() => sessionStorage.clear());
+    response.addCode(`await page.evaluate(() => sessionStorage.clear());`);
+  }
+});
+var webstorage_default = [
+  localStorageList,
+  localStorageGet,
+  localStorageSet,
+  localStorageDelete,
+  localStorageClear,
+  sessionStorageList,
+  sessionStorageGet,
+  sessionStorageSet,
+  sessionStorageDelete,
+  sessionStorageClear
+];

package/lib/mcp/browser/tools.js

@@ -33,7 +33,9 @@ __export(tools_exports, {
 });
 module.exports = __toCommonJS(tools_exports);
 var import_common = __toESM(require("./tools/common"));
+var import_config = __toESM(require("./tools/config"));
 var import_console = __toESM(require("./tools/console"));
+var import_cookies = __toESM(require("./tools/cookies"));
 var import_dialogs = __toESM(require("./tools/dialogs"));
 var import_evaluate = __toESM(require("./tools/evaluate"));
 var import_files = __toESM(require("./tools/files"));
@@ -44,6 +46,7 @@ var import_mouse = __toESM(require("./tools/mouse"));
 var import_navigate = __toESM(require("./tools/navigate"));
 var import_network = __toESM(require("./tools/network"));
 var import_pdf = __toESM(require("./tools/pdf"));
+var import_route = __toESM(require("./tools/route"));
 var import_runCode = __toESM(require("./tools/runCode"));
 var import_snapshot = __toESM(require("./tools/snapshot"));
 var import_screenshot = __toESM(require("./tools/screenshot"));
@@ -53,9 +56,12 @@ var import_tracing = __toESM(require("./tools/tracing"));
 var import_verify = __toESM(require("./tools/verify"));
 var import_video = __toESM(require("./tools/video"));
 var import_wait = __toESM(require("./tools/wait"));
+var import_webstorage = __toESM(require("./tools/webstorage"));
 const browserTools = [
   ...import_common.default,
+  ...import_config.default,
   ...import_console.default,
+  ...import_cookies.default,
   ...import_dialogs.default,
   ...import_evaluate.default,
   ...import_files.default,
@@ -66,6 +72,7 @@ const browserTools = [
   ...import_navigate.default,
   ...import_network.default,
   ...import_pdf.default,
+  ...import_route.default,
   ...import_runCode.default,
   ...import_screenshot.default,
   ...import_snapshot.default,
@@ -74,10 +81,11 @@ const browserTools = [
   ...import_tracing.default,
   ...import_verify.default,
   ...import_video.default,
-  ...import_wait.default
+  ...import_wait.default,
+  ...import_webstorage.default
 ];
-function filteredTools(config) {
-  return browserTools.filter((tool) => tool.capability.startsWith("core") || config.capabilities?.includes(tool.capability)).filter((tool) => !tool.skillOnly);
+function filteredTools(config2) {
+  return browserTools.filter((tool) => tool.capability.startsWith("core") || config2.capabilities?.includes(tool.capability)).filter((tool) => !tool.skillOnly);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/mcp/extension/cdpRelay.js

@@ -62,22 +62,22 @@ class CDPRelayServer {
   extensionEndpoint() {
     return `${this._wsHost}${this._extensionPath}`;
   }
-  async ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, toolName) {
+  async ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, forceNewTab) {
     debugLogger("Ensuring extension connection for MCP context");
     if (this._extensionConnection)
       return;
-    this._connectBrowser(clientInfo, toolName);
+    this._connectBrowser(clientInfo, forceNewTab);
     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.`));
+        reject(new Error(`Extension connection timeout. Make sure the "Playwright MCP Bridge" extension is installed. See https://github.com/microsoft/playwright-mcp/blob/main/packages/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) {
+  _connectBrowser(clientInfo, forceNewTab) {
     const mcpRelayEndpoint = `${this._wsHost}${this._extensionPath}`;
     const url = new URL("chrome-extension://jakfalbnbhgkpmoaakfflhflbfpkailf/connect.html");
     url.searchParams.set("mcpRelayUrl", mcpRelayEndpoint);
@@ -87,8 +87,8 @@ class CDPRelayServer {
     };
     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"));
+    if (forceNewTab)
+      url.searchParams.set("newTab", "true");
     const token = process.env.PLAYWRIGHT_MCP_EXTENSION_TOKEN;
     if (token)
       url.searchParams.set("token", token);
@@ -98,7 +98,7 @@ class CDPRelayServer {
       const executableInfo = import_registry.registry.findExecutable(this._browserChannel);
       if (!executableInfo)
         throw new Error(`Unsupported channel: "${this._browserChannel}"`);
-      executablePath = executableInfo.executablePath("javascript");
+      executablePath = executableInfo.executablePath();
       if (!executablePath)
         throw new Error(`"${this._browserChannel}" executable not found. Make sure it is installed at a standard location.`);
     }

package/lib/mcp/extension/extensionContextFactory.js

@@ -37,10 +37,11 @@ var import_utils = require("playwright-core/lib/utils");
 var import_cdpRelay = require("./cdpRelay");
 const debugLogger = (0, import_utilsBundle.debug)("pw:mcp:relay");
 class ExtensionContextFactory {
-  constructor(browserChannel, userDataDir, executablePath) {
+  constructor(browserChannel, userDataDir, executablePath, forceNewTab) {
     this._browserChannel = browserChannel;
     this._userDataDir = userDataDir;
     this._executablePath = executablePath;
+    this._forceNewTab = forceNewTab;
   }
   async createContext(clientInfo, abortSignal, options) {
     const browser = await this._obtainBrowser(clientInfo, abortSignal, options?.toolName);
@@ -54,7 +55,8 @@ class ExtensionContextFactory {
   }
   async _obtainBrowser(clientInfo, abortSignal, toolName) {
     const relay = await this._startRelay(abortSignal);
-    await relay.ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, toolName);
+    const forceNewTab = this._forceNewTab || toolName === "browser_navigate";
+    await relay.ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, forceNewTab);
     return await playwright.chromium.connectOverCDP(relay.cdpEndpoint(), { isLocal: true });
   }
   async _startRelay(abortSignal) {

package/lib/mcp/program.js

@@ -42,7 +42,7 @@ 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, devtools.", 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("--codegen <lang>", 'specify the language to use for code generation, possible values: "typescript", "none". Default is "typescript".', import_config.enumParser.bind(null, "--codegen", ["none", "typescript"])).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("--output-mode <mode>", 'whether to save snapshots, console messages, network logs to a file or to the standard output. Can be "file" or "stdout". Default is "stdout".', import_config.enumParser.bind(null, "--output-mode", ["file", "stdout"])).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("--sandbox", "enable the sandbox for all process types that are normally not sandboxed.").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()).addOption(new import_utilsBundle.ProgramOption("--daemon-data-dir <path>", "path to the daemon data directory.").hideHelp()).addOption(new import_utilsBundle.ProgramOption("--daemon-headed", "run daemon in headed mode").hideHelp()).addOption(new import_utilsBundle.ProgramOption("--daemon-version <version>", "version of this daemon").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, devtools.", 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("--cdp-timeout <timeout>", "timeout in milliseconds for connecting to CDP endpoint, defaults to 30000ms", import_config.numberParser).option("--codegen <lang>", 'specify the language to use for code generation, possible values: "typescript", "none". Default is "typescript".', import_config.enumParser.bind(null, "--codegen", ["none", "typescript"])).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("--output-mode <mode>", 'whether to save snapshots, console messages, network logs to a file or to the standard output. Can be "file" or "stdout". Default is "stdout".', import_config.enumParser.bind(null, "--output-mode", ["file", "stdout"])).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("--sandbox", "enable the sandbox for all process types that are normally not sandboxed.").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-session <path>", "path to the daemon config.").hideHelp()).action(async (options) => {
     options.sandbox = options.sandbox === true ? void 0 : false;
     (0, import_watchdog.setupExitWatchdog)();
     if (options.vision) {
@@ -63,17 +63,24 @@ Please run the command below. It will install a local copy of ffmpeg and will no
       process.exit(1);
     }
     const browserContextFactory = (0, import_browserContextFactory.contextFactory)(config);
-    const extensionContextFactory = new import_extensionContextFactory.ExtensionContextFactory(config.browser.launchOptions.channel || "chrome", config.browser.userDataDir, config.browser.launchOptions.executablePath);
-    if (options.daemon) {
+    const forceNewTab = !!config.sessionConfig;
+    const extensionContextFactory = new import_extensionContextFactory.ExtensionContextFactory(config.browser.launchOptions.channel || "chrome", config.browser.userDataDir, config.browser.launchOptions.executablePath, forceNewTab);
+    if (config.sessionConfig) {
       const contextFactory2 = config.extension ? extensionContextFactory : browserContextFactory;
-      const serverBackendFactory = {
-        name: "Playwright",
-        nameInConfig: "playwright-daemon",
-        version,
-        create: () => new import_browserServerBackend.BrowserServerBackend(config, contextFactory2, { allTools: true })
-      };
-      const socketPath = await (0, import_daemon.startMcpDaemonServer)(options.daemon, serverBackendFactory, options.daemonVersion);
-      console.error(`Daemon server listening on ${socketPath}`);
+      console.log(`### Config`);
+      console.log("```json");
+      console.log(JSON.stringify(config, null, 2));
+      console.log("```");
+      try {
+        const socketPath = await (0, import_daemon.startMcpDaemonServer)(config, contextFactory2);
+        console.log(`### Success
+Daemon listening on ${socketPath}`);
+        console.log("<EOF>");
+      } catch (error) {
+        console.log(`### Error
+${error.message}`);
+        console.log("<EOF>");
+      }
       return;
     }
     if (config.extension) {
@@ -98,7 +105,7 @@ Please run the command below. It will install a local copy of ffmpeg and will no
 function checkFfmpeg() {
   try {
     const executable = import_server.registry.findExecutable("ffmpeg");
-    return import_fs.default.existsSync(executable.executablePath("javascript"));
+    return import_fs.default.existsSync(executable.executablePath());
   } catch (error) {
     return false;
   }

package/lib/mcp/terminal/cli.js

@@ -1,7 +1,28 @@
 "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_program = require("./program");
-const packageJSON = require("../../../package.json");
-(0, import_program.program)({ version: packageJSON.version }).catch((e) => {
+(0, import_program.program)(require.resolve("../../../package.json")).catch((e) => {
   console.error(e.message);
   process.exit(1);
 });

package/lib/mcp/terminal/command.js

@@ -1,9 +1,7 @@
 "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)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   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 command_exports = {};
 __export(command_exports, {
@@ -32,35 +22,49 @@ __export(command_exports, {
   parseCommand: () => parseCommand
 });
 module.exports = __toCommonJS(command_exports);
-var import_path = __toESM(require("path"));
+var import_mcpBundle = require("../../mcpBundle");
 function declareCommand(command) {
   return command;
 }
+const kEmptyOptions = import_mcpBundle.z.object({});
+const kEmptyArgs = import_mcpBundle.z.object({});
 function parseCommand(command, args) {
-  if (args.filename)
-    args.filename = import_path.default.resolve(args.outputDir, args.filename);
-  const shape = command.args ? command.args.shape : {};
-  const argv = args["_"];
-  const options = command.options?.parse({ ...args, _: void 0 }) ?? {};
+  const optionsObject = { ...args };
+  delete optionsObject["_"];
+  const optionsSchema = (command.options ?? kEmptyOptions).strict();
+  const options = zodParse(optionsSchema, optionsObject, "option");
+  const argsSchema = (command.args ?? kEmptyArgs).strict();
+  const argNames = [...Object.keys(argsSchema.shape)];
+  const argv = args["_"].slice(1);
+  if (argv.length > argNames.length)
+    throw new Error(`error: too many arguments: expected ${argNames.length}, received ${argv.length}`);
   const argsObject = {};
-  let i = 0;
-  for (const name of Object.keys(shape))
-    argsObject[name] = argv[++i];
-  let parsedArgsObject = {};
-  try {
-    parsedArgsObject = command.args?.parse(argsObject) ?? {};
-  } catch (e) {
-    throw new Error(formatZodError(e));
-  }
+  argNames.forEach((name, index) => argsObject[name] = argv[index]);
+  const parsedArgsObject = zodParse(argsSchema, argsObject, "argument");
   const toolName = typeof command.toolName === "function" ? command.toolName({ ...parsedArgsObject, ...options }) : command.toolName;
   const toolParams = command.toolParams({ ...parsedArgsObject, ...options });
   return { toolName, toolParams };
 }
-function formatZodError(error) {
-  const issue = error.issues[0];
-  if (issue.code === "invalid_type")
-    return `${issue.message} in <${issue.path.join(".")}>`;
-  return error.issues.map((i) => i.message).join("\n");
+function zodParse(schema, data, type) {
+  try {
+    return schema.parse(data);
+  } catch (e) {
+    throw new Error(e.issues.map((issue) => {
+      const keys = issue.keys || [""];
+      const props = keys.map((key) => [...issue.path, key].filter(Boolean).join("."));
+      return props.map((prop) => {
+        const label = type === "option" ? `'--${prop}' option` : `'${prop}' argument`;
+        switch (issue.code) {
+          case "invalid_type":
+            return "error: " + label + ": " + issue.message.toLowerCase().replace(/invalid input:/, "").trim();
+          case "unrecognized_keys":
+            return "error: unknown " + label;
+          default:
+            return "error: " + label + ": " + issue.message.toLowerCase();
+        }
+      });
+    }).flat().join("\n"));
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {