@wordbricks/playwright-mcp 0.1.3

package/lib/utils/truncate.js

@@ -0,0 +1,103 @@
+/**
+ * Utilities for truncating values for display
+ */
+/**
+ * Recursively truncate values for display, limiting strings, arrays, and object keys at each depth level
+ */
+export const truncate = (value, options) => {
+    const { maxStringLength = 100, maxItems = 10 } = options ?? {};
+    if (typeof value === 'string') {
+        if (value.length > maxStringLength)
+            return value.substring(0, Math.max(0, maxStringLength - 3)) + '...';
+        return value;
+    }
+    if (Array.isArray(value)) {
+        const limited = maxItems !== undefined ? value.slice(0, maxItems) : value;
+        return limited.map(v => truncate(v, options));
+    }
+    if (value && typeof value === 'object') {
+        let entries = Object.entries(value);
+        if (maxItems !== undefined)
+            entries = entries.slice(0, maxItems);
+        const out = {};
+        for (const [key, val] of entries)
+            out[key] = truncate(val, options);
+        return out;
+    }
+    return value;
+};
+export const truncateStringTo = (text, max) => {
+    if (max <= 0)
+        return { text: '', truncated: text.length > 0 };
+    if (text.length <= max)
+        return { text, truncated: false };
+    const sliceLen = Math.max(0, max - 3);
+    return { text: text.slice(0, sliceLen) + '...', truncated: true };
+};
+/**
+ * Create a standardized truncation note like:
+ * … [truncated: showing 120/500 chars (24%)]
+ * Caller may optionally provide a formatter (e.g. bytes -> "8 KB") and/or units label.
+ */
+export const formatTruncationLine = (shown, total, options) => {
+    const { units, formatter } = options ?? {};
+    const pct = total ? Math.round((shown / total) * 100) : 0;
+    const shownStr = formatter ? formatter(shown) : String(shown);
+    const totalStr = formatter ? formatter(total) : String(total);
+    const unitsPart = units ? ` ${units}` : '';
+    return `… [truncated: showing ${shownStr}/${totalStr}${unitsPart} (${pct}%)]`;
+};
+export const trimLeafValuesDeep = (value, maxChars) => {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === 'string')
+        return value.length > maxChars ? value.slice(0, maxChars) + '...' : value;
+    if (Array.isArray(value))
+        return value.map(v => trimLeafValuesDeep(v, maxChars));
+    if (typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value))
+            out[k] = trimLeafValuesDeep(v, maxChars);
+        return out;
+    }
+    return value;
+};
+export const trimJsonLeafValues = (input, maxChars) => {
+    try {
+        const parsed = JSON.parse(input);
+        const trimmed = trimLeafValuesDeep(parsed, maxChars);
+        return JSON.stringify(trimmed);
+    }
+    catch {
+        return input.length > maxChars ? input.slice(0, maxChars) + '...' : input;
+    }
+};
+export const toJsonPathNormalized = (path) => {
+    let root = null;
+    if (path.startsWith('response.body.'))
+        root = 'response.body';
+    else if (path.startsWith('request.body.'))
+        root = 'request.body';
+    else
+        return null;
+    let p = path.slice(root.length + 1);
+    if (p.includes(' > ') || p.includes('@'))
+        return null;
+    p = p.replace(/\.\*/g, '[*]');
+    p = p.replace(/\.(\d+)(?=\.|$)/g, '[$1]');
+    return { root, jsonPath: `$.${p}` };
+};
+export const toJsonPathOriginal = (path) => {
+    let root = null;
+    if (path.startsWith('response.body.'))
+        root = 'response.body';
+    else if (path.startsWith('request.body.'))
+        root = 'request.body';
+    else
+        return null;
+    let p = path.slice(root.length + 1);
+    if (p.includes(' > ') || p.includes('@'))
+        return null;
+    p = p.replace(/\.(\d+)(?=\.|$)/g, '[$1]');
+    return { root, jsonPath: `$.${p}` };
+};

package/lib/utils/withTimeout.js

