@hover-dev/core 0.16.0 → 0.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hover-dev/core",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Hover's local Node service: agent invocation, Playwright CDP preflight, WebSocket bridge.",
   "license": "Apache-2.0",
   "author": "Hyperyond",
@@ -35,6 +35,10 @@
       "types": "./dist/service.d.ts",
       "import": "./dist/service.js"
     },
+    "./engine": {
+      "types": "./dist/engine.d.ts",
+      "import": "./dist/engine.js"
+    },
     "./launch-chrome": {
       "types": "./dist/playwright/launchChrome.d.ts",
       "import": "./dist/playwright/launchChrome.js"
@@ -46,6 +50,7 @@
   },
   "files": [
     "dist",
+    "seeds",
     "README.md"
   ],
   "dependencies": {
@@ -70,14 +75,6 @@
     "build": "tsc -p tsconfig.build.json",
     "dev": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "smoke": "tsx src/smoke.ts",
-    "smoke:chrome": "tsx src/scripts/start-chrome.ts",
-    "detect": "tsx src/scripts/detect-cli.ts",
-    "verify-widget": "tsx src/scripts/verify-widget.ts",
-    "verify-spec": "tsx src/scripts/verify-spec.ts",
-    "ws-smoke": "tsx src/scripts/ws-smoke.ts",
-    "bench-ttfb": "tsx src/scripts/bench-ttfb.ts",
-    "bench-multi-tab": "tsx src/scripts/bench-multi-tab.ts",
     "test": "vitest run",
     "test:watch": "vitest"
   },

package/dist/agents/aider.d.ts

@@ -1,16 +0,0 @@
-import type { AgentDescriptor, ParserState } from './types.js';
-export declare const aiderAgent: AgentDescriptor;
-/**
- * Test-only escape hatches, same pattern as cursor.ts / codex.ts.
- */
-export declare const __testing: {
-    freshState: () => ParserState;
-    resetCounters: (state: ParserState) => void;
-    getState: (state: ParserState) => {
-        runningLines: number;
-        runningSessionId: string | undefined;
-        collectedText: string[];
-        sawErrorEvent: boolean;
-    };
-};
-//# sourceMappingURL=aider.d.ts.map

package/dist/agents/aider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"aider.d.ts","sourceRoot":"","sources":["../../src/agents/aider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA8B,WAAW,EAAE,MAAM,YAAY,CAAC;AA8G3F,eAAO,MAAM,UAAU,EAAE,eA0GxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS;sBACJ,WAAW;2BACJ,WAAW;sBAChB,WAAW;;;;;;CAS9B,CAAC"}

package/dist/agents/aider.js

