@hypersoniclabs/helix-cli 0.1.7 → 0.1.24-helix3.438

package/dist/browser/hostSlots.d.ts

@@ -0,0 +1,57 @@
+export interface BrowserLease {
+    file?: string;
+    nonce: string;
+    beginLaunch(): Promise<void>;
+    release(): Promise<void>;
+}
+interface Receipt {
+    protocol: 2;
+    nonce: string;
+    pid: number;
+    start: string;
+    state: 'reserved' | 'launching';
+    at: string;
+    identity?: string;
+}
+export declare function hostBrowserCap(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): number;
+interface ProcessRow {
+    pid: number;
+    ppid: number;
+    start: string;
+    command: string;
+}
+/**
+ * Could a browser launched under this (dead) owner's receipt still be running?
+ * A persistent launch records its profile as `identity`: any process holding that --user-data-dir
+ * is the browser. Otherwise (Playwright's own temp profile) fall back to the only thing a dead
+ * Playwright owner can leave behind: an orphaned (ppid 1) pipe-driven Chromium main process born
+ * after the owner. Anything unmeasurable answers 'unknown', which keeps the lease.
+ */
+export declare function browserMayStillRun(owner: {
+    identity?: string;
+    start: string;
+}, procs?: ProcessRow[] | null): boolean | 'unknown';
+export declare function slotIsStale(file: string, alive?: (pid: number) => boolean | 'unknown', birth?: (pid: number) => string, browser?: (owner: Receipt) => boolean | 'unknown'): {
+    stale: boolean;
+    raw: string | null;
+};
+/** One unique lease per actual launch; callers must beginLaunch immediately before launching. */
+export declare function acquireHostBrowserSlot(options?: {
+    signal?: AbortSignal;
+    identity?: string;
+}): Promise<BrowserLease>;
+/** Explicit lease only; there is no process-wide release that could free live browsers. */
+export declare function releaseHostBrowserSlot(lease: BrowserLease): Promise<void>;
+interface ManagedBrowser {
+    close(...args: any[]): Promise<void>;
+    once?(event: any, listener: () => void): unknown;
+}
+/** Bind admission to actual teardown. A rejected close keeps the lease unless an
+ * independent close/disconnected event confirms the browser is gone. */
+export declare function bindBrowserLease<T extends ManagedBrowser>(browser: T, lease: BrowserLease, event: 'close' | 'disconnected'): T;
+/** A launch rejection means Playwright completed its failed-launch cleanup. */
+export declare function launchWithBrowserSlot<T extends ManagedBrowser>(launch: () => Promise<T>, event: 'close' | 'disconnected', options?: {
+    signal?: AbortSignal;
+    identity?: string;
+}): Promise<T>;
+export {};

package/dist/browser/hostSlots.js

