@acpus/runtime 0.8.0 → 0.9.0-alpha.0

package/dist/run-control.d.ts

@@ -1,45 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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;IAElE,YAA6B,KAAK,EAAE,QAAQ,EAAI;IAEhD,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI,CAEzF;IAED,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGtD;IAED,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGzC;IAED,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAUrC;IAED,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CA0BrE;IAED,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAIhE;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAkB5B;IAED,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAsC7B;IAED,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAoB7B;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CA+B5B;IAED,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,SAAS,CAU/F;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAEhE;IAED,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAGvF;IAED,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG5G;IAED,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAK1F;IAED,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAEjE;IAED,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,kBAAkB;CAW3B"}

package/dist/run-control.js

@@ -1,255 +0,0 @@
-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.writeTerminalNodeState(runId, nodeState);
-            }
-        }
-        for (const nodeState of this.store.listNodeStates(runId)) {
-            if (nodeState.state === "pending") {
-                nodeState.state = cancelPendingForRunCancel(nodeState.state);
-                this.store.writeTerminalNodeState(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.writeTerminalNodeState(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.writeTerminalNodeState(runId, state);
-        }
-        else if (state && canTransition(state.state, "cancelled")) {
-            state.state = transition(state.state, "cancelled");
-            this.store.writeTerminalNodeState(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.renderedPrompt = undefined;
-        state.renderedSessionKey = undefined;
-        state.agentTelemetry = undefined;
-    }
-}
-//# sourceMappingURL=run-control.js.map

package/dist/run-control.js.map

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

package/dist/run-id.d.ts

@@ -1,3 +0,0 @@
-export declare function isUnsafeRunId(runId: string): boolean;
-export declare function validateRunId(runId: string): void;
-//# sourceMappingURL=run-id.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"run-id.d.ts","sourceRoot":"","sources":["../src/run-id.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjD"}

package/dist/run-id.js

@@ -1,10 +0,0 @@
-const UNSAFE_RUN_ID = /(^|\/)\.\.?(\/|$)|[\\:\0]/;
-export function isUnsafeRunId(runId) {
-    return !runId || runId.includes("/") || UNSAFE_RUN_ID.test(runId);
-}
-export function validateRunId(runId) {
-    if (isUnsafeRunId(runId)) {
-        throw new Error(`Invalid runId: '${runId}' contains unsafe path characters`);
-    }
-}
-//# sourceMappingURL=run-id.js.map

package/dist/run-id.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-id.js","sourceRoot":"","sources":["../src/run-id.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAElD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,mCAAmC,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC"}

package/dist/state-machine.d.ts

@@ -1,31 +0,0 @@
-import type { IrNodeKind } from "@acpus/core";
-import type { NodeExecutionState, NodeState } from "./types.js";
-/** Check if a transition from `from` to `to` is legal. */
-export declare function canTransition(from: NodeState, to: NodeState): boolean;
-/**
- * Transition a node state. Throws if the transition is illegal.
- * Returns the new state.
- */
-export declare function transition(from: NodeState, to: NodeState): NodeState;
-/** Check if a state is terminal (no further business-lifecycle transitions). */
-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). */
-export declare function resetRunningForCrashRecovery(from: NodeState): NodeState;
-/**
- * Control-plane reset: crash recovery of a stale awaiting node (awaiting → pending).
- * The in-memory signal resolver does not survive a supervisor restart, so a node
- * left in `awaiting` must be re-executed from scratch to re-register its resolver and
- * wait for a fresh external 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, definitionHash?: string): NodeExecutionState;
-//# sourceMappingURL=state-machine.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,102 +0,0 @@
-// ─── Legal transitions ───────────────────────────────────────────
-//
-// This table models only the *business lifecycle* of a Node. Control-plane
-// resets (operator retry, crash recovery) are NOT transitions here — they are
-// reset operations exposed via dedicated helpers below, so that no generic
-// `canTransition(x, "pending")` call can accidentally gain retry/reset rights.
-const TRANSITIONS = {
-    pending: new Set(["running"]),
-    running: new Set(["awaiting", "completed", "failed", "paused", "cancelled"]),
-    // `awaiting` is an external-decision wait (e.g. a Signal Node blocked on an
-    // operator/system signal). It is distinct from `paused` (an operator-initiated
-    // pause): a signal resolves it to `completed`, a cancel to `cancelled`.
-    awaiting: new Set(["completed", "cancelled"]),
-    // A paused Node is resumed by a Run-level control-plane reset back to
-    // `pending`, not by a direct lifecycle transition to `running`.
-    paused: new Set(["cancelled"]),
-    completed: new Set(),
-    failed: new Set(),
-    cancelled: new Set()
-};
-/** Check if a transition from `from` to `to` is legal. */
-export function canTransition(from, to) {
-    return TRANSITIONS[from].has(to);
-}
-/**
- * Transition a node state. Throws if the transition is illegal.
- * Returns the new state.
- */
-export function transition(from, to) {
-    if (!canTransition(from, to)) {
-        throw new Error(`Illegal state transition: ${from} → ${to}`);
-    }
-    return to;
-}
-/** Check if a state is terminal (no further business-lifecycle transitions). */
-export function isTerminal(state) {
-    return TRANSITIONS[state].size === 0;
-}
-// ─── Control-plane resets ────────────────────────────────────────
-//
-// These are NOT business-lifecycle transitions. They are explicit reset
-// operations invoked only from dedicated control entry points, so the
-// generic state machine never exposes a path back to `pending`.
-/** Control-plane reset: operator retry of a failed node (failed → pending). */
-export function resetFailedForRetry(from) {
-    if (from !== "failed") {
-        throw new Error(`Cannot retry node in state '${from}': only failed nodes are retryable`);
-    }
-    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") {
-        throw new Error(`Cannot reset node in state '${from}': only paused nodes can be reset`);
-    }
-    return "pending";
-}
-/** Control-plane reset: crash recovery of a stale running node (running → pending). */
-export function resetRunningForCrashRecovery(from) {
-    if (from !== "running") {
-        throw new Error(`Cannot recover stale node in state '${from}': only running nodes can be reset`);
-    }
-    return "pending";
-}
-/**
- * Control-plane reset: crash recovery of a stale awaiting node (awaiting → pending).
- * The in-memory signal resolver does not survive a supervisor restart, so a node
- * left in `awaiting` must be re-executed from scratch to re-register its resolver and
- * wait for a fresh external decision.
- */
-export function resetAwaitingForCrashRecovery(from) {
-    if (from !== "awaiting") {
-        throw new Error(`Cannot recover stale node in state '${from}': only awaiting nodes can be reset`);
-    }
-    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, definitionHash) {
-    return {
-        nodeKey,
-        nodeId,
-        kind,
-        definitionHash,
-        state: "pending",
-        attempt: 0
-    };
-}
-//# sourceMappingURL=state-machine.js.map

package/dist/state-machine.js.map

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

package/dist/store.d.ts

@@ -1,92 +0,0 @@
-import type { AcpusIr, AgentOverrideWarning, AgentOverrides, HookConfigSnapshot } from "@acpus/core";
-import type { NodeExecutionState, RunCheckpoint, RunCleanResult, RunState } from "./types.js";
-export declare class RunStore {
-    private readonly baseDir;
-    private readonly indexedRunIds;
-    constructor(baseDir?: string);
-    /** Create a new run directory and write IR + input snapshots. */
-    initRun(runId: string, ir: AcpusIr, input: Record<string, unknown>, source?: {
-        workflowRef?: string;
-        workflowSourcePath?: string;
-        lineage?: import("./types.js").RunLineage;
-        agentOverrides?: AgentOverrides;
-        submissionWarnings?: AgentOverrideWarning[];
-        skipHooks?: boolean;
-    }): RunState;
-    /** Read the frozen IR snapshot for a run. */
-    readIr(runId: string): AcpusIr | undefined;
-    /** Read the resolved input for a run. */
-    readInput(runId: string): Record<string, unknown> | undefined;
-    /** Write the frozen merged hook configuration snapshot (once, on first run). */
-    writeHookConfig(runId: string, snapshot: HookConfigSnapshot): void;
-    /** Read the frozen hook configuration snapshot. Undefined when no hooks apply. */
-    readHookConfig(runId: string): HookConfigSnapshot | undefined;
-    /** True when this Run has a frozen hook configuration on disk. */
-    hasHookConfig(runId: string): boolean;
-    writeRunMeta(runId: string, meta: RunState): void;
-    readRunMeta(runId: string): RunState | undefined;
-    /** Atomically write node execution state without recording a Run Checkpoint. */
-    writeNodeState(runId: string, state: NodeExecutionState): void;
-    /** Atomically write a terminal node state and record its Run Checkpoint when checkpointable. */
-    writeTerminalNodeState(runId: string, state: NodeExecutionState): void;
-    /** Read node execution state. Returns undefined if not found. */
-    readNodeState(runId: string, nodeKey: string): NodeExecutionState | undefined;
-    /** List all node states for a run. */
-    listNodeStates(runId: string): NodeExecutionState[];
-    /** List all run IDs on disk. */
-    listRunIds(): string[];
-    /** Get the artifacts directory for a node. */
-    artifactsDir(runId: string, nodeKey: string): string;
-    /** Check if a run exists on disk. */
-    hasRun(runId: string): boolean;
-    /**
-     * 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.
-     */
-    inheritNodeFromRun(targetRunId: string, sourceRunId: string, nodeKey: string): void;
-    cleanTerminalRuns(options?: {
-        dryRun?: boolean;
-    }): RunCleanResult;
-    /** Get the base directory. */
-    getBaseDir(): string;
-    /**
-     * Resolve an `artifact://runs/<runId>/nodes/<encodedNodeKey>/<filename>` URI to its
-     * absolute filesystem path. Pure (no mkdir). Returns undefined for malformed
-     * URIs. Mirrors ArtifactStore's layout: <baseDir>/<runId>/artifacts/<storageKey>/<filename>.
-     */
-    resolveArtifactPath(uri: string): string | undefined;
-    private runDir;
-    private checkpointsIndexPath;
-    private hookConfigPath;
-    private nodeIndexPath;
-    private nodeStateFilename;
-    private nodeArtifactDir;
-    private upsertNodeIndex;
-    private readNodeIndex;
-    private rebuildNodeIndexEntries;
-    private nodeIndexEntry;
-    /**
-     * Record 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.
-     */
-    private recordNodeCheckpoint;
-    /** Write JSON via temp file + atomic rename for crash safety. */
-    private atomicWriteJson;
-    /** Write text via temp file + atomic rename for crash safety. */
-    private atomicWriteText;
-    /** Read and parse a JSON file. Returns undefined if missing or invalid. */
-    private readJson;
-}
-//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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