@acpus/runtime 0.1.0 → 0.2.0

package/dist/run-control.d.ts

@@ -0,0 +1,45 @@
+import type { AcpusIr } from "@acpus/core";
+import type { NodeExecutionState } from "./types.js";
+import { RunStore } from "./store.js";
+export type RunControlAbortState = "paused" | "cancelled";
+export declare const PAUSED_ABORT_ERROR = "Aborted: paused";
+export declare function abortedNodeError(state: RunControlAbortState): string;
+export declare function isPausedContinuationState(state: NodeExecutionState | undefined): boolean;
+export interface NodeRetryPreparation {
+    state: NodeExecutionState;
+    ir: AcpusIr;
+    input: Record<string, unknown>;
+}
+export declare class RunControl {
+    private readonly store;
+    /** Active abort controllers keyed by "runId:nodeKey" for pause/cancel support. */
+    private readonly abortControllers;
+    /** Intent of an in-flight abort keyed by "runId:nodeKey" (pause vs cancel). */
+    private readonly abortIntents;
+    /** Per-run scheduling guards used to stop new work after pause/cancel. */
+    private readonly schedulingPaused;
+    private readonly schedulingCancelled;
+    constructor(store: RunStore);
+    registerAbortController(runId: string, nodeKey: string, controller: AbortController): void;
+    clearInFlightNode(runId: string, nodeKey: string): void;
+    clearSchedulingGuards(runId: string): void;
+    recoverStaleNodes(runId: string): void;
+    prepareNodeRetry(runId: string, nodeKey: string): NodeRetryPreparation;
+    resetNodeForRetry(runId: string, state: NodeExecutionState): void;
+    pauseRun(runId: string): void;
+    cancelRun(runId: string): void;
+    resumeRun(runId: string): void;
+    retryRun(runId: string): void;
+    applySchedulingGuard(runId: string, state: NodeExecutionState): RunControlAbortState | undefined;
+    abortIntent(runId: string, nodeKey: string): RunControlAbortState;
+    readAbortedStateOnDisk(runId: string, nodeKey: string): RunControlAbortState | undefined;
+    isStaleAttemptOnDisk(runId: string, nodeKey: string, attempt: number, startedAt: string | undefined): boolean;
+    syncInFrameAttemptFromDisk(runId: string, nodeKey: string, state: NodeExecutionState): void;
+    cancelDescendantsInScope(runId: string, rootNodeKey: string): void;
+    private pauseRunningNode;
+    private cancelMaterializedNode;
+    private descendantsInScope;
+    private key;
+    private clearAttemptFields;
+}
+//# sourceMappingURL=run-control.d.ts.map

package/dist/run-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-control.d.ts","sourceRoot":"","sources":["../src/run-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAa,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAYtC,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE1D,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEpE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAExF;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,qBAAa,UAAU;IAWT,OAAO,CAAC,QAAQ,CAAC,KAAK;IAVlC,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2C;IAE5E,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgD;IAE7E,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8B;IAC/D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA8B;gBAErC,KAAK,EAAE,QAAQ;IAE5C,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI;IAI1F,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKvD,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1C,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAYtC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB;IA4BtE,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAMjE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAoB7B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAwC9B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAsB9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAiC7B,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,SAAS;IAYhG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB;IAIjE,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAKxF,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO;IAK7G,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAO3F,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIlE,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,kBAAkB;CAS3B"}

package/dist/run-control.js

