@rivetkit/workflow-engine 2.3.2 → 2.3.3-rc.2

package/dist/tsup/index.cjs

@@ -43,7 +43,7 @@
 
 
 
-var _chunkGQWOLYBAcjs = require('./chunk-GQWOLYBA.cjs');
+var _chunkOCUQRGRScjs = require('./chunk-OCUQRGRS.cjs');
 
 
 
@@ -89,5 +89,5 @@ var _chunkGQWOLYBAcjs = require('./chunk-GQWOLYBA.cjs');
 
 
 
-exports.CancelledError = _chunkGQWOLYBAcjs.CancelledError; exports.CriticalError = _chunkGQWOLYBAcjs.CriticalError; exports.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL = _chunkGQWOLYBAcjs.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL; exports.DEFAULT_MAX_RETRIES = _chunkGQWOLYBAcjs.DEFAULT_MAX_RETRIES; exports.DEFAULT_RETRY_BACKOFF_BASE = _chunkGQWOLYBAcjs.DEFAULT_RETRY_BACKOFF_BASE; exports.DEFAULT_RETRY_BACKOFF_MAX = _chunkGQWOLYBAcjs.DEFAULT_RETRY_BACKOFF_MAX; exports.DEFAULT_STEP_TIMEOUT = _chunkGQWOLYBAcjs.DEFAULT_STEP_TIMEOUT; exports.EntryInProgressError = _chunkGQWOLYBAcjs.EntryInProgressError; exports.EvictedError = _chunkGQWOLYBAcjs.EvictedError; exports.HistoryDivergedError = _chunkGQWOLYBAcjs.HistoryDivergedError; exports.JoinError = _chunkGQWOLYBAcjs.JoinError; exports.Loop = _chunkGQWOLYBAcjs.Loop; exports.MessageWaitError = _chunkGQWOLYBAcjs.MessageWaitError; exports.RaceError = _chunkGQWOLYBAcjs.RaceError; exports.RollbackCheckpointError = _chunkGQWOLYBAcjs.RollbackCheckpointError; exports.RollbackError = _chunkGQWOLYBAcjs.RollbackError; exports.SleepError = _chunkGQWOLYBAcjs.SleepError; exports.StepExhaustedError = _chunkGQWOLYBAcjs.StepExhaustedError; exports.StepFailedError = _chunkGQWOLYBAcjs.StepFailedError; exports.WorkflowContextImpl = _chunkGQWOLYBAcjs.WorkflowContextImpl; exports.appendLoopIteration = _chunkGQWOLYBAcjs.appendLoopIteration; exports.appendName = _chunkGQWOLYBAcjs.appendName; exports.createEntry = _chunkGQWOLYBAcjs.createEntry; exports.createHistorySnapshot = _chunkGQWOLYBAcjs.createHistorySnapshot; exports.createStorage = _chunkGQWOLYBAcjs.createStorage; exports.deleteEntriesWithPrefix = _chunkGQWOLYBAcjs.deleteEntriesWithPrefix; exports.emptyLocation = _chunkGQWOLYBAcjs.emptyLocation; exports.extractErrorInfo = _chunkGQWOLYBAcjs.extractErrorInfo; exports.flush = _chunkGQWOLYBAcjs.flush; exports.generateId = _chunkGQWOLYBAcjs.generateId; exports.getEntry = _chunkGQWOLYBAcjs.getEntry; exports.getOrCreateMetadata = _chunkGQWOLYBAcjs.getOrCreateMetadata; exports.isLocationPrefix = _chunkGQWOLYBAcjs.isLocationPrefix; exports.isLoopIterationMarker = _chunkGQWOLYBAcjs.isLoopIterationMarker; exports.loadMetadata = _chunkGQWOLYBAcjs.loadMetadata; exports.loadStorage = _chunkGQWOLYBAcjs.loadStorage; exports.locationToKey = _chunkGQWOLYBAcjs.locationToKey; exports.locationsEqual = _chunkGQWOLYBAcjs.locationsEqual; exports.parentLocation = _chunkGQWOLYBAcjs.parentLocation; exports.registerName = _chunkGQWOLYBAcjs.registerName; exports.replayWorkflowFromStep = _chunkGQWOLYBAcjs.replayWorkflowFromStep; exports.resolveName = _chunkGQWOLYBAcjs.resolveName; exports.runWorkflow = _chunkGQWOLYBAcjs.runWorkflow; exports.setEntry = _chunkGQWOLYBAcjs.setEntry;
+exports.CancelledError = _chunkOCUQRGRScjs.CancelledError; exports.CriticalError = _chunkOCUQRGRScjs.CriticalError; exports.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL = _chunkOCUQRGRScjs.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL; exports.DEFAULT_MAX_RETRIES = _chunkOCUQRGRScjs.DEFAULT_MAX_RETRIES; exports.DEFAULT_RETRY_BACKOFF_BASE = _chunkOCUQRGRScjs.DEFAULT_RETRY_BACKOFF_BASE; exports.DEFAULT_RETRY_BACKOFF_MAX = _chunkOCUQRGRScjs.DEFAULT_RETRY_BACKOFF_MAX; exports.DEFAULT_STEP_TIMEOUT = _chunkOCUQRGRScjs.DEFAULT_STEP_TIMEOUT; exports.EntryInProgressError = _chunkOCUQRGRScjs.EntryInProgressError; exports.EvictedError = _chunkOCUQRGRScjs.EvictedError; exports.HistoryDivergedError = _chunkOCUQRGRScjs.HistoryDivergedError; exports.JoinError = _chunkOCUQRGRScjs.JoinError; exports.Loop = _chunkOCUQRGRScjs.Loop; exports.MessageWaitError = _chunkOCUQRGRScjs.MessageWaitError; exports.RaceError = _chunkOCUQRGRScjs.RaceError; exports.RollbackCheckpointError = _chunkOCUQRGRScjs.RollbackCheckpointError; exports.RollbackError = _chunkOCUQRGRScjs.RollbackError; exports.SleepError = _chunkOCUQRGRScjs.SleepError; exports.StepExhaustedError = _chunkOCUQRGRScjs.StepExhaustedError; exports.StepFailedError = _chunkOCUQRGRScjs.StepFailedError; exports.WorkflowContextImpl = _chunkOCUQRGRScjs.WorkflowContextImpl; exports.appendLoopIteration = _chunkOCUQRGRScjs.appendLoopIteration; exports.appendName = _chunkOCUQRGRScjs.appendName; exports.createEntry = _chunkOCUQRGRScjs.createEntry; exports.createHistorySnapshot = _chunkOCUQRGRScjs.createHistorySnapshot; exports.createStorage = _chunkOCUQRGRScjs.createStorage; exports.deleteEntriesWithPrefix = _chunkOCUQRGRScjs.deleteEntriesWithPrefix; exports.emptyLocation = _chunkOCUQRGRScjs.emptyLocation; exports.extractErrorInfo = _chunkOCUQRGRScjs.extractErrorInfo; exports.flush = _chunkOCUQRGRScjs.flush; exports.generateId = _chunkOCUQRGRScjs.generateId; exports.getEntry = _chunkOCUQRGRScjs.getEntry; exports.getOrCreateMetadata = _chunkOCUQRGRScjs.getOrCreateMetadata; exports.isLocationPrefix = _chunkOCUQRGRScjs.isLocationPrefix; exports.isLoopIterationMarker = _chunkOCUQRGRScjs.isLoopIterationMarker; exports.loadMetadata = _chunkOCUQRGRScjs.loadMetadata; exports.loadStorage = _chunkOCUQRGRScjs.loadStorage; exports.locationToKey = _chunkOCUQRGRScjs.locationToKey; exports.locationsEqual = _chunkOCUQRGRScjs.locationsEqual; exports.parentLocation = _chunkOCUQRGRScjs.parentLocation; exports.registerName = _chunkOCUQRGRScjs.registerName; exports.replayWorkflowFromStep = _chunkOCUQRGRScjs.replayWorkflowFromStep; exports.resolveName = _chunkOCUQRGRScjs.resolveName; exports.runWorkflow = _chunkOCUQRGRScjs.runWorkflow; exports.setEntry = _chunkOCUQRGRScjs.setEntry;
 //# sourceMappingURL=index.cjs.map

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.
@@ -458,6 +471,7 @@ interface WorkflowContextInterface {
         value: T;
     }>;
     removed(name: string, originalType: EntryKindType): Promise<void>;
