@voltro/workflow 0.85.0 → 0.86.0

package/dist/cancelOnPlan.js

@@ -0,0 +1,75 @@
+import { Result as e, Schema as t } from "effect";
+//#region src/cancelOnPlan.ts
+var n = (e) => {
+	let t = e instanceof Error ? e.message : String(e);
+	return t.length > 400 ? `${t.slice(0, 400)}…` : t;
+}, r = (r) => {
+	let i = [], a = [], o = [], s = /* @__PURE__ */ new Set(), c = /* @__PURE__ */ new Set(), l = r.payloadSchema === void 0 ? (t) => e.succeed(t) : (i) => {
+		let a = t.decodeUnknownResult(r.payloadSchema)(i);
+		return e.isSuccess(a) ? e.succeed(a.success) : e.fail(n(a.failure));
+	}, u = r.runs.map((e) => ({
+		run: e,
+		decoded: l(e.payload)
+	})), d = r.intents.map((e) => ({
+		intent: e,
+		decoded: l(e.payload)
+	}));
+	for (let l of r.entries) for (let f of r.events) {
+		if (f.name !== l.event) continue;
+		let p = t.decodeUnknownResult(l.schema)(f.payload);
+		if (e.isFailure(p)) {
+			o.push({
+				kind: "event-decode",
+				workflowName: r.workflowName,
+				event: l.event,
+				subject: f.id,
+				detail: n(p.failure)
+			});
+			continue;
+		}
+		let m = p.success, h = (e) => e.getTime() > f.occurredAt.getTime() ? !1 : l.withinMs === void 0 || f.occurredAt.getTime() - e.getTime() <= l.withinMs, g = (t, i) => {
+			if (e.isFailure(t)) return o.push({
+				kind: "payload-decode",
+				workflowName: r.workflowName,
+				event: l.event,
+				subject: i,
+				detail: t.failure
+			}), !1;
+			try {
+				return l.match(m, t.success) === !0;
+			} catch (e) {
+				return o.push({
+					kind: "match-threw",
+					workflowName: r.workflowName,
+					event: l.event,
+					subject: i,
+					detail: n(e)
+				}), !1;
+			}
+		};
+		for (let { run: e, decoded: t } of u) s.has(e.runId) || h(e.startedAt) && g(t, e.runId) && (s.add(e.runId), i.push({
+			runId: e.runId,
+			executionId: e.executionId,
+			reason: l.reason,
+			event: l.event,
+			eventId: f.id
+		}));
+		for (let { intent: e, decoded: t } of d) c.has(e.intentId) || h(e.firstSeenAt) && g(t, e.intentId) && (c.add(e.intentId), a.push({
+			intentId: e.intentId,
+			reason: l.reason,
+			event: l.event,
+			eventId: f.id
+		}));
+	}
+	return {
+		cancels: i,
+		discards: a,
+		problems: o
+	};
+}, i = (e) => {
+	let t;
+	for (let n of e) (t === void 0 || n.occurredAt.getTime() > t.getTime()) && (t = n.occurredAt);
+	return t;
+};
+//#endregion
+export { i as newestEventAt, r as planCancellations };

package/dist/cancelOnSweep.js

