@playwright-repl/mcp 0.18.1 → 0.20.0

package/README.md

@@ -1,6 +1,10 @@
 # @playwright-repl/mcp
 
-MCP server that lets AI agents (Claude Desktop, Claude Code, or any MCP client) control your real Chrome browser through the **Dramaturg** Chrome extension.
+MCP server that lets AI agents (Claude Desktop, Claude Code, or any MCP client) automate a browser using playwright-repl keyword commands.
+
+Two modes:
+- **Bridge mode** (default) — controls your real Chrome browser through the **Dramaturg** Chrome extension
+- **Standalone mode** (`--standalone`) — launches its own browser via Playwright, no extension needed
 
 ## Why
 
@@ -31,6 +35,8 @@ It consists of two parts working together: **Dramaturg** (a Chrome extension tha
 
 ## Architecture
 
+### Bridge mode (default)
+
 ```
 Claude Desktop / Claude Code (or any MCP client)
   ↕ MCP (stdio)
@@ -41,6 +47,18 @@ Chrome extension (offscreen document → service worker)
 Playwright running in your real Chrome session
 ```
 
+### Standalone mode (`--standalone`)
+
+```
+Claude Desktop / Claude Code (or any MCP client)
+  ↕ MCP (stdio)
+playwright-repl MCP server
+  ↕ Engine.run() (in-process)
+Playwright BrowserServerBackend
+  ↕ CDP
+Browser (launched by Playwright)
+```
+
 ## Setup
 
 ### 1. Install the MCP server
@@ -49,12 +67,23 @@ Playwright running in your real Chrome session
 npm install -g @playwright-repl/mcp
 ```
 
-### 2. Install Dramaturg (Chrome extension)
+### 2. Choose a mode
+
+#### Bridge mode (default) — use your real Chrome session
+
+Install Dramaturg (Chrome extension):
 
 Load `packages/extension/dist/` as an unpacked extension in Chrome (`chrome://extensions` → Enable Developer mode → Load unpacked).
 
 Or install from the [Chrome Web Store](https://chromewebstore.google.com/detail/dramaturg/ppbkmncnmjkfppilnmplpokdfagobipa).
 
+#### Standalone mode — no extension needed
+
+Add `--standalone` to the MCP server command. The server launches its own browser via Playwright.
+
+- Default: headless. Add `--headed` to show the browser window.
+- Only `.pw` keyword commands are supported (no raw Playwright API or JavaScript expressions). Use `run-code` or `eval` keywords within `.pw` mode for Playwright API / JS.
+
 ### 3. Configure your MCP client
 
 **Claude Desktop** — add to `claude_desktop_config.json`:
@@ -62,6 +91,8 @@ Or install from the [Chrome Web Store](https://chromewebstore.google.com/detail/
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
 
+Bridge mode:
+
 ```json
 {
   "mcpServers": {
@@ -72,17 +103,36 @@ Or install from the [Chrome Web Store](https://chromewebstore.google.com/detail/
 }
 ```
 
+Standalone mode:
+
+```json
+{
+  "mcpServers": {
+    "playwright-repl": {
+      "command": "playwright-repl-mcp",
+      "args": ["--standalone", "--headed"]
+    }
+  }
+}
+```
+
 Restart Claude Desktop after saving.
 
 **Claude Code** — run once in a terminal:
 
 ```bash
+# Bridge mode
 claude mcp add playwright-repl playwright-repl-mcp
+
+# Standalone mode
+claude mcp add playwright-repl playwright-repl-mcp -- --standalone --headed
 ```
 
 ### 4. Connect
 
-The extension connects to the MCP server automatically — no need to open the side panel. Just make sure Chrome is running with the Dramaturg extension installed.
+**Bridge mode:** The extension connects to the MCP server automatically — no need to open the side panel. Just make sure Chrome is running with the Dramaturg extension installed.
+
+**Standalone mode:** The browser launches automatically on the first command. No extension needed.
 
 ## Dramaturg — The Extension
 
@@ -113,10 +163,10 @@ When the extension is connected, the MCP server logs `Extension connected` to st
 
 ## Tool: `run_command`
 
-One tool, two input modes:
-
 ### Keyword commands (`.pw` syntax)
 
+Both modes support `.pw` keyword commands:
+
 ```
 snapshot                              # accessibility tree — always start here
 goto https://example.com             # navigate
@@ -125,13 +175,14 @@ fill "Email" user@example.com        # fill a form field
 press Enter                          # key press
 verify-text Welcome                  # assert text is visible
 screenshot                           # capture page (returned as image to AI)
-scroll-down                          # scroll
 check "Remember me"                  # check a checkbox
 select "Country" "United States"     # select dropdown option
 localstorage-list                    # list localStorage
 ```
 
-### Playwright API / JavaScript
+### Playwright API / JavaScript (bridge mode only)
+
+In bridge mode, `run_command` also accepts raw Playwright expressions and JavaScript:
 
 ```
 await page.url()
@@ -142,13 +193,16 @@ await page.evaluate(() => document.title)
 await page.evaluate(() => document.querySelectorAll('a').length)
 ```
 
+> In standalone mode, use the `run-code` or `eval` keywords to run Playwright API / JavaScript:
+> `run-code await page.url()` or `eval document.title`.
+
 ## Tool: `run_script`
 
-Batch execution for multi-line scripts. Two language modes:
+Batch execution for multi-line scripts.
 
 ### Keyword script (`language="pw"`)
 
-Splits by line, runs each command sequentially, returns ✓/✗ per line:
+Splits by line, runs each command sequentially, returns ✓/✗ per line. Lines starting with `#` are skipped. Stops on first error.
 
 ```
 goto https://demo.playwright.dev/todomvc/
@@ -157,7 +211,9 @@ press Enter
 verify-text "Buy groceries"
 ```
 
-### JavaScript (`language="javascript"`)
+> In standalone mode, `run_script` only accepts `.pw` keyword scripts (no `language` parameter needed).
+
+### JavaScript (`language="javascript"`) — bridge mode only
 
 Runs the entire block as one evaluation — use for Playwright API with assertions:
 
@@ -168,20 +224,6 @@ await page.keyboard.press('Enter');
 await expect(page.getByText('Buy groceries')).toBeVisible();
 ```
 
-## Prompt: `generate-test`
-
-A prompt template that guides the AI to generate a passing Playwright test from a described scenario.
-
-**Args:**
-- `steps` (required) — describe the test scenario, e.g. "log in with email/password, verify the dashboard loads". Also accepts pasted `.pw` scripts.
-- `url` (optional) — URL to navigate to first.
-
-**In Claude Desktop:** click "+" → select `generate-test` → fill in the form → send.
-
-**In Claude Code:** `/mcp__playwright-repl__generate-test`
-
-The AI navigates the page, takes snapshots, writes Playwright assertions, runs them via `run_script(language="javascript")`, and iterates until all pass.
-
 ## AI Agents
 
 The MCP package includes four ready-to-use AI agents in `packages/mcp/agents/`:

package/dist/bridge.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Bridge runner — connects to Chrome via the Dramaturg extension over WebSocket.
+ */
+import type { RunnerModule, SnapshotCache } from './types.js';
+export declare const descriptions: {
+    readonly runCommandInput: "A keyword command ('snapshot', 'goto https://example.com', 'click Submit', 'fill \"Email\" user@example.com') or a Playwright expression ('await page.url()')";
+    readonly runCommand: "Run a command in the connected Chrome browser. Supports two input modes:\n\n1. KEYWORD (.pw) — playwright-repl commands:\n   snapshot, goto <url>, click <text>, fill <label> <value>, press <key>,\n   verify-text <text>, verify-no-text <text>, screenshot,\n   check <label>, select <label> <value>, localstorage-list, localstorage-clear\n\n2. PLAYWRIGHT — Playwright API (page.* / crxApp.*):\n   await page.url(), await page.title(),\n   await page.locator('button').count(),\n   await page.evaluate(() => document.title)\n\nUpdate commands (click, fill, goto, press, hover, select, check, uncheck, etc.) automatically include a snapshot of the page after the action. You do NOT need to call snapshot separately after these commands.\n\nUse snapshot only for initial exploration or after read-only commands. Use screenshot to visually verify the current state.\n\nIMPORTANT: Before writing .pw commands, run 'help' to get the full list of available commands. Only use commands that appear in the help output. Do not invent commands.";
+    readonly runScript: "Run a multi-line script, returning combined pass/fail results.\nUseful for replaying a known script without per-step round trips.\nPrefer run_command for AI-driven exploration where you need to observe and adapt after each step.\n\nlanguage='pw': each line is a .pw keyword command, run sequentially. Lines starting with # are skipped. Stops on first error.\nlanguage='javascript': the entire script is run as a single JavaScript/Playwright block.\n\nIMPORTANT: Only use commands listed by 'help'. Run run_command('help') first if unsure which commands are available.";
+    readonly scriptOnly: false;
+};
+export declare function createBridgeRunner(argv: string[], snapshotCache: SnapshotCache): Promise<RunnerModule>;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG9D,eAAO,MAAM,YAAY;;;;;CAgCf,CAAC;AAEX,wBAAsB,kBAAkB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,aAAa,EAAE,aAAa,GAC7B,OAAO,CAAC,YAAY,CAAC,CA0DvB"}

package/dist/bridge.js

@@ -0,0 +1,92 @@
+/**
+ * Bridge runner — connects to Chrome via the Dramaturg extension over WebSocket.
+ */
+import { BridgeServer, UPDATE_COMMANDS, parseInput } from '@playwright-repl/core';
+import { logEvent } from './logger.js';
+export const descriptions = {
+    runCommandInput: `A keyword command ('snapshot', 'goto https://example.com', 'click Submit', \
+'fill "Email" user@example.com') or a Playwright expression ('await page.url()')`,
+    runCommand: `Run a command in the connected Chrome browser. Supports two input modes:
+
+1. KEYWORD (.pw) — playwright-repl commands:
+   snapshot, goto <url>, click <text>, fill <label> <value>, press <key>,
+   verify-text <text>, verify-no-text <text>, screenshot,
+   check <label>, select <label> <value>, localstorage-list, localstorage-clear
+
+2. PLAYWRIGHT — Playwright API (page.* / crxApp.*):
+   await page.url(), await page.title(),
+   await page.locator('button').count(),
+   await page.evaluate(() => document.title)
+
+Update commands (click, fill, goto, press, hover, select, check, uncheck, etc.) automatically include a snapshot of the page after the action. You do NOT need to call snapshot separately after these commands.
+
+Use snapshot only for initial exploration or after read-only commands. Use screenshot to visually verify the current state.
+
+IMPORTANT: Before writing .pw commands, run 'help' to get the full list of available commands. Only use commands that appear in the help output. Do not invent commands.`,
+    runScript: `Run a multi-line script, returning combined pass/fail results.
+Useful for replaying a known script without per-step round trips.
+Prefer run_command for AI-driven exploration where you need to observe and adapt after each step.
+
+language='pw': each line is a .pw keyword command, run sequentially. Lines starting with # are skipped. Stops on first error.
+language='javascript': the entire script is run as a single JavaScript/Playwright block.
+
+IMPORTANT: Only use commands listed by 'help'. Run run_command('help') first if unsure which commands are available.`,
+    scriptOnly: false,
+};
+export async function createBridgeRunner(argv, snapshotCache) {
+    const portIdx = argv.indexOf('--port');
+    const port = portIdx !== -1
+        ? parseInt(argv[portIdx + 1])
+        : (process.env.BRIDGE_PORT ? parseInt(process.env.BRIDGE_PORT) : 9876);
+    const srv = new BridgeServer();
+    try {
+        await srv.start(port);
+    }
+    catch (err) {
+        if (err?.code === 'EADDRINUSE') {
+            console.error(`Error: port ${port} is already in use. Another playwright-repl bridge or MCP inspector may be running. Stop it and restart Claude Desktop.`);
+            process.exit(1);
+        }
+        throw err;
+    }
+    console.error(`playwright-repl bridge listening on ws://localhost:${port}`);
+    logEvent(`Bridge listening on ws://localhost:${port}`);
+    srv.onConnect(() => { console.error('Extension connected'); logEvent('Extension connected'); });
+    srv.onDisconnect(() => { console.error('Extension disconnected'); logEvent('Extension disconnected'); });
+    return {
+        descriptions,
+        runner: {
+            async runCommand(command) {
+                if (!srv.connected) {
+                    return { text: 'Browser not connected. Open Chrome with the playwright-repl extension — it connects automatically.', isError: true };
+                }
+                // Determine command name for snapshot logic
+                const parsed = parseInput(command);
+                const cmdName = parsed?._[0];
+                const isUpdate = cmdName !== undefined && UPDATE_COMMANDS.has(cmdName);
+                // Request snapshot in the same round-trip for update commands
+                const result = await srv.run(command, isUpdate ? { includeSnapshot: true } : undefined);
+                if (result.isError)
+                    return result;
+                // Cache snapshot (from explicit snapshot command or appended by handler)
+                if (result.text) {
+                    const snapMatch = result.text.match(/### Snapshot\n([\s\S]+)$/);
+                    if (snapMatch) {
+                        snapshotCache.value = { url: '', snapshotString: snapMatch[1].trim() };
+                    }
+                    else if (cmdName === 'snapshot') {
+                        snapshotCache.value = { url: '', snapshotString: result.text.trim() };
+                    }
+                }
+                return result;
+            },
+            async runScript(script, language) {
+                if (!srv.connected) {
+                    return { text: 'Browser not connected. Open Chrome with the playwright-repl extension — it connects automatically.', isError: true };
+                }
+                return srv.runScript(script, language);
+            },
+        },
+    };
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -2,71 +2,44 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-import { BridgeServer, COMMANDS, CATEGORIES, refToLocator } from '@playwright-repl/core';
+import { COMMANDS, CATEGORIES, refToLocator } from '@playwright-repl/core';
 import pkg from '../package.json' with { type: 'json' };
+import { createBridgeRunner } from './bridge.js';
+import { createStandaloneRunner } from './standalone.js';
+import { logStartup, logEvent, logToolCall, logToolResult, logError, LOG_FILE } from './logger.js';
 const argv = process.argv.slice(2);
-const portIdx = argv.indexOf('--port');
-const port = portIdx !== -1
-    ? parseInt(argv[portIdx + 1])
-    : (process.env.BRIDGE_PORT ? parseInt(process.env.BRIDGE_PORT) : 9876);
-const srv = new BridgeServer();
-let lastSnapshot = null;
-try {
-    await srv.start(port);
-}
-catch (err) {
-    if (err?.code === 'EADDRINUSE') {
-        console.error(`Error: port ${port} is already in use. Another playwright-repl bridge or MCP inspector may be running. Stop it and restart Claude Desktop.`);
-        process.exit(1);
-    }
-    throw err;
-}
-console.error(`playwright-repl bridge listening on ws://localhost:${port}`);
-srv.onConnect(() => console.error('Extension connected'));
-srv.onDisconnect(() => console.error('Extension disconnected'));
-const RUN_COMMAND_INPUT_DESCRIPTION = `\
-A keyword command ('snapshot', 'goto https://example.com', 'click Submit', \
-'fill "Email" user@example.com'), a Playwright expression \
-('await page.url()'), or a JavaScript expression ('document.title')`;
-const RUN_COMMAND_DESCRIPTION = `\
-Run a command in the connected Chrome browser. Supports three input modes:
-
-1. KEYWORD (.pw) — playwright-repl commands:
-   snapshot, goto <url>, click <text>, fill <label> <value>, press <key>,
-   verify-text <text>, verify-no-text <text>, screenshot, scroll-down,
-   check <label>, select <label> <value>, localstorage-list, localstorage-clear
-
-2. PLAYWRIGHT — Playwright API (page.* / crxApp.*):
-   await page.url(), await page.title(),
-   await page.locator('button').count()
-
-3. JAVASCRIPT — any JS expression evaluated in the browser:
-   document.title, window.location.href,
-   document.querySelectorAll('a').length
-
-Use snapshot to understand the page structure before interacting. Use screenshot to visually verify the current state.
-
-IMPORTANT: Before writing .pw commands, run 'help' to get the full list of available commands. Only use commands that appear in the help output. Do not invent commands.`;
+const standalone = argv.includes('--standalone');
+const headed = argv.includes('--headed');
+const snapshotCache = { value: null };
+// ─── Create runner ───────────────────────────────────────────────────────────
+const { runner, descriptions } = standalone
+    ? createStandaloneRunner(headed, snapshotCache)
+    : await createBridgeRunner(argv, snapshotCache);
+logStartup(standalone ? 'standalone' : 'bridge', `log → ${LOG_FILE}`);
+// ─── MCP server ──────────────────────────────────────────────────────────────
 const server = new McpServer({ name: 'playwright-repl', version: pkg.version });
 server.registerTool('run_command', {
-    description: RUN_COMMAND_DESCRIPTION,
+    description: descriptions.runCommand,
     inputSchema: {
-        command: z.string().describe(RUN_COMMAND_INPUT_DESCRIPTION),
+        command: z.string().describe(descriptions.runCommandInput),
     },
 }, async ({ command }) => {
+    const start = Date.now();
+    logToolCall('run_command', { command });
     const trimmed = command.trim().toLowerCase();
     if (trimmed === 'help') {
         const lines = Object.entries(CATEGORIES)
             .map(([cat, cmds]) => `  ${cat}: ${cmds.join(', ')}`)
             .join('\n');
+        logToolResult('run_command', false, 'help', Date.now() - start);
         return { content: [{ type: 'text', text: `Available commands:\n${lines}\n\nType "help <command>" for details.` }] };
     }
     if (trimmed.startsWith('locator ')) {
         const ref = command.trim().slice(8).trim();
-        if (!lastSnapshot) {
+        if (!snapshotCache.value) {
             return { content: [{ type: 'text', text: 'No snapshot cached. Run "snapshot" first.' }], isError: true };
         }
-        const locator = refToLocator(lastSnapshot.snapshotString, ref);
+        const locator = refToLocator(snapshotCache.value.snapshotString, ref);
         if (!locator) {
             return { content: [{ type: 'text', text: `Ref "${ref}" not found in last snapshot. Run "snapshot" to refresh.` }], isError: true };
         }
@@ -88,95 +61,55 @@ server.registerTool('run_command', {
         }
         return { content: [{ type: 'text', text: parts.join('\n') }] };
     }
-    if (!srv.connected) {
+    try {
+        const result = await runner.runCommand(command);
+        logToolResult('run_command', !!result.isError, result.text, Date.now() - start);
+        if (result.image) {
+            const [header, data] = result.image.split(',');
+            const mimeType = (header.match(/data:(.*);base64/) ?? [])[1] ?? 'image/png';
+            return { content: [{ type: 'image', data, mimeType }] };
+        }
         return {
-            content: [{ type: 'text', text: 'Browser not connected. Open Chrome with the playwright-repl extension — it connects automatically.' }],
-            isError: true,
+            content: [{ type: 'text', text: result.text || 'Done' }],
+            isError: result.isError,
         };
     }
-    const result = await srv.run(command);
-    // Cache snapshot for locator command
-    // Bridge mode: snapshot returns raw YAML (no ### headers)
-    if (trimmed.startsWith('snapshot') && result.text && !result.isError) {
-        lastSnapshot = { url: '', snapshotString: result.text.trim() };
+    catch (err) {
+        logError('run_command', err);
+        throw err;
     }
-    if (result.image) {
-        const [header, data] = result.image.split(',');
-        const mimeType = (header.match(/data:(.*);base64/) ?? [])[1] ?? 'image/png';
-        return { content: [{ type: 'image', data, mimeType }] };
-    }
-    return {
-        content: [{ type: 'text', text: result.text || 'Done' }],
-        isError: result.isError,
-    };
 });
-const RUN_SCRIPT_DESCRIPTION = `\
-Run a multi-line script, returning combined pass/fail results.
-Useful for replaying a known script without per-step round trips.
-Prefer run_command for AI-driven exploration where you need to observe and adapt after each step.
-
-language='pw': each line is a .pw keyword command, run sequentially. Lines starting with # are skipped. Stops on first error.
-language='javascript': the entire script is run as a single JavaScript/Playwright block.
-
-IMPORTANT: Only use commands listed by 'help'. Run run_command('help') first if unsure which commands are available.`;
 server.registerTool('run_script', {
-    description: RUN_SCRIPT_DESCRIPTION,
-    inputSchema: {
-        script: z.string().describe('The script to execute'),
-        language: z.enum(['pw', 'javascript']).describe("'pw' for keyword commands (one per line), 'javascript' for a JS/Playwright block"),
-    },
-}, async ({ script, language }) => {
-    if (!srv.connected) {
+    description: descriptions.runScript,
+    inputSchema: descriptions.scriptOnly
+        ? { script: z.string().describe('The .pw keyword script to execute (one command per line)') }
+        : {
+            script: z.string().describe('The script to execute'),
+            language: z.enum(['pw', 'javascript']).describe("'pw' for keyword commands (one per line), 'javascript' for a JS/Playwright block"),
+        },
+}, async (params) => {
+    const start = Date.now();
+    const script = params.script;
+    const language = params.language || 'pw';
+    logToolCall('run_script', { language, script });
+    try {
+        const result = await runner.runScript(script, language);
+        logToolResult('run_script', !!result.isError, result.text, Date.now() - start);
         return {
-            content: [{ type: 'text', text: 'Browser not connected. Open Chrome with the playwright-repl extension — it connects automatically.' }],
-            isError: true,
+            content: [{ type: 'text', text: result.text || 'Done' }],
+            isError: result.isError,
         };
     }
-    const result = await srv.runScript(script, language);
-    return {
-        content: [{ type: 'text', text: result.text || 'Done' }],
-        isError: result.isError,
-    };
+    catch (err) {
+        logError('run_script', err);
+        throw err;
+    }
 });
-const GENERATE_TEST_PROMPT = (steps, url) => `\
-Generate a passing Playwright test for the following scenario:
-${steps}
-
-Workflow:
-0. Run run_command('help') to see all available keyword commands. Only use commands from this list — do not invent commands.
-1. ${url ? `Navigate to ${url} using run_command('goto ${url}').` : 'Navigate to the target URL using run_command.'}
-2. Take a snapshot using run_command('snapshot') to understand the page structure.
-3. Interact with the page as needed (click, fill, press) using run_command.
-4. After each interaction, take another snapshot to verify the state before asserting.
-5. Write assertions using \`expect\`.
-
-Example pattern:
-  await page.goto('https://example.com');
-  await expect(page).toHaveTitle('Example', { exact: true });
-  await expect(page.getByRole('heading', { name: 'Welcome' })).toBeVisible();
-  await page.getByRole('link', { name: 'Get started', exact: true }).click();
-  await expect(page.getByRole('heading', { name: 'Installation' })).toBeVisible();
-
-Code constraints:
-- Use only \`page\` and \`expect\` — available as globals, do NOT import them
-- Plain \`await\` statements only — no \`import\`, no \`test()\` wrapper, no \`describe()\`
-- Use \`exact: true\` when a locator text might match multiple elements
-
-Once you have the code, run it with run_script(language="javascript").
-If any assertion fails, read the error, fix the code, and run again until all pass.
-Show the final passing code.`;
-server.registerPrompt('generate-test', {
-    description: 'Generate a passing Playwright test from a described scenario',
-    argsSchema: {
-        steps: z.string().describe('Describe the test scenario, e.g. "log in with email/password, verify the dashboard loads"'),
-        url: z.string().optional().describe('URL to navigate to first (optional)'),
-    },
-}, ({ steps, url }) => ({
-    messages: [{
-            role: 'user',
-            content: { type: 'text', text: GENERATE_TEST_PROMPT(steps, url) },
-        }],
-}));
+server.server.oninitialized = () => {
+    const client = server.server.getClientVersion();
+    if (client)
+        logEvent(`Client: ${client.name} ${client.version}`);
+};
 const transport = new StdioServerTransport();
 await server.connect(transport);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * File-based logger for the MCP server.
+ *
+ * Writes to ~/.playwright-repl/mcp.log so tool calls are visible
+ * regardless of whether the host (Claude Desktop, Claude Code, etc.)
+ * captures stderr.
+ */
+declare const LOG_FILE: string;
+export declare function logStartup(mode: string, detail: string): void;
+export declare function logEvent(event: string): void;
+export declare function logToolCall(tool: string, input: Record<string, unknown>): void;
+export declare function logToolResult(tool: string, isError: boolean, text: string | undefined, durationMs: number): void;
+export declare function logError(context: string, err: unknown): void;
+export { LOG_FILE };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,QAAA,MAAM,QAAQ,QAA2B,CAAC;AAoC1C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQ9E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAIhH;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAG5D;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/logger.js

@@ -0,0 +1,69 @@
+/**
+ * File-based logger for the MCP server.
+ *
+ * Writes to ~/.playwright-repl/mcp.log so tool calls are visible
+ * regardless of whether the host (Claude Desktop, Claude Code, etc.)
+ * captures stderr.
+ */
+import { mkdirSync, appendFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const LOG_DIR = join(homedir(), '.playwright-repl');
+const LOG_FILE = join(LOG_DIR, 'mcp.log');
+/** Maximum characters kept from a result text in the log. */
+const MAX_RESULT_LENGTH = 200;
+let enabled = true;
+try {
+    mkdirSync(LOG_DIR, { recursive: true });
+}
+catch {
+    enabled = false;
+}
+function ts() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
+function write(level, message) {
+    if (!enabled)
+        return;
+    try {
+        appendFileSync(LOG_FILE, `${ts()} [${level}] ${message}\n`);
+    }
+    catch {
+        // Silently ignore — logging should never break the server.
+    }
+}
+/** Truncate a string for log readability. */
+function truncate(text, max = MAX_RESULT_LENGTH) {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max) + `... (${text.length} chars)`;
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+export function logStartup(mode, detail) {
+    write('info', `Server started [${mode}] ${detail}`);
+}
+export function logEvent(event) {
+    write('info', event);
+}
+export function logToolCall(tool, input) {
+    const args = Object.entries(input)
+        .map(([k, v]) => {
+        const s = typeof v === 'string' ? v : JSON.stringify(v);
+        return `${k}=${truncate(s, 120)}`;
+    })
+        .join(' ');
+    write('info', `→ ${tool}(${args})`);
+}
+export function logToolResult(tool, isError, text, durationMs) {
+    const status = isError ? 'ERROR' : 'OK';
+    const summary = text ? truncate(text.replace(/\n/g, '\\n')) : '(empty)';
+    write('info', `← ${tool} [${status}] ${durationMs}ms ${summary}`);
+}
+export function logError(context, err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    write('error', `${context}: ${msg}`);
+}
+export { LOG_FILE };
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/standalone.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Standalone runner — launches a browser via Engine (in-process Playwright).
+ */
+import type { RunnerModule, SnapshotCache } from './types.js';
+export declare const descriptions: {
+    readonly runCommandInput: "A keyword command ('snapshot', 'goto https://example.com', 'click Submit', 'fill \"Email\" user@example.com')";
+    readonly runCommand: "Run a command in the browser. Supports KEYWORD (.pw) — playwright-repl commands:\n   snapshot, goto <url>, click <text>, fill <label> <value>, press <key>,\n   verify-text <text>, verify-no-text <text>, screenshot,\n   check <label>, select <label> <value>, localstorage-list, localstorage-clear\n\nUpdate commands (click, fill, goto, press, hover, select, check, uncheck, etc.) automatically include a snapshot of the page after the action. You do NOT need to call snapshot separately after these commands.\n\nUse snapshot only for initial exploration or after read-only commands. Use screenshot to visually verify the current state.\n\nIMPORTANT: Before writing .pw commands, run 'help' to get the full list of available commands. Only use commands that appear in the help output. Do not invent commands.";
+    readonly runScript: "Run a multi-line .pw keyword script, returning combined pass/fail results.\nEach line is a .pw keyword command, run sequentially. Lines starting with # are skipped. Stops on first error.\nUseful for replaying a known script without per-step round trips.\n\nIMPORTANT: Only use commands listed by 'help'. Run run_command('help') first if unsure which commands are available.";
+    readonly scriptOnly: true;
+};
+export declare function createStandaloneRunner(headed: boolean, snapshotCache: SnapshotCache): RunnerModule;
+//# sourceMappingURL=standalone.d.ts.map

package/dist/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../src/standalone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI9D,eAAO,MAAM,YAAY;;;;;CAsBf,CAAC;AAEX,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,OAAO,EACf,aAAa,EAAE,aAAa,GAC7B,YAAY,CA8Dd"}

package/dist/standalone.js

@@ -0,0 +1,87 @@
+/**
+ * Standalone runner — launches a browser via Engine (in-process Playwright).
+ */
+import { Engine, parseInput, resolveArgs, filterResponse } from '@playwright-repl/core';
+const INCLUDE_SNAPSHOT = { includeSnapshot: true };
+export const descriptions = {
+    runCommandInput: `A keyword command ('snapshot', 'goto https://example.com', 'click Submit', \
+'fill "Email" user@example.com')`,
+    runCommand: `Run a command in the browser. Supports KEYWORD (.pw) — playwright-repl commands:
+   snapshot, goto <url>, click <text>, fill <label> <value>, press <key>,
+   verify-text <text>, verify-no-text <text>, screenshot,
+   check <label>, select <label> <value>, localstorage-list, localstorage-clear
+
+Update commands (click, fill, goto, press, hover, select, check, uncheck, etc.) automatically include a snapshot of the page after the action. You do NOT need to call snapshot separately after these commands.
+
+Use snapshot only for initial exploration or after read-only commands. Use screenshot to visually verify the current state.
+
+IMPORTANT: Before writing .pw commands, run 'help' to get the full list of available commands. Only use commands that appear in the help output. Do not invent commands.`,
+    runScript: `Run a multi-line .pw keyword script, returning combined pass/fail results.
+Each line is a .pw keyword command, run sequentially. Lines starting with # are skipped. Stops on first error.
+Useful for replaying a known script without per-step round trips.
+
+IMPORTANT: Only use commands listed by 'help'. Run run_command('help') first if unsure which commands are available.`,
+    scriptOnly: true,
+};
+export function createStandaloneRunner(headed, snapshotCache) {
+    let engine = null;
+    let starting = null;
+    function ensureEngine() {
+        if (engine)
+            return Promise.resolve(engine);
+        if (!starting) {
+            const e = new Engine();
+            starting = e.start({ headed }).then(() => {
+                engine = e;
+                console.error(`playwright-repl standalone engine started (${headed ? 'headed' : 'headless'})`);
+                return e;
+            });
+        }
+        return starting;
+    }
+    async function runSingleCommand(command) {
+        const e = await ensureEngine();
+        const args = parseInput(command);
+        if (!args)
+            return { text: `Unknown command: ${command}`, isError: true };
+        const cmdName = args._[0];
+        const resolved = resolveArgs(args);
+        const result = await e.run(resolved);
+        // Cache snapshot for locator command — strip YAML code fences
+        if (result.text && !result.isError) {
+            const snapshotMatch = result.text.match(/### Snapshot\n([\s\S]*?)(?=\n### |$)/);
+            if (snapshotMatch) {
+                const raw = snapshotMatch[1].trim();
+                const yamlBody = raw.replace(/^```(?:yaml)?\n?/, '').replace(/\n?```$/, '');
+                snapshotCache.value = { url: '', snapshotString: yamlBody };
+            }
+        }
+        // Filter verbose Playwright response sections — keep snapshots for MCP
+        if (result.text)
+            result.text = filterResponse(result.text, cmdName, INCLUDE_SNAPSHOT);
+        return result;
+    }
+    return {
+        descriptions,
+        runner: {
+            runCommand: runSingleCommand,
+            async runScript(script, language) {
+                if (language === 'javascript') {
+                    return { text: 'JavaScript mode is not supported in standalone mode. Use language="pw" with run-code or eval keywords.', isError: true };
+                }
+                const lines = script.split('\n').filter(l => l.trim() && !l.trim().startsWith('#'));
+                const results = [];
+                for (const line of lines) {
+                    const result = await runSingleCommand(line.trim());
+                    const status = result.isError ? '✗' : '✓';
+                    results.push(`${status} ${line.trim()}${result.isError && result.text ? ` — ${result.text}` : ''}`);
+                    if (result.isError) {
+                        return { text: results.join('\n'), isError: true };
+                    }
+                }
+                return { text: results.join('\n'), isError: false };
+            },
+        },
+    };
+}
+//# sourceMappingURL=standalone.js.map

package/dist/standalone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.js","sourceRoot":"","sources":["../src/standalone.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,23 @@
+import type { EngineResult } from '@playwright-repl/core';
+export interface Runner {
+    runCommand(command: string): Promise<EngineResult>;
+    runScript(script: string, language: 'pw' | 'javascript'): Promise<EngineResult>;
+}
+export interface RunnerDescriptions {
+    runCommandInput: string;
+    runCommand: string;
+    runScript: string;
+    /** When true, run_script only accepts 'script' param (no 'language'). */
+    scriptOnly: boolean;
+}
+export interface RunnerModule {
+    runner: Runner;
+    descriptions: RunnerDescriptions;
+}
+export interface SnapshotCache {
+    value: {
+        url: string;
+        snapshotString: string;
+    } | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,MAAM;IACnB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnF;AAED,MAAM,WAAW,kBAAkB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,UAAU,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACzD"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playwright-repl/mcp",
-    "version": "0.18.1",
+    "version": "0.20.0",
     "type": "module",
     "bin": {
         "playwright-repl-mcp": "./dist/index.js"
@@ -19,5 +19,9 @@
         "@modelcontextprotocol/sdk": "^1.10.0",
         "@playwright-repl/core": "workspace:*",
         "zod": "^3.24.0"
+    },
+    "peerDependencies": {
+        "playwright": "1.59.0-alpha-2026-02-21",
+        "playwright-core": "1.59.0-alpha-2026-02-21"
     }
 }