taskflow-core 0.1.8 → 0.2.0

package/dist/runtime/phases/approval.js

@@ -0,0 +1,38 @@
+/**
+ * Approval phase — human-in-the-loop pause (approve / reject / edit).
+ */
+import { emptyUsage } from "../../usage.js";
+/**
+ * Build PhaseState for an approval outcome (interactive or auto-reject).
+ */
+export function approvalDecisionToPhaseState(phaseId, decision, opts) {
+    if (opts.auto) {
+        return {
+            id: phaseId,
+            status: "done",
+            output: "(auto-rejected: no interactive approver available)",
+            approval: { decision: "reject", auto: true },
+            gate: { verdict: "block", reason: "(auto-rejected: no interactive approver available)" },
+            usage: emptyUsage(),
+            inputHash: opts.inputHash,
+            reads: opts.reads,
+            endedAt: Date.now(),
+        };
+    }
+    const note = decision.note?.trim();
+    const ps = {
+        id: phaseId,
+        status: "done",
+        output: note || `(${decision.decision})`,
+        approval: { decision: decision.decision, note },
+        usage: emptyUsage(),
+        inputHash: opts.inputHash,
+        reads: opts.reads,
+        endedAt: Date.now(),
+    };
+    if (decision.decision === "reject") {
+        ps.gate = { verdict: "block", reason: note || "Rejected by user" };
+    }
+    return ps;
+}
+//# sourceMappingURL=approval.js.map

package/dist/runtime/phases/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../src/runtime/phases/approval.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAa5C;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC3C,OAAe,EACf,QAA0B,EAC1B,IAKC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO;YACN,EAAE,EAAE,OAAO;YACX,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,oDAAoD;YAC5D,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE;YAC5C,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,oDAAoD,EAAE;YACxF,KAAK,EAAE,UAAU,EAAE;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;SACnB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACnC,MAAM,EAAE,GAAe;QACtB,EAAE,EAAE,OAAO;QACX,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,IAAI,IAAI,IAAI,QAAQ,CAAC,QAAQ,GAAG;QACxC,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE;QAC/C,KAAK,EAAE,UAAU,EAAE;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;KACnB,CAAC;IACF,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACpC,EAAE,CAAC,IAAI,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,kBAAkB,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC"}

package/dist/runtime/phases/expand.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Expand phase helpers — pure transforms for fragment prep + graft promote.
+ * Execution still wires through flow|def path in runtime.ts; logic lives here
+ * so expand does not keep growing executePhaseInner.
+ */
+import type { Phase, Taskflow } from "../../schema.ts";
+import type { PhaseState, RunState } from "../../store.ts";
+import { emptyUsage } from "../../usage.ts";
+export type ExpandMode = "nested" | "graft";
+export declare function resolveExpandMode(phase: Phase): ExpandMode;
+export declare function resolveMaxNodes(phase: Phase, hardCap: number): number;
+/**
+ * Prefix every phase id (and rewrite dependsOn/from + template step refs) so
+ * graft fragments never collide with parent phase ids and internal edges stay valid.
+ */
+export declare function prefixGraftFragment(fragment: Taskflow, expandPhaseId: string): Taskflow;
+/**
+ * Copy child phase states onto the parent run (graft promote).
+ * Skips ids that already exist on the parent.
+ * Returns whether any phase was promoted (caller should zero expand usage to avoid double-count).
+ */
+export declare function promoteGraftPhases(parent: RunState, childPhases: Record<string, PhaseState>): {
+    promoted: number;
+    promotedIds: string[];
+    warnings: string[];
+};
+/** Empty usage helper for expand phase after graft (avoid double-count in rollup). */
+export declare function emptyUsageForGraftExpand(): ReturnType<typeof emptyUsage>;
+//# sourceMappingURL=expand.d.ts.map

package/dist/runtime/phases/expand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../../src/runtime/phases/expand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAE1D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMrE;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,QAAQ,CA2DvF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,QAAQ,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GACrC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAyBjE;AAED,sFAAsF;AACtF,wBAAgB,wBAAwB,IAAI,UAAU,CAAC,OAAO,UAAU,CAAC,CAExE"}