@@ -0,0 +1,253 @@
+import { isNodeKeyBelowAnyAnchor } from "./keys.js";
+import { canTransition, cancelPendingForRunCancel, resetCancelledForRunRetry, resetAwaitingForCrashRecovery, resetFailedForRetry, resetPausedForRunResume, resetRunningForCrashRecovery, transition } from "./state-machine.js";
+export const PAUSED_ABORT_ERROR = "Aborted: paused";
+export function abortedNodeError(state) {
+    return state === "paused" ? PAUSED_ABORT_ERROR : "Aborted: cancelled";
+}
+export function isPausedContinuationState(state) {
+    return state?.state === "pending" && state.attempt > 0 && state.error === PAUSED_ABORT_ERROR;
+}
+export class RunControl {
+    store;
+    /** Active abort controllers keyed by "runId:nodeKey" for pause/cancel support. */
+    abortControllers = new Map();
+    /** Intent of an in-flight abort keyed by "runId:nodeKey" (pause vs cancel). */
+    abortIntents = new Map();
+    /** Per-run scheduling guards used to stop new work after pause/cancel. */
+    schedulingPaused = new Map();
+    schedulingCancelled = new Map();
+    constructor(store) {
+        this.store = store;
+    }
+    registerAbortController(runId, nodeKey, controller) {
+        this.abortControllers.set(this.key(runId, nodeKey), controller);
+    }
+    clearInFlightNode(runId, nodeKey) {
+        this.abortControllers.delete(this.key(runId, nodeKey));
+        this.abortIntents.delete(this.key(runId, nodeKey));
+    }
+    clearSchedulingGuards(runId) {
+        this.schedulingPaused.delete(runId);
+        this.schedulingCancelled.delete(runId);
+    }
+    recoverStaleNodes(runId) {
+        for (const nodeState of this.store.listNodeStates(runId)) {
+            if (nodeState.state === "running") {
+                nodeState.state = resetRunningForCrashRecovery(nodeState.state);
+                this.store.writeNodeState(runId, nodeState);
+            }
+            else if (nodeState.state === "awaiting") {
+                nodeState.state = resetAwaitingForCrashRecovery(nodeState.state);
+                this.store.writeNodeState(runId, nodeState);
+            }
+        }
+    }
+    prepareNodeRetry(runId, nodeKey) {
+        const state = this.store.readNodeState(runId, nodeKey);
+        if (!state) {
+            throw new Error(`Node ${nodeKey} not found in run ${runId}`);
+        }
+        if (state.state !== "failed") {
+            throw new Error(`Cannot retry node ${nodeKey} in state '${state.state}': only failed executable nodes are retryable`);
+        }
+        if (state.kind !== "run.agent" && state.kind !== "run.program") {
+            throw new Error(`Cannot retry node ${nodeKey}: only failed executable nodes are retryable`);
+        }
+        const meta = this.store.readRunMeta(runId);
+        if (!meta)
+            throw new Error(`Run ${runId} not found`);
+        if (meta.status !== "failed") {
+            throw new Error(`Cannot retry node ${nodeKey}: node retry is accepted only when the Run is failed`);
+        }
+        const ir = this.store.readIr(runId);
+        const input = this.store.readInput(runId);
+        if (!ir || !input) {
+            throw new Error(`Cannot retry node ${nodeKey}: run ${runId} has no persisted IR or input`);
+        }
+        return { state, ir, input };
+    }
+    resetNodeForRetry(runId, state) {
+        state.state = resetFailedForRetry(state.state);
+        state.error = undefined;
+        this.store.writeNodeState(runId, state);
+    }
+    pauseRun(runId) {
+        const meta = this.store.readRunMeta(runId);
+        if (!meta)
+            throw new Error(`Run ${runId} not found`);
+        if (meta.status !== "running") {
+            throw new Error(`Cannot pause a run in state '${meta.status}'`);
+        }
+        this.schedulingPaused.set(runId, true);
+        for (const nodeState of this.store.listNodeStates(runId)) {
+            if (nodeState.state === "running") {
+                this.pauseRunningNode(runId, nodeState.nodeKey);
+            }
+        }
+        meta.status = "paused";
+        meta.updatedAt = new Date().toISOString();
+        this.store.writeRunMeta(runId, meta);
+    }
+    cancelRun(runId) {
+        const meta = this.store.readRunMeta(runId);
+        if (!meta)
+            throw new Error(`Run ${runId} not found`);
+        if (meta.status !== "running" && meta.status !== "paused") {
+            throw new Error(`Cannot cancel a run in state '${meta.status}'`);
+        }
+        this.schedulingCancelled.set(runId, true);
+        for (const [key, intent] of this.abortIntents) {
+            if (key.startsWith(`${runId}:`) && intent === "paused") {
+                this.abortIntents.set(key, "cancelled");
+            }
+        }
+        for (const nodeState of this.store.listNodeStates(runId)) {
+            if (nodeState.state === "running" || nodeState.state === "awaiting") {
+                this.cancelMaterializedNode(runId, nodeState.nodeKey);
+            }
+        }
+        for (const nodeState of this.store.listNodeStates(runId)) {
+            if (nodeState.state === "paused" && canTransition(nodeState.state, "cancelled")) {
+                nodeState.state = transition(nodeState.state, "cancelled");
+                this.store.writeNodeState(runId, nodeState);
+            }
+        }
+        for (const nodeState of this.store.listNodeStates(runId)) {
+            if (nodeState.state === "pending") {
+                nodeState.state = cancelPendingForRunCancel(nodeState.state);
+                this.store.writeNodeState(runId, nodeState);
+            }
+        }
+        meta.status = "cancelled";
+        meta.updatedAt = new Date().toISOString();
+        this.store.writeRunMeta(runId, meta);
+    }
+    resumeRun(runId) {
+        const meta = this.store.readRunMeta(runId);
+        if (!meta)
+            throw new Error(`Run ${runId} not found`);
+        if (meta.status !== "paused") {
+            throw new Error(`Cannot resume a run in state '${meta.status}'`);
+        }
+        this.clearSchedulingGuards(runId);
+        this.recoverStaleNodes(runId);
+        for (const nodeState of this.store.listNodeStates(runId)) {
+            if (nodeState.state === "paused") {
+                nodeState.state = resetPausedForRunResume(nodeState.state);
+                this.store.writeNodeState(runId, nodeState);
+            }
+        }
+        meta.status = "running";
+        meta.updatedAt = new Date().toISOString();
+        this.store.writeRunMeta(runId, meta);
+    }
+    retryRun(runId) {
+        const meta = this.store.readRunMeta(runId);
+        if (!meta)
+            throw new Error(`Run ${runId} not found`);
+        if (meta.status !== "failed") {
+            throw new Error(`Cannot retry a run in state '${meta.status}'`);
+        }
+        this.clearSchedulingGuards(runId);
+        for (const nodeState of this.store.listNodeStates(runId)) {
+            if (nodeState.state === "failed") {
+                nodeState.state = resetFailedForRetry(nodeState.state);
+                this.clearAttemptFields(nodeState);
+                this.store.writeNodeState(runId, nodeState);
+            }
+            else if (nodeState.state === "paused") {
+                nodeState.state = resetPausedForRunResume(nodeState.state);
+                this.clearAttemptFields(nodeState);
+                this.store.writeNodeState(runId, nodeState);
+            }
+            else if (nodeState.state === "cancelled") {
+                nodeState.state = resetCancelledForRunRetry(nodeState.state);
+                this.clearAttemptFields(nodeState);
+                this.store.writeNodeState(runId, nodeState);
+            }
+        }
+        meta.status = "running";
+        meta.output = undefined;
+        meta.error = undefined;
+        meta.runAttempt++;
+        meta.updatedAt = new Date().toISOString();
+        this.store.writeRunMeta(runId, meta);
+    }
+    applySchedulingGuard(runId, state) {
+        if (this.schedulingPaused.get(runId) && state.state === "pending") {
+            return "paused";
+        }
+        if (this.schedulingCancelled.get(runId) && state.state === "pending") {
+            state.state = cancelPendingForRunCancel(state.state);
+            this.store.writeNodeState(runId, state);
+            return "cancelled";
+        }
+        return undefined;
+    }
+    abortIntent(runId, nodeKey) {
+        return this.abortIntents.get(this.key(runId, nodeKey)) ?? "paused";
+    }
+    readAbortedStateOnDisk(runId, nodeKey) {
+        const state = this.store.readNodeState(runId, nodeKey)?.state;
+        return state === "paused" || state === "cancelled" ? state : undefined;
+    }
+    isStaleAttemptOnDisk(runId, nodeKey, attempt, startedAt) {
+        const current = this.store.readNodeState(runId, nodeKey);
+        return current !== undefined && current.attempt > attempt && current.startedAt !== startedAt;
+    }
+    syncInFrameAttemptFromDisk(runId, nodeKey, state) {
+        const current = this.store.readNodeState(runId, nodeKey);
+        if (current !== undefined && current.startedAt === state.startedAt && current.attempt > state.attempt) {
+            state.attempt = current.attempt;
+        }
+    }
+    cancelDescendantsInScope(runId, rootNodeKey) {
+        this.descendantsInScope(runId, rootNodeKey, (rid, key) => this.cancelMaterializedNode(rid, key));
+    }
+    pauseRunningNode(runId, nodeKey) {
+        const state = this.store.readNodeState(runId, nodeKey);
+        if (!state || !canTransition(state.state, "paused")) {
+            return;
+        }
+        this.abortIntents.set(this.key(runId, nodeKey), "paused");
+        this.abortControllers.get(this.key(runId, nodeKey))?.abort();
+        state.state = transition(state.state, "paused");
+        this.store.writeNodeState(runId, state);
+    }
+    cancelMaterializedNode(runId, nodeKey) {
+        this.abortIntents.set(this.key(runId, nodeKey), "cancelled");
+        this.abortControllers.get(this.key(runId, nodeKey))?.abort();
+        const state = this.store.readNodeState(runId, nodeKey);
+        if (state?.state === "pending") {
+            state.state = cancelPendingForRunCancel(state.state);
+            this.store.writeNodeState(runId, state);
+        }
+        else if (state && canTransition(state.state, "cancelled")) {
+            state.state = transition(state.state, "cancelled");
+            this.store.writeNodeState(runId, state);
+        }
+    }
+    descendantsInScope(runId, rootNodeKey, action) {
+        const states = this.store.listNodeStates(runId);
+        for (const nodeState of states) {
+            if (nodeState.state !== "running" && nodeState.state !== "awaiting" && nodeState.state !== "pending")
+                continue;
+            if (!isNodeKeyBelowAnyAnchor(nodeState.nodeKey, [rootNodeKey]))
+                continue;
+            action(runId, nodeState.nodeKey);
+        }
+    }
+    key(runId, nodeKey) {
+        return `${runId}:${nodeKey}`;
+    }
+    clearAttemptFields(state) {
+        state.startedAt = undefined;
+        state.completedAt = undefined;
+        state.error = undefined;
+        state.output = undefined;
+        state.artifactRefs = undefined;
+        state.dynamicContext = undefined;
+        state.agentTelemetry = undefined;
+    }
+}
+//# sourceMappingURL=run-control.js.map

