@fragno-dev/workflows 0.0.1 → 0.0.3

package/dist/node/definition.js

@@ -1,32 +1,61 @@
+import { WorkflowsLogger } from "./debug-log.js";
 import { workflowsSchema } from "./schema.js";
+import { WORKFLOW_EVENT_ACTOR_SYSTEM, WORKFLOW_EVENT_ACTOR_USER, WORKFLOW_SYSTEM_PAUSE_EVENT_TYPE, isSystemEventActor } from "./system-events.js";
+import { runWorkflowsTick } from "./new-runner.js";
+import { restoreWorkflowState } from "./runner/restore-state.js";
 import { defineFragment } from "@fragno-dev/core";
-import { dbNow, withDatabase } from "@fragno-dev/db";
+import { withDatabase } from "@fragno-dev/db";
 
 //#region src/definition.ts
 const DEFAULT_PAGE_SIZE = 25;
 const INSTANCE_STATUSES = new Set([
-	"queued",
-	"running",
+	"active",
 	"paused",
 	"errored",
 	"terminated",
 	"complete",
-	"waiting",
-	"waitingForPause",
-	"unknown"
+	"waiting"
 ]);
 const TERMINAL_STATUSES = new Set([
 	"complete",
 	"terminated",
 	"errored"
 ]);
