@rivetkit/workflow-engine 0.0.0-main.6151ab0 → 0.0.0-main.79e97f1

package/dist/tsup/index.d.cts

@@ -101,10 +101,20 @@ interface RemovedEntry {
     originalType: EntryKindType;
     originalName?: string;
 }
+/**
+ * Version check entry data - records which version of a code path this
+ * workflow instance is pinned to at a given location.
+ */
+interface VersionCheckEntry {
+    /** The version this instance resolved to at this location. */
+    resolved: number;
+    /** The `latest` value seen when this entry was first resolved (diagnostics). */
+    latest: number;
+}
 /**
  * All possible entry kind types.
  */
-type EntryKindType = "step" | "loop" | "sleep" | "message" | "rollback_checkpoint" | "join" | "race" | "removed";
+type EntryKindType = "step" | "loop" | "sleep" | "message" | "rollback_checkpoint" | "join" | "race" | "removed" | "version_check";
 /**
  * Type-specific entry data.
  */
@@ -132,6 +142,9 @@ type EntryKind = {
 } | {
     type: "removed";
     data: RemovedEntry;
+} | {
+    type: "version_check";
+    data: VersionCheckEntry;
 };
 /**
  * An entry in the workflow history.
@@ -345,6 +358,8 @@ interface StepConfig<T> {
     retryBackoffMax?: number;
     /** Timeout in ms for step execution (default: 30000). Set to 0 to disable. */
     timeout?: number;
