@rivetkit/workflow-engine 2.3.18 → 2.3.19

package/dist/tsup/index.cjs

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

package/dist/tsup/index.d.cts

@@ -557,6 +557,32 @@ interface KVWrite {
     key: Uint8Array;
     value: Uint8Array;
 }
+/** How one run of the workflow function ended. */
+type WorkflowOutcome = "completed" | "sleeping" | "evicted" | "failed" | "cancelled";
+/** How one step attempt ended. `retry` will be tried again, `failed` will not. */
+type WorkflowStepOutcome = "ok" | "retry" | "failed";
+/** One open run of the workflow function. */
+interface WorkflowSpan {
+    /** Runs `body` attributed to this run. */
+    run<T>(body: () => Promise<T>): Promise<T>;
+    /** Returns nothing when the attempt is not being traced. */
+    startStep(name: string, attempt: number): WorkflowStepSpan | undefined;
+    finish(outcome: WorkflowOutcome): Promise<void>;
+}
+/** One open attempt at one step. */
+interface WorkflowStepSpan {
+    /** Runs `body` attributed to this attempt. */
+    run<T>(body: () => Promise<T>): Promise<T>;
+    /** `error` is what the step callback threw. */
+    finish(outcome: WorkflowStepOutcome, error?: unknown): void;
+}
+/**
+ * Receives the start and end of each workflow run and step attempt. A
+ * completed step replayed from history is not an attempt and is not reported.
+ */
+interface WorkflowTelemetryDriver {
+    startSpan(): Promise<WorkflowSpan>;
+}
 /**
  * The engine driver provides the KV and scheduling interface.
  * Implementations must provide these methods to integrate with different backends.
@@ -638,6 +664,8 @@ interface EngineDriver {
      * Implementations should resolve when any of the specified message names are available.
      */
     waitForMessages(messageNames: string[], abortSignal: AbortSignal): Promise<void>;
