@nodetool-ai/cli 0.7.0-rc.23 → 0.8.2

package/dist/commands/worker.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `nodetool worker` CLI commands — GPU-worker provisioning, registered on a
+ * Commander `Command` via `registerWorkerCommands(program)`.
+ *
+ * The whole group runs against a single `WorkerManager` (from
+ * `@nodetool-ai/compute`), which owns the profiles→instances identity model and
+ * loads each target's API key from the secret store. The CLI's only job is to
+ * unlock the DB + master key (like the deleted `runpod-worker.ts` script did),
+ * parse flags, and render the manager's results.
+ *
+ * Verbs:
+ *   worker profile add <name> --target <t> --image <img> [--gpu <g>] [--disk <gb>] [...]
+ *   worker profile list [--json]
+ *   worker profile rm <name>
+ *   worker create --profile <name> [--attach]
+ *   worker create --target <t> --image <img> [--gpu <g>] [--attach]   (inline)
+ *   worker list [--json]
+ *   worker status <id>
+ *   worker stop <id> | --all
+ */
+import { Command } from "commander";
+export declare function registerWorkerCommands(program: Command): void;
+//# sourceMappingURL=worker.d.ts.map

package/dist/commands/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/commands/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6KpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAY7D"}

package/dist/commands/worker.js

