@acpus/runtime 0.1.0 → 0.2.0

package/dist/index.js

@@ -1,13 +1,14 @@
 // ─── Keys ────────────────────────────────────────────────────────
-export { resolveNodeKey, encodeNodeKeyForFs, encodeNodeKeyForDir } from "./keys.js";
+export { resolveNodeKey, parseNodeKey, staticNodePathFromKey, isNodeKeyAtOrBelow, isNodeKeyInDynamicScope, isNodeKeyBelowAnyAnchor, withNodeKeyPrefix, encodeNodeKeyForFs, encodeNodeKeyForDir } from "./keys.js";
 // ─── Evaluator ───────────────────────────────────────────────────
 export { ExpressionEvaluator } from "./evaluator.js";
+export { buildCompletedStepContext, evaluateWorkflowOutputs, evaluateOutputObject, evaluateTemplatedValue } from "./workflow-outputs.js";
 // ─── Store ───────────────────────────────────────────────────────
 export { RunStore } from "./store.js";
 // ─── State Machine ───────────────────────────────────────────────
 export { canTransition, transition, isTerminal, createInitialNodeState, resetFailedForRetry, resetRunningForCrashRecovery, resetAwaitingForCrashRecovery } from "./state-machine.js";
 // ─── Artifacts ───────────────────────────────────────────────────
-export { ArtifactStore } from "./artifacts.js";
+export { ArtifactStore, ArtifactReferences } from "./artifacts.js";
 // ─── Interpreter ─────────────────────────────────────────────────
 export { WorkflowInterpreter } from "./interpreter.js";
 // ─── Input Validation ────────────────────────────────────────────
@@ -21,5 +22,7 @@ export { createSupervisorApp } from "./supervisor-app.js";
 export { startRunSupervisor } from "./supervisor-runner.js";
 export { ensureWorkspaceSupervisor } from "./supervisor-discovery.js";
 // ─── Client ──────────────────────────────────────────────────────
-export { RunSupervisorClient } from "./client.js";
+export { RunSupervisorClient, ForkRejectedError } from "./client.js";
+// ─── Fork ────────────────────────────────────────────────────────
+export { planFork, applyFork, materializeFork, ForkError } from "./fork.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,oEAAoE;AACpE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEpF,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,oEAAoE;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAErL,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,oEAAoE;AACpE,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG5E,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoCA,oEAAoE;AACpE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAGnB,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEzI,oEAAoE;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAErL,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGnE,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,oEAAoE;AACpE,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG5E,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,oEAAoE;AACpE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErE,oEAAoE;AACpE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/interpreter.d.ts