@@ -0,0 +1,188 @@
+import { newestEventAt as e, planCancellations as t } from "./cancelOnPlan.js";
+import { and as n, eq as r, gte as i } from "@voltro/database";
+//#region src/cancelOnSweep.ts
+var a = "_voltro_workflow_watermarks", o = "_voltro_workflow_events", s = "cancelOn", c = 36e5, l = 500, u = 2e3, d = (e) => {
+	if (e instanceof Date) return e;
+	if (typeof e == "number") return new Date(e);
+	if (typeof e == "string") {
+		let t = new Date(e);
+		if (!Number.isNaN(t.getTime())) return t;
+	}
+}, f = (e) => e instanceof Error ? e.message : String(e), p = async (e, t) => d((await e.query({
+	table: a,
+	predicate: r("id", t),
+	order: [],
+	take: 1,
+	skip: void 0,
+	projection: void 0
+}))[0]?.positionAt), m = async (e, t, n) => {
+	await e.upsert(a, {
+		id: t,
+		positionAt: n,
+		updatedAt: /* @__PURE__ */ new Date()
+	}, {
+		conflictColumns: ["id"],
+		update: (e) => {
+			let t = d(e.positionAt);
+			return t !== void 0 && t.getTime() >= n.getTime() ? {
+				positionAt: t,
+				updatedAt: /* @__PURE__ */ new Date()
+			} : {
+				positionAt: n,
+				updatedAt: /* @__PURE__ */ new Date()
+			};
+		}
+	});
+}, h = async (e, t, i) => {
+	let a = async (a) => e.query({
+		table: "_voltro_workflow_runs",
+		predicate: n(r("tag", t), r("status", a)),
+		order: [{
+			column: "startedAt",
+			direction: "asc"
+		}],
+		take: i,
+		skip: void 0,
+		projection: void 0
+	});
+	return [...await a("running"), ...await a("suspended")].flatMap((e) => {
+		let t = e, n = d(t.startedAt);
+		return typeof t.id != "string" || typeof t.executionId != "string" || n === void 0 ? [] : [{
+			runId: t.id,
+			executionId: t.executionId,
+			payload: t.payload,
+			startedAt: n
+		}];
+	});
+}, g = async (e, t, n) => (await e.query({
+	table: "_voltro_workflow_pending",
+	predicate: r("workflowName", t),
+	order: [{
+		column: "firstSeenAt",
+		direction: "asc"
+	}],
+	take: n,
+	skip: void 0,
+	projection: void 0
+})).flatMap((e) => {
+	let t = e, n = d(t.firstSeenAt);
+	return typeof t.id != "string" || n === void 0 ? [] : [{
+		intentId: t.id,
+		payload: t.payload,
+		firstSeenAt: n
+	}];
+}), _ = async (n, r) => {
+	let a = r.workflows.filter((e) => e.entries.length > 0);
+	if (a.length === 0) return {
+		examined: !1,
+		events: 0,
+		cancelled: 0,
+		discarded: 0,
+		catchingUp: !1,
+		sawFullRunPage: !1,
+		problems: [],
+		failures: [],
+		watermark: void 0
+	};
+	let c = n.now?.() ?? Date.now(), l = r.batch ?? 500, u = r.coldLookbackMs ?? 36e5, _ = /* @__PURE__ */ new Set();
+	for (let e of a) for (let t of e.entries) _.add(t.event);
+	let v = await p(n.store, s), y = v ?? new Date(c - u);
+	v === void 0 && (await m(n.store, s, y), v = y);
+	let b = await n.store.query({
+		table: o,
+		predicate: i("occurredAt", y),
+		order: [{
+			column: "occurredAt",
+			direction: "asc"
+		}],
+		take: l,
+		skip: void 0,
+		projection: void 0
+	}), x = [];
+	for (let e of b) {
+		let t = e, n = d(t.occurredAt);
+		typeof t.id == "string" && typeof t.name == "string" && n !== void 0 && _.has(t.name) && x.push({
+			id: t.id,
+			name: t.name,
+			payload: t.payload,
+			occurredAt: n
+		});
+	}
+	let S = [], C = [], w = 0, T = 0, E = !1, D = !1, O = r.runPage ?? 2e3;
+	if (x.length > 0) for (let e of a) {
+		let r = x.filter((t) => e.entries.some((e) => e.event === t.name));
+		if (r.length === 0) continue;
+		let i = [], a = [];
+		try {
+			i = await h(n.store, e.workflowName, O), a = await g(n.store, e.workflowName, O), (i.length >= O || a.length >= O) && (E = !0);
+		} catch (t) {
+			C.push({
+				subject: e.workflowName,
+				detail: f(t)
+			}), D = !0;
+			continue;
+		}
+		let o = t({
+			workflowName: e.workflowName,
+			entries: e.entries,
+			payloadSchema: e.payloadSchema,
+			events: r,
+			runs: i,
+			intents: a
+		});
+		S.push(...o.problems);
+		for (let t of o.cancels) try {
+			await n.cancelRun({
+				...t,
+				workflowName: e.workflowName
+			}), w += 1, n.log?.info("workflow.cancelOn: run cancelled", {
+				workflow: e.workflowName,
+				runId: t.runId,
+				event: t.event,
+				eventId: t.eventId
+			});
+		} catch (e) {
+			C.push({
+				subject: t.runId,
+				detail: f(e)
+			}), D = !0;
+		}
+		for (let t of o.discards) try {
+			await n.discardIntent({
+				...t,
+				workflowName: e.workflowName
+			}), T += 1;
+		} catch (e) {
+			C.push({
+				subject: t.intentId,
+				detail: f(e)
+			}), D = !0;
+		}
+	}
+	let k = e(x), A = v;
+	if (D) n.log?.warn("workflow.cancelOn: holding the watermark — evaluation or delivery remains incomplete", { failures: C.length });
+	else if (k !== void 0) try {
+		await m(n.store, s, k), A = k;
+	} catch (e) {
+		C.push({
+			subject: s,
+			detail: f(e)
+		});
+	}
+	return S.length > 0 && n.log?.warn("workflow.cancelOn: some events could not be evaluated", {
+		count: S.length,
+		first: S[0]
+	}), {
+		examined: !0,
+		events: x.length,
+		cancelled: w,
+		discarded: T,
+		catchingUp: b.length >= l,
+		sawFullRunPage: E,
+		problems: S,
+		failures: C,
+		watermark: A
+	};
+};
+//#endregion
+export { s as CANCEL_ON_WATERMARK, c as DEFAULT_COLD_LOOKBACK_MS, l as DEFAULT_EVENT_BATCH, u as DEFAULT_RUN_PAGE, o as EVENTS_TABLE, a as WATERMARKS_TABLE, p as readWatermark, _ as sweepCancelOn, m as writeWatermark };

