@clemrig/factory 0.0.0-stage → 0.1.0

package/dist/cli/application.js

@@ -0,0 +1,63 @@
+import { resolve } from "node:path";
+import { openFactory, openFactoryForReading } from "../app/factory.js";
+import { presentResult } from "../app/runs.js";
+import { noOptions, parseArgs } from "./args.js";
+import { doctor } from "./doctor.js";
+import { help } from "./help.js";
+import { TerminalReporter } from "./reporter.js";
+import { run } from "./run.js";
+import { status } from "./status.js";
+import { ui } from "./ui.js";
+/** `--port`: a fixed port, so that an SSH tunnel can forward the same one. */
+function parsePort(value) {
+    const port = Number(value);
+    if (value === true || !/^\d+$/.test(value) || port < 1 || port > 65535)
+        throw new Error(`Invalid --port ${value === true ? "" : value}: expected a port from 1 to 65535`);
+    return port;
+}
+/**
+ * The command run by the core installed in `.factory/`: the global `factory`
+ * calls it with the arguments it received and the `.factory/` it found. This
+ * contract only changes with a major version.
+ */
+export async function main(argv, directory) {
+    // A run changes the working directory: every path must already be absolute.
+    const factoryDir = resolve(directory);
+    try {
+        const args = parseArgs(argv);
+        if (args.help || args.command === "help") {
+            process.stdout.write(help);
+            return 0;
+        }
+        if (args.command === "doctor") {
+            noOptions(args);
+            return await doctor(factoryDir, args.json);
+        }
+        if (args.command === "run") {
+            const factory = await openFactory(factoryDir);
+            const reporter = new TerminalReporter((state) => presentResult(factory, state), args.json);
+            return await run(factory, args, reporter);
+        }
+        if (!["status", "ui"].includes(args.command))
+            throw new Error(`Unknown command ${args.command}; see factory help`);
+        const { port, ...others } = args.options;
+        const dashboardPort = args.command === "ui" && port !== undefined ? parsePort(port) : undefined;
+        noOptions({
+            ...args,
+            options: args.command === "ui" ? others : args.options,
+        });
+        // Runs stay readable while factory.ts is being fixed.
+        const { factory, error } = await openFactoryForReading(factoryDir);
+        if (error)
+            process.stderr.write(`factory: factory.ts cannot be loaded, results use the default rendering: ${error}\n`);
+        if (args.command === "ui")
+            return await ui(factory, dashboardPort);
+        const reporter = new TerminalReporter((state) => presentResult(factory, state), args.json);
+        return await status(factory, reporter, args.positional[0]);
+    }
+    catch (error) {
+        process.stderr.write(`factory: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=application.js.map

package/dist/cli/application.js.map

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

package/dist/cli/args.d.ts

@@ -0,0 +1,12 @@
+export interface Arguments {
+    command: string;
+    positional: string[];
+    /** Command options; for `run`, the workflow's input. */
+    options: Record<string, string | true>;
+    json: boolean;
+    help: boolean;
+}
+/** `--name value`, or `--name` alone for true; --json and --help never take a value. */
+export declare function parseArgs(argv: string[]): Arguments;
+/** Commands other than `run` take no option of their own. */
+export declare function noOptions(args: Arguments): void;

package/dist/cli/args.js

@@ -0,0 +1,45 @@
+const OPTION = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+/** `--name value`, or `--name` alone for true; --json and --help never take a value. */
+export function parseArgs(argv) {
+    const positional = [];
+    const options = {};
+    let json = false;
+    let help = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i] ?? "";
+        if (!arg.startsWith("--")) {
+            positional.push(arg);
+            continue;
+        }
+        const name = arg.slice(2);
+        if (name === "json")
+            json = true;
+        else if (name === "help")
+            help = true;
+        else {
+            if (!OPTION.test(name))
+                throw new Error(`Invalid option ${arg}`);
+            if (Object.hasOwn(options, name))
+                throw new Error(`Duplicate option ${arg}`);
+            const value = argv[i + 1];
+            options[name] =
+                value === undefined || value.startsWith("--") ? true : value;
+            if (options[name] !== true)
+                i++;
+        }
+    }
+    return {
+        command: positional.shift() ?? "help",
+        positional,
+        options,
+        json,
+        help,
+    };
+}
+/** Commands other than `run` take no option of their own. */
+export function noOptions(args) {
+    const [name] = Object.keys(args.options);
+    if (name)
+        throw new Error(`Unknown option --${name} for ${args.command}`);
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,GAAG,0BAA0B,CAAC;AAE1C,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,MAAM;YAAE,IAAI,GAAG,IAAI,CAAC;aAC5B,IAAI,IAAI,KAAK,MAAM;YAAE,IAAI,GAAG,IAAI,CAAC;aACjC,CAAC;YACJ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;YACjE,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;YAC/D,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI;gBAAE,CAAC,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,MAAM;QACrC,UAAU;QACV,OAAO;QACP,IAAI;QACJ,IAAI;KACL,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,SAAS,CAAC,IAAe;IACvC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/cli/doctor.d.ts

@@ -0,0 +1,5 @@
+import type { Workflow } from "../engine/types.js";
+/** `factory run <name>` followed by the workflow's input options. */
+export declare function usage(workflow: Workflow): string;
+/** Node, the factory and its workflows' prompts, then each runtime in use; no provider request. */
+export declare function doctor(factoryDir: string, json: boolean): Promise<number>;

package/dist/cli/doctor.js

@@ -0,0 +1,33 @@
+import { diagnose } from "../app/doctor.js";
+import { isFlag } from "../engine/workflow.js";
+/** `factory run <name>` followed by the workflow's input options. */
+export function usage(workflow) {
+    const options = Object.entries(workflow.input?.shape ?? {}).map(([name, schema]) => {
+        const option = isFlag(schema) ? `--${name}` : `--${name} <value>`;
+        return schema.safeParse(undefined).success ? `[${option}]` : option;
+    });
+    return ["factory run", workflow.name, ...options].join(" ");
+}
+/** Node, the factory and its workflows' prompts, then each runtime in use; no provider request. */
+export async function doctor(factoryDir, json) {
+    const { ok, node, factory, runtimes, problems, ...found } = await diagnose(factoryDir);
+    const workflows = {};
+    for (const { workflow, error } of found.workflows)
+        workflows[workflow.name] =
+            error === undefined
+                ? { ok: true, detail: `Workflow ${workflow.name}: ${usage(workflow)}` }
+                : { ok: false, detail: `Workflow ${workflow.name}: ${error}` };
+    if (json) {
+        process.stdout.write(`${JSON.stringify({ ok, node, factory, workflows, runtimes, problems })}\n`);
+        return ok ? 0 : 1;
+    }
+    const line = (check, text = check.detail) => `${check.ok ? "✓" : "✗"} ${text}`;
+    const lines = [
+        ...[node, factory, ...Object.values(workflows)].map((check) => line(check)),
+        ...Object.values(runtimes).map((check) => line(check)),
+        ...problems.map(({ stage, runtime, reason }) => `✗ ${stage} (${runtime}): ${reason}`),
+    ];
+    process.stdout.write(`${lines.join("\n")}\n`);
+    return ok ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/help.d.ts

@@ -0,0 +1 @@
+export declare const help = "factory \u2014 workflows written in this repository's .factory/\n\n  factory init                             create .factory/ here and install it\n  factory doctor [--json]                  check Node, workflows, prompts and runtimes\n  factory run WORKFLOW [--INPUT VALUE\u2026] [--max-cost-usd USD] [--json]\n  factory status [RUN_ID] [--json]         list this repository's runs, or show one\n  factory ui [--port N]                    serve a live read-only dashboard on 127.0.0.1\n\nCommands other than init and help use the nearest .factory/ in the current directory\nor a parent, with the core version installed there. factory doctor lists each\nworkflow's input options. .factory/.env is loaded; shell variables take precedence.\n--max-cost-usd fails the run once its agents' announced cost exceeds it, instead\nof the workflow's maxCostUsd. --json writes events, then the result, as JSON lines.\nCtrl-C stops a run, which ends failed; press it again to quit at once.\nExit codes: 0 completed, 1 error or failed run, 130 second Ctrl-C.\n";

package/dist/cli/help.js

@@ -0,0 +1,17 @@
+export const help = `factory — workflows written in this repository's .factory/
+
+  factory init                             create .factory/ here and install it
+  factory doctor [--json]                  check Node, workflows, prompts and runtimes
+  factory run WORKFLOW [--INPUT VALUE…] [--max-cost-usd USD] [--json]
+  factory status [RUN_ID] [--json]         list this repository's runs, or show one
+  factory ui [--port N]                    serve a live read-only dashboard on 127.0.0.1
+
+Commands other than init and help use the nearest .factory/ in the current directory
+or a parent, with the core version installed there. factory doctor lists each
+workflow's input options. .factory/.env is loaded; shell variables take precedence.
+--max-cost-usd fails the run once its agents' announced cost exceeds it, instead
+of the workflow's maxCostUsd. --json writes events, then the result, as JSON lines.
+Ctrl-C stops a run, which ends failed; press it again to quit at once.
+Exit codes: 0 completed, 1 error or failed run, 130 second Ctrl-C.
+`;
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;CAenB,CAAC"}

package/dist/cli/init.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `factory init`: creates `.factory/` in `cwd` from the templates, pinned to this
+ * core version, then installs it. An existing `.factory/` is refused untouched;
+ * a failed installation keeps the files.
+ */
+export declare function init(cwd: string): Promise<number>;

package/dist/cli/init.js

@@ -0,0 +1,18 @@
+import { createFactory, installFactory } from "../app/init.js";
+/**
+ * `factory init`: creates `.factory/` in `cwd` from the templates, pinned to this
+ * core version, then installs it. An existing `.factory/` is refused untouched;
+ * a failed installation keeps the files.
+ */
+export async function init(cwd) {
+    const { factoryDir, version } = await createFactory(cwd);
+    process.stdout.write(`Created ${factoryDir}; installing @clemrig/factory ${version}…\n`);
+    const install = await installFactory(factoryDir);
+    if (!install.ok) {
+        process.stderr.write(`${install.output}\n`);
+        throw new Error("Installation failed; .factory/ is kept: run npm install --prefix .factory");
+    }
+    process.stdout.write('Next: commit .factory/, run factory doctor, then factory run ask --question "What changed recently?"\n');
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,GAAW;IACpC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,WAAW,UAAU,iCAAiC,OAAO,KAAK,CACnE,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wGAAwG,CACzG,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/launcher.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The global `factory`: help and init run here; any other command runs with the
+ * core version installed in the repository's `.factory/`.
+ */
+export declare function launch(argv: string[], cwd: string): Promise<number>;

package/dist/cli/launcher.js

@@ -0,0 +1,55 @@
+import { existsSync, statSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, relative } from "node:path";
+import { pathToFileURL } from "node:url";
+import { help } from "./help.js";
+import { init } from "./init.js";
+/** The nearest `.factory/` holding a package.json, in `cwd` or a parent. */
+function findFactory(cwd) {
+    for (let dir = cwd;; dir = dirname(dir)) {
+        const factoryDir = join(dir, ".factory");
+        if (existsSync(join(factoryDir, "package.json")))
+            return factoryDir;
+        if (dirname(dir) === dir)
+            return undefined;
+    }
+}
+/**
+ * The `main` entry of the core installed in `.factory/`. Node's resolution also
+ * searches parent `node_modules`: a core found there is never used.
+ */
+function installedCore(factoryDir, cwd) {
+    if (!existsSync(join(factoryDir, "node_modules", "@clemrig", "factory", "package.json"))) {
+        const lock = existsSync(join(factoryDir, "package-lock.json"));
+        throw new Error(`The core is not installed in ${factoryDir}; run npm ${lock ? "ci" : "install"} --prefix ${relative(cwd, factoryDir)}`);
+    }
+    return createRequire(join(factoryDir, "package.json")).resolve("@clemrig/factory/cli");
+}
+/**
+ * The global `factory`: help and init run here; any other command runs with the
+ * core version installed in the repository's `.factory/`.
+ */
+export async function launch(argv, cwd) {
+    try {
+        const [command] = argv;
+        if (command === undefined || command === "help" || command === "--help") {
+            process.stdout.write(help);
+            return 0;
+        }
+        if (command === "init") {
+            if (argv.length > 1)
+                throw new Error("factory init takes no argument");
+            return await init(cwd);
+        }
+        const factoryDir = findFactory(cwd);
+        if (!factoryDir || !statSync(factoryDir).isDirectory())
+            throw new Error(`No .factory/ found in ${cwd} or its parents; run factory init at the root of your repository`);
+        const { main } = (await import(pathToFileURL(installedCore(factoryDir, cwd)).href));
+        return await main(argv, factoryDir);
+    }
+    catch (error) {
+        process.stderr.write(`factory: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=launcher.js.map

package/dist/cli/launcher.js.map

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

package/dist/cli/reporter.d.ts

@@ -0,0 +1,17 @@
+import type { RunEvent, RunState } from "../engine/types.js";
+/** The run's duration, then its agents' tokens and estimated cost. */
+export declare function metricsSummary(state: RunState, now?: number): string[];
+/** Stage events and journal on stderr; results on stdout; JSON lines on stdout with --json. */
+export declare class TerminalReporter {
+    #private;
+    constructor(
+    /** The result lines of a run's workflow. */
+    present: (state: Readonly<RunState>) => string[], json?: boolean);
+    event: (event: RunEvent) => void;
+    /** A runtime the run uses, with its version and connection; --json output stays events only. */
+    runtime: (detail: string) => void;
+    /** A line under the current stage: journal messages, agent activity and runtimes. */
+    detail: (message: string) => void;
+    unreadable(runId: string, message: string): void;
+    result(state: RunState): void;
+}

package/dist/cli/reporter.js

@@ -0,0 +1,123 @@
+import { elapsedMs } from "../engine/metrics.js";
+import { runtimeLabels } from "../engine/profiles.js";
+function duration(ms) {
+    const seconds = Math.max(0, Math.floor(ms / 1000));
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    return `${hours ? `${hours} h ` : ""}${minutes} min ${seconds % 60} s`;
+}
+/** The run's duration, then its agents' tokens and estimated cost. */
+export function metricsSummary(state, now = Date.now()) {
+    const elapsed = elapsedMs(state, now);
+    const usage = state.metrics?.usage;
+    const count = (n) => n.toLocaleString("en-US");
+    return [
+        `Duration: ${elapsed === null ? "unavailable" : duration(elapsed)}`,
+        !usage
+            ? "Agents: unavailable"
+            : usage.responses
+                ? `Agents: ${count(usage.input)} input · ${count(usage.output)} output · ${count(usage.cacheRead)} cache read · ${count(usage.cacheWrite)} cache write tokens · estimated cost ${usage.costUsd.toFixed(6)} USD${usage.missing ? " (partial)" : ""}`
+                : `Agents: ${usage.missing ? "unavailable (partial)" : "no measured call"}`,
+    ];
+}
+const icons = { started: "→", passed: "✓", failed: "✗", completed: "✓" };
+const inSeconds = (ms) => `${(ms / 1000).toFixed(1)} s`;
+/** An agent call's start and end, its finished tools and its warnings; not each response. */
+function activityLine(activity) {
+    switch (activity.kind) {
+        case "call":
+            return activity.status === "started"
+                ? `${runtimeLabels[activity.runtime]} started with ${activity.model}`
+                : `${runtimeLabels[activity.runtime]} ${activity.status}`;
+        case "tool":
+            return activity.status === "started"
+                ? undefined
+                : activity.status === "failed"
+                    ? `${activity.name} failed after ${inSeconds(activity.durationMs)}`
+                    : `${activity.name} ${inSeconds(activity.durationMs)}`;
+        case "warning":
+            return activity.message;
+        default:
+            return undefined;
+    }
+}
+/** Stage events and journal on stderr; results on stdout; JSON lines on stdout with --json. */
+export class TerminalReporter {
+    #present;
+    #json;
+    constructor(
+    /** The result lines of a run's workflow. */
+    present, json = false) {
+        this.#present = present;
+        this.#json = json;
+    }
+    event = (event) => {
+        if (this.#json) {
+            process.stdout.write(`${JSON.stringify(event)}\n`);
+            return;
+        }
+        if (event.type === "log") {
+            this.detail(event.message);
+            return;
+        }
+        if (event.type === "agent") {
+            const line = activityLine(event.activity);
+            if (line)
+                this.detail(line);
+            return;
+        }
+        const correction = event.decision?.verdict === "correction";
+        const icon = correction && event.status !== "failed" ? "↻" : icons[event.status];
+        const color = process.stderr.isTTY && !process.env.NO_COLOR
+            ? event.status === "failed"
+                ? "\x1b[31m"
+                : correction
+                    ? "\x1b[33m"
+                    : event.status === "started"
+                        ? "\x1b[36m"
+                        : "\x1b[32m"
+            : "";
+        const label = event.decision
+            ? `${event.decision.verdict}${event.status === "failed" ? " · failed" : ""}`
+            : event.status;
+        const reasonInDetail = event.decision && event.detail?.includes(event.decision.reason);
+        const decision = event.decision
+            ? `${reasonInDetail ? "" : ` — ${event.decision.reason}`} → ${event.decision.destination ?? "end"}`
+            : "";
+        const retry = event.retry
+            ? ` [${event.retry.key} ${event.retry.count}/${event.retry.max}]`
+            : "";
+        process.stderr.write(`${color}${icon} ${event.kind.padEnd(6)} ${event.stage.padEnd(24)} ${label}${color ? "\x1b[0m" : ""}${decision}${retry}${event.detail ? ` — ${event.detail}` : ""}\n`);
+    };
+    /** A runtime the run uses, with its version and connection; --json output stays events only. */
+    runtime = (detail) => {
+        if (!this.#json)
+            this.detail(detail);
+    };
+    /** A line under the current stage: journal messages, agent activity and runtimes. */
+    detail = (message) => {
+        process.stderr.write(`  · ${message}\n`);
+    };
+    unreadable(runId, message) {
+        if (this.#json)
+            process.stdout.write(`${JSON.stringify({ type: "unreadable", runId, error: message })}\n`);
+        else
+            process.stdout.write(`\n${runId} · unreadable\n${message}\n`);
+    }
+    result(state) {
+        if (this.#json) {
+            process.stdout.write(`${JSON.stringify({ type: "result", state, elapsedMs: elapsedMs(state) })}\n`);
+            return;
+        }
+        const lines = [
+            "",
+            `${state.workflow} · ${state.id} · ${state.status}`,
+            ...(state.error ? [state.error] : []),
+            ...metricsSummary(state),
+            ...Object.values(state.runtimes ?? {}).map((runtime) => `Runtime: ${runtime}`),
+            ...this.#present(state),
+        ];
+        process.stdout.write(`${lines.join("\n")}\n`);
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/cli/reporter.js.map

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

package/dist/cli/run.d.ts

@@ -0,0 +1,9 @@
+import type { Factory } from "../app/factory.js";
+import type { Arguments } from "./args.js";
+import type { TerminalReporter } from "./reporter.js";
+/**
+ * `factory run`: the run executes in the foreground. The first SIGINT or SIGTERM
+ * stops it before its next stage (child processes are stopped at once); a second
+ * one kills the child process groups and exits with 130.
+ */
+export declare function run(factory: Factory, args: Arguments, reporter: TerminalReporter): Promise<number>;

package/dist/cli/run.js

@@ -0,0 +1,39 @@
+import { startRun } from "../app/run.js";
+/**
+ * `factory run`: the run executes in the foreground. The first SIGINT or SIGTERM
+ * stops it before its next stage (child processes are stopped at once); a second
+ * one kills the child process groups and exits with 130.
+ */
+export async function run(factory, args, reporter) {
+    const name = args.positional[0];
+    if (!name)
+        throw new Error(`Usage: factory run WORKFLOW [--INPUT VALUE…]; workflows: ${[...factory.workflows.keys()].join(", ") || "none"}`);
+    const started = await startRun(factory, name, args.options, {
+        onEvent: reporter.event,
+    });
+    for (const runtime of started.runtimes)
+        reporter.runtime(runtime.detail);
+    let interrupted = false;
+    const interrupt = (signal) => {
+        if (interrupted) {
+            started.kill();
+            process.exit(130);
+        }
+        interrupted = true;
+        reporter.detail(`${signal} received: stopping the run; press Ctrl-C again to quit at once`);
+        started.stop(new Error(`Run interrupted by ${signal}`));
+    };
+    process.on("SIGINT", interrupt);
+    process.on("SIGTERM", interrupt);
+    let state;
+    try {
+        state = await started.done;
+    }
+    finally {
+        process.off("SIGINT", interrupt);
+        process.off("SIGTERM", interrupt);
+    }
+    reporter.result(state);
+    return state.status === "completed" ? 0 : 1;
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,OAAgB,EAChB,IAAe,EACf,QAA0B;IAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI;QACP,MAAM,IAAI,KAAK,CACb,4DAA4D,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CACjH,CAAC;IACJ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;QAC1D,OAAO,EAAE,QAAQ,CAAC,KAAK;KACxB,CAAC,CAAC;IACH,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ;QAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,MAAM,SAAS,GAAG,CAAC,MAAsB,EAAE,EAAE;QAC3C,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,WAAW,GAAG,IAAI,CAAC;QACnB,QAAQ,CAAC,MAAM,CACb,GAAG,MAAM,iEAAiE,CAC3E,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjC,IAAI,KAAmC,CAAC;IACxC,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;IAC7B,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/cli/status.d.ts

@@ -0,0 +1,4 @@
+import type { Factory } from "../app/factory.js";
+import type { TerminalReporter } from "./reporter.js";
+/** Every run of the repository, or one run. */
+export declare function status(factory: Factory, reporter: TerminalReporter, runId: string | undefined): Promise<number>;

package/dist/cli/status.js

@@ -0,0 +1,15 @@
+import { listRuns, loadRun } from "../app/runs.js";
+/** Every run of the repository, or one run. */
+export async function status(factory, reporter, runId) {
+    if (runId) {
+        reporter.result(await loadRun(factory, runId));
+        return 0;
+    }
+    for (const entry of await listRuns(factory))
+        if ("state" in entry)
+            reporter.result(entry.state);
+        else
+            reporter.unreadable(entry.id, entry.error);
+    return 0;
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGnD,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAgB,EAChB,QAA0B,EAC1B,KAAyB;IAEzB,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,QAAQ,CAAC,OAAO,CAAC;QACzC,IAAI,OAAO,IAAI,KAAK;YAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;;YAC9C,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/ui.d.ts

@@ -0,0 +1,3 @@
+import type { Factory } from "../app/factory.js";
+/** `factory ui`: serves the dashboard until Ctrl-C, on `port` or one the system chooses. */
+export declare function ui(factory: Factory, port?: number): Promise<number>;

package/dist/cli/ui.js

@@ -0,0 +1,18 @@
+import { startDashboard } from "../ui/server.js";
+/** `factory ui`: serves the dashboard until Ctrl-C, on `port` or one the system chooses. */
+export async function ui(factory, port) {
+    const dashboard = await startDashboard(factory, port);
+    process.stdout.write(`factory ui: ${dashboard.url} (read-only; Ctrl-C to stop)\n`);
+    await new Promise((resolve) => {
+        const stop = () => {
+            process.off("SIGINT", stop);
+            process.off("SIGTERM", stop);
+            resolve();
+        };
+        process.on("SIGINT", stop);
+        process.on("SIGTERM", stop);
+    });
+    await dashboard.close();
+    return 0;
+}
+//# sourceMappingURL=ui.js.map

package/dist/cli/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/cli/ui.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,OAAgB,EAAE,IAAa;IACtD,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,eAAe,SAAS,CAAC,GAAG,gCAAgC,CAC7D,CAAC;IACF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IACxB,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/engine/metrics.d.ts

@@ -0,0 +1,45 @@
+import type { RunState } from "./types.js";
+/** Tokens of a model response or of an agent call. */
+export interface TokenCounts {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+}
+/** Tokens and the runtime's estimated cost. */
+export interface AgentUsage extends TokenCounts {
+    costUsd: number;
+}
+export interface RunMetrics {
+    /** The run's total, the sum of its sessions; `responses` counts measured reports, `missing` unmeasured ones. */
+    usage: AgentUsage & {
+        responses: number;
+        missing: number;
+    };
+    /**
+     * Per agent session, `<runtime>:<session>`: the latest total its runtime
+     * announced (Claude Code), or the sum of its responses (Pi). Absent from runs
+     * recorded before it existed.
+     */
+    sessions?: Record<string, AgentUsage>;
+}
+/** A measure as the runtime reports it: one response (Pi), or its session's total so far (Claude Code). */
+export interface UsageReport {
+    session: string;
+    scope: "response" | "session";
+    /** `undefined` when the runtime reported nothing measurable. */
+    usage: AgentUsage | undefined;
+}
+/** Tokens and cost of several measures together. */
+export declare function sumUsage(measures: AgentUsage[]): AgentUsage;
+export declare function emptyMetrics(): RunMetrics;
+/**
+ * Records a measure as its runtime reports it: a session total replaces the
+ * previous one, a response adds to its session. The run's total is the sum of
+ * its sessions; nothing else is computed.
+ */
+export declare function recordUsage(metrics: RunMetrics, report: UsageReport): void;
+/** Why a run past its budget must stop: its announced cost exceeds it, or a call announced none. */
+export declare function budgetProblem(metrics: RunMetrics, maxCostUsd: number): string | undefined;
+/** From creation to now while running, to the last update once completed or failed. */
+export declare function elapsedMs(state: RunState, now?: number): number | null;