+    /** If true, step timeouts retry like any other error instead of failing immediately as critical. Default: false. */
+    retryOnTimeout?: boolean;
 }
 type TryStepCatchKind = "critical" | "timeout" | "exhausted" | "rollback";
 interface TryStepFailure {
@@ -398,7 +413,7 @@ type LoopResult<S, T> = {
  * Stateless loops (state = undefined) may return void/undefined, which is treated as
  * `Loop.continue(undefined)`.
  */
-type LoopIterationResult<S, T> = Promise<LoopResult<S, T> | (S extends undefined ? void : never)>;
+type LoopIterationResult<S, T> = Promise<LoopResult<S, T> | (S extends undefined ? undefined : never)>;
 /**
  * Configuration for a loop.
  */
@@ -410,6 +425,12 @@ interface LoopConfig<S, T> {
     historyPruneInterval?: number;
     /** Number of past iterations to retain when pruning. Defaults to historyPruneInterval. */
     historySize?: number;
+    /** @deprecated Use historyPruneInterval. */
+    commitInterval?: number;
+    /** @deprecated Use historyPruneInterval. */
+    historyEvery?: number;
+    /** @deprecated Use historySize. */
+    historyKeep?: number;
 }
 /**
  * Configuration for a branch in join/race.
@@ -450,6 +471,7 @@ interface WorkflowContextInterface {
         value: T;
     }>;
     removed(name: string, originalType: EntryKindType): Promise<void>;
+    getVersion(name: string, latest: number): Promise<number>;
     isEvicted(): boolean;
 }
 /**
@@ -549,6 +571,11 @@ interface KVWrite {
  * See architecture.md "Isolation Model" for details.
  */
 interface EngineDriver {
+    /**
+     * Requires each logical storage flush to reach `batch` as one indivisible
+     * unit. The driver must reject an oversized unit instead of splitting it.
+     */
+    readonly atomicBatch?: boolean;
     /**
      * Get a value by key.
      * Returns null if the key doesn't exist.
@@ -691,12 +718,12 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
      */
     evict(): void;
     /**
-     * Wait for eviction message.
-     *
-     * The event listener uses { once: true } to auto-remove after firing,
-     * preventing memory leaks if this method is called multiple times.
+     * Wait for `ms`, rejecting early with EvictedError if the workflow is
+     * evicted. Both the timer and the abort listener are torn down on either
+     * outcome, so a completed sleep never leaves a dangling listener on the
+     * long-lived run abort signal.
      */
-    waitForEviction(): Promise<never>;
+    private sleepOrEvict;
     step<T>(nameOrConfig: string | StepConfig<T>, run?: () => Promise<T>): Promise<T>;
     tryStep<T>(nameOrConfig: string | TryStepConfig<T>, run?: () => Promise<T>): Promise<TryStepResult<T>>;
     try<T>(nameOrConfig: string | TryBlockConfig<T>, run?: (ctx: WorkflowContextInterface) => Promise<T>): Promise<TryBlockResult<T>>;
@@ -707,7 +734,9 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
      *
      * Note: This does NOT cancel the underlying operation. JavaScript Promises
      * cannot be cancelled once started. When a timeout occurs:
-     * - The step is marked as failed with StepTimeoutError
+     * - The step is rejected with StepTimeoutError. By default this is treated
+     *   as a critical failure with no retry. Set retryOnTimeout: true on the
+     *   step config to retry timeouts like any other error.
      * - The underlying async operation continues running in the background
      * - Any side effects from the operation may still occur
      *
@@ -771,8 +800,22 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
     private executeRace;
     removed(name: string, originalType: EntryKindType): Promise<void>;
     private executeRemoved;
+    getVersion(name: string, latest: number): Promise<number>;
+    private executeGetVersion;
+    /**
+     * Returns true if any history entry under the current location scope
+     * (other than `excludeKey`) has not yet been visited this run. Used by
+     * getVersion to detect an old in-flight instance whose scope was already
+     * executed by code that predates a version gate.
+     */
+    private hasUnvisitedUnderCurrentScope;
 }
 
+/**
+ * Extract structured error information from an error.
+ */
+declare function extractErrorInfo(error: unknown): WorkflowError;
+
 /**
  * Thrown from steps to prevent retry.
  * Use this when an error is unrecoverable and retrying would be pointless.
@@ -877,11 +920,6 @@ declare class EntryInProgressError extends Error {
     constructor();
 }
 
-/**
- * Extract structured error information from an error.
- */
-declare function extractErrorInfo(error: unknown): WorkflowError;
-
 /**
  * Check if a path segment is a loop iteration marker.
  */

package/dist/tsup/index.d.ts

@@ -101,10 +101,20 @@ interface RemovedEntry {
     originalType: EntryKindType;
     originalName?: string;
 }
+/**
+ * Version check entry data - records which version of a code path this
+ * workflow instance is pinned to at a given location.
+ */
+interface VersionCheckEntry {
+    /** The version this instance resolved to at this location. */
+    resolved: number;
+    /** The `latest` value seen when this entry was first resolved (diagnostics). */
+    latest: number;
+}
 /**
  * All possible entry kind types.
  */
-type EntryKindType = "step" | "loop" | "sleep" | "message" | "rollback_checkpoint" | "join" | "race" | "removed";
+type EntryKindType = "step" | "loop" | "sleep" | "message" | "rollback_checkpoint" | "join" | "race" | "removed" | "version_check";
 /**
  * Type-specific entry data.
  */
@@ -132,6 +142,9 @@ type EntryKind = {
 } | {
     type: "removed";
     data: RemovedEntry;
+} | {
+    type: "version_check";
+    data: VersionCheckEntry;
 };
 /**
  * An entry in the workflow history.
@@ -345,6 +358,8 @@ interface StepConfig<T> {
     retryBackoffMax?: number;
     /** Timeout in ms for step execution (default: 30000). Set to 0 to disable. */
     timeout?: number;
+    /** If true, step timeouts retry like any other error instead of failing immediately as critical. Default: false. */
+    retryOnTimeout?: boolean;
 }
 type TryStepCatchKind = "critical" | "timeout" | "exhausted" | "rollback";
 interface TryStepFailure {
@@ -398,7 +413,7 @@ type LoopResult<S, T> = {
  * Stateless loops (state = undefined) may return void/undefined, which is treated as
  * `Loop.continue(undefined)`.
  */
-type LoopIterationResult<S, T> = Promise<LoopResult<S, T> | (S extends undefined ? void : never)>;
+type LoopIterationResult<S, T> = Promise<LoopResult<S, T> | (S extends undefined ? undefined : never)>;
 /**
  * Configuration for a loop.
  */
@@ -410,6 +425,12 @@ interface LoopConfig<S, T> {
     historyPruneInterval?: number;
     /** Number of past iterations to retain when pruning. Defaults to historyPruneInterval. */
     historySize?: number;
+    /** @deprecated Use historyPruneInterval. */
+    commitInterval?: number;
+    /** @deprecated Use historyPruneInterval. */
+    historyEvery?: number;
+    /** @deprecated Use historySize. */
+    historyKeep?: number;
 }
 /**
  * Configuration for a branch in join/race.
@@ -450,6 +471,7 @@ interface WorkflowContextInterface {
         value: T;
     }>;
     removed(name: string, originalType: EntryKindType): Promise<void>;
+    getVersion(name: string, latest: number): Promise<number>;
     isEvicted(): boolean;
 }
 /**
@@ -549,6 +571,11 @@ interface KVWrite {
  * See architecture.md "Isolation Model" for details.
  */
 interface EngineDriver {
+    /**
+     * Requires each logical storage flush to reach `batch` as one indivisible
+     * unit. The driver must reject an oversized unit instead of splitting it.
+     */
+    readonly atomicBatch?: boolean;
     /**
      * Get a value by key.
      * Returns null if the key doesn't exist.
@@ -691,12 +718,12 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
      */
     evict(): void;
     /**
-     * Wait for eviction message.
-     *
-     * The event listener uses { once: true } to auto-remove after firing,
-     * preventing memory leaks if this method is called multiple times.
+     * Wait for `ms`, rejecting early with EvictedError if the workflow is
+     * evicted. Both the timer and the abort listener are torn down on either
+     * outcome, so a completed sleep never leaves a dangling listener on the
+     * long-lived run abort signal.
      */
-    waitForEviction(): Promise<never>;
+    private sleepOrEvict;
     step<T>(nameOrConfig: string | StepConfig<T>, run?: () => Promise<T>): Promise<T>;
     tryStep<T>(nameOrConfig: string | TryStepConfig<T>, run?: () => Promise<T>): Promise<TryStepResult<T>>;
     try<T>(nameOrConfig: string | TryBlockConfig<T>, run?: (ctx: WorkflowContextInterface) => Promise<T>): Promise<TryBlockResult<T>>;
@@ -707,7 +734,9 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
      *
      * Note: This does NOT cancel the underlying operation. JavaScript Promises
      * cannot be cancelled once started. When a timeout occurs:
-     * - The step is marked as failed with StepTimeoutError
+     * - The step is rejected with StepTimeoutError. By default this is treated
+     *   as a critical failure with no retry. Set retryOnTimeout: true on the
+     *   step config to retry timeouts like any other error.
      * - The underlying async operation continues running in the background
      * - Any side effects from the operation may still occur
      *
@@ -771,8 +800,22 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
     private executeRace;
     removed(name: string, originalType: EntryKindType): Promise<void>;
     private executeRemoved;
+    getVersion(name: string, latest: number): Promise<number>;
+    private executeGetVersion;
+    /**
+     * Returns true if any history entry under the current location scope
+     * (other than `excludeKey`) has not yet been visited this run. Used by
+     * getVersion to detect an old in-flight instance whose scope was already
+     * executed by code that predates a version gate.
+     */
+    private hasUnvisitedUnderCurrentScope;
 }
 
+/**
+ * Extract structured error information from an error.
+ */
+declare function extractErrorInfo(error: unknown): WorkflowError;
+
 /**
  * Thrown from steps to prevent retry.
  * Use this when an error is unrecoverable and retrying would be pointless.
@@ -877,11 +920,6 @@ declare class EntryInProgressError extends Error {
     constructor();
 }
 
-/**
- * Extract structured error information from an error.
- */
-declare function extractErrorInfo(error: unknown): WorkflowError;
-
 /**
  * Check if a path segment is a loop iteration marker.
  */

package/dist/tsup/index.js

@@ -43,7 +43,7 @@ import {
   resolveName,
   runWorkflow,
   setEntry
-} from "./chunk-UMFB2AR3.js";
+} from "./chunk-DTS4S7RT.js";
 export {
   CancelledError,
   CriticalError,

package/dist/tsup/testing.cjs

@@ -47,7 +47,7 @@
 
 
 
-var _chunk4SWXLWKLcjs = require('./chunk-4SWXLWKL.cjs');
+var _chunkKLHCG2KYcjs = require('./chunk-KLHCG2KY.cjs');
 
 // src/testing.ts
 var InMemoryWorkflowMessageDriver = class {
@@ -97,7 +97,7 @@ var InMemoryWorkflowMessageDriver = class {
   }
   async waitForMessages(messageNames, abortSignal) {
     if (abortSignal.aborted) {
-      throw new (0, _chunk4SWXLWKLcjs.EvictedError)();
+      throw new (0, _chunkKLHCG2KYcjs.EvictedError)();
     }
     const nameSet = messageNames.length > 0 ? new Set(messageNames) : void 0;
     if (this.#messages.some(
@@ -118,7 +118,7 @@ var InMemoryWorkflowMessageDriver = class {
         },
         abortSignal,
         onAbort: () => {
-          waiter.reject(new (0, _chunk4SWXLWKLcjs.EvictedError)());
+          waiter.reject(new (0, _chunkKLHCG2KYcjs.EvictedError)());
         }
       };
       abortSignal.addEventListener("abort", waiter.onAbort, {
@@ -158,56 +158,56 @@ var InMemoryDriver = (_class = class {constructor() { _class.prototype.__init.ca
   __init4() {this.workerPollInterval = 100}
   __init5() {this.messageDriver = this.#inMemoryMessageDriver}
   async get(key) {
-    await _chunk4SWXLWKLcjs.sleep.call(void 0, this.latency);
-    const entry = this.kv.get(_chunk4SWXLWKLcjs.keyToHex.call(void 0, key));
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
+    const entry = this.kv.get(_chunkKLHCG2KYcjs.keyToHex.call(void 0, key));
     return _nullishCoalesce((entry == null ? void 0 : entry.value), () => ( null));
   }
   async set(key, value) {
-    await _chunk4SWXLWKLcjs.sleep.call(void 0, this.latency);
-    this.kv.set(_chunk4SWXLWKLcjs.keyToHex.call(void 0, key), { key, value });
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
+    this.kv.set(_chunkKLHCG2KYcjs.keyToHex.call(void 0, key), { key, value });
   }
   async delete(key) {
-    await _chunk4SWXLWKLcjs.sleep.call(void 0, this.latency);
-    this.kv.delete(_chunk4SWXLWKLcjs.keyToHex.call(void 0, key));
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
+    this.kv.delete(_chunkKLHCG2KYcjs.keyToHex.call(void 0, key));
   }
   async deletePrefix(prefix) {
-    await _chunk4SWXLWKLcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     for (const [hexKey, entry] of this.kv) {
-      if (_chunk4SWXLWKLcjs.keyStartsWith.call(void 0, entry.key, prefix)) {
+      if (_chunkKLHCG2KYcjs.keyStartsWith.call(void 0, entry.key, prefix)) {
         this.kv.delete(hexKey);
       }
     }
   }
   async deleteRange(start, end) {
-    await _chunk4SWXLWKLcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     for (const [hexKey, entry] of this.kv) {
-      if (_chunk4SWXLWKLcjs.compareKeys.call(void 0, entry.key, start) >= 0 && _chunk4SWXLWKLcjs.compareKeys.call(void 0, entry.key, end) < 0) {
+      if (_chunkKLHCG2KYcjs.compareKeys.call(void 0, entry.key, start) >= 0 && _chunkKLHCG2KYcjs.compareKeys.call(void 0, entry.key, end) < 0) {
         this.kv.delete(hexKey);
       }
     }
   }
   async list(prefix) {
-    await _chunk4SWXLWKLcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     const results = [];
     for (const entry of this.kv.values()) {
-      if (_chunk4SWXLWKLcjs.keyStartsWith.call(void 0, entry.key, prefix)) {
+      if (_chunkKLHCG2KYcjs.keyStartsWith.call(void 0, entry.key, prefix)) {
         results.push({ key: entry.key, value: entry.value });
       }
     }
-    return results.sort((a, b) => _chunk4SWXLWKLcjs.compareKeys.call(void 0, a.key, b.key));
+    return results.sort((a, b) => _chunkKLHCG2KYcjs.compareKeys.call(void 0, a.key, b.key));
   }
   async batch(writes) {
-    await _chunk4SWXLWKLcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     for (const { key, value } of writes) {
-      this.kv.set(_chunk4SWXLWKLcjs.keyToHex.call(void 0, key), { key, value });
+      this.kv.set(_chunkKLHCG2KYcjs.keyToHex.call(void 0, key), { key, value });
     }
   }
   async setAlarm(workflowId, wakeAt) {
-    await _chunk4SWXLWKLcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     this.alarms.set(workflowId, wakeAt);
   }
   async clearAlarm(workflowId) {
-    await _chunk4SWXLWKLcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     this.alarms.delete(workflowId);
   }
   async waitForMessages(messageNames, abortSignal) {
@@ -218,7 +218,7 @@ var InMemoryDriver = (_class = class {constructor() { _class.prototype.__init.ca
     }
     while (true) {
       if (abortSignal.aborted) {
-        throw new (0, _chunk4SWXLWKLcjs.EvictedError)();
+        throw new (0, _chunkKLHCG2KYcjs.EvictedError)();
       }
       const messages = await this.messageDriver.receiveMessages({
         names: messageNames.length > 0 ? messageNames : void 0,
@@ -228,7 +228,7 @@ var InMemoryDriver = (_class = class {constructor() { _class.prototype.__init.ca
       if (messages.length > 0) {
         return;
       }
-      await _chunk4SWXLWKLcjs.sleep.call(void 0, Math.max(1, this.latency));
+      await _chunkKLHCG2KYcjs.sleep.call(void 0, Math.max(1, this.latency));
     }
   }
   /**
@@ -324,5 +324,5 @@ var InMemoryDriver = (_class = class {constructor() { _class.prototype.__init.ca
 
 
 
-exports.CancelledError = _chunk4SWXLWKLcjs.CancelledError; exports.CriticalError = _chunk4SWXLWKLcjs.CriticalError; exports.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL = _chunk4SWXLWKLcjs.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL; exports.DEFAULT_MAX_RETRIES = _chunk4SWXLWKLcjs.DEFAULT_MAX_RETRIES; exports.DEFAULT_RETRY_BACKOFF_BASE = _chunk4SWXLWKLcjs.DEFAULT_RETRY_BACKOFF_BASE; exports.DEFAULT_RETRY_BACKOFF_MAX = _chunk4SWXLWKLcjs.DEFAULT_RETRY_BACKOFF_MAX; exports.DEFAULT_STEP_TIMEOUT = _chunk4SWXLWKLcjs.DEFAULT_STEP_TIMEOUT; exports.EntryInProgressError = _chunk4SWXLWKLcjs.EntryInProgressError; exports.EvictedError = _chunk4SWXLWKLcjs.EvictedError; exports.HistoryDivergedError = _chunk4SWXLWKLcjs.HistoryDivergedError; exports.InMemoryDriver = InMemoryDriver; exports.JoinError = _chunk4SWXLWKLcjs.JoinError; exports.Loop = _chunk4SWXLWKLcjs.Loop; exports.MessageWaitError = _chunk4SWXLWKLcjs.MessageWaitError; exports.RaceError = _chunk4SWXLWKLcjs.RaceError; exports.RollbackCheckpointError = _chunk4SWXLWKLcjs.RollbackCheckpointError; exports.RollbackError = _chunk4SWXLWKLcjs.RollbackError; exports.SleepError = _chunk4SWXLWKLcjs.SleepError; exports.StepExhaustedError = _chunk4SWXLWKLcjs.StepExhaustedError; exports.StepFailedError = _chunk4SWXLWKLcjs.StepFailedError; exports.WorkflowContextImpl = _chunk4SWXLWKLcjs.WorkflowContextImpl; exports.appendLoopIteration = _chunk4SWXLWKLcjs.appendLoopIteration; exports.appendName = _chunk4SWXLWKLcjs.appendName; exports.createEntry = _chunk4SWXLWKLcjs.createEntry; exports.createHistorySnapshot = _chunk4SWXLWKLcjs.createHistorySnapshot; exports.createStorage = _chunk4SWXLWKLcjs.createStorage; exports.deleteEntriesWithPrefix = _chunk4SWXLWKLcjs.deleteEntriesWithPrefix; exports.emptyLocation = _chunk4SWXLWKLcjs.emptyLocation; exports.extractErrorInfo = _chunk4SWXLWKLcjs.extractErrorInfo; exports.flush = _chunk4SWXLWKLcjs.flush; exports.generateId = _chunk4SWXLWKLcjs.generateId; exports.getEntry = _chunk4SWXLWKLcjs.getEntry; exports.getOrCreateMetadata = _chunk4SWXLWKLcjs.getOrCreateMetadata; exports.isLocationPrefix = _chunk4SWXLWKLcjs.isLocationPrefix; exports.isLoopIterationMarker = _chunk4SWXLWKLcjs.isLoopIterationMarker; exports.loadMetadata = _chunk4SWXLWKLcjs.loadMetadata; exports.loadStorage = _chunk4SWXLWKLcjs.loadStorage; exports.locationToKey = _chunk4SWXLWKLcjs.locationToKey; exports.locationsEqual = _chunk4SWXLWKLcjs.locationsEqual; exports.parentLocation = _chunk4SWXLWKLcjs.parentLocation; exports.registerName = _chunk4SWXLWKLcjs.registerName; exports.replayWorkflowFromStep = _chunk4SWXLWKLcjs.replayWorkflowFromStep; exports.resolveName = _chunk4SWXLWKLcjs.resolveName; exports.runWorkflow = _chunk4SWXLWKLcjs.runWorkflow; exports.setEntry = _chunk4SWXLWKLcjs.setEntry;
+exports.CancelledError = _chunkKLHCG2KYcjs.CancelledError; exports.CriticalError = _chunkKLHCG2KYcjs.CriticalError; exports.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL = _chunkKLHCG2KYcjs.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL; exports.DEFAULT_MAX_RETRIES = _chunkKLHCG2KYcjs.DEFAULT_MAX_RETRIES; exports.DEFAULT_RETRY_BACKOFF_BASE = _chunkKLHCG2KYcjs.DEFAULT_RETRY_BACKOFF_BASE; exports.DEFAULT_RETRY_BACKOFF_MAX = _chunkKLHCG2KYcjs.DEFAULT_RETRY_BACKOFF_MAX; exports.DEFAULT_STEP_TIMEOUT = _chunkKLHCG2KYcjs.DEFAULT_STEP_TIMEOUT; exports.EntryInProgressError = _chunkKLHCG2KYcjs.EntryInProgressError; exports.EvictedError = _chunkKLHCG2KYcjs.EvictedError; exports.HistoryDivergedError = _chunkKLHCG2KYcjs.HistoryDivergedError; exports.InMemoryDriver = InMemoryDriver; exports.JoinError = _chunkKLHCG2KYcjs.JoinError; exports.Loop = _chunkKLHCG2KYcjs.Loop; exports.MessageWaitError = _chunkKLHCG2KYcjs.MessageWaitError; exports.RaceError = _chunkKLHCG2KYcjs.RaceError; exports.RollbackCheckpointError = _chunkKLHCG2KYcjs.RollbackCheckpointError; exports.RollbackError = _chunkKLHCG2KYcjs.RollbackError; exports.SleepError = _chunkKLHCG2KYcjs.SleepError; exports.StepExhaustedError = _chunkKLHCG2KYcjs.StepExhaustedError; exports.StepFailedError = _chunkKLHCG2KYcjs.StepFailedError; exports.WorkflowContextImpl = _chunkKLHCG2KYcjs.WorkflowContextImpl; exports.appendLoopIteration = _chunkKLHCG2KYcjs.appendLoopIteration; exports.appendName = _chunkKLHCG2KYcjs.appendName; exports.createEntry = _chunkKLHCG2KYcjs.createEntry; exports.createHistorySnapshot = _chunkKLHCG2KYcjs.createHistorySnapshot; exports.createStorage = _chunkKLHCG2KYcjs.createStorage; exports.deleteEntriesWithPrefix = _chunkKLHCG2KYcjs.deleteEntriesWithPrefix; exports.emptyLocation = _chunkKLHCG2KYcjs.emptyLocation; exports.extractErrorInfo = _chunkKLHCG2KYcjs.extractErrorInfo; exports.flush = _chunkKLHCG2KYcjs.flush; exports.generateId = _chunkKLHCG2KYcjs.generateId; exports.getEntry = _chunkKLHCG2KYcjs.getEntry; exports.getOrCreateMetadata = _chunkKLHCG2KYcjs.getOrCreateMetadata; exports.isLocationPrefix = _chunkKLHCG2KYcjs.isLocationPrefix; exports.isLoopIterationMarker = _chunkKLHCG2KYcjs.isLoopIterationMarker; exports.loadMetadata = _chunkKLHCG2KYcjs.loadMetadata; exports.loadStorage = _chunkKLHCG2KYcjs.loadStorage; exports.locationToKey = _chunkKLHCG2KYcjs.locationToKey; exports.locationsEqual = _chunkKLHCG2KYcjs.locationsEqual; exports.parentLocation = _chunkKLHCG2KYcjs.parentLocation; exports.registerName = _chunkKLHCG2KYcjs.registerName; exports.replayWorkflowFromStep = _chunkKLHCG2KYcjs.replayWorkflowFromStep; exports.resolveName = _chunkKLHCG2KYcjs.resolveName; exports.runWorkflow = _chunkKLHCG2KYcjs.runWorkflow; exports.setEntry = _chunkKLHCG2KYcjs.setEntry;
 //# sourceMappingURL=testing.cjs.map

package/dist/tsup/testing.js

@@ -47,7 +47,7 @@ import {
   runWorkflow,
   setEntry,
   sleep
-} from "./chunk-UMFB2AR3.js";
+} from "./chunk-DTS4S7RT.js";
 
 // src/testing.ts
 var InMemoryWorkflowMessageDriver = class {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rivetkit/workflow-engine",
-	"version": "0.0.0-main.6151ab0",
+	"version": "0.0.0-main.79e97f1",
 	"description": "Durable workflow engine with reentrant execution",
 	"license": "Apache-2.0",
 	"keywords": [

package/schemas/serde.ts

@@ -18,7 +18,6 @@ import type {
 	EntryMetadata as InternalEntryMetadata,
 	EntryStatus as InternalEntryStatus,
 	Location as InternalLocation,
-	LoopIterationMarker as InternalLoopIterationMarker,
 	PathSegment as InternalPathSegment,
 	SleepState as InternalSleepState,
 	WorkflowState as InternalWorkflowState,
@@ -27,7 +26,6 @@ import {
 	CURRENT_VERSION,
 	ENTRY_METADATA_VERSIONED,
 	ENTRY_VERSIONED,
-	WORKFLOW_METADATA_VERSIONED,
 } from "./versioned.js";
 
 // === Helper: ArrayBuffer to/from utilities ===
@@ -74,7 +72,7 @@ function assertString(
 /**
  * Validate that a value is a number.
  */
-function assertNumber(
+function _assertNumber(
 	value: unknown,
 	context: string,
 ): asserts value is number {
@@ -309,6 +307,14 @@ function entryKindToBare(kind: InternalEntryKind): v1.EntryKind {
 					originalName: kind.data.originalName ?? null,
 				},
 			};
+		case "version_check":
+			return {
+				tag: "VersionCheckEntry",
+				val: {
+					resolved: kind.data.resolved,
+					latest: kind.data.latest,
+				},
+			};
 	}
 }
 
@@ -398,6 +404,14 @@ function entryKindFromBare(kind: v1.EntryKind): InternalEntryKind {
 					originalName: kind.val.originalName ?? undefined,
 				},
 			};
+		case "VersionCheckEntry":
+			return {
+				type: "version_check",
+				data: {
+					resolved: kind.val.resolved,
+					latest: kind.val.latest,
+				},
+			};
 		default:
 			throw new Error(
 				`Unknown entry kind: ${(kind as { tag: string }).tag}`,

package/schemas/v1.bare

@@ -122,6 +122,14 @@ type RemovedEntry struct {
 	originalName: optional<str>
 }
 
+# MARK: Version Check Entry
+type VersionCheckEntry struct {
+	# The version this instance resolved to at this location
+	resolved: u32
+	# The `latest` value seen when first resolved (diagnostics)
+	latest: u32
+}
+
 # MARK: Entry Kind
 # Type-specific entry data
 type EntryKind union {
@@ -132,7 +140,8 @@ type EntryKind union {
 	RollbackCheckpointEntry |
 	JoinEntry |
 	RaceEntry |
-	RemovedEntry
+	RemovedEntry |
+	VersionCheckEntry
 }
 
 # MARK: Entry

package/schemas/versioned.ts

@@ -19,6 +19,7 @@ export type {
 	RemovedEntry,
 	SleepEntry,
 	StepEntry,
+	VersionCheckEntry,
 	WorkflowMetadata,
 } from "../dist/schemas/v1.js";