package/dist/cancelPendingStart.js

@@ -0,0 +1,50 @@
+import { readAdmissionSubmission as e } from "./admissionSubmission.js";
+import { readWorkflowStartReceipt as t, settlePendingStartReceipts as n } from "./startReceipt.js";
+import { PENDING_TABLE as r, toPendingIntent as i } from "./admissionStore.js";
+import { eq as a } from "@voltro/database";
+//#region src/cancelPendingStart.ts
+var o = async (o, s) => {
+	if (!Number.isFinite(s.now) || !Number.isFinite(new Date(s.now).getTime())) throw Error("Queued cancellation requires a valid timestamp");
+	let c = await t(o, s.receiptId);
+	if (c === void 0 || c.workflowName !== s.workflowName || c.tenantId !== s.tenantId) throw Error("Queued cancellation receipt is missing or belongs to another workflow or tenant");
+	if (c.terminal !== null) return {
+		kind: "terminal",
+		outcome: c.terminal
+	};
+	if (c.submissionId !== null) {
+		let t = await e(o, c.submissionId);
+		if (t === void 0 || !t.receiptsBound || t.workflowName !== c.workflowName || t.tenantId !== c.tenantId || !t.intentIds.includes(c.pendingId)) throw Error("Queued cancellation receipt has no matching submission");
+		return {
+			kind: "submitted",
+			submissionId: t.id
+		};
+	}
+	let [l] = await o.query({
+		table: r,
+		predicate: a("id", c.pendingId),
+		lock: "update",
+		order: [],
+		take: 1,
+		skip: void 0,
+		projection: void 0
+	});
+	if (l === void 0) throw Error("Queued cancellation has no pending input or submission");
+	let u = i(l);
+	if (u.workflowName !== c.workflowName || u.tenantId !== c.tenantId || u.deadLetteredAt !== void 0) throw Error("Queued cancellation input has contradictory ownership or is dead-lettered");
+	let d = {
+		kind: "cancelled",
+		at: s.now
+	};
+	if (await n(o, {
+		pendingId: c.pendingId,
+		workflowName: c.workflowName,
+		tenantId: c.tenantId,
+		terminal: d
+	}), !await o.delete("_voltro_workflow_pending", c.pendingId)) throw Error("Queued cancellation lost its pending input");
+	return {
+		kind: "terminal",
+		outcome: d
+	};
+};
+//#endregion
+export { o as cancelPendingWorkflowStartInTransaction };

package/dist/cluster.js

