@lostgradient/weft 0.23.1 → 0.24.1

package/dist/cli/generated/operation-client.generated.d.ts

@@ -1,7 +1,7 @@
 import { type CatalogWeftClient, type WeftClientConnection } from '../operation-client-runtime.ts';
-export declare const CATALOG_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.principal", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.get", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.diagnostics", "weft.workers.drain", "weft.workers.list", "weft.workers.rejections", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
+export declare const CATALOG_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.catalog.diagnostics", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.principal", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.get", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.diagnostics", "weft.workers.drain", "weft.workers.list", "weft.workers.rejections", "weft.workers.resume", "weft.workflows.active.get", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.revisions.activate", "weft.workflows.revisions.get", "weft.workflows.revisions.install", "weft.workflows.revisions.list", "weft.workflows.revisions.preload", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
 export type CatalogOperationName = (typeof CATALOG_OPERATION_NAMES)[number];
-export declare const CLIENT_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.principal", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.diagnostics.deadletters.clear", "weft.tasks.get", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.diagnostics", "weft.workers.drain", "weft.workers.list", "weft.workers.rejections", "weft.workers.resume", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
+export declare const CLIENT_OPERATION_NAMES: readonly ["weft.activities.complete", "weft.activities.fail", "weft.alerts.list", "weft.catalog.diagnostics", "weft.recover.all", "weft.retention.get", "weft.reviews.decision.submit", "weft.reviews.get", "weft.reviews.list", "weft.schedules.cancel", "weft.schedules.create", "weft.schedules.get", "weft.schedules.list", "weft.schedules.pause", "weft.schedules.resume", "weft.schedules.update", "weft.storage.capabilities", "weft.system.lease", "weft.system.metrics", "weft.system.principal", "weft.system.registry", "weft.task.queues.list", "weft.tasks.diagnostics", "weft.tasks.diagnostics.deadletters.clear", "weft.tasks.get", "weft.updates.result.get", "weft.worker.deployments.drain", "weft.worker.deployments.resume", "weft.workers.diagnostics", "weft.workers.drain", "weft.workers.list", "weft.workers.rejections", "weft.workers.resume", "weft.workflows.active.get", "weft.workflows.activities.pending.list", "weft.workflows.aggregate", "weft.workflows.attributes.get", "weft.workflows.attributes.set", "weft.workflows.bulk.cancel", "weft.workflows.bulk.delete", "weft.workflows.bulk.retryfailed", "weft.workflows.bulk.signal", "weft.workflows.bulk.tags", "weft.workflows.cancel", "weft.workflows.checkpoints.get", "weft.workflows.checkpoints.list", "weft.workflows.events.list", "weft.workflows.finalizer.get", "weft.workflows.fork", "weft.workflows.get", "weft.workflows.list", "weft.workflows.purge", "weft.workflows.query", "weft.workflows.replay", "weft.workflows.result.get", "weft.workflows.resume", "weft.workflows.revisions.activate", "weft.workflows.revisions.get", "weft.workflows.revisions.install", "weft.workflows.revisions.list", "weft.workflows.revisions.preload", "weft.workflows.scheduleprovenance.get", "weft.workflows.signal", "weft.workflows.start", "weft.workflows.startorsignal", "weft.workflows.streams.chunks", "weft.workflows.suspend", "weft.workflows.tags.add", "weft.workflows.tags.remove", "weft.workflows.timeline.get", "weft.workflows.timeout", "weft.workflows.update"];
 export type ClientOperationName = (typeof CLIENT_OPERATION_NAMES)[number];
 export declare const CLIENT_REST_OPERATION_BINDINGS: {
     readonly 'weft.tasks.diagnostics.deadletters.clear': {
@@ -19,6 +19,27 @@ export declare const CLIENT_REST_OPERATION_BINDINGS: {
         };
     };
 };