-const PAUSED_STATUSES = new Set(["paused", "waitingForPause"]);
-function generateInstanceId(nowMs, randomFloat) {
-	return `inst_${nowMs.toString(36)}_${randomFloat().toString(36).slice(2, 10)}`;
+function buildRestoreInstanceStateReadModel(instance, steps) {
+	if (!instance) throw new Error("INSTANCE_NOT_FOUND");
+	return {
+		instance,
+		steps: steps.filter((step) => step.runNumber === instance.runNumber)
+	};
+}
+function restoreWorkflowStateFromReadModel(workflow, readModel, liveState) {
+	return restoreWorkflowState({
+		workflow,
+		instance: readModel.instance,
+		steps: readModel.steps
+	}).then((state) => {
+		if (liveState && state !== void 0) liveState.set({
+			workflowName: readModel.instance.workflowName,
+			instanceId: readModel.instance.id.toString(),
+			runNumber: readModel.instance.runNumber,
+			status: buildInstanceStatus(readModel.instance).status,
+			capturedAt: readModel.instance.updatedAt,
+			state
+		});
+		return state;
+	});
+}
+function generateInstanceId(randomUuid) {
+	const prefix = "inst_";
+	const maxLength = 128;
+	const raw = randomUuid().replace(/-/g, "");
+	const suffixLength = Math.max(maxLength - 5, 0);
+	return `${prefix}${raw.slice(0, suffixLength)}`;
 }
 function buildInstanceStatus(instance) {
+	if (!INSTANCE_STATUSES.has(instance.status)) throw new Error(`INSTANCE_STATUS_INVALID:${instance.status}`);
 	return {
-		status: INSTANCE_STATUSES.has(instance.status) ? instance.status : "unknown",
+		status: instance.status,
 		error: instance.errorName || instance.errorMessage ? {
 			name: instance.errorName ?? "Error",
 			message: instance.errorMessage ?? ""
@@ -39,7 +68,6 @@ function buildInstanceMetadata(instance) {
 		workflowName: instance.workflowName,
 		runNumber: instance.runNumber,
 		params: instance.params ?? {},
-		pauseRequested: instance.pauseRequested,
 		createdAt: instance.createdAt,
 		updatedAt: instance.updatedAt,
 		startedAt: instance.startedAt,
@@ -100,37 +128,59 @@ function buildEventHistoryEntry(event) {
 		consumedByStepKey: event.consumedByStepKey
 	};
 }
-function buildLogHistoryEntry(log) {
-	return {
-		id: log.id.toString(),
-		runNumber: log.runNumber,
-		stepKey: log.stepKey,
-		attempt: log.attempt,
-		level: log.level,
-		category: log.category,
-		message: log.message,
-		data: log.data ?? null,
-		createdAt: log.createdAt
-	};
-}
 function isTerminalStatus(status) {
 	return TERMINAL_STATUSES.has(status);
 }
-function isPausedStatus(status) {
-	return PAUSED_STATUSES.has(status);
-}
-const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatabase(workflowsSchema)).provideHooks(({ defineHook, config }) => ({ onWorkflowEnqueued: defineHook(async function(_payload) {
-	await config.runner?.tick();
-}) })).providesBaseService(({ defineService, config, deps }) => {
-	const getNow = () => config.runtime.time.now();
-	const getDbNow = async () => deps.db.now ? deps.db.now() : getNow();
-	const getRunAtNow = () => config.dbNow?.() ?? dbNow();
-	const randomFloat = () => config.runtime.random.float();
+const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatabase(workflowsSchema)).provideHooks(({ defineHook, config }) => {
+	const workflows = config.workflows ?? {};
+	const workflowsByName = /* @__PURE__ */ new Map();
+	for (const entry of Object.values(workflows)) workflowsByName.set(entry.name, entry);
+	return { onWorkflowEnqueued: defineHook(async function(payload) {
+		if (config.autoTickHooks === false) return;
+		if (workflowsByName.size === 0) return;
+		const timestamp = this.nextRetryAt ?? this.createdAt;
+		await runWorkflowsTick({
+			handlerTx: this.handlerTx,
+			workflowsByName,
+			workflows,
+			liveState: config.liveState,
+			payload: {
+				...payload,
+				timestamp
+			}
+		});
+	}) };
+}).providesBaseService(({ defineService, config }) => {
+	WorkflowsLogger.configure(config.logging);
+	const randomUuid = () => config.runtime.random.uuid();
 	const workflowsByName = /* @__PURE__ */ new Map();
 	for (const entry of Object.values(config.workflows ?? {})) workflowsByName.set(entry.name, entry);
-	const validateWorkflowParams = async (workflowName, params) => {
+	const getWorkflowEntry = (workflowName) => {
 		const entry = workflowsByName.get(workflowName);
 		if (!entry) throw new Error("WORKFLOW_NOT_FOUND");
+		return entry;
+	};
+	const assertWorkflowName = (workflowName) => {
+		getWorkflowEntry(workflowName);
+	};
+	const readLiveInstanceState = (workflowName, instanceId) => {
+		assertWorkflowName(workflowName);
+		return config.liveState?.get(instanceId, { workflowName }) ?? null;
+	};
+	const setLiveInstanceStatus = (workflowName, instanceId, status) => {
+		const snapshot = readLiveInstanceState(workflowName, instanceId);
+		if (!snapshot || !config.liveState) return;
+		config.liveState.set({
+			...snapshot,
+			status,
+			capturedAt: /* @__PURE__ */ new Date()
+		});
+	};
+	const deleteLiveInstanceState = (instanceId) => {
+		config.liveState?.delete(instanceId);
+	};
+	const validateWorkflowParams = async (workflowName, params) => {
+		const entry = getWorkflowEntry(workflowName);
 		if ("workflow" in entry) return params ?? {};
 		if (!entry.schema) return params ?? {};
 		const result = await entry.schema["~standard"].validate(params ?? {});
@@ -141,22 +191,28 @@ const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatab
 		}
 		return result.value;
 	};
+	const getWorkflowEntryForRestore = (workflowName) => {
+		return getWorkflowEntry(workflowName);
+	};
+	const buildRestoreInstanceStateTx = (ctx, workflowName, workflow, instanceId) => ctx.serviceTx(workflowsSchema).retrieve((uow) => {
+		return uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId)))).find("workflow_step", (b) => b.whereIndex("idx_workflow_step_instanceRef_runNumber_createdAt", (eb) => eb("instanceRef", "=", instanceId)).orderByIndex("idx_workflow_step_instanceRef_runNumber_createdAt", "desc"));
+	}).transformRetrieve(([instance, steps]) => buildRestoreInstanceStateReadModel(instance, steps)).mutate(({ retrieveResult }) => restoreWorkflowStateFromReadModel(workflow, retrieveResult, config.liveState)).build();
 	return defineService({
-		getDbNow,
 		validateWorkflowParams,
+		getLiveInstanceState: function(workflowOrName, instanceId) {
+			return readLiveInstanceState(typeof workflowOrName === "string" ? workflowOrName : workflowOrName.name, instanceId);
+		},
 		createInstance: function(workflowName, options) {
-			const now = getNow();
-			const instanceId = options?.id ?? generateInstanceId(now.getTime(), randomFloat);
+			assertWorkflowName(workflowName);
+			const instanceId = options?.id ?? generateInstanceId(randomUuid);
 			const params = options?.params ?? {};
-			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId))))).mutate(({ uow, retrieveResult: [existing] }) => {
+			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId))))).mutate(({ uow, retrieveResult: [existing] }) => {
 				if (existing) throw new Error("INSTANCE_ID_ALREADY_EXISTS");
 				const instanceRef = uow.create("workflow_instance", {
+					id: instanceId,
 					workflowName,
-					instanceId,
-					status: "queued",
+					status: "active",
 					params,
-					pauseRequested: false,
-					retentionUntil: null,
 					runNumber: 0,
 					startedAt: null,
 					completedAt: null,
@@ -164,29 +220,17 @@ const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatab
 					errorName: null,
 					errorMessage: null
 				});
-				uow.create("workflow_task", {
-					instanceRef,
-					workflowName,
-					instanceId,
-					runNumber: 0,
-					kind: "run",
-					runAt: getRunAtNow(),
-					status: "pending",
-					attempts: 0,
-					maxAttempts: 1,
-					lastError: null,
-					lockedUntil: null,
-					lockOwner: null
-				});
 				uow.triggerHook("onWorkflowEnqueued", {
 					workflowName,
 					instanceId,
+					instanceRef: String(instanceRef),
+					runNumber: 0,
 					reason: "create"
 				});
 				return {
 					id: instanceId,
 					details: buildInstanceStatus({
-						status: "queued",
+						status: "active",
 						output: null,
 						errorName: null,
 						errorMessage: null
@@ -195,21 +239,20 @@ const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatab
 			}).build();
 		},
 		createBatch: function(workflowName, instances) {
-			if (instances.length === 0) return Promise.resolve([]);
-			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.find("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "in", instances.map((instance) => instance.id)))))).mutate(({ uow, retrieveResult: [existingInstances] }) => {
-				const existingIds = new Set(existingInstances.map((record) => record.instanceId));
+			assertWorkflowName(workflowName);
+			if (instances.length === 0) return this.serviceTx(workflowsSchema).transform(() => []).build();
+			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.find("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "in", instances.map((instance) => instance.id)))))).mutate(({ uow, retrieveResult: [existingInstances] }) => {
+				const existingIds = new Set(existingInstances.map((record) => record.id.toString()));
 				const processedIds = /* @__PURE__ */ new Set();
 				const created = [];
 				for (const instance of instances) {
 					if (existingIds.has(instance.id) || processedIds.has(instance.id)) continue;
 					processedIds.add(instance.id);
 					const instanceRef = uow.create("workflow_instance", {
+						id: instance.id,
 						workflowName,
-						instanceId: instance.id,
-						status: "queued",
+						status: "active",
 						params: instance.params ?? {},
-						pauseRequested: false,
-						retentionUntil: null,
 						runNumber: 0,
 						startedAt: null,
 						completedAt: null,
@@ -217,29 +260,17 @@ const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatab
 						errorName: null,
 						errorMessage: null
 					});
-					uow.create("workflow_task", {
-						instanceRef,
-						workflowName,
-						instanceId: instance.id,
-						runNumber: 0,
-						kind: "run",
-						runAt: getRunAtNow(),
-						status: "pending",
-						attempts: 0,
-						maxAttempts: 1,
-						lastError: null,
-						lockedUntil: null,
-						lockOwner: null
-					});
 					uow.triggerHook("onWorkflowEnqueued", {
 						workflowName,
 						instanceId: instance.id,
+						instanceRef: String(instanceRef),
+						runNumber: 0,
 						reason: "create"
 					});
 					created.push({
 						id: instance.id,
 						details: buildInstanceStatus({
-							status: "queued",
+							status: "active",
 							output: null,
 							errorName: null,
 							errorMessage: null
@@ -250,32 +281,40 @@ const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatab
 			}).build();
 		},
 		getInstanceStatus: function(workflowName, instanceId) {
-			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId))))).transformRetrieve(([instance]) => {
+			assertWorkflowName(workflowName);
+			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId))))).transformRetrieve(([instance]) => {
 				if (!instance) throw new Error("INSTANCE_NOT_FOUND");
 				return buildInstanceStatus(instance);
 			}).build();
 		},
 		getInstanceMetadata: function(workflowName, instanceId) {
-			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId))))).transformRetrieve(([instance]) => {
+			assertWorkflowName(workflowName);
+			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId))))).transformRetrieve(([instance]) => {
 				if (!instance) throw new Error("INSTANCE_NOT_FOUND");
 				return buildInstanceMetadata(instance);
 			}).build();
 		},