@@ -1,2 +1,8 @@
-import { _ as e, a as t, b as n, c as r, d as i, f as a, g as o, h as s, i as c, l, m as u, n as d, o as f, p, r as m, s as h, t as g, u as _, v, y } from "./cluster-F_bhqVP7.js";
-export { d as DEFAULT_RUNNER_LISTEN_PORT, s as JournalExit, u as WorkflowRestartDispatcher, n as WorkflowResumeDispatcher, o as activityPrimaryKey, i as clusterLockNamespaceOid, p as clusterMigrationGateLayer, m as detectWsrepCluster, g as makeClusterCronLayer, a as makeClusterDiagnostics, c as parseShardLockMode, t as pollWorkflowStorage, e as readWorkflowRunReply, v as redriveFailedRun, f as resolveFailoverTuning, h as resolveRunnerIdentity, r as resolveRunnerStorage, l as resolveShardLockDisableAdvisory, y as resumeRunFromStep, _ as workflowEngineLayer };
+import { WorkflowResumeDispatcher as e } from "./workflowResumeDispatch.js";
+import { JournalExit as t, activityPrimaryKey as n, readWorkflowRunReply as r, redriveFailedRun as i, resumeRunFromStep as a } from "./workflowJournal.js";
+import { WorkflowRestartDispatcher as o } from "./workflowRestartDispatch.js";
+import { clusterMigrationGateLayer as s } from "./clusterMigrationGate.js";
+import { clusterLockNamespaceOid as c, makeClusterDiagnostics as l } from "./clusterDiagnosticsSql.js";
+import { DEFAULT_RUNNER_LISTEN_PORT as u, detectWsrepCluster as d, parseShardLockMode as f, pollWorkflowStorage as p, resolveFailoverTuning as m, resolveRunnerIdentity as h, resolveRunnerStorage as g, resolveShardLockDisableAdvisory as _, workflowEngineLayer as v } from "./clusterLayer.js";
+import { makeClusterCronLayer as y } from "./clusterCron.js";
+export { u as DEFAULT_RUNNER_LISTEN_PORT, t as JournalExit, o as WorkflowRestartDispatcher, e as WorkflowResumeDispatcher, n as activityPrimaryKey, c as clusterLockNamespaceOid, s as clusterMigrationGateLayer, d as detectWsrepCluster, y as makeClusterCronLayer, l as makeClusterDiagnostics, f as parseShardLockMode, p as pollWorkflowStorage, r as readWorkflowRunReply, i as redriveFailedRun, m as resolveFailoverTuning, h as resolveRunnerIdentity, g as resolveRunnerStorage, _ as resolveShardLockDisableAdvisory, a as resumeRunFromStep, v as workflowEngineLayer };

package/dist/clusterCron.js

@@ -0,0 +1,11 @@
+import { Duration as e, Effect as t } from "effect";
+import { ClusterCron as n } from "effect/cluster";
+//#region src/clusterCron.ts
+var r = (r) => n.make({
+	name: r.name,
+	cron: r.cron,
+	execute: t.promise(() => r.execute()),
+	skipIfOlderThan: r.skipIfOlderThan ?? e.days(1)
+});
+//#endregion
+export { r as makeClusterCronLayer };

package/dist/clusterDiagnostics.js

@@ -0,0 +1,20 @@
+import { Context as e, Effect as t } from "effect";
+//#region src/clusterDiagnostics.ts
+var n = 6e5, r = class extends e.Service()("@voltro/workflow/ClusterDiagnostics") {}, i = (e, n, r = Date.now()) => t.flatMap(e.messagesFor(n), (n) => {
+	if (n.length === 0) return t.succeed(void 0);
+	let i = [...new Set(n.filter((e) => !e.processed).map((e) => e.shardId))], a = i.length === 0 ? t.succeed([]) : e.shardLockHolders(i);
+	return t.map(a, (t) => ({
+		runner: e.ownAddress,
+		shardLockMode: e.shardLockMode,
+		messages: n.map((e) => ({
+			tag: e.tag,
+			shardId: e.shardId,
+			processed: e.processed,
+			lastRead: e.lastRead === null ? null : e.lastRead.toISOString(),
+			unreadForMs: !e.processed && e.lastRead !== null ? Math.max(0, r - e.lastRead.getTime()) : null
+		})),
+		shardLocks: t
+	}));
+});
+//#endregion
+export { n as CLUSTER_REREAD_WINDOW_MS, r as ClusterDiagnostics, i as describeStalledRun };

package/dist/clusterDiagnosticsSql.js

@@ -0,0 +1,145 @@
+import { CLUSTER_REREAD_WINDOW_MS as e } from "./clusterDiagnostics.js";
+import { Effect as t } from "effect";
+import { SqlClient as n } from "effect/sql";
+//#region src/clusterDiagnosticsSql.ts
+var r = (e) => {
+	if (e instanceof Date) return Number.isNaN(e.getTime()) ? null : e;
+	if (typeof e == "string" || typeof e == "number") {
+		let t = typeof e == "string" && /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/.test(e) ? `${e.replace(" ", "T")}Z` : e, n = new Date(t);
+		return Number.isNaN(n.getTime()) ? null : n;
+	}
+	return null;
+}, i = (e) => e === !0 || e === 1 || e === "1" || e instanceof Uint8Array && e[0] === 1, a = "cluster", o = (e = a) => {
+	let t = new TextEncoder().encode(`effect-cluster:${e}`), n = 2166136261;
+	for (let e of t) n = Math.imul(n ^ e, 16777619);
+	return (n | 0) >>> 0;
+}, s = (e, t) => {
+	let n = e.lastIndexOf(":");
+	if (n < 0) return;
+	let r = e.slice(0, n), i = Number(e.slice(n + 1)), a = t.indexOf(r);
+	if (!(a < 0 || !Number.isInteger(i))) return (a + 1) * 1e6 + i;
+}, c = (a) => t.gen(function* () {
+	let c = yield* n.SqlClient, l = a.shardGroups ?? ["default"], u = a.dialectId ?? "", d = u.startsWith("postgres") || u === "pg", f = (e) => e.pipe(t.catch(() => t.succeed([]))), p = c.onDialectOrElse({
+		pg: () => c.literal("NOW()"),
+		mysql: () => c.literal("NOW()"),
+		mssql: () => c.literal("GETDATE()"),
+		orElse: () => c.literal("CURRENT_TIMESTAMP")
+	}), m = (e, t) => {
+		let n = r(e.last_read), a = r(e.server_now), o = n !== null && a !== null ? Math.max(0, a.getTime() - n.getTime()) : null;
+		return {
+			tag: typeof e.tag == "string" ? e.tag : null,
+			entityType: String(e.entity_type ?? ""),
+			entityId: String(e.entity_id ?? ""),
+			shardId: String(e.shard_id ?? ""),
+			processed: i(e.processed),
+			lastRead: o === null ? null : new Date(t - o)
+		};
+	}, h = (e) => c.onDialectOrElse({
+		pg: () => c.literal(`NOW() - INTERVAL '${e} seconds'`),
+		mysql: () => c.literal(`NOW() - INTERVAL ${e} SECOND`),
+		mssql: () => c.literal(`DATEADD(SECOND, -${e}, GETDATE())`),
+		orElse: () => c.literal(`DATETIME('now', '-${e} seconds')`)
+	}), g = c.onDialectOrElse({
+		pg: () => c.literal("FALSE"),
+		orElse: () => c.literal("0")
+	}), _ = (e) => {
+		let n = Date.now();
+		return f(c`
+        SELECT tag, entity_type, entity_id, shard_id, processed, last_read, ${p} AS server_now
+        FROM cluster_messages
+        WHERE entity_id = ${e}
+        ORDER BY rowid ASC
+      `).pipe(t.map((e) => e.map((e) => m(e, n))));
+	}, v = (n = e) => {
+		let r = Math.max(1, Math.ceil(n / 1e3)), i = Date.now();
+		return f(c`
+        SELECT tag, entity_type, entity_id, shard_id, processed, last_read, ${p} AS server_now
+        FROM cluster_messages
+        WHERE processed = ${g}
+        AND last_read IS NOT NULL
+        AND last_read < ${h(r)}
+        AND (deliver_at IS NULL OR deliver_at <= ${i})
+        ORDER BY last_read ASC
+      `).pipe(t.map((e) => e.flatMap((e) => {
+			let t = m(e, i);
+			return t.lastRead === null ? [] : [{
+				...t,
+				unreadForMs: Math.max(0, i - t.lastRead.getTime())
+			}];
+		})));
+	}, y = (e) => f(c`
+        SELECT shard_id, address, acquired_at FROM cluster_locks WHERE ${c.in("shard_id", e)}
+      `).pipe(t.map((e) => e.map((e) => {
+		let t = e, n = String(t.address ?? ""), i = String(t.shard_id ?? "");
+		return {
+			shardId: i,
+			mode: "row",
+			holder: n,
+			own: n === a.ownAddress || (a.hasShard?.(i) ?? !1),
+			since: r(t.acquired_at)
+		};
+	}))), b = (e) => {
+		let n = /* @__PURE__ */ new Map();
+		for (let t of e) {
+			let e = s(t, l);
+			e !== void 0 && n.set(e, t);
+		}
+		return n.size === 0 ? t.succeed([]) : t.gen(function* () {
+			return (yield* f(c`
+          SELECT l.objid, a.pid, a.client_addr, a.application_name, a.state, a.state_change, a.backend_start, a.wait_event_type
+          FROM pg_locks l
+          JOIN pg_stat_activity a ON a.pid = l.pid
+          WHERE l.locktype = 'advisory' AND l.granted AND l.objsubid = 2
+            AND l.classid = ${o()} AND ${c.in("l.objid", [...n.keys()])}
+        `)).flatMap((e) => {
+				let t = e, i = n.get(Number(t.objid));
+				if (i === void 0) return [];
+				let o = Number(t.pid), s = t.client_addr === null || t.client_addr === void 0 ? "local socket" : String(t.client_addr), c = a.hasShard?.(i) ?? !1;
+				return [{
+					shardId: i,
+					mode: "advisory",
+					holder: c ? `this runner (pid ${o})` : `pid ${o} from ${s}`,
+					own: c,
+					since: r(t.state_change),
+					detail: {
+						pid: o,
+						clientAddr: t.client_addr ?? null,
+						applicationName: t.application_name ?? null,
+						state: t.state ?? null,
+						waitEventType: t.wait_event_type ?? null,
+						backendStart: r(t.backend_start)?.toISOString() ?? null
+					}
+				}];
+			});
+		});
+	};
+	return {
+		ownAddress: a.ownAddress,
+		shardLockMode: a.shardLockMode,
+		messagesFor: _,
+		unreadMessages: v,
+		shardLockHolders: (e) => e.length === 0 || a.runnerStorage !== "sql" ? t.succeed([]) : a.shardLockMode === "row" ? y(e) : a.shardLockMode === "advisory" && d ? b(e) : t.succeed([]),
+		runners: () => a.runnerStorage === "sql" ? f(c`SELECT address, last_heartbeat, healthy FROM cluster_runners ORDER BY last_heartbeat DESC`).pipe(t.map((e) => e.map((e) => {
+			let t = e;
+			return {
+				address: String(t.address ?? ""),
+				lastHeartbeat: r(t.last_heartbeat),
+				healthy: i(t.healthy)
+			};
+		}))) : t.succeed([]),
+		discardMessages: (e) => {
+			let r = e.unreadForMs === void 0 ? c.literal("") : c`AND last_read IS NOT NULL AND last_read < ${h(Math.max(1, Math.ceil(e.unreadForMs / 1e3)))}`;
+			return t.gen(function* () {
+				let t = (yield* c`
+          SELECT id FROM cluster_messages
+          WHERE entity_type = ${e.entityType} AND entity_id = ${e.entityId}
+          AND processed = ${g}
+          ${r}
+        `).map((e) => e.id).filter((e) => e != null).map(String);
+				return t.length === 0 ? 0 : (yield* c`DELETE FROM cluster_replies WHERE ${c.in("request_id", t)}`, yield* c`DELETE FROM cluster_messages WHERE ${c.in("id", t)}`, t.length);
+			}).pipe(c.withTransaction, t.provideService(n.SafeIntegers, !0), t.catch(() => t.succeed(0)));
+		}
+	};
+});
+//#endregion
+export { o as clusterLockNamespaceOid, c as makeClusterDiagnostics };