+    getVersion(name: string, latest: number): Promise<number>;
     isEvicted(): boolean;
 }
 /**
@@ -781,6 +795,15 @@ 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;
 }
 
 /**

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.
@@ -458,6 +471,7 @@ interface WorkflowContextInterface {
         value: T;
     }>;
     removed(name: string, originalType: EntryKindType): Promise<void>;
+    getVersion(name: string, latest: number): Promise<number>;
     isEvicted(): boolean;
 }
 /**
@@ -781,6 +795,15 @@ 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;
 }
 
 /**

package/dist/tsup/index.js

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

package/dist/tsup/testing.cjs

@@ -47,7 +47,7 @@
 
 
 
-var _chunkGQWOLYBAcjs = require('./chunk-GQWOLYBA.cjs');
+var _chunkOCUQRGRScjs = require('./chunk-OCUQRGRS.cjs');
 
 // src/testing.ts
 var InMemoryWorkflowMessageDriver = class {
@@ -97,7 +97,7 @@ var InMemoryWorkflowMessageDriver = class {
   }
   async waitForMessages(messageNames, abortSignal) {
     if (abortSignal.aborted) {
-      throw new (0, _chunkGQWOLYBAcjs.EvictedError)();
+      throw new (0, _chunkOCUQRGRScjs.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, _chunkGQWOLYBAcjs.EvictedError)());
+          waiter.reject(new (0, _chunkOCUQRGRScjs.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 _chunkGQWOLYBAcjs.sleep.call(void 0, this.latency);
-    const entry = this.kv.get(_chunkGQWOLYBAcjs.keyToHex.call(void 0, key));
+    await _chunkOCUQRGRScjs.sleep.call(void 0, this.latency);
+    const entry = this.kv.get(_chunkOCUQRGRScjs.keyToHex.call(void 0, key));
     return _nullishCoalesce((entry == null ? void 0 : entry.value), () => ( null));
   }
   async set(key, value) {
-    await _chunkGQWOLYBAcjs.sleep.call(void 0, this.latency);
-    this.kv.set(_chunkGQWOLYBAcjs.keyToHex.call(void 0, key), { key, value });
+    await _chunkOCUQRGRScjs.sleep.call(void 0, this.latency);
+    this.kv.set(_chunkOCUQRGRScjs.keyToHex.call(void 0, key), { key, value });
   }
   async delete(key) {
-    await _chunkGQWOLYBAcjs.sleep.call(void 0, this.latency);
-    this.kv.delete(_chunkGQWOLYBAcjs.keyToHex.call(void 0, key));
+    await _chunkOCUQRGRScjs.sleep.call(void 0, this.latency);
+    this.kv.delete(_chunkOCUQRGRScjs.keyToHex.call(void 0, key));
   }
   async deletePrefix(prefix) {
-    await _chunkGQWOLYBAcjs.sleep.call(void 0, this.latency);
+    await _chunkOCUQRGRScjs.sleep.call(void 0, this.latency);
     for (const [hexKey, entry] of this.kv) {
-      if (_chunkGQWOLYBAcjs.keyStartsWith.call(void 0, entry.key, prefix)) {
+      if (_chunkOCUQRGRScjs.keyStartsWith.call(void 0, entry.key, prefix)) {
         this.kv.delete(hexKey);
       }
     }
   }
   async deleteRange(start, end) {
-    await _chunkGQWOLYBAcjs.sleep.call(void 0, this.latency);
+    await _chunkOCUQRGRScjs.sleep.call(void 0, this.latency);
     for (const [hexKey, entry] of this.kv) {
-      if (_chunkGQWOLYBAcjs.compareKeys.call(void 0, entry.key, start) >= 0 && _chunkGQWOLYBAcjs.compareKeys.call(void 0, entry.key, end) < 0) {
+      if (_chunkOCUQRGRScjs.compareKeys.call(void 0, entry.key, start) >= 0 && _chunkOCUQRGRScjs.compareKeys.call(void 0, entry.key, end) < 0) {
         this.kv.delete(hexKey);
       }
     }
   }
   async list(prefix) {
-    await _chunkGQWOLYBAcjs.sleep.call(void 0, this.latency);
+    await _chunkOCUQRGRScjs.sleep.call(void 0, this.latency);
     const results = [];
     for (const entry of this.kv.values()) {
-      if (_chunkGQWOLYBAcjs.keyStartsWith.call(void 0, entry.key, prefix)) {
+      if (_chunkOCUQRGRScjs.keyStartsWith.call(void 0, entry.key, prefix)) {
         results.push({ key: entry.key, value: entry.value });
       }
     }
-    return results.sort((a, b) => _chunkGQWOLYBAcjs.compareKeys.call(void 0, a.key, b.key));
+    return results.sort((a, b) => _chunkOCUQRGRScjs.compareKeys.call(void 0, a.key, b.key));
   }
   async batch(writes) {
-    await _chunkGQWOLYBAcjs.sleep.call(void 0, this.latency);
+    await _chunkOCUQRGRScjs.sleep.call(void 0, this.latency);
     for (const { key, value } of writes) {
-      this.kv.set(_chunkGQWOLYBAcjs.keyToHex.call(void 0, key), { key, value });
+      this.kv.set(_chunkOCUQRGRScjs.keyToHex.call(void 0, key), { key, value });
     }
   }
   async setAlarm(workflowId, wakeAt) {
-    await _chunkGQWOLYBAcjs.sleep.call(void 0, this.latency);
+    await _chunkOCUQRGRScjs.sleep.call(void 0, this.latency);
     this.alarms.set(workflowId, wakeAt);
   }
   async clearAlarm(workflowId) {
-    await _chunkGQWOLYBAcjs.sleep.call(void 0, this.latency);
+    await _chunkOCUQRGRScjs.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, _chunkGQWOLYBAcjs.EvictedError)();
+        throw new (0, _chunkOCUQRGRScjs.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 _chunkGQWOLYBAcjs.sleep.call(void 0, Math.max(1, this.latency));
+      await _chunkOCUQRGRScjs.sleep.call(void 0, Math.max(1, this.latency));
     }
   }
   /**
@@ -324,5 +324,5 @@ var InMemoryDriver = (_class = class {constructor() { _class.prototype.__init.ca
 
 
 
-exports.CancelledError = _chunkGQWOLYBAcjs.CancelledError; exports.CriticalError = _chunkGQWOLYBAcjs.CriticalError; exports.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL = _chunkGQWOLYBAcjs.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL; exports.DEFAULT_MAX_RETRIES = _chunkGQWOLYBAcjs.DEFAULT_MAX_RETRIES; exports.DEFAULT_RETRY_BACKOFF_BASE = _chunkGQWOLYBAcjs.DEFAULT_RETRY_BACKOFF_BASE; exports.DEFAULT_RETRY_BACKOFF_MAX = _chunkGQWOLYBAcjs.DEFAULT_RETRY_BACKOFF_MAX; exports.DEFAULT_STEP_TIMEOUT = _chunkGQWOLYBAcjs.DEFAULT_STEP_TIMEOUT; exports.EntryInProgressError = _chunkGQWOLYBAcjs.EntryInProgressError; exports.EvictedError = _chunkGQWOLYBAcjs.EvictedError; exports.HistoryDivergedError = _chunkGQWOLYBAcjs.HistoryDivergedError; exports.InMemoryDriver = InMemoryDriver; exports.JoinError = _chunkGQWOLYBAcjs.JoinError; exports.Loop = _chunkGQWOLYBAcjs.Loop; exports.MessageWaitError = _chunkGQWOLYBAcjs.MessageWaitError; exports.RaceError = _chunkGQWOLYBAcjs.RaceError; exports.RollbackCheckpointError = _chunkGQWOLYBAcjs.RollbackCheckpointError; exports.RollbackError = _chunkGQWOLYBAcjs.RollbackError; exports.SleepError = _chunkGQWOLYBAcjs.SleepError; exports.StepExhaustedError = _chunkGQWOLYBAcjs.StepExhaustedError; exports.StepFailedError = _chunkGQWOLYBAcjs.StepFailedError; exports.WorkflowContextImpl = _chunkGQWOLYBAcjs.WorkflowContextImpl; exports.appendLoopIteration = _chunkGQWOLYBAcjs.appendLoopIteration; exports.appendName = _chunkGQWOLYBAcjs.appendName; exports.createEntry = _chunkGQWOLYBAcjs.createEntry; exports.createHistorySnapshot = _chunkGQWOLYBAcjs.createHistorySnapshot; exports.createStorage = _chunkGQWOLYBAcjs.createStorage; exports.deleteEntriesWithPrefix = _chunkGQWOLYBAcjs.deleteEntriesWithPrefix; exports.emptyLocation = _chunkGQWOLYBAcjs.emptyLocation; exports.extractErrorInfo = _chunkGQWOLYBAcjs.extractErrorInfo; exports.flush = _chunkGQWOLYBAcjs.flush; exports.generateId = _chunkGQWOLYBAcjs.generateId; exports.getEntry = _chunkGQWOLYBAcjs.getEntry; exports.getOrCreateMetadata = _chunkGQWOLYBAcjs.getOrCreateMetadata; exports.isLocationPrefix = _chunkGQWOLYBAcjs.isLocationPrefix; exports.isLoopIterationMarker = _chunkGQWOLYBAcjs.isLoopIterationMarker; exports.loadMetadata = _chunkGQWOLYBAcjs.loadMetadata; exports.loadStorage = _chunkGQWOLYBAcjs.loadStorage; exports.locationToKey = _chunkGQWOLYBAcjs.locationToKey; exports.locationsEqual = _chunkGQWOLYBAcjs.locationsEqual; exports.parentLocation = _chunkGQWOLYBAcjs.parentLocation; exports.registerName = _chunkGQWOLYBAcjs.registerName; exports.replayWorkflowFromStep = _chunkGQWOLYBAcjs.replayWorkflowFromStep; exports.resolveName = _chunkGQWOLYBAcjs.resolveName; exports.runWorkflow = _chunkGQWOLYBAcjs.runWorkflow; exports.setEntry = _chunkGQWOLYBAcjs.setEntry;
+exports.CancelledError = _chunkOCUQRGRScjs.CancelledError; exports.CriticalError = _chunkOCUQRGRScjs.CriticalError; exports.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL = _chunkOCUQRGRScjs.DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL; exports.DEFAULT_MAX_RETRIES = _chunkOCUQRGRScjs.DEFAULT_MAX_RETRIES; exports.DEFAULT_RETRY_BACKOFF_BASE = _chunkOCUQRGRScjs.DEFAULT_RETRY_BACKOFF_BASE; exports.DEFAULT_RETRY_BACKOFF_MAX = _chunkOCUQRGRScjs.DEFAULT_RETRY_BACKOFF_MAX; exports.DEFAULT_STEP_TIMEOUT = _chunkOCUQRGRScjs.DEFAULT_STEP_TIMEOUT; exports.EntryInProgressError = _chunkOCUQRGRScjs.EntryInProgressError; exports.EvictedError = _chunkOCUQRGRScjs.EvictedError; exports.HistoryDivergedError = _chunkOCUQRGRScjs.HistoryDivergedError; exports.InMemoryDriver = InMemoryDriver; exports.JoinError = _chunkOCUQRGRScjs.JoinError; exports.Loop = _chunkOCUQRGRScjs.Loop; exports.MessageWaitError = _chunkOCUQRGRScjs.MessageWaitError; exports.RaceError = _chunkOCUQRGRScjs.RaceError; exports.RollbackCheckpointError = _chunkOCUQRGRScjs.RollbackCheckpointError; exports.RollbackError = _chunkOCUQRGRScjs.RollbackError; exports.SleepError = _chunkOCUQRGRScjs.SleepError; exports.StepExhaustedError = _chunkOCUQRGRScjs.StepExhaustedError; exports.StepFailedError = _chunkOCUQRGRScjs.StepFailedError; exports.WorkflowContextImpl = _chunkOCUQRGRScjs.WorkflowContextImpl; exports.appendLoopIteration = _chunkOCUQRGRScjs.appendLoopIteration; exports.appendName = _chunkOCUQRGRScjs.appendName; exports.createEntry = _chunkOCUQRGRScjs.createEntry; exports.createHistorySnapshot = _chunkOCUQRGRScjs.createHistorySnapshot; exports.createStorage = _chunkOCUQRGRScjs.createStorage; exports.deleteEntriesWithPrefix = _chunkOCUQRGRScjs.deleteEntriesWithPrefix; exports.emptyLocation = _chunkOCUQRGRScjs.emptyLocation; exports.extractErrorInfo = _chunkOCUQRGRScjs.extractErrorInfo; exports.flush = _chunkOCUQRGRScjs.flush; exports.generateId = _chunkOCUQRGRScjs.generateId; exports.getEntry = _chunkOCUQRGRScjs.getEntry; exports.getOrCreateMetadata = _chunkOCUQRGRScjs.getOrCreateMetadata; exports.isLocationPrefix = _chunkOCUQRGRScjs.isLocationPrefix; exports.isLoopIterationMarker = _chunkOCUQRGRScjs.isLoopIterationMarker; exports.loadMetadata = _chunkOCUQRGRScjs.loadMetadata; exports.loadStorage = _chunkOCUQRGRScjs.loadStorage; exports.locationToKey = _chunkOCUQRGRScjs.locationToKey; exports.locationsEqual = _chunkOCUQRGRScjs.locationsEqual; exports.parentLocation = _chunkOCUQRGRScjs.parentLocation; exports.registerName = _chunkOCUQRGRScjs.registerName; exports.replayWorkflowFromStep = _chunkOCUQRGRScjs.replayWorkflowFromStep; exports.resolveName = _chunkOCUQRGRScjs.resolveName; exports.runWorkflow = _chunkOCUQRGRScjs.runWorkflow; exports.setEntry = _chunkOCUQRGRScjs.setEntry;
 //# sourceMappingURL=testing.cjs.map

package/dist/tsup/testing.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rivetkit/workflow-engine",
-	"version": "2.3.2",
+	"version": "2.3.3-rc.2",
 	"description": "Durable workflow engine with reentrant execution",
 	"license": "Apache-2.0",
 	"keywords": [

package/schemas/serde.ts

@@ -307,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,
+				},
+			};
 	}
 }
 
@@ -396,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";
 

package/src/context.ts

@@ -2581,4 +2581,97 @@ export class WorkflowContextImpl implements WorkflowContextInterface {
 		setEntry(this.storage, location, entry);
 		await this.flushStorage();
 	}
+
+	// === Version ===
+
+	async getVersion(name: string, latest: number): Promise<number> {
+		this.assertNotInProgress();
+		this.checkEvicted();
+
+		this.entryInProgress = true;
+		try {
+			return await this.executeGetVersion(name, latest);
+		} finally {
+			this.entryInProgress = false;
+		}
+	}
+
+	private async executeGetVersion(
+		name: string,
+		latest: number,
+	): Promise<number> {
+		if (!Number.isInteger(latest) || latest < 1) {
+			throw new Error(
+				`getVersion("${name}", ${latest}): latest must be an integer >= 1`,
+			);
+		}
+
+		// Check for duplicate name in current execution
+		this.checkDuplicateName(name);
+
+		const location = appendName(this.storage, this.currentLocation, name);
+		const key = locationToKey(this.storage, location);
+		const existing = this.storage.history.entries.get(key);
+
+		// Mark this entry as visited for validateComplete
+		this.markVisited(key);
+
+		this.stopRollbackIfMissing(existing);
+
+		if (existing) {
+			if (existing.kind.type !== "version_check") {
+				throw new HistoryDivergedError(
+					`Expected version_check at ${key}, found ${existing.kind.type}`,
+				);
+			}
+			// Pure replay: this instance is already pinned at this location.
+			return existing.kind.data.resolved;
+		}
+
+		// No recorded version at this location. Decide whether this instance
+		// already executed past this point under older code (old in-flight) or
+		// is reaching it fresh at the live frontier.
+		//
+		// The discriminator is "is there any unvisited history entry under the
+		// current scope?". Entries created earlier in this same run are already
+		// marked visited, so the only unvisited entries under the scope are
+		// leftovers from a prior run, which proves this scope already executed
+		// under code that predates this gate. Such instances resolve to the
+		// implicit floor version 1 (old branch); fresh instances resolve to
+		// `latest`.
+		const resolved = this.hasUnvisitedUnderCurrentScope(key) ? 1 : latest;
+
+		const entry = createEntry(location, {
+			type: "version_check",
+			data: { resolved, latest },
+		});
+		setEntry(this.storage, location, entry);
+		await this.flushStorage();
+
+		return resolved;
+	}
+
+	/**
+	 * 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(excludeKey: string): boolean {
+		const prefix = locationToKey(this.storage, this.currentLocation);
+
+		for (const key of this.storage.history.entries.keys()) {
+			if (key === excludeKey) {
+				continue;
+			}
+			const isUnderPrefix =
+				prefix === ""
+					? true
+					: key.startsWith(`${prefix}/`) || key === prefix;
+			if (isUnderPrefix && !this.visitedKeys.has(key)) {
+				return true;
+			}
+		}
+		return false;
+	}
 }

package/src/types.ts

@@ -135,6 +135,17 @@ export interface RemovedEntry {
 	originalName?: string;
 }
 
+/**
+ * Version check entry data - records which version of a code path this
+ * workflow instance is pinned to at a given location.
+ */
+export 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.
  */
@@ -146,7 +157,8 @@ export type EntryKindType =
 	| "rollback_checkpoint"
 	| "join"
 	| "race"
-	| "removed";
+	| "removed"
+	| "version_check";
 
 /**
  * Type-specific entry data.
@@ -159,7 +171,8 @@ export type EntryKind =
 	| { type: "rollback_checkpoint"; data: RollbackCheckpointEntry }
 	| { type: "join"; data: JoinEntry }
 	| { type: "race"; data: RaceEntry }
-	| { type: "removed"; data: RemovedEntry };
+	| { type: "removed"; data: RemovedEntry }
+	| { type: "version_check"; data: VersionCheckEntry };
 
 /**
  * An entry in the workflow history.
@@ -539,6 +552,8 @@ export interface WorkflowContextInterface {
 
 	removed(name: string, originalType: EntryKindType): Promise<void>;
 
+	getVersion(name: string, latest: number): Promise<number>;
+
 	isEvicted(): boolean;
 }