@yieldstar/core 0.4.6 → 0.6.0

package/dist/lib/effect-state.d.ts

@@ -0,0 +1,78 @@
+import { EffectClientInvariantError, type EffectBeginRequest, type EffectBeginResult, type EffectRecord, type EffectSettleRequest, type EffectSettleResult, type EffectWatchRequest } from "../base/effect";
+/**
+ * An effect as runtime adapters store it. `input`, `result` and the values of
+ * each conflict report are canonical `durableValueCodec` encodings, so equal
+ * values compare as equal strings.
+ */
+export type EffectState = {
+    effectId: string;
+    operation: string;
+    input: string;
+    status: "pending" | "settled";
+    result?: string;
+    conflicts: EffectConflictState[];
+};
+export type EffectConflictState = {
+    result: string;
+    conflictingResult: string;
+    reportedAt: number;
+};
+export type PreparedEffectBegin = {
+    effectId: string;
+    operation: string;
+    /** The canonical input. */
+    input: string;
+    executionId: string;
+    stepKey: string;
+};
+export type PreparedEffectSettle = {
+    effectId: string;
+    operation: string;
+    /** The canonical result. */
+    result: string;
+};
+/**
+ * Checks the values `step.effect` passes to `begin`, and returns a message
+ * naming the first invalid one. The driver rejects these requests with
+ * `INVALID_EFFECT_REQUEST` before calling the client.
+ */
+export declare function validateEffectRequest(request: {
+    effectId: unknown;
+    operation: unknown;
+    input: unknown;
+}): {
+    ok: true;
+    input: string;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Validates a `begin` request and encodes its input canonically. Adapters call
+ * this before touching storage; it throws `EffectClientInvariantError` for a
+ * request the driver should have rejected.
+ */
+export declare function prepareEffectBegin(request: EffectBeginRequest): PreparedEffectBegin;
+/** Validates a `settle` request and encodes its result canonically. */
+export declare function prepareEffectSettle(request: EffectSettleRequest): PreparedEffectSettle;
+/** Validates a `watch` request. */
+export declare function prepareEffectWatch(request: EffectWatchRequest): EffectWatchRequest;
+/** The pending effect a `begin` that finds no effect creates. */
+export declare function createEffectState(begin: PreparedEffectBegin): EffectState;
+/** Answers a `begin` for an effect that already exists. */
+export declare function matchEffectBegin(state: EffectState, begin: PreparedEffectBegin): EffectBeginResult;
+/**
+ * Applies a settlement. `wake` is true only when this settlement moved the
+ * effect from pending to settled: adapters then wake every waiter in the same
+ * write. `state` is the input object when nothing changed. Throws
+ * `EffectClientInvariantError` when the operation differs from the effect's,
+ * which `begin` would have rejected.
+ */
+export declare function settleEffect(state: EffectState, settle: PreparedEffectSettle, now: number): {
+    state: EffectState;
+    result: EffectSettleResult;
+    wake: boolean;
+};
+export declare function toEffectRecord(state: EffectState): EffectRecord;
+export declare function effectNotFound(effectId: string): EffectClientInvariantError;
+//# sourceMappingURL=effect-state.d.ts.map

package/dist/lib/effect-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-state.d.ts","sourceRoot":"","sources":["../../src/lib/effect-state.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAe/D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,mBAAmB,CAWnF;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB,CAgBtF;AAED,mCAAmC;AACnC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAUlF;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,WAAW,CAQzE;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,mBAAmB,GACzB,iBAAiB,CAMnB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,oBAAoB,EAC5B,GAAG,EAAE,MAAM,GACV;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAoCnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAc/D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,0BAA0B,CAE3E"}

package/dist/lib/execution-dispatcher.d.ts

@@ -0,0 +1,102 @@
+import type { Logger } from "pino";
+import type { WorkflowInvoker } from "../base/invoker";
+import type { Runtime } from "../base/runtime";
+export declare const DEFAULT_DISPATCHER_CONCURRENCY = 10;
+export declare const DEFAULT_ABORT_GRACE_PERIOD = 1000;
+export interface DispatcherOptions {
+    invoker: WorkflowInvoker;
+    logger: Logger;
+    /** The maximum number of deliveries this dispatcher runs at once. @default 10 */
+    concurrency?: number;
+    /** Milliseconds between claims when nothing is due. @default 10 */
+    pollInterval?: number;
+    /** Whether the dispatcher's timers keep the process alive. @default true */
+    keepAlive?: boolean;
+    /** How long each lease lasts unless renewed, in milliseconds. @default 30_000 */
+    leaseDuration?: number;
+    /**
+     * Milliseconds between renewals of a delivery's lease, measured on the
+     * process's timers. Must be shorter than `leaseDuration`.
+     * @default leaseDuration / 3
+     */
+    renewInterval?: number;
+    /**
+     * Milliseconds to keep waiting for a delivery after its lease is lost and
+     * its signal aborts. After that the dispatcher abandons the delivery and
+     * frees its slot, even if the invoker cannot stop a step function that is
+     * still running.
+     * @default 1_000
+     */
+    abortGracePeriod?: number;
+}
+/**
+ * The only component that delivers executions. It leases due executions, reads
+ * each event from its record, hands it to the invoker, and acknowledges the
+ * outcome under the delivery's lease.
+ *
+ * - Up to `concurrency` deliveries run at once. The dispatcher claims new
+ *   executions as slots free up, without waiting for earlier deliveries.
+ * - It renews each lease every `renewInterval` while the delivery runs. If a
+ *   renewal returns `lost`, another claim has taken over: the dispatcher stops
+ *   renewing, aborts the delivery's signal so it runs no more workflow code,
+ *   and neither acknowledges nor releases. If the delivery has not settled
+ *   `abortGracePeriod` after the abort, the dispatcher abandons it and frees
+ *   its slot. An abandoned delivery may keep running a step function, but its
+ *   signal and lease token stop every write it attempts.
+ * - A delivery that rejects is not acknowledged. If the worker exited before
+ *   replying, the lease is left to expire; any other rejection is a retry
+ *   reply, and the lease is released. Either way the wakes stay pending and the
+ *   execution is delivered again after the redelivery delay.
+ * - If reading the record, acknowledging or releasing throws, the lease is
+ *   left to expire rather than released.
+ */
+export declare class ExecutionDispatcher {
+    private runtime;
+    private invoker;
+    private logger;
+    private pollInterval;
+    private keepAlive;
+    private concurrency;
+    private leaseDuration;
+    private renewInterval;
+    private abortGracePeriod;
+    private running;
+    private looping;
+    private timer;
+    private inFlight;
+    /** Slots reserved by claims that have not returned yet. */
+    private claiming;
+    constructor(runtime: Runtime, options: DispatcherOptions);
+    start(): void;
+    /** Stops claiming and waits for in-flight deliveries to settle. */
+    stop(): Promise<void>;
+    get activeDeliveries(): number;
+    /**
+     * Leases due executions, up to the free delivery slots, and starts
+     * delivering them. Resolves with the number of deliveries claimed; it does
+     * not wait for them to finish.
+     */
+    tick(): Promise<number>;
+    /** Waits for every delivery started so far to settle. */
+    drain(): Promise<void>;
+    private schedule;
+    private loop;
+    private dispatch;
+    /**
+     * Settles with `delivery`, or with `ABANDONED` once `abortGracePeriod` has
+     * passed since `signal` aborted. An abandoned delivery's late outcome or
+     * rejection is logged and otherwise ignored, so it is never acknowledged or
+     * released and never surfaces as an unhandled rejection.
+     */
+    private abandonAfterAbort;
+    /**
+     * Renews `lease` every `renewInterval` until stopped. `signal` aborts, with
+     * a `LeaseLostError`, once a renewal returns `lost`. `stop` waits for any
+     * renewal in flight and resolves with the latest lease, or `undefined` once
+     * a renewal has returned `lost`.
+     */
+    private renew;
+    private warnLost;
+    private emit;
+}
+//# sourceMappingURL=execution-dispatcher.d.ts.map

package/dist/lib/execution-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-dispatcher.d.ts","sourceRoot":"","sources":["../../src/lib/execution-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAS/C,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAIhD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,QAAQ,CAA4B;IAC5C,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAK;gBAET,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB;IAwBxD,KAAK;IAML,mEAAmE;IAC7D,IAAI;IAOV,IAAI,gBAAgB,WAEnB;IAED;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAwB7B,yDAAyD;IACnD,KAAK;IAMX,OAAO,CAAC,QAAQ;YASF,IAAI;YAiBJ,QAAQ;IAiFtB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAiDzB;;;;;OAKG;IACH,OAAO,CAAC,KAAK;IAiDb,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,IAAI;CAOb"}

package/dist/lib/execution-state.d.ts

@@ -0,0 +1,248 @@
+import type { EventContext, EventParams } from "../base/event";
+import type { ExecutionAcknowledgeResult, ExecutionLease, ExecutionOutcome, ExecutionParent, ExecutionRecord, ExecutionReleaseResult, ExecutionRenewResult, ExecutionStartRequest, ExecutionStartResult, ExecutionStatus, WorkflowRunOutcome } from "../base/execution";
+/**
+ * Storage-neutral state of one execution record, with the event and outcome
+ * already encoded. Runtime adapters persist these fields however they like and
+ * apply the transitions below inside one atomic write, so every adapter keeps
+ * the same lease, wake and acknowledgement semantics.
+ *
+ * Lease transitions (claim, renew, release) do not change `updatedAt`.
+ */
+export type ExecutionState = {
+    executionId: string;
+    workflowId: string;
+    params: string;
+    context: string;
+    /**
+     * The status the execution rests in when it has no live lease. The record's
+     * `running` status is derived from the lease and the clock by
+     * `executionStatusAt`, so an expired lease reads as ended without a write.
+     */
+    status: Exclude<ExecutionStatus, "running">;
+    outcome: string | null;
+    admittedAt: number;
+    updatedAt: number;
+    /** The earliest of the wakes not covered by a lease. */
+    dueAt: number | null;
+    /**
+     * The wakes the current lease covers. They stay pending until that lease is
+     * acknowledged, so a lease that is released or expires leaves them due.
+     */
+    claimedDueAt: number | null;
+    /** The highest token issued for this execution (0 before the first claim). */
+    leaseToken: number;
+    /**
+     * Non-null while the lease with `leaseToken` is held, that is, claimed and
+     * not yet released or acknowledged. A held lease stays current after it
+     * expires, until a later claim issues a higher token.
+     */
+    leaseExpiresAt: number | null;
+    /**
+     * Consecutive leases that ended by release or by expiry and a later claim.
+     * It does not include a held lease that has expired;
+     * `unacknowledgedDeliveryCountAt` adds that one.
+     */
+    unacknowledgedDeliveryCount: number;
+    /**
+     * When a released execution may be claimed again. A held lease's delay is
+     * measured from `leaseExpiresAt` instead.
+     */
+    redeliverAt: number | null;
+    /** Set at admission by `start`, and never changed. */
+    parent: ExecutionParent | null;
+};
+export declare const DEFAULT_LEASE_DURATION = 30000;
+/** The redelivery delay after one unacknowledged delivery. */
+export declare const REDELIVERY_DELAY_BASE = 1000;
+export declare const REDELIVERY_DELAY_MAX = 300000;
+/**
+ * How long an execution waits after a delivery ends unacknowledged before it
+ * can be claimed again. Starts at `REDELIVERY_DELAY_BASE` and doubles with
+ * each consecutive unacknowledged delivery, up to `REDELIVERY_DELAY_MAX`.
+ */
+export declare function redeliveryDelay(unacknowledgedDeliveryCount: number): number;
+export declare class ExecutionEventEncodingError extends Error {
+    constructor(message: string);
+}
+/**
+ * Encodes `params` with the durable value codec and `context` as its entries,
+ * so that decoding returns exactly what was admitted. Context keys must be
+ * strings. Throws `ExecutionEventEncodingError` for any value the codec
+ * rejects.
+ */
+export declare function encodeExecutionEvent(event: {
+    params: EventParams;
+    context: EventContext | undefined;
+}): {
+    params: string;
+    context: string;
+};
+export declare function decodeExecutionEvent(encoded: {
+    params: string;
+    context: string;
+}): {
+    params: EventParams;
+    context: EventContext;
+};
+/**
+ * Encodes a terminal outcome. A completed result the codec rejects is recorded
+ * as a failed outcome with `WorkflowValueError` (`INVALID_STEP_VALUE`), and a
+ * failure that is not an error is recorded as `Error(String(value))`.
+ */
+export declare function encodeExecutionOutcome(outcome: ExecutionOutcome): string;
+export declare function decodeExecutionOutcome(encoded: string): ExecutionOutcome;
+export declare function createExecutionState(params: {
+    executionId: string;
+    workflowId: string;
+    encoded: {
+        params: string;
+        context: string;
+    };
+    now: number;
+    parent?: ExecutionParent;
+}): ExecutionState;
+/** The record's status at `now`: `running` while a lease is live. */
+export declare function executionStatusAt(state: ExecutionState, now: number): ExecutionStatus;
+/**
+ * Consecutive unacknowledged deliveries at `now`, counting a held lease that
+ * has expired as ended.
+ */
+export declare function unacknowledgedDeliveryCountAt(state: ExecutionState, now: number): number;
+export declare function toExecutionRecord(state: ExecutionState, now: number): ExecutionRecord;
+/**
+ * The earliest time `claimDue` may return this execution, or null when it has
+ * nothing pending. It depends only on the state, not on the clock, so
+ * adapters can persist and index it to find due executions.
+ */
+export declare function nextClaimAt(state: ExecutionState): number | null;
+export declare function isExecutionClaimable(state: ExecutionState, now: number): boolean;
+/**
+ * Whether `lease` is the execution's current lease: its token is the highest
+ * issued and the lease has not been released or acknowledged. Expiry alone
+ * does not end it. Adapters check this in the same atomic write as every
+ * fenced write.
+ */
+export declare function isLeaseCurrent(state: ExecutionState, lease: ExecutionLease): boolean;
+/** Returns null when the execution is terminal and the wake is ignored. */
+export declare function requestExecutionWake(state: ExecutionState, wakeAt: number, now: number): ExecutionState | null;
+/**
+ * Leases a claimable execution with the next token. Adapters check
+ * `isExecutionClaimable` first, in the same atomic write.
+ */
+export declare function claimExecution(state: ExecutionState, params: {
+    now: number;
+    duration: number;
+}): {
+    state: ExecutionState;
+    lease: ExecutionLease;
+};
+export declare function renewExecutionLease(state: ExecutionState, params: {
+    lease: ExecutionLease;
+    duration: number;
+    now: number;
+}): {
+    state: ExecutionState;
+    result: ExecutionRenewResult;
+};
+export declare function releaseExecutionLease(state: ExecutionState, params: {
+    lease: ExecutionLease;
+    now: number;
+}): {
+    state: ExecutionState;
+    result: ExecutionReleaseResult;
+};
+export declare function acknowledgeExecution(state: ExecutionState, params: {
+    lease: ExecutionLease;
+    outcome: WorkflowRunOutcome;
+    now: number;
+}): {
+    state: ExecutionState;
+    result: ExecutionAcknowledgeResult;
+};
+/**
+ * Validates an admission request and encodes its event. Adapters call this
+ * before their atomic insert, then reject with `EXECUTION_ID_CONFLICT` if the
+ * ID is already in use.
+ */
+export declare function prepareExecutionAdmission(request: {
+    executionId?: string;
+    workflowId: string;
+    params: EventParams;
+    context: EventContext;
+}): {
+    ok: true;
+    executionId: string;
+    encoded: {
+        params: string;
+        context: string;
+    };
+} | {
+    ok: false;
+    code: "INVALID_EXECUTION_EVENT";
+    message: string;
+};
+export declare function executionIdConflict(executionId: string): {
+    status: "rejected";
+    code: "EXECUTION_ID_CONFLICT";
+    message: string;
+};
+export declare function executionNotFound(executionId: string): {
+    status: "rejected";
+    code: "EXECUTION_NOT_FOUND";
+    message: string;
+};
+/**
+ * A recorded start request, keyed by `callerExecutionId` and `stepKey`.
+ * `executionId` is the target it admitted. Adapters keep it until the caller
+ * is pruned, including after the target is terminal.
+ */
+export type StartRequestState = {
+    callerExecutionId: string;
+    stepKey: string;
+    workflowId: string;
+    /** The canonical params, or null when the request had none. */
+    params: string | null;
+    executionId: string;
+};
+export type PreparedExecutionStart = {
+    callerExecutionId: string;
+    stepKey: string;
+    workflowId: string;
+    params: string | null;
+};
+/**
+ * Validates a start request and encodes its params canonically. Adapters call
+ * this before touching storage and return the rejection as is.
+ */
+export declare function prepareExecutionStart(request: ExecutionStartRequest): {
+    ok: true;
+    start: PreparedExecutionStart;
+} | {
+    ok: false;
+    result: Extract<ExecutionStartResult, {
+        status: "rejected";
+    }>;
+};
+/**
+ * Answers a repeated start request from its record: the first target's ID when
+ * the workflow ID and canonical params match, and `START_REQUEST_MISMATCH`
+ * otherwise. The target's status does not matter.
+ */
+export declare function matchStartRequest(recorded: StartRequestState, start: PreparedExecutionStart): ExecutionStartResult;
+/**
+ * Builds a new start's target state and start-request record. The target
+ * inherits the caller's encoded context and links to the caller as its parent.
+ * Adapters insert both in one atomic write, after finding no recorded request
+ * for the same ID. `executionId` defaults to a random UUID; if it is already in
+ * use, adapters must not reuse it.
+ */
+export declare function createStartedExecution(params: {
+    start: PreparedExecutionStart;
+    caller: ExecutionState;
+    now: number;
+    executionId?: string;
+}): {
+    target: ExecutionState;
+    startRequest: StartRequestState;
+};
+//# sourceMappingURL=execution-state.d.ts.map

package/dist/lib/execution-state.d.ts.map

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

package/dist/lib/execution-state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execution-state.test.d.ts.map

package/dist/lib/execution-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-state.test.d.ts","sourceRoot":"","sources":["../../src/lib/execution-state.test.ts"],"names":[],"mappings":""}

package/dist/lib/wait-for-outcome.d.ts

@@ -0,0 +1,15 @@
+import type { EventEmitter } from "node:events";
+import type { ExecutionClient, ExecutionOutcome } from "../base/execution";
+/**
+ * Resolves with an execution's outcome once its record is terminal, or with
+ * undefined if no record exists. The record is the source of truth, so this
+ * settles even if the process that ran the execution restarted. An optional
+ * `emitter` (the invoker's deprecated `workflowEndEmitter`) only nudges an
+ * early re-read.
+ */
+export declare function waitForExecutionOutcome(executions: Pick<ExecutionClient, "get">, executionId: string, options?: {
+    emitter?: EventEmitter;
+    pollInterval?: number;
+    signal?: AbortSignal;
+}): Promise<ExecutionOutcome | undefined>;
+//# sourceMappingURL=wait-for-outcome.d.ts.map

package/dist/lib/wait-for-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-outcome.d.ts","sourceRoot":"","sources":["../../src/lib/wait-for-outcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG3E;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,EACxC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,YAAY,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAChF,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAwBvC"}

package/dist/lib/workflow-runner.d.ts

@@ -1,16 +1,23 @@
 import type { Logger } from "pino";
-import type { WorkflowGenerator, HeapClient, SchedulerClient, EventProcessor } from "..";
+import type { WorkflowGenerator, WorkflowEvent, WorkflowRunOutcome } from "..";
+import type { Runtime } from "../base/runtime";
+import type { DeliveryOptions } from "../base/invoker";
 export declare class WorkflowRunner<Router extends Record<string, WorkflowGenerator<any, any, any>>> {
-    private heapClient;
-    private schedulerClient;
+    private runtime;
     private router;
-    constructor(params: {
-        heapClient: HeapClient;
-        schedulerClient: SchedulerClient;
+    private logger;
+    constructor(runtime: Runtime, options: {
         router: Router;
         logger: Logger;
     });
-    run: EventProcessor;
+    /**
+     * Runs one delivery under `options.lease` and resolves with its outcome.
+     * Rejects only with an infrastructure error, which must not be acknowledged
+     * as an outcome; a lost lease is one, and so is an aborted `options.signal`.
+     */
+    run: (event: WorkflowEvent, options: DeliveryOptions & {
+        logger?: Logger;
+    }) => Promise<WorkflowRunOutcome>;
     private runWorkflows;
 }
 //# sourceMappingURL=workflow-runner.d.ts.map

package/dist/lib/workflow-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-runner.d.ts","sourceRoot":"","sources":["../../src/lib/workflow-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,cAAc,EAGf,MAAM,IAAI,CAAC;AAIZ,qBAAa,cAAc,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE/D,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE;QAClB,UAAU,EAAE,UAAU,CAAC;QACvB,eAAe,EAAE,eAAe,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB;IAMD,GAAG,EAAE,cAAc,CA0BjB;YAEY,YAAY;CAiC3B"}
+{"version":3,"file":"workflow-runner.d.ts","sourceRoot":"","sources":["../../src/lib/workflow-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EAGb,kBAAkB,EACnB,MAAM,IAAI,CAAC;AAQZ,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,qBAAa,cAAc,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAE/D,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAMzE;;;;OAIG;IACH,GAAG,GACD,OAAO,aAAa,EACpB,SAAS,eAAe,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAC7C,OAAO,CAAC,kBAAkB,CAAC,CAsC5B;YAEY,YAAY;CAmD3B"}

package/dist/utils/map.d.ts

@@ -1,6 +1,6 @@
 export declare class ReadOnlyMap<K, V> implements ReadonlyMap<K, V> {
     private sourceMap;
-    constructor(sourceMap: Map<K, V>);
+    constructor(sourceMap: Map<K, V> | Record<any, any> | undefined);
     get(key: K): V | undefined;
     has(key: K): boolean;
     get size(): number;

package/dist/utils/map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/utils/map.ts"],"names":[],"mappings":"AAEA,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAIhC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAI1B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAI9B,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC;IAItB,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC;IAIxB,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EACtD,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI;IAIP,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAGzC;AAED,qBAAa,YAAY,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,MAAM,CAAS;IAEvB,MAAM,IAAI,IAAI;IAId,QAAQ,IAAI,OAAO;IAInB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQ3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAQvB,KAAK,IAAI,IAAI;CAOd"}
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/utils/map.ts"],"names":[],"mappings":"AAEA,qBAAa,WAAW,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS;IAU/D,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAI1B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAI9B,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC;IAItB,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC;IAIxB,OAAO,CACL,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,EACtD,OAAO,CAAC,EAAE,GAAG,GACZ,IAAI;IAIP,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAGzC;AAED,qBAAa,YAAY,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,MAAM,CAAS;IAEvB,MAAM,IAAI,IAAI;IAId,QAAQ,IAAI,OAAO;IAInB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQ3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAQvB,KAAK,IAAI,IAAI;CAOd"}

package/package.json

@@ -1,14 +1,24 @@
 {
   "name": "@yieldstar/core",
-  "version": "0.4.6",
+  "version": "0.6.0",
+  "license": "MIT",
+  "author": "Daniel Grant",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/notationlabs/yieldstar.git",
+    "directory": "packages/core"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "dependencies": {
+    "@standard-schema/spec": "^1.1.0"
+  },
   "devDependencies": {
-    "@types/bun": "latest",
+    "@types/node": "^22.18.0",
     "pino": "^9.9.0"
   },
   "scripts": {
-    "build": "bun build src/index.ts --outfile dist/index.js --target bun --packages=external"
+    "build": "bun build src/index.ts --outfile dist/index.js --target node --packages=external"
   }
 }