+    /** Present when the host traces workflows. */
+    readonly telemetry?: WorkflowTelemetryDriver;
 }
 
 /**
@@ -670,6 +698,7 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
     private abortController;
     private currentLocation;
     private visitedKeys;
+    private runSpan?;
     private mode;
     private rollbackActions?;
     private rollbackCheckpointSet;
@@ -679,7 +708,7 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
     private historyNotifier?;
     private onError?;
     private logger?;
-    constructor(workflowId: string, storage: Storage, driver: EngineDriver, messageDriver: WorkflowMessageDriver, location?: Location, abortController?: AbortController, mode?: "forward" | "rollback", rollbackActions?: RollbackAction[], rollbackCheckpointSet?: boolean, historyNotifier?: () => void, onError?: WorkflowErrorHandler, logger?: Logger, visitedKeys?: Set<string>);
+    constructor(workflowId: string, storage: Storage, driver: EngineDriver, messageDriver: WorkflowMessageDriver, location?: Location, abortController?: AbortController, mode?: "forward" | "rollback", rollbackActions?: RollbackAction[], rollbackCheckpointSet?: boolean, historyNotifier?: () => void, onError?: WorkflowErrorHandler, logger?: Logger, visitedKeys?: Set<string>, runSpan?: WorkflowSpan);
     get abortSignal(): AbortSignal;
     get queue(): WorkflowQueue;
     isEvicted(): boolean;
@@ -1049,4 +1078,4 @@ declare function replayWorkflowFromStep(workflowId: string, driver: EngineDriver
     scheduleAlarm?: boolean;
 }): Promise<WorkflowHistorySnapshot>;
 
-export { type BranchConfig, type BranchOutput, type BranchStatus, type BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, type EngineDriver, type Entry, EntryInProgressError, type EntryKind, type EntryKindType, type EntryMetadata, type EntryStatus, EvictedError, type History, HistoryDivergedError, type JoinEntry, JoinError, type KVEntry, type KVWrite, type Location, Loop, type LoopConfig, type LoopEntry, type LoopIterationMarker, type LoopResult, type Message, type MessageEntry, MessageWaitError, type NameIndex, type PathSegment, type RaceEntry, RaceError, type RemovedEntry, type RollbackCheckpointEntry, RollbackCheckpointError, type RollbackContextInterface, RollbackError, type RunWorkflowOptions, type SleepEntry, SleepError, type SleepState, type StepConfig, type StepEntry, StepExhaustedError, StepFailedError, type Storage, type TryBlockCatchKind, type TryBlockConfig, type TryBlockFailure, type TryBlockResult, type TryStepCatchKind, type TryStepConfig, type TryStepFailure, type TryStepResult, WorkflowContextImpl, type WorkflowContextInterface, type WorkflowEntryMetadataSnapshot, type WorkflowError, type WorkflowErrorEvent, type WorkflowErrorHandler, type WorkflowFunction, type WorkflowHandle, type WorkflowHistoryEntry, type WorkflowHistorySnapshot, type WorkflowMessageDriver, type WorkflowQueue, type WorkflowQueueMessage, type WorkflowQueueNextBatchOptions, type WorkflowQueueNextOptions, type WorkflowResult, type WorkflowRollbackErrorEvent, type WorkflowRunErrorEvent, type WorkflowRunMode, type WorkflowState, type WorkflowStepErrorEvent, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, extractErrorInfo, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, replayWorkflowFromStep, resolveName, runWorkflow, setEntry };
+export { type BranchConfig, type BranchOutput, type BranchStatus, type BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, type EngineDriver, type Entry, EntryInProgressError, type EntryKind, type EntryKindType, type EntryMetadata, type EntryStatus, EvictedError, type History, HistoryDivergedError, type JoinEntry, JoinError, type KVEntry, type KVWrite, type Location, Loop, type LoopConfig, type LoopEntry, type LoopIterationMarker, type LoopResult, type Message, type MessageEntry, MessageWaitError, type NameIndex, type PathSegment, type RaceEntry, RaceError, type RemovedEntry, type RollbackCheckpointEntry, RollbackCheckpointError, type RollbackContextInterface, RollbackError, type RunWorkflowOptions, type SleepEntry, SleepError, type SleepState, type StepConfig, type StepEntry, StepExhaustedError, StepFailedError, type Storage, type TryBlockCatchKind, type TryBlockConfig, type TryBlockFailure, type TryBlockResult, type TryStepCatchKind, type TryStepConfig, type TryStepFailure, type TryStepResult, WorkflowContextImpl, type WorkflowContextInterface, type WorkflowEntryMetadataSnapshot, type WorkflowError, type WorkflowErrorEvent, type WorkflowErrorHandler, type WorkflowFunction, type WorkflowHandle, type WorkflowHistoryEntry, type WorkflowHistorySnapshot, type WorkflowMessageDriver, type WorkflowOutcome, type WorkflowQueue, type WorkflowQueueMessage, type WorkflowQueueNextBatchOptions, type WorkflowQueueNextOptions, type WorkflowResult, type WorkflowRollbackErrorEvent, type WorkflowRunErrorEvent, type WorkflowRunMode, type WorkflowSpan, type WorkflowState, type WorkflowStepErrorEvent, type WorkflowStepOutcome, type WorkflowStepSpan, type WorkflowTelemetryDriver, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, extractErrorInfo, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, replayWorkflowFromStep, resolveName, runWorkflow, setEntry };

package/dist/tsup/index.d.ts

@@ -557,6 +557,32 @@ interface KVWrite {
     key: Uint8Array;
     value: Uint8Array;
 }
+/** How one run of the workflow function ended. */
+type WorkflowOutcome = "completed" | "sleeping" | "evicted" | "failed" | "cancelled";
+/** How one step attempt ended. `retry` will be tried again, `failed` will not. */
+type WorkflowStepOutcome = "ok" | "retry" | "failed";
+/** One open run of the workflow function. */
+interface WorkflowSpan {
+    /** Runs `body` attributed to this run. */
+    run<T>(body: () => Promise<T>): Promise<T>;
+    /** Returns nothing when the attempt is not being traced. */
+    startStep(name: string, attempt: number): WorkflowStepSpan | undefined;
+    finish(outcome: WorkflowOutcome): Promise<void>;
+}
+/** One open attempt at one step. */
+interface WorkflowStepSpan {
+    /** Runs `body` attributed to this attempt. */
+    run<T>(body: () => Promise<T>): Promise<T>;
+    /** `error` is what the step callback threw. */
+    finish(outcome: WorkflowStepOutcome, error?: unknown): void;
+}
+/**
+ * Receives the start and end of each workflow run and step attempt. A
+ * completed step replayed from history is not an attempt and is not reported.
+ */
+interface WorkflowTelemetryDriver {
+    startSpan(): Promise<WorkflowSpan>;
+}
 /**
  * The engine driver provides the KV and scheduling interface.
  * Implementations must provide these methods to integrate with different backends.
@@ -638,6 +664,8 @@ interface EngineDriver {
      * Implementations should resolve when any of the specified message names are available.
      */
     waitForMessages(messageNames: string[], abortSignal: AbortSignal): Promise<void>;