-		getInstanceCurrentStep: function({ workflowName, instanceId, runNumber }) {
+		restoreInstanceState: function(workflowOrName, instanceId) {
+			if (typeof workflowOrName === "string") return buildRestoreInstanceStateTx(this, workflowOrName, getWorkflowEntryForRestore(workflowOrName), instanceId);
+			return buildRestoreInstanceStateTx(this, workflowOrName.name, workflowOrName, instanceId);
+		},
+		getInstanceCurrentStep: function({ instanceId, runNumber }) {
 			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findWithCursor("workflow_step", (b) => {
-				return b.whereIndex("idx_workflow_step_history_createdAt", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId), eb("runNumber", "=", runNumber))).orderByIndex("idx_workflow_step_history_createdAt", "desc").pageSize(1);
+				return b.whereIndex("idx_workflow_step_instanceRef_runNumber_createdAt", (eb) => eb.and(eb("instanceRef", "=", instanceId), eb("runNumber", "=", runNumber))).orderByIndex("idx_workflow_step_instanceRef_runNumber_createdAt", "desc").pageSize(1);
 			})).transformRetrieve(([steps]) => {
 				const latest = steps.items[0];
 				return latest ? buildCurrentStepSummary(latest) : void 0;
 			}).build();
 		},
 		getInstanceRunNumber: function(workflowName, instanceId) {
-			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId))))).transformRetrieve(([instance]) => {
+			assertWorkflowName(workflowName);
+			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId))))).transformRetrieve(([instance]) => {
 				if (!instance) throw new Error("INSTANCE_NOT_FOUND");
 				return instance.runNumber;
 			}).build();
 		},
 		listInstances: function({ workflowName, status, pageSize = DEFAULT_PAGE_SIZE, cursor, order = "desc" }) {
+			assertWorkflowName(workflowName);
 			const effectivePageSize = cursor?.pageSize ?? pageSize;
 			const effectiveOrder = cursor?.orderDirection ?? order;
 			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findWithCursor("workflow_instance", (b) => {
@@ -283,12 +322,12 @@ const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatab
 					const query$1 = b.whereIndex("idx_workflow_instance_status_updatedAt", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("status", "=", status))).orderByIndex("idx_workflow_instance_status_updatedAt", effectiveOrder).pageSize(effectivePageSize);
 					return cursor ? query$1.after(cursor) : query$1;
 				}
-				const query = b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb("workflowName", "=", workflowName)).orderByIndex("idx_workflow_instance_workflowName_instanceId", effectiveOrder).pageSize(effectivePageSize);
+				const query = b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb("workflowName", "=", workflowName)).orderByIndex("idx_workflow_instance_workflowName_id", effectiveOrder).pageSize(effectivePageSize);
 				return cursor ? query.after(cursor) : query;
 			})).transformRetrieve(([instances]) => {
 				return {
 					instances: instances.items.map((instance) => ({
-						id: instance.instanceId,
+						id: instance.id.toString(),
 						details: buildInstanceStatus(instance),
 						createdAt: instance.createdAt
 					})),
@@ -297,131 +336,68 @@ const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatab
 				};
 			}).build();
 		},
