@cotestdev/mcp_playwright 0.0.14 → 0.0.15

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

@@ -21,9 +21,9 @@ __export(tabs_exports, {
   default: () => tabs_default
 });
 module.exports = __toCommonJS(tabs_exports);
-var import_bundle = require("../../sdk/bundle");
-var import_common = require("./common");
+var import_mcpBundle = require("playwright-core/lib/mcpBundle");
 var import_tool = require("./tool");
+var import_common = require("./common");
 const browserTabs = (0, import_tool.defineTool)({
   capability: "core-tabs",
   schema: {
@@ -31,10 +31,10 @@ const browserTabs = (0, import_tool.defineTool)({
     title: "Manage tabs",
     description: "List, create, close, or select a browser tab.",
     inputSchema: import_common.baseSchema.extend({
-      action: import_bundle.z.enum(["list", "new", "close", "select"]).describe("Operation to perform"),
-      index: import_bundle.z.number().optional().describe("Tab index, used for close/select. If omitted for close, current tab is closed.")
+      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.")
     }),
-    type: "destructive"
+    type: "action"
   },
   handle: async (context, params, response) => {
     switch (params.action) {
@@ -44,23 +44,20 @@ const browserTabs = (0, import_tool.defineTool)({
         return;
       }
       case "new": {
-        response.addCode(`page = await context.newPage();`);
         await context.newTab();
         response.setIncludeTabs();
         return;
       }
       case "close": {
-        response.addCode(`await page.close();`);
         await context.closeTab(params.index);
-        response.setIncludeSnapshot();
+        response.setIncludeFullSnapshot();
         return;
       }
       case "select": {
         if (params.index === void 0)
           throw new Error("Tab index is required");
-        response.addCode(`page = pages[${params.index}];`);
         await context.selectTab(params.index);
-        response.setIncludeSnapshot();
+        response.setIncludeFullSnapshot();
         return;
       }
     }

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

@@ -31,14 +31,15 @@ function defineTabTool(tool) {
     handle: async (context, params, response) => {
       const tab = await context.ensureTab();
       const modalStates = tab.modalStates().map((state) => state.type);
-      if (tool.clearsModalState && !modalStates.includes(tool.clearsModalState))
-        response.addError(`Error: The tool "${tool.schema.name}" can only be used when there is related modal state present.
-` + tab.modalStatesMarkdown().join("\n"));
-      else if (!tool.clearsModalState && modalStates.length)
-        response.addError(`Error: Tool "${tool.schema.name}" does not handle the modal state.
-` + tab.modalStatesMarkdown().join("\n"));
-      else
+      if (tool.clearsModalState && !modalStates.includes(tool.clearsModalState)) {
+        response.setIncludeModalStates(tab.modalStates());
+        response.addError(`Error: The tool "${tool.schema.name}" can only be used when there is related modal state present.`);
+      } else if (!tool.clearsModalState && modalStates.length) {
+        response.setIncludeModalStates(tab.modalStates());
+        response.addError(`Error: Tool "${tool.schema.name}" does not handle the modal state.`);
+      } else {
         return tool.handle(tab, params, response);
+      }
     }
   };
 }

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

@@ -21,7 +21,7 @@ __export(tracing_exports, {
   default: () => tracing_default
 });
 module.exports = __toCommonJS(tracing_exports);
-var import_bundle = require("../../sdk/bundle");
+var import_mcpBundle = require("playwright-core/lib/mcpBundle");
 var import_tool = require("./tool");
 const tracingStart = (0, import_tool.defineTool)({
   capability: "tracing",
@@ -29,12 +29,12 @@ const tracingStart = (0, import_tool.defineTool)({
     name: "browser_start_tracing",
     title: "Start tracing",
     description: "Start trace recording",
-    inputSchema: import_bundle.z.object({}),
+    inputSchema: import_mcpBundle.z.object({}),
     type: "readOnly"
   },
   handle: async (context, params, response) => {
     const browserContext = await context.ensureBrowserContext();
-    const tracesDir = await context.outputFile(`traces`, { origin: "code" });
+    const tracesDir = await context.outputFile(`traces`, { origin: "code", reason: "Collecting trace" });
     const name = "trace-" + Date.now();
     await browserContext.tracing.start({
       name,
@@ -56,7 +56,7 @@ const tracingStop = (0, import_tool.defineTool)({
     name: "browser_stop_tracing",
     title: "Stop tracing",
     description: "Stop trace recording",
-    inputSchema: import_bundle.z.object({}),
+    inputSchema: import_mcpBundle.z.object({}),
     type: "readOnly"
   },
   handle: async (context, params, response) => {

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

@@ -20,77 +20,75 @@ var utils_exports = {};
 __export(utils_exports, {
   callOnPageNoTrace: () => callOnPageNoTrace,
   dateAsFileName: () => dateAsFileName,
-  generateLocator: () => generateLocator,
+  eventWaiter: () => eventWaiter,
   waitForCompletion: () => waitForCompletion
 });
 module.exports = __toCommonJS(utils_exports);
-var import_utils = require("playwright-core/lib/utils");
 async function waitForCompletion(tab, callback) {
-  const requests = /* @__PURE__ */ new Set();
-  let frameNavigated = false;
-  let waitCallback = () => {
-  };
-  const waitBarrier = new Promise((f) => {
-    waitCallback = f;
-  });
-  const requestListener = (request) => requests.add(request);
-  const requestFinishedListener = (request) => {
-    requests.delete(request);
-    if (!requests.size)
-      waitCallback();
-  };
-  const frameNavigateListener = (frame) => {
-    if (frame.parentFrame())
-      return;
-    frameNavigated = true;
-    dispose();
-    clearTimeout(timeout);
-    void tab.waitForLoadState("load").then(waitCallback);
-  };
-  const onTimeout = () => {
-    dispose();
-    waitCallback();
-  };
-  tab.page.on("request", requestListener);
-  tab.page.on("requestfinished", requestFinishedListener);
-  tab.page.on("framenavigated", frameNavigateListener);
-  const timeout = setTimeout(onTimeout, 1e4);
-  const dispose = () => {
+  const requests = [];
+  const requestListener = (request) => requests.push(request);
+  const disposeListeners = () => {
     tab.page.off("request", requestListener);
-    tab.page.off("requestfinished", requestFinishedListener);
-    tab.page.off("framenavigated", frameNavigateListener);
-    clearTimeout(timeout);
   };
+  tab.page.on("request", requestListener);
+  let result;
   try {
-    const result = await callback();
-    if (!requests.size && !frameNavigated)
-      waitCallback();
-    await waitBarrier;
-    await tab.waitForTimeout(1e3);
-    return result;
+    result = await callback();
+    await tab.waitForTimeout(500);
   } finally {
-    dispose();
+    disposeListeners();
   }
-}
-async function generateLocator(locator) {
-  try {
-    const { resolvedSelector } = await locator._resolveSelector();
-    return (0, import_utils.asLocator)("javascript", resolvedSelector);
-  } catch (e) {
-    throw new Error("Ref not found, likely because element was removed. Use browser_snapshot to see what elements are currently on the page.");
+  const requestedNavigation = requests.some((request) => request.isNavigationRequest());
+  if (requestedNavigation) {
+    await tab.page.mainFrame().waitForLoadState("load", { timeout: 1e4 }).catch(() => {
+    });
+    return result;
   }
+  const promises = [];
+  for (const request of requests) {
+    if (["document", "stylesheet", "script", "xhr", "fetch"].includes(request.resourceType()))
+      promises.push(request.response().then((r) => r?.finished()).catch(() => {
+      }));
+    else
+      promises.push(request.response().catch(() => {
+      }));
+  }
+  const timeout = new Promise((resolve) => setTimeout(resolve, 5e3));
+  await Promise.race([Promise.all(promises), timeout]);
+  if (requests.length)
+    await tab.waitForTimeout(500);
+  return result;
 }
 async function callOnPageNoTrace(page, callback) {
   return await page._wrapApiCall(() => callback(page), { internal: true });
 }
-function dateAsFileName() {
+function dateAsFileName(extension) {
   const date = /* @__PURE__ */ new Date();
-  return date.toISOString().replace(/[:.]/g, "-");
+  return `page-${date.toISOString().replace(/[:.]/g, "-")}.${extension}`;
+}
+function eventWaiter(page, event, timeout) {
+  const disposables = [];
+  const eventPromise = new Promise((resolve, reject) => {
+    page.on(event, resolve);
+    disposables.push(() => page.off(event, resolve));
+  });
+  let abort;
+  const abortPromise = new Promise((resolve, reject) => {
+    abort = () => resolve(void 0);
+  });
+  const timeoutPromise = new Promise((f) => {
+    const timeoutId = setTimeout(() => f(void 0), timeout);
+    disposables.push(() => clearTimeout(timeoutId));
+  });
+  return {
+    promise: Promise.race([eventPromise, abortPromise, timeoutPromise]).finally(() => disposables.forEach((dispose) => dispose())),
+    abort
+  };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   callOnPageNoTrace,
   dateAsFileName,
-  generateLocator,
+  eventWaiter,
   waitForCompletion
 });

package/lib/mcp/browser/tools/verify.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,24 +15,15 @@ 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 verify_exports = {};
 __export(verify_exports, {
   default: () => verify_default
 });
 module.exports = __toCommonJS(verify_exports);
-var import_bundle = require("../../sdk/bundle");
+var import_mcpBundle = require("playwright-core/lib/mcpBundle");
+var import_utils = require("playwright-core/lib/utils");
 var import_tool = require("./tool");
-var javascript = __toESM(require("../codegen"));
-var import_utils = require("./utils");
 var import_common = require("./common");
 const verifyElement = (0, import_tool.defineTabTool)({
   capability: "testing",
@@ -43,10 +32,10 @@ const verifyElement = (0, import_tool.defineTabTool)({
     title: "Verify element visible",
     description: "Verify element is visible on the page",
     inputSchema: import_common.baseSchema.extend({
-      role: import_bundle.z.string().describe('ROLE of the element. Can be found in the snapshot like this: `- {ROLE} "Accessible Name":`'),
-      accessibleName: import_bundle.z.string().describe('ACCESSIBLE_NAME of the element. Can be found in the snapshot like this: `- role "{ACCESSIBLE_NAME}"`')
+      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}"`')
     }),
-    type: "readOnly"
+    type: "assertion"
   },
   handle: async (tab, params, response) => {
     const locator = tab.page.getByRole(params.role, { name: params.accessibleName });
@@ -54,7 +43,7 @@ const verifyElement = (0, import_tool.defineTabTool)({
       response.addError(`Element with role "${params.role}" and accessible name "${params.accessibleName}" not found`);
       return;
     }
-    response.addCode(`await expect(page.getByRole(${javascript.escapeWithQuotes(params.role)}, { name: ${javascript.escapeWithQuotes(params.accessibleName)} })).toBeVisible();`);
+    response.addCode(`await expect(page.getByRole(${(0, import_utils.escapeWithQuotes)(params.role)}, { name: ${(0, import_utils.escapeWithQuotes)(params.accessibleName)} })).toBeVisible();`);
     response.addResult("Done");
   }
 });
@@ -65,9 +54,9 @@ const verifyText = (0, import_tool.defineTabTool)({
     title: "Verify text visible",
     description: `Verify text is visible on the page. Prefer ${verifyElement.schema.name} if possible.`,
     inputSchema: import_common.baseSchema.extend({
-      text: import_bundle.z.string().describe('TEXT to verify. Can be found in the snapshot like this: `- role "Accessible Name": {TEXT}` or like this: `- text: {TEXT}`')
+      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: "readOnly"
+    type: "assertion"
   },
   handle: async (tab, params, response) => {
     const locator = tab.page.getByText(params.text).filter({ visible: true });
@@ -75,7 +64,7 @@ const verifyText = (0, import_tool.defineTabTool)({
       response.addError("Text not found");
       return;
     }
-    response.addCode(`await expect(page.getByText(${javascript.escapeWithQuotes(params.text)})).toBeVisible();`);
+    response.addCode(`await expect(page.getByText(${(0, import_utils.escapeWithQuotes)(params.text)})).toBeVisible();`);
     response.addResult("Done");
   }
 });
@@ -86,14 +75,14 @@ const verifyList = (0, import_tool.defineTabTool)({
     title: "Verify list visible",
     description: "Verify list is visible on the page",
     inputSchema: import_common.baseSchema.extend({
-      element: import_bundle.z.string().describe("Human-readable list description"),
-      ref: import_bundle.z.string().describe("Exact target element reference that points to the list"),
-      items: import_bundle.z.array(import_bundle.z.string()).describe("Items to verify")
+      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")
     }),
-    type: "readOnly"
+    type: "assertion"
   },
   handle: async (tab, params, response) => {
-    const locator = await tab.refLocator({ ref: params.ref, element: params.element });
+    const { locator } = await tab.refLocator({ ref: params.ref, element: params.element });
     const itemTexts = [];
     for (const item of params.items) {
       const itemLocator = locator.getByText(item);
@@ -105,7 +94,7 @@ const verifyList = (0, import_tool.defineTabTool)({
     }
     const ariaSnapshot = `\`
 - list:
-${itemTexts.map((t) => `  - listitem: ${javascript.escapeWithQuotes(t, '"')}`).join("\n")}
+${itemTexts.map((t) => `  - listitem: ${(0, import_utils.escapeWithQuotes)(t, '"')}`).join("\n")}
 \``;
     response.addCode(`await expect(page.locator('body')).toMatchAriaSnapshot(${ariaSnapshot});`);
     response.addResult("Done");
@@ -118,23 +107,23 @@ const verifyValue = (0, import_tool.defineTabTool)({
     title: "Verify value",
     description: "Verify element value",
     inputSchema: import_common.baseSchema.extend({
-      type: import_bundle.z.enum(["textbox", "checkbox", "radio", "combobox", "slider"]).describe("Type of the element"),
-      element: import_bundle.z.string().describe("Human-readable element description"),
-      ref: import_bundle.z.string().describe("Exact target element reference that points to the element"),
-      value: import_bundle.z.string().describe('Value to verify. For checkbox, use "true" or "false".')
+      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"),
+      value: import_mcpBundle.z.string().describe('Value to verify. For checkbox, use "true" or "false".')
     }),
-    type: "readOnly"
+    type: "assertion"
   },
   handle: async (tab, params, response) => {
-    const locator = await tab.refLocator({ ref: params.ref, element: params.element });
-    const locatorSource = `page.${await (0, import_utils.generateLocator)(locator)}`;
+    const { locator, resolved } = await tab.refLocator({ ref: params.ref, element: params.element });
+    const locatorSource = `page.${resolved}`;
     if (params.type === "textbox" || params.type === "slider" || params.type === "combobox") {
       const value = await locator.inputValue();
       if (value !== params.value) {
         response.addError(`Expected value "${params.value}", but got "${value}"`);
         return;
       }
-      response.addCode(`await expect(${locatorSource}).toHaveValue(${javascript.quote(params.value)});`);
+      response.addCode(`await expect(${locatorSource}).toHaveValue(${(0, import_utils.escapeWithQuotes)(params.value)});`);
     } else if (params.type === "checkbox" || params.type === "radio") {
       const value = await locator.isChecked();
       if (value !== (params.value === "true")) {

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

@@ -21,9 +21,9 @@ __export(wait_exports, {
   default: () => wait_default
 });
 module.exports = __toCommonJS(wait_exports);
-var import_bundle = require("../../sdk/bundle");
-var import_common = require("./common");
+var import_mcpBundle = require("playwright-core/lib/mcpBundle");
 var import_tool = require("./tool");
+var import_common = require("./common");
 const wait = (0, import_tool.defineTool)({
   capability: "core",
   schema: {
@@ -31,11 +31,11 @@ const wait = (0, import_tool.defineTool)({
     title: "Wait for",
     description: "Wait for text to appear or disappear or a specified time to pass",
     inputSchema: import_common.baseSchema.extend({
-      time: import_bundle.z.number().optional().describe("The time to wait in seconds"),
-      text: import_bundle.z.string().optional().describe("The text to wait for"),
-      textGone: import_bundle.z.string().optional().describe("The text to wait for to disappear")
+      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")
     }),
-    type: "readOnly"
+    type: "assertion"
   },
   handle: async (context, params, response) => {
     if (!params.text && !params.textGone && !params.time)

package/lib/mcp/browser/tools.js

@@ -41,14 +41,15 @@ var import_keyboard = __toESM(require("./tools/keyboard"));
 var import_mouse = __toESM(require("./tools/mouse"));
 var import_navigate = __toESM(require("./tools/navigate"));
 var import_pdf = __toESM(require("./tools/pdf"));
+var import_runCode = __toESM(require("./tools/runCode"));
 var import_snapshot = __toESM(require("./tools/snapshot"));
 var import_screenshot = __toESM(require("./tools/screenshot"));
-var import_script = __toESM(require("./tools/script"));
 var import_tabs = __toESM(require("./tools/tabs"));
 var import_tracing = __toESM(require("./tools/tracing"));
 var import_wait = __toESM(require("./tools/wait"));
 var import_verify = __toESM(require("./tools/verify"));
 const browserTools = [
+  ...import_common.default,
   ...import_common.default,
   // ...console,
   ...import_dialogs.default,
@@ -61,16 +62,16 @@ const browserTools = [
   // ...network,
   ...import_mouse.default,
   ...import_pdf.default,
+  ...import_runCode.default,
   ...import_screenshot.default,
   ...import_snapshot.default,
-  ...import_script.default,
   ...import_tabs.default,
   ...import_tracing.default,
   ...import_wait.default,
   ...import_verify.default
 ];
 function filteredTools(config) {
-  return browserTools.filter((tool) => tool.capability.startsWith("core") || tool.capability === "testing" || config.capabilities?.includes(tool.capability));
+  return browserTools.filter((tool) => tool.capability.startsWith("core") || config.capabilities?.includes(tool.capability));
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/lib/mcp/extension/cdpRelay.js

@@ -44,7 +44,7 @@ class CDPRelayServer {
     this._playwrightConnection = null;
     this._extensionConnection = null;
     this._nextSessionId = 1;
-    this._wsHost = (0, import_http2.httpAddressToString)(server.address()).replace(/^http/, "ws");
+    this._wsHost = (0, import_http2.addressToString)(server.address(), { protocol: "ws" });
     this._browserChannel = browserChannel;
     this._userDataDir = userDataDir;
     this._executablePath = executablePath;

package/lib/mcp/extension/extensionContextFactory.js

@@ -33,7 +33,7 @@ __export(extensionContextFactory_exports, {
 module.exports = __toCommonJS(extensionContextFactory_exports);
 var playwright = __toESM(require("playwright-core"));
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
-var import_http = require("../sdk/http");
+var import_utils = require("playwright-core/lib/utils");
 var import_cdpRelay = require("./cdpRelay");
 const debugLogger = (0, import_utilsBundle.debug)("pw:mcp:relay");
 class ExtensionContextFactory {
@@ -55,10 +55,11 @@ class ExtensionContextFactory {
   async _obtainBrowser(clientInfo, abortSignal, toolName) {
     const relay = await this._startRelay(abortSignal);
     await relay.ensureExtensionConnectionForMCPContext(clientInfo, abortSignal, toolName);
-    return await playwright.chromium.connectOverCDP(relay.cdpEndpoint());
+    return await playwright.chromium.connectOverCDP(relay.cdpEndpoint(), { isLocal: true });
   }
   async _startRelay(abortSignal) {
-    const httpServer = await (0, import_http.startHttpServer)({});
+    const httpServer = (0, import_utils.createHttpServer)();
+    await (0, import_utils.startHttpServer)(httpServer, {});
     if (abortSignal.aborted) {
       httpServer.close();
       throw new Error(abortSignal.reason);

package/lib/mcp/log.js

@@ -23,9 +23,9 @@ __export(log_exports, {
 });
 module.exports = __toCommonJS(log_exports);
 var import_utilsBundle = require("playwright-core/lib/utilsBundle");
-const errorsDebug = (0, import_utilsBundle.debug)("pw:mcp:errors");
+const errorDebug = (0, import_utilsBundle.debug)("pw:mcp:error");
 function logUnhandledError(error) {
-  errorsDebug(error);
+  errorDebug(error);
 }
 const testDebug = (0, import_utilsBundle.debug)("pw:mcp:test");
 // Annotate the CommonJS export names for ESM import in node:

package/lib/mcp/program.js

@@ -31,23 +31,33 @@ __export(program_exports, {
   decorateCommand: () => decorateCommand
 });
 module.exports = __toCommonJS(program_exports);
+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_config = require("./browser/config");
 var import_watchdog = require("./browser/watchdog");
 var import_browserContextFactory = require("./browser/browserContextFactory");
-var import_proxyBackend = require("./sdk/proxyBackend");
 var import_browserServerBackend = require("./browser/browserServerBackend");
 var import_extensionContextFactory = require("./extension/extensionContextFactory");
-var import_host = require("./vscode/host");
 function decorateCommand(command, version) {
-  command.option("--allowed-origins <origins>", "semicolon-separated list of origins to allow the browser to request. Default is to allow all.", import_config.semicolonSeparatedList).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.", 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("--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-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".').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("--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("--storage-state <path>", "path to the storage state file for isolated sessions.").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 "1280, 720"').addOption(new import_utilsBundle.ProgramOption("--connect-tool", "Allow to switch between different browser connection methods.").hideHelp()).addOption(new import_utilsBundle.ProgramOption("--vscode", "VS Code tools.").hideHelp()).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("--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) => {
     (0, import_watchdog.setupExitWatchdog)();
     if (options.vision) {
       console.error("The --vision option is deprecated, use --caps=vision instead");
       options.caps = "vision";
     }
     const config = await (0, import_config.resolveCLIConfig)(options);
+    if (config.saveVideo && !checkFfmpeg()) {
+      console.error(import_utilsBundle.colors.red(`
+Error: ffmpeg required to save the video is not installed.`));
+      console.error(`
+Please run the command below. It will install a local copy of ffmpeg and will not change any system-wide settings.`);
+      console.error(`
+    npx playwright install ffmpeg
+`);
+      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.extension) {
@@ -60,32 +70,6 @@ function decorateCommand(command, version) {
       await mcpServer.start(serverBackendFactory, config.server);
       return;
     }
-    if (options.vscode) {
-      await (0, import_host.runVSCodeTools)(config);
-      return;
-    }
-    if (options.connectTool) {
-      const providers = [
-        {
-          name: "default",
-          description: "Starts standalone browser",
-          connect: () => mcpServer.wrapInProcess(new import_browserServerBackend.BrowserServerBackend(config, browserContextFactory))
-        },
-        {
-          name: "extension",
-          description: "Connect to a browser using the Playwright MCP extension",
-          connect: () => mcpServer.wrapInProcess(new import_browserServerBackend.BrowserServerBackend(config, extensionContextFactory))
-        }
-      ];
-      const factory2 = {
-        name: "Playwright w/ switch",
-        nameInConfig: "playwright-switch",
-        version,
-        create: () => new import_proxyBackend.ProxyBackend(providers)
-      };
-      await mcpServer.start(factory2, config.server);
-      return;
-    }
     const factory = {
       name: "Playwright",
       nameInConfig: "playwright",
@@ -95,6 +79,14 @@ function decorateCommand(command, version) {
     await mcpServer.start(factory, config.server);
   });
 }
+function checkFfmpeg() {
+  try {
+    const executable = import_server.registry.findExecutable("ffmpeg");
+    return import_fs.default.existsSync(executable.executablePath("javascript"));
+  } catch (error) {
+    return false;
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   decorateCommand

package/lib/mcp/sdk/exports.js

@@ -16,17 +16,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var exports_exports = {};
 module.exports = __toCommonJS(exports_exports);
 __reExport(exports_exports, require("./inProcessTransport"), module.exports);
-__reExport(exports_exports, require("./proxyBackend"), module.exports);
 __reExport(exports_exports, require("./server"), module.exports);
 __reExport(exports_exports, require("./tool"), module.exports);
 __reExport(exports_exports, require("./http"), module.exports);
-__reExport(exports_exports, require("./mdb"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./inProcessTransport"),
-  ...require("./proxyBackend"),
   ...require("./server"),
   ...require("./tool"),
-  ...require("./http"),
-  ...require("./mdb")
+  ...require("./http")
 });