+    /** Present when the host traces workflows. */
+    readonly telemetry?: WorkflowTelemetryDriver;
 }
 
 /**
@@ -670,6 +698,7 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
     private abortController;
     private currentLocation;
     private visitedKeys;
+    private runSpan?;
     private mode;
     private rollbackActions?;
     private rollbackCheckpointSet;
@@ -679,7 +708,7 @@ declare class WorkflowContextImpl implements WorkflowContextInterface {
     private historyNotifier?;
     private onError?;
     private logger?;
-    constructor(workflowId: string, storage: Storage, driver: EngineDriver, messageDriver: WorkflowMessageDriver, location?: Location, abortController?: AbortController, mode?: "forward" | "rollback", rollbackActions?: RollbackAction[], rollbackCheckpointSet?: boolean, historyNotifier?: () => void, onError?: WorkflowErrorHandler, logger?: Logger, visitedKeys?: Set<string>);
+    constructor(workflowId: string, storage: Storage, driver: EngineDriver, messageDriver: WorkflowMessageDriver, location?: Location, abortController?: AbortController, mode?: "forward" | "rollback", rollbackActions?: RollbackAction[], rollbackCheckpointSet?: boolean, historyNotifier?: () => void, onError?: WorkflowErrorHandler, logger?: Logger, visitedKeys?: Set<string>, runSpan?: WorkflowSpan);
     get abortSignal(): AbortSignal;
     get queue(): WorkflowQueue;
     isEvicted(): boolean;
@@ -1049,4 +1078,4 @@ declare function replayWorkflowFromStep(workflowId: string, driver: EngineDriver
     scheduleAlarm?: boolean;
 }): Promise<WorkflowHistorySnapshot>;
 
-export { type BranchConfig, type BranchOutput, type BranchStatus, type BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, type EngineDriver, type Entry, EntryInProgressError, type EntryKind, type EntryKindType, type EntryMetadata, type EntryStatus, EvictedError, type History, HistoryDivergedError, type JoinEntry, JoinError, type KVEntry, type KVWrite, type Location, Loop, type LoopConfig, type LoopEntry, type LoopIterationMarker, type LoopResult, type Message, type MessageEntry, MessageWaitError, type NameIndex, type PathSegment, type RaceEntry, RaceError, type RemovedEntry, type RollbackCheckpointEntry, RollbackCheckpointError, type RollbackContextInterface, RollbackError, type RunWorkflowOptions, type SleepEntry, SleepError, type SleepState, type StepConfig, type StepEntry, StepExhaustedError, StepFailedError, type Storage, type TryBlockCatchKind, type TryBlockConfig, type TryBlockFailure, type TryBlockResult, type TryStepCatchKind, type TryStepConfig, type TryStepFailure, type TryStepResult, WorkflowContextImpl, type WorkflowContextInterface, type WorkflowEntryMetadataSnapshot, type WorkflowError, type WorkflowErrorEvent, type WorkflowErrorHandler, type WorkflowFunction, type WorkflowHandle, type WorkflowHistoryEntry, type WorkflowHistorySnapshot, type WorkflowMessageDriver, type WorkflowQueue, type WorkflowQueueMessage, type WorkflowQueueNextBatchOptions, type WorkflowQueueNextOptions, type WorkflowResult, type WorkflowRollbackErrorEvent, type WorkflowRunErrorEvent, type WorkflowRunMode, type WorkflowState, type WorkflowStepErrorEvent, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, extractErrorInfo, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, replayWorkflowFromStep, resolveName, runWorkflow, setEntry };
+export { type BranchConfig, type BranchOutput, type BranchStatus, type BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, type EngineDriver, type Entry, EntryInProgressError, type EntryKind, type EntryKindType, type EntryMetadata, type EntryStatus, EvictedError, type History, HistoryDivergedError, type JoinEntry, JoinError, type KVEntry, type KVWrite, type Location, Loop, type LoopConfig, type LoopEntry, type LoopIterationMarker, type LoopResult, type Message, type MessageEntry, MessageWaitError, type NameIndex, type PathSegment, type RaceEntry, RaceError, type RemovedEntry, type RollbackCheckpointEntry, RollbackCheckpointError, type RollbackContextInterface, RollbackError, type RunWorkflowOptions, type SleepEntry, SleepError, type SleepState, type StepConfig, type StepEntry, StepExhaustedError, StepFailedError, type Storage, type TryBlockCatchKind, type TryBlockConfig, type TryBlockFailure, type TryBlockResult, type TryStepCatchKind, type TryStepConfig, type TryStepFailure, type TryStepResult, WorkflowContextImpl, type WorkflowContextInterface, type WorkflowEntryMetadataSnapshot, type WorkflowError, type WorkflowErrorEvent, type WorkflowErrorHandler, type WorkflowFunction, type WorkflowHandle, type WorkflowHistoryEntry, type WorkflowHistorySnapshot, type WorkflowMessageDriver, type WorkflowOutcome, type WorkflowQueue, type WorkflowQueueMessage, type WorkflowQueueNextBatchOptions, type WorkflowQueueNextOptions, type WorkflowResult, type WorkflowRollbackErrorEvent, type WorkflowRunErrorEvent, type WorkflowRunMode, type WorkflowSpan, type WorkflowState, type WorkflowStepErrorEvent, type WorkflowStepOutcome, type WorkflowStepSpan, type WorkflowTelemetryDriver, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, extractErrorInfo, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, replayWorkflowFromStep, resolveName, runWorkflow, setEntry };

package/dist/tsup/index.js

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

package/dist/tsup/testing.cjs

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

package/dist/tsup/testing.d.cts

@@ -1,5 +1,5 @@
 import { EngineDriver, WorkflowMessageDriver, KVEntry, KVWrite } from './index.cjs';
-export { BranchConfig, BranchOutput, BranchStatus, BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, Entry, EntryInProgressError, EntryKind, EntryKindType, EntryMetadata, EntryStatus, EvictedError, History, HistoryDivergedError, JoinEntry, JoinError, Location, Loop, LoopConfig, LoopEntry, LoopIterationMarker, LoopResult, Message, MessageEntry, MessageWaitError, NameIndex, PathSegment, RaceEntry, RaceError, RemovedEntry, RollbackCheckpointEntry, RollbackCheckpointError, RollbackContextInterface, RollbackError, RunWorkflowOptions, SleepEntry, SleepError, SleepState, StepConfig, StepEntry, StepExhaustedError, StepFailedError, Storage, TryBlockCatchKind, TryBlockConfig, TryBlockFailure, TryBlockResult, TryStepCatchKind, TryStepConfig, TryStepFailure, TryStepResult, WorkflowContextImpl, WorkflowContextInterface, WorkflowEntryMetadataSnapshot, WorkflowError, WorkflowErrorEvent, WorkflowErrorHandler, WorkflowFunction, WorkflowHandle, WorkflowHistoryEntry, WorkflowHistorySnapshot, WorkflowQueue, WorkflowQueueMessage, WorkflowQueueNextBatchOptions, WorkflowQueueNextOptions, WorkflowResult, WorkflowRollbackErrorEvent, WorkflowRunErrorEvent, WorkflowRunMode, WorkflowState, WorkflowStepErrorEvent, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, extractErrorInfo, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, replayWorkflowFromStep, resolveName, runWorkflow, setEntry } from './index.cjs';
+export { BranchConfig, BranchOutput, BranchStatus, BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, Entry, EntryInProgressError, EntryKind, EntryKindType, EntryMetadata, EntryStatus, EvictedError, History, HistoryDivergedError, JoinEntry, JoinError, Location, Loop, LoopConfig, LoopEntry, LoopIterationMarker, LoopResult, Message, MessageEntry, MessageWaitError, NameIndex, PathSegment, RaceEntry, RaceError, RemovedEntry, RollbackCheckpointEntry, RollbackCheckpointError, RollbackContextInterface, RollbackError, RunWorkflowOptions, SleepEntry, SleepError, SleepState, StepConfig, StepEntry, StepExhaustedError, StepFailedError, Storage, TryBlockCatchKind, TryBlockConfig, TryBlockFailure, TryBlockResult, TryStepCatchKind, TryStepConfig, TryStepFailure, TryStepResult, WorkflowContextImpl, WorkflowContextInterface, WorkflowEntryMetadataSnapshot, WorkflowError, WorkflowErrorEvent, WorkflowErrorHandler, WorkflowFunction, WorkflowHandle, WorkflowHistoryEntry, WorkflowHistorySnapshot, WorkflowOutcome, WorkflowQueue, WorkflowQueueMessage, WorkflowQueueNextBatchOptions, WorkflowQueueNextOptions, WorkflowResult, WorkflowRollbackErrorEvent, WorkflowRunErrorEvent, WorkflowRunMode, WorkflowSpan, WorkflowState, WorkflowStepErrorEvent, WorkflowStepOutcome, WorkflowStepSpan, WorkflowTelemetryDriver, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, extractErrorInfo, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, replayWorkflowFromStep, resolveName, runWorkflow, setEntry } from './index.cjs';
 import 'pino';
 
 /**

package/dist/tsup/testing.d.ts

@@ -1,5 +1,5 @@
 import { EngineDriver, WorkflowMessageDriver, KVEntry, KVWrite } from './index.js';
-export { BranchConfig, BranchOutput, BranchStatus, BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, Entry, EntryInProgressError, EntryKind, EntryKindType, EntryMetadata, EntryStatus, EvictedError, History, HistoryDivergedError, JoinEntry, JoinError, Location, Loop, LoopConfig, LoopEntry, LoopIterationMarker, LoopResult, Message, MessageEntry, MessageWaitError, NameIndex, PathSegment, RaceEntry, RaceError, RemovedEntry, RollbackCheckpointEntry, RollbackCheckpointError, RollbackContextInterface, RollbackError, RunWorkflowOptions, SleepEntry, SleepError, SleepState, StepConfig, StepEntry, StepExhaustedError, StepFailedError, Storage, TryBlockCatchKind, TryBlockConfig, TryBlockFailure, TryBlockResult, TryStepCatchKind, TryStepConfig, TryStepFailure, TryStepResult, WorkflowContextImpl, WorkflowContextInterface, WorkflowEntryMetadataSnapshot, WorkflowError, WorkflowErrorEvent, WorkflowErrorHandler, WorkflowFunction, WorkflowHandle, WorkflowHistoryEntry, WorkflowHistorySnapshot, WorkflowQueue, WorkflowQueueMessage, WorkflowQueueNextBatchOptions, WorkflowQueueNextOptions, WorkflowResult, WorkflowRollbackErrorEvent, WorkflowRunErrorEvent, WorkflowRunMode, WorkflowState, WorkflowStepErrorEvent, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, extractErrorInfo, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, replayWorkflowFromStep, resolveName, runWorkflow, setEntry } from './index.js';
+export { BranchConfig, BranchOutput, BranchStatus, BranchStatusType, CancelledError, CriticalError, DEFAULT_LOOP_HISTORY_PRUNE_INTERVAL, DEFAULT_MAX_RETRIES, DEFAULT_RETRY_BACKOFF_BASE, DEFAULT_RETRY_BACKOFF_MAX, DEFAULT_STEP_TIMEOUT, Entry, EntryInProgressError, EntryKind, EntryKindType, EntryMetadata, EntryStatus, EvictedError, History, HistoryDivergedError, JoinEntry, JoinError, Location, Loop, LoopConfig, LoopEntry, LoopIterationMarker, LoopResult, Message, MessageEntry, MessageWaitError, NameIndex, PathSegment, RaceEntry, RaceError, RemovedEntry, RollbackCheckpointEntry, RollbackCheckpointError, RollbackContextInterface, RollbackError, RunWorkflowOptions, SleepEntry, SleepError, SleepState, StepConfig, StepEntry, StepExhaustedError, StepFailedError, Storage, TryBlockCatchKind, TryBlockConfig, TryBlockFailure, TryBlockResult, TryStepCatchKind, TryStepConfig, TryStepFailure, TryStepResult, WorkflowContextImpl, WorkflowContextInterface, WorkflowEntryMetadataSnapshot, WorkflowError, WorkflowErrorEvent, WorkflowErrorHandler, WorkflowFunction, WorkflowHandle, WorkflowHistoryEntry, WorkflowHistorySnapshot, WorkflowOutcome, WorkflowQueue, WorkflowQueueMessage, WorkflowQueueNextBatchOptions, WorkflowQueueNextOptions, WorkflowResult, WorkflowRollbackErrorEvent, WorkflowRunErrorEvent, WorkflowRunMode, WorkflowSpan, WorkflowState, WorkflowStepErrorEvent, WorkflowStepOutcome, WorkflowStepSpan, WorkflowTelemetryDriver, appendLoopIteration, appendName, createEntry, createHistorySnapshot, createStorage, deleteEntriesWithPrefix, emptyLocation, extractErrorInfo, flush, generateId, getEntry, getOrCreateMetadata, isLocationPrefix, isLoopIterationMarker, loadMetadata, loadStorage, locationToKey, locationsEqual, parentLocation, registerName, replayWorkflowFromStep, resolveName, runWorkflow, setEntry } from './index.js';
 import 'pino';
 
 /**

package/dist/tsup/testing.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rivetkit/workflow-engine",
-	"version": "2.3.18",
+	"version": "2.3.19",
 	"description": "Durable workflow engine with reentrant execution",
 	"license": "Apache-2.0",
 	"keywords": [

package/src/context.ts

@@ -1,5 +1,5 @@
 import type { Logger } from "pino";
-import type { EngineDriver } from "./driver.js";
+import type { EngineDriver, WorkflowSpan } from "./driver.js";
 import {
 	extractErrorInfo,
 	getErrorEventTag,
@@ -345,6 +345,7 @@ export class WorkflowContextImpl implements WorkflowContextInterface {
 	private abortController: AbortController;
 	private currentLocation: Location;
 	private visitedKeys: Set<string>;
+	private runSpan?: WorkflowSpan;
 	private mode: "forward" | "rollback";
 	private rollbackActions?: RollbackAction[];
 	private rollbackCheckpointSet: boolean;
@@ -369,6 +370,7 @@ export class WorkflowContextImpl implements WorkflowContextInterface {
 		onError?: WorkflowErrorHandler,
 		logger?: Logger,
 		visitedKeys?: Set<string>,
+		runSpan?: WorkflowSpan,
 	) {
 		this.currentLocation = location;
 		this.abortController = abortController ?? new AbortController();
@@ -379,6 +381,7 @@ export class WorkflowContextImpl implements WorkflowContextInterface {
 		this.onError = onError;
 		this.logger = logger;
 		this.visitedKeys = visitedKeys ?? new Set();
+		this.runSpan = runSpan;
 	}
 
 	get abortSignal(): AbortSignal {
@@ -435,6 +438,7 @@ export class WorkflowContextImpl implements WorkflowContextInterface {
 			this.onError,
 			this.logger,
 			this.visitedKeys,
+			this.runSpan,
 		);
 	}
 
@@ -906,10 +910,15 @@ export class WorkflowContextImpl implements WorkflowContextInterface {
 		// Get timeout configuration
 		const timeout = config.timeout ?? DEFAULT_STEP_TIMEOUT;
 
+		const stepSpan = this.runSpan?.startStep(
+			config.name,
+			metadata.attempts,
+		);
+
 		try {
 			// Execute with timeout
 			const output = await this.executeWithTimeout(
-				config.run(),
+				stepSpan ? stepSpan.run(() => config.run()) : config.run(),
 				timeout,
 				config.name,
 			);
@@ -936,6 +945,7 @@ export class WorkflowContextImpl implements WorkflowContextInterface {
 				await this.flushStorage();
 			}
 
+			stepSpan?.finish("ok");
 			this.log("debug", {
 				msg: "step completed",
 				step: config.name,
@@ -951,6 +961,7 @@ export class WorkflowContextImpl implements WorkflowContextInterface {
 			// Timeout errors are treated as critical by default. Steps opt
 			// into retrying on timeout with retryOnTimeout: true.
 			if (error instanceof StepTimeoutError && !config.retryOnTimeout) {
+				stepSpan?.finish("failed", error);
 				metadata.status = "exhausted";
 				metadata.error = String(error);
 				await this.notifyStepError(config, metadata.attempts, error, {
@@ -970,6 +981,7 @@ export class WorkflowContextImpl implements WorkflowContextInterface {
 				error instanceof CriticalError ||
 				error instanceof RollbackError
 			) {
+				stepSpan?.finish("failed", error);
 				metadata.status = "exhausted";
 				metadata.error = String(error);
 				await this.notifyStepError(config, metadata.attempts, error, {
@@ -989,6 +1001,7 @@ export class WorkflowContextImpl implements WorkflowContextInterface {
 			}
 
 			const willRetry = metadata.attempts <= maxRetries;
+			stepSpan?.finish(willRetry ? "retry" : "failed", error);
 			metadata.status = willRetry ? "failed" : "exhausted";
 			metadata.error = String(error);
 

package/src/driver.ts

@@ -16,6 +16,42 @@ export interface KVWrite {
 	value: Uint8Array;
 }
 
+/** How one run of the workflow function ended. */
+export type WorkflowOutcome =
+	| "completed"
+	| "sleeping"
+	| "evicted"
+	| "failed"
+	| "cancelled";
+
+/** How one step attempt ended. `retry` will be tried again, `failed` will not. */
+export type WorkflowStepOutcome = "ok" | "retry" | "failed";
+
+/** One open run of the workflow function. */
+export interface WorkflowSpan {
+	/** Runs `body` attributed to this run. */
+	run<T>(body: () => Promise<T>): Promise<T>;
+	/** Returns nothing when the attempt is not being traced. */
+	startStep(name: string, attempt: number): WorkflowStepSpan | undefined;
+	finish(outcome: WorkflowOutcome): Promise<void>;
+}
+
+/** One open attempt at one step. */
+export interface WorkflowStepSpan {
+	/** Runs `body` attributed to this attempt. */
+	run<T>(body: () => Promise<T>): Promise<T>;
+	/** `error` is what the step callback threw. */
+	finish(outcome: WorkflowStepOutcome, error?: unknown): void;
+}
+
+/**
+ * Receives the start and end of each workflow run and step attempt. A
+ * completed step replayed from history is not an attempt and is not reported.
+ */
+export interface WorkflowTelemetryDriver {
+	startSpan(): Promise<WorkflowSpan>;
+}
+
 /**
  * The engine driver provides the KV and scheduling interface.
  * Implementations must provide these methods to integrate with different backends.
@@ -117,4 +153,7 @@ export interface EngineDriver {
 		messageNames: string[],
 		abortSignal: AbortSignal,
 	): Promise<void>;
+
+	/** Present when the host traces workflows. */
+	readonly telemetry?: WorkflowTelemetryDriver;
 }