@@ -1,161 +0,0 @@
-import { HOVER_PROMPT_PREFACE } from './shared.js';
-function aiderState(state) {
-    if (typeof state.runningLines !== 'number') {
-        state.runningLines = 0;
-        state.collectedText = [];
-        state.sawErrorEvent = false;
-        state.runningSessionId = undefined;
-    }
-    return state;
-}
-function resetAiderCounters(s) {
-    s.runningLines = 0;
-    s.collectedText = [];
-    s.sawErrorEvent = false;
-    s.runningSessionId = undefined;
-}
-// Aider has no system-prompt flag, so we prepend the standing HOVER-mode
-// preface (HOVER_PROMPT_PREFACE, from shared.ts) to the user prompt (same
-// approach as cursor.ts). The agent treats it as the leading user-message text.
-/**
- * Lines we treat as noise and drop instead of surfacing as text events.
- * Aider chatters with status lines that would clutter the widget panel.
- * Conservative list — anything we don't explicitly skip falls through.
- */
-function isNoiseLine(line) {
-    const t = line.trim();
-    if (!t)
-        return true;
-    // Common aider boilerplate / banner lines.
-    if (/^Aider v\d/i.test(t))
-        return true;
-    if (/^Main model:/i.test(t))
-        return true;
-    if (/^Weak model:/i.test(t))
-        return true;
-    if (/^Git repo:/i.test(t))
-        return true;
-    if (/^Repo-map:/i.test(t))
-        return true;
-    if (/^VSCode terminal detected/i.test(t))
-        return true;
-    if (/^Use \/help/i.test(t))
-        return true;
-    if (/^Tokens:.*sent.*received/i.test(t))
-        return true;
-    if (/^─{3,}$/.test(t))
-        return true; // horizontal rule
-    return false;
-}
-function detectErrorLine(line) {
-    // Aider prints errors / API failures with a leading marker.
-    return /^(error|fatal|api error|litellm.*error)/i.test(line.trim());
-}
-export const aiderAgent = {
-    id: 'aider',
-    binName: 'aider',
-    protocol: 'argv',
-    streamFormat: 'plain-text',
-    sandboxStrength: 'soft',
-    display: {
-        label: 'Aider',
-        tagline: 'Aider — soft sandbox, plain-text stream, no MCP support',
-        homepage: 'https://aider.chat',
-        installHint: 'pipx install aider-chat',
-    },
-    buildArgs(opts) {
-        // Prepend HOVER-mode preface plus any caller-supplied appendSystemPrompt
-        // to the prompt. Aider has no --append-system-prompt flag, so this is
-        // the closest functional analogue (same trick as cursor.ts).
-        const preface = opts.appendSystemPrompt && opts.appendSystemPrompt.trim().length > 0
-            ? `${HOVER_PROMPT_PREFACE} ${opts.appendSystemPrompt}`
-            : HOVER_PROMPT_PREFACE;
-        const finalPrompt = `${preface}\n\n${opts.prompt}`;
-        const args = ['--message', finalPrompt];
-        // Auto-confirm every prompt so the run doesn't hang.
-        args.push('--yes-always');
-        // Make stdout line-buffered instead of character-streamed; friendlier
-        // for our per-line parseEvent loop.
-        args.push('--no-stream');
-        // Defang git side-effects. Aider's default behaviour is to auto-commit
-        // every edit it makes; for a browser-driving agent that should never
-        // edit files this is still a hazard if cwd is a stale repo.
-        args.push('--no-auto-commits');
-        args.push('--no-git');
-        if (opts.model) {
-            args.push('--model', opts.model);
-        }
-        // Aider's `--restore-chat-history` is a boolean (no session-id form);
-        // we deliberately do NOT pass it. `opts.sessionId` is ignored because
-        // there is no way to select a specific past session by ID.
-        // No equivalents for --max-budget-usd / --allowedTools / --mcp-config /
-        // --append-system-prompt — all four are absent from aider.
-        return args;
-    },
-    parseEvent(line, state = {}) {
-        const s = aiderState(state);
-        const out = [];
-        // Emit a synthetic session_start on the very first non-empty line so
-        // the widget gets the same shape it expects from JSON-based agents.
-        if (!s.runningSessionId) {
-            // Cheap unique id; aider has no real session_id we can echo. The
-            // Math.random() suffix is load-bearing — two states created in the
-            // same millisecond would otherwise collide and break per-invocation
-            // session tracking.
-            const rand = Math.random().toString(36).slice(2, 8);
-            s.runningSessionId = `aider-${Date.now().toString(36)}-${rand}`;
-            out.push({ kind: 'session_start', sessionId: s.runningSessionId });
-        }
-        if (isNoiseLine(line))
-            return out;
-        if (detectErrorLine(line)) {
-            s.sawErrorEvent = true;
-            out.push({ kind: 'text', text: line.trim() });
-            return out;
-        }
-        // Treat everything else as assistant text. Aider has no per-tool events
-        // so we cannot emit tool_use / tool_result — see file-header doc comment.
-        s.runningLines += 1;
-        s.collectedText.push(line.trim());
-        out.push({ kind: 'text', text: line.trim() });
-        return out;
-    },
-    /**
-     * Aider doesn't emit a terminal event — the child process simply exits
-     * after the final printed line. Synthesize session_end from accumulated
-     * state, same pattern as codex.ts.
-     */
-    onStreamEnd(exitCode, state = {}) {
-        const s = aiderState(state);
-        // The "summary" is the last non-empty text line, which is typically
-        // aider's final answer. If we collected nothing, leave it undefined
-        // rather than fabricating.
-        const lastText = s.collectedText.length > 0
-            ? s.collectedText[s.collectedText.length - 1]
-            : undefined;
-        return {
-            kind: 'session_end',
-            turns: s.runningLines,
-            // costUsd intentionally undefined — aider's "Tokens:" status line is
-            // ad-hoc text, not a stable API. We don't fabricate a number.
-            isError: s.sawErrorEvent || (exitCode != null && exitCode !== 0),
-            summary: lastText,
-        };
-    },
-};
-/**
- * Test-only escape hatches, same pattern as cursor.ts / codex.ts.
- */
-export const __testing = {
-    freshState: () => ({}),
-    resetCounters: (state) => resetAiderCounters(aiderState(state)),
-    getState: (state) => {
-        const s = aiderState(state);
-        return {
-            runningLines: s.runningLines,
-            runningSessionId: s.runningSessionId,
-            collectedText: [...s.collectedText],
-            sawErrorEvent: s.sawErrorEvent,
-        };
-    },
-};

