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

package/dist/visualQa/winChrome.d.ts

@@ -0,0 +1,92 @@
+import { type BrowserChannel } from './pinnedChrome';
+/** Primary receipt dir on the WSL disk: reboot-surviving (never os.tmpdir(), which WSL wipes on VM restart). */
+export declare function receiptDir(env?: NodeJS.ProcessEnv): string;
+/** The pre-fix location, still read (and cleaned) so receipts from older CLI builds are not stranded. */
+export declare function legacyReceiptDir(): string;
+export declare function runningInWsl(): boolean;
+/** Is the interop surface this module needs actually present? */
+export declare function windowsInteropAvailable(): boolean;
+export interface WinChromeLaunch {
+    /** `http://127.0.0.1:<port>` — hand to chromium.connectOverCDP. */
+    cdpUrl: string;
+    pid: number;
+    profileWin: string;
+    profileId: string;
+    /** The chrome.exe this launch runs (a Windows path) and where it came from (recorded in the bundle). */
+    executablePath: string;
+    channel: BrowserChannel;
+    /** Windows pid of this launch's watchdog (0 when none could be started). Ours: captured at launch. */
+    watcherPid: number;
+    /** The durable receipt this launch wrote (pid, owner identity, profile). */
+    receipt: Receipt;
+    /** Kills exactly the process tree this launch started and removes its profile. Idempotent. */
+    kill(): Promise<void>;
+}
+/** The Windows-side cache of the pinned Chrome for Testing: `%LOCALAPPDATA%\\helix\\vqa-chrome` (shared with
+ *  scripts/win-browser.sh on the VRPC box, so one install serves both). */
+export declare function windowsPinCacheWin(local: string): string;
+/**
+ * The chrome.exe a Windows render runs: HELIX_VQA_WIN_CHROME, else the pinned current-stable Chrome for Testing (win64),
+ * installed from WSL into the Windows-side cache on first use. Never Playwright's bundled pre-stable Chromium (measured
+ * 2026-10-03: chromium-1243 = 153.0.8010.12 carries a WGSL compiler bug no stable user has).
+ */
+export declare function findWindowsChrome(opts?: {
+    refresh?: boolean;
+}): Promise<{
+    executablePath: string;
+    channel: BrowserChannel;
+    version?: string;
+}>;
+export interface Receipt {
+    pid: number;
+    owner: number;
+    /** Linux boot id + owner start time: a pid alone is recycled the moment WSL restarts. Absent on legacy receipts. */
+    bootId?: string;
+    ownerStart?: string;
+    distro?: string;
+    profileWin: string;
+    profileId: string;
+    startedAt?: number;
+}
+/** Is the Linux process that launched this Chrome still the same live process? Unknown counts as alive (never reap
+ *  on a guess): a receipt from another WSL distro cannot be judged from here. */
+export declare function ownerAlive(rec: Receipt, now?: {
+    bootId?: string;
+    distro?: string;
+}): boolean;
+export declare function validReceipt(rec: unknown): rec is Receipt;
+/** Everything the reaper touches, injectable so the safety properties are unit-testable without Windows. */
+export interface ReaperDeps {
+    /** Receipt dirs to read, as plain directories (WSL-disk dirs, the Windows-side dir translated to /mnt/c/...). */
+    dirs: string[];
+    ownerAlive(rec: Receipt): boolean;
+    /** Command line of the Windows process with this pid; '' when there is no such process; null when it could not be asked. */
+    commandLine(pid: number): string | null;
+    killTree(pid: number): void;
+    removeProfile(profileWin: string): void;
+}
+/** Reap Chromes whose owning Linux process is gone. Touches only pids WE recorded, only after the owner is provably
+ *  dead, and only while that pid's command line still carries our profile id; a recycled pid is never signalled. */
+export declare function sweepReceipts(deps: ReaperDeps): number;
+/** Reap Windows Chromes whose owning Linux process died without cleaning up (SIGKILL, timeout, WSL crash). */
+export declare function sweepStaleWindowsChromes(): number;
+/** The Windows-side watchdog. Pure string so its safety properties are unit-testable: it signals only the captured
+ *  pid, only while that pid's command line carries our profile id, never by name. */
+export declare function watchdogScript(o: {
+    pid: number;
+    profileId: string;
+    profileWin: string;
+    heartbeatWin: string;
+    receiptWin: string;
+}): string;
+/** Linux half of the heartbeat: touches the file while the owner lives and the file exists, then exits by itself. */
+export declare function heartbeatLoop(): string;
+export interface WinChromeOptions {
+    args: string[];
+    /** Seconds to wait for DevToolsActivePort. */
+    startTimeoutMs?: number;
+}
+/** Memory-saving defaults for a throwaway headless render (Windows commit is the scarce resource on the VRPC box).
+ *  None of these touches rendering or the GPU path; caller args come after, so a caller can still override. */
+export declare const MEMORY_ARGS: readonly string[];
+export declare function launchWindowsChrome(opts: WinChromeOptions): Promise<WinChromeLaunch>;

