@playwright/mcp 0.0.36-alpha-2025-09-02 → 0.0.36-alpha-2025-09-04

package/lib/program.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Copyright (c) Microsoft Corporation.
  *
@@ -13,25 +14,58 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { program, Option } from 'commander';
-import * as mcpServer from './mcp/server.js';
-import { commaSeparatedList, resolveCLIConfig, semicolonSeparatedList } from './config.js';
-import { packageJSON } from './utils/package.js';
-import { Context } from './context.js';
-import { contextFactory } from './browserContextFactory.js';
-import { runLoopTools } from './loopTools/main.js';
-import { ProxyBackend } from './mcp/proxyBackend.js';
-import { BrowserServerBackend } from './browserServerBackend.js';
-import { ExtensionContextFactory } from './extension/extensionContextFactory.js';
-import { runVSCodeTools } from './vscode/host.js';
-program
-    .version('Version ' + packageJSON.version)
-    .name(packageJSON.name)
-    .option('--allowed-origins <origins>', 'semicolon-separated list of origins to allow the browser to request. Default is to allow all.', 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.', semicolonSeparatedList)
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const mcpServer = __importStar(require("./sdk/server"));
+const config_1 = require("./browser/config");
+const package_1 = require("./package");
+const context_1 = require("./browser/context");
+const browserContextFactory_1 = require("./browser/browserContextFactory");
+const proxyBackend_1 = require("./sdk/proxyBackend");
+const browserServerBackend_1 = require("./browser/browserServerBackend");
+const extensionContextFactory_1 = require("./extension/extensionContextFactory");
+const host_1 = require("./vscode/host");
+commander_1.program
+    .version('Version ' + package_1.packageJSON.version)
+    .name(package_1.packageJSON.name)
+    .option('--allowed-origins <origins>', 'semicolon-separated list of origins to allow the browser to request. Default is to allow all.', config_1.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.', config_1.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.', commaSeparatedList)
+    .option('--caps <caps>', 'comma-separated list of additional capabilities to enable, possible values: vision, pdf.', config_1.commaSeparatedList)
     .option('--cdp-endpoint <endpoint>', 'CDP endpoint to connect to.')
     .option('--config <path>', 'path to the configuration file.')
     .option('--device <device>', 'device to emulate, for example: "iPhone 15"')
@@ -53,10 +87,9 @@ program
     .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 Option('--connect-tool', 'Allow to switch between different browser connection methods.').hideHelp())
-    .addOption(new Option('--vscode', 'VS Code tools.').hideHelp())
-    .addOption(new Option('--loop-tools', 'Run loop tools').hideHelp())
-    .addOption(new Option('--vision', 'Legacy option, use --caps=vision instead').hideHelp())
+    .addOption(new commander_1.Option('--connect-tool', 'Allow to switch between different browser connection methods.').hideHelp())
+    .addOption(new commander_1.Option('--vscode', 'VS Code tools.').hideHelp())
+    .addOption(new commander_1.Option('--vision', 'Legacy option, use --caps=vision instead').hideHelp())
     .action(async (options) => {
     setupExitWatchdog();
     if (options.vision) {
@@ -64,25 +97,21 @@ program
         console.error('The --vision option is deprecated, use --caps=vision instead');
         options.caps = 'vision';
     }
-    const config = await resolveCLIConfig(options);
-    const browserContextFactory = contextFactory(config);
-    const extensionContextFactory = new ExtensionContextFactory(config.browser.launchOptions.channel || 'chrome', config.browser.userDataDir, config.browser.launchOptions.executablePath);
+    const config = await (0, config_1.resolveCLIConfig)(options);
+    const browserContextFactory = (0, browserContextFactory_1.contextFactory)(config);
+    const extensionContextFactory = new extensionContextFactory_1.ExtensionContextFactory(config.browser.launchOptions.channel || 'chrome', config.browser.userDataDir, config.browser.launchOptions.executablePath);
     if (options.extension) {
         const serverBackendFactory = {
             name: 'Playwright w/ extension',
             nameInConfig: 'playwright-extension',
-            version: packageJSON.version,
-            create: () => new BrowserServerBackend(config, extensionContextFactory)
+            version: package_1.packageJSON.version,
+            create: () => new browserServerBackend_1.BrowserServerBackend(config, extensionContextFactory)
         };
         await mcpServer.start(serverBackendFactory, config.server);
         return;
     }
     if (options.vscode) {
-        await runVSCodeTools(config);
-        return;
-    }
-    if (options.loopTools) {
-        await runLoopTools(config);
+        await (0, host_1.runVSCodeTools)(config);
         return;
     }
     if (options.connectTool) {
@@ -90,19 +119,19 @@ program
             {
                 name: 'default',
                 description: 'Starts standalone browser',
-                connect: () => mcpServer.wrapInProcess(new BrowserServerBackend(config, browserContextFactory)),
+                connect: () => mcpServer.wrapInProcess(new browserServerBackend_1.BrowserServerBackend(config, browserContextFactory)),
             },
             {
                 name: 'extension',
                 description: 'Connect to a browser using the Playwright MCP extension',
-                connect: () => mcpServer.wrapInProcess(new BrowserServerBackend(config, extensionContextFactory)),
+                connect: () => mcpServer.wrapInProcess(new browserServerBackend_1.BrowserServerBackend(config, extensionContextFactory)),
             },
         ];
         const factory = {
             name: 'Playwright w/ switch',
             nameInConfig: 'playwright-switch',
-            version: packageJSON.version,
-            create: () => new ProxyBackend(providers),
+            version: package_1.packageJSON.version,
+            create: () => new proxyBackend_1.ProxyBackend(providers),
         };
         await mcpServer.start(factory, config.server);
         return;
@@ -110,8 +139,8 @@ program
     const factory = {
         name: 'Playwright',
         nameInConfig: 'playwright',
-        version: packageJSON.version,
-        create: () => new BrowserServerBackend(config, browserContextFactory)
+        version: package_1.packageJSON.version,
+        create: () => new browserServerBackend_1.BrowserServerBackend(config, browserContextFactory)
     };
     await mcpServer.start(factory, config.server);
 });
