@acpus/runtime 0.7.1 → 0.9.0-alpha.0

package/dist/scheduler/store-port.d.ts

@@ -0,0 +1,211 @@
+import type { JsonValue } from "@acpus/expression/ir";
+import { type Result } from "neverthrow";
+import type { SchedulerEvent } from "./events.js";
+import type { SchedulerProjection } from "./types.js";
+export type RunOwnerClaim = {
+    runId: string;
+    ownerId: string;
+    ownerEpoch: number;
+    leaseExpiresAt: string;
+};
+export type SchedulerSnapshot = {
+    runId: string;
+    version: number;
+    projection: SchedulerProjection;
+};
+export type SchedulerStoreError = {
+    type: "run-not-found";
+    runId: string;
+    message: string;
+} | {
+    type: "version-mismatch";
+    runId: string;
+    expectedVersion: number;
+    actualVersion: number;
+    message: string;
+} | {
+    type: "owner-epoch-inactive";
+    runId: string;
+    ownerEpoch: number;
+    message: string;
+} | {
+    type: "owner-epoch-still-active";
+    runId: string;
+    ownerEpoch: number;
+    message: string;
+} | {
+    type: "run-paused";
+    runId: string;
+    message: string;
+} | {
+    type: "terminal-attempt";
+    attemptId: string;
+    status: string;
+    message: string;
+} | {
+    type: "attempt-not-found";
+    attemptId: string;
+    message: string;
+} | {
+    type: "owner-epoch-stale";
+    runId: string;
+    attemptId: string;
+    ownerEpoch: number;
+    message: string;
+} | {
+    type: "signal-wait-not-found";
+    runId: string;
+    nodeKey: string;
+    message: string;
+} | {
+    type: "signal-wait-terminal";
+    runId: string;
+    nodeKey: string;
+    status: string;
+    message: string;
+} | {
+    type: "idempotency-conflict";
+    idempotencyKey: string;
+    runId?: string;
+    message: string;
+} | {
+    type: "missing-retry-target";
+    runId: string;
+    targetKey: string;
+    message: string;
+} | {
+    type: "invalid-retry-target";
+    runId: string;
+    targetKey?: string;
+    status: string;
+    message: string;
+} | {
+    type: "missing-cancel-target";
+    runId: string;
+    targetKey: string;
+    message: string;
+} | {
+    type: "invalid-cancel-target";
+    runId: string;
+    targetKey?: string;
+    status: string;
+    message: string;
+} | {
+    type: "invalid-control-state";
+    runId: string;
+    command: "resume";
+    status: string;
+    message: string;
+};
+export type SchedulerStoreResult<T> = Result<T, SchedulerStoreError>;
+export declare class SchedulerStoreException extends Error {
+    readonly failure: SchedulerStoreError;
+    constructor(failure: SchedulerStoreError);
+}
+export declare function schedulerStoreError(error: unknown): SchedulerStoreError | undefined;
+export declare function schedulerStoreResult<T>(fn: () => T): SchedulerStoreResult<T>;
+export declare function throwSchedulerStoreResult<T>(result: SchedulerStoreResult<T>): T;
+export type SchedulerCommit = {
+    runId: string;
+    expectedVersion: number;
+    ownerEpoch: number;
+    events: SchedulerEvent[];
+    idempotencyKey: string;
+};
+export type AttemptStartInput = {
+    runId: string;
+    nodeKey: string;
+    nodeId: string;
+    ownerEpoch: number;
+    deadlineAt?: string;
+    idempotencyKey: string;
+};
+export type AttemptCommitInput = {
+    runId: string;
+    attemptId: string;
+    ownerEpoch: number;
+    result: {
+        status: "completed";
+        output?: JsonValue;
+    } | {
+        status: "failed" | "timed_out";
+        reason: string;
+    } | {
+        status: "cancelled";
+        reason: "parent_failed" | "race_lost" | "quorum_reached" | "paused" | "superseded";
+    };
+    idempotencyKey: string;
+};
+export type SignalConsumeInput = {
+    runId: string;
+    nodeKey: string;
+    ownerEpoch: number;
+    payload: JsonValue;
+    commandIdempotencyKey: string;
+    idempotencyKey: string;
+    now?: Date;
+};
+export type SchedulerPauseInput = {
+    runId: string;
+    ownerEpoch: number;
+    reason?: string;
+    idempotencyKey: string;
+    now?: Date;
+};
+export type SchedulerResumeInput = {
+    runId: string;
+    ownerEpoch: number;
+    idempotencyKey: string;
+    now?: Date;
+};
+export type SchedulerRetryInput = {
+    runId: string;
+    ownerEpoch: number;
+    idempotencyKey: string;
+    targetKey: string;
+};
+export type SchedulerRunRetryInput = {
+    runId: string;
+    ownerEpoch: number;
+    idempotencyKey: string;
+};
+export type SchedulerCancelInput = {
+    runId: string;
+    ownerEpoch: number;
+    idempotencyKey: string;
+    targetKey?: string;
+};
+export type SchedulerStorePort = {
+    claimRun(runId: string, ownerId: string, leaseMs: number): RunOwnerClaim | undefined;
+    heartbeatRun(claim: RunOwnerClaim, leaseMs: number): boolean;
+    releaseRun(claim: RunOwnerClaim): boolean;
+    tryLoadRunSnapshot(runId: string): SchedulerStoreResult<SchedulerSnapshot>;
+    loadRunSnapshot(runId: string): SchedulerSnapshot;
+    tryAppendSchedulerEvents(commit: SchedulerCommit): SchedulerStoreResult<SchedulerSnapshot>;
+    appendSchedulerEvents(commit: SchedulerCommit): SchedulerSnapshot;
+    tryStartAttempt(input: AttemptStartInput): SchedulerStoreResult<{
+        attemptId: string;
+        attemptNo: number;
+    }>;
+    startAttempt(input: AttemptStartInput): {
+        attemptId: string;
+        attemptNo: number;
+    };
+    tryCommitAttemptResult(input: AttemptCommitInput): SchedulerStoreResult<SchedulerSnapshot>;
+    commitAttemptResult(input: AttemptCommitInput): SchedulerSnapshot;
+    tryConsumeSignal(input: SignalConsumeInput): SchedulerStoreResult<SchedulerSnapshot>;
+    consumeSignal(input: SignalConsumeInput): SchedulerSnapshot;
+    tryPauseRun(input: SchedulerPauseInput): SchedulerStoreResult<SchedulerSnapshot>;
+    pauseRun(input: SchedulerPauseInput): SchedulerSnapshot;
+    tryResumeRun(input: SchedulerResumeInput): SchedulerStoreResult<SchedulerSnapshot>;
+    resumeRun(input: SchedulerResumeInput): SchedulerSnapshot;
+    tryRetryRun(input: SchedulerRunRetryInput): SchedulerStoreResult<SchedulerSnapshot>;
+    retryRun(input: SchedulerRunRetryInput): SchedulerSnapshot;
+    tryRetry(input: SchedulerRetryInput): SchedulerStoreResult<SchedulerSnapshot>;
+    retry(input: SchedulerRetryInput): SchedulerSnapshot;
+    tryCancel(input: SchedulerCancelInput): SchedulerStoreResult<SchedulerSnapshot>;
+    cancel(input: SchedulerCancelInput): SchedulerSnapshot;
+    tryMarkExpiredOwnerAttemptsSuperseded(runId: string, ownerEpoch: number): SchedulerStoreResult<SchedulerSnapshot>;
+    markExpiredOwnerAttemptsSuperseded(runId: string, ownerEpoch: number): SchedulerSnapshot;
+};
+//# sourceMappingURL=store-port.d.ts.map