package/dist/runtime/phases/expand.js

@@ -0,0 +1,126 @@
+/**
+ * Expand phase helpers — pure transforms for fragment prep + graft promote.
+ * Execution still wires through flow|def path in runtime.ts; logic lives here
+ * so expand does not keep growing executePhaseInner.
+ */
+import { emptyUsage } from "../../usage.js";
+export function resolveExpandMode(phase) {
+    return phase.expandMode === "graft" ? "graft" : "nested";
+}
+export function resolveMaxNodes(phase, hardCap) {
+    const n = phase.maxNodes;
+    if (typeof n === "number" && Number.isFinite(n)) {
+        return Math.min(hardCap, Math.max(1, Math.floor(n)));
+    }
+    return Math.min(50, hardCap);
+}
+/** Rewrite `{steps.<oldId>...}` placeholders using a phase id map. */
+function rewriteStepRefs(text, idMap) {
+    return text.replace(/\{steps\.([a-zA-Z0-9_-]+)/g, (full, id) => {
+        const mapped = idMap.get(id);
+        return mapped ? `{steps.${mapped}` : full;
+    });
+}
+/**
+ * Prefix every phase id (and rewrite dependsOn/from + template step refs) so
+ * graft fragments never collide with parent phase ids and internal edges stay valid.
+ */
+export function prefixGraftFragment(fragment, expandPhaseId) {
+    const prefix = `${expandPhaseId}-`;
+    const idMap = new Map(fragment.phases.map((p) => [p.id, prefix + p.id]));
+    return {
+        ...fragment,
+        name: fragment.name || `${expandPhaseId}-graft`,
+        phases: fragment.phases.map((p) => {
+            const np = { ...p, id: idMap.get(p.id) ?? prefix + p.id };
+            if (p.dependsOn?.length) {
+                np.dependsOn = p.dependsOn.map((d) => idMap.get(d) ?? d);
+            }
+            if (p.from?.length) {
+                np.from = p.from.map((d) => idMap.get(d) ?? d);
+            }
+            // Rewrite string templates that reference sibling phase ids.
+            const fields = ["task", "over", "when", "until", "input", "judge", "def"];
+            for (const f of fields) {
+                const v = np[f];
+                if (typeof v === "string") {
+                    np[f] = rewriteStepRefs(v, idMap);
+                }
+            }
+            if (Array.isArray(np.run)) {
+                np.run = np.run.map((r) => (typeof r === "string" ? rewriteStepRefs(r, idMap) : r));
+            }
+            else if (typeof np.run === "string") {
+                np.run = rewriteStepRefs(np.run, idMap);
+            }
+            if (Array.isArray(np.eval)) {
+                np.eval = np.eval.map((e) => (typeof e === "string" ? rewriteStepRefs(e, idMap) : e));
+            }
+            if (Array.isArray(np.context)) {
+                np.context = np.context.map((c) => (typeof c === "string" ? rewriteStepRefs(c, idMap) : c));
+            }
+            if (np.branches?.length) {
+                np.branches = np.branches.map((b) => {
+                    const nb = { ...b };
+                    if (typeof nb.task === "string")
+                        nb.task = rewriteStepRefs(nb.task, idMap);
+                    return nb;
+                });
+            }
+            if (np.with && typeof np.with === "object") {
+                const nw = {};
+                for (const [k, v] of Object.entries(np.with)) {
+                    nw[k] = typeof v === "string" ? rewriteStepRefs(v, idMap) : v;
+                }
+                np.with = nw;
+            }
+            const score = np.score;
+            if (score && typeof score === "object") {
+                const ns = { ...score };
+                if (typeof ns.target === "string")
+                    ns.target = rewriteStepRefs(ns.target, idMap);
+                if (ns.judge && typeof ns.judge === "object" && typeof ns.judge.task === "string") {
+                    ns.judge = { ...ns.judge, task: rewriteStepRefs(ns.judge.task, idMap) };
+                }
+                np.score = ns;
+            }
+            return np;
+        }),
+    };
+}
+/**
+ * Copy child phase states onto the parent run (graft promote).
+ * Skips ids that already exist on the parent.
+ * Returns whether any phase was promoted (caller should zero expand usage to avoid double-count).
+ */
+export function promoteGraftPhases(parent, childPhases) {
+    const warnings = [];
+    let promoted = 0;
+    const promotedIds = [];
+    // Collision ownership is defined by the authored definition, not by which
+    // authored phases happen to have reached the scheduler and acquired state
+    // rows. A graft may execute before a later authored phase with the same id;
+    // promoting into that gap would steal ownership and zero the expand's residual
+    // usage even though the authored phase subsequently overwrites the row.
+    const authoredIds = new Set(parent.def.phases.map((phase) => phase.id));
+    for (const [cid, cps] of Object.entries(childPhases)) {
+        if (authoredIds.has(cid) || parent.phases[cid]) {
+            warnings.push(`expand graft skipped promote of '${cid}' (id is authored or already exists on parent)`);
+            continue;
+        }
+        // Keep child usage for audit; expand phase usage must be zeroed by caller
+        // so run-level aggregateUsage does not double-count.
+        parent.phases[cid] = { ...cps, id: cid };
+        promoted++;
+        promotedIds.push(cid);
+    }
+    if (promoted > 0) {
+        warnings.push(`expand graft: promoted ${promoted} phase(s) onto parent run`);
+    }
+    return { promoted, promotedIds, warnings };
+}
+/** Empty usage helper for expand phase after graft (avoid double-count in rollup). */
+export function emptyUsageForGraftExpand() {
+    return emptyUsage();
+}
+//# sourceMappingURL=expand.js.map

package/dist/runtime/phases/expand.js.map

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

package/dist/runtime/phases/parallel.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Parallel phase — wait for all branches (static fan-out).
+ * Scheduling stays injected (`runFanout`); this module only shapes the call.
+ */
+import type { Phase } from "../../schema.ts";
+import type { RunResult } from "../../runner-core.ts";
+import type { PhaseState } from "../../store.ts";
+export interface ParallelBranch {
+    agent: string;
+    task: string;
+}
+export interface ParallelFanout {
+    (branches: ParallelBranch[]): Promise<RunResult[]>;
+}
+export interface ParallelMerge {
+    (phaseId: string, results: RunResult[], inputHash: string, parseJson: boolean): PhaseState;
+}
+/**
+ * Run all parallel branches and merge into one PhaseState.
+ */
+export declare function executeParallelBranches(phase: Phase, branches: ParallelBranch[], runFanout: ParallelFanout, mergePhaseState: ParallelMerge, opts: {
+    inputHash: string;
+    parseJson: boolean;
+    reads?: PhaseState["reads"];
+}): Promise<PhaseState>;
+//# sourceMappingURL=parallel.d.ts.map

package/dist/runtime/phases/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../src/runtime/phases/parallel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC9B,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,aAAa;IAC7B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC;CAC3F;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC5C,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,cAAc,EAAE,EAC1B,SAAS,EAAE,cAAc,EACzB,eAAe,EAAE,aAAa,EAC9B,IAAI,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC5B,GACC,OAAO,CAAC,UAAU,CAAC,CAKrB"}

package/dist/runtime/phases/parallel.js

@@ -0,0 +1,15 @@
+/**
+ * Parallel phase — wait for all branches (static fan-out).
+ * Scheduling stays injected (`runFanout`); this module only shapes the call.
+ */
+/**
+ * Run all parallel branches and merge into one PhaseState.
+ */
+export async function executeParallelBranches(phase, branches, runFanout, mergePhaseState, opts) {
+    const results = await runFanout(branches);
+    const ps = mergePhaseState(phase.id, results, opts.inputHash, opts.parseJson);
+    if (opts.reads)
+        ps.reads = opts.reads;
+    return ps;
+}
+//# sourceMappingURL=parallel.js.map

package/dist/runtime/phases/parallel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.js","sourceRoot":"","sources":["../../../src/runtime/phases/parallel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,KAAY,EACZ,QAA0B,EAC1B,SAAyB,EACzB,eAA8B,EAC9B,IAIC;IAED,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9E,IAAI,IAAI,CAAC,KAAK;QAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACtC,OAAO,EAAE,CAAC;AACX,CAAC"}

package/dist/runtime/phases/race.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Race phase — first **successful** branch wins (not first-settled).
+ */
+import type { Phase } from "../../schema.ts";
+import type { RunResult } from "../../runner-core.ts";
+import type { PhaseState } from "../../store.ts";
+export interface RaceBranch {
+    agent: string;
+    task: string;
+}
+export interface RaceRunOne {
+    (agent: string, task: string, signal?: AbortSignal): Promise<RunResult>;
+}
+export interface RaceIsFailed {
+    (r: RunResult): boolean;
+}
+/**
+ * First **successful** branch wins. Failed settles do not terminate the race.
+ * If all fail → race fails. cancelLosers aborts others after a success (best-effort).
+ * Final usage aggregates every branch result. A non-cooperative branch that
+ * ignores abort is bounded by a finite accounting deadline; if it remains
+ * outstanding the race fails closed with budgetTruncated so no downstream
+ * phase can run against an incomplete usage snapshot.
+ */
+export declare function executeRaceBranches(phase: Phase, branches: RaceBranch[], runOne: RaceRunOne, isFailed: RaceIsFailed, opts: {
+    inputHash: string;
+    parseJson: boolean;
+    readRefs?: PhaseState["reads"];
+    parentSignal?: AbortSignal;
+}): Promise<PhaseState>;
+//# sourceMappingURL=race.d.ts.map

package/dist/runtime/phases/race.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"race.d.ts","sourceRoot":"","sources":["../../../src/runtime/phases/race.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAsBjD,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IAC1B,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,YAAY;IAC5B,CAAC,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,UAAU,EAAE,EACtB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,WAAW,CAAC;CAC3B,GACC,OAAO,CAAC,UAAU,CAAC,CAkMrB"}

package/dist/runtime/phases/race.js

@@ -0,0 +1,220 @@
+/**
+ * Race phase — first **successful** branch wins (not first-settled).
+ */
+import { emptyUsage, aggregateUsage } from "../../usage.js";
+import { safeParse } from "../../interpolate.js";
+/**
+ * A race cannot return a successful result while loser usage is still unknown:
+ * doing so lets the next phase spend against an incomplete budget snapshot.
+ * Give every branch the same finite accounting window as an ordinary agent
+ * call (60s by default), capped so a hostile/injected runner can never strand
+ * the workflow forever even when it ignores AbortSignal.
+ */
+const DEFAULT_ACCOUNTING_TIMEOUT_MS = 60_000;
+const MAX_ACCOUNTING_TIMEOUT_MS = 300_000;
+function accountingTimeoutMs(phase) {
+    const configured = phase.timeout;
+    if (typeof configured !== "number" || !Number.isFinite(configured) || configured < 1000) {
+        return DEFAULT_ACCOUNTING_TIMEOUT_MS;
+    }
+    return Math.min(configured, MAX_ACCOUNTING_TIMEOUT_MS);
+}
+/**
+ * First **successful** branch wins. Failed settles do not terminate the race.
+ * If all fail → race fails. cancelLosers aborts others after a success (best-effort).
+ * Final usage aggregates every branch result. A non-cooperative branch that
+ * ignores abort is bounded by a finite accounting deadline; if it remains
+ * outstanding the race fails closed with budgetTruncated so no downstream
+ * phase can run against an incomplete usage snapshot.
+ */
+export async function executeRaceBranches(phase, branches, runOne, isFailed, opts) {
+    if (branches.length < 2) {
+        return {
+            id: phase.id,
+            status: "failed",
+            error: `race phase '${phase.id}': needs at least 2 branches`,
+            endedAt: Date.now(),
+            usage: emptyUsage(),
+            inputHash: opts.inputHash,
+        };
+    }
+    const cancelLosers = phase.cancelLosers !== false;
+    const controllers = branches.map(() => new AbortController());
+    const accountingTimeout = accountingTimeoutMs(phase);
+    const accountingDeadline = Date.now() + accountingTimeout;
+    const settled = [];
+    let winner;
+    let accountingTimedOut = false;
+    let wake;
+    const gate = new Promise((r) => {
+        wake = r;
+    });
+    const onParentAbort = () => {
+        for (const c of controllers) {
+            try {
+                c.abort();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        // Unblock the wait loop so non-cooperative runners hit the accounting deadline
+        // instead of hanging forever (AGENTS: never hang forever).
+        wake();
+    };
+    if (opts.parentSignal) {
+        if (opts.parentSignal.aborted)
+            onParentAbort();
+        else
+            opts.parentSignal.addEventListener("abort", onParentAbort, { once: true });
+    }
+    try {
+        const branchPromises = branches.map(async (b, i) => {
+            let result;
+            try {
+                result = await runOne(b.agent, b.task, controllers[i].signal);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                result = {
+                    agent: b.agent,
+                    task: b.task,
+                    exitCode: 1,
+                    output: "",
+                    stderr: msg,
+                    usage: emptyUsage(),
+                    stopReason: "error",
+                    errorMessage: msg,
+                };
+            }
+            const entry = { i, result };
+            settled.push(entry);
+            // Parent cancellation wins over a late branch success. The branch still
+            // enters `settled` so its usage is accounted, but it can never revive the
+            // cancelled run or provide a successful race output.
+            if (!winner && opts.parentSignal?.aborted !== true && !isFailed(result)) {
+                winner = entry;
+                if (cancelLosers) {
+                    for (let j = 0; j < controllers.length; j++) {
+                        if (j !== i) {
+                            try {
+                                controllers[j].abort();
+                            }
+                            catch {
+                                /* ignore */
+                            }
+                        }
+                    }
+                }
+                wake();
+            }
+            else if (settled.length >= branches.length) {
+                wake();
+            }
+            return entry;
+        });
+        const allSettled = Promise.allSettled(branchPromises).then(() => undefined);
+        let deadlineTimer;
+        const deadline = new Promise((resolve) => {
+            deadlineTimer = setTimeout(() => {
+                accountingTimedOut = true;
+                for (const c of controllers) {
+                    try {
+                        c.abort();
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                }
+                resolve();
+            }, Math.max(0, accountingDeadline - Date.now()));
+        });
+        try {
+            // First wait for a winner, complete failure, parent abort, or the finite
+            // deadline. Then keep the phase quarantined until every branch reports
+            // its usage. This preserves honest budgets without an unbounded wait.
+            await Promise.race([gate, allSettled, deadline]);
+            if (settled.length < branches.length && !accountingTimedOut) {
+                await Promise.race([allSettled, deadline]);
+            }
+        }
+        finally {
+            if (deadlineTimer)
+                clearTimeout(deadlineTimer);
+        }
+        const totalUsage = aggregateUsage(settled.map((s) => s.result.usage ?? emptyUsage()));
+        const outstanding = branches.length - settled.length;
+        const parentAborted = opts.parentSignal?.aborted === true;
+        if (parentAborted) {
+            const warnings = ["race: parent run aborted; branch successes were discarded"];
+            if (outstanding > 0) {
+                warnings.push(`race: ${outstanding} branch(es) did not report usage within ${accountingTimeout}ms; downstream execution is disabled`);
+            }
+            return {
+                id: phase.id,
+                status: "failed",
+                error: `race phase '${phase.id}' aborted by parent`,
+                usage: totalUsage,
+                inputHash: opts.inputHash,
+                endedAt: Date.now(),
+                budgetTruncated: outstanding > 0 || undefined,
+                warnings,
+                ...(opts.readRefs ? { reads: opts.readRefs } : {}),
+            };
+        }
+        if (outstanding > 0) {
+            return {
+                id: phase.id,
+                status: "failed",
+                error: `race phase '${phase.id}': ${outstanding} branch(es) did not report usage within ${accountingTimeout}ms; refusing to continue with incomplete budget accounting`,
+                usage: totalUsage,
+                inputHash: opts.inputHash,
+                endedAt: Date.now(),
+                budgetTruncated: true,
+                warnings: [
+                    `race: accounting deadline reached with ${outstanding} outstanding branch(es); downstream execution is disabled`,
+                ],
+                ...(opts.readRefs ? { reads: opts.readRefs } : {}),
+            };
+        }
+        if (!winner) {
+            const errs = settled
+                .map((s) => s.result.errorMessage || s.result.stderr || `branch ${s.i + 1} failed`)
+                .filter(Boolean);
+            const warnings = ["race: all branches failed"];
+            return {
+                id: phase.id,
+                status: "failed",
+                error: `race phase '${phase.id}': all ${branches.length} branches failed${errs.length ? `: ${errs.slice(0, 3).join("; ")}` : ""}`,
+                usage: totalUsage,
+                inputHash: opts.inputHash,
+                endedAt: Date.now(),
+                warnings,
+                ...(opts.readRefs ? { reads: opts.readRefs } : {}),
+            };
+        }
+        const w = winner.result;
+        const warnings = [`race: branch ${winner.i + 1}/${branches.length} won (first success)`];
+        if (cancelLosers && branches.length > 1) {
+            warnings.push(`race: cancelLosers aborted ${branches.length - 1} loser branch(es) (best-effort AbortSignal)`);
+        }
+        return {
+            id: phase.id,
+            status: "done",
+            output: w.output,
+            json: opts.parseJson ? safeParse(w.output) : undefined,
+            usage: totalUsage,
+            model: w.model,
+            inputHash: opts.inputHash,
+            endedAt: Date.now(),
+            warnings,
+            ...(opts.readRefs ? { reads: opts.readRefs } : {}),
+        };
+    }
+    finally {
+        if (opts.parentSignal) {
+            opts.parentSignal.removeEventListener("abort", onParentAbort);
+        }
+    }
+}
+//# sourceMappingURL=race.js.map

package/dist/runtime/phases/race.js.map

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

package/dist/runtime/phases/script.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Script phase — zero-token shell command execution.
+ * Isolated from runtime.ts so S5 strangler can flip kinds without growing the monolith.
+ */
+import type { Phase } from "../../schema.ts";
+import type { PhaseState } from "../../store.ts";
+export interface ScriptRunResult {
+    stdout: string;
+    stderr: string;
+    code: number | null;
+    stdoutOversize: boolean;
+    timedOut: boolean;
+}
+/**
+ * Spawn the script command and capture stdout/stderr with timeout + size caps.
+ */
+export declare function runScriptCommand(opts: {
+    /** Interpolated argv (array form) or single shell string as [cmd]. */
+    interpRunText: string[];
+    /** Original `run` shape: array → no shell; string → shell true. */
+    arrayForm: boolean;
+    cwd: string;
+    signal?: AbortSignal;
+    stdinInput?: string;
+    timeoutMs: number;
+}): Promise<ScriptRunResult>;
+/** Map a successful/failed script process result to PhaseState. */
+export declare function scriptResultToPhaseState(phase: Phase, result: ScriptRunResult, opts: {
+    inputHash: string;
+    timeoutMs: number;
+    reads?: PhaseState["reads"];
+}): PhaseState;
+/** Spawn error → failed phase (not cacheable — transient). */
+export declare function scriptSpawnErrorToPhaseState(phaseId: string, err: unknown, opts: {
+    inputHash: string;
+    reads?: PhaseState["reads"];
+}): PhaseState;
+//# sourceMappingURL=script.d.ts.map

package/dist/runtime/phases/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../src/runtime/phases/script.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAOjD,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC5C,sEAAsE;IACtE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,eAAe,CAAC,CA6E3B;AAED,mEAAmE;AACnE,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC5B,GACC,UAAU,CA4BZ;AAED,8DAA8D;AAC9D,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;CAAE,GACtD,UAAU,CAYZ"}