@cotestdev/mcp_playwright 0.0.58 → 0.0.59

package/lib/mcp/browser/config.js

@@ -169,8 +169,8 @@ function configFromCLIOptions(cliOptions) {
     executablePath: cliOptions.executablePath,
     headless: cliOptions.headless
   };
-  if (cliOptions.sandbox !== void 0)
-    launchOptions.chromiumSandbox = cliOptions.sandbox;
+  if (cliOptions.chromiumSandbox !== void 0)
+    launchOptions.chromiumSandbox = cliOptions.chromiumSandbox;
   if (cliOptions.proxyServer) {
     launchOptions.proxy = {
       server: cliOptions.proxyServer
@@ -270,7 +270,7 @@ function configFromEnv() {
   options.isolated = envToBoolean(process.env.PLAYWRIGHT_MCP_ISOLATED);
   if (process.env.PLAYWRIGHT_MCP_IMAGE_RESPONSES)
     options.imageResponses = enumParser("--image-responses", ["allow", "omit"], process.env.PLAYWRIGHT_MCP_IMAGE_RESPONSES);
-  options.sandbox = envToBoolean(process.env.PLAYWRIGHT_MCP_SANDBOX);
+  options.chromiumSandbox = envToBoolean(process.env.PLAYWRIGHT_MCP_CHROMIUM_SANDBOX);
   options.outputDir = envToString(process.env.PLAYWRIGHT_MCP_OUTPUT_DIR);
   options.port = numberParser(process.env.PLAYWRIGHT_MCP_PORT);
   options.proxyBypass = envToString(process.env.PLAYWRIGHT_MCP_PROXY_BYPASS);

package/lib/mcp/browser/context.js

@@ -236,8 +236,10 @@ class Context {
     const result = await this._browserContextFactory.createContext(this._clientInfo, this._abortController.signal, { toolName: this._runningToolName });
     const { browserContext } = result;
     if (!this.config.allowUnrestrictedFileAccess) {
-      browserContext._setAllowedProtocols(["http:", "https:", "about:", "data:"]);
-      browserContext._setAllowedDirectories(allRootPaths(this._clientInfo));
+      if (typeof browserContext._setAllowedProtocols === "function")
+        browserContext._setAllowedProtocols(["http:", "https:", "about:", "data:"]);
+      if (typeof browserContext._setAllowedDirectories === "function")
+        browserContext._setAllowedDirectories(allRootPaths(this._clientInfo));
     }
     await this._setupRequestInterception(browserContext);
     for (const page of browserContext.pages())

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

@@ -24,6 +24,7 @@ module.exports = __toCommonJS(common_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_tool = require("./tool");
 var import_response = require("../response");
+var import_schema = require("./schema");
 const close = (0, import_tool.defineTool)({
   capability: "core",
   schema: {
@@ -46,7 +47,7 @@ const resize = (0, import_tool.defineTabTool)({
     name: "browser_resize",
     title: "Resize browser window",
     description: "Resize the browser window",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       width: import_mcpBundle.z.number().describe("Width of the browser window"),
       height: import_mcpBundle.z.number().describe("Height of the browser window")
     }),

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

@@ -0,0 +1,42 @@
+"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 devtools_exports = {};
+__export(devtools_exports, {
+  default: () => devtools_default
+});
+module.exports = __toCommonJS(devtools_exports);
+var import_mcpBundle = require("../../../mcpBundle");
+var import_tool = require("./tool");
+const devtoolsConnect = (0, import_tool.defineTool)({
+  capability: "devtools",
+  skillOnly: true,
+  schema: {
+    name: "browser_devtools_start",
+    title: "Start browser DevTools",
+    description: "Start browser DevTools",
+    inputSchema: import_mcpBundle.z.object({}),
+    type: "action"
+  },
+  handle: async (context, params, response) => {
+    const browserContext = await context.ensureBrowserContext();
+    const { url } = await browserContext._devtoolsStart();
+    response.addTextResult("Server is listening on: " + url);
+  }
+});
+var devtools_default = [devtoolsConnect];

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

@@ -24,13 +24,14 @@ __export(dialogs_exports, {
 module.exports = __toCommonJS(dialogs_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_tool = require("./tool");
+var import_schema = require("./schema");
 const handleDialog = (0, import_tool.defineTabTool)({
   capability: "core",
   schema: {
     name: "browser_handle_dialog",
     title: "Handle a dialog",
     description: "Handle a dialog",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       accept: import_mcpBundle.z.boolean().describe("Whether to accept the dialog."),
       promptText: import_mcpBundle.z.string().optional().describe("The text of the prompt in case of a prompt dialog.")
     }),

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

@@ -24,7 +24,8 @@ module.exports = __toCommonJS(evaluate_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_utils = require("playwright-core/lib/utils");
 var import_tool = require("./tool");
-const evaluateSchema = import_mcpBundle.z.object({
+var import_schema = require("./schema");
+const evaluateSchema = import_schema.baseSchema.extend({
   function: import_mcpBundle.z.string().describe("() => { /* code */ } or (element) => { /* code */ } when element is provided"),
   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().optional().describe("Exact target element reference from the page snapshot")

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

@@ -24,13 +24,14 @@ __export(files_exports, {
 module.exports = __toCommonJS(files_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_tool = require("./tool");
+var import_schema = require("./schema");
 const uploadFile = (0, import_tool.defineTabTool)({
   capability: "core",
   schema: {
     name: "browser_file_upload",
     title: "Upload files",
     description: "Upload one or multiple files",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       paths: import_mcpBundle.z.array(import_mcpBundle.z.string()).optional().describe("The absolute paths to the files to upload. Can be single file or multiple files. If omitted, file chooser is cancelled.")
     }),
     type: "action"

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

@@ -24,13 +24,14 @@ module.exports = __toCommonJS(form_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_utils = require("playwright-core/lib/utils");
 var import_tool = require("./tool");
+var import_schema = require("./schema");
 const fillForm = (0, import_tool.defineTabTool)({
   capability: "core",
   schema: {
     name: "browser_fill_form",
     title: "Fill form",
     description: "Fill multiple form fields",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       fields: import_mcpBundle.z.array(import_mcpBundle.z.object({
         name: import_mcpBundle.z.string().describe("Human-readable field name"),
         type: import_mcpBundle.z.enum(["textbox", "checkbox", "radio", "combobox", "slider"]).describe("Type of the field"),

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

@@ -24,13 +24,14 @@ module.exports = __toCommonJS(keyboard_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_tool = require("./tool");
 var import_snapshot = require("./snapshot");
+var import_schema = require("./schema");
 const press = (0, import_tool.defineTabTool)({
   capability: "core-input",
   schema: {
     name: "browser_press_key",
     title: "Press a key",
     description: "Press a key on the keyboard",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       key: import_mcpBundle.z.string().describe("Name of the key to press or a character to generate, such as `ArrowLeft` or `a`")
     }),
     type: "input"
@@ -55,7 +56,7 @@ const pressSequentially = (0, import_tool.defineTabTool)({
     name: "browser_press_sequentially",
     title: "Type text key by key",
     description: "Type text key by key on the keyboard",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       text: import_mcpBundle.z.string().describe("Text to type"),
       submit: import_mcpBundle.z.boolean().optional().describe("Whether to submit entered text (press Enter after)")
     }),
@@ -115,7 +116,7 @@ const keydown = (0, import_tool.defineTabTool)({
     name: "browser_keydown",
     title: "Press a key down",
     description: "Press a key down on the keyboard",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       key: import_mcpBundle.z.string().describe("Name of the key to press or a character to generate, such as `ArrowLeft` or `a`")
     }),
     type: "input"
@@ -132,7 +133,7 @@ const keyup = (0, import_tool.defineTabTool)({
     name: "browser_keyup",
     title: "Press a key up",
     description: "Press a key up on the keyboard",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       key: import_mcpBundle.z.string().describe("Name of the key to press or a character to generate, such as `ArrowLeft` or `a`")
     }),
     type: "input"

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

@@ -23,13 +23,14 @@ __export(navigate_exports, {
 module.exports = __toCommonJS(navigate_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_tool = require("./tool");
+var import_schema = require("./schema");
 const navigate = (0, import_tool.defineTool)({
   capability: "core-navigation",
   schema: {
     name: "browser_navigate",
     title: "Navigate to a URL",
     description: "Navigate to a URL",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       url: import_mcpBundle.z.string().describe("The URL to navigate to")
     }),
     type: "action"
@@ -56,7 +57,7 @@ const goBack = (0, import_tool.defineTabTool)({
     name: "browser_navigate_back",
     title: "Go back",
     description: "Go back to the previous page in the history",
-    inputSchema: import_mcpBundle.z.object({}),
+    inputSchema: import_schema.baseSchema.extend({}),
     type: "action"
   },
   handle: async (tab, params, response) => {
@@ -72,7 +73,7 @@ const goForward = (0, import_tool.defineTabTool)({
     name: "browser_navigate_forward",
     title: "Go forward",
     description: "Go forward to the next page in the history",
-    inputSchema: import_mcpBundle.z.object({}),
+    inputSchema: import_schema.baseSchema.extend({}),
     type: "action"
   },
   handle: async (tab, params, response) => {
@@ -88,7 +89,7 @@ const reload = (0, import_tool.defineTabTool)({
     name: "browser_reload",
     title: "Reload the page",
     description: "Reload the current page",
-    inputSchema: import_mcpBundle.z.object({}),
+    inputSchema: import_schema.baseSchema.extend({}),
     type: "action"
   },
   handle: async (tab, params, response) => {

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

@@ -34,8 +34,10 @@ module.exports = __toCommonJS(runCode_exports);
 var import_vm = __toESM(require("vm"));
 var import_utils = require("playwright-core/lib/utils");
 var import_mcpBundle = require("../../../mcpBundle");
+var import_ai_runner_fake = require("@cotestdev/ai-runner-fake");
 var import_tool = require("./tool");
-const codeSchema = import_mcpBundle.z.object({
+var import_schema = require("./schema");
+const codeSchema = import_schema.baseSchema.extend({
   code: import_mcpBundle.z.string().describe(`A JavaScript 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(); }\``)
 });
 const runCode = (0, import_tool.defineTabTool)({
@@ -71,6 +73,33 @@ const runCode = (0, import_tool.defineTabTool)({
     });
   }
 });
+const scriptSchema = import_mcpBundle.z.object({
+  code: import_mcpBundle.z.string().describe(`A JavaScript 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.string(), import_mcpBundle.z.any()).optional().describe("Parameters to pass to the script."),
+  projectId: import_mcpBundle.z.string().describe("Project ID"),
+  testId: import_mcpBundle.z.string().describe("Test ID")
+});
+const runScript = (0, import_tool.defineTabTool)({
+  capability: "extra",
+  schema: {
+    name: "run_test_script",
+    title: "Run test script with runner",
+    description: "Run Playwright script",
+    inputSchema: scriptSchema,
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    response.setIncludeSnapshot();
+    const runner = import_ai_runner_fake.Runner.NewInstance(params.projectId, params.testId);
+    await runner.init(tab.page, tab.page.context(), params.params);
+    const result = await runner.runScript(params.testId, params.code);
+    const code = `// Returns the out parameters of the reusable test
+const result = await runner.reuseTest('${params.testId}');`;
+    response.addCode(code);
+    response.addTextResult(`Out Parameters: ${JSON.stringify(result)}`);
+  }
+});
 var runCode_default = [
-  runCode
+  runCode,
+  runScript
 ];

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

@@ -27,7 +27,8 @@ var import_utilsBundle = require("playwright-core/lib/utilsBundle");
 var import_utils2 = require("playwright-core/lib/utils");
 var import_mcpBundle = require("../../../mcpBundle");
 var import_tool = require("./tool");
-const screenshotSchema = import_mcpBundle.z.object({
+var import_schema = require("./schema");
+const screenshotSchema = import_schema.baseSchema.extend({
   type: import_mcpBundle.z.enum(["png", "jpeg"]).default("png").describe("Image format for the screenshot. Default is png."),
   filename: import_mcpBundle.z.string().optional().describe("File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified. Prefer relative file names to stay within the output directory."),
   element: import_mcpBundle.z.string().optional().describe("Human-readable element description used to obtain permission to screenshot the element. If not provided, the screenshot will be taken of viewport. If element is provided, ref must be provided too."),

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

@@ -25,6 +25,7 @@ module.exports = __toCommonJS(snapshot_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_utils = require("playwright-core/lib/utils");
 var import_tool = require("./tool");
+var import_schema = require("./schema");
 const snapshot = (0, import_tool.defineTool)({
   capability: "core",
   schema: {
@@ -41,7 +42,7 @@ const snapshot = (0, import_tool.defineTool)({
     response.setIncludeFullSnapshot(params.filename);
   }
 });
-const elementSchema = import_mcpBundle.z.object({
+const elementSchema = import_schema.baseSchema.extend({
   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")
 });
@@ -86,7 +87,7 @@ const drag = (0, import_tool.defineTabTool)({
     name: "browser_drag",
     title: "Drag mouse",
     description: "Perform drag and drop between two elements",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       startElement: import_mcpBundle.z.string().describe("Human-readable source element description used to obtain the permission to interact with the element"),
       startRef: import_mcpBundle.z.string().describe("Exact source element reference from the page snapshot"),
       endElement: import_mcpBundle.z.string().describe("Human-readable target element description used to obtain the permission to interact with the element"),

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

@@ -24,13 +24,14 @@ module.exports = __toCommonJS(tabs_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_tool = require("./tool");
 var import_response = require("../response");
+var import_schema = require("./schema");
 const browserTabs = (0, import_tool.defineTool)({
   capability: "core-tabs",
   schema: {
     name: "browser_tabs",
     title: "Manage tabs",
     description: "List, create, close, or select a browser tab.",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       action: import_mcpBundle.z.enum(["list", "new", "close", "select"]).describe("Operation to perform"),
       index: import_mcpBundle.z.number().optional().describe("Tab index, used for close/select. If omitted for close, current tab is closed.")
     }),

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

@@ -24,13 +24,14 @@ module.exports = __toCommonJS(verify_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_utils = require("playwright-core/lib/utils");
 var import_tool = require("./tool");
+var import_schema = require("./schema");
 const verifyElement = (0, import_tool.defineTabTool)({
   capability: "testing",
   schema: {
     name: "browser_verify_element_visible",
     title: "Verify element visible",
     description: "Verify element is visible on the page",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       role: import_mcpBundle.z.string().describe('ROLE of the element. Can be found in the snapshot like this: `- {ROLE} "Accessible Name":`'),
       accessibleName: import_mcpBundle.z.string().describe('ACCESSIBLE_NAME of the element. Can be found in the snapshot like this: `- role "{ACCESSIBLE_NAME}"`')
     }),
@@ -52,7 +53,7 @@ const verifyText = (0, import_tool.defineTabTool)({
     name: "browser_verify_text_visible",
     title: "Verify text visible",
     description: `Verify text is visible on the page. Prefer ${verifyElement.schema.name} if possible.`,
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       text: import_mcpBundle.z.string().describe('TEXT to verify. Can be found in the snapshot like this: `- role "Accessible Name": {TEXT}` or like this: `- text: {TEXT}`')
     }),
     type: "assertion"
@@ -73,7 +74,7 @@ const verifyList = (0, import_tool.defineTabTool)({
     name: "browser_verify_list_visible",
     title: "Verify list visible",
     description: "Verify list is visible on the page",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       element: import_mcpBundle.z.string().describe("Human-readable list description"),
       ref: import_mcpBundle.z.string().describe("Exact target element reference that points to the list"),
       items: import_mcpBundle.z.array(import_mcpBundle.z.string()).describe("Items to verify")
@@ -105,7 +106,7 @@ const verifyValue = (0, import_tool.defineTabTool)({
     name: "browser_verify_value",
     title: "Verify value",
     description: "Verify element value",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       type: import_mcpBundle.z.enum(["textbox", "checkbox", "radio", "combobox", "slider"]).describe("Type of the element"),
       element: import_mcpBundle.z.string().describe("Human-readable element description"),
       ref: import_mcpBundle.z.string().describe("Exact target element reference that points to the element"),

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

@@ -23,13 +23,14 @@ __export(wait_exports, {
 module.exports = __toCommonJS(wait_exports);
 var import_mcpBundle = require("../../../mcpBundle");
 var import_tool = require("./tool");
+var import_schema = require("./schema");
 const wait = (0, import_tool.defineTool)({
   capability: "core",
   schema: {
     name: "browser_wait_for",
     title: "Wait for",
     description: "Wait for text to appear or disappear or a specified time to pass",
-    inputSchema: import_mcpBundle.z.object({
+    inputSchema: import_schema.baseSchema.extend({
       time: import_mcpBundle.z.number().optional().describe("The time to wait in seconds"),
       text: import_mcpBundle.z.string().optional().describe("The text to wait for"),
       textGone: import_mcpBundle.z.string().optional().describe("The text to wait for to disappear")

package/lib/mcp/browser/tools.js

@@ -36,6 +36,7 @@ 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_devtools = __toESM(require("./tools/devtools"));
 var import_dialogs = __toESM(require("./tools/dialogs"));
 var import_evaluate = __toESM(require("./tools/evaluate"));
 var import_files = __toESM(require("./tools/files"));
@@ -62,6 +63,7 @@ const browserTools = [
   ...import_config.default,
   ...import_console.default,
   ...import_cookies.default,
+  ...import_devtools.default,
   ...import_dialogs.default,
   ...import_evaluate.default,
   ...import_files.default,

package/lib/mcp/extension/extensionContextFactory.js

@@ -37,11 +37,10 @@ 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, forceNewTab) {
+  constructor(browserChannel, userDataDir, executablePath) {
     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);
@@ -55,7 +54,7 @@ class ExtensionContextFactory {
   }
   async _obtainBrowser(clientInfo, abortSignal, toolName) {
     const relay = await this._startRelay(abortSignal);
-    const forceNewTab = this._forceNewTab || toolName === "browser_navigate";
+    const forceNewTab = toolName === "browser_navigate";
     await relay.ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, forceNewTab);
     return await playwright.chromium.connectOverCDP(relay.cdpEndpoint(), { isLocal: true });
   }

package/lib/mcp/program.js

@@ -42,8 +42,8 @@ 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("--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;
+  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("--chromium-sandbox", "enable the chromium sandbox. disable with --no-chromium-sandbox.").option("--no-chromium-sandbox", "disable the chromium sandbox.").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("--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("--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.chromiumSandbox = options.chromiumSandbox === true ? void 0 : false;
     (0, import_watchdog.setupExitWatchdog)();
     if (options.vision) {
       console.error("The --vision option is deprecated, use --caps=vision instead");
@@ -63,8 +63,7 @@ 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 forceNewTab = !!config.sessionConfig;
-    const extensionContextFactory = new import_extensionContextFactory.ExtensionContextFactory(config.browser.launchOptions.channel || "chrome", config.browser.userDataDir, config.browser.launchOptions.executablePath, forceNewTab);
+    const extensionContextFactory = new import_extensionContextFactory.ExtensionContextFactory(config.browser.launchOptions.channel || "chrome", config.browser.userDataDir, config.browser.launchOptions.executablePath);
     if (config.sessionConfig) {
       const contextFactory2 = config.extension ? extensionContextFactory : browserContextFactory;
       try {

package/lib/mcp/sdk/tool.js

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

package/lib/mcp/terminal/cli.js

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

package/lib/mcp/terminal/commands.js

@@ -49,7 +49,7 @@ const open = (0, import_command.declareCommand)({
     persistent: import_mcpBundle.z.boolean().optional().describe("Use persistent browser profile"),
     profile: import_mcpBundle.z.string().optional().describe("Use persistent browser profile, store profile in specified directory.")
   }),
-  toolName: "browser_navigate",
+  toolName: ({ url }) => url ? "browser_navigate" : "browser_snapshot",
   toolParams: ({ url }) => ({ url: url || "about:blank" })
 });
 const close = (0, import_command.declareCommand)({
@@ -681,6 +681,22 @@ const videoStop = (0, import_command.declareCommand)({
   toolName: "browser_stop_video",
   toolParams: ({ filename }) => ({ filename })
 });
+const devtoolsShow = (0, import_command.declareCommand)({
+  name: "show",
+  description: "Show browser DevTools",
+  category: "devtools",
+  args: import_mcpBundle.z.object({}),
+  toolName: "",
+  toolParams: () => ({})
+});
+const devtoolsStart = (0, import_command.declareCommand)({
+  name: "devtools-start",
+  description: "Show browser DevTools",
+  category: "devtools",
+  args: import_mcpBundle.z.object({}),
+  toolName: "browser_devtools_start",
+  toolParams: () => ({})
+});
 const sessionList = (0, import_command.declareCommand)({
   name: "list",
   description: "List browser sessions",
@@ -742,6 +758,14 @@ const installBrowser = (0, import_command.declareCommand)({
   toolName: "browser_install",
   toolParams: () => ({})
 });
+const tray = (0, import_command.declareCommand)({
+  name: "tray",
+  description: "Run tray",
+  category: "config",
+  hidden: true,
+  toolName: "",
+  toolParams: () => ({})
+});
 const commandsArray = [
   // core category
   open,
@@ -819,10 +843,14 @@ const commandsArray = [
   tracingStop,
   videoStart,
   videoStop,
+  devtoolsShow,
+  devtoolsStart,
   // session category
   sessionList,
   sessionCloseAll,
-  killAll
+  killAll,
+  // Hidden commands
+  tray
 ];
 const commands = Object.fromEntries(commandsArray.map((cmd) => [cmd.name, cmd]));
 // Annotate the CommonJS export names for ESM import in node: