@osolmaz/pi-workflows 0.12.0 → 0.13.0

package/src/workflows/errors.ts

@@ -16,9 +16,9 @@ export class CancelledError extends Error {
 }
 
 /**
- * Thrown when a runner writes to a run bundle after losing its queue claim.
+ * Thrown when a runner writes to a SQLite run state after losing its queue claim.
  * The current claim holder owns the run from that point on, so the fenced
- * writer must stop touching the bundle immediately.
+ * writer must stop changing the run immediately.
  */
 export class ClaimLostError extends Error {
   readonly runId: string;
@@ -32,7 +32,7 @@ export class ClaimLostError extends Error {
 
 /**
  * Internal stop signal for close-to-park: the engine halts without writing
- * a terminal event, leaving a resumable bundle for the next claim holder.
+ * a terminal event, leaving resumable state for the next claim holder.
  */
 export class RunParkedError extends Error {
   constructor() {
@@ -56,6 +56,30 @@ export class WorkflowSourceChangedError extends Error {
   }
 }
 
+/** A built-in revision is unavailable, so its incompatible run must restart. */
+export class BuiltinWorkflowRevisionChangedError extends Error {
+  readonly runId: string;
+  readonly workflowId: string;
+  readonly previousRevision: string;
+  readonly currentRevision: string;
+
+  constructor(options: {
+    runId: string;
+    workflowId: string;
+    previousRevision: string;
+    currentRevision: string;
+  }) {
+    super(
+      `Built-in workflow ${options.workflowId} revision ${options.previousRevision} cannot resume run ${options.runId} with installed revision ${options.currentRevision}; cancel run ${options.runId}, then start ${options.workflowId} again`,
+    );
+    this.name = "BuiltinWorkflowRevisionChangedError";
+    this.runId = options.runId;
+    this.workflowId = options.workflowId;
+    this.previousRevision = options.previousRevision;
+    this.currentRevision = options.currentRevision;
+  }
+}
+
 export function isClaimLostError(error: unknown): error is ClaimLostError {
   return error instanceof ClaimLostError;
 }