@atom-workflow-agent/workflow-engine 0.1.0

package/dist/runtime/durable-workflow-engine.d.ts

@@ -0,0 +1,78 @@
+import { type HostTaskResumeRequest, type JsonValue, type RuntimeEvent, type WorkflowIR, type WorkflowRevision } from "@atom-workflow-agent/contracts";
+import { type AtomAttemptRunner } from "@atom-workflow-agent/atom-executor";
+import type { WorkflowArtifactStore, WorkflowAtomResolver, WorkflowRunStore } from "../ports/runtime-ports.js";
+import { type RuntimeSnapshot } from "../store/runtime-snapshot.js";
+export interface DurableWorkflowEngineOptions {
+    readonly store: WorkflowRunStore;
+    readonly artifacts: WorkflowArtifactStore;
+    readonly atoms: WorkflowAtomResolver;
+    /** Shared Atom execution boundary. Applications use the process-backed implementation; tests may inject in-process execution. */
+    readonly atomAttemptRunner?: AtomAttemptRunner;
+    readonly cacheDirectory: string;
+    /** Omit or set null for no active-run wall-clock timer. */
+    readonly runTimeoutMs?: number | null;
+    /** Optional Runtime-wide node cap; null leaves the node/Atom policy in control. */
+    readonly nodeTimeoutMs?: number | null;
+    readonly now?: () => Date;
+    /** Observability hook. Failures in consumers never affect durable execution. */
+    readonly onEvent?: (event: RuntimeEvent) => void;
+}
+export interface CreateWorkflowRunInput {
+    readonly runId: string;
+    readonly goal: string;
+    readonly cwd: string;
+    readonly projectScope?: string;
+    readonly hostScope?: string;
+    readonly planId?: string;
+    readonly revision: WorkflowRevision;
+    readonly ir: WorkflowIR;
+    readonly inputs: Readonly<Record<string, JsonValue>>;
+}
+/** Durable scheduler and executor for one frozen WorkflowIR revision. */
+export declare class DurableWorkflowEngine {
+    private readonly options;
+    private readonly cache;
+    private readonly controllers;
+    private readonly resumeProcessing;
+    private readonly now;
+    private readonly atomAttemptRunner;
+    constructor(options: DurableWorkflowEngineOptions);
+    createRun(input: CreateWorkflowRunInput): Promise<RuntimeSnapshot>;
+    execute(runId: string): Promise<RuntimeSnapshot>;
+    signal(runId: string, signalId: string, response: JsonValue): Promise<RuntimeSnapshot>;
+    resumeHost(runId: string, raw: HostTaskResumeRequest): Promise<RuntimeSnapshot>;
+    cancel(runId: string): Promise<RuntimeSnapshot>;
+    retry(runId: string, activationId: string): Promise<RuntimeSnapshot>;
+    resume(runId: string): Promise<RuntimeSnapshot>;
+    recover(autoResume?: boolean): Promise<readonly RuntimeSnapshot[]>;
+    /** Applies one already accepted continuation. The persisted payload is the sole retry source. */
+    private processResumeDelivery;
+    private processResumeDeliveryExclusive;
+    private executeNode;
+    private executeSwitch;
+    private executeMap;
+    private commitControlCompletion;
+    private runNewAttempt;
+    private resumeAttempt;
+    private context;
+    private lifecycleOptions;
+    private resources;
+    private tickTimeout;
+    private persistTick;
+    private persistLifecycle;
+    private commitCompletion;
+    private advance;
+    private routeEdge;
+    private returnFromMap;
+    private scheduleMapItems;
+    private mapOutput;
+    private finishMap;
+    private resolveEdgeValue;
+    private activate;
+    private flushReadyJoinsSync;
+    private flushReadyJoins;
+    private workflowOutputs;
+    private hostManager;
+    private event;
+}
+//# sourceMappingURL=durable-workflow-engine.d.ts.map

package/dist/runtime/durable-workflow-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-workflow-engine.d.ts","sourceRoot":"","sources":["../../src/runtime/durable-workflow-engine.ts"],"names":[],"mappings":"AACA,OAAO,EASL,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EAGd,KAAK,YAAY,EAIjB,KAAK,UAAU,EAKf,KAAK,gBAAgB,EACtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAGL,KAAK,iBAAiB,EAOvB,MAAM,oCAAoC,CAAC;AAmB5C,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAgE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIlI,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,iIAAiI;IACjI,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,mFAAmF;IACnF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACtD;AAgKD,yEAAyE;AACzE,qBAAa,qBAAqB;IAOpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+C;IAChF,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;gBAEzB,OAAO,EAAE,4BAA4B;IAM5D,SAAS,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IA+ClE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAmEhD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC;IAgEtF,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IA4C/E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAsB/C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAcpE,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAiB/C,OAAO,CAAC,UAAU,UAAO,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IA6GrE,iGAAiG;IACjG,OAAO,CAAC,qBAAqB;YAUf,8BAA8B;YAgK9B,WAAW;YAkIX,aAAa;YAgBb,UAAU;YAiDV,uBAAuB;YAoBvB,aAAa;YAkEb,aAAa;YAmEb,OAAO;IAoCrB,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,SAAS;YA4BH,WAAW;YAUX,WAAW;YAoBX,gBAAgB;YAqEhB,gBAAgB;IAqB9B,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,SAAS;IAgEjB,OAAO,CAAC,aAAa;IA6CrB,OAAO,CAAC,gBAAgB;IA6BxB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,SAAS;IA+BjB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,QAAQ;IA8ChB,OAAO,CAAC,mBAAmB;YAmCb,eAAe;IAO7B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,KAAK;CAyBd"}