@rivetkit/workflow-engine 0.0.0-main.72cbc7c → 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.
  */
@@ -456,6 +471,7 @@ interface WorkflowContextInterface {
         value: T;
     }>;
     removed(name: string, originalType: EntryKindType): Promise<void>;
+    getVersion(name: string, latest: number): Promise<number>;
     isEvicted(): boolean;
 }
 /**
@@ -555,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.
@@ -697,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>>;
@@ -713,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
      *
@@ -777,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.
@@ -883,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.
  */
@@ -456,6 +471,7 @@ interface WorkflowContextInterface {
         value: T;
     }>;
     removed(name: string, originalType: EntryKindType): Promise<void>;
+    getVersion(name: string, latest: number): Promise<number>;
     isEvicted(): boolean;
 }
 /**
@@ -555,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.
@@ -697,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>>;
@@ -713,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
      *
@@ -777,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.
@@ -883,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-CIDHCIH7.js";
+} from "./chunk-DTS4S7RT.js";
 export {
   CancelledError,
   CriticalError,

package/dist/tsup/testing.cjs

@@ -47,7 +47,7 @@
 
 
 
-var _chunkSFJQFMCWcjs = require('./chunk-SFJQFMCW.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, _chunkSFJQFMCWcjs.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, _chunkSFJQFMCWcjs.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 _chunkSFJQFMCWcjs.sleep.call(void 0, this.latency);
-    const entry = this.kv.get(_chunkSFJQFMCWcjs.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 _chunkSFJQFMCWcjs.sleep.call(void 0, this.latency);
-    this.kv.set(_chunkSFJQFMCWcjs.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 _chunkSFJQFMCWcjs.sleep.call(void 0, this.latency);
-    this.kv.delete(_chunkSFJQFMCWcjs.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 _chunkSFJQFMCWcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     for (const [hexKey, entry] of this.kv) {
-      if (_chunkSFJQFMCWcjs.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 _chunkSFJQFMCWcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     for (const [hexKey, entry] of this.kv) {
-      if (_chunkSFJQFMCWcjs.compareKeys.call(void 0, entry.key, start) >= 0 && _chunkSFJQFMCWcjs.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 _chunkSFJQFMCWcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     const results = [];
     for (const entry of this.kv.values()) {
-      if (_chunkSFJQFMCWcjs.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) => _chunkSFJQFMCWcjs.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 _chunkSFJQFMCWcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     for (const { key, value } of writes) {
-      this.kv.set(_chunkSFJQFMCWcjs.keyToHex.call(void 0, key), { key, value });
+      this.kv.set(_chunkKLHCG2KYcjs.keyToHex.call(void 0, key), { key, value });
     }
   }
   async setAlarm(workflowId, wakeAt) {
-    await _chunkSFJQFMCWcjs.sleep.call(void 0, this.latency);
+    await _chunkKLHCG2KYcjs.sleep.call(void 0, this.latency);
     this.alarms.set(workflowId, wakeAt);
   }
   async clearAlarm(workflowId) {
-    await _chunkSFJQFMCWcjs.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, _chunkSFJQFMCWcjs.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 _chunkSFJQFMCWcjs.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 = _chunkSFJQFMCWcjs.CancelledError; exports.CriticalError = _chunkSFJQFMCWcjs.CriticalError; exports.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL = _chunkSFJQFMCWcjs.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL; exports.DEFAULT_MAX_RETRIES = _chunkSFJQFMCWcjs.DEFAULT_MAX_RETRIES; exports.DEFAULT_RETRY_BACKOFF_BASE = _chunkSFJQFMCWcjs.DEFAULT_RETRY_BACKOFF_BASE; exports.DEFAULT_RETRY_BACKOFF_MAX = _chunkSFJQFMCWcjs.DEFAULT_RETRY_BACKOFF_MAX; exports.DEFAULT_STEP_TIMEOUT = _chunkSFJQFMCWcjs.DEFAULT_STEP_TIMEOUT; exports.EntryInProgressError = _chunkSFJQFMCWcjs.EntryInProgressError; exports.EvictedError = _chunkSFJQFMCWcjs.EvictedError; exports.HistoryDivergedError = _chunkSFJQFMCWcjs.HistoryDivergedError; exports.InMemoryDriver = InMemoryDriver; exports.JoinError = _chunkSFJQFMCWcjs.JoinError; exports.Loop = _chunkSFJQFMCWcjs.Loop; exports.MessageWaitError = _chunkSFJQFMCWcjs.MessageWaitError; exports.RaceError = _chunkSFJQFMCWcjs.RaceError; exports.RollbackCheckpointError = _chunkSFJQFMCWcjs.RollbackCheckpointError; exports.RollbackError = _chunkSFJQFMCWcjs.RollbackError; exports.SleepError = _chunkSFJQFMCWcjs.SleepError; exports.StepExhaustedError = _chunkSFJQFMCWcjs.StepExhaustedError; exports.StepFailedError = _chunkSFJQFMCWcjs.StepFailedError; exports.WorkflowContextImpl = _chunkSFJQFMCWcjs.WorkflowContextImpl; exports.appendLoopIteration = _chunkSFJQFMCWcjs.appendLoopIteration; exports.appendName = _chunkSFJQFMCWcjs.appendName; exports.createEntry = _chunkSFJQFMCWcjs.createEntry; exports.createHistorySnapshot = _chunkSFJQFMCWcjs.createHistorySnapshot; exports.createStorage = _chunkSFJQFMCWcjs.createStorage; exports.deleteEntriesWithPrefix = _chunkSFJQFMCWcjs.deleteEntriesWithPrefix; exports.emptyLocation = _chunkSFJQFMCWcjs.emptyLocation; exports.extractErrorInfo = _chunkSFJQFMCWcjs.extractErrorInfo; exports.flush = _chunkSFJQFMCWcjs.flush; exports.generateId = _chunkSFJQFMCWcjs.generateId; exports.getEntry = _chunkSFJQFMCWcjs.getEntry; exports.getOrCreateMetadata = _chunkSFJQFMCWcjs.getOrCreateMetadata; exports.isLocationPrefix = _chunkSFJQFMCWcjs.isLocationPrefix; exports.isLoopIterationMarker = _chunkSFJQFMCWcjs.isLoopIterationMarker; exports.loadMetadata = _chunkSFJQFMCWcjs.loadMetadata; exports.loadStorage = _chunkSFJQFMCWcjs.loadStorage; exports.locationToKey = _chunkSFJQFMCWcjs.locationToKey; exports.locationsEqual = _chunkSFJQFMCWcjs.locationsEqual; exports.parentLocation = _chunkSFJQFMCWcjs.parentLocation; exports.registerName = _chunkSFJQFMCWcjs.registerName; exports.replayWorkflowFromStep = _chunkSFJQFMCWcjs.replayWorkflowFromStep; exports.resolveName = _chunkSFJQFMCWcjs.resolveName; exports.runWorkflow = _chunkSFJQFMCWcjs.runWorkflow; exports.setEntry = _chunkSFJQFMCWcjs.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-CIDHCIH7.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.72cbc7c",
+	"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";