@@ -0,0 +1,371 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hostBrowserCap = hostBrowserCap;
+exports.browserMayStillRun = browserMayStillRun;
+exports.slotIsStale = slotIsStale;
+exports.acquireHostBrowserSlot = acquireHostBrowserSlot;
+exports.releaseHostBrowserSlot = releaseHostBrowserSlot;
+exports.bindBrowserLease = bindBrowserLease;
+exports.launchWithBrowserSlot = launchWithBrowserSlot;
+// Per-browser admission protocol v2; kept identical to workspace headless-browser.mjs
+// (workspace: scripts/lib/headless-browser.mjs; change both together).
+// slot-N is a permanent directory. Old process-slot clients see it occupied and fail
+// closed. Legacy slot FILES are never reclaimed by v2. See architecture change journal.
+// All mutations of lease.json occur under atomic mkdir(mutex). We NEVER reclaim a
+// mutex: a crash in a critical section sacrifices capacity, rather than risking CAS
+// races or deleting a new owner's receipt. No owner or browser is ever signalled.
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const held = new Map();
+const HOOKS = Symbol.for('helix-headless-browser-lease-hooks');
+const globalHooks = globalThis;
+const hooks = (globalHooks[HOOKS] ??= { releasers: new Set(), installed: false, exit: undefined, signals: [] });
+function releaseAllSync() {
+    for (const release of [...hooks.releasers]) {
+        try {
+            release();
+        }
+        catch { /* the next acquirer reclaims it */ }
+    }
+}
+function syncHookRefresh() {
+    if (hooks.releasers.size && !hooks.installed) {
+        hooks.installed = true;
+        hooks.exit = () => releaseAllSync();
+        process.on('exit', hooks.exit);
+        for (const sig of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+            const handler = () => {
+                if (process.listenerCount(sig) > 1)
+                    return;
+                releaseAllSync();
+                process.removeListener(sig, handler);
+                process.kill(process.pid, sig);
+            };
+            hooks.signals.push([sig, handler]);
+            process.on(sig, handler);
+        }
+    }
+    else if (!hooks.releasers.size && hooks.installed) {
+        hooks.installed = false;
+        process.removeListener('exit', hooks.exit);
+        for (const [sig, handler] of hooks.signals)
+            process.removeListener(sig, handler);
+        hooks.signals = [];
+    }
+}
+function sleepSync(ms) { Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms); }
+function hostBrowserCap(env = process.env, platform = process.platform) {
+    const v = env.HELIX_HEADLESS_MAX;
+    if (v !== undefined) {
+        if (!/^\d+$/.test(v) || !Number.isSafeInteger(Number(v)))
+            throw new Error('HELIX_HEADLESS_MAX must be a non-negative whole number (0 explicitly disables admission)');
+        return Number(v);
+    }
+    // CI (including CI=false) never removes the Mac's local budget.
+    return platform === 'darwin' ? 4 : 0;
+}
+function waitBudget() {
+    const v = process.env.HELIX_HEADLESS_WAIT_MS ?? String(30 * 60_000);
+    if (!/^\d+$/.test(v) || !Number.isSafeInteger(Number(v)))
+        throw new Error('HELIX_HEADLESS_WAIT_MS must be a non-negative whole number');
+    return Number(v);
+}
+function startStamp(pid) {
+    try {
+        return (0, node_child_process_1.execFileSync)('ps', ['-o', 'lstart=', '-p', String(pid)], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+function pidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return 'unknown';
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e.code === 'ESRCH' ? false : 'unknown';
+    }
+}
+// ps snapshot: pid, ppid, birth stamp and full command line of every process, or null when unreadable.
+function listProcesses() {
+    try {
+        const out = (0, node_child_process_1.execFileSync)('ps', ['-axo', 'pid=,ppid=,lstart=,command='], { encoding: 'utf8', maxBuffer: 256 << 20, stdio: ['ignore', 'pipe', 'ignore'] });
+        const procs = [];
+        for (const line of out.split('\n')) {
+            const m = /^\s*(\d+)\s+(\d+)\s+(\w{3} \w{3}\s+\d+ \d\d:\d\d:\d\d \d{4})\s+(.*)$/.exec(line);
+            if (m)
+                procs.push({ pid: Number(m[1]), ppid: Number(m[2]), start: m[3], command: m[4] });
+        }
+        return procs.length ? procs : null;
+    }
+    catch {
+        return null;
+    }
+}
+function hasUserDataDir(command, dir) {
+    const flag = `--user-data-dir=${dir}`;
+    for (let at = command.indexOf(flag); at >= 0; at = command.indexOf(flag, at + 1)) {
+        const next = command[at + flag.length];
+        if (next === undefined || next === ' ' || next === '/')
+            return true;
+    }
+    return false;
+}
+/**
+ * Could a browser launched under this (dead) owner's receipt still be running?
+ * A persistent launch records its profile as `identity`: any process holding that --user-data-dir
+ * is the browser. Otherwise (Playwright's own temp profile) fall back to the only thing a dead
+ * Playwright owner can leave behind: an orphaned (ppid 1) pipe-driven Chromium main process born
+ * after the owner. Anything unmeasurable answers 'unknown', which keeps the lease.
+ */
+function browserMayStillRun(owner, procs = listProcesses()) {
+    if (!procs)
+        return 'unknown';
+    const id = typeof owner.identity === 'string' ? owner.identity : '';
+    if (node_path_1.default.isAbsolute(id)) {
+        const dirs = new Set([id]);
+        try {
+            dirs.add(node_fs_1.default.realpathSync(id));
+        }
+        catch { /* profile already removed */ }
+        for (const d of [...dirs])
+            dirs.add(d.startsWith('/private/') ? d.slice('/private'.length) : `/private${d}`);
+        return procs.some((p) => [...dirs].some((d) => hasUserDataDir(p.command, d)));
+    }
+    const born = Date.parse(owner.start);
+    return procs.some((p) => {
+        if (p.ppid !== 1 || !p.command.includes('--remote-debugging-pipe') || p.command.includes(' --type='))
+            return false;
+        const t = Date.parse(p.start);
+        return !Number.isFinite(born) || !Number.isFinite(t) || t >= born - 1000;
+    });
+}
+// A RESERVED lease is stale as soon as its owner is dead or its pid was reused. A LAUNCHING lease
+// is stale only when, in addition, no browser it could have started is still running: a Node
+// owner that dies mid-launch (SIGKILL, crash, harness timeout) takes its pipe-driven Chromium down
+// with it, and before this check that left the slot held forever by a dead pid and no browser.
+function slotIsStale(file, alive = pidAlive, birth = startStamp, browser = browserMayStillRun) {
+    let raw;
+    try {
+        raw = node_fs_1.default.readFileSync(file, 'utf8');
+    }
+    catch {
+        return { stale: false, raw: null };
+    }
+    let owner;
+    try {
+        owner = JSON.parse(raw);
+    }
+    catch {
+        return { stale: false, raw };
+    }
+    if (!owner || typeof owner !== 'object' || owner.protocol !== 2 || (owner.state !== 'reserved' && owner.state !== 'launching') || typeof owner.nonce !== 'string' || !owner.nonce || !Number.isSafeInteger(owner.pid) || owner.pid <= 0 || typeof owner.start !== 'string' || !owner.start)
+        return { stale: false, raw };
+    const state = alive(owner.pid);
+    if (state === 'unknown')
+        return { stale: false, raw };
+    if (state !== false) {
+        const now = birth(owner.pid);
+        if (!now || owner.start === now)
+            return { stale: false, raw };
+    }
+    if (owner.state === 'launching' && browser(owner) !== false)
+        return { stale: false, raw };
+    return { stale: true, raw };
+}
+function aborted(signal) {
+    if (signal?.aborted)
+        throw new Error('Browser admission aborted');
+}
+function delay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        aborted(signal);
+        const done = () => { signal?.removeEventListener('abort', cancel); resolve(); };
+        const timer = setTimeout(done, ms);
+        const cancel = () => { clearTimeout(timer); signal?.removeEventListener('abort', cancel); reject(new Error('Browser admission aborted')); };
+        signal?.addEventListener('abort', cancel, { once: true });
+    });
+}
+function underMutex(container, action) {
+    const mutex = node_path_1.default.join(container, 'mutex');
+    try {
+        node_fs_1.default.mkdirSync(mutex);
+    }
+    catch (e) {
+        if (['EEXIST', 'ENOTDIR', 'ENOENT'].includes(e.code ?? ''))
+            return { acquired: false };
+        throw e;
+    }
+    try {
+        return { acquired: true, value: action() };
+    }
+    finally {
+        node_fs_1.default.rmdirSync(mutex);
+    }
+}
+/** One unique lease per actual launch; callers must beginLaunch immediately before launching. */
+async function acquireHostBrowserSlot(options = {}) {
+    const cap = hostBrowserCap();
+    const waitMs = waitBudget();
+    aborted(options.signal);
+    const nonce = (0, node_crypto_1.randomUUID)();
+    if (!cap)
+        return { nonce, beginLaunch: async () => { aborted(options.signal); }, release: async () => undefined };
+    const dir = process.env.HELIX_HEADLESS_SLOT_DIR ?? node_path_1.default.join(node_os_1.default.homedir(), '.cache/helix-headless-slots');
+    node_fs_1.default.mkdirSync(dir, { recursive: true });
+    const receipt = { protocol: 2, nonce, pid: process.pid, start: startStamp(process.pid), state: 'reserved', at: new Date().toISOString(), identity: options.identity };
+    const began = Date.now();
+    for (;;) {
+        aborted(options.signal);
+        let sameProcessHolder = false;
+        for (let k = 0; k < cap; k++) {
+            const container = node_path_1.default.join(dir, `slot-${k}`);
+            try {
+                node_fs_1.default.mkdirSync(container);
+            }
+            catch (e) {
+                if (e.code !== 'EEXIST')
+                    throw e;
+            }
+            const file = node_path_1.default.join(container, 'lease.json');
+            const claim = underMutex(container, () => {
+                if (node_fs_1.default.existsSync(file)) {
+                    // CLI and workspace modules have independent in-memory maps. Read the
+                    // common receipt under this mutex so mixed APIs cannot wait on self.
+                    try {
+                        const owner = JSON.parse(node_fs_1.default.readFileSync(file, 'utf8'));
+                        if (owner?.protocol === 2 && owner.pid === receipt.pid &&
+                            (owner.state === 'reserved' || owner.state === 'launching') &&
+                            (!owner.start || !receipt.start || owner.start === receipt.start))
+                            sameProcessHolder = true;
+                    }
+                    catch { /* corrupt ownership stays occupied */ }
+                    if (!slotIsStale(file).stale)
+                        return false;
+                    node_fs_1.default.unlinkSync(file); // read and remove under the SAME mutex, never read+rename CAS
+                }
+                node_fs_1.default.writeFileSync(file, JSON.stringify(receipt), { flag: 'wx' });
+                return true;
+            });
+            if (!claim.value)
+                continue;
+            let released = false;
+            const mutate = async (remove) => {
+                if (released) {
+                    if (!remove)
+                        throw new Error('Browser lease was already released');
+                    return;
+                }
+                const deadline = Date.now() + 2000;
+                for (;;) {
+                    const changed = underMutex(container, () => {
+                        const current = JSON.parse(node_fs_1.default.readFileSync(file, 'utf8'));
+                        if (current?.nonce !== nonce || current.pid !== receipt.pid || current.start !== receipt.start)
+                            throw new Error('Browser lease ownership changed; refusing mutation');
+                        if (remove)
+                            node_fs_1.default.unlinkSync(file);
+                        else {
+                            receipt.state = 'launching';
+                            node_fs_1.default.writeFileSync(file, JSON.stringify(receipt));
+                        }
+                    });
+                    if (changed.acquired) {
+                        if (remove) {
+                            released = true;
+                            forget();
+                        }
+                        return;
+                    }
+                    if (Date.now() >= deadline)
+                        throw new Error(`Browser lease mutex unavailable; retained ${file}`);
+                    await delay(20);
+                }
+            };
+            const forget = () => { held.delete(nonce); hooks.releasers.delete(releaseSync); syncHookRefresh(); };
+            // Synchronous best-effort release for process exit; leaves the receipt if the mutex stays busy.
+            const releaseSync = () => {
+                if (released)
+                    return;
+                for (const until = Date.now() + 500; Date.now() < until; sleepSync(10)) {
+                    const changed = underMutex(container, () => {
+                        let current;
+                        try {
+                            current = JSON.parse(node_fs_1.default.readFileSync(file, 'utf8'));
+                        }
+                        catch {
+                            return;
+                        }
+                        if (current?.nonce === nonce && current.pid === receipt.pid && current.start === receipt.start)
+                            node_fs_1.default.unlinkSync(file);
+                    });
+                    if (changed.acquired) {
+                        released = true;
+                        return;
+                    }
+                }
+            };
+            const lease = {
+                file, nonce,
+                beginLaunch: async () => { aborted(options.signal); await mutate(false); aborted(options.signal); },
+                release: () => mutate(true),
+            };
+            held.set(nonce, lease);
+            hooks.releasers.add(releaseSync);
+            syncHookRefresh();
+            if (options.signal?.aborted) {
+                await lease.release();
+                aborted(options.signal);
+            }
+            return lease;
+        }
+        // Fail promptly if this process already owns browsers. Waiting here may deadlock
+        // a Promise.all fanout whose cleanup cannot run until every launch resolves.
+        if (sameProcessHolder || [...held.values()].some((lease) => lease.file?.startsWith(`${dir}${node_path_1.default.sep}`)))
+            throw new Error(`Browser capacity exhausted while this process holds leases (cap ${cap}); serialize browser fanout and close each browser before launching another`);
+        if (Date.now() - began >= waitMs)
+            throw new Error(`No browser slot free after ${waitMs}ms (host cap ${cap} in ${dir}); legacy receipts or interrupted mutexes require a quiescent migration`);
+        await delay(Math.min(100, waitMs - (Date.now() - began)), options.signal);
+    }
+}
+/** Explicit lease only; there is no process-wide release that could free live browsers. */
+async function releaseHostBrowserSlot(lease) { await lease.release(); }
+/** Bind admission to actual teardown. A rejected close keeps the lease unless an
+ * independent close/disconnected event confirms the browser is gone. */
+function bindBrowserLease(browser, lease, event) {
+    let releasePromise;
+    const release = () => releasePromise ??= lease.release().catch((e) => { releasePromise = undefined; throw e; });
+    browser.once?.(event, () => { void release().catch((e) => console.error('Browser lease retained after teardown:', e)); });
+    const close = browser.close.bind(browser);
+    browser.close = async (...args) => { await close(...args); await release(); };
+    return browser;
+}
+/** A launch rejection means Playwright completed its failed-launch cleanup. */
+async function launchWithBrowserSlot(launch, event, options = {}) {
+    const lease = await acquireHostBrowserSlot(options);
+    let browser;
+    try {
+        await lease.beginLaunch();
+        browser = await launch();
+    }
+    catch (e) {
+        // A failed release must not mask the launch error; the exit hook / stale reclaim covers it.
+        await lease.release().catch(() => undefined);
+        throw e;
+    }
+    bindBrowserLease(browser, lease, event);
+    if (options.signal?.aborted) {
+        await browser.close();
+        throw new Error('Browser launch aborted');
+    }
+    return browser;
+}
+//# sourceMappingURL=hostSlots.js.map