@@ -13,22 +13,16 @@ export declare class WorkflowInterpreter {
     private readonly agentExecutor;
     private readonly programExecutor;
     private readonly artifactStore;
+    private readonly attemptArtifacts;
+    private readonly runControl;
     private readonly maxConcurrency;
     private readonly allowedSourceRoots;
     private readonly sleep;
-    /** 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;
     /** Pending human-decision resolvers for Approval Gates awaiting a signal,
      *  keyed by "runId:nodeKey". An entry exists only while a node is `awaiting`. */
     private readonly approvalResolvers;
     /** Absolute paths of subworkflow specs currently on the execution stack (cycle guard). */
     private readonly subworkflowStack;
-    /** Scheduling guards for Run-level pause/cancel, keyed by runId.
-     *  Per-runId to prevent leakage across runs sharing the same interpreter. */
-    private readonly schedulingPaused;
-    private readonly schedulingCancelled;
     constructor(store: RunStore, agentExecutor: ExecutorAdapter, programExecutor: ExecutorAdapter, options?: InterpreterOptions);
     /**
      * Start a new workflow run to completion (init + execute). Convenience for
@@ -74,18 +68,6 @@ export declare class WorkflowInterpreter {
      * actually recorded (racy joins do not run every branch).
      */
     private replayNode;
-    /** Pause one running node as part of a Run-level pause operation. */
-    private pauseRunningNode;
-    /** Cancel one materialized node as part of Run-level cancel or fail-fast. */
-    private cancelMaterializedNode;
-    /** Resolve the operator intent for an in-flight abort; defaults to paused. */
-    private abortIntent;
-    /** True if the node has been persisted as terminal `cancelled` (e.g. by
-     * fail-fast). Used to avoid clobbering it when a still-running leaf later
-     * resolves/rejects. */
-    private readAbortedStateOnDisk;
-    private isStaleAttemptOnDisk;
-    private syncInFrameAttemptFromDisk;
     /**
      * Retry a failed executable Node. This is a local repair operation for the
      * target executable only; Run-level retry remains the operation that restores
@@ -118,35 +100,10 @@ export declare class WorkflowInterpreter {
     private executePipeline;
     private executeAgent;
     private executeProgram;
-    /** Write stdout.log/stderr.log artifacts; returns their URIs. */
-    private writeProgramArtifacts;
-    /** Write per-attempt agent response/protocol artifacts; returns their URIs. */
-    private writeAgentArtifacts;
-    /** Pre-create live Agent attempt artifacts and return their refs immediately. */
-    private startAgentAttemptArtifacts;
-    private appendAgentTranscript;
     private publishRunningAgentAttempt;
-    private agentAttemptPrefix;
+    private publishAgentTelemetry;
+    private syncAgentTelemetryFromDisk;
     private executeParallel;
-    /**
-     * Cancel still-running/pending/awaiting descendant nodes of a failed
-     * composite (parallel or fanout), scoped to the given dynamic context. A
-     * descendant must (a) be one of the composite's descendant IR node ids and
-     * (b) share every dynamic dimension (item/lane/round) the composite already
-     * carries — so concurrent sibling fanout lanes outside this scope are not
-     * affected.
-     *
-     * NOTE: pass the composite's OWN dynamic. For a parallel this scopes to the
-     * current lane (item/lane present). For a fanout, the dynamic does NOT yet
-     * carry this fanout's lane (lanes are introduced for its children), so the
-     * scope spans ALL of the fanout's lanes — exactly the fail-fast intent.
-     */
-    private descendantsInScope;
-    /**
-     * Cancel still-running/pending descendant nodes of a failed composite
-     * (parallel `join: all`, or fanout `join: all` fail-fast).
-     */
-    private cancelDescendantsInScope;
     private executeFanout;
     /**
      * Resolve fanout lanes per the wait strategy. Lanes never reject on normal
@@ -154,6 +111,7 @@ export declare class WorkflowInterpreter {
      * let propagate. Losing/excess lanes are silently consumed.
      */
     private waitForFanout;
+    private materializePendingNode;
     private executeSwitch;
     private executeLoop;
     private executeGuard;
@@ -167,8 +125,6 @@ export declare class WorkflowInterpreter {
     submitApproval(runId: string, nodeKey: string, approved: boolean): void;
     private executeSubworkflow;
     private assertAllowedSourcePath;
-    /** Evaluate a subworkflow input value, preserving native type for single expressions. */
-    private evaluateInputValue;
     private buildContext;
     private populateStepOutputs;
     /** Extract the parent dynamic value-context (fanout item / loop round) from a context, if any. */

package/dist/interpreter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpreter.d.ts","sourceRoot":"","sources":["../src/interpreter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA2B,MAAM,aAAa,CAAC;AAIpE,OAAO,KAAK,EAAqB,kBAAkB,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAC;AACpG,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAiC,YAAY,EAAkB,MAAM,YAAY,CAAC;AAoD9F;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAW;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAEtD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2C;IAE5E,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkD;IAE/E;qFACiF;IACjF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuD;IAEzF,0FAA0F;IAC1F,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAE3D;iFAC6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8B;IAC/D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA8B;gBAGhE,KAAK,EAAE,QAAQ,EACf,aAAa,EAAE,eAAe,EAC9B,eAAe,EAAE,eAAe,EAChC,OAAO,CAAC,EAAE,kBAAkB;IAY9B;;;OAGG;IACG,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,YAAY,EAAE,QAAQ,CAAC;IAKlF;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,YAAY,EAAE,QAAQ;IASrE;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,YAAY,EAAE,QAAQ,CAAC;IA2B3G;;;;;;;OAOG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAYtC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IA+CnC;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAkGlB,qEAAqE;IACrE,OAAO,CAAC,gBAAgB;IAexB,6EAA6E;IAC7E,OAAO,CAAC,sBAAsB;IAc9B,8EAA8E;IAC9E,OAAO,CAAC,WAAW;IAInB;;2BAEuB;IACvB,OAAO,CAAC,sBAAsB;IAK9B,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,0BAA0B;IAOlC;;;;OAIG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsD9D;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAqB7B;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmD9B;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B7C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;YAiCf,WAAW;YAwMX,eAAe;YAcf,YAAY;YA8FZ,cAAc;IAqB5B,iEAAiE;IACjE,OAAO,CAAC,qBAAqB;IAM7B,+EAA+E;IAC/E,OAAO,CAAC,mBAAmB;IAyB3B,iFAAiF;IACjF,OAAO,CAAC,0BAA0B;IAOlC,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,0BAA0B;IAQlC,OAAO,CAAC,kBAAkB;YAIZ,eAAe;IAkE7B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;YAIlB,aAAa;IAoF3B;;;;OAIG;YACW,aAAa;YA6Bb,aAAa;YAoCb,WAAW;IAkCzB,OAAO,CAAC,YAAY;YAuBN,eAAe;IA4D7B;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;YAQzD,kBAAkB;IAqDhC,OAAO,CAAC,uBAAuB;IAM/B,yFAAyF;IACzF,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,mBAAmB;IAQ3B,kGAAkG;IAClG,OAAO,CAAC,qBAAqB;IAU7B,gGAAgG;IAChG,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,aAAa;IAUrB,yGAAyG;IACzG,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,aAAa;CAOtB;AA0BD,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,GAAG,OAAa,GAAG,MAAM,CAWtD"}
+{"version":3,"file":"interpreter.d.ts","sourceRoot":"","sources":["../src/interpreter.ts"],"names":[],"mappings":"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"}