package/dist/visualQa/winChrome.js

@@ -0,0 +1,445 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MEMORY_ARGS = void 0;
+exports.receiptDir = receiptDir;
+exports.legacyReceiptDir = legacyReceiptDir;
+exports.runningInWsl = runningInWsl;
+exports.windowsInteropAvailable = windowsInteropAvailable;
+exports.windowsPinCacheWin = windowsPinCacheWin;
+exports.findWindowsChrome = findWindowsChrome;
+exports.ownerAlive = ownerAlive;
+exports.validReceipt = validReceipt;
+exports.sweepReceipts = sweepReceipts;
+exports.sweepStaleWindowsChromes = sweepStaleWindowsChromes;
+exports.watchdogScript = watchdogScript;
+exports.heartbeatLoop = heartbeatLoop;
+exports.launchWindowsChrome = launchWindowsChrome;
+// Windows-native headless Chromium, driven from WSL over CDP.
+//
+// Inside WSL the only Chrome is the Linux build, and WSL has no NVIDIA Vulkan, so it renders on SwiftShader (the CPU,
+// ~2x slower, multi-second stalls, wrong GPU in the bundle). A Windows Chromium sees the real GPU through D3D11. WSL's
+// interop lets a Linux process start a Windows executable, and with mirrored networking 127.0.0.1 is the same loopback
+// on both sides, so we start chrome.exe headless with a throwaway profile and `remote-debugging-port=0`, read the port
+// from the profile's DevToolsActivePort file, and `connectOverCDP` to it.
+//
+// Safety rails (these are why this is a module and not a one-liner):
+//   - HEADLESS ALWAYS (`--headless=new`); never a visible window.
+//   - A throwaway profile per launch, deleted on close; never the user's profile, never the credential store.
+//   - We record the Windows pid we started and only ever `taskkill /T /F /PID <that pid>`. A receipt lets a later run
+//     reap a launch whose owner died (after checking the pid still has OUR profile id on its command line, so a
+//     recycled pid is never touched). Nothing is ever matched by name.
+//   - Receipts must outlive the thing that kills them. WSL's /tmp is wiped whenever the WSL VM restarts, and a WSL
+//     crash is exactly when Windows Chromes get orphaned, so the receipt is written to TWO reboot-surviving places: a
+//     per-user cache dir on the WSL disk (HELIX_VQA_WINCHROME_REGISTRY overrides) and a registry dir on the Windows
+//     side under %LOCALAPPDATA% that survives the loss of the WSL disk. The old os.tmpdir() location is still read.
+//   - The Windows side contains its own Chrome. Each launch also starts a hidden PowerShell watchdog (a Windows
+//     process, so it survives a WSL crash) that kills the receipted pid's tree, and only that pid, once the owner's
+//     heartbeat file (touched every 10 s by a tiny Linux loop that dies with the owner) goes stale or disappears. It
+//     applies the same guard as the sweep: the pid's command line must still carry our profile id.
+const node_child_process_1 = require("node:child_process");
+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 node_crypto_1 = __importDefault(require("node:crypto"));
+const pinnedChrome_1 = require("./pinnedChrome");
+const POWERSHELL = process.env.HELIX_VQA_POWERSHELL ?? '/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe';
+const POWERSHELL_WIN = 'powershell.exe';
+const CMD = process.env.HELIX_VQA_WIN_CMD ?? '/mnt/c/Windows/System32/cmd.exe';
+const TASKKILL = process.env.HELIX_VQA_WIN_TASKKILL ?? '/mnt/c/Windows/System32/taskkill.exe';
+const REGISTRY_NAME = 'helix-vqa-winchrome';
+const PROFILE_PREFIX = 'helix-vqa-win-';
+const PROFILE_ID_RE = /^helix-vqa-win-[0-9a-f]{12}$/;
+/** Primary receipt dir on the WSL disk: reboot-surviving (never os.tmpdir(), which WSL wipes on VM restart). */
+function receiptDir(env = process.env) {
+    if (env.HELIX_VQA_WINCHROME_REGISTRY)
+        return env.HELIX_VQA_WINCHROME_REGISTRY;
+    const cache = env.XDG_CACHE_HOME || node_path_1.default.join(env.HOME || node_os_1.default.homedir(), '.cache');
+    return node_path_1.default.join(cache, 'helix', REGISTRY_NAME);
+}
+/** The pre-fix location, still read (and cleaned) so receipts from older CLI builds are not stranded. */
+function legacyReceiptDir() { return node_path_1.default.join(node_os_1.default.tmpdir(), REGISTRY_NAME); }
+function runningInWsl() {
+    if (process.platform !== 'linux')
+        return false;
+    try {
+        return /microsoft/i.test(node_fs_1.default.readFileSync('/proc/version', 'utf8'));
+    }
+    catch {
+        return false;
+    }
+}
+/** Is the interop surface this module needs actually present? */
+function windowsInteropAvailable() {
+    return runningInWsl() && node_fs_1.default.existsSync(POWERSHELL) && node_fs_1.default.existsSync(CMD);
+}
+function ps(command, timeoutMs = 30_000) {
+    const encoded = Buffer.from(command, 'utf16le').toString('base64');
+    const r = (0, node_child_process_1.spawnSync)(POWERSHELL, ['-NoProfile', '-NonInteractive', '-EncodedCommand', encoded], {
+        encoding: 'utf8', cwd: '/mnt/c', timeout: timeoutMs, windowsHide: true,
+    });
+    return { stdout: (r.stdout ?? '').replace(/\r/g, ''), status: r.status };
+}
+function winEnv(name) {
+    const r = (0, node_child_process_1.spawnSync)(CMD, ['/c', `echo %${name}%`], { encoding: 'utf8', cwd: '/mnt/c', timeout: 15_000 });
+    return (r.stdout ?? '').replace(/\r|\n/g, '').trim();
+}
+function toWsl(winPath) {
+    const r = (0, node_child_process_1.spawnSync)('wslpath', ['-u', winPath], { encoding: 'utf8' });
+    const out = (r.stdout ?? '').trim();
+    if (r.status !== 0 || !out)
+        throw new Error(`wslpath could not translate ${winPath}`);
+    return out;
+}
+/** The Windows-side cache of the pinned Chrome for Testing: `%LOCALAPPDATA%\\helix\\vqa-chrome` (shared with
+ *  scripts/win-browser.sh on the VRPC box, so one install serves both). */
+function windowsPinCacheWin(local) { return `${local}\\helix\\vqa-chrome`; }
+/**
+ * The chrome.exe a Windows render runs: HELIX_VQA_WIN_CHROME, else the pinned current-stable Chrome for Testing (win64),
+ * installed from WSL into the Windows-side cache on first use. Never Playwright's bundled pre-stable Chromium (measured
+ * 2026-10-03: chromium-1243 = 153.0.8010.12 carries a WGSL compiler bug no stable user has).
+ */
+async function findWindowsChrome(opts = {}) {
+    const override = process.env.HELIX_VQA_WIN_CHROME;
+    if (override)
+        return { executablePath: override, channel: 'env-override' };
+    const local = winEnv('LOCALAPPDATA');
+    if (!local || local.includes('%'))
+        throw new Error('could not resolve %LOCALAPPDATA% through WSL interop');
+    const cacheWin = windowsPinCacheWin(local);
+    const cacheWsl = toWsl(cacheWin);
+    const pin = await (0, pinnedChrome_1.ensurePinnedChrome)({
+        platform: 'win64',
+        cacheDir: cacheWsl,
+        refresh: opts.refresh,
+        toLaunchPath: (p) => `${cacheWin}\\${node_path_1.default.relative(cacheWsl, p).split(node_path_1.default.sep).join('\\')}`,
+        log: (m) => console.error(`[visual-qa] ${m}`),
+    });
+    return { executablePath: pin.executablePath, channel: 'pinned-cft', version: pin.version };
+}
+function taskkillTree(pid) {
+    (0, node_child_process_1.spawnSync)(TASKKILL, ['/T', '/F', '/PID', String(pid)], { stdio: 'ignore', cwd: '/mnt/c', timeout: 20_000 });
+}
+function processAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e.code === 'EPERM';
+    }
+}
+function readProcStart(pid) {
+    try {
+        const stat = node_fs_1.default.readFileSync(`/proc/${pid}/stat`, 'utf8');
+        return stat.slice(stat.lastIndexOf(')') + 2).split(' ')[19] ?? null; // field 22 (starttime), after "pid (comm) "
+    }
+    catch {
+        return null;
+    }
+}
+function readBootId() {
+    try {
+        return node_fs_1.default.readFileSync('/proc/sys/kernel/random/boot_id', 'utf8').trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Is the Linux process that launched this Chrome still the same live process? Unknown counts as alive (never reap
+ *  on a guess): a receipt from another WSL distro cannot be judged from here. */
+function ownerAlive(rec, now = { bootId: readBootId(), distro: process.env.WSL_DISTRO_NAME }) {
+    if (rec.bootId && now.bootId && rec.bootId !== now.bootId)
+        return false; // WSL VM restarted since: the owner is certainly gone
+    if (rec.distro && now.distro && rec.distro !== now.distro)
+        return true; // different pid namespace; cannot tell
+    if (rec.ownerStart) {
+        const start = readProcStart(rec.owner);
+        return start !== null && start === rec.ownerStart;
+    }
+    return processAlive(rec.owner);
+}
+function validReceipt(rec) {
+    const r = rec;
+    return !!r && Number.isInteger(r.pid) && r.pid > 0 && Number.isInteger(r.owner) && typeof r.profileId === 'string'
+        && PROFILE_ID_RE.test(r.profileId) && typeof r.profileWin === 'string' && r.profileWin.endsWith(`\\${r.profileId}`);
+}
+/** Reap Chromes whose owning Linux process is gone. Touches only pids WE recorded, only after the owner is provably
+ *  dead, and only while that pid's command line still carries our profile id; a recycled pid is never signalled. */
+function sweepReceipts(deps) {
+    let reaped = 0;
+    const seen = new Set();
+    for (const dir of deps.dirs) {
+        let names = [];
+        try {
+            names = node_fs_1.default.readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const f of names) {
+            if (!f.endsWith('.json'))
+                continue;
+            const file = node_path_1.default.join(dir, f);
+            let rec;
+            try {
+                rec = JSON.parse(node_fs_1.default.readFileSync(file, 'utf8'));
+            }
+            catch {
+                continue;
+            } // unreadable: not ours to judge, leave it
+            if (!validReceipt(rec))
+                continue;
+            if (seen.has(rec.profileId))
+                continue; // same launch mirrored in several dirs: handle once
+            if (deps.ownerAlive(rec))
+                continue;
+            const cmd = deps.commandLine(rec.pid);
+            if (cmd === null)
+                continue; // could not ask Windows: keep the receipt, try again next sweep
+            seen.add(rec.profileId);
+            if (cmd.includes(rec.profileId)) {
+                deps.killTree(rec.pid);
+                reaped++;
+            }
+            deps.removeProfile(rec.profileWin);
+            for (const d of deps.dirs) {
+                node_fs_1.default.rmSync(node_path_1.default.join(d, `${rec.profileId}.json`), { force: true });
+                node_fs_1.default.rmSync(node_path_1.default.join(d, `${rec.profileId}.hb`), { force: true });
+            }
+        }
+    }
+    return reaped;
+}
+let localAppDataCache;
+function localAppData() {
+    return (localAppDataCache ??= winEnv('LOCALAPPDATA'));
+}
+function winRegistryDirWin(local) { return `${local}\\${REGISTRY_NAME}`; }
+/** All receipt dirs as WSL-visible paths. The Windows-side one is best effort (needs interop). */
+function receiptDirs() {
+    const dirs = [receiptDir(), legacyReceiptDir()];
+    try {
+        const local = localAppData();
+        if (local && !local.includes('%'))
+            dirs.push(toWsl(winRegistryDirWin(local)));
+    }
+    catch { /* no Windows side reachable: the WSL-side dirs still work */ }
+    return dirs;
+}
+/** Reap Windows Chromes whose owning Linux process died without cleaning up (SIGKILL, timeout, WSL crash). */
+function sweepStaleWindowsChromes() {
+    return sweepReceipts({
+        dirs: receiptDirs(),
+        ownerAlive: (rec) => ownerAlive(rec),
+        commandLine: (pid) => {
+            const r = ps(`(Get-CimInstance Win32_Process -Filter "ProcessId=${Number(pid)}").CommandLine`);
+            return r.status === 0 ? r.stdout : null;
+        },
+        killTree: taskkillTree,
+        removeProfile: rmProfile,
+    });
+}
+function rmProfile(profileWin) {
+    let p;
+    try {
+        p = toWsl(profileWin);
+    }
+    catch {
+        return;
+    }
+    if (!node_path_1.default.basename(p).startsWith(PROFILE_PREFIX))
+        return; // only ever delete a directory we created
+    for (let i = 0; i < 6; i++) {
+        try {
+            node_fs_1.default.rmSync(p, { recursive: true, force: true });
+            return;
+        }
+        catch {
+            (0, node_child_process_1.spawnSync)('sleep', ['0.4']);
+        }
+    }
+}
+/** Write the receipt to every durable dir; a dir that cannot be written is skipped as long as one works. */
+function writeReceipt(rec) {
+    const written = [];
+    const dirs = [receiptDir()];
+    try {
+        const local = localAppData();
+        if (local && !local.includes('%'))
+            dirs.push(toWsl(winRegistryDirWin(local)));
+    }
+    catch { /* WSL side only */ }
+    for (const d of dirs) {
+        try {
+            node_fs_1.default.mkdirSync(d, { recursive: true });
+            const f = node_path_1.default.join(d, `${rec.profileId}.json`);
+            node_fs_1.default.writeFileSync(f, JSON.stringify(rec));
+            written.push(f);
+        }
+        catch { /* try the next */ }
+    }
+    return written;
+}
+function removeReceiptFiles(rec) {
+    for (const d of receiptDirs()) {
+        node_fs_1.default.rmSync(node_path_1.default.join(d, `${rec.profileId}.json`), { force: true });
+        node_fs_1.default.rmSync(node_path_1.default.join(d, `${rec.profileId}.hb`), { force: true });
+    }
+}
+const HEARTBEAT_SECONDS = 10;
+const HEARTBEAT_STALE_SECONDS = 90;
+const WATCHDOG_POLL_SECONDS = 15;
+/** The Windows-side watchdog. Pure string so its safety properties are unit-testable: it signals only the captured
+ *  pid, only while that pid's command line carries our profile id, never by name. */
+function watchdogScript(o) {
+    const q = (v) => `'${v.replace(/'/g, "''")}'`;
+    return [
+        "$ErrorActionPreference = 'SilentlyContinue'",
+        `$target = ${Number(o.pid)}`,
+        `$id = ${q(o.profileId)}`,
+        `$hb = ${q(o.heartbeatWin)}`,
+        `$profile = ${q(o.profileWin)}`,
+        `$receipt = ${q(o.receiptWin)}`,
+        'while ($true) {',
+        `  Start-Sleep -Seconds ${WATCHDOG_POLL_SECONDS}`,
+        '  $proc = Get-CimInstance Win32_Process -Filter "ProcessId=$target"',
+        '  if (-not $proc -or -not $proc.CommandLine -or -not $proc.CommandLine.Contains($id)) { break }', // gone, or a recycled pid
+        '  $f = Get-Item -LiteralPath $hb',
+        `  if ($f -and ((Get-Date) - $f.LastWriteTime).TotalSeconds -lt ${HEARTBEAT_STALE_SECONDS}) { continue }`,
+        '  & taskkill.exe /T /F /PID $target | Out-Null',
+        '  break',
+        '}',
+        'Start-Sleep -Seconds 1',
+        `if ((Split-Path -Leaf $profile).StartsWith(${q(PROFILE_PREFIX)})) { Remove-Item -LiteralPath $profile -Recurse -Force }`,
+        'Remove-Item -LiteralPath $receipt, $hb -Force',
+    ].join('\n');
+}
+/** Linux half of the heartbeat: touches the file while the owner lives and the file exists, then exits by itself. */
+function heartbeatLoop() {
+    return `while kill -0 "$2" 2>/dev/null && [ -e "$1" ]; do touch "$1"; sleep ${HEARTBEAT_SECONDS}; done`;
+}
+/** Start the Windows watchdog for a launch. Best effort: a launch without one is still receipted and swept. */
+function startWatchdog(rec, local) {
+    try {
+        const regWin = winRegistryDirWin(local);
+        const hbWin = `${regWin}\\${rec.profileId}.hb`;
+        const hb = toWsl(hbWin);
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(hb), { recursive: true });
+        node_fs_1.default.writeFileSync(hb, String(Date.now()));
+        (0, node_child_process_1.spawn)('sh', ['-c', heartbeatLoop(), 'sh', hb, String(process.pid)], { detached: true, stdio: 'ignore' }).unref();
+        const script = watchdogScript({ pid: rec.pid, profileId: rec.profileId, profileWin: rec.profileWin, heartbeatWin: hbWin, receiptWin: `${regWin}\\${rec.profileId}.json` });
+        const encoded = Buffer.from(script, 'utf16le').toString('base64');
+        const r = ps(`$w = Start-Process -FilePath '${POWERSHELL_WIN}' -ArgumentList @('-NoProfile','-NonInteractive','-EncodedCommand','${encoded}') -PassThru -WindowStyle Hidden; $w.Id`);
+        const watcherPid = Number(r.stdout.trim().split('\n').pop());
+        return Number.isInteger(watcherPid) && watcherPid > 0 ? { watcherPid, heartbeat: hb } : null;
+    }
+    catch {
+        return null;
+    }
+}
+let handlersInstalled = false;
+const live = new Set();
+function installExitHandlers() {
+    if (handlersInstalled)
+        return;
+    handlersInstalled = true;
+    const killAllSync = () => {
+        for (const l of [...live]) {
+            taskkillTree(l.pid);
+            if (l.watcherPid)
+                taskkillTree(l.watcherPid);
+            (0, node_child_process_1.spawnSync)('sleep', ['0.5']);
+            rmProfile(l.profileWin);
+            removeReceiptFiles(l.receipt);
+        }
+    };
+    process.on('exit', killAllSync);
+    for (const sig of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+        process.on(sig, () => { killAllSync(); process.exit(128 + (sig === 'SIGINT' ? 2 : sig === 'SIGTERM' ? 15 : 1)); });
+    }
+}
+/** Memory-saving defaults for a throwaway headless render (Windows commit is the scarce resource on the VRPC box).
+ *  None of these touches rendering or the GPU path; caller args come after, so a caller can still override. */
+exports.MEMORY_ARGS = [
+    '--disable-extensions',
+    '--disable-background-networking',
+    '--disable-component-update',
+    '--disable-default-apps',
+    '--renderer-process-limit=4',
+];
+async function launchWindowsChrome(opts) {
+    if (!windowsInteropAvailable())
+        throw new Error('Windows Chrome needs WSL with interop (powershell.exe/cmd.exe not reachable)');
+    installExitHandlers();
+    // A previous launch whose owner was SIGKILLed / timed out / lost to a WSL crash left its tree behind: reap it now.
+    try {
+        sweepStaleWindowsChromes();
+    }
+    catch { /* best effort; never block a launch on housekeeping */ }
+    const { executablePath: exe, channel } = await findWindowsChrome();
+    const local = localAppData();
+    const profileId = `${PROFILE_PREFIX}${node_crypto_1.default.randomBytes(6).toString('hex')}`;
+    const profileWin = `${local}\\Temp\\${profileId}`;
+    const profileWsl = toWsl(profileWin);
+    const args = [
+        '--headless=new', // hard rail: never a visible window
+        '--remote-debugging-port=0',
+        `--user-data-dir=${profileWin}`,
+        ...exports.MEMORY_ARGS,
+        ...opts.args,
+        'about:blank',
+    ];
+    const quoted = args.map((a) => `'${a.replace(/'/g, "''")}'`).join(',');
+    const started = ps(`$p = Start-Process -FilePath '${exe.replace(/'/g, "''")}' -ArgumentList @(${quoted}) -PassThru -WindowStyle Hidden; $p.Id`);
+    const pid = Number(started.stdout.trim().split('\n').pop());
+    if (!Number.isInteger(pid) || pid <= 0)
+        throw new Error(`could not start Windows Chrome (${started.stdout.trim().slice(0, 200)})`);
+    const receipt = {
+        pid, owner: process.pid, bootId: readBootId(), ownerStart: readProcStart(process.pid) ?? undefined,
+        distro: process.env.WSL_DISTRO_NAME, profileWin, profileId, startedAt: Date.now(),
+    };
+    writeReceipt(receipt);
+    const watchdog = startWatchdog(receipt, local);
+    let killed = false;
+    const launch = {
+        cdpUrl: '',
+        executablePath: exe,
+        channel,
+        pid,
+        profileWin,
+        profileId,
+        receipt,
+        watcherPid: watchdog?.watcherPid ?? 0,
+        async kill() {
+            if (killed)
+                return;
+            killed = true;
+            live.delete(launch);
+            taskkillTree(pid);
+            if (launch.watcherPid)
+                taskkillTree(launch.watcherPid);
+            await new Promise((r) => setTimeout(r, 500));
+            rmProfile(profileWin);
+            removeReceiptFiles(receipt);
+        },
+    };
+    live.add(launch);
+    const deadline = Date.now() + (opts.startTimeoutMs ?? 45_000);
+    const portFile = node_path_1.default.join(profileWsl, 'DevToolsActivePort');
+    while (Date.now() < deadline) {
+        if (node_fs_1.default.existsSync(portFile)) {
+            const port = Number(node_fs_1.default.readFileSync(portFile, 'utf8').split('\n')[0]);
+            if (port > 0) {
+                launch.cdpUrl = `http://127.0.0.1:${port}`;
+                return launch;
+            }
+        }
+        await new Promise((r) => setTimeout(r, 250));
+    }
+    await launch.kill();
+    throw new Error('Windows Chrome did not publish a DevTools port in time');
+}
+//# sourceMappingURL=winChrome.js.map

package/dist/visualQa/winChrome.js.map

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

package/dist/visualQa/worldWalk.d.ts

@@ -0,0 +1,59 @@
+import type { Frame, Page } from 'playwright';
+import type { RenderContext } from './harness';
+import type { VisualQaAssert, VisualQaFrame } from './types';
+export declare const WORLD_WALK_REVISION = "world-walk@1";
+export declare const TRIAL_STORAGE_PREFIX = "helix:item-trial:v1:";
+export interface WalkStageResult {
+    frames: VisualQaFrame[];
+    asserts: VisualQaAssert[];
+    facts: Record<string, unknown>;
+    errors: string[];
+    fetchedAssets: string[];
+    renderer?: string | null;
+}
+/** The Try Now request that wears `itemId` in `slotId` on `baseId` (helixgame.com `UniversalItemTrialRequest`). */
+export declare function trialDraftRequest(baseId: string, slotId: string, itemId: string, packageVersion?: string | null): Record<string, unknown>;
+/** What helixgame.com stores for a `tryDraft` launch (`storeTrialLaunch`): bound to the signed-in account. */
+export declare function storedTrialLaunch(actorId: string, request: Record<string, unknown>): string;
+/** The add-on's slot on a base, from a `GET /universal-items/<base>/add-ons` page. */
+export declare function slotIdFromAddOns(body: unknown, itemId: string): string | null;
+export interface WalkSessionInfo {
+    baseModelUrl: string | null;
+    addOn: {
+        slotId: string;
+        itemId: string;
+        modelUrl: string | null;
+        visualOps: unknown[];
+    } | null;
+    addOns: number;
+}
+/** The parts of a Try Now session response the stage needs (never the token). */
+export declare function walkSessionInfo(json: unknown, itemId: string | null): WalkSessionInfo;
+/** A refused draft session: the backend's message, never the body (a live session carries a token). */
+export declare function describeRefusal(status: number, text: string): string;
+export declare function fetchBytes(url: string): Promise<Uint8Array | null>;
+/** Find the item's slot on a base through the base's add-ons list (the same predicate the customiser uses). */
+export declare function resolveSlotId(apiBase: string, baseId: string, itemId: string, title: string, slotType: string | null, token?: string | null): Promise<string | null>;
+/** Wear the item on one base through a Try Now draft, walk it, measure it. Owns its own browser. */
+export declare function runWearWalk(ctx: RenderContext, baseId: string, baseTitle: string): Promise<WalkStageResult>;
+export interface WalkArgs {
+    page: Page;
+    frame: Frame;
+    outDir: string;
+    /** Frame/assert subject: the base id (wearables) or the avatar's own id. */
+    subject: string;
+    subjectTitle: string;
+    itemTitle: string;
+    /** Scene names of the item's meshes (a name ending in `|` is a prefix: the composer's `compaddon:<slot>|`); empty for an
+     *  avatar (everything that is not the baked base body is its outfit). */
+    itemNames: string[];
+    /** The base (or avatar) model, for the master index of the body meshes. */
+    baseGlb: Uint8Array | null;
+    /** 'wear': an item on a base; 'avatar': a whole avatar, its outfit = every drawn mesh that is not the baked base body. */
+    mode?: 'wear' | 'avatar';
+    log: (k: string, v: unknown) => void;
+}
+/** `walk` (default: Alt held, the engine's walk tier) or `run` (HELIX_VQA_WALK_GAIT=run, the default gait of a bare W). */
+export declare function walkGait(env?: NodeJS.ProcessEnv): 'walk' | 'run';
+/** Walk the presented player and measure it. Never throws: errors are returned. */
+export declare function walkAndMeasure(a: WalkArgs): Promise<Omit<WalkStageResult, 'fetchedAssets'>>;