package/dist/browser/hostSlots.js.map

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

package/dist/browser/launch.d.ts

@@ -0,0 +1,25 @@
+import type { LaunchOptions } from 'playwright';
+export declare const HEADLESS_GL_ARGS: string[];
+export declare const GPU_GL_ARGS: string[];
+export type BrowserKey = 'bundled' | 'chromium' | 'chrome' | 'msedge';
+export type BrowserCandidate = {
+    key: BrowserKey;
+    label: string;
+    launchOptions: LaunchOptions;
+};
+export declare function cachedChromiumCandidate(args: string[], cached?: string | undefined): BrowserCandidate[];
+export declare function browserCandidates(cached?: string): BrowserCandidate[];
+export declare function gpuBrowserCandidates(cached?: string): BrowserCandidate[];
+export declare function selectBrowserCandidates(browser: BrowserKey | undefined, cached?: string): BrowserCandidate[];
+export type LaunchAttempt = {
+    key: BrowserKey;
+    label: string;
+    message: string;
+};
+export declare function composeLaunchFailure(attempts: LaunchAttempt[]): string;
+export type HelperTimeoutState = 'absent' | 'present';
+export type TimeoutAdvice = {
+    absent: string;
+    present: string;
+};
+export declare function composeTimeoutDiagnosisWith(state: HelperTimeoutState, errors: string[], advice: TimeoutAdvice): string;

