@claudexor/orchestrator 4.1.0 → 4.2.0

package/dist/runScope.js

@@ -0,0 +1,181 @@
+/**
+ * Per-run process custody: mint one scope marker before the first launch,
+ * carry it (plus the host facts a scoped HOME owes the child) in every harness
+ * `spec.env` the run builds, and end the marker's members at the whole-run
+ * terminal barrier on every terminal — the engine side of "a finished
+ * delegated run ends every OS process it left" (owner 1A).
+ *
+ * The durable discovery index lives in the daemon data root and is injected as
+ * a {@link RunScopeCustodian} (the daemon wires {@link DaemonRunScopeIndex};
+ * tests inject a temp one). An embedder without one still gets in-process
+ * custody — a minted marker, carried and reaped at the barrier — but no
+ * crash-recovery index, which is disclosed here rather than silently absent.
+ */
+import { join } from "node:path";
+import { harnessHostFactsEnv, mintRunScopeMarker, reapScopeMembers, scopeMarkerEnv, } from "@claudexor/core";
+import { RunProcessScopeOutcome, } from "@claudexor/schema";
+/**
+ * The default custodian for an embedder/test with no daemon index: it mints
+ * and reaps in process (no durable crash-recovery record), remembering each
+ * marker's opening time so the census can skip processes older than the
+ * scope. The reaper's own per-marker coalescing makes repeat settles safe.
+ */
+export function createInProcessRunScopeCustodian(reap = reapScopeMembers) {
+    const openedAt = new Map();
+    return {
+        async open() {
+            const marker = mintRunScopeMarker();
+            openedAt.set(marker, new Date().toISOString());
+            return { marker };
+        },
+        async settle(_runId, marker) {
+            const scopeStartAt = openedAt.get(marker) ?? null;
+            openedAt.delete(marker);
+            return reap({ marker, scopeStartAt });
+        },
+    };
+}
+export const inProcessRunScopeCustodian = createInProcessRunScopeCustodian();
+/**
+ * Add the run's scope marker (and, when the env is a scoped native-state HOME,
+ * the host facts) to a harness spec env WITHOUT overwriting the existing
+ * HOME/config/auth patch. The marker is applied last so it always survives.
+ * `baseEnv` may be absent (an in-place run that inherits the operator env):
+ * the marker still applies so the run can end what it leaves. Returns
+ * `undefined` only when there is no marker (custody disabled).
+ */
+export function scopedSpecEnv(marker, baseEnv, options = {}) {
+    if (!marker)
+        return baseEnv;
+    return {
+        ...(baseEnv ?? {}),
+        ...harnessHostFactsEnv(baseEnv, options),
+        ...scopeMarkerEnv(marker),
+    };
+}
+/**
+ * The env patch for a deterministic command the run itself launches (its
+ * candidate gates, final verification and adoption): the scope marker alone, so
+ * whatever the command leaves running is ended at the whole-run barrier. The
+ * gate keeps its own HOME and allowlist; nothing is cleaned up per command.
+ */
+export function runScopeGateEnv(marker) {
+    return marker ? scopeMarkerEnv(marker) : undefined;
+}
+function toFacts(marker, outcome) {
+    return RunProcessScopeOutcome.parse({
+        marker,
+        coverage: outcome.coverage,
+        census: outcome.census,
+        census_failure: outcome.censusFailure,
+        restricted: outcome.restricted,
+        ended: outcome.ended.map((m) => ({ pid: m.pid, start_token: m.startToken })),
+        survivors: outcome.survivors.map((m) => ({ pid: m.pid, start_token: m.startToken })),
+        unreadable: outcome.unreadable.map((u) => ({ pid: u.pid, reason: u.reason })),
+        reused_groups: outcome.reusedGroups,
+        settled: outcome.settled,
+        completeness: outcome.completeness,
+        completeness_reason: outcome.completenessReason,
+        incomplete: outcome.incomplete,
+    });
+}
+/** The outcome written when the custodian itself failed: unknown, never clean. */
+export function failedScopeOutcome(reason) {
+    return {
+        coverage: "marker",
+        census: "failed",
+        censusFailure: reason,
+        ended: [],
+        survivors: [],
+        unreadable: [],
+        reusedGroups: [],
+        settled: false,
+        incomplete: false,
+        completeness: "not_provable",
+        completenessReason: reason,
+        restricted: process.platform === "darwin",
+        durationMs: 0,
+    };
+}
+/**
+ * Write the scope outcome to its OWN terminal artifact (`final/process_scope.yaml`)
+ * so it survives the record rewrites and projections the immutable RunFacts
+ * receipt goes through. Best-effort: a write failure never fails an
+ * already-terminal run (the reap itself already happened).
+ */
+export function writeRunScopeFacts(ctx, marker, outcome) {
+    try {
+        const facts = toFacts(marker, outcome);
+        ctx.store.writeYaml(join(ctx.paths.finalDir, "process_scope.yaml"), facts);
+        return facts;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The route-admitting readiness probe and the run must share the EXACT env
+ * (W3.3 / TZ-1 §B: evidence gathered in one env while the run executes in
+ * another is not evidence). The marker and host facts therefore join the
+ * route context itself, so the probe, the model inventory and the spawn all
+ * see one env; `scopedSpecEnv` on the eventual spec is then idempotent.
+ */
+export function scopedRouteContext(ctx, marker) {
+    if (!marker)
+        return ctx;
+    const envForHarness = ctx.envForHarness;
+    return {
+        ...ctx,
+        env: scopedSpecEnv(marker, ctx.env) ?? ctx.env,
+        ...(envForHarness
+            ? {
+                envForHarness: (harnessId) => {
+                    const lane = envForHarness(harnessId);
+                    return lane ? (scopedSpecEnv(marker, lane) ?? lane) : null;
+                },
+            }
+            : {}),
+    };
+}
+export async function openRunScopeCustody(custodian, runId) {
+    const custody = custodian ?? inProcessRunScopeCustodian;
+    const { marker } = await custody.open(runId);
+    let announcedContext = null;
+    let settlement = null;
+    const settle = () => {
+        settlement ??= custody
+            .settle(runId, marker)
+            .catch((error) => failedScopeOutcome(`scope settlement failed: ${error instanceof Error ? error.message : String(error)}`));
+        return settlement;
+    };
+    let recorded = false;
+    const record = async () => {
+        const outcome = await settle();
+        if (!announcedContext || recorded)
+            return;
+        recorded = true;
+        writeRunScopeFacts(announcedContext, marker, outcome);
+    };
+    return {
+        marker,
+        announced: (announce) => (a) => {
+            announcedContext = a;
+            announce(a);
+            a.log.deferTerminal();
+        },
+        barrier: async (drain) => {
+            try {
+                await drain();
+            }
+            finally {
+                await record();
+            }
+        },
+        record,
+        settleUnannounced: async () => {
+            if (!announcedContext)
+                await settle();
+        },
+    };
+}
+//# sourceMappingURL=runScope.js.map

package/dist/runScope.js.map

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

package/dist/runTerminalContext.d.ts

@@ -2,6 +2,7 @@ import type { ArtifactStore } from "@claudexor/artifact-store";
 import type { BudgetLedger, BudgetTerminal } from "@claudexor/budget";
 import type { EventLog } from "@claudexor/event-log";
 import type { ModeKind } from "@claudexor/schema";
+import type { ContinuityTerminalFacts } from "./continuity-terminal.js";
 export interface AnnouncedRunContext {
     log: EventLog;
     store: ArtifactStore;
@@ -24,6 +25,9 @@ export interface AnnouncedRunContext {
      * Ordinary runs may already have emitted a non-deferred terminal and must
      * never be terminalized a second time by the post-drain recheck. */
     recheckBudgetAfterBarrier?: () => boolean;
+    /** The lane's own attempts once they exist (each with its tries' accounts):
+     * a failure this owner stamps after the strategy names their failed tries. */
+    attempts?: () => readonly ContinuityTerminalFacts[];
 }
 type AnnouncedRunIdentity = Pick<AnnouncedRunContext, "log" | "store" | "paths" | "runId" | "taskId" | "mode" | "phase">;
 export declare function announcedRunContext(identity: AnnouncedRunIdentity, ledger: BudgetLedger, hasDelegateAuthority: () => boolean): AnnouncedRunContext;

package/dist/runTerminalContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runTerminalContext.d.ts","sourceRoot":"","sources":["../src/runTerminalContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd;oEACgE;IAChE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAC7D;kFAC8E;IAC9E,cAAc,CAAC,EAAE,MAAM,cAAc,CAAC;IACtC;;wEAEoE;IACpE,yBAAyB,CAAC,EAAE,MAAM,OAAO,CAAC;CAC3C;AAED,KAAK,oBAAoB,GAAG,IAAI,CAC9B,mBAAmB,EACnB,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAClE,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,YAAY,EACpB,oBAAoB,EAAE,MAAM,OAAO,GAClC,mBAAmB,CAUrB"}
+{"version":3,"file":"runTerminalContext.d.ts","sourceRoot":"","sources":["../src/runTerminalContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,QAAQ,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd;oEACgE;IAChE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAC7D;kFAC8E;IAC9E,cAAc,CAAC,EAAE,MAAM,cAAc,CAAC;IACtC;;wEAEoE;IACpE,yBAAyB,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1C;kFAC8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,SAAS,uBAAuB,EAAE,CAAC;CACrD;AAED,KAAK,oBAAoB,GAAG,IAAI,CAC9B,mBAAmB,EACnB,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAClE,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,YAAY,EACpB,oBAAoB,EAAE,MAAM,OAAO,GAClC,mBAAmB,CAUrB"}

package/dist/runTerminalContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"runTerminalContext.js","sourceRoot":"","sources":["../src/runTerminalContext.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,mBAAmB,CACjC,QAA8B,EAC9B,MAAoB,EACpB,oBAAmC;IAEnC,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QAC3B,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;QACnC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;QACxC,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE;QACrD,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE;QACvC,yBAAyB,EAAE,oBAAoB;KAChD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"runTerminalContext.js","sourceRoot":"","sources":["../src/runTerminalContext.ts"],"names":[],"mappings":"AAsCA,MAAM,UAAU,mBAAmB,CACjC,QAA8B,EAC9B,MAAoB,EACpB,oBAAmC;IAEnC,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QAC3B,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;QACnC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;QACxC,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE;QACrD,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE;QACvC,yBAAyB,EAAE,oBAAoB;KAChD,CAAC;AACJ,CAAC"}

package/dist/runTerminalHelpers.d.ts

@@ -0,0 +1,50 @@
+import { type CancelReasonCode, type PoolAttemptFailure, type RunOutcomeFacts as RunOutcomeFactsType } from "@claudexor/schema";
+import type { BudgetTerminal } from "@claudexor/budget";
+import type { TerminalRunEventType } from "@claudexor/event-log";
+import { type SettledBudgetSnapshot } from "./decisionBudget.js";
+import type { OrchestratorResult } from "./orchestrator.js";
+import type { AnnouncedRunContext } from "./runTerminalContext.js";
+export declare function ownsDelegateDrain(context: AnnouncedRunContext): boolean;
+export declare function postDrainBudgetFailure(context: AnnouncedRunContext, terminal: Exclude<BudgetTerminal, null>, budget: SettledBudgetSnapshot, prior: OrchestratorResult): OrchestratorResult;
+/** The terminal-facts failure's message with the run's list, like every
+ * failure terminal; an unreadable history costs only the list, never the terminal. */
+export declare function terminalFactsFailure(context: AnnouncedRunContext, detail: string): {
+    message: string;
+    poolAttempts: PoolAttemptFailure[];
+};
+/** A cancellation the terminal commit chose over the strategy's own verdict. */
+export interface CommittedCancellation {
+    summary: string;
+    cancelReason?: string;
+    payload: Record<string, unknown>;
+}
+/**
+ * The cancel landed after the strategy's last checkpoint, so the terminal
+ * commit (not the strategy) chose it: state it like every cancelled terminal.
+ * The run's collected attempts name their earlier failed tries on the event and
+ * in summary.md; the verdict's own failure cause and record are not the
+ * cancel's (a cancellation has none), except a record that carries capture
+ * facts: it stays on the public failure surface re-labelled with this same
+ * statement (`clearFailureArtifact`), and the event keeps its address. Best
+ * effort: an unreadable history costs only the list, an unwritable artifact
+ * never the terminal.
+ */
+export declare function commitCancellation(context: AnnouncedRunContext, signal: AbortSignal, payload: Record<string, unknown>): CommittedCancellation;
+export declare function terminalEventTypeFor(_originalType: TerminalRunEventType, outcome: RunOutcomeFactsType): TerminalRunEventType;
+/** Map an abort-signal reason token to its typed terminal RunReason. The
+ * abort reason is the ONE channel a cancel's provenance survives on — before
+ * this mapping every host-initiated cancel coerced to user_cancelled (the
+ * daemon's own ctrl-c relay and the MCP host teardown included). The client
+ * vocabulary is read from CANCEL_REASON_CODES so a future member cannot be
+ * silently coerced away here while the HTTP boundary already admits it;
+ * wall_clock_exceeded stays daemon-internal (deliberately NOT in the client
+ * enum — unforgeable). Unknown tokens keep the user_cancelled coercion for
+ * wire compatibility. */
+export declare function cancelReasonFromSignalToken(reason: unknown): "wall_clock_exceeded" | CancelReasonCode;
+export declare function cancellationFacts(signal: AbortSignal, prior: RunOutcomeFactsType): RunOutcomeFactsType;
+export declare function terminalOutcomeFromPayload(payload: Record<string, unknown>): RunOutcomeFactsType;
+export declare function settledSpend(a: AnnouncedRunContext): number | null;
+export declare function isTerminalRecoveryRequired(error: unknown): boolean;
+export declare function committedOutcome(a: AnnouncedRunContext): RunOutcomeFactsType | null;
+export declare function committedResult(a: AnnouncedRunContext, outcome: RunOutcomeFactsType, spendUsd: number | null): OrchestratorResult;
+//# sourceMappingURL=runTerminalHelpers.d.ts.map

package/dist/runTerminalHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runTerminalHelpers.d.ts","sourceRoot":"","sources":["../src/runTerminalHelpers.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,gBAAgB,EAKrB,KAAK,kBAAkB,EACvB,KAAK,eAAe,IAAI,mBAAmB,EAC5C,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAKjE,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAQnE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CASvE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,EACvC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,kBAAkB,GACxB,kBAAkB,CAoCpB;AAED;sFACsF;AACtF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,MAAM,GACb;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAOzD;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,qBAAqB,CA8BvB;AAED,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,oBAAoB,EACnC,OAAO,EAAE,mBAAmB,GAC3B,oBAAoB,CAOtB;AAED;;;;;;;;yBAQyB;AACzB,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,OAAO,GACd,qBAAqB,GAAG,gBAAgB,CAG1C;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,mBAAmB,GACzB,mBAAmB,CAErB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,CAmBhG;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAMlE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOlE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,IAAI,CAWnF;AAED,wBAAgB,eAAe,CAC7B,CAAC,EAAE,mBAAmB,EACtB,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,kBAAkB,CAgBpB"}

package/dist/runTerminalHelpers.js

@@ -0,0 +1,200 @@
+/**
+ * Pure helpers of the whole-strategy terminal net (`runTerminals.ts`): the
+ * terminal event type from the canonical axes, cancel-reason mapping, payload
+ * decoding, committed-outcome recovery and the post-drain budget failure.
+ */
+import { join } from "node:path";
+import { makeOutcomeFacts, needsOperatorAttention, normalizeCancelReasonCode, RunOutcomeFacts, } from "@claudexor/schema";
+import { readTextSafe } from "@claudexor/util";
+import { budgetFailureRecord, classifyBudgetFailure } from "./budgetFailure.js";
+import { poolFailure } from "./pool-attempt-evidence.js";
+import { reconcileDecisionBudget } from "./decisionBudget.js";
+import { cancellationStatement, writeFailure } from "./runTerminalResults.js";
+import { clearFailureArtifact, reconcileWorkProductTerminal, terminalOutcomeFacts, } from "./terminalOutcome.js";
+export function ownsDelegateDrain(context) {
+    try {
+        return context.recheckBudgetAfterBarrier?.() === true;
+    }
+    catch {
+        // Reconciliation is an extra authority granted only to a proven Delegate
+        // drain owner. An unreadable ownership predicate must fail closed instead
+        // of touching an ordinary Agent's already-terminal artifacts.
+        return false;
+    }
+}
+export function postDrainBudgetFailure(context, terminal, budget, prior) {
+    const mapping = classifyBudgetFailure({ denial: null, terminal });
+    const facts = terminalOutcomeFacts(prior.facts, "failed", mapping.reason);
+    reconcileDecisionBudget(context, budget, { facts, why: mapping.safeMessage });
+    reconcileWorkProductTerminal(context, facts);
+    const { message, poolAttempts } = poolFailure(mapping.safeMessage, context.attempts?.() ?? []);
+    context.store.writeText(join(context.paths.finalDir, "summary.md"), `# Run ${context.runId} (${context.mode})\n\n- Lifecycle: failed (${mapping.reason})\n- Phase: budget\n\n${message}\n`);
+    writeFailure(context.store, context.paths, {
+        ...budgetFailureRecord(mapping, { runDir: context.paths.root }),
+        safeMessage: message,
+        poolAttempts,
+    });
+    context.log.emit("output.ready", {
+        kind: "summary",
+        path: "final/summary.md",
+        state: "diagnostic",
+    });
+    context.log.emit("run.failed", {
+        lifecycle: "failed",
+        facts,
+        reason: mapping.reason,
+        phase: "budget",
+        error: message,
+        pool_attempts: poolAttempts,
+        failure_ref: "final/failure.yaml",
+    });
+    return {
+        ...prior,
+        lifecycle: "failed",
+        facts,
+        summary: message,
+        spendUsd: budget.spendUsd,
+    };
+}
+/** The terminal-facts failure's message with the run's list, like every
+ * failure terminal; an unreadable history costs only the list, never the terminal. */
+export function terminalFactsFailure(context, detail) {
+    const message = `terminal facts preparation failed: ${detail}`;
+    try {
+        return poolFailure(message, context.attempts?.() ?? []);
+    }
+    catch {
+        return { message, poolAttempts: [] };
+    }
+}
+/**
+ * The cancel landed after the strategy's last checkpoint, so the terminal
+ * commit (not the strategy) chose it: state it like every cancelled terminal.
+ * The run's collected attempts name their earlier failed tries on the event and
+ * in summary.md; the verdict's own failure cause and record are not the
+ * cancel's (a cancellation has none), except a record that carries capture
+ * facts: it stays on the public failure surface re-labelled with this same
+ * statement (`clearFailureArtifact`), and the event keeps its address. Best
+ * effort: an unreadable history costs only the list, an unwritable artifact
+ * never the terminal.
+ */
+export function commitCancellation(context, signal, payload) {
+    let attempts = null;
+    try {
+        attempts = context.attempts?.() ?? null;
+    }
+    catch {
+        /* the cancellation stands without its list */
+    }
+    const statement = cancellationStatement(context.runId, context.mode, signal, attempts ?? []);
+    try {
+        context.store.writeText(join(context.paths.finalDir, "summary.md"), statement.markdown);
+    }
+    catch {
+        /* the terminal event remains the authority */
+    }
+    let failureKept = false;
+    try {
+        failureKept = clearFailureArtifact(context, { summary: statement.summary });
+    }
+    catch {
+        /* the terminal event remains the authority */
+    }
+    const { phase: _phase, error: _error, failure_ref: _failureRef, ...kept } = payload;
+    return {
+        summary: statement.summary,
+        ...(statement.cancelReason ? { cancelReason: statement.cancelReason } : {}),
+        payload: {
+            ...kept,
+            ...(failureKept ? { failure_ref: "final/failure.yaml" } : {}),
+            ...(statement.cancelReason ? { cancel_reason: statement.cancelReason } : {}),
+            ...(attempts ? { pool_attempts: statement.poolAttempts } : {}),
+        },
+    };
+}
+export function terminalEventTypeFor(_originalType, outcome) {
+    if (outcome.lifecycle !== "succeeded")
+        return "run.failed";
+    if (needsOperatorAttention(outcome, false))
+        return "run.blocked";
+    // The canonical axes own terminal type. Preserving a producer-authored
+    // run.blocked with clean axes creates an unexplainable block (no reason or
+    // required action), so it is normalized to completed.
+    return "run.completed";
+}
+/** Map an abort-signal reason token to its typed terminal RunReason. The
+ * abort reason is the ONE channel a cancel's provenance survives on — before
+ * this mapping every host-initiated cancel coerced to user_cancelled (the
+ * daemon's own ctrl-c relay and the MCP host teardown included). The client
+ * vocabulary is read from CANCEL_REASON_CODES so a future member cannot be
+ * silently coerced away here while the HTTP boundary already admits it;
+ * wall_clock_exceeded stays daemon-internal (deliberately NOT in the client
+ * enum — unforgeable). Unknown tokens keep the user_cancelled coercion for
+ * wire compatibility. */
+export function cancelReasonFromSignalToken(reason) {
+    if (reason === "wall_clock_exceeded")
+        return "wall_clock_exceeded";
+    return normalizeCancelReasonCode(reason) ?? "user_cancelled";
+}
+export function cancellationFacts(signal, prior) {
+    return terminalOutcomeFacts(prior, "cancelled", cancelReasonFromSignalToken(signal.reason));
+}
+export function terminalOutcomeFromPayload(payload) {
+    const parsed = RunOutcomeFacts.safeParse(payload["facts"]);
+    if (parsed.success)
+        return parsed.data;
+    // Older in-process terminal producers (including the Delegate drain
+    // contract) supplied only lifecycle. Keep that compatible while treating an
+    // explicitly malformed facts object as a contradiction that must fail
+    // closed through the terminal-facts path below.
+    if (!Object.prototype.hasOwnProperty.call(payload, "facts")) {
+        const lifecycle = payload["lifecycle"];
+        if (lifecycle === "succeeded" ||
+            lifecycle === "failed" ||
+            lifecycle === "cancelled" ||
+            lifecycle === "interrupted") {
+            return makeOutcomeFacts(lifecycle);
+        }
+    }
+    return RunOutcomeFacts.parse(payload["facts"]);
+}
+export function settledSpend(a) {
+    try {
+        return a.spend ? a.spend() : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function isTerminalRecoveryRequired(error) {
+    return (!!error &&
+        typeof error === "object" &&
+        "code" in error &&
+        error.code === "terminal_recovery_required");
+}
+export function committedOutcome(a) {
+    const terminal = [...a.log.readAll().events]
+        .reverse()
+        .find((event) => event.type === "run.completed" ||
+        event.type === "run.blocked" ||
+        event.type === "run.failed");
+    const parsed = RunOutcomeFacts.safeParse(terminal?.payload["facts"]);
+    return parsed.success ? parsed.data : null;
+}
+export function committedResult(a, outcome, spendUsd) {
+    const summary = readTextSafe(join(a.paths.finalDir, "summary.md"))?.trim().slice(0, 400) ??
+        `run terminal committed with lifecycle ${outcome.lifecycle}`;
+    return {
+        runId: a.runId,
+        taskId: a.taskId,
+        mode: a.mode,
+        lifecycle: outcome.lifecycle,
+        facts: outcome,
+        winner: null,
+        runDir: a.paths.root,
+        summary,
+        candidates: [],
+        spendUsd,
+    };
+}
+//# sourceMappingURL=runTerminalHelpers.js.map

package/dist/runTerminalHelpers.js.map

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

package/dist/runTerminalResults.d.ts

@@ -1,6 +1,6 @@
 import type { ArtifactStore } from "@claudexor/artifact-store";
 import type { EventLog } from "@claudexor/event-log";
-import { RunFailure, RunFailureCode, type ModeKind, type RunOutcomeFacts, type RunResumable, type VendorFailureEvidence, HarnessRequestRefusal } from "@claudexor/schema";
+import { RunFailure, RunFailureCode, type ModeKind, type RunOutcomeFacts, type RunResumable, type VendorFailureEvidence, type PoolAttemptFailure, HarnessRequestRefusal } from "@claudexor/schema";
 import type { OrchestratorResult } from "./orchestrator.js";
 import { type ContinuityTerminalFacts } from "./continuity-terminal.js";
 export declare function writeFailure(store: ArtifactStore, paths: ReturnType<ArtifactStore["runPaths"]>, failure: {
@@ -24,6 +24,9 @@ export declare function writeFailure(store: ArtifactStore, paths: ReturnType<Art
      * null/omitted when no vendor-typed evidence exists. Opaque evidence. */
     vendorFailure?: VendorFailureEvidence | null;
     requestRefusal?: HarnessRequestRefusal;
+    captureFailure?: RunFailure["captureFailure"];
+    /** Every failed try with its own account, in order (empty = none). */
+    poolAttempts?: readonly PoolAttemptFailure[];
     nextActions?: string[];
 }): void;
 /** The typed provenance an error declared about its own terminal. */
@@ -50,6 +53,17 @@ export declare function requestRefusalFailure(requestRefusal: HarnessRequestRefu
  * reduces it to a message string.
  */
 export declare function declaredFailure(err: unknown): DeclaredFailure;
+/**
+ * The one statement of a cancellation, shared by every cancelled terminal: the
+ * cancel first (a STRING abort reason, e.g. the maxSeconds deadline, is named),
+ * then the run's earlier failed tries; `markdown` is its summary.md.
+ */
+export declare function cancellationStatement(runId: string, mode: ModeKind, cancelSignal: AbortSignal | undefined, attempts: readonly ContinuityTerminalFacts[]): {
+    cancelReason?: string;
+    summary: string;
+    markdown: string;
+    poolAttempts: PoolAttemptFailure[];
+};
 /**
  * Terminal result for a cancelled run: emits run.failed with status
  * "cancelled" so every mode ends consistently. `writeTelemetry` carries the
@@ -72,19 +86,27 @@ store?: ArtifactStore,
  * when cancellation wins during the Delegate terminal barrier. */
 priorFacts?: RunOutcomeFacts, 
 /** The attempt's continuation facts (cause wall_clock/cancelled, carriers), when any. */
-resumable?: RunResumable | null): OrchestratorResult;
+resumable?: RunResumable | null, 
+/** The run's attempts: their earlier failed tries stay diagnostic history
+ * beside the cancellation (a cancelled try has no row; no failure record). */
+attempts?: readonly ContinuityTerminalFacts[]): OrchestratorResult;
 /**
  * Shared post-announce failure terminal. Unexpected throws use its internal
  * defaults; known callers may supply narrow typed provenance. Every run ends
  * with failure.yaml + summary + a terminal run.failed event.
  */
 export declare function failTerminally(log: EventLog, store: ArtifactStore, paths: ReturnType<ArtifactStore["runPaths"]>, runId: string, taskId: string, mode: ModeKind, phase: string, err: unknown, spendUsd?: number | null, failureMeta?: {
-    category?: "harness_error" | "internal";
+    category?: "harness_error" | "internal" | "project";
+    captureFailure?: RunFailure["captureFailure"];
     harnessId?: string;
     attemptId?: string;
     rawDetailRef?: string;
     nextActions?: string[];
+    /** Actions that follow this terminal's own remedy (an earlier record's capture actions). */
+    followUps?: readonly string[];
     priorFacts?: RunOutcomeFacts;
     continuity?: readonly ContinuityTerminalFacts[];
+    /** Every attempt whose failed tries this terminal names (default: `continuity`). */
+    attempts?: readonly ContinuityTerminalFacts[];
 }): OrchestratorResult;
 //# sourceMappingURL=runTerminalResults.d.ts.map

package/dist/runTerminalResults.d.ts.map

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