@voltro/workflow 0.83.1 → 0.85.0

package/dist/cluster.d.ts

@@ -1,24 +1,25 @@
-import { ConfigError } from 'effect';
+import { Config } from 'effect';
 import { Context } from 'effect';
 import { Cron } from 'effect';
 import { DataStore } from '@voltro/database';
 import { Duration } from 'effect';
 import { Effect } from 'effect';
 import { Layer } from 'effect';
-import { MalformedMessage } from '@effect/cluster/ClusterError';
-import { MessageStorage } from '@effect/cluster';
+import { MalformedMessage } from 'effect/cluster/ClusterError';
+import { MessageStorage } from 'effect/cluster';
 import { MysqlCharset } from '@voltro/database/sql';
-import { PersistenceError } from '@effect/cluster/ClusterError';
+import { PersistenceError } from 'effect/cluster/ClusterError';
 import { QueryDescriptor } from '@voltro/database';
+import { RateLimiter } from 'effect/persistence';
 import { Row } from '@voltro/database';
 import { Schema } from 'effect';
-import { Sharding } from '@effect/cluster';
-import { SqlClient } from '@effect/sql';
-import { SqlClient as SqlClient_2 } from '@effect/sql/SqlClient';
-import { SqlError } from '@effect/sql';
-import { SqlError as SqlError_2 } from '@effect/sql/SqlError';
-import { Workflow } from '@effect/workflow';
-import { WorkflowEngine } from '@effect/workflow';
+import { Sharding } from 'effect/cluster';
+import { SqlClient } from 'effect/sql';
+import { SqlClient as SqlClient_2 } from 'effect/sql/SqlClient';
+import { SqlError } from 'effect/sql';
+import { SqlError as SqlError_2 } from 'effect/sql/SqlError';
+import { Workflow } from 'effect/workflow';
+import { WorkflowEngine } from 'effect/workflow';
 
 /**
  * The cluster's own activity primary-key format — an activity RPC's
@@ -79,31 +80,25 @@ declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: string, ob
     kind: "settled";
     request: {
         readonly id: string;
-        readonly cause?: {
-            readonly detail?: {
-                readonly [x: string]: unknown;
-            } | undefined;
-            readonly reason: string;
-        } | null | undefined;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -113,36 +108,36 @@ declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: string, ob
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
-    };
-} | {
-    kind: "unknown";
-    request: {
-        readonly id: string;
         readonly cause?: {
+            readonly reason: string;
             readonly detail?: {
                 readonly [x: string]: unknown;
             } | undefined;
-            readonly reason: string;
         } | null | undefined;
+    };
+} | {
+    kind: "unknown";
+    request: {
+        readonly id: string;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -152,36 +147,36 @@ declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: string, ob
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
-    };
-} | {
-    kind: "superseded";
-    request: {
-        readonly id: string;
         readonly cause?: {
+            readonly reason: string;
             readonly detail?: {
                 readonly [x: string]: unknown;
             } | undefined;
-            readonly reason: string;
         } | null | undefined;
+    };
+} | {
+    kind: "superseded";
+    request: {
+        readonly id: string;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -191,36 +186,36 @@ declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: string, ob
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
-    };
-} | {
-    kind: "not-suspended";
-    request: {
-        readonly id: string;
         readonly cause?: {
+            readonly reason: string;
             readonly detail?: {
                 readonly [x: string]: unknown;
             } | undefined;
-            readonly reason: string;
         } | null | undefined;
+    };
+} | {
+    kind: "not-suspended";
+    request: {
+        readonly id: string;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -230,36 +225,36 @@ declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: string, ob
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
-    };
-} | {
-    kind: "bound";
-    request: {
-        readonly id: string;
         readonly cause?: {
+            readonly reason: string;
             readonly detail?: {
                 readonly [x: string]: unknown;
             } | undefined;
-            readonly reason: string;
         } | null | undefined;
+    };
+} | {
+    kind: "bound";
+    request: {
+        readonly id: string;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -269,36 +264,36 @@ declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: string, ob
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
-    };
-} | {
-    kind: "waiting-journal";
-    request: {
-        readonly id: string;
         readonly cause?: {
+            readonly reason: string;
             readonly detail?: {
                 readonly [x: string]: unknown;
             } | undefined;
-            readonly reason: string;
         } | null | undefined;
+    };
+} | {
+    kind: "waiting-journal";
+    request: {
+        readonly id: string;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -308,6 +303,12 @@ declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: string, ob
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
+        readonly cause?: {
+            readonly reason: string;
+            readonly detail?: {
+                readonly [x: string]: unknown;
+            } | undefined;
+        } | null | undefined;
     };
 }>;
 
@@ -323,13 +324,13 @@ export declare interface ClusterCronSpec {
     readonly execute: () => Promise<void>;
     /** Skip a firing whose scheduled time is older than this — the
      *  cluster's built-in backfill guard. Defaults to "1 day". */
