@playwright-repl/core 0.7.10

package/dist/colors.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Terminal color helpers.
+ * No dependency — just ANSI escape codes.
+ */
+export declare const c: Record<string, string>;
+//# sourceMappingURL=colors.d.ts.map

package/dist/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWpC,CAAC"}

package/dist/colors.js

@@ -0,0 +1,17 @@
+/**
+ * Terminal color helpers.
+ * No dependency — just ANSI escape codes.
+ */
+export const c = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+};
+//# sourceMappingURL=colors.js.map

package/dist/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,CAAC,GAA2B;IACvC,KAAK,EAAI,SAAS;IAClB,IAAI,EAAK,SAAS;IAClB,GAAG,EAAM,SAAS;IAClB,GAAG,EAAM,UAAU;IACnB,KAAK,EAAI,UAAU;IACnB,MAAM,EAAG,UAAU;IACnB,IAAI,EAAK,UAAU;IACnB,OAAO,EAAE,UAAU;IACnB,IAAI,EAAK,UAAU;IACnB,IAAI,EAAK,UAAU;CACpB,CAAC"}

package/dist/completion-data.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Completion data — builds the list of items for ghost completion.
+ *
+ * Sources: COMMANDS from resolve.ts plus REPL meta-commands (.help, .exit, etc.).
+ */
+export interface CompletionItem {
+    cmd: string;
+    desc: string;
+}
+/**
+ * Returns a sorted array of `{ cmd, desc }` for all completable items:
+ * commands and meta-commands.
+ */
+export declare function buildCompletionItems(): {
+    cmd: string;
+    desc: string;
+}[];
+//# sourceMappingURL=completion-data.d.ts.map

package/dist/completion-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-data.d.ts","sourceRoot":"","sources":["../src/completion-data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;GAGG;AACH,wBAAgB,oBAAoB;;;IAgBnC"}

package/dist/completion-data.js

@@ -0,0 +1,53 @@
+/**
+ * Completion data — builds the list of items for ghost completion.
+ *
+ * Sources: COMMANDS from resolve.ts plus REPL meta-commands (.help, .exit, etc.).
+ */
+import { COMMANDS } from './resolve.js';
+// ─── Meta-commands ───────────────────────────────────────────────────────────
+const META_COMMANDS = [
+    { cmd: '.clear', desc: 'Clear terminal output' },
+    { cmd: '.help', desc: 'Show available commands' },
+    { cmd: '.aliases', desc: 'Show command aliases' },
+    { cmd: '.history', desc: 'Show command history' },
+    { cmd: '.history clear', desc: 'Clear command history' },
+    { cmd: '.status', desc: 'Show connection status' },
+    { cmd: '.reconnect', desc: 'Reconnect to daemon' },
+    { cmd: '.record', desc: 'Start recording commands' },
+    { cmd: '.save', desc: 'Stop recording and save' },
+    { cmd: '.pause', desc: 'Pause/resume recording' },
+    { cmd: '.discard', desc: 'Discard current recording' },
+    { cmd: '.replay', desc: 'Replay a recorded session' },
+    { cmd: '.exit', desc: 'Exit REPL' },
+];
+const EXTRA_COMMANDS = [
+    { cmd: 'highlight', desc: 'Highlight matching elements' },
+    { cmd: 'verify', desc: 'Assert page state (title, url, text, element, value, list)' },
+    { cmd: 'verify-text', desc: 'Assert text is visible on page' },
+    { cmd: 'verify-element', desc: 'Assert element exists by role and name' },
+    { cmd: 'verify-value', desc: 'Assert input/select/checkbox value' },
+    { cmd: 'verify-list', desc: 'Assert list contains expected items' },
+    { cmd: 'verify-title', desc: 'Assert page title contains text' },
+    { cmd: 'verify-url', desc: 'Assert page URL contains text' },
+    { cmd: 'verify-no-text', desc: 'Assert text is not visible on page' },
+    { cmd: 'verify-no-element', desc: 'Assert element does not exist' },
+];
+// ─── Build completion items ──────────────────────────────────────────────────
+/**
+ * Returns a sorted array of `{ cmd, desc }` for all completable items:
+ * commands and meta-commands.
+ */
+export function buildCompletionItems() {
+    const items = [];
+    // Primary commands
+    for (const [name, info] of Object.entries(COMMANDS)) {
+        items.push({ cmd: name, desc: info.desc });
+    }
+    // Extra commands (not in COMMANDS but handled by REPL)
+    items.push(...EXTRA_COMMANDS);
+    // Meta-commands
+    items.push(...META_COMMANDS);
+    items.sort((a, b) => a.cmd.localeCompare(b.cmd));
+    return items;
+}
+//# sourceMappingURL=completion-data.js.map

