@voltro/workflow 0.86.0 → 0.88.0

package/dist/journalRoutingLock.js

@@ -0,0 +1,38 @@
+import { Effect as e } from "effect";
+import { SqlClient as t } from "effect/sql";
+import { fnv1a64 as n } from "@voltro/database/sql";
+// 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"));
+		}))
+	};
+});
+export { r as acquireJournalRoutingLock };

package/dist/journalRoutingMaintenance.js

@@ -0,0 +1,23 @@
+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";
+// 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"));
+});
+export { o as makePostgresJournalRoutingMaintenance };

package/dist/journalRoutingMessageStorage.js

@@ -0,0 +1,31 @@
+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";
+// 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)
+	});
+};
+export { i as guardJournalMessageStorage };

package/dist/journalRoutingNamespace.js

@@ -0,0 +1,22 @@
+import { workflowJournalRoutingTable as e } from "./journalRoutingTable.js";
+import { Effect as t } from "effect";
+import { SqlClient as n } from "effect/sql";
+// 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));
+export { r as resolvePostgresJournalLocation, i as resolvePostgresJournalNamespace };

package/dist/journalRoutingRuntime.js

@@ -0,0 +1,32 @@
+import { journalRoutingLayout as e, journalWorkflowGroup as t } from "./journalRoutingLayout.js";
+import { Context as n } from "effect";
+import { ClusterSchema as r } from "effect/cluster";
+// 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);
+		}
+	};
+};
+export { i as JournalRoutingLayout, a as routeJournalWorkflow, s as withJournalEntityRouting, o as withJournalWorkflowRouting };

package/dist/journalRoutingSharding.js

@@ -0,0 +1,27 @@
+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";
+// 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)))
+	};
+};
+export { a as withJournalRoutingGuard };

package/dist/journalRoutingState.js

