@wjarka/cezarion 0.15.1 → 0.16.0

package/dist/preview/chromium.js

@@ -0,0 +1,394 @@
+import { execFile, spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, writeFileSync } from 'node:fs';
+import { mkdir, mkdtemp, open, rename, rm } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { basename, delimiter, dirname, join } from 'node:path';
+import { promisify } from 'node:util';
+import { z } from 'zod';
+import { processStartToken } from '../delegation/process-liveness.js';
+export const realFs = {
+    existsSync,
+    readdirSync: path => {
+        try {
+            return readdirSync(path);
+        }
+        catch {
+            return [];
+        }
+    },
+    realpathSync: path => {
+        try {
+            return realpathSync(path);
+        }
+        catch {
+            return path;
+        }
+    },
+};
+/** `~/.cache/cez`: the root the skills cache already uses. */
+export function cezCacheDir(home = homedir()) {
+    return join(home, '.cache', 'cez');
+}
+/** Google Chrome first: a distro `chromium` is often a snap shim (Ubuntu) or a build that never
+ *  opened its DevTools port headless (a GitHub runner's /usr/bin/chromium, PR #792). */
+const PATH_NAMES = ['google-chrome', 'google-chrome-stable', 'chromium', 'chromium-browser'];
+const MAC_APPS = ['Google Chrome', 'Chromium', 'Google Chrome Canary', 'Brave Browser', 'Microsoft Edge'];
+const HEADLESS_SHELL = 'chrome-headless-shell';
+/** Where a browser binary sits inside one installed revision directory, per platform. */
+function revisionLayouts(platform) {
+    const exe = platform === 'win32' ? '.exe' : '';
+    if (platform === 'darwin') {
+        const cft = 'Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing';
+        return [
+            `chrome-mac-arm64/${cft}`,
+            `chrome-mac-x64/${cft}`,
+            cft,
+            'chrome-mac/Chromium.app/Contents/MacOS/Chromium',
+            `${HEADLESS_SHELL}-mac-arm64/${HEADLESS_SHELL}`,
+            `${HEADLESS_SHELL}-mac-x64/${HEADLESS_SHELL}`,
+        ];
+    }
+    if (platform === 'win32') {
+        return ['chrome-win64/chrome.exe', 'chrome-win/chrome.exe', 'chrome.exe', `${HEADLESS_SHELL}-win64/${HEADLESS_SHELL}${exe}`];
+    }
+    return ['chrome-linux64/chrome', 'chrome-linux/chrome', 'chrome', `${HEADLESS_SHELL}-linux64/${HEADLESS_SHELL}`, 'chrome-linux/headless_shell'];
+}
+const byRevisionDesc = (a, b) => b.localeCompare(a, undefined, { numeric: true });
+function firstBinary(fs, revisionDir, platform) {
+    return revisionLayouts(platform)
+        .map(rel => join(revisionDir, rel))
+        .find(p => fs.existsSync(p));
+}
+function firstInRevisions(fs, root, pattern, platform) {
+    for (const dir of fs.readdirSync(root).filter(d => pattern.test(d)).sort(byRevisionDesc)) {
+        const bin = firstBinary(fs, join(root, dir), platform);
+        if (bin)
+            return bin;
+    }
+    return undefined;
+}
+/** A snap's confinement keeps it out of hidden directories and /tmp, so it can never write the
+ *  task profile under `.ai/cezar/preview/` and its DevTools port file never appears. */
+function snapConfined(fs, path) {
+    return (fs.realpathSync?.(path) ?? path).startsWith('/snap/');
+}
+/**
+ * The first usable Chromium, most deliberate source first: PATH, macOS app bundles, Playwright's
+ * cache, agent-browser's Chrome for Testing cache, then the copy `downloadChromium` keeps.
+ */
+export function resolveChromium(fs = realFs, env = process.env, platform = process.platform, _arch = process.arch) {
+    const home = env.HOME || env.USERPROFILE || homedir();
+    const exe = platform === 'win32' ? '.exe' : '';
+    for (const dir of (env.PATH ?? '').split(delimiter).filter(Boolean)) {
+        for (const name of PATH_NAMES) {
+            const p = join(dir, name + exe);
+            if (fs.existsSync(p) && !snapConfined(fs, p))
+                return p;
+        }
+    }
+    if (platform === 'darwin') {
+        for (const root of ['/Applications', join(home, 'Applications')]) {
+            for (const app of MAC_APPS) {
+                const p = join(root, `${app}.app`, 'Contents', 'MacOS', app);
+                if (fs.existsSync(p))
+                    return p;
+            }
+        }
+    }
+    const playwright = env.PLAYWRIGHT_BROWSERS_PATH ||
+        (platform === 'darwin'
+            ? join(home, 'Library', 'Caches', 'ms-playwright')
+            : platform === 'win32'
+                ? join(env.LOCALAPPDATA || join(home, 'AppData', 'Local'), 'ms-playwright')
+                : join(home, '.cache', 'ms-playwright'));
+    // A full Chromium before a headless shell, the newest revision of each first.
+    const found = firstInRevisions(fs, playwright, /^chromium-\d+$/, platform) ?? firstInRevisions(fs, playwright, /^chromium_headless_shell-\d+$/, platform);
+    if (found)
+        return found;
+    // agent-browser keeps its Chrome for Testing under ~/.agent-browser/browsers/<chrome-version>/.
+    const agentBrowser = firstInRevisions(fs, join(home, '.agent-browser', 'browsers'), /^chrome-/, platform);
+    if (agentBrowser)
+        return agentBrowser;
+    const cache = join(cezCacheDir(home), 'chromium');
+    for (const dir of fs.readdirSync(cache).filter(d => d.startsWith(`${HEADLESS_SHELL}-`)).sort(byRevisionDesc)) {
+        const p = join(cache, dir, HEADLESS_SHELL + exe);
+        if (fs.existsSync(p))
+            return p;
+    }
+    return undefined;
+}
+/** The Chrome for Testing build for this machine. Google publishes none for linux-arm64. */
+export function downloadTarget(platform, arch) {
+    if (platform === 'linux' && arch === 'x64')
+        return { platformKey: 'linux64' };
+    if (platform === 'darwin' && arch === 'arm64')
+        return { platformKey: 'mac-arm64' };
+    if (platform === 'darwin' && arch === 'x64')
+        return { platformKey: 'mac-x64' };
+    if (platform === 'win32' && arch === 'x64')
+        return { platformKey: 'win64' };
+    return undefined;
+}
+/** The command that installs Chromium on this OS, or '' when cezar does not know one. `osRelease` is /etc/os-release. */
+export function installCommand(platform, osRelease) {
+    if (platform === 'darwin')
+        return 'brew install --cask chromium';
+    if (platform !== 'linux')
+        return '';
+    const field = (key) => osRelease.match(new RegExp(`^${key}=(.*)$`, 'm'))?.[1]?.replace(/^["']|["']$/g, '') ?? '';
+    const ids = [field('ID'), ...field('ID_LIKE').split(/\s+/)].filter(Boolean);
+    // Ubuntu (and its derivatives) has no `chromium` deb, only a snap; Debian proper has the package.
+    if (ids.includes('ubuntu'))
+        return 'sudo snap install chromium';
+    if (ids.includes('debian'))
+        return 'sudo apt-get install -y chromium';
+    if (ids.includes('fedora'))
+        return 'sudo dnf install -y chromium';
+    return '';
+}
+const VERSIONS_URL = 'https://googlechromelabs.github.io/chrome-for-testing/last-known-good-versions-with-downloads.json';
+const RETRY_DELAYS_MS = [1_000, 4_000];
+const versionsSchema = z.object({
+    channels: z.object({
+        Stable: z.object({
+            downloads: z.record(z.string(), z.array(z.object({ platform: z.string(), url: z.string() }))),
+        }),
+    }),
+});
+const execFileAsync = promisify(execFile);
+async function extractZip(zip, dest, platform, signal) {
+    if (platform === 'win32')
+        await execFileAsync('tar', ['-xf', zip, '-C', dest], { signal });
+    else
+        await execFileAsync('unzip', ['-q', zip, '-d', dest], { signal });
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal.aborted)
+            return reject(signal.reason);
+        const timer = setTimeout(() => {
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal.reason);
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/** A failure a retry cannot fix: a bad manifest, a missing extractor, a wrong archive layout. */
+class PermanentDownloadError extends Error {
+}
+/**
+ * Downloads the Stable `chrome-headless-shell` build into `<cache>/chromium` and returns its binary.
+ * Each download stages in its own `.partial-*` directory (two cezar processes in different repos
+ * share the cache) and is renamed into place only once unpacked, so an abort or a crash never
+ * leaves a half-installed Chromium for `resolveChromium` to find. A copy another process already
+ * published wins; ours is discarded. Only the network
+ * phase gets three attempts; a failed extraction fails at once, since re-downloading would not help.
+ */
+export async function downloadChromium(opts) {
+    const platform = opts.platform ?? process.platform;
+    const arch = opts.arch ?? process.arch;
+    const target = downloadTarget(platform, arch);
+    if (!target)
+        throw new Error(`Chrome for Testing publishes no download for ${platform}-${arch}`);
+    const root = join(opts.cacheDir ?? cezCacheDir(), 'chromium');
+    await mkdir(root, { recursive: true });
+    const partial = await mkdtemp(join(root, '.partial-'));
+    const zip = join(partial, 'chromium.zip');
+    try {
+        for (let attempt = 0;; attempt++) {
+            try {
+                await fetchArchive(opts, target.platformKey, partial, zip);
+                break;
+            }
+            catch (err) {
+                await rm(partial, { recursive: true, force: true });
+                if (opts.signal.aborted || err instanceof PermanentDownloadError)
+                    throw err;
+                const delay = RETRY_DELAYS_MS[attempt];
+                if (delay === undefined)
+                    throw err;
+                await (opts.sleep ?? sleep)(delay, opts.signal);
+            }
+        }
+        return await install(opts, target.platformKey, platform, root, partial, zip);
+    }
+    catch (err) {
+        await rm(partial, { recursive: true, force: true });
+        throw err;
+    }
+}
+async function fetchArchive(opts, platformKey, partial, zip) {
+    const doFetch = opts.fetchImpl ?? fetch;
+    const { signal } = opts;
+    const versionsRes = await doFetch(VERSIONS_URL, { signal });
+    if (!versionsRes.ok)
+        throw new Error(`Chrome for Testing version list answered ${versionsRes.status}`);
+    const versions = versionsSchema.safeParse(await versionsRes.json());
+    if (!versions.success)
+        throw new PermanentDownloadError('Chrome for Testing version list has an unexpected shape');
+    const url = versions.data.channels.Stable.downloads[HEADLESS_SHELL]?.find(d => d.platform === platformKey)?.url;
+    if (!url)
+        throw new PermanentDownloadError(`Chrome for Testing lists no ${HEADLESS_SHELL} download for ${platformKey}`);
+    await rm(partial, { recursive: true, force: true });
+    await mkdir(partial, { recursive: true });
+    const res = await doFetch(url, { signal });
+    if (!res.ok || !res.body)
+        throw new Error(`Chromium download answered ${res.status}`);
+    const total = Number(res.headers.get('content-length')) || 0;
+    const file = await open(zip, 'w');
+    try {
+        let received = 0;
+        const reader = res.body.getReader();
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            await file.write(value);
+            received += value.length;
+            opts.onProgress(received, total || received);
+        }
+    }
+    finally {
+        await file.close();
+    }
+    signal.throwIfAborted();
+}
+/**
+ * Renames `staged` to `finalDir` in one step. A directory rename never replaces a non-empty one, so
+ * when another process published first, its complete copy stays and ours is discarded with the
+ * staging directory. Only a leftover without a binary is cleared and the rename tried again.
+ */
+async function publish(staged, finalDir, bin) {
+    for (let attempt = 0;; attempt++) {
+        try {
+            await rename(staged, finalDir);
+            return;
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ENOTEMPTY' && code !== 'EEXIST' && code !== 'EPERM')
+                throw err;
+            if (existsSync(bin))
+                return;
+            if (attempt >= 2)
+                throw err;
+            await rm(finalDir, { recursive: true, force: true });
+        }
+    }
+}
+async function install(opts, platformKey, platform, root, partial, zip) {
+    const tool = platform === 'win32' ? 'tar' : 'unzip';
+    const unpacked = join(partial, 'unpacked');
+    await mkdir(unpacked);
+    try {
+        await (opts.extract ?? extractZip)(zip, unpacked, platform, opts.signal);
+    }
+    catch (err) {
+        if (opts.signal.aborted)
+            throw err;
+        const reason = err.code === 'ENOENT' ? `${tool} is not installed` : `${tool} could not unpack the download: ${err.message}`;
+        throw new PermanentDownloadError(`Could not extract Chromium: ${reason}`);
+    }
+    opts.signal.throwIfAborted();
+    const dirName = `${HEADLESS_SHELL}-${platformKey}`;
+    const finalDir = join(root, dirName);
+    const bin = join(finalDir, HEADLESS_SHELL + (platform === 'win32' ? '.exe' : ''));
+    if (!existsSync(join(unpacked, dirName)))
+        throw new PermanentDownloadError(`The Chromium download did not contain ${dirName}`);
+    if (!existsSync(join(unpacked, dirName, basename(bin))))
+        throw new PermanentDownloadError(`The Chromium download did not contain ${HEADLESS_SHELL}`);
+    await publish(join(unpacked, dirName), finalDir, bin);
+    await rm(partial, { recursive: true, force: true });
+    return bin;
+}
+export class ChromiumError extends Error {
+    kind;
+    stderrTail;
+    constructor(kind, stderrTail, message) {
+        super(message);
+        this.kind = kind;
+        this.stderrTail = stderrTail;
+        this.name = 'ChromiumError';
+    }
+}
+const STDERR_TAIL_BYTES = 4096;
+const SANDBOX_FAILURE = /No usable sandbox|zygote_host_impl|setuid sandbox/;
+/** A cold start (fresh profile, loaded machine) can take well over 10 s; CI runners did (#781). */
+const LAUNCH_TIMEOUT_MS = 30_000;
+/** Chromium's argv: the prototype's, without its automatic `--no-sandbox` for root.
+ *  `--proxy-server=direct://` so Linux Chrome does not inherit HTTP(S)_PROXY: it will not send
+ *  proxy auth the way curl does, and a render-blocking third-party stylesheet then never paints. */
+export function chromiumArgs(profileDir, env) {
+    const args = ['--headless=new', '--remote-debugging-port=0', `--user-data-dir=${profileDir}`, '--no-first-run', '--no-default-browser-check', '--proxy-server=direct://', 'about:blank'];
+    return env.CEZ_PREVIEW_NO_SANDBOX === '1' ? ['--no-sandbox', ...args] : args;
+}
+/**
+ * The task's Chromium pid record, `<runDir>/chromium.pid.json` beside its profile: `{ pid, startToken }`.
+ * A crashed cezar leaves the browser running; the boot sweep kills it by this record (#781).
+ */
+export const CHROMIUM_PID_FILE = 'chromium.pid.json';
+/**
+ * Starts headless Chromium on a loopback DevTools port of its choosing and resolves once it has
+ * written `DevToolsActivePort` into the profile. Failure kills the process and says why. While it
+ * runs, `CHROMIUM_PID_FILE` in the profile's parent names it.
+ */
+export async function launchChromium(bin, profileDir, env, opts = {}) {
+    mkdirSync(profileDir, { recursive: true });
+    const portFile = join(profileDir, 'DevToolsActivePort');
+    // A file from an earlier launch would hand back a port nobody listens on.
+    rmSync(portFile, { force: true });
+    const proc = spawn(bin, chromiumArgs(profileDir, env), { stdio: ['ignore', 'ignore', 'pipe'] });
+    const pid = proc.pid;
+    if (pid !== undefined) {
+        const record = join(dirname(profileDir), CHROMIUM_PID_FILE);
+        writeFileSync(record, JSON.stringify({ pid, startToken: processStartToken(pid) }), { mode: 0o600 });
+        proc.once('exit', () => {
+            try {
+                if (JSON.parse(readFileSync(record, 'utf8')).pid !== pid)
+                    return;
+            }
+            catch { /* gone or unreadable: nothing of ours to keep */ }
+            rmSync(record, { force: true });
+        });
+    }
+    let tail = Buffer.alloc(0);
+    proc.stderr?.on('data', (chunk) => {
+        tail = Buffer.concat([tail, chunk]).subarray(-STDERR_TAIL_BYTES);
+    });
+    let exit;
+    let missing = false;
+    proc.once('close', (code, signal) => {
+        exit ??= `Chromium exited (${signal ?? code})`;
+    });
+    proc.on('error', err => {
+        exit ??= `Chromium could not start: ${err.message}`;
+        missing ||= err.code === 'ENOENT';
+        tail = Buffer.from(err.message);
+    });
+    const fail = (kind, message) => {
+        proc.kill('SIGKILL');
+        const stderrTail = tail.toString('utf8');
+        if (missing)
+            return new ChromiumError('not-installed', stderrTail, message);
+        return new ChromiumError(SANDBOX_FAILURE.test(stderrTail) ? 'sandbox' : kind, stderrTail, message);
+    };
+    const timeoutMs = opts.timeoutMs ?? LAUNCH_TIMEOUT_MS;
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        if (exit)
+            throw fail('exited', exit);
+        if (existsSync(portFile)) {
+            const port = Number(readFileSync(portFile, 'utf8').split('\n')[0]);
+            if (port > 0)
+                return { proc, port };
+        }
+        if (Date.now() >= deadline)
+            throw fail('timeout', `Chromium did not open its DevTools port within ${timeoutMs / 1000} s (${bin})`);
+        await new Promise(resolve => setTimeout(resolve, 50));
+    }
+}
+//# sourceMappingURL=chromium.js.map

package/dist/preview/chromium.js.map

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

package/dist/preview/dev-server.d.ts

@@ -0,0 +1,68 @@
+import { EventEmitter } from 'node:events';
+import type { PreviewServer } from '../contract/index.js';
+/**
+ * Supervisor for one cezar-owned dev server (#781, spec 2026-10-02-live-preview-v1): spawn the
+ * registered command in its own process group, TCP-probe until the port answers, and kill the
+ * whole group on stop so a command that forks (`npm` -> `node` -> `vite`) frees its port.
+ */
+export declare const PREVIEW_PORT_WAIT_MS: number;
+export declare const PREVIEW_PROBE_MS = 2000;
+export type DevServerState = 'starting' | 'up' | 'stalled' | 'exited' | 'stopped';
+export type DevServerStopReason = 'user' | 'idle' | 'release';
+/** Does anything answer on `port`? Vite resolves `localhost` to `::1` on some hosts, so both loopbacks count. */
+export declare function probePort(port: number): Promise<boolean>;
+/** Keep the last 1 MiB once the log passes 5 MiB. The child holds the file open in append mode, so it keeps writing at the end. */
+export declare function trimLog(path: string): void;
+export declare class DevServer extends EventEmitter {
+    state: DevServerState;
+    exitCode?: number;
+    attempts: number;
+    stopReason?: DevServerStopReason;
+    private readonly server;
+    private readonly worktreePath;
+    private readonly dir;
+    private readonly probeMs;
+    private readonly waitMs;
+    private child?;
+    private childExited?;
+    private probeTimer?;
+    private waitTimer?;
+    private logTimer?;
+    private probing;
+    private stopping?;
+    constructor(opts: {
+        server: PreviewServer;
+        worktreePath: string;
+        dir: string;
+        probeMs?: number;
+        waitMs?: number;
+    });
+    private get pidPath();
+    private get logPath();
+    start(): void;
+    /** The owner pressed "keep waiting" on a stalled server: probe again for another full window. */
+    keepWaiting(): void;
+    stop(reason: DevServerStopReason): Promise<void>;
+    logTail(lines?: number): string[];
+    private terminate;
+    private beginWaiting;
+    private endWaiting;
+    private probeOnce;
+    /** A terminal state: the process is gone, so timers and (unless its group is still being reaped) the pid record go with it. */
+    private finish;
+    /** Only our own record: a Start again on the same port may already have written its successor's. */
+    private removeRecord;
+    private setState;
+}
+/**
+ * Boot sweep: a crashed cezar leaves pid records behind, `<port>.pid.json` for each dev server and
+ * `chromium.pid.json` for the task's browser. Kill only when the recorded pid is still the process
+ * we started (an exactly matching start token), so a reused pid is never hit; a missing or
+ * unreadable token means skip. A dev server's whole group goes; Chromium shares cezar's group, so
+ * only its pid is signalled.
+ * The record goes either way, except one `keep` claims: a server or browser the live host still runs.
+ * Returns how many processes were killed.
+ */
+export declare function sweepPreviewLeftovers(dataDir: string, opts?: {
+    keep?: (runId: string, what: number | 'browser') => boolean;
+}): Promise<number>;