@voltro/workflow 0.86.0 → 0.87.0

package/dist/index.d.ts

@@ -603,9 +603,10 @@ export declare const beginWorkflowControlDispatchInTransaction: (tx: Store, id:
     kind: "settled";
     request: {
         readonly id: string;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -616,7 +617,6 @@ export declare const beginWorkflowControlDispatchInTransaction: (tx: Store, id:
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
@@ -643,9 +643,10 @@ export declare const beginWorkflowControlDispatchInTransaction: (tx: Store, id:
     kind: "unknown";
     request: {
         readonly id: string;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -656,7 +657,6 @@ export declare const beginWorkflowControlDispatchInTransaction: (tx: Store, id:
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
@@ -683,9 +683,10 @@ export declare const beginWorkflowControlDispatchInTransaction: (tx: Store, id:
     kind: "superseded";
     request: {
         readonly id: string;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -696,7 +697,6 @@ export declare const beginWorkflowControlDispatchInTransaction: (tx: Store, id:
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
@@ -723,9 +723,10 @@ export declare const beginWorkflowControlDispatchInTransaction: (tx: Store, id:
     kind: "already-terminal";
     request: {
         readonly id: string;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -736,7 +737,6 @@ export declare const beginWorkflowControlDispatchInTransaction: (tx: Store, id:
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
@@ -764,9 +764,10 @@ export declare const beginWorkflowControlDispatchInTransaction: (tx: Store, id:
     request: {
         dispatchAttempts: number;
         id: string;
+        operation: "resume" | "cancel" | "terminate";
         result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -777,7 +778,6 @@ export declare const beginWorkflowControlDispatchInTransaction: (tx: Store, id:
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        operation: "resume" | "cancel" | "terminate";
         generation: string;
         runId: string;
         requestedAt: number;
@@ -814,9 +814,10 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
     kind: "settled";
     request: {
         readonly id: string;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -827,7 +828,6 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
@@ -853,9 +853,10 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
     kind: "unknown";
     request: {
         readonly id: string;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -866,7 +867,6 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
@@ -892,9 +892,10 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
     kind: "superseded";
     request: {
         readonly id: string;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -905,7 +906,6 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
@@ -931,9 +931,10 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
     kind: "not-suspended";
     request: {
         readonly id: string;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -944,7 +945,6 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
@@ -970,9 +970,10 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
     kind: "bound";
     request: {
         readonly id: string;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -983,7 +984,6 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
@@ -1009,9 +1009,10 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
     kind: "waiting-journal";
     request: {
         readonly id: string;
+        readonly operation: "resume" | "cancel" | "terminate";
         readonly result: {
             readonly kind: "confirmed" | "already-terminal";
-            readonly status: "failed" | "cancelled" | "succeeded";
+            readonly status: "failed" | "succeeded" | "cancelled";
             readonly completedAt: number;
             readonly output: unknown;
             readonly errorTag: string | null;
@@ -1022,7 +1023,6 @@ export declare const bindWorkflowResumeJournalInTransaction: (tx: Store, id: str
             readonly enteredAt: number;
             readonly generation: string;
         } | null;
-        readonly operation: "resume" | "cancel" | "terminate";
         readonly generation: string;
         readonly runId: string;
         readonly requestedAt: number;
@@ -1961,6 +1961,11 @@ export declare const isWorkflowEncrypted: (name: string) => boolean;
 
 export declare const isWorkflowWorkerLayer: (value: unknown) => value is WorkflowWorkerLayerBrand;
 
+export declare interface JournalRoutingState {
+    readonly generation: number;
+    readonly layout: string;
+}
+
 /**
  * Attach the engine's execution id to the ledger row written by
  * {@link admitStart}.
@@ -4159,6 +4164,17 @@ declare type WorkflowFn = <const Name extends string, Payload extends WorkflowPa
     readonly name: Name;
 } & WorkflowMessagesCarrier<NormaliseWorkflowMessages<Messages>>;
 
+/** Journal routing generation per PostgreSQL journal namespace. Declared, so the
+ * schema owns it (plan, fingerprint, backup); the maintenance transition only
+ * reads and writes it inside its pinned journal transaction. */
+export declare const workflowJournalRoutingTable: Table<"_voltro_workflow_journal_routing", FieldDefinitions<{
+    readonly id: ColumnBuilder<string, "id", boolean>;
+    readonly namespace: ColumnBuilder<string, "text", boolean>;
+    readonly generation: ColumnBuilder<string, "bigint", boolean>;
+    readonly layout: ColumnBuilder<string, "text", boolean>;
+    readonly relocation: ColumnBuilder<string, "text", boolean>;
+}>, false, never>;
+
 declare type WorkflowMake = typeof workflowModule.make;
 
 export declare interface WorkflowMessagePairSchemas {
@@ -4584,6 +4600,15 @@ export declare type WorkflowScheduleOverlap = 'skip' | 'buffer' | 'cancelOther';
  *  that crossed a bundler boundary, and symbols do not survive every one. */
 export declare const WorkflowScheduleProperty = "__voltroWorkflowSchedule";
 
+/** Explicit routing inventory shared by every runner in one cluster. Changing
+ * groups changes persistent addresses; this is not a journal migration. */
+/** Group names are at most 32 ASCII characters: group + colon + a safe integer
+ * slot fits the existing SQL journal shard_id VARCHAR(50) on every dialect. */
+export declare interface WorkflowShardGroups {
+    readonly available: ReadonlyArray<string>;
+    readonly assigned: ReadonlyArray<string>;
+}
+
 /**
  * At most one run per key. The newcomer either stands down or evicts.
  *

package/dist/index.js

@@ -24,26 +24,27 @@ import { stageWorkflowParentClosureInTransaction as kt } from "./parentClosure.j
 import { readWorkflowRestartObservationInTransaction as At, reserveWorkflowRestartInTransaction as jt, withdrawWorkflowRestartInTransaction as Mt, workflowRestartRequestsTable as Nt, workflowRestartWithdrawalsTable as Pt } from "./workflowRestartReservation.js";
 import { cancelSuspendedWorkflowRunInTransaction as Ft, completeWorkflowRunGenerationInTransaction as It, enterWorkflowRunGenerationInTransaction as Lt } from "./runGeneration.js";
 import { queuedCancellationRequestsTable as Rt } from "./queuedCancellationRequest.js";
-import { cancelQueuedWorkflowStartInTransaction as zt, readQueuedWorkflowCancellationInTransaction as Bt } from "./queuedControl.js";
-import { inspectAdmissionSubmissionRetry as Vt, retryAdmissionSubmissionInTransaction as Ht } from "./submissionRetry.js";
-import { takeAdmittedSubmissionInTransaction as Ut, takePendingAdmissionSubmission as Wt } from "./pendingSubmission.js";
-import { admitStart as Gt, linkExecution as Kt } from "./admissionGate.js";
-import { _voltroWorkflowWatermarksTable as qt } from "./watermarkTable.js";
-import { newestEventAt as Jt, planCancellations as Yt } from "./cancelOnPlan.js";
-import { CANCEL_ON_WATERMARK as Xt, DEFAULT_COLD_LOOKBACK_MS as Zt, DEFAULT_EVENT_BATCH as Qt, EVENTS_TABLE as $t, WATERMARKS_TABLE as en, readWatermark as tn, sweepCancelOn as nn, writeWatermark as rn } from "./cancelOnSweep.js";
-import { DEFAULT_STALL_AFTER_MS as an, DEFAULT_STALL_EVENT_LOOKBACK as on, DEFAULT_STALL_RUN_PAGE as sn, sweepStalledRuns as cn } from "./stalenessSweep.js";
-import { CLUSTER_REREAD_WINDOW_MS as ln, ClusterDiagnostics as un, describeStalledRun as dn } from "./clusterDiagnostics.js";
-import { DEFAULT_DRAIN_BATCH as fn, acceptAdmissionSubmission as pn, drainTick as mn, isUnacknowledgedSubmission as hn } from "./admissionDrainer.js";
-import { DEFAULT_SUSPEND_HINT_MS as gn, maybeHintSuspendingSignal as _n, resetSuspendHintsForTest as vn, resolveSuspendHintMs as yn, setSuspendSignalHintMs as bn } from "./signalHint.js";
-import { awaitSignal as xn } from "./signals.js";
-import { awaitEvent as Sn } from "./awaitEvent.js";
-import { SuspensionUnavailable as Cn, WorkflowCannotPark as wn } from "./suspensionUnavailable.js";
-import { makeWorkflowUpdateId as Tn, resolveWorkflowMessageRun as En, sendWorkflowSignal as Dn, sendWorkflowUpdate as On } from "./messages.js";
-import { awaitSignalSuspending as kn, completeSuspendingSignal as An, suspendingSignalDeferredName as jn } from "./signalsSuspending.js";
-import { BUDGET_HOLDS_TABLE as Mn, BudgetHoldExpired as Nn, DEFAULT_BUDGET_HOLD_TIMEOUT_MS as Pn, _voltroBudgetHoldsTable as Fn, budgetHoldGeneration as In, budgetHoldKey as Ln, budgetHoldSignalName as Rn, heldBudgets as zn, pendingBudgetHolds as Bn, releaseBudgetHolds as Vn, suspendForBudget as Hn } from "./budgetHold.js";
-import { awaitUpdate as Un } from "./updates.js";
-import { inspectWorkflow as Wn } from "./inspectWorkflow.js";
-import { makeInMemoryRecorder as Gn } from "./inMemoryRecorder.js";
-import { DEFAULT_MAX_RUN_RECLAIMS as Kn, DEFAULT_REPLAY_SHAPE_LIMIT as qn, makeWorkflowRunRecorder as Jn, normaliseWorkflowPatches as Yn, resolveRunGuardTuning as Xn, serialiseWorkflowRowForWire as Zn, truncateWorkflowValue as Qn, wrapWorkflowExecuteWithRunRecording as $n } from "./runRecording.js";
-import { recordWorkflowExecutionRefusal as er } from "./executionRefusal.js";
-export { et as ADMISSIONS_TABLE, Ie as ADMISSION_SUBMISSION_ID_PREFIX, Mn as BUDGET_HOLDS_TABLE, Nn as BudgetHoldExpired, Xt as CANCEL_ON_WATERMARK, ln as CLUSTER_REREAD_WINDOW_MS, un as ClusterDiagnostics, C as CurrentWorkflowExecutionId, w as CurrentWorkflowPatches, I as CurrentWorkflowReplayShape, T as CurrentWorkflowRunId, E as CurrentWorkflowStep, Pn as DEFAULT_BUDGET_HOLD_TIMEOUT_MS, Zt as DEFAULT_COLD_LOOKBACK_MS, fn as DEFAULT_DRAIN_BATCH, Qt as DEFAULT_EVENT_BATCH, tt as DEFAULT_LEASE_MS, Kn as DEFAULT_MAX_RUN_RECLAIMS, qn as DEFAULT_REPLAY_SHAPE_LIMIT, an as DEFAULT_STALL_AFTER_MS, on as DEFAULT_STALL_EVENT_LOOKBACK, sn as DEFAULT_STALL_RUN_PAGE, gn as DEFAULT_SUSPEND_HINT_MS, M as DEFAULT_WORKFLOW_SCHEDULE_MAX_RUNTIME_MS, _ as DEFERRING_CONTROLS, $t as EVENTS_TABLE, we as FlowControlKeyError, nt as PAUSES_TABLE, rt as PENDING_TABLE, i as STEP_JOURNAL_BINDING, Le as SUBMISSIONS_TABLE, Cn as SuspensionUnavailable, en as WATERMARKS_TABLE, a as WORKFLOW_JOURNAL_BINDING, wn as WorkflowCannotPark, B as WorkflowFlowControlProperty, V as WorkflowMessagesProperty, D as WorkflowRunRecorder, N as WorkflowScheduleProperty, Je as WorkflowStartRequestConflictError, O as WorkflowStepInterceptorTag, H as WorkflowVersionTypeId, U as WorkflowWorkerLayerTypeId, Fn as _voltroBudgetHoldsTable, me as _voltroWorkflowAdmissionLocksTable, he as _voltroWorkflowAdmissionsTable, ge as _voltroWorkflowControlRequestsTable, _e as _voltroWorkflowFailureReportsTable, ve as _voltroWorkflowParentClosuresTable, ye as _voltroWorkflowPausesTable, be as _voltroWorkflowPendingTable, fe as _voltroWorkflowRunEventsTable, de as _voltroWorkflowRunStepsTable, ue as _voltroWorkflowRunsTable, pe as _voltroWorkflowStartContextsTable, xe as _voltroWorkflowStartReceiptsTable, Se as _voltroWorkflowSubmissionsTable, qt as _voltroWorkflowWatermarksTable, pn as acceptAdmissionSubmission, Tt as acceptWorkflowControlInTransaction, Re as acknowledgeAdmissionSubmission, it as admissionLeaseHeldPredicate, Gt as admitStart, at as allIntents, v as assertConsistentPools, t as attachPreparedWorkflowExecution, Sn as awaitEvent, xn as awaitSignal, kn as awaitSignalSuspending, Un as awaitUpdate, ze as beginAdmissionSubmissionDispatchInTransaction, Et as beginWorkflowControlDispatchInTransaction, Dt as bindWorkflowResumeJournalInTransaction, Ye as bindWorkflowStartReceipts, In as budgetHoldGeneration, Ln as budgetHoldKey, Rn as budgetHoldSignalName, zt as cancelQueuedWorkflowStartInTransaction, Ft as cancelSuspendedWorkflowRunInTransaction, Te as comparePendingOrder, An as completeSuspendingSignal, It as completeWorkflowRunGenerationInTransaction, k as currentWorkflowStep, ot as deadLetterIntent, Ee as decideAdmission, y as deferringControlsOf, st as deleteIntent, dn as describeStalledRun, ct as discardIntent, lt as discardIntentInTransaction, mn as drainTick, ut as dueIntents, W as durableClock, G as durableQueue, K as durableQueueModule, Lt as enterWorkflowRunGenerationInTransaction, dt as evaluateAdmission, n as executePreparedWorkflow, e as failureMessage, A as getCurrentWorkflowExecutionId, j as getCurrentWorkflowRunId, q as getWorkflowFlowControl, o as getWorkflowJournalCipher, P as getWorkflowSchedule, J as getWorkflowVersionMetadata, Pe as handoffWorkflowFailureInTransaction, b as hasCancelOn, x as hasFlowControl, r as hasPreparedWorkflowExecution, zn as heldBudgets, le as inMemoryWorkflowEngineLayer, Vt as inspectAdmissionSubmissionRetry, Wn as inspectWorkflow, Y as isCarrier, De as isFinishExpired, s as isSealedJournalValue, Oe as isStartExpired, hn as isUnacknowledgedSubmission, c as isWorkflowEncrypted, X as isWorkflowWorkerLayer, Kt as linkExecution, Gn as makeInMemoryRecorder, L as makeReplayShapeTracker, Jn as makeWorkflowRunRecorder, Tn as makeWorkflowUpdateId, _n as maybeHintSuspendingSignal, Be as newAdmissionSubmissionId, Jt as newestEventAt, ke as nextSlotAt, R as nondeterminismEventPayload, Yn as normaliseWorkflowPatches, Ve as noteAdmissionSubmissionFailure, ft as noteIntentAttempt, l as openErrorText, u as openEventPayload, d as openJournalValue, f as openPayloadFields, p as openWorkflowRow, pt as parkDelayedStart, Z as patch, mt as pauseWorkflow, He as pendingAdmissionSubmissions, Bn as pendingBudgetHolds, ht as pendingSlotId, gt as pendingWindow, _t as persistDefer, Yt as planCancellations, Ae as pooledConcurrencyKey, Ue as prepareAdmissionSubmissionExecutionInTransaction, Q as processQueue, vt as pruneAdmissions, $ as queueWorker, Rt as queuedCancellationRequestsTable, ee as rateLimit, yt as readAdmissionState, We as readAdmissionSubmission, bt as readPausedWorkflows, Bt as readQueuedWorkflowCancellationInTransaction, tn as readWatermark, Ot as readWorkflowControlInTransaction, Me as readWorkflowFailureRecord, At as readWorkflowRestartObservationInTransaction, Xe as readWorkflowStartReceipt, Ze as readWorkflowStartRequest, Fe as reconcileWorkflowFailureInTransaction, xt as recordAdmission, er as recordWorkflowExecutionRefusal, Ne as recordWorkflowFailureInTransaction, Qe as recordWorkflowStartReceipt, Ge as rejectAdmissionSubmissionInTransaction, Vn as releaseBudgetHolds, St as releaseLease, z as reportNondeterminism, Ke as reserveAdmissionSubmission, qe as reserveAdmissionSubmissionInTransaction, jt as reserveWorkflowRestartInTransaction, vn as resetSuspendHintsForTest, je as resolveAdmissionKeys, Xn as resolveRunGuardTuning, yn as resolveSuspendHintMs, En as resolveWorkflowMessageRun, $e as resolveWorkflowStartReceipt, Ct as resumeWorkflow, Ht as retryAdmissionSubmissionInTransaction, wt as retryDeadLetterIntent, m as sealJournalValue, Dn as sendWorkflowSignal, On as sendWorkflowUpdate, Zn as serialiseWorkflowRowForWire, bn as setSuspendSignalHintMs, h as setWorkflowJournalCipher, te as sleep, ne as sleepUntil, kt as stageWorkflowParentClosureInTransaction, re as step, ie as stepIdempotencyKey, ae as stepModule, Hn as suspendForBudget, jn as suspendingSignalDeferredName, nn as sweepCancelOn, cn as sweepStalledRuns, Ut as takeAdmittedSubmissionInTransaction, Wt as takePendingAdmissionSubmission, Qn as truncateWorkflowValue, g as tryOpenJournalValue, S as validateFlowControl, F as validateWorkflowSchedule, Ce as withAdmissionTransaction, oe as withCompensation, Mt as withdrawWorkflowRestartInTransaction, se as workflow, ce as workflowModule, Nt as workflowRestartRequestsTable, Pt as workflowRestartWithdrawalsTable, $n as wrapWorkflowExecuteWithRunRecording, rn as writeWatermark };
+import { workflowJournalRoutingTable as zt } from "./journalRoutingTable.js";
+import { cancelQueuedWorkflowStartInTransaction as Bt, readQueuedWorkflowCancellationInTransaction as Vt } from "./queuedControl.js";
+import { inspectAdmissionSubmissionRetry as Ht, retryAdmissionSubmissionInTransaction as Ut } from "./submissionRetry.js";
+import { takeAdmittedSubmissionInTransaction as Wt, takePendingAdmissionSubmission as Gt } from "./pendingSubmission.js";
+import { admitStart as Kt, linkExecution as qt } from "./admissionGate.js";
+import { _voltroWorkflowWatermarksTable as Jt } from "./watermarkTable.js";
+import { newestEventAt as Yt, planCancellations as Xt } from "./cancelOnPlan.js";
+import { CANCEL_ON_WATERMARK as Zt, DEFAULT_COLD_LOOKBACK_MS as Qt, DEFAULT_EVENT_BATCH as $t, EVENTS_TABLE as en, WATERMARKS_TABLE as tn, readWatermark as nn, sweepCancelOn as rn, writeWatermark as an } from "./cancelOnSweep.js";
+import { DEFAULT_STALL_AFTER_MS as on, DEFAULT_STALL_EVENT_LOOKBACK as sn, DEFAULT_STALL_RUN_PAGE as cn, sweepStalledRuns as ln } from "./stalenessSweep.js";
+import { CLUSTER_REREAD_WINDOW_MS as un, ClusterDiagnostics as dn, describeStalledRun as fn } from "./clusterDiagnostics.js";
+import { DEFAULT_DRAIN_BATCH as pn, acceptAdmissionSubmission as mn, drainTick as hn, isUnacknowledgedSubmission as gn } from "./admissionDrainer.js";
+import { DEFAULT_SUSPEND_HINT_MS as _n, maybeHintSuspendingSignal as vn, resetSuspendHintsForTest as yn, resolveSuspendHintMs as bn, setSuspendSignalHintMs as xn } from "./signalHint.js";
+import { awaitSignal as Sn } from "./signals.js";
+import { awaitEvent as Cn } from "./awaitEvent.js";
+import { SuspensionUnavailable as wn, WorkflowCannotPark as Tn } from "./suspensionUnavailable.js";
+import { makeWorkflowUpdateId as En, resolveWorkflowMessageRun as Dn, sendWorkflowSignal as On, sendWorkflowUpdate as kn } from "./messages.js";
+import { awaitSignalSuspending as An, completeSuspendingSignal as jn, suspendingSignalDeferredName as Mn } from "./signalsSuspending.js";
+import { BUDGET_HOLDS_TABLE as Nn, BudgetHoldExpired as Pn, DEFAULT_BUDGET_HOLD_TIMEOUT_MS as Fn, _voltroBudgetHoldsTable as In, budgetHoldGeneration as Ln, budgetHoldKey as Rn, budgetHoldSignalName as zn, heldBudgets as Bn, pendingBudgetHolds as Vn, releaseBudgetHolds as Hn, suspendForBudget as Un } from "./budgetHold.js";
+import { awaitUpdate as Wn } from "./updates.js";
+import { inspectWorkflow as Gn } from "./inspectWorkflow.js";
+import { makeInMemoryRecorder as Kn } from "./inMemoryRecorder.js";
+import { DEFAULT_MAX_RUN_RECLAIMS as qn, DEFAULT_REPLAY_SHAPE_LIMIT as Jn, makeWorkflowRunRecorder as Yn, normaliseWorkflowPatches as Xn, resolveRunGuardTuning as Zn, serialiseWorkflowRowForWire as Qn, truncateWorkflowValue as $n, wrapWorkflowExecuteWithRunRecording as er } from "./runRecording.js";
+import { recordWorkflowExecutionRefusal as tr } from "./executionRefusal.js";
+export { et as ADMISSIONS_TABLE, Ie as ADMISSION_SUBMISSION_ID_PREFIX, Nn as BUDGET_HOLDS_TABLE, Pn as BudgetHoldExpired, Zt as CANCEL_ON_WATERMARK, un as CLUSTER_REREAD_WINDOW_MS, dn as ClusterDiagnostics, C as CurrentWorkflowExecutionId, w as CurrentWorkflowPatches, I as CurrentWorkflowReplayShape, T as CurrentWorkflowRunId, E as CurrentWorkflowStep, Fn as DEFAULT_BUDGET_HOLD_TIMEOUT_MS, Qt as DEFAULT_COLD_LOOKBACK_MS, pn as DEFAULT_DRAIN_BATCH, $t as DEFAULT_EVENT_BATCH, tt as DEFAULT_LEASE_MS, qn as DEFAULT_MAX_RUN_RECLAIMS, Jn as DEFAULT_REPLAY_SHAPE_LIMIT, on as DEFAULT_STALL_AFTER_MS, sn as DEFAULT_STALL_EVENT_LOOKBACK, cn as DEFAULT_STALL_RUN_PAGE, _n as DEFAULT_SUSPEND_HINT_MS, M as DEFAULT_WORKFLOW_SCHEDULE_MAX_RUNTIME_MS, _ as DEFERRING_CONTROLS, en as EVENTS_TABLE, we as FlowControlKeyError, nt as PAUSES_TABLE, rt as PENDING_TABLE, i as STEP_JOURNAL_BINDING, Le as SUBMISSIONS_TABLE, wn as SuspensionUnavailable, tn as WATERMARKS_TABLE, a as WORKFLOW_JOURNAL_BINDING, Tn as WorkflowCannotPark, B as WorkflowFlowControlProperty, V as WorkflowMessagesProperty, D as WorkflowRunRecorder, N as WorkflowScheduleProperty, Je as WorkflowStartRequestConflictError, O as WorkflowStepInterceptorTag, H as WorkflowVersionTypeId, U as WorkflowWorkerLayerTypeId, In as _voltroBudgetHoldsTable, me as _voltroWorkflowAdmissionLocksTable, he as _voltroWorkflowAdmissionsTable, ge as _voltroWorkflowControlRequestsTable, _e as _voltroWorkflowFailureReportsTable, ve as _voltroWorkflowParentClosuresTable, ye as _voltroWorkflowPausesTable, be as _voltroWorkflowPendingTable, fe as _voltroWorkflowRunEventsTable, de as _voltroWorkflowRunStepsTable, ue as _voltroWorkflowRunsTable, pe as _voltroWorkflowStartContextsTable, xe as _voltroWorkflowStartReceiptsTable, Se as _voltroWorkflowSubmissionsTable, Jt as _voltroWorkflowWatermarksTable, mn as acceptAdmissionSubmission, Tt as acceptWorkflowControlInTransaction, Re as acknowledgeAdmissionSubmission, it as admissionLeaseHeldPredicate, Kt as admitStart, at as allIntents, v as assertConsistentPools, t as attachPreparedWorkflowExecution, Cn as awaitEvent, Sn as awaitSignal, An as awaitSignalSuspending, Wn as awaitUpdate, ze as beginAdmissionSubmissionDispatchInTransaction, Et as beginWorkflowControlDispatchInTransaction, Dt as bindWorkflowResumeJournalInTransaction, Ye as bindWorkflowStartReceipts, Ln as budgetHoldGeneration, Rn as budgetHoldKey, zn as budgetHoldSignalName, Bt as cancelQueuedWorkflowStartInTransaction, Ft as cancelSuspendedWorkflowRunInTransaction, Te as comparePendingOrder, jn as completeSuspendingSignal, It as completeWorkflowRunGenerationInTransaction, k as currentWorkflowStep, ot as deadLetterIntent, Ee as decideAdmission, y as deferringControlsOf, st as deleteIntent, fn as describeStalledRun, ct as discardIntent, lt as discardIntentInTransaction, hn as drainTick, ut as dueIntents, W as durableClock, G as durableQueue, K as durableQueueModule, Lt as enterWorkflowRunGenerationInTransaction, dt as evaluateAdmission, n as executePreparedWorkflow, e as failureMessage, A as getCurrentWorkflowExecutionId, j as getCurrentWorkflowRunId, q as getWorkflowFlowControl, o as getWorkflowJournalCipher, P as getWorkflowSchedule, J as getWorkflowVersionMetadata, Pe as handoffWorkflowFailureInTransaction, b as hasCancelOn, x as hasFlowControl, r as hasPreparedWorkflowExecution, Bn as heldBudgets, le as inMemoryWorkflowEngineLayer, Ht as inspectAdmissionSubmissionRetry, Gn as inspectWorkflow, Y as isCarrier, De as isFinishExpired, s as isSealedJournalValue, Oe as isStartExpired, gn as isUnacknowledgedSubmission, c as isWorkflowEncrypted, X as isWorkflowWorkerLayer, qt as linkExecution, Kn as makeInMemoryRecorder, L as makeReplayShapeTracker, Yn as makeWorkflowRunRecorder, En as makeWorkflowUpdateId, vn as maybeHintSuspendingSignal, Be as newAdmissionSubmissionId, Yt as newestEventAt, ke as nextSlotAt, R as nondeterminismEventPayload, Xn as normaliseWorkflowPatches, Ve as noteAdmissionSubmissionFailure, ft as noteIntentAttempt, l as openErrorText, u as openEventPayload, d as openJournalValue, f as openPayloadFields, p as openWorkflowRow, pt as parkDelayedStart, Z as patch, mt as pauseWorkflow, He as pendingAdmissionSubmissions, Vn as pendingBudgetHolds, ht as pendingSlotId, gt as pendingWindow, _t as persistDefer, Xt as planCancellations, Ae as pooledConcurrencyKey, Ue as prepareAdmissionSubmissionExecutionInTransaction, Q as processQueue, vt as pruneAdmissions, $ as queueWorker, Rt as queuedCancellationRequestsTable, ee as rateLimit, yt as readAdmissionState, We as readAdmissionSubmission, bt as readPausedWorkflows, Vt as readQueuedWorkflowCancellationInTransaction, nn as readWatermark, Ot as readWorkflowControlInTransaction, Me as readWorkflowFailureRecord, At as readWorkflowRestartObservationInTransaction, Xe as readWorkflowStartReceipt, Ze as readWorkflowStartRequest, Fe as reconcileWorkflowFailureInTransaction, xt as recordAdmission, tr as recordWorkflowExecutionRefusal, Ne as recordWorkflowFailureInTransaction, Qe as recordWorkflowStartReceipt, Ge as rejectAdmissionSubmissionInTransaction, Hn as releaseBudgetHolds, St as releaseLease, z as reportNondeterminism, Ke as reserveAdmissionSubmission, qe as reserveAdmissionSubmissionInTransaction, jt as reserveWorkflowRestartInTransaction, yn as resetSuspendHintsForTest, je as resolveAdmissionKeys, Zn as resolveRunGuardTuning, bn as resolveSuspendHintMs, Dn as resolveWorkflowMessageRun, $e as resolveWorkflowStartReceipt, Ct as resumeWorkflow, Ut as retryAdmissionSubmissionInTransaction, wt as retryDeadLetterIntent, m as sealJournalValue, On as sendWorkflowSignal, kn as sendWorkflowUpdate, Qn as serialiseWorkflowRowForWire, xn as setSuspendSignalHintMs, h as setWorkflowJournalCipher, te as sleep, ne as sleepUntil, kt as stageWorkflowParentClosureInTransaction, re as step, ie as stepIdempotencyKey, ae as stepModule, Un as suspendForBudget, Mn as suspendingSignalDeferredName, rn as sweepCancelOn, ln as sweepStalledRuns, Wt as takeAdmittedSubmissionInTransaction, Gt as takePendingAdmissionSubmission, $n as truncateWorkflowValue, g as tryOpenJournalValue, S as validateFlowControl, F as validateWorkflowSchedule, Ce as withAdmissionTransaction, oe as withCompensation, Mt as withdrawWorkflowRestartInTransaction, se as workflow, zt as workflowJournalRoutingTable, ce as workflowModule, Nt as workflowRestartRequestsTable, Pt as workflowRestartWithdrawalsTable, er as wrapWorkflowExecuteWithRunRecording, an as writeWatermark };

package/dist/journalRoutingGuard.js

@@ -0,0 +1,50 @@
+import { Context as e, Deferred as t, Effect as n, Option as r, Schedule as i, Semaphore as a } from "effect";
+//#region src/journalRoutingGuard.ts
+var o = (e) => n.gen(function* () {
+	let r = e.pollMs ?? 1e3, o = e.verify;
+	if (!Number.isSafeInteger(r) || r < 1 || r > 3e4) return yield* n.fail(/* @__PURE__ */ Error("Invalid journal routing probe interval"));
+	let s = yield* t.make(), c = /* @__PURE__ */ new Set(), l = yield* a.make(1), u = !1, d = (e) => n.gen(function* () {
+		u = !0, yield* t.fail(s, Error(e));
+	}), f = l.withPermits(1)(n.gen(function* () {
+		if (u) return yield* t.await(s);
+		let e = yield* n.interruptible(o).pipe(n.timeout(r), n.isSuccess);
+		if (u) return yield* t.await(s);
+		if (!e) return yield* d("Journal routing lock ownership was lost"), yield* t.await(s);
+	})), p = (e) => n.uninterruptibleMask((r) => n.gen(function* () {
+		if (u) return yield* t.await(s);
+		let i = yield* t.make();
+		return c.add(i), yield* r(f.pipe(n.andThen(n.suspend(() => u ? t.await(s) : n.raceFirst(e, n.interruptible(t.await(s))))))).pipe(n.ensuring(n.gen(function* () {
+			c.delete(i), yield* t.succeed(i, void 0);
+		})));
+	})), m = (e) => n.uninterruptibleMask((r) => n.gen(function* () {
+		if (u) return yield* t.await(s);
+		let i = yield* t.make();
+		c.add(i);
+		let a = new AbortController(), o = Promise.resolve().then(() => {
+			if (u) throw Error("Journal routing admission is closed");
+			return e(a.signal);
+		});
+		return yield* r(n.tryPromise({
+			try: () => o,
+			catch: (e) => e
+		})).pipe(n.ensuring(n.gen(function* () {
+			a.abort(), yield* n.promise(() => o.then(() => void 0, () => void 0)), c.delete(i), yield* t.succeed(i, void 0);
+		})));
+	})), h = n.gen(function* () {
+		yield* d("Journal routing admission is closed"), yield* n.forEach([...c], (e) => t.await(e), { discard: !0 });
+	});
+	return yield* n.addFinalizer(() => h), yield* f.pipe(n.ignore, n.repeat(i.spaced(r)), n.forkScoped), {
+		run: p,
+		ownPromise: m,
+		check: f,
+		close: h,
+		isClosed: () => u
+	};
+}), s = e.Service("@voltro/workflow/JournalRoutingGuard"), c = (e, t) => e === void 0 ? t : n.gen(function* () {
+	return yield* yield* e.run(n.exit(t.pipe(n.provideService(s, e)))).pipe(n.orDie);
+}), l = (e) => n.flatMap(n.serviceOption(s), (t) => r.isSome(t) ? t.value.ownPromise(e).pipe(n.orDie) : n.promise(e)), u = (e) => n.flatMap(n.serviceOption(s), (t) => r.isSome(t) ? t.value.ownPromise(e) : n.tryPromise({
+	try: e,
+	catch: (e) => e
+}));
+//#endregion
+export { s as JournalRoutingGuard, o as makeJournalRoutingGuard, l as ownedJournalRoutingPromise, c as protectJournalRoutingEffect, u as tryOwnedJournalRoutingPromise };

package/dist/journalRoutingLayout.js

@@ -0,0 +1,47 @@
+//#region src/journalRoutingLayout.ts
+var e = (e) => {
+	if (e !== "default" && e !== "api-workloads-v1") throw Error("Unknown journal routing layout");
+	let t = e === "api-workloads-v1";
+	return Object.freeze({
+		id: e,
+		workflowGroup: "default",
+		webhookGroup: t ? "voltro.webhooks" : "default",
+		cronGroup: t ? "voltro.schedules" : "default",
+		available: Object.freeze(t ? [
+			"default",
+			"voltro.webhooks",
+			"voltro.schedules"
+		] : ["default"])
+	});
+}, t = (t, n) => {
+	let r = e(t), i = e(n), a = [];
+	return r.webhookGroup !== i.webhookGroup && a.push({
+		entity: "workflow",
+		name: "voltro.deliverWebhook",
+		from: r.webhookGroup,
+		to: i.webhookGroup
+	}), r.cronGroup !== i.cronGroup && a.push({
+		entity: "cron",
+		name: "*",
+		from: r.cronGroup,
+		to: i.cronGroup
+	}), Object.freeze(a.map((e) => Object.freeze(e)));
+}, n = (t, n) => {
+	let r = e(t);
+	return n === "voltro.deliverWebhook" ? r.webhookGroup : r.workflowGroup;
+}, r = (t, n) => {
+	let r = e(t), i = [
+		n.workflows,
+		n.schedules,
+		n.webhooks
+	];
+	if (i.some((e) => typeof e != "boolean")) throw Error("Explicit executor selection is required");
+	if (t === "default" && i.some(Boolean) && !i.every(Boolean)) throw Error("Separate executor roles require the api-workloads-v1 journal routing transition");
+	let a = /* @__PURE__ */ new Set();
+	return n.workflows && a.add(r.workflowGroup), n.schedules && a.add(r.cronGroup), n.webhooks && a.add(r.webhookGroup), Object.freeze({
+		available: r.available,
+		assigned: Object.freeze([...a])
+	});
+};
+//#endregion
+export { r as journalExecutorGroups, e as journalRoutingLayout, t as journalRoutingTransitions, n as journalWorkflowGroup };

package/dist/journalRoutingLock.js

@@ -0,0 +1,39 @@
+import { Effect as e } from "effect";
+import { SqlClient as t } from "effect/sql";
+import { fnv1a64 as n } from "@voltro/database/sql";
+//#region src/journalRoutingLock.ts
+var r = (r) => e.gen(function* () {
+	let i = r.namespace, a = r.mode, o = r.timeoutMs ?? 3e4;
+	if (!i || i.length > 256 || !["shared", "exclusive"].includes(a) || !Number.isSafeInteger(o) || o < 1 || o > 3e5) return yield* e.fail(/* @__PURE__ */ Error("Invalid journal routing lock options"));
+	let s = yield* t.SqlClient, c = s.onDialectOrElse({
+		pg: () => "pg",
+		mssql: () => "mssql",
+		orElse: () => "unsupported"
+	});
+	if (c === "unsupported") return yield* e.fail(/* @__PURE__ */ Error("Journal routing locks require PostgreSQL or SQL Server"));
+	let l = (n("voltro:journal-routing:" + i) & 9223372036854775807n).toString(), u = "voltro-journal-routing-" + l, d = yield* s.reserve, f = a === "shared" ? "_shared" : "", p = c === "pg" ? `SELECT pg_try_advisory_lock${f}(${l}::bigint)` : `DECLARE @res int; EXEC @res = sp_getapplock @Resource = '${u}', @LockMode = '${a === "shared" ? "Shared" : "Exclusive"}', @LockOwner = 'Session', @LockTimeout = 0; SELECT @res`, m = c === "pg" ? `SELECT pg_advisory_unlock${f}(${l}::bigint)` : `DECLARE @res int; EXEC @res = sp_releaseapplock @Resource = '${u}', @LockOwner = 'Session'; SELECT @res`, h = performance.now(), g = e.gen(function* () {
+		for (;;) {
+			let t = (yield* d.executeValues(p, []))[0]?.[0];
+			if (c === "pg" ? t === !0 || t === "t" || t === 1 : typeof t == "number" && t >= 0) return;
+			if (c === "mssql" && t !== -1) return yield* e.fail(/* @__PURE__ */ Error("Journal routing application lock failed"));
+			let n = o - (performance.now() - h);
+			if (n <= 0) return yield* e.fail(/* @__PURE__ */ Error("Journal routing lock acquisition timed out"));
+			yield* e.sleep(Math.min(n, 100));
+		}
+	});
+	yield* e.acquireRelease(g, () => d.executeValues(m, []).pipe(e.flatMap((t) => {
+		let n = t[0]?.[0];
+		return (c === "pg" ? n === !0 || n === "t" || n === 1 : typeof n == "number" && n >= 0) ? e.void : e.die(/* @__PURE__ */ Error("Journal routing lock was lost before release"));
+	}), e.orDie));
+	let _ = c === "pg" ? `SELECT EXISTS (SELECT 1 FROM pg_locks WHERE locktype = 'advisory' AND pid = pg_backend_pid() AND granted AND classid = (${l}::bigint >> 32)::oid AND objid = (${l}::bigint & 4294967295)::oid AND objsubid = 1 AND mode = '${a === "shared" ? "ShareLock" : "ExclusiveLock"}')` : `SELECT APPLOCK_MODE('public', '${u}', 'Session')`;
+	return {
+		connection: d,
+		dialect: c,
+		verify: d.executeValues(_, []).pipe(e.flatMap((t) => {
+			let n = t[0]?.[0];
+			return (c === "pg" ? n === !0 || n === "t" || n === 1 : n === (a === "shared" ? "Shared" : "Exclusive")) ? e.void : e.fail(/* @__PURE__ */ Error("Journal routing lock ownership was lost"));
+		}))
+	};
+});
+//#endregion
+export { r as acquireJournalRoutingLock };

package/dist/journalRoutingMaintenance.js

@@ -0,0 +1,24 @@
+import { withJournalRoutingTransaction as e } from "./journalRoutingTransaction.js";
+import { acquireJournalRoutingLock as t } from "./journalRoutingLock.js";
+import { JournalRoutingMaintenance as n } from "./workflowShardRelocationSql.js";
+import { Effect as r, Option as i } from "effect";
+import { SqlClient as a } from "effect/sql";
+//#region src/journalRoutingMaintenance.ts
+var o = (o, s = 3e4) => r.gen(function* () {
+	let c = yield* a.SqlClient;
+	return c.onDialectOrElse({
+		pg: () => !0,
+		orElse: () => !1
+	}) ? n.of({ exclusive: (n) => r.scoped(r.gen(function* () {
+		let a = yield* r.serviceOption(c.transactionService);
+		if (i.isSome(a)) return yield* r.fail(/* @__PURE__ */ Error("Journal maintenance cannot enter an ambient transaction"));
+		let { connection: l } = yield* t({
+			namespace: o,
+			mode: "exclusive",
+			timeoutMs: s
+		});
+		return yield* e(c, l, n);
+	})).pipe(r.provideService(a.SqlClient, c)) }) : yield* r.fail(/* @__PURE__ */ Error("Pinned journal maintenance currently requires PostgreSQL"));
+});
+//#endregion
+export { o as makePostgresJournalRoutingMaintenance };

package/dist/journalRoutingMessageStorage.js

@@ -0,0 +1,32 @@
+import { protectJournalRoutingEffect as e } from "./journalRoutingGuard.js";
+import { Effect as t } from "effect";
+import { MessageStorage as n } from "effect/cluster";
+import { PersistenceError as r } from "effect/cluster/ClusterError";
+//#region src/journalRoutingMessageStorage.ts
+var i = (i, a) => {
+	let o = (e) => t.gen(function* () {
+		return yield* yield* a.run(t.exit(e)).pipe(t.mapError((e) => new r({ cause: e })));
+	});
+	return n.MessageStorage.of({
+		saveRequest: (e) => o(t.suspend(() => i.saveRequest(e))),
+		saveEnvelope: (e) => o(t.suspend(() => i.saveEnvelope(e))),
+		saveReply: (e) => o(t.suspend(() => i.saveReply(e))),
+		clearReplies: (e) => o(t.suspend(() => i.clearReplies(e))),
+		repliesFor: (e) => o(t.suspend(() => i.repliesFor(e))),
+		repliesForUnfiltered: (e) => o(t.suspend(() => i.repliesForUnfiltered(e))),
+		requestIdForPrimaryKey: (e) => o(t.suspend(() => i.requestIdForPrimaryKey(e))),
+		unprocessedMessages: (e) => o(t.suspend(() => i.unprocessedMessages(e))),
+		unprocessedMessagesById: (e) => o(t.suspend(() => i.unprocessedMessagesById(e))),
+		resetShards: (e) => o(t.suspend(() => i.resetShards(e))),
+		resetRequests: (e) => o(t.suspend(() => i.resetRequests(e))),
+		resetAddresses: (e) => o(t.suspend(() => i.resetAddresses(e))),
+		withTransaction: (t) => e(a, i.withTransaction(t)),
+		resetAddress: (e) => o(t.suspend(() => i.resetAddress(e))),
+		clearAddress: (e) => o(t.suspend(() => i.clearAddress(e))),
+		registerReplyHandler: (e) => i.registerReplyHandler(e),
+		unregisterReplyHandler: (e) => i.unregisterReplyHandler(e),
+		unregisterShardReplyHandlers: (e) => i.unregisterShardReplyHandlers(e)
+	});
+};
+//#endregion
+export { i as guardJournalMessageStorage };

package/dist/journalRoutingNamespace.js

@@ -0,0 +1,23 @@
+import { workflowJournalRoutingTable as e } from "./journalRoutingTable.js";
+import { Effect as t } from "effect";
+import { SqlClient as n } from "effect/sql";
+//#region src/journalRoutingNamespace.ts
+var r = t.gen(function* () {
+	let r = (yield* n.SqlClient).withoutTransforms();
+	if (!r.onDialectOrElse({
+		pg: () => !0,
+		orElse: () => !1
+	})) return yield* t.fail(/* @__PURE__ */ Error("Journal namespace resolution requires PostgreSQL"));
+	let i = yield* r`
+    SELECT n.nspname AS schema_name, current_schema() AS active_schema, c.relkind AS kind,
+      format('%I.%I', n.nspname, ${e.tableName}::text) AS routing_table
+    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE c.oid = to_regclass('cluster_messages')`, a = i[0];
+	return i.length !== 1 || !a || a.kind !== "r" || a.schema_name !== a.active_schema ? yield* t.fail(/* @__PURE__ */ Error("Journal table must exist in the active PostgreSQL schema without search-path fallback")) : Object.freeze({
+		namespace: `pg:${a.schema_name}:cluster_messages`,
+		schema: a.schema_name,
+		routingTable: r.literal(a.routing_table)
+	});
+}), i = r.pipe(t.map((e) => e.namespace));
+//#endregion
+export { r as resolvePostgresJournalLocation, i as resolvePostgresJournalNamespace };

package/dist/journalRoutingRuntime.js

@@ -0,0 +1,33 @@
+import { journalRoutingLayout as e, journalWorkflowGroup as t } from "./journalRoutingLayout.js";
+import { Context as n } from "effect";
+import { ClusterSchema as r } from "effect/cluster";
+//#region src/journalRoutingRuntime.ts
+var i = class extends n.Service()("@voltro/workflow/JournalRoutingLayout") {}, a = (e, i) => {
+	let a = n.add(e.annotations, r.ShardGroup, () => t(i, e._tag));
+	return new Proxy(e, { get(e, t, n) {
+		return t === "annotations" ? a : Reflect.get(e, t, n);
+	} });
+}, o = (t, n) => (e(n), {
+	...t,
+	register: (e, r) => t.register(a(e, n), r),
+	execute: (e, r) => t.execute(a(e, n), r),
+	poll: (e, r) => t.poll(a(e, n), r),
+	interrupt: (e, r) => t.interrupt(a(e, n), r),
+	resume: (e, r) => t.resume(a(e, n), r),
+	scheduleClock: (e, r) => t.scheduleClock(a(e, n), r)
+}), s = (n, i) => {
+	let a = e(i), o = (e) => e.startsWith("Workflow/") && !e.startsWith("Workflow/-/") ? t(i, e.slice(9)) : e.startsWith("ClusterCron/") ? a.cronGroup : void 0;
+	return {
+		...n,
+		makeClient: (e) => {
+			let t = o(e.type);
+			return n.makeClient(t === void 0 ? e : e.annotate(r.ShardGroup, () => t));
+		},
+		registerEntity: (e, t, i) => {
+			let a = o(e.type);
+			return n.registerEntity(a === void 0 ? e : e.annotate(r.ShardGroup, () => a), t, i);
+		}
+	};
+};
+//#endregion
+export { i as JournalRoutingLayout, a as routeJournalWorkflow, s as withJournalEntityRouting, o as withJournalWorkflowRouting };

package/dist/journalRoutingSharding.js

@@ -0,0 +1,28 @@
+import { protectJournalRoutingEffect as e } from "./journalRoutingGuard.js";
+import { Effect as t, Stream as n } from "effect";
+import { Rpc as r, RpcSchema as i } from "effect/rpc";
+//#region src/journalRoutingSharding.ts
+var a = (a, o) => {
+	let s = (i) => {
+		if (typeof i == "object" && i && r.isWrapper(i)) return {
+			...i,
+			value: s(i.value)
+		};
+		if (t.isEffect(i)) return e(o, i);
+		if (n.isStream(i)) {
+			let r = i;
+			return n.unwrap(t.map(e(o, n.toPull(r)), (r) => n.fromPull(t.succeed(e(o, r)))));
+		}
+		throw Error("Cluster handler must return an Effect, Stream or RPC wrapper");
+	};
+	return {
+		...a,
+		registerEntity: (r, c, l) => e(o, t.suspend(() => a.registerEntity(r, c.pipe(t.map((e) => new Proxy(e, { get(e, a, c) {
+			let l = Reflect.get(e, a, c), u = typeof a == "string" ? r.protocol.requests.get(a) : void 0;
+			return !u || typeof l != "function" ? l : (...r) => o.isClosed() ? i.isStreamSchema(u.successSchema) ? n.fromEffect(t.interrupt) : t.interrupt : s(Reflect.apply(l, e, r));
+		} }))), l))),
+		registerSingleton: (n, r, i) => e(o, t.suspend(() => a.registerSingleton(n, e(o, r), i)))
+	};
+};
+//#endregion
+export { a as withJournalRoutingGuard };