package/dist/run-control.js.map

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

package/dist/state-machine.d.ts

@@ -11,6 +11,8 @@ export declare function transition(from: NodeState, to: NodeState): NodeState;
 export declare function isTerminal(state: NodeState): boolean;
 /** Control-plane reset: operator retry of a failed node (failed → pending). */
 export declare function resetFailedForRetry(from: NodeState): NodeState;
+/** Control-plane reset: Run-level retry of a cancelled node in a failed Run (cancelled → pending). */
+export declare function resetCancelledForRunRetry(from: NodeState): NodeState;
 /** Control-plane reset: Run-level resume of a paused node (paused → pending). */
 export declare function resetPausedForRunResume(from: NodeState): NodeState;
 /** Control-plane reset: crash recovery of a stale running node (running → pending). */
@@ -22,6 +24,8 @@ export declare function resetRunningForCrashRecovery(from: NodeState): NodeState
  * wait for a fresh human decision.
  */
 export declare function resetAwaitingForCrashRecovery(from: NodeState): NodeState;
+/** Control-plane cancellation: Run-level cancel of a materialized pending node (pending → cancelled). */
+export declare function cancelPendingForRunCancel(from: NodeState): NodeState;
 /** Create the initial NodeExecutionState for a node. */
-export declare function createInitialNodeState(nodeKey: string, nodeId: string, kind: IrNodeKind): NodeExecutionState;
+export declare function createInitialNodeState(nodeKey: string, nodeId: string, kind: IrNodeKind, definitionHash?: string): NodeExecutionState;
 //# sourceMappingURL=state-machine.d.ts.map