package/dist/completion-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-data.js","sourceRoot":"","sources":["../src/completion-data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,gFAAgF;AAEhF,MAAM,aAAa,GAAG;IACpB,EAAE,GAAG,EAAE,QAAQ,EAAM,IAAI,EAAE,uBAAuB,EAAE;IACpD,EAAE,GAAG,EAAE,OAAO,EAAO,IAAI,EAAE,yBAAyB,EAAE;IACtD,EAAE,GAAG,EAAE,UAAU,EAAI,IAAI,EAAE,sBAAsB,EAAE;IACnD,EAAE,GAAG,EAAE,UAAU,EAAI,IAAI,EAAE,sBAAsB,EAAE;IACnD,EAAE,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,uBAAuB,EAAE;IACxD,EAAE,GAAG,EAAE,SAAS,EAAK,IAAI,EAAE,wBAAwB,EAAE;IACrD,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAClD,EAAE,GAAG,EAAE,SAAS,EAAK,IAAI,EAAE,0BAA0B,EAAE;IACvD,EAAE,GAAG,EAAE,OAAO,EAAO,IAAI,EAAE,yBAAyB,EAAE;IACtD,EAAE,GAAG,EAAE,QAAQ,EAAM,IAAI,EAAE,wBAAwB,EAAE;IACrD,EAAE,GAAG,EAAE,UAAU,EAAI,IAAI,EAAE,2BAA2B,EAAE;IACxD,EAAE,GAAG,EAAE,SAAS,EAAK,IAAI,EAAE,2BAA2B,EAAE;IACxD,EAAE,GAAG,EAAE,OAAO,EAAO,IAAI,EAAE,WAAW,EAAE;CACzC,CAAC;AAEF,MAAM,cAAc,GAAG;IACrB,EAAE,GAAG,EAAE,WAAW,EAAQ,IAAI,EAAE,6BAA6B,EAAE;IAC/D,EAAE,GAAG,EAAE,QAAQ,EAAW,IAAI,EAAE,4DAA4D,EAAE;IAC9F,EAAE,GAAG,EAAE,aAAa,EAAM,IAAI,EAAE,gCAAgC,EAAE;IAClE,EAAE,GAAG,EAAE,gBAAgB,EAAG,IAAI,EAAE,wCAAwC,EAAE;IAC1E,EAAE,GAAG,EAAE,cAAc,EAAK,IAAI,EAAE,oCAAoC,EAAE;IACtE,EAAE,GAAG,EAAE,aAAa,EAAM,IAAI,EAAE,qCAAqC,EAAE;IACvE,EAAE,GAAG,EAAE,cAAc,EAAK,IAAI,EAAE,iCAAiC,EAAE;IACnE,EAAE,GAAG,EAAE,YAAY,EAAO,IAAI,EAAE,+BAA+B,EAAE;IACjE,EAAE,GAAG,EAAE,gBAAgB,EAAG,IAAI,EAAE,oCAAoC,EAAE;IACtE,EAAE,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,+BAA+B,EAAE;CACpE,CAAC;AAOF,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,EAAE,CAAC;IAEjB,mBAAmB;IACnB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;IAE9B,gBAAgB;IAChB,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;IAE7B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Engine — in-process Playwright backend.
+ *
+ * Wraps BrowserServerBackend directly, eliminating the daemon process.
+ * Provides the same interface as DaemonConnection: run(args), connected, close().
+ *
+ * Three connection modes:
+ *   - launch:    new browser via Playwright (default)
+ *   - connect:   existing Chrome via CDP port (--connect [port])
+ *   - extension: DevTools extension CDP relay (--extension)
+ */
+export interface EngineOpts {
+    headed?: boolean;
+    browser?: string;
+    connect?: number | boolean;
+    extension?: boolean;
+    spawn?: boolean;
+    port?: number;
+    cdpPort?: number;
+    persistent?: boolean;
+    profile?: string;
+    cwd?: string;
+    [key: string]: unknown;
+}
+export interface EngineResult {
+    text?: string;
+    image?: string;
+    isError?: boolean;
+}
+export interface ParsedArgs {
+    _: string[];
+    cwd?: string;
+    nth?: string | number;
+    [key: string]: unknown;
+}
+interface PlaywrightDeps {
+    BrowserServerBackend: new (config: any, factory: any, opts: any) => any;
+    contextFactory: (config: any) => {
+        createContext: (info: any, signal: AbortSignal, opts: any) => Promise<{
+            browserContext: any;
+            close: () => Promise<void>;
+        }>;
+    };
+    playwright: any;
+    registry: {
+        findExecutable: (name: string) => {
+            executablePath: () => string | undefined;
+        } | undefined;
+    };
+    resolveConfig: (config: any) => Promise<any> | any;
+    commands: Record<string, any>;
+    parseCommand: (command: any, args: any) => {
+        toolName: string;
+        toolParams: Record<string, any>;
+    };
+}
+export declare class Engine {
+    private _deps;
+    private _backend;
+    private _browserContext;
+    private _close;
+    private _connected;
+    private _commandServer;
+    private _chromeProc;
+    constructor(deps?: PlaywrightDeps);
+    get connected(): boolean;
+    /**
+     * Start the engine with given options.
+     */
+    start(opts?: EngineOpts): Promise<void>;
+    /**
+     * Run a command given minimist-parsed args.
+     * Returns { text, isError } matching DaemonConnection.run() shape.
+     */
+    run(args: ParsedArgs): Promise<EngineResult>;
+    /**
+     * Select the Playwright page matching the given URL.
+     * Uses backend.callTool('browser_tabs') to properly update the tab tracker.
+     */
+    selectPageByUrl(targetUrl: string): Promise<void>;
+    /**
+     * Shut down the browser and backend.
+     */
+    close(): Promise<void>;
+    private _buildConfig;
+}
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAGD,UAAU,cAAc;IACtB,oBAAoB,EAAE,KAAK,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;IACxE,cAAc,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK;QAAE,aAAa,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC;YAAE,cAAc,EAAE,GAAG,CAAC;YAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAChK,UAAU,EAAE,GAAG,CAAC;IAChB,QAAQ,EAAE;QAAE,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;YAAE,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAC;IACzG,aAAa,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,YAAY,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC;CAClG;AA6BD,qBAAa,MAAM;IAEjB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,WAAW,CAAwD;gBAG/D,IAAI,CAAC,EAAE,cAAc;IAIjC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACG,KAAK,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAkIjD;;;OAGG;IACG,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IA6DlD;;;OAGG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAevD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAsBd,YAAY;CA0D3B"}