package/dist/browser/launch.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GPU_GL_ARGS = exports.HEADLESS_GL_ARGS = void 0;
+exports.cachedChromiumCandidate = cachedChromiumCandidate;
+exports.browserCandidates = browserCandidates;
+exports.gpuBrowserCandidates = gpuBrowserCandidates;
+exports.selectBrowserCandidates = selectBrowserCandidates;
+exports.composeLaunchFailure = composeLaunchFailure;
+exports.composeTimeoutDiagnosisWith = composeTimeoutDiagnosisWith;
+const nonSystemChrome_1 = require("./nonSystemChrome");
+// Software-GL flags: headless Chromium has no real GPU, so WebGL must render via SwiftShader.
+exports.HEADLESS_GL_ARGS = ['--use-angle=swiftshader', '--enable-unsafe-swiftshader'];
+// Real-GPU flags: nothing forces software GL, and the blocklist is ignored so a headless run still gets the
+// hardware backend on the driver/VM combinations Chrome distrusts.
+exports.GPU_GL_ARGS = ['--ignore-gpu-blocklist'];
+// macOS only: a cached Playwright Chromium ("Google Chrome for Testing", its own bundle id) is tried before the user's
+// system Chrome, because an automated headless /Applications/Google Chrome.app registers as the user's own Chrome in
+// LaunchServices and hijacks their Dock icon and Cmd-Q. `cached` is injectable so the chain stays unit-testable.
+function cachedChromiumCandidate(args, cached = process.platform === 'darwin' ? (0, nonSystemChrome_1.findCachedAutomationChromium)() : undefined) {
+    return cached ? [{ key: 'chromium', label: 'Playwright Chromium (Chrome for Testing)', launchOptions: { headless: true, args, executablePath: cached } }] : [];
+}
+// Ordered fallback chain for `chromium.launch()`: the pinned bundled build first (most
+// deterministic), then a cached Playwright Chromium on macOS, then whichever system browser is already
+// installed — so first-run works without the ~150 MB download on machines that already have Chrome or Edge.
+function browserCandidates(cached) {
+    return [
+        { key: 'bundled', label: 'bundled Chromium', launchOptions: { headless: true, args: exports.HEADLESS_GL_ARGS } },
+        ...cachedChromiumCandidate(exports.HEADLESS_GL_ARGS, cached),
+        { key: 'chrome', label: 'system Chrome', launchOptions: { headless: true, args: exports.HEADLESS_GL_ARGS, channel: 'chrome' } },
+        { key: 'msedge', label: 'system Edge', launchOptions: { headless: true, args: exports.HEADLESS_GL_ARGS, channel: 'msedge' } },
+    ];
+}
+// The GPU chain: full browsers only. Playwright's bundled build is the headless SHELL, which carries no
+// hardware GL backend at all — it renders through SwiftShader whatever flags it is handed. On macOS the cached
+// Chrome for Testing (full Chromium, real Metal/WebGPU) leads, so the user's own Chrome is only a last resort.
+function gpuBrowserCandidates(cached) {
+    return [
+        ...cachedChromiumCandidate(exports.GPU_GL_ARGS, cached),
+        { key: 'chrome', label: 'system Chrome', launchOptions: { headless: true, args: exports.GPU_GL_ARGS, channel: 'chrome' } },
+        { key: 'msedge', label: 'system Edge', launchOptions: { headless: true, args: exports.GPU_GL_ARGS, channel: 'msedge' } },
+    ];
+}
+// Pure so the "forced candidate, no fallback" plan is unit-testable without Playwright.
+function selectBrowserCandidates(browser, cached) {
+    return browser ? browserCandidates(cached).filter((c) => c.key === browser) : browserCandidates(cached);
+}
+// Pure so the "everything failed" message is unit-testable without Playwright. The install hint only
+// makes sense when the bundled build was among the attempts — forcing a system browser that's simply
+// not installed can't be fixed by `--install`, which only downloads the pinned Chromium.
+function composeLaunchFailure(attempts) {
+    const tried = attempts.map((a) => a.label).join(', ');
+    const details = attempts.map((a) => `  - ${a.label}: ${a.message}`).join('\n');
+    const installHint = attempts.some((a) => a.key === 'bundled')
+        ? ' — run: helix screenshot --install to download the pinned headless browser (one-time, ~150 MB)'
+        : '';
+    // Only the GPU chain ITSELF earns the --gpu hint: a forced single system browser (--browser chrome) failed for
+    // its own reasons, and telling that run to drop a flag it never passed is noise.
+    const gpuChain = gpuBrowserCandidates().map((c) => c.key);
+    const isGpuChain = attempts.length === gpuChain.length && gpuChain.every((key) => attempts.some((a) => a.key === key));
+    const gpuHint = isGpuChain ? ' (--gpu needs a system Chrome or Edge; drop --gpu to bake on the bundled SwiftShader build)' : '';
+    return `No usable browser found — tried ${tried}${installHint}.${gpuHint}\n\n${details}`;
+}
+// Pure so the two timeout causes are unit-testable without Playwright. "absent" — the world never
+// installed the helper's window global — means a missing integration; "present" — the boot-presence
+// marker landed but ready never flipped — means the world loaded the helper but crashed during boot.
+// Each driver supplies its own recovery advice: the screenshot and inspect helpers have different
+// integration lines, and wrong advice is worse than none.
+function composeTimeoutDiagnosisWith(state, errors, advice) {
+    const cause = state === 'absent' ? advice.absent : advice.present;
+    if (errors.length === 0)
+        return cause;
+    return `${cause}\n\npage errors during load:\n${errors.map((line) => `  - ${line}`).join('\n')}`;
+}
+//# sourceMappingURL=launch.js.map

package/dist/browser/launch.js.map

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

package/dist/browser/nonSystemChrome.d.ts

@@ -0,0 +1,15 @@
+/** Throws when an executable path or Playwright channel would launch the user's branded Chrome. */
+export declare function assertNotSystemChrome(executablePath?: string, channel?: string, platform?: NodeJS.Platform): void;
+/** Newest Chrome for Testing / Chromium in the Playwright browser cache, regardless of which Playwright installed it. */
+export declare function findCachedAutomationChromium(home?: string, env?: NodeJS.ProcessEnv): string | undefined;
+/**
+ * The browser a macOS automated run should use: HELIX_VQA_CHROME, else the Playwright build's own Chromium, else any
+ * cached Chrome for Testing. Never the system Chrome. Returns undefined off macOS (callers keep their platform default).
+ */
+export declare function resolveAutomationChromium(opts?: {
+    override?: string;
+    playwrightDefault?: string;
+    platform?: NodeJS.Platform;
+    home?: string;
+    env?: NodeJS.ProcessEnv;
+}): string | undefined;