package/dist/agents/cursor.d.ts

@@ -1,18 +0,0 @@
-import type { AgentDescriptor, ParserState } from './types.js';
-export declare const cursorAgent: AgentDescriptor;
-/**
- * Test-only escape hatches. Same pattern as codex.ts so the tests can drive
- * the parser without going through invokeAgent.
- */
-export declare const __testing: {
-    freshState: () => ParserState;
-    resetCounters: (state: ParserState) => void;
-    getState: (state: ParserState) => {
-        runningTurns: number;
-        runningSessionId: string | undefined;
-        runningModel: string | undefined;
-        lastAssistantText: string | undefined;
-        sawErrorEvent: boolean;
-    };
-};
-//# sourceMappingURL=cursor.d.ts.map

package/dist/agents/cursor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/agents/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA8B,WAAW,EAAE,MAAM,YAAY,CAAC;AA2K3F,eAAO,MAAM,WAAW,EAAE,eAuJzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS;sBACJ,WAAW;2BACJ,WAAW;sBAChB,WAAW;;;;;;;CAU9B,CAAC"}

package/dist/agents/cursor.js

@@ -1,220 +0,0 @@
-import { HOVER_PROMPT_PREFACE, stripMcpPrefix } from './shared.js';
-function cursorState(state) {
-    if (typeof state.runningTurns !== 'number') {
-        state.runningTurns = 0;
-        state.runningSessionId = undefined;
-        state.runningModel = undefined;
-        state.lastAssistantText = undefined;
-        state.sawErrorEvent = false;
-        state.toolNameByCallId = new Map();
-    }
-    return state;
-}
-function resetCursorCounters(s) {
-    s.runningTurns = 0;
-    s.runningSessionId = undefined;
-    s.runningModel = undefined;
-    s.lastAssistantText = undefined;
-    s.sawErrorEvent = false;
-    s.toolNameByCallId.clear();
-}
-/**
- * Best-effort extraction of a tool's name from the `tool_call` envelope.
- * Cursor's stream-json wraps each kind in a sub-object keyed by name
- * (`shellToolCall`, `mcpToolCall`, etc.) but doesn't publish a stable
- * `name` field at the top level. We:
- *   1. Look for the first key that ends in `ToolCall` → strip the suffix.
- *      `shellToolCall` → `shell`, `mcpToolCall` → `mcp`.
- *   2. If the sub-object carries a `tool` / `name` field, prefer that
- *      (mcp calls embed the playwright tool name there).
- *   3. Strip the `mcp__playwright__` / `mcp__hover-playwright__` prefix to
- *      match the normalised tool names claude / codex emit.
- */
-function extractToolName(tc) {
-    if (!tc)
-        return { tool: 'unknown', input: undefined };
-    const wrapperKey = Object.keys(tc).find(k => k.endsWith('ToolCall'));
-    const inner = (wrapperKey ? tc[wrapperKey] : undefined) ?? undefined;
-    // Prefer the inner sub-tool name if it exists (MCP case).
-    const innerName = (inner && typeof inner === 'object' && 'tool' in inner && typeof inner.tool === 'string' && inner.tool) ||
-        (inner && typeof inner === 'object' && 'name' in inner && typeof inner.name === 'string' && inner.name) ||
-        null;
-    const kindFromKey = wrapperKey ? wrapperKey.replace(/ToolCall$/, '') : 'unknown';
-    const rawName = innerName || kindFromKey;
-    const tool = stripMcpPrefix(rawName);
-    const input = (inner && typeof inner === 'object' && 'input' in inner && inner.input) ||
-        (inner && typeof inner === 'object' && 'arguments' in inner && inner.arguments) ||
-        (inner && typeof inner === 'object' && 'args' in inner && inner.args) ||
-        inner;
-    return { tool, input };
-}
-function detectToolError(tc) {
-    if (!tc || typeof tc !== 'object')
-        return false;
-    const wrapperKey = Object.keys(tc).find(k => k.endsWith('ToolCall'));
-    const inner = wrapperKey ? tc[wrapperKey] : undefined;
-    if (!inner)
-        return false;
-    if (inner.is_error === true)
-        return true;
-    if (typeof inner.status === 'string' && /error|fail/i.test(inner.status))
-        return true;
-    return false;
-}
-// The closest analogue Cursor has to claude's --append-system-prompt or
-// codex's developer_instructions is prepending the standing HOVER-mode
-// preface (HOVER_PROMPT_PREFACE, from shared.ts) to the user prompt so the
-// agent sees it as the leading instruction. There is no CLI flag for it.
-export const cursorAgent = {
-    id: 'cursor',
-    binName: 'cursor-agent',
-    protocol: 'argv',
-    streamFormat: 'json-lines',
-    sandboxStrength: 'soft',
-    display: {
-        label: 'Cursor',
-        tagline: 'Cursor — soft sandbox (no built-in tool deny-list)',
-        homepage: 'https://cursor.com/docs/cli/overview',
-        installHint: 'curl https://cursor.com/install -fsS | bash',
-    },
-    buildArgs(opts) {
-        // The HOVER-mode preface plus any caller-supplied appendSystemPrompt
-        // gets prepended to the prompt. This is the closest functional analogue
-        // Cursor has to claude's --append-system-prompt / codex's
-        // developer_instructions, because Cursor exposes no CLI flag for it.
-        const preface = opts.appendSystemPrompt && opts.appendSystemPrompt.trim().length > 0
-            ? `${HOVER_PROMPT_PREFACE} ${opts.appendSystemPrompt}`
-            : HOVER_PROMPT_PREFACE;
-        const finalPrompt = `${preface}\n\n${opts.prompt}`;
-        const args = ['-p', finalPrompt];
-        // NDJSON streaming output.
-        args.push('--output-format', 'stream-json');
-        // Non-interactive: auto-approve commands and MCP tools so the run doesn't
-        // hang waiting for permission. Cursor calls this --force / --yolo.
-        args.push('--force');
-        if (opts.model) {
-            args.push('--model', opts.model);
-        }
-        if (opts.sessionId) {
-            // Cursor's --resume accepts the chat_id. Empty / no-arg --resume
-            // resumes the latest, which is NOT what we want here.
-            args.push('--resume', opts.sessionId);
-        }
-        // MCP servers are configured in ~/.cursor/mcp.json (or repo-local
-        // .cursor/mcp.json) at install time, not per-invocation. Cursor has no
-        // equivalent of claude's --mcp-config. If the caller passed opts.mcpConfig
-        // we don't have a way to forward it; service.ts logs a one-time warning.
-        // No equivalent for --max-budget-usd or --allowedTools / --disallowedTools.
-        return args;
-    },
-    parseEvent(line, state = {}) {
-        if (!line.trim())
-            return [];
-        let ev;
-        try {
-            ev = JSON.parse(line);
-        }
-        catch {
-            return [{ kind: 'raw', line }];
-        }
-        const s = cursorState(state);
-        const out = [];
-        if (ev.type === 'system' && ev.subtype === 'init') {
-            resetCursorCounters(s);
-            s.runningModel = ev.model;
-            if (ev.session_id) {
-                s.runningSessionId = ev.session_id;
-                out.push({ kind: 'session_start', sessionId: ev.session_id, model: ev.model });
-            }
-            return out;
-        }
-        if (ev.type === 'tool_call' && ev.subtype === 'started') {
-            const { tool, input } = extractToolName(ev.tool_call);
-            if (ev.call_id)
-                s.toolNameByCallId.set(ev.call_id, tool);
-            out.push({ kind: 'tool_use', tool, input });
-            return out;
-        }
-        if (ev.type === 'tool_call' && ev.subtype === 'completed') {
-            const isError = detectToolError(ev.tool_call);
-            out.push({ kind: 'tool_result', isError });
-            return out;
-        }
-        if (ev.type === 'assistant') {
-            s.runningTurns += 1;
-            // Emit a usage event so the widget can advance its turn counter even
-            // though Cursor gives us no token / $ data. costUsd intentionally
-            // omitted — we don't fabricate a number.
-            out.push({ kind: 'usage', turns: s.runningTurns });
-            for (const block of ev.message?.content ?? []) {
-                if (block.type === 'text') {
-                    const text = block.text?.trim();
-                    if (text) {
-                        s.lastAssistantText = text;
-                        out.push({ kind: 'text', text });
-                    }
-                }
-            }
-            return out;
-        }
-        if (ev.type === 'result') {
-            // Cursor's result event IS the session_end. We forward it directly so
-            // onStreamEnd doesn't need to synthesize.
-            const isError = ev.is_error === true ||
-                (typeof ev.subtype === 'string' && /error|fail/i.test(ev.subtype));
-            if (isError)
-                s.sawErrorEvent = true;
-            out.push({
-                kind: 'session_end',
-                turns: s.runningTurns,
-                // costUsd intentionally undefined — Cursor doesn't publish $ or tokens.
-                isError,
-                summary: ev.result ?? s.lastAssistantText,
-            });
-            return out;
-        }
-        // Cursor sometimes emits error envelopes mid-stream; surface them as
-        // text so the widget shows the problem instead of silently hanging.
-        if (ev.type && /error/i.test(ev.type)) {
-            s.sawErrorEvent = true;
-            // No documented `message` field on these — best-effort.
-            const msg = ev.result ?? `[cursor] ${ev.type}`;
-            out.push({ kind: 'text', text: msg });
-            return out;
-        }
-        return [];
-    },
-    /**
-     * Cursor's `result` event already produces a session_end via parseEvent;
-     * this fallback is for the case where the child exits without emitting a
-     * `result` (e.g. crash, signal). Mirrors codex.ts's shape.
-     */
-    onStreamEnd(exitCode, state = {}) {
-        const s = cursorState(state);
-        return {
-            kind: 'session_end',
-            turns: s.runningTurns,
-            // costUsd intentionally undefined — see parseEvent note.
-            isError: s.sawErrorEvent || (exitCode != null && exitCode !== 0),
-            summary: s.lastAssistantText,
-        };
-    },
-};
-/**
- * Test-only escape hatches. Same pattern as codex.ts so the tests can drive
- * the parser without going through invokeAgent.
- */
-export const __testing = {
-    freshState: () => ({}),
-    resetCounters: (state) => resetCursorCounters(cursorState(state)),
-    getState: (state) => {
-        const s = cursorState(state);
-        return {
-            runningTurns: s.runningTurns,
-            runningSessionId: s.runningSessionId,
-            runningModel: s.runningModel,
-            lastAssistantText: s.lastAssistantText,
-            sawErrorEvent: s.sawErrorEvent,
-        };
-    },
-};

