playwright 1.56.1 → 1.57.0

package/lib/mcp/browser/tab.js

@@ -29,6 +29,7 @@ var import_utils2 = require("./tools/utils");
 var import_log = require("../log");
 var import_dialogs = require("./tools/dialogs");
 var import_files = require("./tools/files");
+var import_transform = require("../../transform/transform");
 const TabEvents = {
   modalState: "modalState"
 };
@@ -41,6 +42,7 @@ class Tab extends import_events.EventEmitter {
     this._requests = /* @__PURE__ */ new Set();
     this._modalStates = [];
     this._downloads = [];
+    this._needsFullSnapshot = false;
     this.context = context;
     this.page = page;
     this._onPageClose = onPageClose;
@@ -63,7 +65,7 @@ class Tab extends import_events.EventEmitter {
     page.setDefaultNavigationTimeout(this.context.config.timeouts.navigation);
     page.setDefaultTimeout(this.context.config.timeouts.action);
     page[tabSymbol] = this;
-    this._initializedPromise = this._initialize();
+    this.initializedPromise = this._initialize();
   }
   static forPage(page) {
     return page[tabSymbol];
@@ -84,6 +86,14 @@ class Tab extends import_events.EventEmitter {
     const requests = await this.page.requests().catch(() => []);
     for (const request of requests)
       this._requests.add(request);
+    for (const initPage of this.context.config.browser.initPage || []) {
+      try {
+        const { default: func } = await (0, import_transform.requireOrImport)(initPage);
+        await func({ page: this.page });
+      } catch (e) {
+        (0, import_log.logUnhandledError)(e);
+      }
+    }
   }
   modalStates() {
     return this._modalStates;
@@ -165,21 +175,22 @@ class Tab extends import_events.EventEmitter {
     await this.waitForLoadState("load", { timeout: 5e3 });
   }
   async consoleMessages(type) {
-    await this._initializedPromise;
+    await this.initializedPromise;
     return this._consoleMessages.filter((message) => type ? message.type === type : true);
   }
   async requests() {
-    await this._initializedPromise;
+    await this.initializedPromise;
     return this._requests;
   }
   async captureSnapshot() {
     let tabSnapshot;
     const modalStates = await this._raceAgainstModalStates(async () => {
-      const snapshot = await this.page._snapshotForAI();
+      const snapshot = await this.page._snapshotForAI({ track: "response" });
       tabSnapshot = {
         url: this.page.url(),
         title: await this.page.title(),
-        ariaSnapshot: snapshot,
+        ariaSnapshot: snapshot.full,
+        ariaSnapshotDiff: this._needsFullSnapshot ? void 0 : snapshot.incremental,
         modalStates: [],
         consoleMessages: [],
         downloads: this._downloads
@@ -189,6 +200,7 @@ class Tab extends import_events.EventEmitter {
       tabSnapshot.consoleMessages = this._recentConsoleMessages;
       this._recentConsoleMessages = [];
     }
+    this._needsFullSnapshot = !tabSnapshot;
     return tabSnapshot ?? {
       url: this.page.url(),
       title: "",
@@ -222,12 +234,15 @@ class Tab extends import_events.EventEmitter {
     return (await this.refLocators([params]))[0];
   }
   async refLocators(params) {
-    const snapshot = await this.page._snapshotForAI();
-    return params.map((param) => {
-      if (!snapshot.includes(`[ref=${param.ref}]`))
+    return Promise.all(params.map(async (param) => {
+      try {
+        const locator = this.page.locator(`aria-ref=${param.ref}`).describe(param.element);
+        const { resolvedSelector } = await locator._resolveSelector();
+        return { locator, resolved: (0, import_utils.asLocator)("javascript", resolvedSelector) };
+      } catch (e) {
         throw new Error(`Ref ${param.ref} not found in the current page snapshot. Try capturing new snapshot.`);
-      return this.page.locator(`aria-ref=${param.ref}`).describe(param.element);
-    });
+      }
+    }));
   }
   async waitForTimeout(time) {
     if (this._javaScriptBlocked()) {

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

@@ -34,7 +34,6 @@ module.exports = __toCommonJS(evaluate_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
-var import_utils = require("./utils");
 const evaluateSchema = import_bundle.z.object({
   function: import_bundle.z.string().describe("() => { /* code */ } or (element) => { /* code */ } when element is provided"),
   element: import_bundle.z.string().optional().describe("Human-readable element description used to obtain permission to interact with the element"),
@@ -54,12 +53,12 @@ const evaluate = (0, import_tool.defineTabTool)({
     let locator;
     if (params.ref && params.element) {
       locator = await tab.refLocator({ ref: params.ref, element: params.element });
-      response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.evaluate(${javascript.quote(params.function)});`);
+      response.addCode(`await page.${locator.resolved}.evaluate(${javascript.quote(params.function)});`);
     } else {
       response.addCode(`await page.evaluate(${javascript.quote(params.function)});`);
     }
     await tab.waitForCompletion(async () => {
-      const receiver = locator ?? tab.page;
+      const receiver = locator?.locator ?? tab.page;
       const result = await receiver._evaluateFunction(params.function);
       response.addResult(JSON.stringify(result, null, 2) || "undefined");
     });

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

@@ -33,7 +33,6 @@ __export(form_exports, {
 module.exports = __toCommonJS(form_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
-var import_utils = require("./utils");
 var codegen = __toESM(require("../codegen"));
 const fillForm = (0, import_tool.defineTabTool)({
   capability: "core",
@@ -53,8 +52,8 @@ const fillForm = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     for (const field of params.fields) {
-      const locator = await tab.refLocator({ element: field.name, ref: field.ref });
-      const locatorSource = `await page.${await (0, import_utils.generateLocator)(locator)}`;
+      const { locator, resolved } = await tab.refLocator({ element: field.name, ref: field.ref });
+      const locatorSource = `await page.${resolved}`;
       if (field.type === "textbox" || field.type === "slider") {
         const secret = tab.context.lookupSecret(field.value);
         await locator.fill(secret.value);

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

@@ -24,7 +24,6 @@ module.exports = __toCommonJS(keyboard_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var import_snapshot = require("./snapshot");
-var import_utils = require("./utils");
 const pressKey = (0, import_tool.defineTabTool)({
   capability: "core",
   schema: {
@@ -60,20 +59,20 @@ const type = (0, import_tool.defineTabTool)({
     type: "input"
   },
   handle: async (tab, params, response) => {
-    const locator = await tab.refLocator(params);
+    const { locator, resolved } = await tab.refLocator(params);
     const secret = tab.context.lookupSecret(params.text);
     await tab.waitForCompletion(async () => {
       if (params.slowly) {
         response.setIncludeSnapshot();
-        response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.pressSequentially(${secret.code});`);
+        response.addCode(`await page.${resolved}.pressSequentially(${secret.code});`);
         await locator.pressSequentially(secret.value);
       } else {
-        response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.fill(${secret.code});`);
+        response.addCode(`await page.${resolved}.fill(${secret.code});`);
         await locator.fill(secret.value);
       }
       if (params.submit) {
         response.setIncludeSnapshot();
-        response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.press('Enter');`);
+        response.addCode(`await page.${resolved}.press('Enter');`);
         await locator.press("Enter");
       }
     });

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

@@ -36,7 +36,7 @@ var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
 var import_utils = require("./utils");
 const pdfSchema = import_bundle.z.object({
-  filename: import_bundle.z.string().optional().describe("File name to save the pdf to. Defaults to `page-{timestamp}.pdf` if not specified.")
+  filename: import_bundle.z.string().optional().describe("File name to save the pdf to. Defaults to `page-{timestamp}.pdf` if not specified. Prefer relative file names to stay within the output directory.")
 });
 const pdf = (0, import_tool.defineTabTool)({
   capability: "pdf",

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

@@ -0,0 +1,75 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var runCode_exports = {};
+__export(runCode_exports, {
+  default: () => runCode_default
+});
+module.exports = __toCommonJS(runCode_exports);
+var import_vm = __toESM(require("vm"));
+var import_utils = require("playwright-core/lib/utils");
+var import_bundle = require("../../sdk/bundle");
+var import_tool = require("./tool");
+const codeSchema = import_bundle.z.object({
+  code: import_bundle.z.string().describe(`Playwright code snippet to run. The snippet should access the \`page\` object to interact with the page. Can make multiple statements. For example: \`await page.getByRole('button', { name: 'Submit' }).click();\``)
+});
+const runCode = (0, import_tool.defineTabTool)({
+  capability: "core",
+  schema: {
+    name: "browser_run_code",
+    title: "Run Playwright code",
+    description: "Run Playwright code snippet",
+    inputSchema: codeSchema,
+    type: "action"
+  },
+  handle: async (tab, params, response) => {
+    response.setIncludeSnapshot();
+    response.addCode(params.code);
+    const __end__ = new import_utils.ManualPromise();
+    const context = {
+      page: tab.page,
+      __end__
+    };
+    import_vm.default.createContext(context);
+    await tab.waitForCompletion(async () => {
+      const snippet = `(async () => {
+        try {
+          ${params.code};
+          __end__.resolve();
+        } catch (e) {
+          __end__.reject(e);
+        }
+      })()`;
+      import_vm.default.runInContext(snippet, context);
+      await __end__;
+    });
+  }
+});
+var runCode_default = [
+  runCode
+];

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

@@ -28,16 +28,20 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var screenshot_exports = {};
 __export(screenshot_exports, {
-  default: () => screenshot_default
+  default: () => screenshot_default,
+  scaleImageToFitMessage: () => scaleImageToFitMessage
 });
 module.exports = __toCommonJS(screenshot_exports);
+var import_fs = __toESM(require("fs"));
+var import_utils = require("playwright-core/lib/utils");
+var import_utilsBundle = require("playwright-core/lib/utilsBundle");
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
-var import_utils = require("./utils");
+var import_utils2 = require("./utils");
 const screenshotSchema = import_bundle.z.object({
   type: import_bundle.z.enum(["png", "jpeg"]).default("png").describe("Image format for the screenshot. Default is png."),
-  filename: import_bundle.z.string().optional().describe("File name to save the screenshot to. Defaults to `page-{timestamp}.{png|jpeg}` if not specified."),
+  filename: import_bundle.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_bundle.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."),
   ref: import_bundle.z.string().optional().describe("Exact target element reference from the page snapshot. If not provided, the screenshot will be taken of viewport. If ref is provided, element must be provided too."),
   fullPage: import_bundle.z.boolean().optional().describe("When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Cannot be used with element screenshots.")
@@ -57,32 +61,46 @@ const screenshot = (0, import_tool.defineTabTool)({
     if (params.fullPage && params.ref)
       throw new Error("fullPage cannot be used with element screenshots.");
     const fileType = params.type || "png";
-    const fileName = await tab.context.outputFile(params.filename ?? (0, import_utils.dateAsFileName)(fileType), { origin: "llm", reason: "Saving screenshot" });
+    const fileName = await tab.context.outputFile(params.filename || (0, import_utils2.dateAsFileName)(fileType), { origin: "llm", reason: "Saving screenshot" });
     const options = {
       type: fileType,
       quality: fileType === "png" ? void 0 : 90,
       scale: "css",
-      path: fileName,
       ...params.fullPage !== void 0 && { fullPage: params.fullPage }
     };
     const isElementScreenshot = params.element && params.ref;
     const screenshotTarget = isElementScreenshot ? params.element : params.fullPage ? "full page" : "viewport";
     response.addCode(`// Screenshot ${screenshotTarget} and save it as ${fileName}`);
-    const locator = params.ref ? await tab.refLocator({ element: params.element || "", ref: params.ref }) : null;
-    if (locator)
-      response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.screenshot(${javascript.formatObject(options)});`);
+    const ref = params.ref ? await tab.refLocator({ element: params.element || "", ref: params.ref }) : null;
+    if (ref)
+      response.addCode(`await page.${ref.resolved}.screenshot(${javascript.formatObject(options)});`);
     else
       response.addCode(`await page.screenshot(${javascript.formatObject(options)});`);
-    const buffer = locator ? await locator.screenshot(options) : await tab.page.screenshot(options);
+    const buffer = ref ? await ref.locator.screenshot(options) : await tab.page.screenshot(options);
+    await (0, import_utils.mkdirIfNeeded)(fileName);
+    await import_fs.default.promises.writeFile(fileName, buffer);
     response.addResult(`Took the ${screenshotTarget} screenshot and saved it as ${fileName}`);
-    if (!params.fullPage) {
-      response.addImage({
-        contentType: fileType === "png" ? "image/png" : "image/jpeg",
-        data: buffer
-      });
-    }
+    response.addImage({
+      contentType: fileType === "png" ? "image/png" : "image/jpeg",
+      data: scaleImageToFitMessage(buffer, fileType)
+    });
   }
 });
+function scaleImageToFitMessage(buffer, imageType) {
+  const image = imageType === "png" ? import_utilsBundle.PNG.sync.read(buffer) : import_utilsBundle.jpegjs.decode(buffer, { maxMemoryUsageInMB: 512 });
+  const pixels = image.width * image.height;
+  const shrink = Math.min(1568 / image.width, 1568 / image.height, Math.sqrt(1.15 * 1024 * 1024 / pixels));
+  if (shrink > 1)
+    return buffer;
+  const width = image.width * shrink | 0;
+  const height = image.height * shrink | 0;
+  const scaledImage = (0, import_utils.scaleImageToSize)(image, { width, height });
+  return imageType === "png" ? import_utilsBundle.PNG.sync.write(scaledImage) : import_utilsBundle.jpegjs.encode(scaledImage, 80).data;
+}
 var screenshot_default = [
   screenshot
 ];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  scaleImageToFitMessage
+});

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

@@ -35,7 +35,6 @@ module.exports = __toCommonJS(snapshot_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
-var import_utils = require("./utils");
 const snapshot = (0, import_tool.defineTool)({
   capability: "core",
   schema: {
@@ -47,7 +46,7 @@ const snapshot = (0, import_tool.defineTool)({
   },
   handle: async (context, params, response) => {
     await context.ensureTab();
-    response.setIncludeSnapshot();
+    response.setIncludeSnapshot("full");
   }
 });
 const elementSchema = import_bundle.z.object({
@@ -70,7 +69,7 @@ const click = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
-    const locator = await tab.refLocator(params);
+    const { locator, resolved } = await tab.refLocator(params);
     const options = {
       button: params.button,
       modifiers: params.modifiers
@@ -78,9 +77,9 @@ const click = (0, import_tool.defineTabTool)({
     const formatted = javascript.formatObject(options, " ", "oneline");
     const optionsAttr = formatted !== "{}" ? formatted : "";
     if (params.doubleClick)
-      response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.dblclick(${optionsAttr});`);
+      response.addCode(`await page.${resolved}.dblclick(${optionsAttr});`);
     else
-      response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.click(${optionsAttr});`);
+      response.addCode(`await page.${resolved}.click(${optionsAttr});`);
     await tab.waitForCompletion(async () => {
       if (params.doubleClick)
         await locator.dblclick(options);
@@ -105,14 +104,14 @@ const drag = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
-    const [startLocator, endLocator] = await tab.refLocators([
+    const [start, end] = await tab.refLocators([
       { ref: params.startRef, element: params.startElement },
       { ref: params.endRef, element: params.endElement }
     ]);
     await tab.waitForCompletion(async () => {
-      await startLocator.dragTo(endLocator);
+      await start.locator.dragTo(end.locator);
     });
-    response.addCode(`await page.${await (0, import_utils.generateLocator)(startLocator)}.dragTo(page.${await (0, import_utils.generateLocator)(endLocator)});`);
+    response.addCode(`await page.${start.resolved}.dragTo(page.${end.resolved});`);
   }
 });
 const hover = (0, import_tool.defineTabTool)({
@@ -126,8 +125,8 @@ const hover = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
-    const locator = await tab.refLocator(params);
-    response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.hover();`);
+    const { locator, resolved } = await tab.refLocator(params);
+    response.addCode(`await page.${resolved}.hover();`);
     await tab.waitForCompletion(async () => {
       await locator.hover();
     });
@@ -147,8 +146,8 @@ const selectOption = (0, import_tool.defineTabTool)({
   },
   handle: async (tab, params, response) => {
     response.setIncludeSnapshot();
-    const locator = await tab.refLocator(params);
-    response.addCode(`await page.${await (0, import_utils.generateLocator)(locator)}.selectOption(${javascript.formatObject(params.values)});`);
+    const { locator, resolved } = await tab.refLocator(params);
+    response.addCode(`await page.${resolved}.selectOption(${javascript.formatObject(params.values)});`);
     await tab.waitForCompletion(async () => {
       await locator.selectOption(params.values);
     });
@@ -164,8 +163,8 @@ const pickLocator = (0, import_tool.defineTabTool)({
     type: "readOnly"
   },
   handle: async (tab, params, response) => {
-    const locator = await tab.refLocator(params);
-    response.addResult(await (0, import_utils.generateLocator)(locator));
+    const { resolved } = await tab.refLocator(params);
+    response.addResult(resolved);
   }
 });
 var snapshot_default = [

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

@@ -49,14 +49,14 @@ const browserTabs = (0, import_tool.defineTool)({
       }
       case "close": {
         await context.closeTab(params.index);
-        response.setIncludeSnapshot();
+        response.setIncludeSnapshot("full");
         return;
       }
       case "select": {
         if (params.index === void 0)
           throw new Error("Tab index is required");
         await context.selectTab(params.index);
-        response.setIncludeSnapshot();
+        response.setIncludeSnapshot("full");
         return;
       }
     }

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

@@ -20,11 +20,9 @@ var utils_exports = {};
 __export(utils_exports, {
   callOnPageNoTrace: () => callOnPageNoTrace,
   dateAsFileName: () => dateAsFileName,
-  generateLocator: () => generateLocator,
   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;
@@ -76,14 +74,6 @@ async function waitForCompletion(tab, callback) {
     dispose();
   }
 }
-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.");
-  }
-}
 async function callOnPageNoTrace(page, callback) {
   return await page._wrapApiCall(() => callback(page), { internal: true });
 }
@@ -95,6 +85,5 @@ function dateAsFileName(extension) {
 0 && (module.exports = {
   callOnPageNoTrace,
   dateAsFileName,
-  generateLocator,
   waitForCompletion
 });

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

@@ -34,7 +34,6 @@ module.exports = __toCommonJS(verify_exports);
 var import_bundle = require("../../sdk/bundle");
 var import_tool = require("./tool");
 var javascript = __toESM(require("../codegen"));
-var import_utils = require("./utils");
 const verifyElement = (0, import_tool.defineTabTool)({
   capability: "testing",
   schema: {
@@ -92,7 +91,7 @@ const verifyList = (0, import_tool.defineTabTool)({
     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);
@@ -125,8 +124,8 @@ const verifyValue = (0, import_tool.defineTabTool)({
     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) {

package/lib/mcp/browser/tools.js

@@ -44,6 +44,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_runCode = __toESM(require("./tools/runCode"));
 var import_snapshot = __toESM(require("./tools/snapshot"));
 var import_screenshot = __toESM(require("./tools/screenshot"));
 var import_tabs = __toESM(require("./tools/tabs"));
@@ -63,6 +64,7 @@ const browserTools = [
   ...import_network.default,
   ...import_mouse.default,
   ...import_pdf.default,
+  ...import_runCode.default,
   ...import_screenshot.default,
   ...import_snapshot.default,
   ...import_tabs.default,

package/lib/mcp/program.js

@@ -31,7 +31,9 @@ __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");
@@ -40,13 +42,23 @@ var import_proxyBackend = require("./sdk/proxyBackend");
 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 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("--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("--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 "1280x720"', import_config.resolutionParser.bind(null, "--viewport-size")).addOption(new import_utilsBundle.ProgramOption("--connect-tool", "Allow to switch between different browser connection methods.").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("--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-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".').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("--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("--connect-tool", "Allow to switch between different browser connection methods.").hideHelp()).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) {
@@ -90,6 +102,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

@@ -20,13 +20,11 @@ __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")
 });

package/lib/mcp/sdk/http.js

@@ -67,11 +67,12 @@ function httpAddressToString(address) {
     resolvedHost = "localhost";
   return `http://${resolvedHost}:${resolvedPort}`;
 }
-async function installHttpTransport(httpServer, serverBackendFactory, allowedHosts) {
+async function installHttpTransport(httpServer, serverBackendFactory, unguessableUrl, allowedHosts) {
   const url = httpAddressToString(httpServer.address());
   const host = new URL(url).host;
   allowedHosts = (allowedHosts || [host]).map((h) => h.toLowerCase());
   const allowAnyHost = allowedHosts.includes("*");
+  const pathPrefix = unguessableUrl ? `/${import_crypto.default.randomUUID()}` : "";
   const sseSessions = /* @__PURE__ */ new Map();
   const streamableSessions = /* @__PURE__ */ new Map();
   httpServer.on("request", async (req, res) => {
@@ -86,7 +87,12 @@ async function installHttpTransport(httpServer, serverBackendFactory, allowedHos
         return res.end("Access is only allowed at " + allowedHosts.join(", "));
       }
     }
-    const url2 = new URL(`http://localhost${req.url}`);
+    if (!req.url?.startsWith(pathPrefix)) {
+      res.statusCode = 404;
+      return res.end("Not found");
+    }
+    const path = req.url?.slice(pathPrefix.length);
+    const url2 = new URL(`http://localhost${path}`);
     if (url2.pathname === "/killkillkill" && req.method === "GET") {
       res.statusCode = 200;
       res.end("Killing process");
@@ -98,6 +104,7 @@ async function installHttpTransport(httpServer, serverBackendFactory, allowedHos
     else
       await handleStreamable(serverBackendFactory, req, res, streamableSessions);
   });
+  return `${url}${pathPrefix}`;
 }
 async function handleSSE(serverBackendFactory, req, res, url, sessions) {
   if (req.method === "POST") {