@clemrig/factory 0.0.0-stage → 0.1.0

package/dist/system/process.js

@@ -0,0 +1,238 @@
+import { spawn } from "node:child_process";
+const MAX_CAPTURE_BYTES = 2 * 1024 * 1024;
+const MAX_LINE_BYTES = 32 * 1024 * 1024;
+const KILL_GRACE_MS = 1_000;
+export class ProcessStartError extends Error {
+    constructor(executable, cause) {
+        super(`Could not start ${executable}: ${cause.message}`, { cause });
+        this.name = "ProcessStartError";
+    }
+}
+export class ProcessInterruptedError extends Error {
+    constructor(signal, executable) {
+        super(`Process interrupted by ${signal}: ${executable}`);
+        this.name = "ProcessInterruptedError";
+    }
+}
+class BoundedCapture {
+    #chunks = [];
+    #length = 0;
+    #dropped = false;
+    append(chunk) {
+        if (chunk.length === 0)
+            return;
+        if (chunk.length >= MAX_CAPTURE_BYTES) {
+            this.#dropped ||= this.#length > 0 || chunk.length > MAX_CAPTURE_BYTES;
+            this.#chunks = [chunk.subarray(chunk.length - MAX_CAPTURE_BYTES)];
+            this.#length = MAX_CAPTURE_BYTES;
+            return;
+        }
+        this.#chunks.push(chunk);
+        this.#length += chunk.length;
+        while (this.#length > MAX_CAPTURE_BYTES) {
+            const first = this.#chunks.shift();
+            if (!first)
+                break;
+            this.#length -= first.length;
+            this.#dropped = true;
+        }
+    }
+    get truncated() {
+        return this.#dropped;
+    }
+    text() {
+        const prefix = this.#dropped ? "[earlier process output truncated]\n" : "";
+        return prefix + Buffer.concat(this.#chunks, this.#length).toString("utf8");
+    }
+}
+function signalGroup(child, signal) {
+    if (!child.pid)
+        return;
+    if (process.platform !== "win32") {
+        try {
+            process.kill(-child.pid, signal);
+            return;
+        }
+        catch {
+            // The process group can already be gone.
+        }
+    }
+    try {
+        child.kill(signal);
+    }
+    catch {
+        // The child can already be gone.
+    }
+}
+function groupStillExists(child) {
+    if (process.platform === "win32" || !child.pid)
+        return false;
+    try {
+        process.kill(-child.pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Children still running, so that a forced exit does not leave them behind. */
+const running = new Set();
+/** Kills every running child's process group at once, before a forced exit. */
+export function killProcessGroups() {
+    for (const child of running)
+        signalGroup(child, "SIGKILL");
+}
+/** Runs `work` with `dir` as the process's working directory, then restores the previous one. */
+export async function inDirectory(dir, work) {
+    const previous = process.cwd();
+    process.chdir(dir);
+    try {
+        return await work();
+    }
+    finally {
+        process.chdir(previous);
+    }
+}
+/**
+ * Runs an executable without a shell. A failure terminates the entire child group
+ * and settles only after the child closes and the TERM→KILL grace period finishes.
+ */
+export async function runProcess(command, cwd, timeoutMs, onLine, stdin) {
+    if (command.length === 0 || !command[0])
+        throw new Error("Process command must include an executable");
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0)
+        throw new Error("Process timeout must be positive");
+    const executable = command[0];
+    return new Promise((resolve, reject) => {
+        const child = spawn(executable, command.slice(1), {
+            cwd,
+            detached: process.platform !== "win32",
+            shell: false,
+            stdio: [stdin === undefined ? "ignore" : "pipe", "pipe", "pipe"],
+        });
+        running.add(child);
+        const stdout = new BoundedCapture();
+        const stderr = new BoundedCapture();
+        let pending = Buffer.alloc(0);
+        let failure;
+        let closeResult;
+        let terminating = false;
+        let killSent = false;
+        let killTimer;
+        let settled = false;
+        const onParentSignal = (signal) => {
+            requestTermination(new ProcessInterruptedError(signal, executable));
+        };
+        const cleanup = () => {
+            running.delete(child);
+            clearTimeout(timeout);
+            if (killTimer)
+                clearTimeout(killTimer);
+            process.removeListener("SIGINT", onParentSignal);
+            process.removeListener("SIGTERM", onParentSignal);
+        };
+        const settle = () => {
+            if (settled || !closeResult || (terminating && !killSent))
+                return;
+            settled = true;
+            cleanup();
+            if (failure) {
+                reject(failure);
+                return;
+            }
+            resolve({
+                exitCode: closeResult.code ?? (closeResult.signal ? 1 : 0),
+                stdout: stdout.text(),
+                stderr: stderr.text(),
+                stdoutTruncated: stdout.truncated,
+                stderrTruncated: stderr.truncated,
+            });
+        };
+        const sendKill = () => {
+            killTimer = undefined;
+            killSent = true;
+            signalGroup(child, "SIGKILL");
+            settle();
+        };
+        const requestTermination = (error) => {
+            if (!failure || error instanceof ProcessInterruptedError)
+                failure = error;
+            if (terminating)
+                return;
+            terminating = true;
+            signalGroup(child, "SIGTERM");
+            killTimer = setTimeout(sendKill, KILL_GRACE_MS);
+        };
+        const timeout = setTimeout(() => {
+            requestTermination(new Error(`Process timed out after ${timeoutMs}ms: ${executable}`));
+        }, timeoutMs);
+        timeout.unref();
+        process.once("SIGINT", onParentSignal);
+        process.once("SIGTERM", onParentSignal);
+        child.once("error", (error) => {
+            requestTermination(new ProcessStartError(executable, error));
+        });
+        if (stdin !== undefined) {
+            if (!child.stdin)
+                requestTermination(new Error("Process stdin is unavailable"));
+            else {
+                child.stdin.once("error", (error) => {
+                    requestTermination(new Error(`Could not write process stdin: ${error.message}`, {
+                        cause: error,
+                    }));
+                });
+                child.stdin.end(stdin);
+            }
+        }
+        if (!child.stdout || !child.stderr)
+            requestTermination(new Error("Process output streams are unavailable"));
+        child.stdout?.on("data", (chunk) => {
+            stdout.append(chunk);
+            if (!onLine || failure)
+                return;
+            pending = Buffer.concat([pending, chunk]);
+            while (!failure) {
+                const newline = pending.indexOf(0x0a);
+                if (newline < 0)
+                    break;
+                const line = pending
+                    .subarray(0, newline)
+                    .toString("utf8")
+                    .replace(/\r$/, "");
+                pending = pending.subarray(newline + 1);
+                if (Buffer.byteLength(line) > MAX_LINE_BYTES) {
+                    requestTermination(new Error(`Process output line exceeded ${MAX_LINE_BYTES} byte limit`));
+                    break;
+                }
+                try {
+                    onLine(line);
+                }
+                catch (error) {
+                    requestTermination(error instanceof Error ? error : new Error(String(error)));
+                }
+            }
+            if (!failure && pending.length > MAX_LINE_BYTES)
+                requestTermination(new Error(`Process output line exceeded ${MAX_LINE_BYTES} byte limit`));
+        });
+        child.stderr?.on("data", (chunk) => stderr.append(chunk));
+        child.once("close", (code, signal) => {
+            closeResult = { code, signal };
+            if (!failure && groupStillExists(child))
+                requestTermination(new Error(`Process group remained after ${executable} exited`));
+            if (!failure && onLine && pending.length > 0) {
+                if (pending.length > MAX_LINE_BYTES)
+                    requestTermination(new Error(`Process output line exceeded ${MAX_LINE_BYTES} byte limit`));
+                else {
+                    try {
+                        onLine(pending.toString("utf8").replace(/\r$/, ""));
+                    }
+                    catch (error) {
+                        requestTermination(error instanceof Error ? error : new Error(String(error)));
+                    }
+                }
+            }
+            settle();
+        });
+    });
+}
+//# sourceMappingURL=process.js.map

package/dist/system/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/system/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC1C,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AACxC,MAAM,aAAa,GAAG,KAAK,CAAC;AAE5B,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,UAAkB,EAAE,KAAY;QAC1C,KAAK,CAAC,mBAAmB,UAAU,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,MAAsB,EAAE,UAAkB;QACpD,KAAK,CAAC,0BAA0B,MAAM,KAAK,UAAU,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,cAAc;IAClB,OAAO,GAAa,EAAE,CAAC;IACvB,OAAO,GAAG,CAAC,CAAC;IACZ,QAAQ,GAAG,KAAK,CAAC;IAEjB,MAAM,CAAC,KAAa;QAClB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,IAAI,KAAK,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAC;YACvE,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC;YAClE,IAAI,CAAC,OAAO,GAAG,iBAAiB,CAAC;YACjC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,GAAG,iBAAiB,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK;gBAAE,MAAM;YAClB,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC;YAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAI;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,OAAO,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7E,CAAC;CACF;AAED,SAAS,WAAW,CAClB,KAA+B,EAC/B,MAAsB;IAEtB,IAAI,CAAC,KAAK,CAAC,GAAG;QAAE,OAAO;IACvB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA+B;IACvD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAC7D,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEpD,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO;QAAE,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,IAAsB;IAEtB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAiB,EACjB,GAAW,EACX,SAAiB,EACjB,MAA+B,EAC/B,KAAc;IAQd,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YAChD,GAAG;YACH,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;YACtC,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SACjE,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACpC,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,OAA0B,CAAC;QAC/B,IAAI,WAES,CAAC;QACd,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,SAAqC,CAAC;QAC1C,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,cAAc,GAAG,CAAC,MAAsB,EAAE,EAAE;YAChD,kBAAkB,CAAC,IAAI,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QACtE,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,SAAS;gBAAE,YAAY,CAAC,SAAS,CAAC,CAAC;YACvC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YACjD,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACpD,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,IAAI,OAAO,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC;gBAAE,OAAO;YAClE,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,CAAC;YACV,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,OAAO,CAAC,CAAC;gBAChB,OAAO;YACT,CAAC;YACD,OAAO,CAAC;gBACN,QAAQ,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1D,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;gBACrB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;gBACrB,eAAe,EAAE,MAAM,CAAC,SAAS;gBACjC,eAAe,EAAE,MAAM,CAAC,SAAS;aAClC,CAAC,CAAC;QACL,CAAC,CAAC;QACF,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,SAAS,GAAG,SAAS,CAAC;YACtB,QAAQ,GAAG,IAAI,CAAC;YAChB,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YAC9B,MAAM,EAAE,CAAC;QACX,CAAC,CAAC;QACF,MAAM,kBAAkB,GAAG,CAAC,KAAY,EAAE,EAAE;YAC1C,IAAI,CAAC,OAAO,IAAI,KAAK,YAAY,uBAAuB;gBAAE,OAAO,GAAG,KAAK,CAAC;YAC1E,IAAI,WAAW;gBAAE,OAAO;YACxB,WAAW,GAAG,IAAI,CAAC;YACnB,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YAC9B,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAClD,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,kBAAkB,CAChB,IAAI,KAAK,CAAC,2BAA2B,SAAS,OAAO,UAAU,EAAE,CAAC,CACnE,CAAC;QACJ,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAExC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,kBAAkB,CAAC,IAAI,iBAAiB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QACH,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,KAAK;gBACd,kBAAkB,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;iBAC3D,CAAC;gBACJ,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;oBAClC,kBAAkB,CAChB,IAAI,KAAK,CAAC,kCAAkC,KAAK,CAAC,OAAO,EAAE,EAAE;wBAC3D,KAAK,EAAE,KAAK;qBACb,CAAC,CACH,CAAC;gBACJ,CAAC,CAAC,CAAC;gBACH,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM;YAChC,kBAAkB,CAAC,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC,CAAC;QAC1E,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrB,IAAI,CAAC,MAAM,IAAI,OAAO;gBAAE,OAAO;YAC/B,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC1C,OAAO,CAAC,OAAO,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACtC,IAAI,OAAO,GAAG,CAAC;oBAAE,MAAM;gBACvB,MAAM,IAAI,GAAG,OAAO;qBACjB,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC;qBACpB,QAAQ,CAAC,MAAM,CAAC;qBAChB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACtB,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACxC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,cAAc,EAAE,CAAC;oBAC7C,kBAAkB,CAChB,IAAI,KAAK,CACP,gCAAgC,cAAc,aAAa,CAC5D,CACF,CAAC;oBACF,MAAM;gBACR,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,kBAAkB,CAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,cAAc;gBAC7C,kBAAkB,CAChB,IAAI,KAAK,CACP,gCAAgC,cAAc,aAAa,CAC5D,CACF,CAAC;QACN,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACnC,WAAW,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC;gBACrC,kBAAkB,CAChB,IAAI,KAAK,CAAC,gCAAgC,UAAU,SAAS,CAAC,CAC/D,CAAC;YACJ,IAAI,CAAC,OAAO,IAAI,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7C,IAAI,OAAO,CAAC,MAAM,GAAG,cAAc;oBACjC,kBAAkB,CAChB,IAAI,KAAK,CACP,gCAAgC,cAAc,aAAa,CAC5D,CACF,CAAC;qBACC,CAAC;oBACJ,IAAI,CAAC;wBACH,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;oBACtD,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,kBAAkB,CAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YACD,MAAM,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/system/runtimes/adapter.d.ts

@@ -0,0 +1,90 @@
+import type { z } from "zod";
+import type { AgentUsage, TokenCounts } from "../../engine/metrics.js";
+import type { ResolvedProfile, Runtime } from "../../engine/profiles.js";
+/** A runtime's profile, with its defaults applied. */
+export type ProfileOf<R extends Runtime> = Extract<ResolvedProfile, {
+    runtime: R;
+}>;
+/** One agent call, as a runtime prepares it. */
+export interface RuntimeCall<R extends Runtime> {
+    profile: ProfileOf<R>;
+    /** The workflow's prompt, appended to the runtime's own system prompt. */
+    systemPrompt: string;
+    /** The conversation within the run. */
+    session: string;
+    /** The run, and the directory where it keeps this runtime's sessions. */
+    sessions: {
+        runId: string;
+        directory: string;
+    };
+}
+/** What an output line of a runtime means for the call, the same for every runtime. */
+export type RuntimeEvent = {
+    type: "tool";
+    id: string;
+    name: string;
+    status: "started" | "completed" | "failed";
+}
+/** A model response's tokens as the call goes, before the figures announced at its end. */
+ | {
+    type: "response";
+    tokens: TokenCounts;
+}
+/**
+ * A measure as the runtime announces it: one response's final figures, or its
+ * session's total so far; `undefined` when nothing measurable was announced.
+ */
+ | {
+    type: "usage";
+    scope: "response" | "session";
+    usage: AgentUsage | undefined;
+}
+/** A customization of the session that does not change what the agent can do. */
+ | {
+    type: "warning";
+    message: string;
+}
+/** The runtime reported that the call failed: it stops there. */
+ | {
+    type: "failure";
+    message: string;
+}
+/** The agent's final text. */
+ | {
+    type: "result";
+    text: string;
+};
+/** A prepared call: the arguments after the executable, and the reader of its output. */
+export interface RuntimeProcess {
+    args: string[];
+    /** Reads one parsed output line; throws on output the adapter cannot rely on. */
+    read(event: unknown): RuntimeEvent[];
+}
+/** The connection a profile would use: connected or not, and which one, never the account. */
+export interface Connection {
+    connected: boolean;
+    detail: string;
+}
+/** What factory needs from an agent runtime. */
+export interface RuntimeAdapter<R extends Runtime> {
+    name: R;
+    /** As the operator reads it. */
+    label: string;
+    /** Found in the PATH. */
+    executable: string;
+    /** The oldest version validated by a real call; `--version` prints it first. */
+    minimumVersion: string;
+    /** The command that reports a profile's connection without a provider request, and how to read its output. */
+    connection(profile: ProfileOf<R>): {
+        args: string[];
+        read(stdout: string): Connection;
+    };
+    /** The model a call is recorded with. */
+    model(profile: ProfileOf<R>): string;
+    start(call: RuntimeCall<R>): Promise<RuntimeProcess>;
+}
+/**
+ * An output event the adapter relies on, validated: a missing or malformed field
+ * stops the call with the event and the field, rather than being misread.
+ */
+export declare function parseEvent<T>(label: string, schema: z.ZodType<T>, event: unknown): T;

package/dist/system/runtimes/adapter.js

@@ -0,0 +1,20 @@
+/**
+ * An output event the adapter relies on, validated: a missing or malformed field
+ * stops the call with the event and the field, rather than being misread.
+ */
+export function parseEvent(label, schema, event) {
+    const parsed = schema.safeParse(event);
+    if (parsed.success)
+        return parsed.data;
+    const type = typeof event === "object" &&
+        event !== null &&
+        "type" in event &&
+        typeof event.type === "string"
+        ? `${event.type} `
+        : "";
+    const issues = parsed.error.issues
+        .map(({ path, message }) => `${path.join(".") || "value"}: ${message}`)
+        .join("; ");
+    throw new Error(`${label} emitted an unexpected ${type}event: ${issues}`);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/system/runtimes/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/system/runtimes/adapter.ts"],"names":[],"mappings":"AA+EA;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,MAAoB,EACpB,KAAc;IAEd,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACvC,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC5B,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG;QAClB,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;SAC/B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;SACtE,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0BAA0B,IAAI,UAAU,MAAM,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/system/runtimes/agent-runtime.d.ts

@@ -0,0 +1,45 @@
+import { type UsageReport } from "../../engine/metrics.js";
+import { type Runtime } from "../../engine/profiles.js";
+import type { AgentPort, AgentRequest, RecordActivity } from "../../engine/types.js";
+import type { RuntimeAdapter, RuntimeCall } from "./adapter.js";
+export interface CallOptions {
+    /** The repository the agent works in. */
+    repo: string;
+    /** The executable's absolute path; by default its name, looked up in the PATH. */
+    executable?: string;
+    /** Records the call's activity under the calling stage. */
+    record?: RecordActivity;
+    /** Each measure as the runtime announces it; one unmeasured report when a started call announced none. */
+    onUsage?: (report: UsageReport) => void | Promise<void>;
+}
+/**
+ * One agent call, the same for every runtime: the request goes through standard
+ * input, the adapter reads each output line, and the final text is the result.
+ * The call's activity is recorded as it goes; a call that started always reports
+ * its measures, even when it fails.
+ */
+export declare function runCall<R extends Runtime>(adapter: RuntimeAdapter<R>, call: RuntimeCall<R> & {
+    context: unknown;
+    schema: Record<string, unknown>;
+}, options: CallOptions): Promise<unknown>;
+export interface AgentRuntimeOptions extends Pick<CallOptions, "onUsage"> {
+    /** The repository agents work in. */
+    dir: string;
+    /** Relative skill, extension and MCP command paths of profiles belong to it. */
+    factoryDir: string;
+    /** Prompt texts by name. */
+    prompts: Record<string, string>;
+    /** The run, whose directory keeps each runtime's sessions in a subdirectory of its name. */
+    run: {
+        id: string;
+        directory: string;
+    };
+    /** The executables checked before the run, by absolute path. */
+    executables?: Partial<Record<Runtime, string>>;
+}
+/** Validates each request's profile, then runs it on the runtime the profile selects, with its named prompt. */
+export declare class AgentRuntime implements AgentPort {
+    #private;
+    constructor(options: AgentRuntimeOptions);
+    execute(request: AgentRequest, record?: RecordActivity): Promise<unknown>;
+}

package/dist/system/runtimes/agent-runtime.js

@@ -0,0 +1,184 @@
+import { mkdir } from "node:fs/promises";
+import { isAbsolute, join, resolve } from "node:path";
+import { sumUsage, } from "../../engine/metrics.js";
+import { resolveProfile, } from "../../engine/profiles.js";
+import { ProcessStartError, runProcess } from "../process.js";
+import { agentPrompt, parseAgentJson } from "./protocol.js";
+import { runtimes } from "./registry.js";
+/** The figures announced for the call: its session's total, or the sum of its responses. */
+function callUsage(reports) {
+    const session = reports.findLast((report) => report.scope === "session" && report.usage);
+    if (session?.usage)
+        return { scope: "session", usage: session.usage };
+    const responses = reports.flatMap(({ usage }) => (usage ? [usage] : []));
+    return responses.length ? { scope: "call", usage: sumUsage(responses) } : {};
+}
+/**
+ * One agent call, the same for every runtime: the request goes through standard
+ * input, the adapter reads each output line, and the final text is the result.
+ * The call's activity is recorded as it goes; a call that started always reports
+ * its measures, even when it fails.
+ */
+export async function runCall(adapter, call, options) {
+    const { label } = adapter;
+    const { record, onUsage } = options;
+    const session = `${adapter.name}:${call.session}`;
+    await mkdir(call.sessions.directory, { recursive: true, mode: 0o700 });
+    const started = await adapter.start(call);
+    // A request that cannot be written fails before the call starts.
+    const request = agentPrompt(call);
+    record?.({
+        kind: "call",
+        status: "started",
+        runtime: adapter.name,
+        model: adapter.model(call.profile),
+        session: call.session,
+    });
+    const reports = [];
+    const tools = new Map();
+    let text;
+    let running = true;
+    let succeeded = false;
+    try {
+        const exit = await runProcess([options.executable ?? adapter.executable, ...started.args], options.repo, call.profile.timeoutMs, (line) => {
+            if (!line)
+                return;
+            let event;
+            try {
+                event = JSON.parse(line);
+            }
+            catch {
+                throw new Error(`${label} emitted invalid JSONL output`);
+            }
+            for (const item of started.read(event))
+                switch (item.type) {
+                    case "tool": {
+                        const { id, name, status } = item;
+                        if (status === "started") {
+                            tools.set(id, Date.now());
+                            record?.({ kind: "tool", id, name, status });
+                        }
+                        else
+                            record?.({
+                                kind: "tool",
+                                id,
+                                name,
+                                status,
+                                durationMs: Date.now() - (tools.get(id) ?? Date.now()),
+                            });
+                        break;
+                    }
+                    case "response":
+                        record?.({
+                            kind: "response",
+                            tokens: item.tokens,
+                            provisional: true,
+                        });
+                        break;
+                    case "usage":
+                        reports.push({ session, scope: item.scope, usage: item.usage });
+                        if (item.scope === "response" && item.usage) {
+                            const { costUsd, ...tokens } = item.usage;
+                            record?.({
+                                kind: "response",
+                                tokens,
+                                costUsd,
+                                provisional: false,
+                            });
+                        }
+                        break;
+                    case "warning":
+                        record?.({ kind: "warning", message: item.message });
+                        break;
+                    case "failure":
+                        throw new Error(item.message);
+                    case "result":
+                        text = item.text;
+                }
+        }, request);
+        if (exit.exitCode !== 0)
+            throw new Error(`${label} exited with code ${exit.exitCode}: ${exit.stderr.trim() || "no error output"}`);
+        if (text === undefined)
+            throw new Error(`${label} completed without a final result`);
+        succeeded = true;
+    }
+    catch (error) {
+        if (error instanceof ProcessStartError)
+            running = false;
+        throw error;
+    }
+    finally {
+        for (const report of reports)
+            await onUsage?.(report);
+        if (running && !reports.length)
+            await onUsage?.({ session, scope: "response", usage: undefined });
+        record?.({
+            kind: "call",
+            status: succeeded ? "completed" : "failed",
+            runtime: adapter.name,
+            ...callUsage(reports),
+        });
+    }
+    try {
+        return parseAgentJson(text);
+    }
+    catch {
+        // The workflow's gate owns output-format feedback and retry routing.
+        return text;
+    }
+}
+/** Relative skill, extension and MCP command paths belong to `.factory/`; a bare command stays a PATH lookup. */
+function resolvePaths(profile, factoryDir) {
+    if (profile.runtime === "pi")
+        return {
+            ...profile,
+            skills: profile.skills.map((path) => resolve(factoryDir, path)),
+            extensions: profile.extensions.map((path) => resolve(factoryDir, path)),
+        };
+    const command = (value) => value.includes("/") && !isAbsolute(value)
+        ? resolve(factoryDir, value)
+        : value;
+    return {
+        ...profile,
+        mcpServers: Object.fromEntries(Object.entries(profile.mcpServers).map(([name, server]) => [
+            name,
+            { ...server, command: command(server.command) },
+        ])),
+    };
+}
+/** Validates each request's profile, then runs it on the runtime the profile selects, with its named prompt. */
+export class AgentRuntime {
+    #options;
+    constructor(options) {
+        this.#options = options;
+    }
+    async execute(request, record) {
+        const { dir, factoryDir, prompts, run, onUsage, executables } = this.#options;
+        const systemPrompt = Object.hasOwn(prompts, request.prompt)
+            ? prompts[request.prompt]
+            : undefined;
+        if (systemPrompt === undefined)
+            throw new Error(`No prompt loaded: ${request.prompt}`);
+        const profile = resolvePaths(resolveProfile(request.profile), factoryDir);
+        const options = {
+            repo: dir,
+            executable: executables?.[profile.runtime],
+            record,
+            onUsage,
+        };
+        const call = {
+            systemPrompt,
+            session: request.session,
+            sessions: {
+                runId: run.id,
+                directory: join(run.directory, profile.runtime),
+            },
+            context: request.context,
+            schema: request.schema,
+        };
+        return profile.runtime === "pi"
+            ? runCall(runtimes.pi, { ...call, profile }, options)
+            : runCall(runtimes["claude-code"], { ...call, profile }, options);
+    }
+}
+//# sourceMappingURL=agent-runtime.js.map

package/dist/system/runtimes/agent-runtime.js.map

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

package/dist/system/runtimes/claude-code.d.ts

@@ -0,0 +1,10 @@
+import { type RuntimeAdapter } from "./adapter.js";
+/** Claude Code session IDs are UUIDs: a stable one per session name. */
+export declare function claudeCodeSessionId(name: string): string;
+/**
+ * Claude Code in print mode, in a session that holds only the profile's tools and
+ * MCP servers. Its sessions need UUIDs: the run keeps a marker per session, so
+ * that the next call resumes it. At the end of each call, Claude Code announces
+ * its session's total, which is reported as it is.
+ */
+export declare const claudeCode: RuntimeAdapter<"claude-code">;