@@ -0,0 +1,374 @@
+/**
+ * `nodetool worker` CLI commands — GPU-worker provisioning, registered on a
+ * Commander `Command` via `registerWorkerCommands(program)`.
+ *
+ * The whole group runs against a single `WorkerManager` (from
+ * `@nodetool-ai/compute`), which owns the profiles→instances identity model and
+ * loads each target's API key from the secret store. The CLI's only job is to
+ * unlock the DB + master key (like the deleted `runpod-worker.ts` script did),
+ * parse flags, and render the manager's results.
+ *
+ * Verbs:
+ *   worker profile add <name> --target <t> --image <img> [--gpu <g>] [--disk <gb>] [...]
+ *   worker profile list [--json]
+ *   worker profile rm <name>
+ *   worker create --profile <name> [--attach]
+ *   worker create --target <t> --image <img> [--gpu <g>] [--attach]   (inline)
+ *   worker list [--json]
+ *   worker status <id>
+ *   worker stop <id> | --all
+ */
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { WorkerManager } from "@nodetool-ai/compute";
+import { initDb } from "@nodetool-ai/models";
+import { initMasterKey } from "@nodetool-ai/security";
+import { getDefaultDbPath } from "@nodetool-ai/config";
+import { registerWorkerModelsCommands } from "./worker-models.js";
+import { printTable, asJson } from "./output.js";
+const SUPPORTED_TARGETS = ["runpod", "vast", "verda"];
+const TOKEN_POLICIES = ["generate", "fixed"];
+/**
+ * Redact a high-entropy bearer token for human-readable output. Shows only the
+ * first 8 characters so the user can confirm a token exists without leaking the
+ * full secret to shell history, CI logs, or terminal transcripts. The full
+ * token is retrievable on demand via `worker token <id>`.
+ */
+function maskToken(token) {
+    if (!token) {
+        return "(none)";
+    }
+    return `${token.slice(0, 8)}… (full token: worker token <id>)`;
+}
+// ---------------------------------------------------------------------------
+// Manager + DB setup
+// ---------------------------------------------------------------------------
+/**
+ * Unlock the DB + master key (so the manager can read API keys from the secret
+ * store) and return a fresh `WorkerManager`. Mirrors the resolution the deleted
+ * `runpod-worker.ts` script used: best-effort init, env fallback handled inside
+ * the manager.
+ */
+async function getWorkerManager() {
+    try {
+        initDb(getDefaultDbPath());
+        await initMasterKey();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`Could not unlock the secret store: ${msg}\n` +
+            `Falling back to env vars for provider API keys.`);
+    }
+    return new WorkerManager();
+}
+/** Unify error handling on every sub-command: print and exit non-zero. */
+function runAction(fn) {
+    return async (...args) => {
+        try {
+            await fn(...args);
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    };
+}
+function assertTarget(value) {
+    if (!SUPPORTED_TARGETS.includes(value)) {
+        throw new Error(`Invalid --target '${value}': expected one of ${SUPPORTED_TARGETS.join(", ")}.`);
+    }
+    return value;
+}
+function assertTokenPolicy(value) {
+    if (!TOKEN_POLICIES.includes(value)) {
+        throw new Error(`Invalid --token-policy '${value}': expected one of ${TOKEN_POLICIES.join(", ")}.`);
+    }
+    return value;
+}
+/**
+ * Parse an optional duration flag into a positive integer (or null when
+ * absent). Rejects non-numeric / zero / negative input up front so the reaper
+ * never gets a NaN or a negative timeout that would stop a worker immediately.
+ */
+function parsePositiveMinutes(value, flag) {
+    if (value == null) {
+        return null;
+    }
+    const n = Number.parseInt(value, 10);
+    if (!Number.isInteger(n) || n <= 0) {
+        throw new Error(`Invalid ${flag} '${value}': expected a positive integer.`);
+    }
+    return n;
+}
+/**
+ * Parse a positive-integer flag, rejecting anything else.
+ *
+ * A silently-dropped size is worse than a rejected one: the caller believes
+ * they asked for 200 GB and gets the 100 GB default, which only shows up as a
+ * download failing partway through on a rented GPU.
+ */
+function parsePositiveInt(value, flag) {
+    if (value == null) {
+        return undefined;
+    }
+    const n = Number.parseInt(value, 10);
+    if (!Number.isInteger(n) || n <= 0) {
+        throw new Error(`Invalid ${flag} '${value}': expected a positive integer.`);
+    }
+    return n;
+}
+/**
+ * Read an OpenSSH public key from disk.
+ *
+ * A rented worker exposes only the node-execution bridge, so diagnosing one
+ * means inferring its state from whether whole model loads pass or fail. The
+ * key travels as PUBLIC_KEY and the worker entrypoint installs it before
+ * starting sshd.
+ */
+function readSshPublicKey(path) {
+    const key = readFileSync(resolvePath(path), "utf8").trim();
+    if (!key.startsWith("ssh-") && !key.startsWith("ecdsa-")) {
+        throw new Error(`--ssh-key ${path} is not an OpenSSH public key. ` +
+            "Point it at a .pub file, not a private key.");
+    }
+    if (key.includes("PRIVATE KEY")) {
+        throw new Error(`--ssh-key ${path} is a private key. Use the .pub file.`);
+    }
+    return key;
+}
+/** Build a profile `spec` JSON blob from the inline provisioning flags. */
+function specFromFlags(opts) {
+    const spec = {};
+    if (opts.gpu) {
+        spec.gpu = opts.gpu;
+    }
+    const vcpu = parsePositiveInt(opts.vcpu, "--vcpu");
+    if (vcpu != null) {
+        spec.vcpu = vcpu;
+    }
+    const disk = parsePositiveInt(opts.disk, "--disk");
+    if (disk != null) {
+        spec.disk = disk;
+    }
+    if (opts.sshKey) {
+        spec.sshPublicKey = readSshPublicKey(opts.sshKey);
+    }
+    return spec;
+}
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerWorkerCommands(program) {
+    const worker = program
+        .command("worker")
+        .description("Provision, attach, and tear down GPU workers");
+    registerProfile(worker);
+    registerCreate(worker);
+    registerList(worker);
+    registerStatus(worker);
+    registerToken(worker);
+    registerStop(worker);
+    registerWorkerModelsCommands(worker, getWorkerManager);
+}
+// ---------------------------------------------------------------------------
+// worker profile
+// ---------------------------------------------------------------------------
+function registerProfile(worker) {
+    const profile = worker
+        .command("profile")
+        .description("Manage reusable worker presets");
+    profile
+        .command("add <name>")
+        .description("Create a worker profile")
+        .requiredOption("--target <target>", "Provider target (runpod | vast)")
+        .requiredOption("--image <image>", "Worker container image")
+        .option("--gpu <gpu>", "GPU type (provider-specific)")
+        .option("--ssh-key <path>", "OpenSSH public key file; exposes 22/tcp so the worker can be debugged")
+        .option("--vcpu <n>", "vCPU count")
+        .option("--disk <gb>", "Persistent volume size in GB (holds the model cache; default 100)")
+        .option("--token-policy <policy>", "Token policy (generate | fixed)", "generate")
+        .option("--idle-timeout <minutes>", "Idle auto-stop timeout in minutes")
+        .option("--max-lifetime <minutes>", "Hard TTL in minutes")
+        .action(runAction(async (name, opts) => {
+        const target = assertTarget(opts.target);
+        const manager = await getWorkerManager();
+        const created = await manager.createProfile({
+            name,
+            target,
+            image: opts.image,
+            spec: specFromFlags(opts),
+            token_policy: assertTokenPolicy(opts.tokenPolicy),
+            idle_timeout_minutes: parsePositiveMinutes(opts.idleTimeout, "--idle-timeout"),
+            max_lifetime_minutes: parsePositiveMinutes(opts.maxLifetime, "--max-lifetime")
+        });
+        console.log(`Created worker profile '${created.name}'.`);
+    }));
+    profile
+        .command("list")
+        .description("List worker profiles")
+        .option("--json", "Output as JSON")
+        .action(runAction(async (opts) => {
+        const manager = await getWorkerManager();
+        const profiles = await manager.listProfiles();
+        if (opts.json) {
+            asJson(profiles);
+            return;
+        }
+        printTable(profiles.map((p) => ({
+            name: p.name,
+            target: p.target,
+            image: p.image,
+            idle: p.idle_timeout_minutes ?? "",
+            ttl: p.max_lifetime_minutes ?? ""
+        })), ["name", "target", "image", "idle", "ttl"]);
+    }));
+    profile
+        .command("rm <name>")
+        .description("Delete a worker profile")
+        .action(runAction(async (name) => {
+        const manager = await getWorkerManager();
+        await manager.deleteProfile(name);
+        console.log(`Deleted worker profile '${name}'.`);
+    }));
+}
+// ---------------------------------------------------------------------------
+// worker create
+// ---------------------------------------------------------------------------
+function registerCreate(worker) {
+    worker
+        .command("create")
+        .description("Provision a worker from a profile (or inline flags)")
+        .option("--profile <name>", "Provision from an existing profile")
+        .option("--target <target>", "Inline: provider target (runpod | vast)")
+        .option("--image <image>", "Inline: worker container image")
+        .option("--gpu <gpu>", "Inline: GPU type")
+        .option("--ssh-key <path>", "Inline: OpenSSH public key file; exposes 22/tcp for debugging")
+        .option("--vcpu <n>", "Inline: vCPU count")
+        .option("--disk <gb>", "Inline: persistent volume size in GB (default 100)")
+        .option("--token-policy <policy>", "Inline: token policy (generate | fixed)", "generate")
+        .option("--idle-timeout <minutes>", "Inline: idle auto-stop in minutes")
+        .option("--max-lifetime <minutes>", "Inline: hard TTL in minutes")
+        .option("--attach", "Attach the new worker once it is running")
+        .action(runAction(async (opts) => {
+        const manager = await getWorkerManager();
+        let profileName = opts.profile;
+        if (!profileName) {
+            // Inline form: synthesise a one-off profile from the flags.
+            if (!opts.target || !opts.image) {
+                throw new Error("Provide --profile <name>, or the inline form " +
+                    "--target <t> --image <img> [--gpu <g>].");
+            }
+            const target = assertTarget(opts.target);
+            profileName = `inline-${target}-${Date.now()}`;
+            await manager.createProfile({
+                name: profileName,
+                target,
+                image: opts.image,
+                spec: specFromFlags(opts),
+                token_policy: assertTokenPolicy(opts.tokenPolicy),
+                idle_timeout_minutes: parsePositiveMinutes(opts.idleTimeout, "--idle-timeout"),
+                max_lifetime_minutes: parsePositiveMinutes(opts.maxLifetime, "--max-lifetime")
+            });
+        }
+        const instance = await manager.provision(profileName);
+        console.log(`Provisioned worker '${instance.id}'.`);
+        console.log(`  wsUrl: ${instance.ws_url}`);
+        console.log(`  token: ${maskToken(instance.token)}`);
+        console.log(`  status: ${instance.status}`);
+        if (opts.attach) {
+            const conn = await manager.attach(instance.id);
+            console.log(`Attached. Bridge target: ${conn.wsUrl}`);
+            console.log(`export NODETOOL_WORKER_URL=${conn.wsUrl}`);
+            if (conn.token) {
+                // Never print the raw bearer token to stdout — it would leak into
+                // shell history, CI logs, and terminal transcripts. Give a
+                // pipeable retrieval path instead (token: ${maskToken(conn.token)}).
+                console.log("# NODETOOL_WORKER_TOKEN was redacted; set it with:");
+                console.log(`#   export NODETOOL_WORKER_TOKEN=$(nodetool worker token ${instance.id})`);
+            }
+        }
+    }));
+}
+// ---------------------------------------------------------------------------
+// worker list
+// ---------------------------------------------------------------------------
+function registerList(worker) {
+    worker
+        .command("list")
+        .description("List worker instances")
+        .option("--json", "Output as JSON")
+        .action(runAction(async (opts) => {
+        const manager = await getWorkerManager();
+        const instances = await manager.list();
+        if (opts.json) {
+            asJson(instances);
+            return;
+        }
+        printTable(instances.map((i) => ({
+            id: i.id,
+            profile: i.profile_name,
+            target: i.target,
+            status: i.status,
+            cost: i.estimated_cost_usd ?? "",
+            ws_url: i.ws_url
+        })), ["id", "profile", "target", "status", "cost", "ws_url"]);
+    }));
+}
+// ---------------------------------------------------------------------------
+// worker status
+// ---------------------------------------------------------------------------
+function registerStatus(worker) {
+    worker
+        .command("status <id>")
+        .description("Refresh a worker instance's status from its provider")
+        .action(runAction(async (id) => {
+        const manager = await getWorkerManager();
+        const state = await manager.status(id);
+        console.log(state);
+    }));
+}
+// ---------------------------------------------------------------------------
+// worker token
+// ---------------------------------------------------------------------------
+function registerToken(worker) {
+    worker
+        .command("token <id>")
+        .description("Print a worker's decrypted bearer token (pipe into NODETOOL_WORKER_TOKEN)")
+        .action(runAction(async (id) => {
+        const manager = await getWorkerManager();
+        // getInstance decrypts on demand; bulk `list` withholds the token.
+        const instance = await manager.getInstance(id);
+        if (!instance) {
+            throw new Error(`Worker instance not found: ${id}`);
+        }
+        if (!instance.token) {
+            throw new Error(`Worker instance '${id}' has no token (open worker).`);
+        }
+        // Print ONLY the token so it pipes cleanly, e.g.
+        //   export NODETOOL_WORKER_TOKEN=$(nodetool worker token i1)
+        console.log(instance.token);
+    }));
+}
+// ---------------------------------------------------------------------------
+// worker stop
+// ---------------------------------------------------------------------------
+function registerStop(worker) {
+    worker
+        .command("stop [id]")
+        .description("Stop a worker by id, or every worker with --all")
+        .option("--all", "Stop every non-stopped worker")
+        .action(runAction(async (id, opts) => {
+        const manager = await getWorkerManager();
+        if (opts.all) {
+            await manager.stopAll();
+            console.log("Stopped all workers.");
+            return;
+        }
+        if (!id) {
+            throw new Error("Provide a worker id, or --all to stop everything.");
+        }
+        await manager.stop(id);
+        console.log(`Stopped worker '${id}'.`);
+    }));
+}
+//# sourceMappingURL=worker.js.map

package/dist/commands/worker.js.map

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

package/dist/debug/browser-runner.d.ts

@@ -0,0 +1,21 @@
+import type { BrowserRunReport, DebugGraph } from "./types.js";
+export interface BrowserRunInput {
+    graph: DebugGraph;
+    params: Record<string, unknown>;
+    /** Bundle dir for the browser surface; record/screenshot/console land here. */
+    outDir: string;
+    /** Capture a screenshot at every run stage (expensive) vs. only the final frame. */
+    captureStages?: boolean;
+    timeoutMs?: number;
+    /** Stream the Playwright child's stdout/stderr through. */
+    onLog?: (line: string) => void;
+}
+export declare function runInBrowser(input: BrowserRunInput): Promise<BrowserRunReport>;
+/**
+ * Fold the artifacts a Playwright debug run leaves in `outDir`
+ * (record.json, console-errors.log, screenshot.png) into a `BrowserRunReport`.
+ * Pure file IO — separated from the spawn so it's directly testable against a
+ * real captured bundle.
+ */
+export declare function buildBrowserReport(outDir: string, exitCode?: number): Promise<BrowserRunReport>;
+//# sourceMappingURL=browser-runner.d.ts.map

package/dist/debug/browser-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-runner.d.ts","sourceRoot":"","sources":["../../src/debug/browser-runner.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkB/D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAgED,wBAAsB,YAAY,CAChC,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAmE3B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,QAAQ,SAAI,GACX,OAAO,CAAC,gBAAgB,CAAC,CAsD3B"}

package/dist/debug/browser-runner.js

@@ -0,0 +1,196 @@
+/**
+ * Real-browser ("browser") debug surface: drives the `e2e_runner` harness page
+ * in headless Chromium via Playwright to execute the workflow end-to-end through
+ * the actual web stack, capturing browser console errors, a canvas screenshot,
+ * and the same logs / node IO / outputs the server surface reports.
+ *
+ * The heavy lifting (Vite + hermetic backend + the harness page) already exists
+ * in `web/`; this module just resolves the web workspace, shells out to the
+ * Playwright spec, and folds the resulting RunRecord into a `BrowserRunReport`.
+ * It degrades gracefully (an `unavailableReason`) when the web deps or browser
+ * binaries aren't installed.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { collectExecutionSummary } from "./collector.js";
+const CONFIG_REL = "playwright.debug-harness.config.ts";
+const DEFAULT_TIMEOUT_MS = 6 * 60_000;
+/** Walk up from this module to the repo root (the dir whose `web/` has our config). */
+function findWebDir() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 8; i++) {
+        const candidate = join(dir, "web");
+        if (existsSync(join(candidate, CONFIG_REL)))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/** Grace period between SIGTERM and SIGKILL when tearing down the child's process group. */
+const GROUP_KILL_GRACE_MS = 5_000;
+/**
+ * Kill the Playwright child on timeout. Playwright's webServer (Vite) and the
+ * tsx e2e backend spawned by globalSetup are children of this process, not of
+ * `child` itself, so a plain `child.kill()` orphans them holding ports
+ * 3000/7777. On POSIX, `child` is spawned detached (its own process group), so
+ * we can kill the whole group via the negative pid; on win32 (no process
+ * groups, and no `shell: true` here) fall back to killing just the child.
+ */
+function killChild(child) {
+    if (process.platform !== "win32" && child.pid !== undefined) {
+        const pgid = child.pid;
+        try {
+            process.kill(-pgid, "SIGTERM");
+        }
+        catch {
+            // Process group may already be gone.
+        }
+        setTimeout(() => {
+            try {
+                process.kill(-pgid, "SIGKILL");
+            }
+            catch {
+                // Process group may already be gone.
+            }
+        }, GROUP_KILL_GRACE_MS).unref();
+        return;
+    }
+    try {
+        child.kill("SIGKILL");
+    }
+    catch {
+        // Already exited.
+    }
+}
+function unavailable(reason) {
+    return {
+        surface: "browser",
+        ok: false,
+        status: "unavailable",
+        error: null,
+        durationMs: null,
+        summary: collectExecutionSummary([]),
+        consoleErrors: [],
+        unavailableReason: reason
+    };
+}
+export async function runInBrowser(input) {
+    const webDir = findWebDir();
+    if (!webDir)
+        return unavailable("could not locate the web workspace");
+    const playwrightBin = join(webDir, "node_modules", ".bin", "playwright");
+    if (!existsSync(playwrightBin)) {
+        return unavailable("web dependencies not installed (run `npm install` and `npx playwright install chromium`)");
+    }
+    await mkdir(input.outDir, { recursive: true });
+    const graphPath = join(input.outDir, "_graph.json");
+    await writeFile(graphPath, JSON.stringify({ graph: input.graph }), "utf8");
+    const env = {
+        ...process.env,
+        NODETOOL_DEBUG_GRAPH: graphPath,
+        NODETOOL_DEBUG_OUT: input.outDir,
+        NODETOOL_DEBUG_PARAMS: JSON.stringify(input.params ?? {})
+    };
+    if (input.captureStages) {
+        env.NODETOOL_DEBUG_STAGES = "1";
+    }
+    // Read by debug.spec.ts to arm the in-page run's own timeout, so the
+    // Playwright spec doesn't fall back to its internal RUN_TIMEOUT_MS cap.
+    if (input.timeoutMs) {
+        env.NODETOOL_DEBUG_TIMEOUT = String(input.timeoutMs);
+    }
+    // The child-kill timer below is the outer backstop; it must stay comfortably
+    // above the in-page timeout the spec applies, or the child gets killed
+    // before the harness can settle and write record.json.
+    const killTimeoutMs = input.timeoutMs !== undefined
+        ? Math.max(input.timeoutMs + 60_000, DEFAULT_TIMEOUT_MS)
+        : DEFAULT_TIMEOUT_MS;
+    const isWindows = process.platform === "win32";
+    const exitCode = await new Promise((resolvePromise) => {
+        const child = spawn(playwrightBin, ["test", "-c", CONFIG_REL], {
+            cwd: webDir,
+            env,
+            stdio: ["ignore", "pipe", "pipe"],
+            // .bin/playwright is a shell shim on win32 (no .exe), so it needs a
+            // shell to resolve; shell mode has no process groups, so detach only
+            // on POSIX where killChild can use them for whole-tree teardown.
+            ...(isWindows ? { shell: true } : { detached: true })
+        });
+        const onChunk = (buf) => input.onLog?.(buf.toString());
+        child.stdout?.on("data", onChunk);
+        child.stderr?.on("data", onChunk);
+        const timer = setTimeout(() => {
+            killChild(child);
+            resolvePromise(124);
+        }, killTimeoutMs);
+        child.on("error", () => {
+            clearTimeout(timer);
+            resolvePromise(127);
+        });
+        child.on("exit", (code) => {
+            clearTimeout(timer);
+            resolvePromise(code ?? 1);
+        });
+    });
+    return buildBrowserReport(input.outDir, exitCode);
+}
+/**
+ * Fold the artifacts a Playwright debug run leaves in `outDir`
+ * (record.json, console-errors.log, screenshot.png) into a `BrowserRunReport`.
+ * Pure file IO — separated from the spawn so it's directly testable against a
+ * real captured bundle.
+ */
+export async function buildBrowserReport(outDir, exitCode = 0) {
+    const recordPath = join(outDir, "record.json");
+    if (!existsSync(recordPath)) {
+        return unavailable(`Playwright run produced no record (exit ${exitCode}); check that the web app builds and chromium is installed`);
+    }
+    let record;
+    try {
+        record = JSON.parse(await readFile(recordPath, "utf8"));
+    }
+    catch (err) {
+        return unavailable(`could not parse browser record: ${String(err)}`);
+    }
+    const consoleErrors = existsSync(join(outDir, "console-errors.log"))
+        ? (await readFile(join(outDir, "console-errors.log"), "utf8"))
+            .split("\n")
+            .filter(Boolean)
+        : [];
+    const summary = collectExecutionSummary(record.events ?? []);
+    const status = record.status ?? summary.status;
+    const report = {
+        surface: "browser",
+        ok: status === "completed",
+        status,
+        error: record.error ?? summary.error,
+        durationMs: record.durationMs ?? null,
+        summary,
+        consoleErrors,
+        recordFile: "browser/record.json"
+    };
+    if (existsSync(join(outDir, "screenshot.png"))) {
+        report.screenshotFile = "browser/screenshot.png";
+    }
+    if (existsSync(join(outDir, "stages.json"))) {
+        try {
+            const stages = JSON.parse(await readFile(join(outDir, "stages.json"), "utf8"));
+            report.stages = stages.map((s) => ({
+                index: s.index,
+                status: s.status,
+                file: `browser/${s.file}`
+            }));
+        }
+        catch {
+            // A malformed stages manifest just means no staged screenshots.
+        }
+    }
+    return report;
+}
+//# sourceMappingURL=browser-runner.js.map

package/dist/debug/browser-runner.js.map

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

package/dist/debug/collector.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Re-export of the shared execution-summary collector.
+ *
+ * The reducer lives in `@nodetool-ai/execution` so the CLI harness, the HTTP
+ * debug endpoint and the agent-facing `debug_workflow` tool all distill a run
+ * the same way. This module keeps the CLI's original import path.
+ */
+export { collectExecutionSummary, previewValue } from "@nodetool-ai/execution/debug";
+//# sourceMappingURL=collector.d.ts.map