@@ -0,0 +1,92 @@
+import { makeJournalRoutingGuard as e } from "./journalRoutingGuard.js";
+import { workflowJournalRoutingRowId as t, workflowJournalRoutingTable as n } from "./journalRoutingTable.js";
+import { journalRoutingLayout as r, journalRoutingTransitions as i } from "./journalRoutingLayout.js";
+import { withJournalRoutingTransaction as a } from "./journalRoutingTransaction.js";
+import { resolvePostgresJournalLocation as o, resolvePostgresJournalNamespace as s } from "./journalRoutingNamespace.js";
+import { acquireJournalRoutingLock as c } from "./journalRoutingLock.js";
+import { JournalRoutingMaintenance as l, relocateWorkflowJournal as u } from "./workflowShardRelocationSql.js";
+import { makePostgresJournalRoutingMaintenance as d } from "./journalRoutingMaintenance.js";
+import { Effect as f, Option as p } from "effect";
+import { SqlClient as m } from "effect/sql";
+// src/journalRoutingState.ts
+var h = (e, t) => f.gen(function* () {
+	let r = yield* e`SELECT c.relkind AS kind
+    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE n.nspname = ${t} AND c.relname = ${n.tableName}`;
+	return r.length === 0 ? !1 : r.length !== 1 || r[0]?.kind !== "r" ? yield* f.fail(/* @__PURE__ */ Error("Journal routing metadata must be a table in the journal schema")) : !0;
+}), g = (e) => {
+	if (!Number.isSafeInteger(e.generation) || e.generation < 0 || e.generation >= 2 ** 53 - 1 || !/^[a-z][a-z0-9._-]{0,63}$/.test(e.layout)) throw Error("Invalid journal routing state");
+	return r(e.layout), Object.freeze({
+		generation: e.generation,
+		layout: e.layout
+	});
+}, _ = (e) => f.gen(function* () {
+	let n = yield* f.sync(() => g(e.expected)), r = yield* f.sync(() => g({
+		generation: n.generation + 1,
+		layout: e.nextLayout
+	})), a = yield* f.sync(() => i(n.layout, r.layout)), c = yield* m.SqlClient, p = c.withoutTransforms(), _ = yield* s, v = yield* d(_), y = l.of({ exclusive: (e) => v.exclusive(f.gen(function* () {
+		let i = yield* o;
+		if (i.namespace !== _) return yield* f.fail(/* @__PURE__ */ Error("Journal namespace changed during maintenance acquisition"));
+		if (yield* p`SELECT pg_advisory_xact_lock(6322741009312602::bigint)`, !(yield* h(p, i.schema))) return yield* f.fail(/* @__PURE__ */ Error("Workflow journal routing table is missing; apply the app schema first"));
+		yield* p`INSERT INTO ${i.routingTable} (id, namespace, generation, layout, relocation)
+      VALUES (${t(_)}, ${_}, 0, 'default', '[]') ON CONFLICT (namespace) DO NOTHING`;
+		let [s] = yield* p`
+      SELECT generation, layout FROM ${i.routingTable} WHERE namespace = ${_} FOR UPDATE`;
+		if (!s || String(s.generation) !== String(n.generation) || s.layout !== n.layout) return yield* f.fail(/* @__PURE__ */ Error("Journal routing generation changed; transition refused"));
+		let c = yield* e;
+		return yield* p`UPDATE ${i.routingTable} SET generation = ${r.generation}, layout = ${r.layout},
+      relocation = ${JSON.stringify(a)} WHERE namespace = ${_}`, c;
+	}).pipe(f.provideService(m.SqlClient, c))) });
+	return {
+		...yield* u(a).pipe(f.provideService(l, y)),
+		state: r
+	};
+}), v = () => f.gen(function* () {
+	let e = yield* m.SqlClient;
+	if (p.isSome(yield* f.serviceOption(e.transactionService))) return yield* f.fail(/* @__PURE__ */ Error("Journal routing admission cannot enter an ambient transaction"));
+	if (!e.onDialectOrElse({
+		pg: () => !0,
+		orElse: () => !1
+	})) return yield* f.fail(/* @__PURE__ */ Error("Journal routing generation admission currently requires PostgreSQL"));
+	let t = yield* s, n = yield* c({
+		namespace: t,
+		mode: "shared"
+	}), r = yield* a(e, n.connection, f.gen(function* () {
+		let n = yield* o;
+		if (n.namespace !== t) return yield* f.fail(/* @__PURE__ */ Error("Journal namespace changed during runtime admission"));
+		if (!(yield* h(e, n.schema))) return {
+			generation: 0,
+			layout: "default"
+		};
+		let r = yield* e`
+        SELECT generation, layout FROM ${n.routingTable} WHERE namespace = ${t}`;
+		return r.length === 0 ? {
+			generation: 0,
+			layout: "default"
+		} : r.length === 1 ? yield* f.sync(() => g({
+			generation: Number(r[0]?.generation),
+			layout: String(r[0]?.layout)
+		})) : yield* f.fail(/* @__PURE__ */ Error("Journal routing metadata has duplicate namespace rows"));
+	}));
+	return {
+		...n,
+		state: r,
+		namespace: t
+	};
+}), y = f.gen(function* () {
+	let e = yield* v();
+	return {
+		namespace: e.namespace,
+		state: e.state
+	};
+}), b = (e) => f.gen(function* () {
+	let t = yield* f.sync(() => g(e)), n = yield* v();
+	return n.state.generation !== t.generation || n.state.layout !== t.layout ? yield* f.fail(/* @__PURE__ */ Error("Journal routing generation does not match this runtime")) : n;
+}), x = (t) => f.gen(function* () {
+	let n = yield* b(t), r = yield* e({ verify: n.verify });
+	return {
+		...n,
+		...r
+	};
+});
+export { x as acquireGuardedPostgresJournalRoutingAdmission, b as acquirePostgresJournalRoutingAdmission, g as captureJournalRoutingState, y as readPostgresJournalRoutingState, _ as transitionPostgresJournalRouting };