package/dist/scheduler/store-port.d.ts.map

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

package/dist/scheduler/store-port.js

@@ -0,0 +1,28 @@
+import { err, ok } from "neverthrow";
+export class SchedulerStoreException extends Error {
+    failure;
+    constructor(failure) {
+        super(failure.message);
+        this.failure = failure;
+    }
+}
+export function schedulerStoreError(error) {
+    return error instanceof SchedulerStoreException ? error.failure : undefined;
+}
+export function schedulerStoreResult(fn) {
+    try {
+        return ok(fn());
+    }
+    catch (error) {
+        const storeError = schedulerStoreError(error);
+        if (storeError)
+            return err(storeError);
+        throw error;
+    }
+}
+export function throwSchedulerStoreResult(result) {
+    return result.match(value => value, error => {
+        throw new SchedulerStoreException(error);
+    });
+}
+//# sourceMappingURL=store-port.js.map

package/dist/scheduler/store-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-port.js","sourceRoot":"","sources":["../../src/scheduler/store-port.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,YAAY,CAAC;AAqClD,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC3B;IAArB,YAAqB,OAA4B;QAC/C,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QADJ,YAAO,GAAP,OAAO,CAAqB;IAEjD,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,KAAK,YAAY,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,EAAW;IACjD,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,UAAU;YAAE,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAI,MAA+B;IAC1E,OAAO,MAAM,CAAC,KAAK,CACjB,KAAK,CAAC,EAAE,CAAC,KAAK,EACd,KAAK,CAAC,EAAE;QACN,MAAM,IAAI,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/scheduler/transitions.d.ts

