@wordbricks/playwright-mcp 0.1.27 → 0.1.30

package/lib/browserContextFactory.js

@@ -109,11 +109,16 @@ async function hidePlaywrightMarkers(browserContext) {
             },
         };
         const proxiedWindow = new Proxy(window, windowHandler);
-        Object.defineProperty(globalThis, "window", {
-            value: proxiedWindow,
-            configurable: false,
-            writable: false,
-        });
+        try {
+            Object.defineProperty(globalThis, "window", {
+                value: proxiedWindow,
+                configurable: true,
+                writable: false,
+            });
+        }
+        catch {
+            // Ignore if window property is already non-configurable
+        }
     });
 }
 export function contextFactory(config) {
@@ -232,6 +237,10 @@ class IsolatedContextFactory extends BaseContextFactory {
             ...this.config.browser.contextOptions,
             bypassCSP: true,
         });
+        // Grant local-network-access permission to suppress LNA prompt (Chrome 142+)
+        await browserContext
+            .grantPermissions(["local-network-access"])
+            .catch(() => { });
         await applyInitScript(browserContext, this.config);
         await hidePlaywrightMarkers(browserContext);
         return browserContext;
@@ -248,6 +257,10 @@ class CdpContextFactory extends BaseContextFactory {
         const browserContext = this.config.browser.isolated
             ? await browser.newContext({ bypassCSP: true })
             : browser.contexts()[0];
+        // Grant local-network-access permission to suppress LNA prompt (Chrome 142+)
+        await browserContext
+            .grantPermissions(["local-network-access"])
+            .catch(() => { });
         await applyInitScript(browserContext, this.config);
         await hidePlaywrightMarkers(browserContext);
         return browserContext;
@@ -323,6 +336,10 @@ class PersistentContextFactory {
                 }
                 // Get the initial page (persistent context creates one automatically)
                 const initialPage = browserContext.pages()[0];
+                // Grant local-network-access permission to suppress LNA prompt (Chrome 142+)
+                await browserContext
+                    .grantPermissions(["local-network-access"])
+                    .catch(() => { });
                 await applyInitScript(browserContext, this.config);
                 await hidePlaywrightMarkers(browserContext);
                 // Increment ref count for this persistent context

package/lib/config.js

@@ -96,7 +96,7 @@ export function configFromCLIOptions(cliOptions) {
     // Disable Cast/Media Router and local network discovery
     "--media-router=0", "--disable-cast", "--disable-cast-streaming-hw-encoding", 
     // Disable various Chrome features (Translate, PasswordManager, Autofill, Sync, MediaRouter, Cast)
-    "--disable-features=Translate,PasswordManager,PasswordManagerEnabled,PasswordManagerOnboarding,AutofillServerCommunication,CredentialManagerOnboarding,MediaRouter,GlobalMediaControls,CastMediaRouteProvider,DialMediaRouteProvider,CastAllowAllIPs,EnableCastDiscovery,LocalNetworkAccessChecks", "--disable-sync", 
+    "--disable-features=Translate,PasswordManager,PasswordManagerEnabled,PasswordManagerOnboarding,AutofillServerCommunication,CredentialManagerOnboarding,MediaRouter,GlobalMediaControls,CastMediaRouteProvider,DialMediaRouteProvider,CastAllowAllIPs,EnableCastDiscovery,LocalNetworkAccessCheck", "--disable-sync", 
     // Disable password manager via experimental options
     "--enable-features=DisablePasswordManager");
     // --app was passed, add app mode argument

package/lib/program.js

@@ -14,6 +14,8 @@
  * limitations under the License.
  */
 import { Option, program } from "commander";
+import dotenv from "dotenv";
+import fs from "fs";
 import { contextFactory } from "./browserContextFactory.js";
 import { BrowserServerBackend } from "./browserServerBackend.js";
 import { commaSeparatedList, resolveCLIConfig, semicolonSeparatedList, } from "./config.js";
@@ -24,6 +26,22 @@ import { ProxyBackend } from "./mcp/proxyBackend.js";
 import * as mcpServer from "./mcp/server.js";
 import * as mcpTransport from "./mcp/transport.js";
 import { packageJSON } from "./utils/package.js";
+export function dotenvFileLoader(value) {
+    if (!value)
+        return undefined;
+    if (!fs.existsSync(value))
+        return undefined;
+    return dotenv.parse(fs.readFileSync(value, "utf8"));
+}
+function loadSecretsFromCli(options) {
+    const secrets = dotenvFileLoader(options.secret);
+    if (!secrets)
+        return;
+    for (const [key, value] of Object.entries(secrets)) {
+        if (process.env[key] === undefined)
+            process.env[key] = value;
+    }
+}
 program
     .version("Version " + packageJSON.version)
     .name(packageJSON.name)
@@ -52,6 +70,7 @@ program
     .option("--storage-state <path>", "path to the storage state file for isolated sessions.")
     .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("--secret <path>", "path to a file containing secrets in the dotenv format")
     .option("--viewport-size <size>", 'specify browser viewport size in pixels, for example "1280, 720"')
     .option("--window-position <x,y>", 'specify Chrome window position in pixels, for example "100,200"')
     .option("--window-size <width,height>", 'specify Chrome window size in pixels, for example "1280,720"')
@@ -62,6 +81,7 @@ program
     .addOption(new Option("--vision", "Legacy option, use --caps=vision instead").hideHelp())
     .action(async (options) => {
     setupExitWatchdog();
+    loadSecretsFromCli(options);
     if (options.vision) {
         // eslint-disable-next-line no-console
         console.error("The --vision option is deprecated, use --caps=vision instead");

package/lib/response.js

@@ -21,6 +21,7 @@ export class Response {
     _events = [];
     _code = [];
     _images = [];
+    _screenshotUrl = null;
     _context;
     _includeSnapshot = false;
     _includeTabs = false;
@@ -62,6 +63,9 @@ export class Response {
     images() {
         return this._images;
     }
+    addScreenshotUrl(url) {
+        this._screenshotUrl = url;
+    }
     // NOTE Wordbricks Disabled: Page state logging not needed
     setIncludeSnapshot(full) {
         // this._includeSnapshot = full ?? 'incremental';
@@ -125,7 +129,13 @@ ${this._code.join("\n")}
         }
         // Main response part
         const content = [
-            { type: "text", text: response.join("\n") },
+            {
+                type: "text",
+                text: response.join("\n"),
+                ...(this._screenshotUrl && {
+                    _meta: { screenShotUrl: this._screenshotUrl },
+                }),
+            },
         ];
         // Image attachments.
         if (this._context.config.imageResponses !== "omit") {

package/lib/tools/getSnapshot.js

@@ -22,7 +22,7 @@ const getSnapshot = defineTool({
             lines.push(`- Page Title: ${snapshot.title}`);
             lines.push(`- Page Snapshot:`);
             lines.push("```yaml");
-            let aria = snapshot.ariaSnapshot || "";
+            let aria = JSON.stringify(snapshot.ariaSnapshot) || ""; // HOTFIX: JSON.stringify is hotfix, Find root cause
             aria = String(truncate(aria, { maxStringLength: MAX_LENGTH }));
             lines.push(aria);
             lines.push("```");

package/lib/tools/navigate.js

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 import { z } from "zod";
+import { captureAndUploadScreenshot } from "../utils/screenshot.js";
 import { defineTabTool, defineTool } from "./tool.js";
 const navigate = defineTool({
     capability: "core",
@@ -29,6 +30,10 @@ const navigate = defineTool({
     handle: async (context, params, response) => {
         const tab = await context.ensureTab();
         await tab.navigate(params.url);
+        const screenshotUrl = await captureAndUploadScreenshot(tab.page);
+        if (screenshotUrl) {
+            response.addScreenshotUrl(screenshotUrl);
+        }
         response.setIncludeSnapshot();
         response.addCode(`await page.goto('${params.url}');`);
     },

package/lib/tools/scroll.js

@@ -1,5 +1,6 @@
 import ms from "ms";
 import { z } from "zod";
+import { captureAndUploadScreenshot } from "../utils/screenshot.js";
 import { defineTabTool } from "./tool.js";
 /**
  * Generate random number between min and max
@@ -126,6 +127,10 @@ const scrollWheel = defineTabTool({
         }));
         // Always show scroll position for scroll tool
         response.addResult(`Scroll position:\nBefore: x=${initialScrollPosition.x}, y=${initialScrollPosition.y}\nAfter: x=${finalScrollPosition.x}, y=${finalScrollPosition.y}`);
+        const screenshotUrl = await captureAndUploadScreenshot(tab.page);
+        if (screenshotUrl) {
+            response.addScreenshotUrl(screenshotUrl);
+        }
     },
 });
 export default [scrollWheel];

package/lib/tools/snapshot.js

@@ -15,6 +15,7 @@
  */
 import { z } from "zod";
 import * as javascript from "../utils/codegen.js";
+import { captureAndUploadScreenshot } from "../utils/screenshot.js";
 import { defineTabTool, defineTool } from "./tool.js";
 import { generateLocator } from "./utils.js";
 const snapshot = defineTool({
@@ -81,6 +82,10 @@ const click = defineTabTool({
             else
                 await locator.click(options);
         });
+        const screenshotUrl = await captureAndUploadScreenshot(tab.page);
+        if (screenshotUrl) {
+            response.addScreenshotUrl(screenshotUrl);
+        }
     },
 });
 const drag = defineTabTool({

package/lib/utils/screenshot.js

@@ -0,0 +1,43 @@
+import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
+import { createGuid } from "./guid.js";
+const S3_REGION = "us-west-1";
+const ENABLE_SCREENSHOT_VALUES = new Set(["1", "true", "yes", "on"]);
+export const isScreenshotEnabled = () => ENABLE_SCREENSHOT_VALUES.has((process.env.ENABLE_SCREENSHOT_ON_NAVIGATE ?? "").toLowerCase());
+/**
+ * Captures a screenshot, uploads it to S3, and returns the URL.
+ * Waits 1 second before taking the screenshot to let the page settle.
+ */
+export async function captureAndUploadScreenshot(page) {
+    if (!isScreenshotEnabled())
+        return null;
+    const bucket = process.env.SCREENSHOT_S3_BUCKET;
+    const AWS_ACCESS_KEY_ID = process.env.AWS_ACCESS_KEY_ID;
+    const AWS_SECRET_ACCESS_KEY = process.env.AWS_SECRET_ACCESS_KEY;
+    const hasCredentials = Boolean(AWS_ACCESS_KEY_ID) && Boolean(AWS_SECRET_ACCESS_KEY);
+    if (!bucket || !hasCredentials)
+        return null;
+    await page.waitForLoadState("networkidle");
+    const s3Client = new S3Client({ region: S3_REGION });
+    const screenshotUrl = await page
+        .screenshot({
+        type: "jpeg",
+        quality: 80,
+        scale: "css",
+        timeout: 10000,
+    })
+        .then(async (screenshot) => {
+        const objectKey = `playwright-mcp/screenshot/${createGuid()}.jpg`;
+        await s3Client.send(new PutObjectCommand({
+            Bucket: bucket,
+            Key: objectKey,
+            Body: screenshot,
+            ContentType: "image/jpeg",
+        }));
+        return `https://${bucket}.s3.${S3_REGION}.amazonaws.com/${objectKey}`;
+    })
+        .catch((error) => {
+        console.error("Failed to capture and upload screenshot", error);
+        return null;
+    });
+    return screenshotUrl;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wordbricks/playwright-mcp",
-  "version": "0.1.27",
+  "version": "0.1.30",
   "description": "Playwright Tools for MCP",
   "type": "module",
   "files": [
@@ -18,11 +18,11 @@
     "build": "tsc && bun run copy-filters",
     "copy-filters": "mkdir -p lib/filters && cp -r src/filters/*.txt lib/filters/ 2>/dev/null || true",
     "build:extension": "tsc --project extension",
-    "dev": "concurrently --raw prefix none \"tsc --watch\" \"DEBUG=pw:mcp:* node --watch=lib cli.js --port 9224 --isolated\"",
-    "dev:headless": "concurrently --raw prefix none \"tsc --watch\" \"DEBUG=pw:mcp:* node --watch=lib cli.js --port 9224 --isolated --headless\"",
-    "start": "node cli.js --port 9224",
-    "start:isolated": "node cli.js --port 9224 --isolated",
-    "start:vision": "node cli.js --port 9224 --caps=vision",
+    "dev": "concurrently --raw prefix none \"tsc --watch\" \"DEBUG=pw:mcp:* node --watch=lib cli.js --port 9224 --isolated --secret .env.development\"",
+    "dev:headless": "concurrently --raw prefix none \"tsc --watch\" \"DEBUG=pw:mcp:* node --watch=lib cli.js --port 9224 --isolated --headless --secret .env.development\"",
+    "start": "node cli.js --port 9224 --secret .env.production",
+    "start:isolated": "node cli.js --port 9224 --isolated --secret .env.production",
+    "start:vision": "node cli.js --port 9224 --caps=vision --secret .env.production",
     "lint": "biome check --diagnostic-level=error",
     "format": "biome check --write --diagnostic-level=error",
     "check-types": "tsc --noEmit",
@@ -46,9 +46,10 @@
     "./cli.js": "./cli.js"
   },
   "dependencies": {
-    "@fxts/core": "1.21.1",
-    "@ghostery/adblocker": "2.13.0",
-    "@modelcontextprotocol/sdk": "1.24.3",
+    "@fxts/core": "1.23.0",
+    "@ghostery/adblocker": "2.13.2",
+    "@aws-sdk/client-s3": "3.958.0",
+    "@modelcontextprotocol/sdk": "1.25.1",
     "cheerio": "1.1.2",
     "commander": "14.0.2",
     "content-type": "1.0.5",
@@ -60,7 +61,7 @@
     "lodash": "4.17.21",
     "mime": "4.1.0",
     "ms": "2.1.3",
-    "playwright-core": "1.56.1",
+    "playwright-core": "1.57.0",
     "raw-body": "3.0.2",
     "typescript-parsec": "0.3.4",
     "ws": "8.18.3",
@@ -75,15 +76,15 @@
     "@types/content-type": "1.1.9",
     "@types/debug": "4.1.12",
     "@types/ms": "2.1.0",
-    "@types/bun": "1.3.4",
-    "@types/node": "24.10.1",
+    "@types/bun": "1.3.5",
+    "@types/node": "25.0.3",
     "@types/ws": "8.18.1",
     "concurrently": "9.2.1",
     "domelementtype": "2.3.0",
     "domhandler": "5.0.3",
-    "devtools-protocol": "0.0.1558402",
-    "esbuild": "0.27.1",
-    "openai": "6.10.0",
+    "devtools-protocol": "0.0.1561482",
+    "esbuild": "0.27.2",
+    "openai": "6.15.0",
     "typescript": "5.9.3"
   },
   "bin": {