@@ -0,0 +1,7 @@
+// Helper to safely execute a promise with timeout
+export const withTimeout = async (promise, ms) => {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error('Timeout')), ms)),
+    ]);
+};

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@wordbricks/playwright-mcp",
+  "version": "0.1.3",
+  "description": "Playwright Tools for MCP",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wordbricks/playwright-mcp.git"
+  },
+  "homepage": "https://playwright.dev",
+  "engines": {
+    "node": ">=18"
+  },
+  "author": {
+    "name": "Microsoft Corporation"
+  },
+  "license": "Apache-2.0",
+  "scripts": {
+    "build": "tsc",
+    "build:extension": "tsc --project extension",
+    "dev": "concurrently --raw prefix none \"tsc --watch\" \"DEBUG=pw:mcp:* node --watch=lib cli.js --port 9224\"",
+    "dev:isolated": "concurrently --raw prefix none \"tsc --watch\" \"DEBUG=pw:mcp:* node --watch=lib cli.js --port 9224 --isolated --viewport-size=1280,720\"",
+    "dev:isolated:headless": "concurrently --raw prefix none \"tsc --watch\" \"DEBUG=pw:mcp:* node --watch=lib cli.js --port 9224 --isolated --headless --viewport-size=1280,720\"",
+    "dev:vision": "concurrently --raw prefix none \"tsc --watch\" \"DEBUG=pw:mcp:* node --watch=lib cli.js --port 9224 --caps=vision\"",
+    "start": "node cli.js --port 9224 --viewport-size=1280,720",
+    "start:isolated": "node cli.js --port 9224 --viewport-size=1280,720 --isolated",
+    "start:vision": "node cli.js --port 9224 --viewport-size=1280,720 --caps=vision",
+    "lint": "npm run update-readme && npm run check-deps && eslint . && tsc --noEmit",
+    "lint-fix": "eslint . --fix",
+    "check-deps": "node utils/check-deps.js",
+    "update-readme": "node utils/update-readme.js",
+    "watch": "tsc --watch",
+    "test": "playwright test",
+    "ctest": "playwright test --project=chrome",
+    "ftest": "playwright test --project=firefox",
+    "wtest": "playwright test --project=webkit",
+    "run-server": "node lib/browserServer.js",
+    "clean": "rm -rf lib && rm -rf extension/lib",
+    "npm-publish": "npm run clean && npm run build && npm run test && npm publish",
+    "ext:download": "bun src/scripts/prepare.ts"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  },
+  "dependencies": {
+    "@fxts/core": "^1.13.2",
+    "@modelcontextprotocol/sdk": "^1.16.0",
+    "@wordbricks/fetch-mcp": "1.2.3",
+    "cheerio": "1.1.2",
+    "commander": "^13.1.0",
+    "content-type": "^1.0.5",
+    "debug": "^4.4.1",
+    "dotenv": "^17.2.0",
+    "find-up": "^7.0.0",
+    "json5": "^2.2.3",
+    "jsonpath-plus": "^10.3.0",
+    "lodash": "^4.17.21",
+    "mime": "^4.0.7",
+    "ms": "^2.1.3",
+    "playwright": "1.55.0-alpha-2025-08-12",
+    "playwright-core": "1.55.0-alpha-2025-08-12",
+    "raw-body": "^3.0.0",
+    "typescript-parsec": "0.3.4",
+    "ws": "^8.18.1",
+    "zod": "^3.24.1",
+    "zod-to-json-schema": "^3.24.4"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.57.0",
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.19.0",
+    "@playwright/test": "1.55.0-alpha-2025-08-12",
+    "@stylistic/eslint-plugin": "^3.0.1",
+    "@tomjs/unzip-crx": "1.1.3",
+    "@types/chrome": "^0.0.315",
+    "@types/content-type": "^1.1.9",
+    "@types/debug": "^4.1.12",
+    "@types/node": "^22.13.10",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.26.1",
+    "@typescript-eslint/parser": "^8.26.1",
+    "@typescript-eslint/utils": "^8.26.1",
+    "concurrently": "^9.2.0",
+    "devtools-protocol": "^0.0.1498597",
+    "esbuild": "^0.20.1",
+    "eslint": "^9.19.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-notice": "^1.0.0",
+    "openai": "^5.10.2",
+    "typescript": "^5.8.2",
+    "zx": "^8.6.1"
+  },
+  "bin": {
+    "mcp-server-playwright": "cli-wrapper.js"
+  }
+}