-    readonly skipIfOlderThan?: Duration.DurationInput;
+    readonly skipIfOlderThan?: Duration.Input;
 }
 
 declare class ClusterDiagnostics extends ClusterDiagnostics_base {
 }
 
-declare const ClusterDiagnostics_base: Context.TagClass<ClusterDiagnostics, "@voltro/workflow/ClusterDiagnostics", ClusterDiagnosticsOps>;
+declare const ClusterDiagnostics_base: Context.ServiceClass<ClusterDiagnostics, "@voltro/workflow/ClusterDiagnostics", ClusterDiagnosticsOps>;
 
 declare interface ClusterDiagnosticsOps {
     /** This runner's advertised address — what keys its locks and its runner row. */
@@ -383,6 +384,9 @@ export declare interface ClusterDiagnosticsOptions {
     readonly hasShard?: (shardId: string) => boolean;
 }
 
+/** `SqlRunnerStorage`'s postgres lock namespace, as `pg_locks.classid` shows it. */
+export declare const clusterLockNamespaceOid: (prefix?: string) => number;
+
 declare interface ClusterMessageState {
     /** The rpc tag — `run` for the workflow itself, `activity/<name>/<attempt>` for a step. */
     readonly tag: string | null;
@@ -477,31 +481,25 @@ declare const dispatchWorkflowResume: (options: {
     kind: "settled";
     request: {
         readonly id: string;
-        readonly cause?: {
-            readonly detail?: {
-                readonly [x: string]: unknown;
-            } | undefined;
-            readonly reason: string;
-        } | null | undefined;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -511,36 +509,36 @@ declare const dispatchWorkflowResume: (options: {
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
-    };
-} | {
-    kind: "unknown";
-    request: {
-        readonly id: string;
         readonly cause?: {
+            readonly reason: string;
             readonly detail?: {
                 readonly [x: string]: unknown;
             } | undefined;
-            readonly reason: string;
         } | null | undefined;
+    };
+} | {
+    kind: "unknown";
+    request: {
+        readonly id: string;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -550,36 +548,36 @@ declare const dispatchWorkflowResume: (options: {
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
-    };
-} | {
-    kind: "superseded";
-    request: {
-        readonly id: string;
         readonly cause?: {
+            readonly reason: string;
             readonly detail?: {
                 readonly [x: string]: unknown;
             } | undefined;
-            readonly reason: string;
         } | null | undefined;
+    };
+} | {
+    kind: "superseded";
+    request: {
+        readonly id: string;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -589,36 +587,36 @@ declare const dispatchWorkflowResume: (options: {
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
-    };
-} | {
-    kind: "not-suspended";
-    request: {
-        readonly id: string;
         readonly cause?: {
+            readonly reason: string;
             readonly detail?: {
                 readonly [x: string]: unknown;
             } | undefined;
-            readonly reason: string;
         } | null | undefined;
+    };
+} | {
+    kind: "not-suspended";
+    request: {
+        readonly id: string;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -628,36 +626,36 @@ declare const dispatchWorkflowResume: (options: {
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
-    };
-} | {
-    kind: "waiting-journal";
-    request: {
-        readonly id: string;
         readonly cause?: {
+            readonly reason: string;
             readonly detail?: {
                 readonly [x: string]: unknown;
             } | undefined;
-            readonly reason: string;
         } | null | undefined;
+    };
+} | {
+    kind: "waiting-journal";
+    request: {
+        readonly id: string;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -667,36 +665,36 @@ declare const dispatchWorkflowResume: (options: {
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
-    };
-} | {
-    kind: "already-terminal";
-    request: {
-        readonly id: string;
         readonly cause?: {
+            readonly reason: string;
             readonly detail?: {
                 readonly [x: string]: unknown;
             } | undefined;
-            readonly reason: string;
         } | null | undefined;
+    };
+} | {
+    kind: "already-terminal";
+    request: {
+        readonly id: string;
         readonly result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
         readonly executionId: string;
         readonly workflowName: string;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly dispatchAttempts: number;
         readonly owner: {
             readonly tenantId: string | null;
@@ -706,6 +704,12 @@ declare const dispatchWorkflowResume: (options: {
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
+        readonly cause?: {
+            readonly reason: string;
+            readonly detail?: {
+                readonly [x: string]: unknown;
+            } | undefined;
+        } | null | undefined;
     };
     run: Readonly<Record<string, unknown>>;
 } | {
@@ -713,31 +717,25 @@ declare const dispatchWorkflowResume: (options: {
     request: {
         dispatchAttempts: number;
         id: string;
-        cause?: {
-            readonly detail?: {
-                readonly [x: string]: unknown;
-            } | undefined;
-            readonly reason: string;
-        } | null | undefined;
         result: {
-            readonly status: "failed" | "cancelled" | "succeeded";
             readonly kind: "confirmed" | "already-terminal";
-            readonly errorMessage: string | null;
+            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
-            readonly completedAt: number;
+            readonly errorMessage: string | null;
         } | {
-            readonly status: "running";
             readonly kind: "confirmed";
-            readonly generation: string;
+            readonly status: "running";
             readonly enteredAt: number;
+            readonly generation: string;
         } | null;
+        operation: "resume" | "cancel" | "terminate";
         generation: string;
         runId: string;
         requestedAt: number;
         executionId: string;
         workflowName: string;
-        operation: "resume" | "cancel" | "terminate";
         owner: {
             readonly tenantId: string | null;
         } | null;
@@ -746,6 +744,12 @@ declare const dispatchWorkflowResume: (options: {
             readonly replyId: string;
             readonly restartToken: string | null;
         } | null;
+        cause?: {
+            readonly reason: string;
+            readonly detail?: {
+                readonly [x: string]: unknown;
+            } | undefined;
+        } | null | undefined;
     };
     journal: {
         kind: "changed";
@@ -774,6 +778,26 @@ export declare interface FailedActivityRef {
     readonly attempt: number;
 }
 
+/** The exit as the cluster journals it: the rpc WIRE form (`RpcMessage.ExitEncoded`),
+ *  whose failure carries the cause as a list of reasons — not `Schema.Exit`'s
+ *  own `_id`-tagged encoding. */
+export declare const JournalExit: Schema.Union<readonly [Schema.Struct<{
+    readonly _tag: Schema.Literal<"Success">;
+    readonly value: Schema.Unknown;
+}>, Schema.Struct<{
+    readonly _tag: Schema.Literal<"Failure">;
+    readonly cause: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly _tag: Schema.Literal<"Fail">;
+        readonly error: Schema.Unknown;
+    }>, Schema.Struct<{
+        readonly _tag: Schema.Literal<"Die">;
+        readonly defect: Schema.Unknown;
+    }>, Schema.Struct<{
+        readonly _tag: Schema.Literal<"Interrupt">;
+        readonly fiberId: Schema.optional<Schema.NullOr<Schema.Number>>;
+    }>]>>;
+}>]>;
+
 /**
  * Build the cluster-cron layer for one schedule. Returns a
  * `Layer<never, never, Sharding>` — the framework provides `Sharding`
@@ -831,7 +855,7 @@ export declare const parseShardLockMode: (raw?: string | undefined) => ShardLock
  * "wake". Run it on the workflow runtime (`workflowRuntime.runPromise`), which
  * carries `Sharding`; it opens the storage-read latch so a message just enqueued
  * by another replica is picked up immediately instead of on the next poll tick.
- * Lives here so a boot path doesn't import `@effect/cluster` (and its ~420ms
+ * Lives here so a boot path doesn't import `effect/cluster` (and its ~420ms
  * load) just to reach the `Sharding` tag.
  */
 export declare const pollWorkflowStorage: Effect.Effect<void, never, Sharding.Sharding>;
@@ -854,26 +878,13 @@ declare const prepareWorkflowRestart: (options: {
     kind: "reserved";
     request: {
         readonly id: string;
-        readonly tenantId: string | null;
-        readonly token: string;
-        readonly generation: string;
         readonly runId: string;
-        readonly requestedAt: Date;
-        readonly executionId: string;
         readonly workflowName: string;
-        readonly selection: {
-            readonly kind: "failed-steps";
-        } | {
-            readonly kind: "from-step";
-            readonly stepName: string;
-        };
-        readonly dispatchAttempts: number;
-        readonly enteredGeneration: string | null;
+        readonly executionId: string;
+        readonly generation: string;
+        readonly token: string;
         readonly ledgerId: string;
-        readonly eviction: {
-            readonly runId: string;
-            readonly executionId: string;
-        } | null;
+        readonly tenantId: string | null;
         readonly delivery: {
             readonly requestId: string;
             readonly restartToken: string | null;
@@ -882,6 +893,19 @@ declare const prepareWorkflowRestart: (options: {
             readonly requestId: string;
             readonly replyId: string;
         }[];
+        readonly selection: {
+            readonly kind: "failed-steps";
+        } | {
+            readonly kind: "from-step";
+            readonly stepName: string;
+        };
+        readonly eviction: {
+            readonly executionId: string;
+            readonly runId: string;
+        } | null;
+        readonly requestedAt: Date;
+        readonly dispatchAttempts: number;
+        readonly enteredGeneration: string | null;
     };
     reused: boolean;
     decision?: never;
@@ -926,26 +950,13 @@ declare const prepareWorkflowRestartCommand: (options: Omit<Parameters<typeof pr
     kind: "reserved";
     request: {
         readonly id: string;
-        readonly tenantId: string | null;
-        readonly token: string;
-        readonly generation: string;
         readonly runId: string;
-        readonly requestedAt: Date;
-        readonly executionId: string;
         readonly workflowName: string;
-        readonly selection: {
-            readonly kind: "failed-steps";
-        } | {
-            readonly kind: "from-step";
-            readonly stepName: string;
-        };
-        readonly dispatchAttempts: number;
-        readonly enteredGeneration: string | null;
+        readonly executionId: string;
+        readonly generation: string;
+        readonly token: string;
         readonly ledgerId: string;
-        readonly eviction: {
-            readonly runId: string;
-            readonly executionId: string;
-        } | null;
+        readonly tenantId: string | null;
         readonly delivery: {
             readonly requestId: string;
             readonly restartToken: string | null;
@@ -954,6 +965,19 @@ declare const prepareWorkflowRestartCommand: (options: Omit<Parameters<typeof pr
             readonly requestId: string;
             readonly replyId: string;
         }[];
+        readonly selection: {
+            readonly kind: "failed-steps";
+        } | {
+            readonly kind: "from-step";
+            readonly stepName: string;
+        };
+        readonly eviction: {
+            readonly executionId: string;
+            readonly runId: string;
+        } | null;
+        readonly requestedAt: Date;
+        readonly dispatchAttempts: number;
+        readonly enteredGeneration: string | null;
     };
     reused: boolean;
     decision?: never;
@@ -999,26 +1023,13 @@ declare const readWorkflowRestartCommandInTransaction: (tx: AdmissionDataStore,
     readonly selection: WorkflowRestartSelection;
 }) => Promise<{
     readonly id: string;
-    readonly tenantId: string | null;
-    readonly token: string;
-    readonly generation: string;
     readonly runId: string;
-    readonly requestedAt: Date;
-    readonly executionId: string;
     readonly workflowName: string;
-    readonly selection: {
-        readonly kind: "failed-steps";
-    } | {
-        readonly kind: "from-step";
-        readonly stepName: string;
-    };
-    readonly dispatchAttempts: number;
-    readonly enteredGeneration: string | null;
+    readonly executionId: string;
+    readonly generation: string;
+    readonly token: string;
     readonly ledgerId: string;
-    readonly eviction: {
-        readonly runId: string;
-        readonly executionId: string;
-    } | null;
+    readonly tenantId: string | null;
     readonly delivery: {
         readonly requestId: string;
         readonly restartToken: string | null;
@@ -1027,6 +1038,19 @@ declare const readWorkflowRestartCommandInTransaction: (tx: AdmissionDataStore,
         readonly requestId: string;
         readonly replyId: string;
     }[];
+    readonly selection: {
+        readonly kind: "failed-steps";
+    } | {
+        readonly kind: "from-step";
+        readonly stepName: string;
+    };
+    readonly eviction: {
+        readonly executionId: string;
+        readonly runId: string;
+    } | null;
+    readonly requestedAt: Date;
+    readonly dispatchAttempts: number;
+    readonly enteredGeneration: string | null;
 } | undefined>;
 
 /** Internal owner check after a generation has been captured. Command recovery
@@ -1035,26 +1059,13 @@ declare const readWorkflowRestartReservationInTransaction: (tx: AdmissionDataSto
     readonly generation: string;
 }) => Promise<{
     readonly id: string;
-    readonly tenantId: string | null;
-    readonly token: string;
-    readonly generation: string;
     readonly runId: string;
-    readonly requestedAt: Date;
-    readonly executionId: string;
     readonly workflowName: string;
-    readonly selection: {
-        readonly kind: "failed-steps";
-    } | {
-        readonly kind: "from-step";
-        readonly stepName: string;
-    };
-    readonly dispatchAttempts: number;
-    readonly enteredGeneration: string | null;
+    readonly executionId: string;
+    readonly generation: string;
+    readonly token: string;
     readonly ledgerId: string;
-    readonly eviction: {
-        readonly runId: string;
-        readonly executionId: string;
-    } | null;
+    readonly tenantId: string | null;
     readonly delivery: {
         readonly requestId: string;
         readonly restartToken: string | null;
@@ -1063,6 +1074,19 @@ declare const readWorkflowRestartReservationInTransaction: (tx: AdmissionDataSto
         readonly requestId: string;
         readonly replyId: string;
     }[];
+    readonly selection: {
+        readonly kind: "failed-steps";
+    } | {
+        readonly kind: "from-step";
+        readonly stepName: string;
+    };
+    readonly eviction: {
+        readonly executionId: string;
+        readonly runId: string;
+    } | null;
+    readonly requestedAt: Date;
+    readonly dispatchAttempts: number;
+    readonly enteredGeneration: string | null;
 } | undefined>;
 
 /** Observe the persisted run delivery without decoding it against a possibly
@@ -1128,35 +1152,35 @@ export declare interface RedriveTarget {
 }
 
 declare const Request_2: Schema.Struct<{
-    id: typeof Schema.NonEmptyString;
-    runId: typeof Schema.NonEmptyString;
-    workflowName: typeof Schema.NonEmptyString;
-    executionId: typeof Schema.NonEmptyString;
-    generation: typeof Schema.NonEmptyString;
-    token: typeof Schema.NonEmptyString;
-    ledgerId: typeof Schema.NonEmptyString;
-    tenantId: Schema.NullOr<typeof Schema.NonEmptyString>;
-    delivery: Schema.Struct<{
-        requestId: typeof Schema.NonEmptyString;
-        restartToken: Schema.NullOr<typeof Schema.NonEmptyString>;
+    readonly id: Schema.NonEmptyString;
+    readonly runId: Schema.NonEmptyString;
+    readonly workflowName: Schema.NonEmptyString;
+    readonly executionId: Schema.NonEmptyString;
+    readonly generation: Schema.NonEmptyString;
+    readonly token: Schema.NonEmptyString;
+    readonly ledgerId: Schema.NonEmptyString;
+    readonly tenantId: Schema.NullOr<Schema.NonEmptyString>;
+    readonly delivery: Schema.Struct<{
+        readonly requestId: Schema.NonEmptyString;
+        readonly restartToken: Schema.NullOr<Schema.NonEmptyString>;
     }>;
-    replies: Schema.Array$<Schema.Struct<{
-        requestId: typeof Schema.NonEmptyString;
-        replyId: typeof Schema.NonEmptyString;
+    readonly replies: Schema.$Array<Schema.Struct<{
+        readonly requestId: Schema.NonEmptyString;
+        readonly replyId: Schema.NonEmptyString;
     }>>;
-    selection: Schema.Union<[Schema.Struct<{
-        kind: Schema.Literal<["failed-steps"]>;
+    readonly selection: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"failed-steps">;
     }>, Schema.Struct<{
-        kind: Schema.Literal<["from-step"]>;
-        stepName: Schema.filter<typeof Schema.NonEmptyString>;
+        readonly kind: Schema.Literal<"from-step">;
+        readonly stepName: Schema.NonEmptyString;
     }>]>;
-    eviction: Schema.NullOr<Schema.Struct<{
-        executionId: typeof Schema.NonEmptyString;
-        runId: typeof Schema.String;
+    readonly eviction: Schema.NullOr<Schema.Struct<{
+        readonly executionId: Schema.NonEmptyString;
+        readonly runId: Schema.String;
     }>>;
-    requestedAt: typeof Schema.DateFromSelf;
-    dispatchAttempts: Schema.refine<number, typeof Schema.NonNegative>;
-    enteredGeneration: Schema.NullOr<typeof Schema.NonEmptyString>;
+    readonly requestedAt: Schema.Date;
+    readonly dispatchAttempts: Schema.Number;
+    readonly enteredGeneration: Schema.NullOr<Schema.NonEmptyString>;
 }>;
 
 /** Private dispatch composition. Capacity is mandatory, outside the resident
@@ -1189,7 +1213,7 @@ declare const resetReservedWorkflowJournal: (input: {
  *  event at all". */
 declare interface ResolvedCancelOn {
     readonly event: string;
-    readonly schema: Schema.Schema.Any;
+    readonly schema: Schema.Top;
     readonly match: (event: unknown, payload: unknown) => boolean;
     readonly withinMs?: number;
     readonly reason: string;
@@ -1294,7 +1318,7 @@ export declare const resolveRunnerIdentity: (opts: {
  * `VOLTRO_WORKFLOW_RUNNER_STORAGE` (or an explicit `override`) forces the
  * choice. The load-bearing case is `'memory'` on a real SQL dialect: it keeps
  * the single-process durable engine (workflow run state stays SQL-backed via
- * `@effect/cluster`'s `SqlMessageStorage`) but SKIPS `SqlRunnerStorage`
+ * `effect/cluster`'s `SqlMessageStorage`) but SKIPS `SqlRunnerStorage`
  * entirely — no `cluster_runners` / `cluster_locks` table, and none of its
  * `GET_LOCK` advisory-lock acquisition. That unblocks a managed MySQL /
  * MariaDB reached through a connection-load-balancing Service or a
@@ -1385,23 +1409,23 @@ export declare interface RunnerIdentity {
 }
 
 /**
- * Runner-storage backend for `@effect/cluster.SingleRunner`.
+ * Runner-storage backend for `effect/cluster.SingleRunner`.
  *
  *   - `'sql'`     — durable across crashes + multi-instance scale-out.
  *                   Used for postgres / mysql / mariadb / mssql.
  *   - `'memory'`  — durable replay within the SAME process; no
  *                   horizontal scale-out. Used for `sqlite` because
- *                   `@effect/cluster.SqlRunnerStorage` has no SQLite
+ *                   `effect/cluster.SqlRunnerStorage` has no SQLite
  *                   lock-acquisition branch (`pg_advisory_lock` and
  *                   `GET_LOCK` aren't available there).
  */
 export declare type RunnerStorage = 'sql' | 'memory';
 
-declare const Selection: Schema.Union<[Schema.Struct<{
-    kind: Schema.Literal<["failed-steps"]>;
+declare const Selection: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"failed-steps">;
 }>, Schema.Struct<{
-    kind: Schema.Literal<["from-step"]>;
-    stepName: Schema.filter<typeof Schema.NonEmptyString>;
+    readonly kind: Schema.Literal<"from-step">;
+    readonly stepName: Schema.NonEmptyString;
 }>]>;
 
 declare interface ShardLockHolder {
@@ -1424,7 +1448,7 @@ declare interface ShardLockHolder {
 }
 
 /**
- * How `@effect/cluster`'s `SqlRunnerStorage` coordinates shard ownership across
+ * How `effect/cluster`'s `SqlRunnerStorage` coordinates shard ownership across
  * a fleet of runners:
  *
  *   - `'advisory'` — session-scoped DB advisory locks (`GET_LOCK` on
@@ -1459,7 +1483,7 @@ declare interface UnreadMessage extends ClusterMessageState {
     readonly unreadForMs: number;
 }
 
-export declare const workflowEngineLayer: (options: WorkflowEngineLayerOptions) => Layer.Layer<WorkflowEngine.WorkflowEngine | Sharding.Sharding | MessageStorage.MessageStorage | ClusterDiagnostics | WorkflowResumeDispatcher | WorkflowRestartDispatcher>;
+export declare const workflowEngineLayer: (options: WorkflowEngineLayerOptions) => Layer.Layer<WorkflowEngine.WorkflowEngine | RateLimiter.RateLimiter | Sharding.Sharding | MessageStorage.MessageStorage | ClusterDiagnostics | WorkflowResumeDispatcher | WorkflowRestartDispatcher>;
 
 export declare interface WorkflowEngineLayerOptions {
     /**
@@ -1469,7 +1493,7 @@ export declare interface WorkflowEngineLayerOptions {
      * runs through it for sqlite, the layer's resource lifecycle keeps
      * the cluster's accounting clean.
      */
-    readonly sqlClientLayer: Layer.Layer<SqlClient.SqlClient, ConfigError.ConfigError | SqlError.SqlError, never>;
+    readonly sqlClientLayer: Layer.Layer<SqlClient.SqlClient, Config.ConfigError | SqlError.SqlError, never>;
     /** SQL ownership for shared primaries; memory for local/embedded stores. */
     readonly runnerStorage: RunnerStorage;
     /**
@@ -1501,7 +1525,7 @@ export declare interface WorkflowEngineLayerOptions {
      * lease-expiry problem, NOT a polling one: a dead runner keeps its shards
      * until its heartbeat goes stale, so the floor is the lease TTL.
      *
-     * - `failoverLeaseSeconds` (default 35, `@effect/cluster`
+     * - `failoverLeaseSeconds` (default 35, `effect/cluster`
      *   `shardLockExpiration`) — how long after a runner's last heartbeat its
      *   shards become claimable. Lower = faster failover on a hard crash, at the
      *   cost of false-positive reclaims if a healthy runner is paused longer than
@@ -1518,7 +1542,7 @@ export declare interface WorkflowEngineLayerOptions {
     readonly failoverLeaseSeconds?: number;
     readonly failoverHeartbeatSeconds?: number;
     /**
-     * NEW-MESSAGE latency across replicas (default 10, `@effect/cluster`
+     * NEW-MESSAGE latency across replicas (default 10, `effect/cluster`
      * `entityMessagePollInterval`). DISTINCT from failover: this is how long a
      * freshly-triggered workflow can wait before the replica that OWNS its shard
      * picks it up. When the triggering replica owns the shard it's immediate
@@ -1547,10 +1571,10 @@ export declare interface WorkflowEngineLayerOptions {
 export declare class WorkflowRestartDispatcher extends WorkflowRestartDispatcher_base {
 }
 
-declare const WorkflowRestartDispatcher_base: Context.TagClass<WorkflowRestartDispatcher, "@voltro/workflow/WorkflowRestartDispatcher", {
+declare const WorkflowRestartDispatcher_base: Context.ServiceClass<WorkflowRestartDispatcher, "@voltro/workflow/WorkflowRestartDispatcher", {
     readonly prepare: (options: Omit<Parameters<typeof prepareWorkflowRestartCommand>[0], "observe">) => Effect.Effect<Awaited<ReturnType<typeof prepareWorkflowRestartCommand>>, unknown>;
-    readonly dispatch: (options: Parameters<typeof dispatchWorkflowRestart>[0]) => Effect.Effect<Effect.Effect.Success<ReturnType<typeof dispatchWorkflowRestart>>, Effect.Effect.Error<ReturnType<typeof dispatchWorkflowRestart>>>;
-    readonly observe: (target: WorkflowRestartObservationTarget) => Effect.Effect<Effect.Effect.Success<ReturnType<typeof observeWorkflowRestartReplies>>, Effect.Effect.Error<ReturnType<typeof observeWorkflowRestartReplies>>>;
+    readonly dispatch: (options: Parameters<typeof dispatchWorkflowRestart>[0]) => Effect.Effect<Effect.Success<ReturnType<typeof dispatchWorkflowRestart>>, Effect.Error<ReturnType<typeof dispatchWorkflowRestart>>>;
+    readonly observe: (target: WorkflowRestartObservationTarget) => Effect.Effect<Effect.Success<ReturnType<typeof observeWorkflowRestartReplies>>, Effect.Error<ReturnType<typeof observeWorkflowRestartReplies>>>;
 }>;
 
 declare interface WorkflowRestartObservationTarget {
@@ -1570,8 +1594,8 @@ declare type WorkflowRestartSelection = typeof Selection.Type;
 export declare class WorkflowResumeDispatcher extends WorkflowResumeDispatcher_base {
 }
 
-declare const WorkflowResumeDispatcher_base: Context.TagClass<WorkflowResumeDispatcher, "@voltro/workflow/WorkflowResumeDispatcher", {
-    readonly dispatch: (options: Parameters<typeof dispatchWorkflowResume>[0]) => Effect.Effect<Effect.Effect.Success<ReturnType<typeof dispatchWorkflowResume>>, Effect.Effect.Error<ReturnType<typeof dispatchWorkflowResume>>>;
+declare const WorkflowResumeDispatcher_base: Context.ServiceClass<WorkflowResumeDispatcher, "@voltro/workflow/WorkflowResumeDispatcher", {
+    readonly dispatch: (options: Parameters<typeof dispatchWorkflowResume>[0]) => Effect.Effect<Effect.Success<ReturnType<typeof dispatchWorkflowResume>>, Effect.Error<ReturnType<typeof dispatchWorkflowResume>>>;
 }>;
 
 /** Raw engine evidence, before workflow-result decoding. Server-only consumers