package/dist/clusterLayer.js

@@ -0,0 +1,110 @@
+import { withWorkflowDelivery as e } from "./workflowDelivery.js";
+import { ClusterDiagnostics as t } from "./clusterDiagnostics.js";
+import { WorkflowResumeDispatcher as n, makeWorkflowResumeDispatcher as r } from "./workflowResumeDispatch.js";
+import { WorkflowRestartDispatcher as i, makeWorkflowRestartDispatcher as a } from "./workflowRestartDispatch.js";
+import { clusterMigrationGateLayer as o } from "./clusterMigrationGate.js";
+import { clusterRunnerLayer as s } from "./clusterRunnerLayer.js";
+import { acquireSqliteWorkflowOwnership as c } from "./sqliteWorkflowOwnership.js";
+import { makeClusterDiagnostics as l } from "./clusterDiagnosticsSql.js";
+import { RateLimiter as u } from "effect/persistence";
+import { Context as d, Duration as f, Effect as p, Layer as m, Option as h } from "effect";
+import { SqlClient as g } from "effect/sql";
+import { ClusterWorkflowEngine as _, MessageStorage as v, RunnerAddress as y, ShardId as b, Sharding as x } from "effect/cluster";
+import { createLogger as S } from "@voltro/logger";
+//#region src/clusterLayer.ts
+var C = S({ scope: "voltro:workflow" }), w = 34e3, T = (e) => {
+	let t = e.runnerListenHost ?? process.env.POD_IP ?? process.env.VOLTRO_WORKFLOW_RUNNER_HOST ?? "localhost";
+	return {
+		host: t,
+		port: e.runnerListenPort ?? 34e3,
+		localhostRisk: e.runnerStorage === "sql" && (t === "localhost" || t === "127.0.0.1")
+	};
+}, E = (e) => {
+	let t = e.sqlRunnerSupported ?? !e.sqliteFamily, n = t ? "sql" : "memory", r = e.override ?? process.env.VOLTRO_WORKFLOW_RUNNER_STORAGE;
+	if (r === void 0 || r.trim() === "") return n;
+	let i = r.trim().toLowerCase();
+	if (i !== "memory" && i !== "sql") throw Error(`VOLTRO_WORKFLOW_RUNNER_STORAGE must be 'memory' or 'sql', got '${r}'.`);
+	if (i === "sql" && !t) throw Error("VOLTRO_WORKFLOW_RUNNER_STORAGE='sql' is unsupported for this database connection. Use 'memory' for a local or embedded SQLite-family connection.");
+	return i;
+}, D = (e = process.env.VOLTRO_WORKFLOW_SHARD_LOCK) => {
+	if (e === void 0 || e.trim() === "") return "auto";
+	let t = e.trim().toLowerCase();
+	if (t === "auto" || t === "row" || t === "advisory") return t;
+	throw Error(`VOLTRO_WORKFLOW_SHARD_LOCK must be 'auto', 'row', or 'advisory', got '${e}'.`);
+}, O = p.gen(function* () {
+	let e = yield* (yield* g.SqlClient)`SELECT @@wsrep_on AS wsrep`.pipe(p.catch(() => p.succeed([])));
+	if (e.length === 0) return !1;
+	let t = e[0].wsrep;
+	return t === 1 || t === "1" || t === !0 || t === "ON" || t === "on";
+}), k = (e) => p.gen(function* () {
+	return e.runnerStorage === "memory" ? !1 : e.dialectId === "sqlite" || e.dialectId === "turso" || e.mode === "row" ? !0 : e.mode === "advisory" || e.dialectId !== "mysql" && e.dialectId !== "mariadb" ? !1 : yield* O;
+}), A = (e) => ({
+	coordination: e.disableAdvisory ? "row-based" : "advisory",
+	dialect: e.dialectId ?? "unknown",
+	mode: e.mode,
+	...e.disableAdvisory && e.mode === "auto" ? { reason: e.dialectId === "sqlite" || e.dialectId === "turso" ? "SQLite-family connection uses row locks" : "wsrep/Galera cluster detected" } : {}
+}), j = () => {
+	let e = (e) => {
+		if (e === void 0) return;
+		let t = Number(e);
+		return Number.isFinite(t) && t > 0 ? t : void 0;
+	}, t = e(process.env.VOLTRO_WORKFLOW_FAILOVER_LEASE), n = e(process.env.VOLTRO_WORKFLOW_FAILOVER_HEARTBEAT), r = e(process.env.VOLTRO_WORKFLOW_POLL_INTERVAL);
+	return {
+		...t === void 0 ? {} : { failoverLeaseSeconds: t },
+		...n === void 0 ? {} : { failoverHeartbeatSeconds: n },
+		...r === void 0 ? {} : { messagePollSeconds: r }
+	};
+}, M = p.flatMap(x.Sharding, (e) => e.pollStorage), N = /* @__PURE__ */ new Set(), P = (e) => Object.assign(Object.create(Object.getPrototypeOf(e)), e, { requestIdForPrimaryKey: (t) => e.requestIdForPrimaryKey(t).pipe(p.provideService(g.SafeIntegers, !0)) }), F = (S) => {
+	let w = T({
+		runnerStorage: S.runnerStorage,
+		runnerListenHost: S.runnerListenHost,
+		runnerListenPort: S.runnerListenPort
+	}), E = w.host, O = w.port;
+	w.localhostRisk && !N.has(E) && (N.add(E), C.warn("runner host is not routable from other pods with SQL cluster storage — a workflow cannot resume on another pod after a reschedule. Inject POD_IP via the K8s downward API (fieldRef: status.podIP) or set runnerListenHost / VOLTRO_WORKFLOW_RUNNER_HOST.", { runnerHost: E }));
+	let j = S.dialectId === "sqlite" ? m.effect(g.SqlClient, p.gen(function* () {
+		let e = yield* g.SqlClient, t = (yield* e.unsafe("PRAGMA database_list")).find((e) => e.name === "main");
+		return t === void 0 ? yield* p.die(/* @__PURE__ */ Error("SQLite workflow connection has no main database")) : (t.file !== "" && (yield* c(t.file)), e);
+	}).pipe(p.orDie)).pipe(m.provide(S.sqlClientLayer)) : S.sqlClientLayer, M = o({
+		runnerStorage: S.runnerStorage,
+		charset: S.charset
+	}).pipe(m.provide(j)), F = S.shardLockMode ?? D(), I = m.unwrap(k({
+		dialectId: S.dialectId,
+		runnerStorage: S.runnerStorage,
+		mode: F
+	}).pipe(p.map((e) => {
+		S.runnerStorage === "sql" && C.info("shard-lock coordination", A({
+			disableAdvisory: e,
+			dialectId: S.dialectId,
+			mode: F
+		}));
+		let o = m.effect(t, p.flatMap(x.Sharding, (t) => l({
+			ownAddress: y.make(E, O).toString(),
+			shardLockMode: S.runnerStorage === "sql" ? e ? "row" : "advisory" : "none",
+			runnerStorage: S.runnerStorage,
+			dialectId: S.dialectId,
+			hasShard: (e) => t.hasShardId(b.fromString(e))
+		}))), c = {
+			runnerAddress: h.some(y.make(E, O)),
+			runnerListenAddress: h.some(y.make(E, O)),
+			...e ? { shardLockDisableAdvisory: !0 } : {},
+			...S.failoverLeaseSeconds === void 0 ? {} : { shardLockExpiration: f.seconds(S.failoverLeaseSeconds) },
+			...S.failoverHeartbeatSeconds === void 0 ? {} : { shardLockRefreshInterval: f.seconds(S.failoverHeartbeatSeconds) },
+			...S.messagePollSeconds === void 0 ? {} : { entityMessagePollInterval: f.seconds(S.messagePollSeconds) }
+		}, u = f.seconds(S.failoverHeartbeatSeconds ?? 10), d = s({
+			runnerStorage: S.runnerStorage,
+			shardingConfig: c,
+			guard: {
+				interval: u,
+				giveUpAfter: f.times(u, 3),
+				log: C
+			}
+		});
+		return m.mergeAll(o, m.effect(n, r), m.effect(i, a)).pipe(m.provideMerge(d));
+	}))).pipe(m.provide(M)), L = S.extraShardingLayers ?? [], R = L.length === 0 ? _.layer : m.mergeAll(_.layer, ...L), z = m.flatMap(I, (t) => {
+		let n = d.add(t, x.Sharding, e(d.get(t, x.Sharding)));
+		return m.succeedContext(S.dialectId === "sqlite" ? d.add(n, v.MessageStorage, P(d.get(n, v.MessageStorage))) : n);
+	}), B = u.layer.pipe(m.provide(u.layerStoreMemory));
+	return m.merge(R, B).pipe(m.provideMerge(z));
+};
+//#endregion
+export { w as DEFAULT_RUNNER_LISTEN_PORT, O as detectWsrepCluster, D as parseShardLockMode, M as pollWorkflowStorage, j as resolveFailoverTuning, T as resolveRunnerIdentity, E as resolveRunnerStorage, k as resolveShardLockDisableAdvisory, A as shardLockLogFields, F as workflowEngineLayer };