@@ -122,11 +151,11 @@ function setupExitWatchdog() {
             return;
         isExiting = true;
         setTimeout(() => process.exit(0), 15000);
-        await Context.disposeAll();
+        await context_1.Context.disposeAll();
         process.exit(0);
     };
     process.stdin.on('close', handleExit);
     process.on('SIGINT', handleExit);
     process.on('SIGTERM', handleExit);
 }
-void program.parseAsync(process.argv);
+void commander_1.program.parseAsync(process.argv);

package/lib/sdk/bundle.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.z = exports.PingRequestSchema = exports.ListToolsRequestSchema = exports.ListRootsRequestSchema = exports.CallToolRequestSchema = exports.StreamableHTTPServerTransport = exports.StreamableHTTPClientTransport = exports.StdioServerTransport = exports.StdioClientTransport = exports.SSEServerTransport = exports.Server = exports.Client = exports.zodToJsonSchema = void 0;
+// @ts-ignore
+const bundle = __importStar(require("playwright/lib/mcpBundleImpl"));
+const zodToJsonSchema = bundle.zodToJsonSchema;
+exports.zodToJsonSchema = zodToJsonSchema;
+const Client = bundle.Client;
+exports.Client = Client;
+const Server = bundle.Server;
+exports.Server = Server;
+const SSEServerTransport = bundle.SSEServerTransport;
+exports.SSEServerTransport = SSEServerTransport;
+const StdioClientTransport = bundle.StdioClientTransport;
+exports.StdioClientTransport = StdioClientTransport;
+const StdioServerTransport = bundle.StdioServerTransport;
+exports.StdioServerTransport = StdioServerTransport;
+const StreamableHTTPServerTransport = bundle.StreamableHTTPServerTransport;
+exports.StreamableHTTPServerTransport = StreamableHTTPServerTransport;
+const StreamableHTTPClientTransport = bundle.StreamableHTTPClientTransport;
+exports.StreamableHTTPClientTransport = StreamableHTTPClientTransport;
+const CallToolRequestSchema = bundle.CallToolRequestSchema;
+exports.CallToolRequestSchema = CallToolRequestSchema;
+const ListRootsRequestSchema = bundle.ListRootsRequestSchema;
+exports.ListRootsRequestSchema = ListRootsRequestSchema;
+const ListToolsRequestSchema = bundle.ListToolsRequestSchema;
+exports.ListToolsRequestSchema = ListToolsRequestSchema;
+const PingRequestSchema = bundle.PingRequestSchema;
+exports.PingRequestSchema = PingRequestSchema;
+const z = bundle.z;
+exports.z = z;

package/lib/{mcp → sdk}/http.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Copyright (c) Microsoft Corporation.
  *