package/dist/engine.js

@@ -0,0 +1,346 @@
+/**
+ * Engine — in-process Playwright backend.
+ *
+ * Wraps BrowserServerBackend directly, eliminating the daemon process.
+ * Provides the same interface as DaemonConnection: run(args), connected, close().
+ *
+ * Three connection modes:
+ *   - launch:    new browser via Playwright (default)
+ *   - connect:   existing Chrome via CDP port (--connect [port])
+ *   - extension: DevTools extension CDP relay (--extension)
+ */
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import url from 'node:url';
+import { replVersion } from './resolve.js';
+/* eslint-enable @typescript-eslint/no-explicit-any */
+// ─── Lazy-loaded Playwright dependencies ────────────────────────────────────
+let _deps;
+function loadDeps() {
+    if (_deps)
+        return _deps;
+    const require = createRequire(import.meta.url);
+    // Resolve absolute paths to bypass Playwright's exports map.
+    const pwDir = path.dirname(require.resolve('playwright/package.json'));
+    const pwReq = (sub) => require(path.join(pwDir, sub));
+    const pwCoreDir = path.dirname(require.resolve('playwright-core/package.json'));
+    const pwCoreReq = (sub) => require(path.join(pwCoreDir, sub));
+    _deps = {
+        BrowserServerBackend: pwReq('lib/mcp/browser/browserServerBackend.js').BrowserServerBackend,
+        contextFactory: pwReq('lib/mcp/browser/browserContextFactory.js').contextFactory,
+        playwright: require('playwright-core'),
+        registry: pwCoreReq('lib/server/registry/index.js').registry,
+        resolveConfig: pwReq('lib/mcp/browser/config.js').resolveConfig,
+        commands: pwReq('lib/cli/daemon/commands.js').commands,
+        parseCommand: pwReq('lib/cli/daemon/command.js').parseCommand,
+    };
+    return _deps;
+}
+// ─── Engine ─────────────────────────────────────────────────────────────────
+export class Engine {
+    /* eslint-disable @typescript-eslint/no-explicit-any */
+    _deps;
+    _backend = null;
+    _browserContext = null;
+    _close = null;
+    _connected = false;
+    _commandServer = null;
+    _chromeProc = null;
+    /* eslint-enable @typescript-eslint/no-explicit-any */
+    constructor(deps) {
+        this._deps = deps;
+    }
+    get connected() {
+        return this._connected;
+    }
+    /**
+     * Start the engine with given options.
+     */
+    async start(opts = {}) {
+        const deps = this._deps || loadDeps();
+        const config = await this._buildConfig(opts, deps);
+        const cwd = url.pathToFileURL(process.cwd()).href;
+        const clientInfo = {
+            name: 'playwright-repl',
+            version: replVersion,
+            roots: [{ uri: cwd, name: 'cwd' }],
+            timestamp: Date.now(),
+        };
+        // Choose context factory based on mode.
+        if (opts.extension) {
+            const serverPort = opts.port || 6781;
+            const cdpPort = opts.cdpPort || 9222;
+            // 1. Start CommandServer for panel HTTP commands.
+            const { CommandServer } = await import('./extension-server.js');
+            const cmdServer = new CommandServer(this);
+            await cmdServer.start(serverPort);
+            this._commandServer = cmdServer;
+            console.log(`CommandServer listening on http://localhost:${serverPort}`);
+            // 2. Spawn Chrome (only with --spawn).
+            if (opts.spawn) {
+                const extPath = path.resolve(path.dirname(url.fileURLToPath(import.meta.url)), '../../extension/dist');
+                const execInfo = deps.registry.findExecutable(opts.browser || 'chrome');
+                const execPath = execInfo?.executablePath();
+                if (!execPath)
+                    throw new Error('Chrome executable not found. Make sure Chrome is installed.');
+                // Chrome 136+ requires --user-data-dir for CDP. Use a dedicated profile dir.
+                const os = await import('node:os');
+                const fs = await import('node:fs');
+                const userDataDir = opts.profile || path.join(os.default.homedir(), '.playwright-repl', 'chrome-profile');
+                fs.default.mkdirSync(userDataDir, { recursive: true });
+                const chromeArgs = [
+                    `--remote-debugging-port=${cdpPort}`,
+                    `--user-data-dir=${userDataDir}`,
+                    `--load-extension=${extPath}`,
+                    '--no-first-run',
+                    '--no-default-browser-check',
+                ];
+                const { spawn } = await import('node:child_process');
+                const chromeProc = spawn(execPath, chromeArgs, {
+                    detached: true, stdio: 'ignore',
+                });
+                chromeProc.unref();
+                this._chromeProc = chromeProc;
+                console.log(`Chrome profile: ${userDataDir}`);
+            }
+            else {
+                console.log('Connecting to existing Chrome on port ' + cdpPort + ' (use --spawn to launch Chrome automatically)');
+            }
+            // 3. Wait for Chrome CDP to be ready (no timeout — waits until available).
+            console.log('Waiting for Chrome CDP...');
+            const cdpUrl = `http://localhost:${cdpPort}`;
+            while (true) {
+                try {
+                    const res = await fetch(`${cdpUrl}/json/version`);
+                    if (res.ok)
+                        break;
+                }
+                catch { /* retry */ }
+                await new Promise(r => setTimeout(r, 500));
+            }
+            console.log('Chrome CDP ready. Connecting Playwright...');
+            // 4. Connect Playwright via CDP.
+            config.browser.cdpEndpoint = cdpUrl;
+            const factory = deps.contextFactory(config);
+            const { browserContext, close } = await factory.createContext(clientInfo, new AbortController().signal, {});
+            this._browserContext = browserContext;
+            this._close = close;
+            const existingContextFactory = {
+                createContext: () => Promise.resolve({ browserContext, close }),
+            };
+            this._backend = new deps.BrowserServerBackend(config, existingContextFactory, { allTools: true });
+            await this._backend.initialize?.(clientInfo);
+            this._connected = true;
+            // 5. Auto-select the first visible web page.
+            const pages = browserContext.pages();
+            const INTERNAL = /^(chrome|devtools|chrome-extension|about):/;
+            let selectedIdx = -1;
+            for (let i = 0; i < pages.length; i++) {
+                const pageUrl = pages[i].url();
+                if (!pageUrl || INTERNAL.test(pageUrl))
+                    continue;
+                try {
+                    const state = await pages[i].evaluate(() => document.visibilityState);
+                    if (state === 'visible' && selectedIdx === -1) {
+                        selectedIdx = i;
+                    }
+                }
+                catch { /* skip */ }
+            }
+            if (selectedIdx > 0) {
+                await this._backend.callTool('browser_tabs', { action: 'select', index: selectedIdx });
+            }
+            console.log('Ready! Side panel can send commands.');
+            browserContext.on('close', () => {
+                this._connected = false;
+            });
+        }
+        else {
+            // Launch/connect mode: eagerly create context for immediate feedback.
+            const factory = deps.contextFactory(config);
+            const { browserContext, close } = await factory.createContext(clientInfo, new AbortController().signal, {});
+            this._browserContext = browserContext;
+            this._close = close;
+            const existingContextFactory = {
+                createContext: () => Promise.resolve({ browserContext, close }),
+            };
+            this._backend = new deps.BrowserServerBackend(config, existingContextFactory, { allTools: true });
+            await this._backend.initialize?.(clientInfo);
+            this._connected = true;
+            browserContext.on('close', () => {
+                this._connected = false;
+            });
+        }
+    }
+    /**
+     * Run a command given minimist-parsed args.
+     * Returns { text, isError } matching DaemonConnection.run() shape.
+     */
+    async run(args) {
+        if (!this._backend)
+            throw new Error('Engine not started');
+        // ── highlight → run-code translation ──
+        if (args._[0] === 'highlight') {
+            const loc = args._.slice(1).join(' ');
+            if (!loc)
+                return { text: 'Usage: highlight <locator>', isError: true };
+            const isSelector = /[.#\[\]>:=]/.test(loc);
+            const locExpr = isSelector
+                ? `page.locator(${JSON.stringify(loc)})`
+                : `page.getByText(${JSON.stringify(loc)})`;
+            args = { _: ['run-code', `async (page) => { await ${locExpr}.highlight(); return "Highlighted"; }`] };
+        }
+        // ── >> chaining → run-code translation ──
+        const LOCATOR_ACTIONS = {
+            click: 'click', dblclick: 'dblclick', hover: 'hover',
+            check: 'check', uncheck: 'uncheck',
+            fill: 'fill', select: 'selectOption',
+        };
+        if (LOCATOR_ACTIONS[args._[0]] && args._.some(a => a.includes('>>'))) {
+            const action = LOCATOR_ACTIONS[args._[0]];
+            const positional = args._.slice(1);
+            // Find last >> — everything up to the token after it is the selector,
+            // everything after that is the action argument (e.g., value for fill).
+            let lastChainIdx = -1;
+            for (let i = 0; i < positional.length; i++) {
+                if (positional[i] === '>>' || positional[i].includes('>>'))
+                    lastChainIdx = i;
+            }
+            const selectorEnd = positional[lastChainIdx] !== '>>' && positional[lastChainIdx]?.includes('>>')
+                ? lastChainIdx // >> inside quoted token like ".nav >> button"
+                : lastChainIdx + 1;
+            const selector = positional.slice(0, selectorEnd + 1).join(' ');
+            const rest = positional.slice(selectorEnd + 1).join(' ');
+            const locExpr = `page.locator(${JSON.stringify(selector)})`;
+            const actionCall = rest
+                ? `${locExpr}.${action}(${JSON.stringify(rest)})`
+                : `${locExpr}.${action}()`;
+            args = { _: ['run-code', `async (page) => { await ${actionCall}; return "Done"; }`] };
+        }
+        const deps = this._deps || loadDeps();
+        const command = deps.commands[args._[0]];
+        if (!command)
+            throw new Error(`Unknown command: ${args._[0]}`);
+        const { toolName, toolParams } = deps.parseCommand(command, args);
+        // Commands like "close", "list", "kill-all" have empty toolName.
+        if (!toolName)
+            return { text: `Command "${args._[0]}" is not supported in engine mode.`, isError: true };
+        toolParams._meta = { cwd: args.cwd || process.cwd() };
+        const response = await this._backend.callTool(toolName, toolParams);
+        return formatResult(response);
+    }
+    /**
+     * Select the Playwright page matching the given URL.
+     * Uses backend.callTool('browser_tabs') to properly update the tab tracker.
+     */
+    async selectPageByUrl(targetUrl) {
+        if (!this._browserContext || !this._backend || !targetUrl)
+            return;
+        const pages = this._browserContext.pages();
+        const normalize = (u) => u.replace(/\/+$/, '');
+        const target = normalize(targetUrl);
+        for (let i = 0; i < pages.length; i++) {
+            if (normalize(pages[i].url()) === target) {
+                try {
+                    await this._backend.callTool('browser_tabs', { action: 'select', index: i });
+                }
+                catch { /* ignore */ }
+                return;
+            }
+        }
+    }
+    /**
+     * Shut down the browser and backend.
+     */
+    async close() {
+        this._connected = false;
+        if (this._commandServer) {
+            await this._commandServer.close();
+            this._commandServer = null;
+        }
+        if (this._backend) {
+            this._backend.serverClosed();
+            this._backend = null;
+        }
+        if (this._close) {
+            await this._close();
+            this._close = null;
+        }
+        if (this._chromeProc) {
+            try {
+                this._chromeProc.kill();
+            }
+            catch { /* ignore */ }
+            this._chromeProc = null;
+        }
+    }
+    // ─── Config builder ───────────────────────────────────────────────────────
+    async _buildConfig(opts, deps) {
+        const config = {
+            browser: {
+                browserName: 'chromium',
+                launchOptions: {
+                    channel: 'chrome',
+                    headless: !opts.headed,
+                },
+                contextOptions: {
+                    viewport: null,
+                },
+                isolated: false,
+                userDataDir: undefined,
+                cdpEndpoint: undefined,
+            },
+            server: {},
+            network: {},
+            timeouts: {
+                action: 5000,
+                navigation: 15000,
+            },
+        };
+        // Browser selection
+        if (opts.browser) {
+            switch (opts.browser) {
+                case 'firefox':
+                    config.browser.browserName = 'firefox';
+                    config.browser.launchOptions.channel = undefined;
+                    break;
+                case 'webkit':
+                    config.browser.browserName = 'webkit';
+                    config.browser.launchOptions.channel = undefined;
+                    break;
+                default:
+                    // chrome, msedge, chrome-beta, etc.
+                    config.browser.browserName = 'chromium';
+                    config.browser.launchOptions.channel = opts.browser;
+                    break;
+            }
+        }
+        // Persistent profile
+        if (opts.persistent || opts.profile) {
+            config.browser.userDataDir = opts.profile || undefined;
+        }
+        else if (!opts.extension) {
+            config.browser.isolated = true;
+        }
+        // CDP connect mode
+        if (opts.connect) {
+            const port = typeof opts.connect === 'number' ? opts.connect : 9222;
+            config.browser.cdpEndpoint = `http://localhost:${port}`;
+            config.browser.isolated = false;
+        }
+        return await deps.resolveConfig(config);
+    }
+}
+function formatResult(result) {
+    const isError = result.isError;
+    let text;
+    let image;
+    for (const item of result.content) {
+        if (item.type === 'text' && !text)
+            text = item.text;
+        if (item.type === 'image' && !image)
+            image = `data:${item.mimeType || 'image/png'};base64,${item.data}`;
+    }
+    return { isError, text, image };
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/extension-server.d.ts

@@ -0,0 +1,25 @@
+/**
+ * CommandServer — HTTP server for the side panel extension.
+ *
+ * Endpoints:
+ *   POST /run     Panel commands → engine.run()
+ *   GET  /health  Panel checks if server is running
+ */
+import type { ParsedArgs, EngineResult } from './engine.js';
+interface EngineInterface {
+    run: (args: ParsedArgs) => Promise<EngineResult>;
+    selectPageByUrl: (url: string) => Promise<void>;
+    connected: boolean;
+}
+export declare class CommandServer {
+    private _engine;
+    private _server;
+    private _port;
+    constructor(engine: EngineInterface);
+    get port(): number | null;
+    start(port?: number): Promise<void>;
+    close(): Promise<void>;
+    private _handleHttp;
+}
+export {};
+//# sourceMappingURL=extension-server.d.ts.map

package/dist/extension-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-server.d.ts","sourceRoot":"","sources":["../src/extension-server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI5D,UAAU,eAAe;IACvB,GAAG,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACjD,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,KAAK,CAAuB;gBAExB,MAAM,EAAE,eAAe;IAInC,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,CAAuB;IAE1C,KAAK,CAAC,IAAI,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YASd,WAAW;CAsD1B"}