package/dist/journalRoutingTable.js

@@ -0,0 +1,10 @@
+import { bigint as e, derivedRowId as t, id as n, table as r, text as i } from "@voltro/database";
+// src/journalRoutingTable.ts
+var a = r("_voltro_workflow_journal_routing", {
+	id: n({ prefix: "wfjr" }),
+	namespace: i(),
+	generation: e(),
+	layout: i(),
+	relocation: i()
+}).unique(["namespace"]).nonReactive(), o = (e) => t("wfjr", e);
+export { o as workflowJournalRoutingRowId, a as workflowJournalRoutingTable };

package/dist/journalRoutingTransaction.js

@@ -0,0 +1,15 @@
+import { Effect as e } from "effect";
+import { SqlClient as t } from "effect/sql";
+// src/journalRoutingTransaction.ts
+var n = (n, r, i) => t.makeWithTransaction({
+	transactionService: n.transactionService,
+	spanAttributes: [],
+	acquireConnection: () => e.succeed(r),
+	begin: (t) => t.executeUnprepared("BEGIN", [], void 0).pipe(e.asVoid),
+	commit: (t) => t.executeUnprepared("COMMIT", [], void 0).pipe(e.asVoid),
+	rollback: (t) => t.executeUnprepared("ROLLBACK", [], void 0).pipe(e.asVoid),
+	savepoint: (t, n) => t.executeUnprepared(`SAVEPOINT voltro_routing_${n}`, [], void 0).pipe(e.asVoid),
+	rollbackSavepoint: (t, n) => t.executeUnprepared(`ROLLBACK TO SAVEPOINT voltro_routing_${n}`, [], void 0).pipe(e.asVoid),
+	releaseSavepoint: (t, n) => t.executeUnprepared(`RELEASE SAVEPOINT voltro_routing_${n}`, [], void 0).pipe(e.asVoid)
+})(i);
+export { n as withJournalRoutingTransaction };

package/dist/messages.js

@@ -1,6 +1,6 @@
 import { openEventPayload as e } from "./journalEncryption.js";
 import { eq as t } from "@voltro/database";
-//#region src/messages.ts
+// src/messages.ts
 var n = (e) => new Promise((t) => setTimeout(t, e)), r = () => {
 	let e = globalThis.crypto;
 	return typeof e?.randomUUID == "function" ? e.randomUUID() : `${Date.now().toString(36)}${Math.random().toString(36).slice(2)}`;
@@ -88,5 +88,4 @@ var n = (e) => new Promise((t) => setTimeout(t, e)), r = () => {
 		await n(f);
 	}
 };
-//#endregion
 export { o as WorkflowMessageNotRecorded, i as makeWorkflowUpdateId, a as resolveWorkflowMessageRun, s as sendWorkflowSignal, c as sendWorkflowUpdate };

package/dist/nondeterminism.js

@@ -1,6 +1,6 @@
 import { CurrentWorkflowRunId as e, WorkflowRunRecorder as t } from "./recorder.js";
 import { Context as n, Effect as r } from "effect";
-//#region src/nondeterminism.ts
+// src/nondeterminism.ts
 var i = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) t.set(n.stepName, (t.get(n.stepName) ?? 0) + 1);
@@ -47,5 +47,4 @@ var i = (e) => {
 		payload: o(e)
 	}).then(() => void 0).catch(() => void 0));
 });
-//#endregion
 export { a as CurrentWorkflowReplayShape, i as makeReplayShapeTracker, o as nondeterminismEventPayload, s as reportNondeterminism };

package/dist/parentClosure.js