+type SharedActivityContractHashArti_d7d91df4 = {
+    readonly activityContractHash?: string;
+    readonly artifactDigest?: string;
+    readonly buildId?: string;
+    readonly deploymentName?: string;
+    readonly workflowRevision?: string;
+};
+type SharedAffectedWorkersDeploymen_e4c61ae8 = {
+    readonly affectedWorkers: number;
+    readonly deploymentName: string;
+    readonly health: 'active' | 'draining' | 'drained';
+    readonly inFlight: number;
+    readonly target: 'deployment';
+};
+type SharedAffectedWorkersHealthInF_c3f6ebcc = {
+    readonly affectedWorkers: number;
+    readonly health: 'active' | 'draining' | 'drained';
+    readonly inFlight: number;
+    readonly target: 'worker';
+    readonly workerId: string;
+};
 type SharedAttributesBulkConcurrenc_0f0d07d6 = {
     readonly attributes?: ReadonlyArray<SharedGtGteKey_e658e64c>;
     readonly bulkConcurrency?: number;
@@ -55,6 +76,13 @@ type SharedAttributesCreatedAtExecu_47f8e20e = {
     readonly type?: string;
     readonly updatedAt?: SharedGtGteLt_d9a61361;
 };
+type SharedBackoffMultiplierInitial_64d024ea = {
+    readonly backoffMultiplier: number;
+    readonly initialBackoff: number | string;
+    readonly maxAttempts: number;
+    readonly maxBackoff: number | string;
+    readonly nonRetryableErrors?: ReadonlyArray<string>;
+};
 type SharedGtGteKey_e658e64c = {
     readonly gt?: unknown;
     readonly gte?: unknown;
@@ -106,6 +134,38 @@ export type ClientOperationTypes = {
         };
         readonly faults: never;
     };
+    'weft.catalog.diagnostics': {
+        readonly input: {
+            readonly name: string;
+            readonly revision: string;
+        };
+        readonly output: {
+            readonly active: boolean;
+            readonly activeRevision?: string;
+            readonly installed: boolean;
+            readonly name: string;
+            readonly references: {
+                readonly activeExecutionRealms: number;
+                readonly inFlightStarts: number;
+                readonly nonTerminalRuns: number;
+                readonly pendingDispatches: number;
+                readonly pinnedSchedules: number;
+                readonly registeredDefinitions: number;
+                readonly retainedRecoveryRecords: number;
+            };
+            readonly removable: boolean;
+            readonly revision: string;
+            readonly source?: {
+                readonly kind: 'module';
+                readonly lastFailureCategory?: 'application' | 'timeout' | 'cancellation' | 'resource' | 'system';
+                readonly loadDurationMs?: number;
+                readonly requestedRevision: string;
+                readonly state: 'idle' | 'loading' | 'ready' | 'failed' | 'cancelled';
+                readonly waiterCount: number;
+            };
+        };
+        readonly faults: never;
+    };
     'weft.recover.all': {
         readonly input: {};
         readonly output: {
@@ -195,6 +255,7 @@ export type ClientOperationTypes = {
             readonly input?: unknown;
             readonly jitter?: unknown;
             readonly overlap?: unknown;
+            readonly revisionPolicy?: unknown;
             readonly type: unknown;
         };
         readonly output: {
@@ -241,6 +302,7 @@ export type ClientOperationTypes = {
             readonly every?: unknown;
             readonly jitter?: unknown;
             readonly overlap?: unknown;
+            readonly revisionPolicy?: unknown;
             readonly scheduleId: string;
         };
         readonly output: null;
@@ -290,9 +352,11 @@ export type ClientOperationTypes = {
     'weft.system.registry': {
         readonly input: {};
         readonly output: {
+            readonly activeRevisions: unknown;
             readonly activities: unknown;
-            readonly registryVersion: 1;
-            readonly workflows: unknown;
+            readonly generatedAt: string;
+            readonly registryVersion: 2;
+            readonly workflows: ReadonlyArray<unknown>;
         };
         readonly faults: never;
     };
@@ -391,7 +455,220 @@ export type ClientOperationTypes = {
         readonly input: {
             readonly operationId: string;
         };
-        readonly output: unknown;
+        readonly output: {
+            readonly activityName: string;
+            readonly attempt: number;
+            readonly availableAt: number;
+            readonly createdAt: number;
+            readonly executionRequirement?: SharedActivityContractHashArti_d7d91df4;
+            readonly fairShareKey?: string;
+            readonly firstQueuedAt: number;
+            readonly headerKeys: ReadonlyArray<string>;
+            readonly lastDispatchedAt?: number;
+            readonly lastQueuedAt: number;
+            readonly lastRequeueReason?: string;
+            readonly operationId: string;
+            readonly priority?: number;
+            readonly queue: string;
+            readonly requeueCount: number;
+            readonly retryCount: number;
+            readonly retryPolicy?: SharedBackoffMultiplierInitial_64d024ea;
+            readonly scheduleToCloseDeadline?: number;
+            readonly startedAt?: number;
+            readonly state: 'queued';
+            readonly stickyWorkflowId?: string;
+            readonly visibilityTimeoutMilliseconds: number;
+            readonly workflowExecutionToken?: string;
+            readonly workflowId?: string;
+            readonly workflowRevision?: string;
+            readonly workflowType: string;
+        } | {
+            readonly activityName: string;
+            readonly attempt: number;
+            readonly createdAt: number;
+            readonly executionRequirement?: SharedActivityContractHashArti_d7d91df4;
+            readonly fairShareKey?: string;
+            readonly firstQueuedAt: number;
+            readonly headerKeys: ReadonlyArray<string>;
+            readonly lastHeartbeatAt: number;
+            readonly lastQueuedAt: number;
+            readonly lastRequeueReason?: string;
+            readonly leaseDeadline: number;
+            readonly operationId: string;
+            readonly priority?: number;
+            readonly queue: string;
+            readonly requeueCount: number;
+            readonly retryCount: number;
+            readonly retryPolicy?: SharedBackoffMultiplierInitial_64d024ea;
+            readonly scheduleToCloseDeadline?: number;
+            readonly startedAt: number;
+            readonly state: 'leased';
+            readonly stickyWorkflowId?: string;
+            readonly visibilityTimeoutMilliseconds: number;
+            readonly workflowExecutionToken?: string;
+            readonly workflowId?: string;
+            readonly workflowRevision?: string;
+            readonly workflowType: string;
+        } | {
+            readonly activityName: string;
+            readonly attempt: number;
+            readonly createdAt: number;
+            readonly executionRequirement?: SharedActivityContractHashArti_d7d91df4;
+            readonly fairShareKey?: string;
+            readonly firstQueuedAt: number;
+            readonly headerKeys: ReadonlyArray<string>;
+            readonly lastHeartbeatAt: number;
+            readonly lastQueuedAt: number;
+            readonly lastRequeueReason?: string;
+            readonly leaseDeadline: number;
+            readonly operationId: string;
+            readonly pendingStatus: 'completed' | 'failed';
+            readonly priority?: number;
+            readonly queue: string;
+            readonly requeueCount: number;
+            readonly resultDigest: string;
+            readonly retryCount: number;
+            readonly retryPolicy?: SharedBackoffMultiplierInitial_64d024ea;
+            readonly scheduleToCloseDeadline?: number;
+            readonly startedAt: number;
+            readonly state: 'completing';
+            readonly stickyWorkflowId?: string;
+            readonly visibilityTimeoutMilliseconds: number;
+            readonly workflowExecutionToken?: string;
+            readonly workflowId?: string;
+            readonly workflowRevision?: string;
+            readonly workflowType: string;
+        } | {
+            readonly activityName: string;
+            readonly attempt: number;
+            readonly cancellationReason: string;
+            readonly cancellationRequestedAt: number;
+            readonly createdAt: number;
+            readonly executionRequirement?: SharedActivityContractHashArti_d7d91df4;
+            readonly fairShareKey?: string;
+            readonly firstQueuedAt: number;
+            readonly headerKeys: ReadonlyArray<string>;
+            readonly lastHeartbeatAt: number;
+            readonly lastQueuedAt: number;
+            readonly lastRequeueReason?: string;
+            readonly leaseDeadline: number;
+            readonly operationId: string;
+            readonly priority?: number;
+            readonly queue: string;
+            readonly requeueCount: number;
+            readonly retryCount: number;
+            readonly retryPolicy?: SharedBackoffMultiplierInitial_64d024ea;
+            readonly scheduleToCloseDeadline?: number;
+            readonly startedAt: number;
+            readonly state: 'cancelling';
+            readonly stickyWorkflowId?: string;
+            readonly visibilityTimeoutMilliseconds: number;
+            readonly workflowExecutionToken?: string;
+            readonly workflowId?: string;
+            readonly workflowRevision?: string;
+            readonly workflowType: string;
+        } | {
+            readonly activityName: string;
+            readonly adopted: boolean;
+            readonly adoptedAt?: number;
+            readonly attempt: number;
+            readonly createdAt: number;
+            readonly disposition: 'resolved';
+            readonly error?: string;
+            readonly executionRequirement?: SharedActivityContractHashArti_d7d91df4;
+            readonly fairShareKey?: string;
+            readonly headerKeys: ReadonlyArray<string>;
+            readonly operationId: string;
+            readonly priority?: number;
+            readonly queue: string;
+            readonly resultDigest: string;
+            readonly resultStatus: 'completed' | 'failed';
+            readonly retryPolicy?: SharedBackoffMultiplierInitial_64d024ea;
+            readonly scheduleToCloseDeadline?: number;
+            readonly state: 'terminal';
+            readonly stickyWorkflowId?: string;
+            readonly terminalAt: number;
+            readonly visibilityTimeoutMilliseconds: number;
+            readonly workflowExecutionToken?: string;
+            readonly workflowId?: string;
+            readonly workflowRevision?: string;
+            readonly workflowType: string;
+        } | {
+            readonly activityName: string;
+            readonly adopted: boolean;
+            readonly adoptedAt?: number;
+            readonly attempt: number;
+            readonly cancellationReason: string;
+            readonly createdAt: number;
+            readonly disposition: 'cancelled';
+            readonly executionRequirement?: SharedActivityContractHashArti_d7d91df4;
+            readonly fairShareKey?: string;
+            readonly headerKeys: ReadonlyArray<string>;
+            readonly operationId: string;
+            readonly priority?: number;
+            readonly queue: string;
+            readonly retryPolicy?: SharedBackoffMultiplierInitial_64d024ea;
+            readonly scheduleToCloseDeadline?: number;
+            readonly state: 'terminal';
+            readonly stickyWorkflowId?: string;
+            readonly terminalAt: number;
+            readonly visibilityTimeoutMilliseconds: number;
+            readonly workflowExecutionToken?: string;
+            readonly workflowId?: string;
+            readonly workflowRevision?: string;
+            readonly workflowType: string;
+        } | {
+            readonly activityName: string;
+            readonly adopted: boolean;
+            readonly adoptedAt?: number;
+            readonly attempt: number;
+            readonly createdAt: number;
+            readonly disposition: 'retryExhausted';
+            readonly error: string;
+            readonly executionRequirement?: SharedActivityContractHashArti_d7d91df4;
+            readonly fairShareKey?: string;
+            readonly headerKeys: ReadonlyArray<string>;
+            readonly operationId: string;
+            readonly priority?: number;
+            readonly queue: string;
+            readonly retryPolicy?: SharedBackoffMultiplierInitial_64d024ea;
+            readonly scheduleToCloseDeadline?: number;
+            readonly state: 'terminal';
+            readonly stickyWorkflowId?: string;
+            readonly terminalAt: number;
+            readonly visibilityTimeoutMilliseconds: number;
+            readonly workflowExecutionToken?: string;
+            readonly workflowId?: string;
+            readonly workflowRevision?: string;
+            readonly workflowType: string;
+        } | {
+            readonly activityName: string;
+            readonly attempt: number;
+            readonly createdAt: number;
+            readonly deadLetteredAt: number;
+            readonly error?: string;
+            readonly executionRequirement?: SharedActivityContractHashArti_d7d91df4;
+            readonly fairShareKey?: string;
+            readonly headerKeys: ReadonlyArray<string>;
+            readonly lastRequeueReason?: string;
+            readonly operationId: string;
+            readonly pendingStatus: 'completed' | 'failed';
+            readonly persistenceFailureReason: string;
+            readonly priority?: number;
+            readonly queue: string;
+            readonly requeueCount: number;
+            readonly resultDigest: string;
+            readonly retryCount: number;
+            readonly retryPolicy?: SharedBackoffMultiplierInitial_64d024ea;
+            readonly scheduleToCloseDeadline?: number;
+            readonly state: 'deadLettered';
+            readonly stickyWorkflowId?: string;
+            readonly visibilityTimeoutMilliseconds: number;
+            readonly workflowExecutionToken?: string;
+            readonly workflowId?: string;
+            readonly workflowRevision?: string;
+            readonly workflowType: string;
+        };
         readonly faults: 'NotFound';
     };
     'weft.updates.result.get': {
@@ -406,14 +683,14 @@ export type ClientOperationTypes = {
             readonly deploymentName: string;
             readonly reason?: string;
         };
-        readonly output: unknown;
+        readonly output: SharedAffectedWorkersHealthInF_c3f6ebcc | SharedAffectedWorkersDeploymen_e4c61ae8;
         readonly faults: never;
     };
     'weft.worker.deployments.resume': {
         readonly input: {
             readonly deploymentName: string;
         };
-        readonly output: unknown;
+        readonly output: SharedAffectedWorkersHealthInF_c3f6ebcc | SharedAffectedWorkersDeploymen_e4c61ae8;
         readonly faults: never;
     };
     'weft.workers.diagnostics': {
@@ -452,7 +729,7 @@ export type ClientOperationTypes = {
             readonly reason?: string;
             readonly workerId: string;
         };
-        readonly output: unknown;
+        readonly output: SharedAffectedWorkersHealthInF_c3f6ebcc | SharedAffectedWorkersDeploymen_e4c61ae8;
         readonly faults: 'NotFound';
     };
     'weft.workers.list': {
@@ -512,9 +789,16 @@ export type ClientOperationTypes = {
         readonly input: {
             readonly workerId: string;
         };
-        readonly output: unknown;
+        readonly output: SharedAffectedWorkersHealthInF_c3f6ebcc | SharedAffectedWorkersDeploymen_e4c61ae8;
         readonly faults: 'NotFound';
     };
+    'weft.workflows.active.get': {
+        readonly input: {
+            readonly name: unknown;
+        };
+        readonly output: unknown;
+        readonly faults: 'InvalidParams' | 'NotFound';
+    };
     'weft.workflows.activities.pending.list': {
         readonly input: {
             readonly cursor?: string;
@@ -667,7 +951,23 @@ export type ClientOperationTypes = {
         readonly input: {
             readonly workflowId: string;
         };
-        readonly output: unknown;
+        readonly output: {
+            readonly attempts: number;
+            readonly status: 'pending';
+        } | {
+            readonly attempts: number;
+            readonly startedAt: number;
+            readonly status: 'running';
+        } | {
+            readonly attempts: number;
+            readonly completedAt: number;
+            readonly status: 'succeeded';
+        } | {
+            readonly attempts: number;
+            readonly error: string;
+            readonly failedAt: number;
+            readonly status: 'failed';
+        } | null;
         readonly faults: never;
     };
     'weft.workflows.fork': {
@@ -746,6 +1046,46 @@ export type ClientOperationTypes = {
         };
         readonly faults: 'Conflict' | 'NotFound';
     };
+    'weft.workflows.revisions.activate': {
+        readonly input: {
+            readonly expectedGeneration?: unknown;
+            readonly name: unknown;
+            readonly policy?: unknown;
+            readonly revision: unknown;
+        };
+        readonly output: unknown;
+        readonly faults: 'Conflict' | 'InvalidParams' | 'NotFound';
+    };
+    'weft.workflows.revisions.get': {
+        readonly input: {
+            readonly name: unknown;
+            readonly revision: unknown;
+        };
+        readonly output: unknown;
+        readonly faults: 'InvalidParams' | 'NotFound';
+    };
+    'weft.workflows.revisions.install': {
+        readonly input: {
+            readonly manifest: unknown;
+        };
+        readonly output: unknown;
+        readonly faults: 'Conflict' | 'InvalidParams';
+    };
+    'weft.workflows.revisions.list': {
+        readonly input: {
+            readonly name: unknown;
+        };
+        readonly output: unknown;
+        readonly faults: 'InvalidParams';
+    };
+    'weft.workflows.revisions.preload': {
+        readonly input: {
+            readonly name: unknown;
+            readonly revision: unknown;
+        };
+        readonly output: unknown;
+        readonly faults: 'Conflict' | 'InvalidParams' | 'NotFound';
+    };
     'weft.workflows.scheduleprovenance.get': {
         readonly input: {
             readonly workflowId: string;

package/dist/cli/generated/operation-client.generated.js

@@ -6,6 +6,7 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.activities.complete",
   "weft.activities.fail",
   "weft.alerts.list",
+  "weft.catalog.diagnostics",
   "weft.recover.all",
   "weft.retention.get",
   "weft.reviews.decision.submit",
@@ -34,6 +35,7 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.workers.list",
   "weft.workers.rejections",
   "weft.workers.resume",
+  "weft.workflows.active.get",
   "weft.workflows.activities.pending.list",
   "weft.workflows.aggregate",
   "weft.workflows.attributes.get",
@@ -56,6 +58,11 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.workflows.replay",
   "weft.workflows.result.get",
   "weft.workflows.resume",
+  "weft.workflows.revisions.activate",
+  "weft.workflows.revisions.get",
+  "weft.workflows.revisions.install",
+  "weft.workflows.revisions.list",
+  "weft.workflows.revisions.preload",
   "weft.workflows.scheduleprovenance.get",
   "weft.workflows.signal",
   "weft.workflows.start",
@@ -71,6 +78,7 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.activities.complete",
   "weft.activities.fail",
   "weft.alerts.list",
+  "weft.catalog.diagnostics",
   "weft.recover.all",
   "weft.retention.get",
   "weft.reviews.decision.submit",
@@ -100,6 +108,7 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.workers.list",
   "weft.workers.rejections",
   "weft.workers.resume",
+  "weft.workflows.active.get",
   "weft.workflows.activities.pending.list",
   "weft.workflows.aggregate",
   "weft.workflows.attributes.get",
@@ -122,6 +131,11 @@ export const CATALOG_OPERATION_NAMES = [
   "weft.workflows.replay",
   "weft.workflows.result.get",
   "weft.workflows.resume",
+  "weft.workflows.revisions.activate",
+  "weft.workflows.revisions.get",
+  "weft.workflows.revisions.install",
+  "weft.workflows.revisions.list",
+  "weft.workflows.revisions.preload",
   "weft.workflows.scheduleprovenance.get",
   "weft.workflows.signal",
   "weft.workflows.start",

package/dist/cli/output.js

@@ -54,7 +54,7 @@ export function truncateToWidth(value, width) {
 export async function confirmDestructive(options) {
   if (options.assumeYes)
     return "confirmed";
-  if (!(options.isTty ?? Boolean(process.stdin.isTTY)))
+  if (!(options.isTty ?? process.stdin.isTTY))
     return "non-interactive";
   const readLine = options.readLine ?? defaultReadLine;
   process.stdout.write(`${options.prompt} [y/N] `);

package/dist/cli/parse-schedule-arguments.js

@@ -1,6 +1,6 @@
 import { parseArgs } from "node:util";
 import { parsePersistentStorageBackend } from "./storage-backend-arguments.js";
-const SCHEDULE_ACTIONS = new Set(["list", "create", "pause", "resume", "cancel"]), VALID_SCHEDULE_OVERLAP_POLICIES = new Set(["skip", "queue", "cancel-running", "allow"]);
+const SCHEDULE_ACTIONS = new Set(["list", "create", "pause", "resume", "cancel"]), VALID_SCHEDULE_OVERLAP_POLICIES = new Set(["skip", "queue", "cancel-running", "allow"]), VALID_SCHEDULE_REVISION_POLICIES = new Set(["active-at-fire", "pinned"]);
 function parseScheduleCliValues(args) {
   return parseArgs({
     args,
@@ -14,6 +14,7 @@ function parseScheduleCliValues(args) {
       overlap: { type: "string" },
       backfill: { type: "boolean", default: !1 },
       jitter: { type: "string" },
+      "revision-policy": { type: "string" },
       help: { type: "boolean", short: "h", default: !1 },
       json: { type: "boolean", short: "j", default: !1 }
     },
@@ -76,12 +77,23 @@ function requireScheduleAction(positionals) {
     throw Error(`Unknown schedule action "${action}". Expected one of: ${formatScheduleActionList()}`);
   return action;
 }
+function isScheduleRevisionPolicy(value) {
+  return VALID_SCHEDULE_REVISION_POLICIES.has(value);
+}
+function parseScheduleRevisionPolicy(value) {
+  if (value === void 0)
+    return;
+  if (!isScheduleRevisionPolicy(value))
+    throw Error(`Invalid revision policy '${value}'. Must be one of: active-at-fire, pinned`);
+  return value;
+}
 function buildScheduleCreateOptionalFields(values) {
-  const overlap = parseScheduleOverlapPolicy(values.overlap);
+  const overlap = parseScheduleOverlapPolicy(values.overlap), revisionPolicy = parseScheduleRevisionPolicy(values["revision-policy"]);
   return {
     ...values.id !== void 0 ? { id: values.id } : {},
     ...overlap !== void 0 ? { overlap } : {},
-    ...values.jitter !== void 0 ? { jitter: values.jitter } : {}
+    ...values.jitter !== void 0 ? { jitter: values.jitter } : {},
+    ...revisionPolicy !== void 0 ? { revisionPolicy } : {}
   };
 }
 function buildScheduleCreateCommand(values, positionals) {

package/dist/cli/schedule.js

@@ -64,7 +64,8 @@ async function executeScheduleCreate(options, engine, loadRegistrationsFromModul
     ...options.id !== void 0 ? { id: options.id } : {},
     ...options.overlap !== void 0 ? { overlap: options.overlap } : {},
     ...options.backfill ? { backfill: !0 } : {},
-    ...options.jitter !== void 0 ? { jitter: options.jitter } : {}
+    ...options.jitter !== void 0 ? { jitter: options.jitter } : {},
+    ...options.revisionPolicy !== void 0 ? { revisionPolicy: options.revisionPolicy } : {}
   }), schedule = await handle.describe();
   return {
     stdout: formatScheduleCommandOutput(schedule, options.json, `Created schedule ${handle.id}`),

package/dist/cli/storage-factory.js

@@ -10,6 +10,8 @@ export async function createStorage(backend, database) {
     }
     case "memory":
       return createMemoryStorage();
+    default:
+      throw Error(`Unknown storage backend: ${JSON.stringify(backend)}`);
   }
 }
 async function createMemoryStorage() {

package/dist/cli/types.d.ts

@@ -1,4 +1,4 @@
-import type { ScheduleOverlapPolicy } from '../core/types.ts';
+import type { ScheduleOverlapPolicy, ScheduleRevisionPolicy } from '../core/types.ts';
 /** Supported storage backend identifiers for the `--storage` flag. */
 export type StorageBackend = 'sqlite' | 'lmdb' | 'memory';
 /** Storage backends suitable for commands that must survive process exit. */
@@ -86,6 +86,7 @@ export type CliCommand = {
     overlap?: ScheduleOverlapPolicy;
     backfill: boolean;
     jitter?: string;
+    revisionPolicy?: ScheduleRevisionPolicy;
     help: boolean;
     json: boolean;
 } | {

package/dist/cli/workflow-commands.js

@@ -26,6 +26,8 @@ export async function executeWorkflow(command) {
       return executeWorkflowCancel(command, connection);
     case "signal":
       return executeWorkflowSignal(command, connection);
+    default:
+      throw Error(`Unknown workflow command action: ${JSON.stringify(command)}`);
   }
 }
 function isRecord(value) {

package/dist/cli-main.js

@@ -42,7 +42,7 @@ const parsedArguments = (() => {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     console.error(`Error: ${message}`);
-    process.exit(findCliSubcommandName(Bun.argv.slice(2)) === "api" ? 3 : 1);
+    return process.exit(findCliSubcommandName(Bun.argv.slice(2)) === "api" ? 3 : 1);
   }
 })();
 if (parsedArguments.command === "version") {

package/dist/client/http-client-requests.js

@@ -1,7 +1,7 @@
 import { assertScopedBulkWorkflowFilter } from "../core/bulk-workflow-filter.js";
 import { HttpClientError, request } from "./http-request.js";
 import { buildReviewListSearchParams } from "./search-params.js";
-import { scheduleSpecToWireFields } from "./start-body.js";
+import { scheduleSpecToWireFields, setIfDefined } from "./start-body.js";
 export async function listReviewRequests(context, filter) {
   const search = buildReviewListSearchParams(filter).toString(), path = search.length > 0 ? `/reviews?${search}` : "/reviews";
   return (await request(context.baseUrl, path, context.headers)).items;
@@ -187,14 +187,11 @@ export function cancelScheduleRequest(context, id) {
 }
 export function updateScheduleRequest(context, id, newSpec, options) {
   const body = scheduleSpecToWireFields(newSpec);
-  if (options?.description !== void 0)
-    body.description = options.description;
-  if (options?.overlap !== void 0)
-    body.overlap = options.overlap;
-  if (options?.backfill !== void 0)
-    body.backfill = options.backfill;
-  if (options?.jitter !== void 0)
-    body.jitter = options.jitter;
+  setIfDefined(body, "description", options?.description);
+  setIfDefined(body, "overlap", options?.overlap);
+  setIfDefined(body, "backfill", options?.backfill);
+  setIfDefined(body, "jitter", options?.jitter);
+  setIfDefined(body, "revisionPolicy", options?.revisionPolicy);
   return request(context.baseUrl, `/schedules/${encodeURIComponent(id)}`, context.headers, {
     method: "PATCH",
     body: JSON.stringify(body)

package/dist/client/start-body.js

@@ -16,6 +16,7 @@ export function buildScheduleBody(type, input, spec, options) {
   setIfDefined(body, "overlap", options?.overlap);
   setIfDefined(body, "backfill", options?.backfill);
   setIfDefined(body, "jitter", options?.jitter);
+  setIfDefined(body, "revisionPolicy", options?.revisionPolicy);
   return body;
 }
 function applyStartOptionsToBody(body, options) {