@playwright/mcp 0.0.31 → 0.0.32

package/lib/tools/wait.js

@@ -28,7 +28,7 @@ const wait = defineTool({
         }),
         type: 'readOnly',
     },
-    handle: async (context, params) => {
+    handle: async (context, params, response) => {
         if (!params.text && !params.textGone && !params.time)
             throw new Error('Either time, text or textGone must be provided');
         const code = [];
@@ -47,11 +47,8 @@ const wait = defineTool({
             code.push(`await page.getByText(${JSON.stringify(params.text)}).first().waitFor({ state: 'visible' });`);
             await locator.waitFor({ state: 'visible' });
         }
-        return {
-            code,
-            captureSnapshot: true,
-            waitForNetwork: false,
-        };
+        response.addResult(`Waited for ${params.text || params.textGone || params.time}`);
+        response.setIncludeSnapshot();
     },
 });
 export default [

package/lib/tools.js

@@ -45,3 +45,6 @@ export const allTools = [
     ...tabs,
     ...wait,
 ];
+export function filteredTools(config) {
+    return allTools.filter(tool => tool.capability.startsWith('core') || config.capabilities?.includes(tool.capability));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playwright/mcp",
-  "version": "0.0.31",
+  "version": "0.0.32",
   "description": "Playwright Tools for MCP",
   "type": "module",
   "repository": {
@@ -17,15 +17,18 @@
   "license": "Apache-2.0",
   "scripts": {
     "build": "tsc",
+    "build:extension": "tsc --project extension",
     "lint": "npm run update-readme && eslint . && tsc --noEmit",
+    "lint-fix": "eslint . --fix",
     "update-readme": "node utils/update-readme.js",
     "watch": "tsc --watch",
+    "watch:extension": "tsc --watch --project extension",
     "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",
+    "clean": "rm -rf lib extension/lib",
     "npm-publish": "npm run clean && npm run build && npm run test && npm publish"
   },
   "exports": {
@@ -36,9 +39,10 @@
     }
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.11.0",
+    "@modelcontextprotocol/sdk": "^1.16.0",
     "commander": "^13.1.0",
     "debug": "^4.4.1",
+    "dotenv": "^17.2.0",
     "mime": "^4.0.7",
     "playwright": "1.55.0-alpha-1752701791000",
     "playwright-core": "1.55.0-alpha-1752701791000",
@@ -46,6 +50,7 @@
     "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-1752701791000",
@@ -60,6 +65,7 @@
     "eslint": "^9.19.0",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-notice": "^1.0.0",
+    "openai": "^5.10.2",
     "typescript": "^5.8.2"
   },
   "bin": {

package/lib/connection.js

@@ -1,81 +0,0 @@
-/**
- * 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.
- */
-import { Server as McpServer } from '@modelcontextprotocol/sdk/server/index.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-import { Context } from './context.js';
-import { allTools } from './tools.js';
-import { packageJSON } from './package.js';
-export function createConnection(config, browserContextFactory) {
-    const tools = allTools.filter(tool => tool.capability.startsWith('core') || config.capabilities?.includes(tool.capability));
-    const context = new Context(tools, config, browserContextFactory);
-    const server = new McpServer({ name: 'Playwright', version: packageJSON.version }, {
-        capabilities: {
-            tools: {},
-        }
-    });
-    server.setRequestHandler(ListToolsRequestSchema, async () => {
-        return {
-            tools: tools.map(tool => ({
-                name: tool.schema.name,
-                description: tool.schema.description,
-                inputSchema: zodToJsonSchema(tool.schema.inputSchema),
-                annotations: {
-                    title: tool.schema.title,
-                    readOnlyHint: tool.schema.type === 'readOnly',
-                    destructiveHint: tool.schema.type === 'destructive',
-                    openWorldHint: true,
-                },
-            })),
-        };
-    });
-    server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        const errorResult = (...messages) => ({
-            content: [{ type: 'text', text: messages.join('\n') }],
-            isError: true,
-        });
-        const tool = tools.find(tool => tool.schema.name === request.params.name);
-        if (!tool)
-            return errorResult(`Tool "${request.params.name}" not found`);
-        const modalStates = context.modalStates().map(state => state.type);
-        if (tool.clearsModalState && !modalStates.includes(tool.clearsModalState))
-            return errorResult(`The tool "${request.params.name}" can only be used when there is related modal state present.`, ...context.modalStatesMarkdown());
-        if (!tool.clearsModalState && modalStates.length)
-            return errorResult(`Tool "${request.params.name}" does not handle the modal state.`, ...context.modalStatesMarkdown());
-        try {
-            return await context.run(tool, request.params.arguments);
-        }
-        catch (error) {
-            return errorResult(String(error));
-        }
-    });
-    return new Connection(server, context);
-}
-export class Connection {
-    server;
-    context;
-    constructor(server, context) {
-        this.server = server;
-        this.context = context;
-        this.server.oninitialized = () => {
-            this.context.clientVersion = this.server.getClientVersion();
-        };
-    }
-    async close() {
-        await this.server.close();
-        await this.context.close();
-    }
-}

package/lib/pageSnapshot.js

@@ -1,43 +0,0 @@
-/**
- * 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.
- */
-import { callOnPageNoTrace } from './tools/utils.js';
-export class PageSnapshot {
-    _page;
-    _text;
-    constructor(page) {
-        this._page = page;
-    }
-    static async create(page) {
-        const snapshot = new PageSnapshot(page);
-        await snapshot._build();
-        return snapshot;
-    }
-    text() {
-        return this._text;
-    }
-    async _build() {
-        const snapshot = await callOnPageNoTrace(this._page, page => page._snapshotForAI());
-        this._text = [
-            `- Page Snapshot:`,
-            '```yaml',
-            snapshot,
-            '```',
-        ].join('\n');
-    }
-    refLocator(params) {
-        return this._page.locator(`aria-ref=${params.ref}`).describe(params.element);
-    }
-}

package/lib/server.js

@@ -1,48 +0,0 @@
-/**
- * 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.
- */
-import { createConnection } from './connection.js';
-import { contextFactory } from './browserContextFactory.js';
-export class Server {
-    config;
-    _connectionList = [];
-    _browserConfig;
-    _contextFactory;
-    constructor(config) {
-        this.config = config;
-        this._browserConfig = config.browser;
-        this._contextFactory = contextFactory(this._browserConfig);
-    }
-    async createConnection(transport) {
-        const connection = createConnection(this.config, this._contextFactory);
-        this._connectionList.push(connection);
-        await connection.server.connect(transport);
-        return connection;
-    }
-    setupExitWatchdog() {
-        let isExiting = false;
-        const handleExit = async () => {
-            if (isExiting)
-                return;
-            isExiting = true;
-            setTimeout(() => process.exit(0), 15000);
-            await Promise.all(this._connectionList.map(connection => connection.close()));
-            process.exit(0);
-        };
-        process.stdin.on('close', handleExit);
-        process.on('SIGINT', handleExit);
-        process.on('SIGTERM', handleExit);
-    }
-}