@@ -2,7 +2,7 @@ import { acceptWorkflowControlInTransaction as e, hasUnsettledParentClosureContr
 import { cancelSuspendedWorkflowRunInTransaction as r } from "./runGeneration.js";
 import { Schema as i } from "effect";
 import { and as a, derivedRowId as o, eq as s, gt as c } from "@voltro/database";
-//#region src/parentClosure.ts
+// src/parentClosure.ts
 var l = "_voltro_workflow_parent_closures", u = i.NonEmptyString, d = i.Struct({
 	id: u,
 	runId: u,
@@ -137,5 +137,4 @@ var l = "_voltro_workflow_parent_closures", u = i.NonEmptyString, d = i.Struct({
 		wrapped: y
 	};
 };
-//#endregion
 export { p as stageParentClosureAtChildEntry, m as stageWorkflowParentClosureInTransaction };

package/dist/parentClosureRecovery.js

@@ -1,6 +1,6 @@
 import { stageWorkflowParentClosureInTransaction as e } from "./parentClosure.js";
 import { and as t, eq as n, gt as r, isNull as i } from "@voltro/database";
-//#region src/parentClosureRecovery.ts
+// src/parentClosureRecovery.ts
 var a = "_voltro_workflow_parent_closures", o = /* @__PURE__ */ new WeakMap(), s = async (s, c, l) => {
 	let u = o.get(s), d = await s.store.query({
 		table: a,
@@ -50,5 +50,4 @@ var a = "_voltro_workflow_parent_closures", o = /* @__PURE__ */ new WeakMap(), s
 		examined: d.length > 0
 	});
 };
-//#endregion
 export { s as recoverWorkflowParentClosures };

package/dist/pendingSubmission.js

@@ -3,7 +3,7 @@ import { persistReservedSubmission as t, readAdmissionSubmission as n, reserveAd
 import { bindWorkflowStartReceipts as i } from "./startReceipt.js";
 import { PENDING_TABLE as a, toPendingIntent as o } from "./admissionStore.js";
 import { eq as s } from "@voltro/database";
-//#region src/pendingSubmission.ts
+// src/pendingSubmission.ts
 var c = async (e, r) => {
 	if (new Set(r.intentIds).size !== r.intentIds.length) throw Error("Admitted transfer requires distinct pending identities");
 	let c = await n(e, r.id);
@@ -81,5 +81,4 @@ var c = async (e, r) => {
 		}
 	};
 };
-//#endregion
 export { c as takeAdmittedSubmissionInTransaction, l as takePendingAdmissionSubmission, u as takePendingAdmissionSubmissionInTransaction };

package/dist/prepareSubmissionDispatch.js

@@ -1,5 +1,5 @@
 import { prepareAdmissionSubmissionExecutionInTransaction as e, readAdmissionSubmission as t } from "./admissionSubmission.js";
-//#region src/prepareSubmissionDispatch.ts
+// src/prepareSubmissionDispatch.ts
 var n = async (n, r, i) => {
 	let a = await n.transaction((e) => t(e, r.id));
 	if (a === void 0 || a.workflowName !== r.workflowName || a.tenantId !== r.tenantId || a.ledgerId !== r.ledgerId) throw Error("Submission dispatch lost its resident owner");
@@ -13,5 +13,4 @@ var n = async (n, r, i) => {
 	if (s.preparedExecutionId === null) throw Error("Submission preparation returned no execution identity");
 	return s.preparedExecutionId;
 };
-//#endregion
 export { n as prepareSubmissionDispatch };

package/dist/preparedExecution.js

@@ -1,5 +1,5 @@
 import { Effect as e } from "effect";
-//#region src/preparedExecution.ts
+// src/preparedExecution.ts
 var t = Symbol.for("@voltro/workflow/PreparedExecution"), n = (e, n) => {
 	Object.defineProperty(e, t, {
 		value: n,
@@ -10,5 +10,4 @@ var t = Symbol.for("@voltro/workflow/PreparedExecution"), n = (e, n) => {
 	let o = n[t];
 	return typeof o == "function" ? o(r, i, a?.discard ?? !0) : e.die(/* @__PURE__ */ Error("Workflow definition has no prepared-execution capability"));
 });
-//#endregion
 export { n as attachPreparedWorkflowExecution, i as executePreparedWorkflow, r as hasPreparedWorkflowExecution };

package/dist/primitives.js

@@ -10,7 +10,7 @@ import { Activity as A, Activity as j, DurableClock as M, DurableClock as N, Dur
 import { RateLimiter as L } from "effect/persistence";
 import { Cause as R, Duration as z, Effect as B, Effectable as V, Schema as H } from "effect";
 import { attachWorkflowAccess as U, resolveWorkflowAccess as W } from "@voltro/protocol";
-//#region src/primitives.ts
+// src/primitives.ts
 var G = Symbol.for("voltro.workflow.workerLayer"), K = Symbol.for("voltro.workflow.version"), q = "__voltroWorkflowMessages", J = "__voltroWorkflowFlowControl", Y = (e) => typeof e == "object" && !!e && e[G] === !0, X = (e) => (typeof e == "object" || typeof e == "function") && e !== null, re = (e) => X(e) && e[K] !== void 0 ? e[K] : {
 	version: "1",
 	compatibleWith: ["1"],
@@ -221,5 +221,4 @@ var G = Symbol.for("voltro.workflow.workerLayer"), K = Symbol.for("voltro.workfl
 		execute: i.pipe(B.catchDefect((e) => B.die(s(e, c))))
 	}));
 }, me = (e) => B.map(g, (t) => t.includes(e)), he = F.withCompensation, ge = A.idempotencyKey;
-//#endregion
 export { T as CurrentWorkflowReplayShape, x as DEFAULT_WORKFLOW_SCHEDULE_MAX_RUNTIME_MS, u as DEFERRING_CONTROLS, J as WorkflowFlowControlProperty, q as WorkflowMessagesProperty, S as WorkflowScheduleProperty, K as WorkflowVersionTypeId, G as WorkflowWorkerLayerTypeId, d as assertConsistentPools, f as deferringControlsOf, N as durableClock, oe as durableQueue, te as durableQueueModule, ae as getWorkflowFlowControl, C as getWorkflowSchedule, re as getWorkflowVersionMetadata, p as hasCancelOn, m as hasFlowControl, X as isCarrier, Y as isWorkflowWorkerLayer, E as makeReplayShapeTracker, D as nondeterminismEventPayload, me as patch, se as processQueue, Q as queueWorker, ce as rateLimit, O as reportNondeterminism, $ as sleep, le as sleepUntil, pe as step, ge as stepIdempotencyKey, j as stepModule, h as validateFlowControl, w as validateWorkflowSchedule, he as withCompensation, ie as workflow, ne as workflowModule };

package/dist/queuedCancellationRequest.js

@@ -7,7 +7,7 @@ import { cancelSuspendedWorkflowRunInTransaction as c } from "./runGeneration.js
 import { Schema as l } from "effect";
 import { WorkflowQueuedCancellationResultSchema as u } from "@voltro/protocol";
 import { and as d, derivedRowId as f, eq as p, gt as m, id as h, json as g, table as _, text as v, timestamp as y } from "@voltro/database";
-//#region src/queuedCancellationRequest.ts
+// src/queuedCancellationRequest.ts
 var b = _("_voltro_workflow_queued_cancellations", {
 	id: h({ prefix: "wfqc" }),
 	receiptId: v(),
@@ -360,5 +360,4 @@ var b = _("_voltro_workflow_queued_cancellations", {
 		if (e.length < 100) return a;
 	}
 };
-//#endregion
 export { k as acceptQueuedCancellationInTransaction, A as bindQueuedCancellationRunInTransaction, D as observeQueuedCancellationInTransaction, b as queuedCancellationRequestsTable, O as queuedCancellationResult, w as readQueuedCancellationRequestInTransaction, j as stageQueuedCancellationsAtRunEntry };

package/dist/queuedControl.js

@@ -1,6 +1,6 @@
 import { acceptQueuedCancellationInTransaction as e, observeQueuedCancellationInTransaction as t, queuedCancellationResult as n } from "./queuedCancellationRequest.js";
 import { Schema as r } from "effect";
-//#region src/queuedControl.ts
+// src/queuedControl.ts
 var i = r.Struct({
 	requestId: r.NonEmptyString,
 	receiptId: r.NonEmptyString,
@@ -17,5 +17,4 @@ var i = r.Struct({
 	let o = r.decodeUnknownSync(i)(a);
 	return n(o, await t(e, o));
 };
-//#endregion
 export { a as cancelQueuedWorkflowStartInTransaction, o as readQueuedWorkflowCancellationInTransaction };

package/dist/recorder.js

@@ -1,5 +1,5 @@
 import { Context as e, Effect as t } from "effect";
-//#region src/recorder.ts
+// src/recorder.ts
 var n = class extends e.Service()("@voltro/WorkflowRunRecorder") {}, r = e.Reference("@voltro/workflow/CurrentWorkflowRunId", { defaultValue: () => void 0 }), i = e.Reference("@voltro/workflow/CurrentWorkflowExecutionId", { defaultValue: () => void 0 }), a = e.Reference("@voltro/workflow/CurrentWorkflowStep", { defaultValue: () => void 0 }), o = t.gen(function* () {
 	let e = yield* i, t = yield* a;
 	return e === void 0 || t === void 0 ? void 0 : {
@@ -7,5 +7,4 @@ var n = class extends e.Service()("@voltro/WorkflowRunRecorder") {}, r = e.Refer
 		step: t
 	};
 }), s = e.Reference("@voltro/workflow/CurrentWorkflowGeneration", { defaultValue: () => void 0 }), c = e.Reference("@voltro/workflow/CurrentWorkflowWakeTenant", { defaultValue: () => void 0 }), l = e.Reference("@voltro/workflow/CurrentWorkflowPatches", { defaultValue: () => [] }), u = () => r, d = () => i, f = class extends e.Service()("@voltro/WorkflowStepInterceptor") {};
-//#endregion
 export { i as CurrentWorkflowExecutionId, s as CurrentWorkflowGeneration, l as CurrentWorkflowPatches, r as CurrentWorkflowRunId, a as CurrentWorkflowStep, c as CurrentWorkflowWakeTenant, n as WorkflowRunRecorder, f as WorkflowStepInterceptorTag, o as currentWorkflowStep, d as getCurrentWorkflowExecutionId, u as getCurrentWorkflowRunId };

package/dist/residentExecutionEvidence.js

@@ -1,6 +1,6 @@
 import { Schema as e } from "effect";
 import { eq as t } from "@voltro/database";
-//#region src/residentExecutionEvidence.ts
+// src/residentExecutionEvidence.ts
 var n = e.Struct({
 	runId: e.NonEmptyString,
 	workflowName: e.NonEmptyString,
@@ -60,5 +60,4 @@ var n = e.Struct({
 		completedAt: c.closedAt
 	};
 };
-//#endregion
 export { r as readResidentExecutionEvidence };

package/dist/retryPolicy.js

@@ -1,5 +1,5 @@
 import { Cause as e, Duration as t, Effect as n, Exit as r, Option as i, Schedule as a } from "effect";
-//#region src/retryPolicy.ts
+// src/retryPolicy.ts
 var o = (e) => {
 	if (typeof e != "object" || !e) return;
 	let n = e.retryAfterMillis;
@@ -53,5 +53,4 @@ var o = (e) => {
 		while: i
 	});
 };
-//#endregion
 export { m as applyRetryPolicy, l as retryPolicyIsActive };

package/dist/runEventsTable.js

@@ -1,6 +1,6 @@
 import { _voltroWorkflowRunsTable as e } from "./runsTable.js";
 import { id as t, integer as n, json as r, reference as i, table as a, text as o, timestamp as s } from "@voltro/database";
-//#region src/runEventsTable.ts
+// src/runEventsTable.ts
 var c = a("_voltro_workflow_run_events", {
 	id: t({ prefix: "wfev" }),
 	runId: i(() => e, {
@@ -13,5 +13,4 @@ var c = a("_voltro_workflow_run_events", {
 	stepName: o().nullable(),
 	attempt: n().nullable()
 }).index(["runId", "occurredAt"]).index(["eventType"]);
-//#endregion
 export { c as _voltroWorkflowRunEventsTable };

package/dist/runGeneration.js

@@ -10,7 +10,7 @@ import { stageQueuedCancellationsAtRunEntry as g } from "./queuedCancellationReq
 import { Schema as _ } from "effect";
 import { derivedRowId as v, eq as y } from "@voltro/database";
 import { createHash as b } from "node:crypto";
-//#region src/runGeneration.ts
+// src/runGeneration.ts
 var x = "_voltro_workflow_runs", S = _.NullOr(_.Struct({
 	requestId: _.NonEmptyString,
 	restartToken: _.NullOr(_.NonEmptyString)
@@ -341,5 +341,4 @@ var x = "_voltro_workflow_runs", S = _.NullOr(_.Struct({
 		terminalEvent: w
 	};
 }, A = (e, t) => k(e, t, "running");
-//#endregion
 export { D as cancelSuspendedWorkflowRunInTransaction, A as completeWorkflowRunGenerationInTransaction, w as enterWorkflowRestartGenerationInTransaction, T as enterWorkflowRunGenerationInTransaction, O as suspendWorkflowRunGenerationInTransaction };

package/dist/runRecording.js

@@ -10,7 +10,7 @@ import { Cause as v, Effect as y, Exit as b, Fiber as x } from "effect";
 import { publishServerError as S } from "@voltro/protocol";
 import { eq as C } from "@voltro/database";
 import { WorkflowInstance as w } from "effect/workflow/WorkflowEngine";
-//#region src/runRecording.ts
+// src/runRecording.ts
 var T = 8192, E = 3, D = 2e3, O = () => {
 	let e = (e) => {
 		if (e === void 0) return;
@@ -611,5 +611,4 @@ var T = 8192, E = 3, D = 2e3, O = () => {
 		}))), Q;
 	}));
 };
-//#endregion
 export { E as DEFAULT_MAX_RUN_RECLAIMS, D as DEFAULT_REPLAY_SHAPE_LIMIT, F as makeWorkflowRunRecorder, k as normaliseWorkflowPatches, O as resolveRunGuardTuning, P as serialiseWorkflowRowForWire, M as truncateWorkflowValue, I as wrapWorkflowExecuteWithRunRecording };

package/dist/runStepsTable.js

@@ -1,6 +1,6 @@
 import { _voltroWorkflowRunsTable as e } from "./runsTable.js";
 import { id as t, integer as n, json as r, reference as i, table as a, text as o, timestamp as s } from "@voltro/database";
-//#region src/runStepsTable.ts
+// src/runStepsTable.ts
 var c = a("_voltro_workflow_run_steps", {
 	id: t({ prefix: "wfstep" }),
 	runId: i(() => e, {
@@ -24,5 +24,4 @@ var c = a("_voltro_workflow_run_steps", {
 	completedAt: s().nullable(),
 	durationMs: n().nullable()
 }).index(["runId", "stepName"]).index(["startedAt"]);
-//#endregion
 export { c as _voltroWorkflowRunStepsTable };

package/dist/runnerStorageGuard.js

@@ -1,7 +1,7 @@
 import { Duration as e, Effect as t, Schedule as n } from "effect";
 import { RunnerStorage as r } from "effect/cluster";
 import { PersistenceError as i } from "effect/cluster/ClusterError";
-//#region src/runnerStorageGuard.ts
+// src/runnerStorageGuard.ts
 var a = (a, o) => t.gen(function* () {
 	let s = e.fromInputUnsafe(o.interval), c = e.toMillis(o.giveUpAfter), l, u, d = !1, f = !1;
 	yield* o.probe.pipe(t.timeout(s), t.isSuccess, t.flatMap((e) => t.sync(() => {
@@ -25,5 +25,4 @@ var a = (a, o) => t.gen(function* () {
 		})
 	});
 });
-//#endregion
 export { a as guardRunnerStorage };

package/dist/runsTable.js

@@ -1,5 +1,5 @@
 import { boolean as e, id as t, integer as n, json as r, table as i, text as a, timestamp as o } from "@voltro/database";
-//#region src/runsTable.ts
+// src/runsTable.ts
 var s = i("_voltro_workflow_runs", {
 	id: t({ prefix: "wfrun" }),
 	tag: a(),
@@ -38,5 +38,4 @@ var s = i("_voltro_workflow_runs", {
 		"abandon"
 	]).nullable()
 }).index(["tag"]).index(["status"]).index(["source"]).index(["startedAt"]).index(["parentExecutionId"]).index(["parentClosePolicy"]);
-//#endregion
 export { s as _voltroWorkflowRunsTable };

package/dist/scheduleDeclaration.js

@@ -1,5 +1,5 @@
 import { Cron as e, Duration as t, Result as n } from "effect";
-//#region src/scheduleDeclaration.ts
+// src/scheduleDeclaration.ts
 var r = 864e5, i = /* @__PURE__ */ new Set([
 	"skip",
 	"buffer",
@@ -40,5 +40,4 @@ var r = 864e5, i = /* @__PURE__ */ new Set([
 	let t = e[c];
 	return t === void 0 ? void 0 : t;
 };
-//#endregion
 export { r as DEFAULT_WORKFLOW_SCHEDULE_MAX_RUNTIME_MS, c as WorkflowScheduleProperty, l as getWorkflowSchedule, o as validateWorkflowSchedule };

package/dist/signalHint.js

@@ -1,4 +1,4 @@
-//#region src/signalHint.ts
+// src/signalHint.ts
 var e = 3e5, t, n = (e) => {
 	t = e !== void 0 && Number.isFinite(e) && e > 0 ? e : void 0;
 }, r = () => {
@@ -19,5 +19,4 @@ var e = 3e5, t, n = (e) => {
 	let a = e.workflowName === void 0 ? "" : ` in workflow '${e.workflowName}'`;
 	return (e.warn ?? ((e) => console.warn(e)))(`awaitSignal('${e.signalName}')${a} declares a ${Math.round(e.timeoutMs / 1e3)}s timeout — a wait that long holds a worker fiber for its whole duration. For human-approval-length waits, awaitSignalSuspending (same call shape, from @voltro/workflow) SUSPENDS the run and frees the slot until the signal arrives. This is a hint, not a behaviour change; it is logged once per workflow. Threshold: workflows.suspendSignalHintMs in app.config.ts, or VOLTRO_WORKFLOW_SUSPEND_HINT_MS.`), !0;
 };
-//#endregion
 export { e as DEFAULT_SUSPEND_HINT_MS, o as maybeHintSuspendingSignal, a as resetSuspendHintsForTest, r as resolveSuspendHintMs, n as setSuspendSignalHintMs };

package/dist/signals.js

@@ -4,7 +4,7 @@ import { maybeHintSuspendingSignal as i } from "./signalHint.js";
 import { Effect as a, Schema as o } from "effect";
 import { and as s, eq as c } from "@voltro/database";
 import { WorkflowInstance as l } from "effect/workflow/WorkflowEngine";
-//#region src/signals.ts
+// src/signals.ts
 var u = async (e, t) => {
 	if (e) try {
 		await e.recordEvent(t);
@@ -66,5 +66,4 @@ var u = async (e, t) => {
 		execute: p
 	});
 };
-//#endregion
 export { d as awaitSignal };