@@ -13,21 +14,60 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import assert from 'assert';
-import http from 'http';
-import crypto from 'crypto';
-import debug from 'debug';
-import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
-import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-import * as mcpServer from './server.js';
-const testDebug = debug('pw:mcp:test');
-export async function startHttpServer(config, abortSignal) {
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startHttpServer = startHttpServer;
+exports.httpAddressToString = httpAddressToString;
+exports.installHttpTransport = installHttpTransport;
+const assert_1 = __importDefault(require("assert"));
+const http_1 = __importDefault(require("http"));
+const crypto_1 = __importDefault(require("crypto"));
+const debug_1 = __importDefault(require("debug"));
+const mcpBundle = __importStar(require("./bundle"));
+const mcpServer = __importStar(require("./server"));
+const testDebug = (0, debug_1.default)('pw:mcp:test');
+async function startHttpServer(config, abortSignal) {
     const { host, port } = config;
-    const httpServer = http.createServer();
+    const httpServer = http_1.default.createServer();
     decorateServer(httpServer);
     await new Promise((resolve, reject) => {
         httpServer.on('error', reject);
-        abortSignal?.addEventListener('abort', () => {
+        abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.addEventListener('abort', () => {
             httpServer.close();
             reject(new Error('Aborted'));
         });
@@ -38,8 +78,8 @@ export async function startHttpServer(config, abortSignal) {
     });
     return httpServer;
 }
-export function httpAddressToString(address) {
-    assert(address, 'Could not bind server socket');
+function httpAddressToString(address) {
+    (0, assert_1.default)(address, 'Could not bind server socket');
     if (typeof address === 'string')
         return address;
     const resolvedPort = address.port;
@@ -48,7 +88,7 @@ export function httpAddressToString(address) {
         resolvedHost = 'localhost';
     return `http://${resolvedHost}:${resolvedPort}`;
 }
-export async function installHttpTransport(httpServer, serverBackendFactory) {
+async function installHttpTransport(httpServer, serverBackendFactory) {
     const sseSessions = new Map();
     const streamableSessions = new Map();
     httpServer.on('request', async (req, res) => {
@@ -74,7 +114,7 @@ async function handleSSE(serverBackendFactory, req, res, url, sessions) {
         return await transport.handlePostMessage(req, res);
     }
     else if (req.method === 'GET') {
-        const transport = new SSEServerTransport('/sse', res);
+        const transport = new mcpBundle.SSEServerTransport('/sse', res);
         sessions.set(transport.sessionId, transport);
         testDebug(`create SSE session: ${transport.sessionId}`);
         await mcpServer.connect(serverBackendFactory, transport, false);
@@ -99,8 +139,8 @@ async function handleStreamable(serverBackendFactory, req, res, sessions) {
         return await transport.handleRequest(req, res);
     }
     if (req.method === 'POST') {
-        const transport = new StreamableHTTPServerTransport({
-            sessionIdGenerator: () => crypto.randomUUID(),
+        const transport = new mcpBundle.StreamableHTTPServerTransport({
+            sessionIdGenerator: () => crypto_1.default.randomUUID(),
             onsessioninitialized: async (sessionId) => {
                 testDebug(`create http session: ${transport.sessionId}`);
                 await mcpServer.connect(serverBackendFactory, transport, true);

package/lib/{mcp → sdk}/inProcessTransport.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Copyright (c) Microsoft Corporation.
  *
@@ -13,11 +14,11 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export class InProcessTransport {
-    _server;
-    _serverTransport;
-    _connected = false;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InProcessTransport = void 0;
+class InProcessTransport {
     constructor(server) {
+        this._connected = false;
         this._server = server;
         this._serverTransport = new InProcessServerTransport(this);
     }
@@ -33,23 +34,20 @@ export class InProcessTransport {
         this._serverTransport._receiveFromClient(message);
     }
     async close() {
+        var _a, _b, _c;
         if (this._connected) {
             this._connected = false;
-            this.onclose?.();
-            this._serverTransport.onclose?.();
+            (_a = this.onclose) === null || _a === void 0 ? void 0 : _a.call(this);
+            (_c = (_b = this._serverTransport).onclose) === null || _c === void 0 ? void 0 : _c.call(_b);
         }
     }
-    onclose;
-    onerror;
-    onmessage;
-    sessionId;
-    setProtocolVersion;
     _receiveFromServer(message, extra) {
-        this.onmessage?.(message, extra);
+        var _a;
+        (_a = this.onmessage) === null || _a === void 0 ? void 0 : _a.call(this, message, extra);
     }
 }
+exports.InProcessTransport = InProcessTransport;
 class InProcessServerTransport {
-    _clientTransport;
     constructor(clientTransport) {
         this._clientTransport = clientTransport;
     }
@@ -59,14 +57,11 @@ class InProcessServerTransport {
         this._clientTransport._receiveFromServer(message);
     }
     async close() {
-        this.onclose?.();
+        var _a;
+        (_a = this.onclose) === null || _a === void 0 ? void 0 : _a.call(this);
     }
-    onclose;
-    onerror;
-    onmessage;
-    sessionId;
-    setProtocolVersion;
     _receiveFromClient(message) {
-        this.onmessage?.(message);
+        var _a;
+        (_a = this.onmessage) === null || _a === void 0 ? void 0 : _a.call(this, message);
     }
 }

package/lib/{mcp → sdk}/manualPromise.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Copyright (c) Microsoft Corporation.
  *
@@ -13,10 +14,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export class ManualPromise extends Promise {
-    _resolve;
-    _reject;
-    _isDone;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LongStandingScope = exports.ManualPromise = void 0;
+class ManualPromise extends Promise {
     constructor() {
         let resolve;
         let reject;
@@ -46,11 +46,12 @@ export class ManualPromise extends Promise {
         return 'ManualPromise';
     }
 }
-export class LongStandingScope {
-    _terminateError;
-    _closeError;
-    _terminatePromises = new Map();
-    _isClosed = false;
+exports.ManualPromise = ManualPromise;
+class LongStandingScope {
+    constructor() {
+        this._terminatePromises = new Map();
+        this._isClosed = false;
+    }
     reject(error) {
         this._isClosed = true;
         this._terminateError = error;
@@ -94,6 +95,7 @@ export class LongStandingScope {
         }
     }
 }
+exports.LongStandingScope = LongStandingScope;
 function cloneError(error, frames) {
     const clone = new Error();
     clone.name = error.name;