package/dist/playwright/raiseWindow.d.ts

@@ -1,10 +0,0 @@
-/**
- * Find the OS PID of the process listening on the given TCP port.
- * Returns null if nothing is listening or the lookup tool isn't available.
- */
-export declare function findCdpPid(port: number): Promise<number | null>;
-/**
- * Raise the Chrome window owned by `pid` to the OS foreground. Best-effort.
- */
-export declare function raiseChromeWindow(pid: number): Promise<void>;
-//# sourceMappingURL=raiseWindow.d.ts.map

package/dist/playwright/raiseWindow.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"raiseWindow.d.ts","sourceRoot":"","sources":["../../src/playwright/raiseWindow.ts"],"names":[],"mappings":"AAyBA;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8BrE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDlE"}

package/dist/playwright/raiseWindow.js

@@ -1,158 +0,0 @@
-/**
- * Raise the OS-level Chrome window to the foreground.
- *
- * Why this exists: CDP's `Page.bringToFront()` and `Target.activateTarget`
- * only reorder tabs *inside* the Chrome process — they do not raise the
- * Chrome application window in the OS's window stack. When the user clicks
- * "Switch me to it" from a widget hosted in a different window, the tab
- * activates correctly inside the (possibly background) debug Chrome, but
- * the window stays buried. The user then has to manually click the Chrome
- * Dock icon / Alt-Tab to it, which defeats the point of the button.
- *
- * Fix: after `bringToFront()`, run an OS-specific command that raises the
- * specific Chrome *process* (matched by PID, found from the CDP port via
- * `lsof` / `netstat`). PID-matching is critical — the user's own primary
- * Chrome and Hover's debug Chrome are both "Google Chrome" to AppleScript,
- * so raising by app name would risk activating the wrong window.
- *
- * Best-effort and non-blocking — if the helper fails, we still leave the
- * tab correctly focused inside the debug Chrome and the user can click
- * over manually like before. Logging is to stderr only; this never throws
- * back to the caller.
- */
-import { spawn } from 'node:child_process';
-import { platform } from 'node:os';
-/**
- * Find the OS PID of the process listening on the given TCP port.
- * Returns null if nothing is listening or the lookup tool isn't available.
- */
-export async function findCdpPid(port) {
-    const os = platform();
-    if (os === 'darwin' || os === 'linux') {
-        // -t prints just PIDs, -sTCP:LISTEN filters to listeners (otherwise
-        // every client connection's PID would show up too).
-        const out = await runCapture('lsof', ['-tiTCP:' + port, '-sTCP:LISTEN']);
-        if (!out)
-            return null;
-        // lsof may print multiple lines if forked workers also hold the port;
-        // take the first numeric one.
-        for (const line of out.split('\n')) {
-            const pid = Number.parseInt(line.trim(), 10);
-            if (Number.isInteger(pid) && pid > 0)
-                return pid;
-        }
-        return null;
-    }
-    if (os === 'win32') {
-        // `netstat -ano` columns: Proto Local Foreign State PID
-        const out = await runCapture('netstat', ['-ano']);
-        if (!out)
-            return null;
-        for (const line of out.split('\n')) {
-            // Match `TCP    127.0.0.1:9222    0.0.0.0:0    LISTENING    1234`
-            const m = line.match(/^\s*TCP\s+\S+:(\d+)\s+\S+\s+LISTENING\s+(\d+)\s*$/i);
-            if (m && Number(m[1]) === port)
-                return Number(m[2]);
-        }
-        return null;
-    }
-    return null;
-}
-/**
- * Raise the Chrome window owned by `pid` to the OS foreground. Best-effort.
- */
-export async function raiseChromeWindow(pid) {
-    const os = platform();
-    try {
-        if (os === 'darwin') {
-            // System Events can frontmost any process by its unix PID, regardless
-            // of app bundle. This works even when several "Google Chrome"
-            // processes coexist (user's primary + Hover's debug).
-            await runDetached('osascript', [
-                '-e',
-                `tell application "System Events" to set frontmost of (first process whose unix id is ${pid}) to true`,
-            ]);
-            return;
-        }
-        if (os === 'linux') {
-            // wmctrl is the most common helper for X11; not always installed,
-            // but the alternative (xdotool) needs the same dependency story.
-            // If it isn't installed the runCapture/runDetached calls swallow the
-            // ENOENT and we degrade gracefully.
-            //
-            // `wmctrl -i` expects an X11 WINDOW id, NOT a unix PID, so we first
-            // map PID → window id. `wmctrl -l -p` lists windows with their owning
-            // PID in the third column:
-            //   0x03c00007  0 12345  hostname  Title…
-            const listing = await runCapture('wmctrl', ['-l', '-p']);
-            if (!listing)
-                return;
-            let windowId = null;
-            for (const line of listing.split('\n')) {
-                // columns: <window-id> <desktop> <pid> <host> <title…>
-                const m = line.match(/^(0x[0-9a-fA-F]+)\s+\S+\s+(\d+)\s/);
-                if (m && Number(m[2]) === pid) {
-                    windowId = m[1];
-                    break;
-                }
-            }
-            if (!windowId)
-                return; // no matching window — no-op gracefully
-            await runDetached('wmctrl', ['-ia', windowId]);
-            return;
-        }
-        if (os === 'win32') {
-            // PowerShell is bundled with Windows 10+. AppActivate is best-effort:
-            // it requires the target to have a visible main window, which a
-            // headless-less Chrome with a tab open satisfies.
-            const ps = `$p = Get-Process -Id ${pid} -ErrorAction SilentlyContinue; ` +
-                `if ($p) { ` +
-                `  Add-Type -AssemblyName Microsoft.VisualBasic; ` +
-                `  [Microsoft.VisualBasic.Interaction]::AppActivate($p.Id) ` +
-                `}`;
-            await runDetached('powershell', ['-NoProfile', '-Command', ps]);
-            return;
-        }
-    }
-    catch {
-        // Best-effort. CDP-level bringToFront already ran; user can still
-        // click the Chrome window manually.
-    }
-}
-function runCapture(cmd, args) {
-    return new Promise(resolve => {
-        let out = '';
-        let settled = false;
-        const finish = (v) => {
-            if (settled)
-                return;
-            settled = true;
-            resolve(v);
-        };
-        const child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'ignore'] });
-        child.stdout.on('data', chunk => {
-            out += chunk.toString();
-        });
-        child.on('error', () => finish(null));
-        child.on('close', code => finish(code === 0 ? out : null));
-    });
-}
-function runDetached(cmd, args) {
-    return new Promise((resolve, reject) => {
-        let settled = false;
-        const child = spawn(cmd, args, { stdio: 'ignore' });
-        child.on('error', err => {
-            if (settled)
-                return;
-            settled = true;
-            reject(err);
-        });
-        child.on('close', () => {
-            if (settled)
-                return;
-            settled = true;
-            // Don't treat non-zero as fatal — caller already wraps in try/catch.
-            resolve();
-        });
-    });
-}

package/dist/scripts/bench-multi-tab.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=bench-multi-tab.d.ts.map

package/dist/scripts/bench-multi-tab.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bench-multi-tab.d.ts","sourceRoot":"","sources":["../../src/scripts/bench-multi-tab.ts"],"names":[],"mappings":""}