@@ -0,0 +1,89 @@
+import type { JsonObject, JsonValue } from "@acpus/expression/ir";
+import { type SchedulerEvent } from "./events.js";
+import type { FailureClass, GroupMember, GroupProjection, RetryTargetStatus, SchedulerProjection } from "./types.js";
+export type GroupCompletion = {
+    status: "running";
+} | {
+    status: "completed";
+    acceptedMemberKeys: string[];
+    cancelRemaining: boolean;
+} | {
+    status: "failed";
+    reason: string;
+    cancelRemaining: boolean;
+};
+export type FanoutItemInput = {
+    runId: string;
+    groupKey: string;
+    items: readonly JsonValue[];
+    keyForItem?: (item: JsonValue, itemIndex: number) => string | number;
+    readinessSequenceStart: number;
+};
+export type LoopNextStep = {
+    action: "start_iteration";
+    iter: number;
+    previous?: JsonValue;
+} | {
+    action: "complete";
+    output: JsonValue;
+    terminalReason: "stopped" | "exhausted_return_last";
+} | {
+    action: "fail";
+    error: JsonObject;
+    terminalReason: "loop_exhausted";
+};
+export type TimestampedSchedulerEvent = {
+    event: SchedulerEvent;
+    createdAt: string;
+};
+export type SchedulerProjectionTiming = {
+    createdAt: string;
+    updatedAt: string;
+};
+export type SchedulerProjectionTimings = {
+    frame: Map<string, SchedulerProjectionTiming>;
+    instance: Map<string, SchedulerProjectionTiming>;
+    attempt: Map<string, SchedulerProjectionTiming>;
+    member: Map<string, SchedulerProjectionTiming>;
+    signal: Map<string, SchedulerProjectionTiming>;
+};
+export declare function signalTimeoutEvents(projection: SchedulerProjection, now: Date): SchedulerEvent[];
+export declare function attemptTimeoutEvents(projection: SchedulerProjection, now: Date): SchedulerEvent[];
+export declare function createSchedulerProjection(runId: string): SchedulerProjection;
+export declare function applySchedulerEvent(projection: SchedulerProjection, event: SchedulerEvent): SchedulerProjection;
+export declare function applySchedulerEvents(projection: SchedulerProjection, events: readonly SchedulerEvent[]): SchedulerProjection;
+export declare function applyTimestampedSchedulerEvents(runId: string, events: readonly TimestampedSchedulerEvent[]): {
+    projection: SchedulerProjection;
+    timings: SchedulerProjectionTimings;
+};
+export declare function evaluateGroupCompletion(group: GroupProjection, members: readonly GroupMember[]): GroupCompletion;
+export declare function groupCompletionEvents(projection: SchedulerProjection, groupKey: string): SchedulerEvent[];
+export declare function cancellationEventsForFrame(projection: SchedulerProjection, frameKey: string, cancelReason: "operator_cancelled"): SchedulerEvent[];
+export declare function cancellationEventsForNode(projection: SchedulerProjection, nodeKey: string, cancelReason: "operator_cancelled"): SchedulerEvent[];
+export declare function materializeFanoutItems(input: FanoutItemInput): Extract<SchedulerEvent, {
+    type: "group.member_ready";
+}>[];
+export declare function nextLoopStep(input: {
+    iter: number;
+    maxIterations: number;
+    stop: boolean;
+    result?: JsonValue;
+    previous?: JsonValue;
+    onExhausted?: "fail" | "returnLast";
+}): LoopNextStep;
+export declare function resolveScopedNodeKey(scopes: readonly Record<string, string>[], nodeId: string): string;
+export declare function retryTargetClass(status: RetryTargetStatus, failureClass?: FailureClass): "retryable" | "not_retryable";
+export declare function loopExhaustionResult(input: {
+    onExhausted?: "fail" | "returnLast";
+    lastResult?: JsonValue;
+    maxIterations: number;
+}): {
+    status: "completed";
+    output: JsonValue;
+    terminalReason: "exhausted_return_last";
+} | {
+    status: "failed";
+    error: JsonObject;
+    terminalReason: "loop_exhausted";
+};
+//# sourceMappingURL=transitions.d.ts.map

package/dist/scheduler/transitions.d.ts.map

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