-		listHistory: function({ workflowName, instanceId, runNumber, pageSize = DEFAULT_PAGE_SIZE, stepsCursor, eventsCursor, includeLogs, logsCursor, logLevel, logCategory, order = "desc" }) {
-			const stepsOrder = stepsCursor?.orderDirection ?? order;
-			const eventsOrder = eventsCursor?.orderDirection ?? order;
-			const logsOrder = logsCursor?.orderDirection ?? order;
-			const stepsPageSize = stepsCursor?.pageSize ?? pageSize;
-			const eventsPageSize = eventsCursor?.pageSize ?? pageSize;
-			const logsPageSize = logsCursor?.pageSize ?? pageSize;
+		listHistory: function({ workflowName, instanceId, runNumber }) {
+			assertWorkflowName(workflowName);
 			return this.serviceTx(workflowsSchema).retrieve((uow) => {
-				let chain = uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId)))).findWithCursor("workflow_step", (b) => {
-					const query = b.whereIndex("idx_workflow_step_history_createdAt", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId), eb("runNumber", "=", runNumber))).orderByIndex("idx_workflow_step_history_createdAt", stepsOrder).pageSize(stepsPageSize);
-					return stepsCursor ? query.after(stepsCursor) : query;
-				}).findWithCursor("workflow_event", (b) => {
-					const query = b.whereIndex("idx_workflow_event_history_createdAt", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId), eb("runNumber", "=", runNumber))).orderByIndex("idx_workflow_event_history_createdAt", eventsOrder).pageSize(eventsPageSize);
-					return eventsCursor ? query.after(eventsCursor) : query;
-				});
-				const effectiveLogLevel = includeLogs ? logLevel : void 0;
-				const effectiveLogCategory = includeLogs ? logCategory : void 0;
-				const effectiveLogsCursor = includeLogs ? logsCursor : void 0;
-				const effectiveLogsPageSize = includeLogs ? logsPageSize : 1;
-				return chain.findWithCursor("workflow_log", (b) => {
-					if (effectiveLogLevel) {
-						const query$1 = b.whereIndex("idx_workflow_log_level_createdAt", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId), eb("runNumber", "=", runNumber), eb("level", "=", effectiveLogLevel))).orderByIndex("idx_workflow_log_level_createdAt", logsOrder).pageSize(effectiveLogsPageSize);
-						return effectiveLogsCursor ? query$1.after(effectiveLogsCursor) : query$1;
-					}
-					if (effectiveLogCategory) {
-						const query$1 = b.whereIndex("idx_workflow_log_category_createdAt", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId), eb("runNumber", "=", runNumber), eb("category", "=", effectiveLogCategory))).orderByIndex("idx_workflow_log_category_createdAt", logsOrder).pageSize(effectiveLogsPageSize);
-						return effectiveLogsCursor ? query$1.after(effectiveLogsCursor) : query$1;
-					}
-					const query = b.whereIndex("idx_workflow_log_history_createdAt", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId), eb("runNumber", "=", runNumber))).orderByIndex("idx_workflow_log_history_createdAt", logsOrder).pageSize(effectiveLogsPageSize);
-					return effectiveLogsCursor ? query.after(effectiveLogsCursor) : query;
-				});
+				return uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId)))).find("workflow_step", (b) => b.whereIndex("idx_workflow_step_instanceRef_runNumber_createdAt", (eb) => runNumber === void 0 ? eb("instanceRef", "=", instanceId) : eb.and(eb("instanceRef", "=", instanceId), eb("runNumber", "=", runNumber))).orderByIndex("idx_workflow_step_instanceRef_runNumber_createdAt", "desc")).find("workflow_event", (b) => b.whereIndex("idx_workflow_event_instanceRef_runNumber_createdAt", (eb) => runNumber === void 0 ? eb("instanceRef", "=", instanceId) : eb.and(eb("instanceRef", "=", instanceId), eb("runNumber", "=", runNumber))).orderByIndex("idx_workflow_event_instanceRef_runNumber_createdAt", "desc"));
 			}).mutate(({ retrieveResult }) => {
-				const [instance, steps, events, logs] = retrieveResult;
+				const [instance, steps, events] = retrieveResult;
 				if (!instance) throw new Error("INSTANCE_NOT_FOUND");
-				const filteredLogs = includeLogs && logLevel && logCategory ? logs?.items.filter((log) => log.category === logCategory) : logs?.items;
+				const resolvedRunNumber = runNumber ?? instance.runNumber;
+				const selectedSteps = runNumber === void 0 ? steps.filter((step) => step.runNumber === resolvedRunNumber) : steps;
+				const selectedEvents = runNumber === void 0 ? events.filter((event) => event.runNumber === resolvedRunNumber) : events;
 				return {
-					runNumber,
-					steps: steps.items.map(buildStepHistoryEntry),
-					events: events.items.map(buildEventHistoryEntry),
-					stepsCursor: steps.cursor,
-					stepsHasNextPage: steps.hasNextPage,
-					eventsCursor: events.cursor,
-					eventsHasNextPage: events.hasNextPage,
-					logs: includeLogs ? filteredLogs?.map(buildLogHistoryEntry) ?? [] : void 0,
-					logsCursor: includeLogs ? logs.cursor : void 0,
-					logsHasNextPage: includeLogs ? logs.hasNextPage : void 0
+					runNumber: resolvedRunNumber,
+					steps: selectedSteps.map(buildStepHistoryEntry),
+					events: selectedEvents.filter((event) => !isSystemEventActor(event.actor)).map(buildEventHistoryEntry)
 				};
 			}).build();
 		},
 		pauseInstance: function(workflowName, instanceId) {
-			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId))))).mutate(({ uow, retrieveResult: [instance] }) => {
+			assertWorkflowName(workflowName);
+			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId))))).mutate(({ uow, retrieveResult: [instance] }) => {
 				if (!instance) throw new Error("INSTANCE_NOT_FOUND");
 				const currentStatus = buildInstanceStatus(instance).status;
 				if (isTerminalStatus(currentStatus)) throw new Error("INSTANCE_TERMINAL");
-				if (currentStatus === "running") {
-					uow.update("workflow_instance", instance.id, (b) => b.set({
-						status: "waitingForPause",
-						pauseRequested: true,
-						updatedAt: getNow()
-					}).check());
-					return buildInstanceStatus({
-						status: "waitingForPause",
-						output: instance.output,
-						errorName: instance.errorName,
-						errorMessage: instance.errorMessage
-					});
-				}
-				if (currentStatus === "queued" || currentStatus === "waiting") {
-					uow.update("workflow_instance", instance.id, (b) => b.set({
-						status: "paused",
-						pauseRequested: false,
-						updatedAt: getNow()
-					}).check());
-					return buildInstanceStatus({
-						status: "paused",
-						output: instance.output,
-						errorName: instance.errorName,
-						errorMessage: instance.errorMessage
-					});
-				}
+				if (currentStatus === "paused") return buildInstanceStatus(instance);
+				uow.create("workflow_event", {
+					instanceRef: instance.id,
+					runNumber: instance.runNumber,
+					actor: WORKFLOW_EVENT_ACTOR_SYSTEM,
+					type: WORKFLOW_SYSTEM_PAUSE_EVENT_TYPE,
+					payload: null,
+					deliveredAt: null,
+					consumedByStepKey: null
+				});
+				uow.triggerHook("onWorkflowEnqueued", {
+					workflowName,
+					instanceId: instance.id.toString(),
+					instanceRef: String(instance.id),
+					runNumber: instance.runNumber,
+					reason: "event"
+				});
 				return buildInstanceStatus(instance);
 			}).build();
 		},
 		resumeInstance: function(workflowName, instanceId) {
-			const now = getNow();
-			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId)))).find("workflow_task", (b) => b.whereIndex("idx_workflow_task_workflowName_instanceId_runNumber", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId))))).mutate(({ uow, retrieveResult: [instance, tasks] }) => {
+			assertWorkflowName(workflowName);
+			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId))))).mutate(({ uow, retrieveResult: [instance] }) => {
 				if (!instance) throw new Error("INSTANCE_NOT_FOUND");
 				if (buildInstanceStatus(instance).status !== "paused") return buildInstanceStatus(instance);
-				const task = tasks.find((candidate) => candidate.runNumber === instance.runNumber);
 				uow.update("workflow_instance", instance.id, (b) => b.set({
-					status: "queued",
-					pauseRequested: false,
-					updatedAt: now
-				}).check());
-				if (task) uow.update("workflow_task", task.id, (b) => b.set({
-					kind: "resume",
-					runAt: getRunAtNow(),
-					status: "pending",
-					attempts: 0,
-					lastError: null,
-					lockedUntil: null,
-					lockOwner: null,
-					updatedAt: now
+					status: "active",
+					updatedAt: b.now()
 				}).check());
-				else uow.create("workflow_task", {
-					instanceRef: instance.id,
-					workflowName,
-					instanceId,
-					runNumber: instance.runNumber,
-					kind: "resume",
-					runAt: getRunAtNow(),
-					status: "pending",
-					attempts: 0,
-					maxAttempts: 1,
-					lastError: null,
-					lockedUntil: null,
-					lockOwner: null
-				});
+				setLiveInstanceStatus(workflowName, instanceId, "active");
 				uow.triggerHook("onWorkflowEnqueued", {
 					workflowName,
-					instanceId,
+					instanceId: instance.id.toString(),
+					instanceRef: String(instance.id),
+					runNumber: instance.runNumber,
 					reason: "resume"
 				});
 				return buildInstanceStatus({
-					status: "queued",
+					status: "active",
 					output: instance.output,
 					errorName: instance.errorName,
 					errorMessage: instance.errorMessage
@@ -429,17 +405,17 @@ const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatab
 			}).build();
 		},
 		terminateInstance: function(workflowName, instanceId) {
-			const now = getNow();
-			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId))))).mutate(({ uow, retrieveResult: [instance] }) => {
+			assertWorkflowName(workflowName);
+			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId))))).mutate(({ uow, retrieveResult: [instance] }) => {
 				if (!instance) throw new Error("INSTANCE_NOT_FOUND");
 				const currentStatus = buildInstanceStatus(instance).status;
 				if (isTerminalStatus(currentStatus)) throw new Error("INSTANCE_TERMINAL");
 				uow.update("workflow_instance", instance.id, (b) => b.set({
 					status: "terminated",
-					completedAt: now,
-					updatedAt: now,
-					pauseRequested: false
+					completedAt: b.now(),
+					updatedAt: b.now()
 				}).check());
+				setLiveInstanceStatus(workflowName, instanceId, "terminated");
 				return buildInstanceStatus({
 					status: "terminated",
 					output: instance.output,
@@ -449,42 +425,30 @@ const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatab
 			}).build();
 		},
 		restartInstance: function(workflowName, instanceId) {
-			const now = getNow();
-			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId))))).mutate(({ uow, retrieveResult: [instance] }) => {
+			assertWorkflowName(workflowName);
+			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId))))).mutate(({ uow, retrieveResult: [instance] }) => {
 				if (!instance) throw new Error("INSTANCE_NOT_FOUND");
 				const nextRun = instance.runNumber + 1;
 				uow.update("workflow_instance", instance.id, (b) => b.set({
-					status: "queued",
-					pauseRequested: false,
+					status: "active",
 					runNumber: nextRun,
 					startedAt: null,
 					completedAt: null,
 					output: null,
 					errorName: null,
 					errorMessage: null,
-					updatedAt: now
+					updatedAt: b.now()
 				}).check());
-				uow.create("workflow_task", {
-					instanceRef: instance.id,
-					workflowName,
-					instanceId,
-					runNumber: nextRun,
-					kind: "run",
-					runAt: getRunAtNow(),
-					status: "pending",
-					attempts: 0,
-					maxAttempts: 1,
-					lastError: null,
-					lockedUntil: null,
-					lockOwner: null
-				});
+				deleteLiveInstanceState(instanceId);
 				uow.triggerHook("onWorkflowEnqueued", {
 					workflowName,
-					instanceId,
+					instanceId: instance.id.toString(),
+					instanceRef: String(instance.id),
+					runNumber: nextRun,
 					reason: "create"
 				});
 				return buildInstanceStatus({
-					status: "queued",
+					status: "active",
 					output: null,
 					errorName: null,
 					errorMessage: null
@@ -492,54 +456,52 @@ const workflowsFragmentDefinition = defineFragment("workflows").extend(withDatab
 			}).build();
 		},
 		sendEvent: function(workflowName, instanceId, options) {
-			const now = getNow();
-			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_instanceId", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId)))).find("workflow_step", (b) => b.whereIndex("idx_workflow_step_status_wakeAt", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId), eb("status", "=", "waiting"), eb.or(eb.isNull("wakeAt"), eb("wakeAt", ">", dbNow()))))).find("workflow_task", (b) => b.whereIndex("idx_workflow_task_workflowName_instanceId_runNumber", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("instanceId", "=", instanceId))))).mutate(({ uow, retrieveResult: [instance, steps, tasks] }) => {
+			assertWorkflowName(workflowName);
+			return this.serviceTx(workflowsSchema).retrieve((uow) => uow.findFirst("workflow_instance", (b) => b.whereIndex("idx_workflow_instance_workflowName_id", (eb) => eb.and(eb("workflowName", "=", workflowName), eb("id", "=", instanceId)))).find("workflow_step", (b) => b.whereIndex("idx_workflow_step_instanceRef_status_wakeAt", (eb) => eb.and(eb("instanceRef", "=", instanceId), eb("status", "=", "waiting"), eb.or(eb.isNull("wakeAt"), eb("wakeAt", ">", eb.now())))))).mutate(({ uow, retrieveResult: [instance, steps] }) => {
 				if (!instance) throw new Error("INSTANCE_NOT_FOUND");
 				const currentStatus = buildInstanceStatus(instance).status;
 				if (isTerminalStatus(currentStatus)) throw new Error("INSTANCE_TERMINAL");
 				uow.create("workflow_event", {
 					instanceRef: instance.id,
-					workflowName,
-					instanceId,
 					runNumber: instance.runNumber,
+					actor: WORKFLOW_EVENT_ACTOR_USER,
 					type: options.type,
 					payload: options.payload ?? null,
+					...options.createdAt ? { createdAt: options.createdAt } : {},
 					deliveredAt: null,
 					consumedByStepKey: null
 				});
 				const currentRunSteps = steps.filter((step) => step.runNumber === instance.runNumber);
-				const currentTask = tasks.find((candidate) => candidate.runNumber === instance.runNumber);
-				if (currentStatus === "waiting" && !isPausedStatus(currentStatus) && currentRunSteps.some((step) => step.waitEventType === options.type)) {
-					if (currentTask) uow.update("workflow_task", currentTask.id, (b) => b.set({
-						kind: "wake",
-						runAt: getRunAtNow(),
-						status: "pending",
-						attempts: 0,
-						lastError: null,
-						lockedUntil: null,
-						lockOwner: null,
-						updatedAt: now
-					}).check());
-					else uow.create("workflow_task", {
-						instanceRef: instance.id,
+				if (currentStatus === "waiting" && currentRunSteps.some((step) => step.waitEventType === options.type)) {
+					WorkflowsLogger.debug("sendEvent wake", () => ({
 						workflowName,
 						instanceId,
 						runNumber: instance.runNumber,
-						kind: "wake",
-						runAt: getRunAtNow(),
-						status: "pending",
-						attempts: 0,
-						maxAttempts: 1,
-						lastError: null,
-						lockedUntil: null,
-						lockOwner: null
-					});
+						eventType: options.type,
+						status: currentStatus,
+						waitingSteps: currentRunSteps.filter((step) => step.status === "waiting").length
+					}));
 					uow.triggerHook("onWorkflowEnqueued", {
 						workflowName,
-						instanceId,
+						instanceId: instance.id.toString(),
+						instanceRef: String(instance.id),
+						runNumber: instance.runNumber,
 						reason: "event"
 					});
-				}
+				} else WorkflowsLogger.debug("sendEvent no-wake", () => {
+					const waitingSteps = currentRunSteps.filter((step) => step.status === "waiting");
+					const waitTypes = /* @__PURE__ */ new Set();
+					for (const step of waitingSteps) if (step.waitEventType) waitTypes.add(step.waitEventType);
+					return {
+						workflowName,
+						instanceId,
+						runNumber: instance.runNumber,
+						eventType: options.type,
+						status: currentStatus,
+						waitingSteps: waitingSteps.length,
+						waitEventTypes: Array.from(waitTypes)
+					};
+				});
 				return buildInstanceStatus(instance);
 			}).build();
 		}