package/dist/state-machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAwBhE,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAErE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,SAAS,CAKpE;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEpD;AAQD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAK9D;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAKlE;AAED,uFAAuF;AACvF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAKxE;AAED,wDAAwD;AACxD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GACf,kBAAkB,CAQpB"}
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAwBhE,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAErE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,SAAS,CAKpE;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEpD;AAQD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAK9D;AAED,sGAAsG;AACtG,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAKpE;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAKlE;AAED,uFAAuF;AACvF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAKxE;AAED,yGAAyG;AACzG,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAKpE;AAED,wDAAwD;AACxD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,kBAAkB,CASpB"}

package/dist/state-machine.js

@@ -48,6 +48,13 @@ export function resetFailedForRetry(from) {
     }
     return "pending";
 }
+/** Control-plane reset: Run-level retry of a cancelled node in a failed Run (cancelled → pending). */
+export function resetCancelledForRunRetry(from) {
+    if (from !== "cancelled") {
+        throw new Error(`Cannot retry cancelled node from state '${from}': only cancelled nodes use Run-level cancelled reset`);
+    }
+    return "pending";
+}
 /** Control-plane reset: Run-level resume of a paused node (paused → pending). */
 export function resetPausedForRunResume(from) {
     if (from !== "paused") {
@@ -74,12 +81,20 @@ export function resetAwaitingForCrashRecovery(from) {
     }
     return "pending";
 }
+/** Control-plane cancellation: Run-level cancel of a materialized pending node (pending → cancelled). */
+export function cancelPendingForRunCancel(from) {
+    if (from !== "pending") {
+        throw new Error(`Cannot cancel pending node from state '${from}': only pending nodes use Run-level pending cancel`);
+    }
+    return "cancelled";
+}
 /** Create the initial NodeExecutionState for a node. */
-export function createInitialNodeState(nodeKey, nodeId, kind) {
+export function createInitialNodeState(nodeKey, nodeId, kind, definitionHash) {
     return {
         nodeKey,
         nodeId,
         kind,
+        definitionHash,
         state: "pending",
         attempt: 0
     };

package/dist/state-machine.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,2EAA2E;AAC3E,+EAA+E;AAE/E,MAAM,WAAW,GAAsC;IACrD,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7B,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC5E,8EAA8E;IAC9E,0EAA0E;IAC1E,0EAA0E;IAC1E,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC7C,sEAAsE;IACtE,gEAAgE;IAChE,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC;IAC9B,SAAS,EAAE,IAAI,GAAG,EAAE;IACpB,MAAM,EAAE,IAAI,GAAG,EAAE;IACjB,SAAS,EAAE,IAAI,GAAG,EAAE;CACrB,CAAC;AAEF,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,EAAa;IAC1D,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,EAAa;IACvD,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,KAAgB;IACzC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,oEAAoE;AACpE,EAAE;AACF,wEAAwE;AACxE,sEAAsE;AACtE,gEAAgE;AAEhE,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,oCAAoC,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,uBAAuB,CAAC,IAAe;IACrD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,mCAAmC,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,4BAA4B,CAAC,IAAe;IAC1D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,oCAAoC,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAe;IAC3D,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,qCAAqC,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,sBAAsB,CACpC,OAAe,EACf,MAAc,EACd,IAAgB;IAEhB,OAAO;QACL,OAAO;QACP,MAAM;QACN,IAAI;QACJ,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,CAAC;KACX,CAAC;AACJ,CAAC"}
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -1,5 +1,5 @@
 import type { AcpusIr } from "@acpus/core";
-import type { NodeExecutionState, RunCleanResult, RunState } from "./types.js";
+import type { NodeExecutionState, RunCheckpoint, RunCleanResult, RunState } from "./types.js";
 export declare class RunStore {
     private readonly baseDir;
     constructor(baseDir?: string);
@@ -7,6 +7,7 @@ export declare class RunStore {
     initRun(runId: string, ir: AcpusIr, input: Record<string, unknown>, source?: {
         workflowRef?: string;
         workflowSourcePath?: string;
+        lineage?: import("./types.js").RunLineage;
     }): RunState;
     /** Read the frozen IR snapshot for a run. */
     readIr(runId: string): AcpusIr | undefined;
@@ -26,6 +27,29 @@ export declare class RunStore {
     artifactsDir(runId: string, nodeKey: string): string;
     /** Check if a run exists on disk. */
     hasRun(runId: string): boolean;
+    /**
+     * Append a Run Checkpoint for a Node that has just reached a terminal state.
+     * Idempotent on `nodeKey`: if a checkpoint for this Node Key already exists,
+     * its entry is replaced in-place to reflect the latest terminal outcome
+     * (e.g., a Node Retry that flips failed → completed). Sequence numbers
+     * remain monotonic for new entries.
+     */
+    appendCheckpoint(runId: string, checkpoint: Omit<RunCheckpoint, "sequence">): void;
+    /**
+     * Read the ordered Run Checkpoints for a Run. Returns an empty array when
+     * the run was created before checkpoints existed (in which case the Run is
+     * not forkable — callers MUST treat absence as ineligible for fork).
+     */
+    readCheckpoints(runId: string): RunCheckpoint[];
+    /** True when this Run has a checkpoint index file (regardless of size). */
+    hasCheckpointIndex(runId: string): boolean;
+    /**
+     * Copy a Node's persisted state and artifact directory from a prior Run into
+     * a Forked Run, used when applying a fork plan. Replaces any existing entry
+     * and copies the artifact directory recursively. The caller is responsible
+     * for also calling appendCheckpoint to register the inherited Node.
+     */
+    inheritNodeFromRun(targetRunId: string, sourceRunId: string, nodeKey: string): void;
     cleanTerminalRuns(options?: {
         dryRun?: boolean;
     }): RunCleanResult;
@@ -38,6 +62,7 @@ export declare class RunStore {
      */
     resolveArtifactPath(uri: string): string | undefined;
     private runDir;
+    private checkpointsIndexPath;
     /** Write JSON via temp file + atomic rename for crash safety. */
     private atomicWriteJson;
     /** Read and parse a JSON file. Returns undefined if missing or invalid. */

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAgB,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAiC7F,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,CAAC,EAAE,MAAM;IAM5B,iEAAiE;IACjE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ;IA+B7I,6CAA6C;IAC7C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAK1C,yCAAyC;IACzC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAO7D,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAKjD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAOhD,6CAA6C;IAC7C,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAM9D,iEAAiE;IACjE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAM7E,sCAAsC;IACtC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAanD,gCAAgC;IAChC,UAAU,IAAI,MAAM,EAAE;IAOtB,8CAA8C;IAC9C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAOpD,qCAAqC;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAK9B,iBAAiB,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,cAAc;IAuDrE,8BAA8B;IAC9B,UAAU,IAAI,MAAM;IAIpB;;;;OAIG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAwBpD,OAAO,CAAC,MAAM;IAId,iEAAiE;IACjE,OAAO,CAAC,eAAe;IAQvB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ;CAQjB"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAkB,kBAAkB,EAAE,aAAa,EAAgB,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAiC5H,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,CAAC,EAAE,MAAM;IAM5B,iEAAiE;IACjE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,YAAY,EAAE,UAAU,CAAA;KAAE,GAAG,QAAQ;IAkCxL,6CAA6C;IAC7C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAK1C,yCAAyC;IACzC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAO7D,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAKjD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAOhD,6CAA6C;IAC7C,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAc9D,iEAAiE;IACjE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAM7E,sCAAsC;IACtC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAanD,gCAAgC;IAChC,UAAU,IAAI,MAAM,EAAE;IAOtB,8CAA8C;IAC9C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAOpD,qCAAqC;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAO9B;;;;;;OAMG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,GAAG,IAAI;IAclF;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE;IAO/C,2EAA2E;IAC3E,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAK1C;;;;;OAKG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA+BnF,iBAAiB,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,cAAc;IAuDrE,8BAA8B;IAC9B,UAAU,IAAI,MAAM;IAIpB;;;;OAIG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMpD,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,oBAAoB;IAI5B,iEAAiE;IACjE,OAAO,CAAC,eAAe;IAQvB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ;CAQjB"}