@pixelzx/genesis 2026.5.3-2 → 2026.5.3-3

package/dist/task-registry-CQnnTGmN.js

@@ -0,0 +1,2366 @@
+import { i as formatErrorMessage } from "./errors-Jbvi20TW.js";
+import { c as normalizeOptionalString } from "./string-coerce-C1IzJjqi.js";
+import { t as createSubsystemLogger } from "./subsystem-DTMy5YmO.js";
+import { _ as resolveStateDir } from "./paths-DmR9mjUX.js";
+import { o as parseAgentSessionKey } from "./session-key-utils-BT0y7mVK.js";
+import { s as isDeliverableMessageChannel } from "./message-channel-D2Y7UhTM.js";
+import { i as normalizeDeliveryContext } from "./delivery-context.shared-D4UlGXfV.js";
+import { l as onAgentEvent } from "./agent-events-DpcKIBpp.js";
+import { t as requireNodeSqlite } from "./node-sqlite-CCZ4VvIJ.js";
+import { n as requestHeartbeatNow } from "./heartbeat-wake-gACR6ANS.js";
+import { i as enqueueSystemEvent } from "./system-events-k0hT4HhM.js";
+import { a as sanitizeTaskStatusText, i as formatTaskStatusTitleText } from "./task-status-Cw5Ekoq5.js";
+import { createRequire } from "node:module";
+import { chmodSync, existsSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import crypto from "node:crypto";
+import { isMainThread, threadId } from "node:worker_threads";
+//#region src/tasks/task-executor-policy.ts
+function isTerminalTaskStatus(status) {
+	return status === "succeeded" || status === "failed" || status === "timed_out" || status === "cancelled" || status === "lost";
+}
+function resolveTaskDisplayTitle(task) {
+	return formatTaskStatusTitleText(task.label?.trim() || (task.runtime === "acp" ? "ACP background task" : task.runtime === "subagent" ? "Subagent task" : task.task.trim() || "Background task"));
+}
+function resolveTaskRunLabel(task) {
+	return task.runId ? ` (run ${task.runId.slice(0, 8)})` : "";
+}
+function formatTaskTerminalMessage(task) {
+	const title = resolveTaskDisplayTitle(task);
+	const runLabel = resolveTaskRunLabel(task);
+	const summary = sanitizeTaskStatusText(task.terminalSummary, { errorContext: task.status !== "succeeded" || task.terminalOutcome === "blocked" });
+	if (task.status === "succeeded") {
+		if (task.terminalOutcome === "blocked") return summary ? `Background task blocked: ${title}${runLabel}. ${summary}` : `Background task blocked: ${title}${runLabel}.`;
+		return summary ? `Background task done: ${title}${runLabel}. ${summary}` : `Background task done: ${title}${runLabel}.`;
+	}
+	if (task.status === "timed_out") return `Background task timed out: ${title}${runLabel}.`;
+	if (task.status === "lost") {
+		const error = sanitizeTaskStatusText(task.error, { errorContext: true });
+		const fallbackSummary = sanitizeTaskStatusText(task.terminalSummary, { errorContext: true });
+		return `Background task lost: ${title}${runLabel}. ${error || fallbackSummary || "Backing session disappeared."}`;
+	}
+	if (task.status === "cancelled") return `Background task cancelled: ${title}${runLabel}.`;
+	const error = sanitizeTaskStatusText(task.error, { errorContext: true });
+	const fallbackSummary = sanitizeTaskStatusText(task.terminalSummary, { errorContext: true });
+	return error ? `Background task failed: ${title}${runLabel}. ${error}` : fallbackSummary ? `Background task failed: ${title}${runLabel}. ${fallbackSummary}` : `Background task failed: ${title}${runLabel}.`;
+}
+function formatTaskBlockedFollowupMessage(task) {
+	if (task.status !== "succeeded" || task.terminalOutcome !== "blocked") return null;
+	return `Task needs follow-up: ${resolveTaskDisplayTitle(task)}${resolveTaskRunLabel(task)}. ${sanitizeTaskStatusText(task.terminalSummary, { errorContext: true }) || "Task is blocked and needs follow-up."}`;
+}
+function formatTaskStateChangeMessage(task, event) {
+	const title = resolveTaskDisplayTitle(task);
+	if (event.kind === "running") return `Background task started: ${title}.`;
+	if (event.kind === "progress") {
+		const summary = sanitizeTaskStatusText(event.summary);
+		return summary ? `Background task update: ${title}. ${summary}` : null;
+	}
+	return null;
+}
+function shouldAutoDeliverTaskTerminalUpdate(task) {
+	if (task.notifyPolicy === "silent") return false;
+	if (task.runtime === "subagent" && task.status !== "cancelled") return false;
+	if (!isTerminalTaskStatus(task.status)) return false;
+	return task.deliveryStatus === "pending";
+}
+function shouldAutoDeliverTaskStateChange(task) {
+	return task.notifyPolicy === "state_changes" && task.deliveryStatus === "pending" && !isTerminalTaskStatus(task.status);
+}
+function shouldSuppressDuplicateTerminalDelivery(params) {
+	if (params.task.runtime !== "acp" || !params.task.runId?.trim()) return false;
+	return Boolean(params.preferredTaskId && params.preferredTaskId !== params.task.taskId);
+}
+//#endregion
+//#region src/tasks/task-registry.paths.ts
+function resolveTaskStateDir(env = process.env) {
+	if (env.GENESIS_STATE_DIR?.trim()) return resolveStateDir(env);
+	if (env.VITEST || env.NODE_ENV === "test") {
+		const workerIdRaw = env.VITEST_WORKER_ID ?? env.VITEST_POOL_ID ?? "";
+		const workerId = Number.parseInt(workerIdRaw, 10);
+		const shardSuffix = Number.isFinite(workerId) ? `${process.pid}-${workerId}` : isMainThread ? String(process.pid) : `${process.pid}-${threadId}`;
+		return path.join(os.tmpdir(), "genesis-test-state", shardSuffix);
+	}
+	return resolveStateDir(env);
+}
+function resolveTaskRegistryDir(env = process.env) {
+	return path.join(resolveTaskStateDir(env), "tasks");
+}
+function resolveTaskRegistrySqlitePath(env = process.env) {
+	return path.join(resolveTaskRegistryDir(env), "runs.sqlite");
+}
+//#endregion
+//#region src/tasks/task-flow-registry.paths.ts
+function resolveTaskFlowRegistryDir(env = process.env) {
+	return path.join(resolveTaskStateDir(env), "flows");
+}
+function resolveTaskFlowRegistrySqlitePath(env = process.env) {
+	return path.join(resolveTaskFlowRegistryDir(env), "registry.sqlite");
+}
+//#endregion
+//#region src/tasks/task-flow-registry.store.sqlite.ts
+let cachedDatabase$1 = null;
+const FLOW_REGISTRY_DIR_MODE = 448;
+const FLOW_REGISTRY_FILE_MODE = 384;
+const FLOW_REGISTRY_SIDECAR_SUFFIXES = [
+	"",
+	"-shm",
+	"-wal"
+];
+function normalizeNumber$1(value) {
+	if (typeof value === "bigint") return Number(value);
+	return typeof value === "number" ? value : void 0;
+}
+function serializeJson$1(value) {
+	return value === void 0 ? null : JSON.stringify(value);
+}
+function parseJsonValue$1(raw) {
+	if (!raw?.trim()) return;
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return;
+	}
+}
+function rowToSyncMode(row) {
+	if (row.sync_mode === "task_mirrored" || row.sync_mode === "managed") return row.sync_mode;
+	return row.shape === "single_task" ? "task_mirrored" : "managed";
+}
+function rowToFlowRecord(row) {
+	const endedAt = normalizeNumber$1(row.ended_at);
+	const cancelRequestedAt = normalizeNumber$1(row.cancel_requested_at);
+	const requesterOrigin = parseJsonValue$1(row.requester_origin_json);
+	const stateJson = parseJsonValue$1(row.state_json);
+	const waitJson = parseJsonValue$1(row.wait_json);
+	return {
+		flowId: row.flow_id,
+		syncMode: rowToSyncMode(row),
+		ownerKey: row.owner_key,
+		...requesterOrigin ? { requesterOrigin } : {},
+		...row.controller_id ? { controllerId: row.controller_id } : {},
+		revision: normalizeNumber$1(row.revision) ?? 0,
+		status: row.status,
+		notifyPolicy: row.notify_policy,
+		goal: row.goal,
+		...row.current_step ? { currentStep: row.current_step } : {},
+		...row.blocked_task_id ? { blockedTaskId: row.blocked_task_id } : {},
+		...row.blocked_summary ? { blockedSummary: row.blocked_summary } : {},
+		...stateJson !== void 0 ? { stateJson } : {},
+		...waitJson !== void 0 ? { waitJson } : {},
+		...cancelRequestedAt != null ? { cancelRequestedAt } : {},
+		createdAt: normalizeNumber$1(row.created_at) ?? 0,
+		updatedAt: normalizeNumber$1(row.updated_at) ?? 0,
+		...endedAt != null ? { endedAt } : {}
+	};
+}
+function bindFlowRecord(record) {
+	return {
+		flow_id: record.flowId,
+		sync_mode: record.syncMode,
+		owner_key: record.ownerKey,
+		requester_origin_json: serializeJson$1(record.requesterOrigin),
+		controller_id: record.controllerId ?? null,
+		revision: record.revision,
+		status: record.status,
+		notify_policy: record.notifyPolicy,
+		goal: record.goal,
+		current_step: record.currentStep ?? null,
+		blocked_task_id: record.blockedTaskId ?? null,
+		blocked_summary: record.blockedSummary ?? null,
+		state_json: serializeJson$1(record.stateJson),
+		wait_json: serializeJson$1(record.waitJson),
+		cancel_requested_at: record.cancelRequestedAt ?? null,
+		created_at: record.createdAt,
+		updated_at: record.updatedAt,
+		ended_at: record.endedAt ?? null
+	};
+}
+function createStatements$1(db) {
+	return {
+		selectAll: db.prepare(`
+      SELECT
+        flow_id,
+        sync_mode,
+        shape,
+        owner_key,
+        requester_origin_json,
+        controller_id,
+        revision,
+        status,
+        notify_policy,
+        goal,
+        current_step,
+        blocked_task_id,
+        blocked_summary,
+        state_json,
+        wait_json,
+        cancel_requested_at,
+        created_at,
+        updated_at,
+        ended_at
+      FROM flow_runs
+      ORDER BY created_at ASC, flow_id ASC
+    `),
+		upsertRow: db.prepare(`
+      INSERT INTO flow_runs (
+        flow_id,
+        sync_mode,
+        owner_key,
+        requester_origin_json,
+        controller_id,
+        revision,
+        status,
+        notify_policy,
+        goal,
+        current_step,
+        blocked_task_id,
+        blocked_summary,
+        state_json,
+        wait_json,
+        cancel_requested_at,
+        created_at,
+        updated_at,
+        ended_at
+      ) VALUES (
+        @flow_id,
+        @sync_mode,
+        @owner_key,
+        @requester_origin_json,
+        @controller_id,
+        @revision,
+        @status,
+        @notify_policy,
+        @goal,
+        @current_step,
+        @blocked_task_id,
+        @blocked_summary,
+        @state_json,
+        @wait_json,
+        @cancel_requested_at,
+        @created_at,
+        @updated_at,
+        @ended_at
+      )
+      ON CONFLICT(flow_id) DO UPDATE SET
+        sync_mode = excluded.sync_mode,
+        owner_key = excluded.owner_key,
+        requester_origin_json = excluded.requester_origin_json,
+        controller_id = excluded.controller_id,
+        revision = excluded.revision,
+        status = excluded.status,
+        notify_policy = excluded.notify_policy,
+        goal = excluded.goal,
+        current_step = excluded.current_step,
+        blocked_task_id = excluded.blocked_task_id,
+        blocked_summary = excluded.blocked_summary,
+        state_json = excluded.state_json,
+        wait_json = excluded.wait_json,
+        cancel_requested_at = excluded.cancel_requested_at,
+        created_at = excluded.created_at,
+        updated_at = excluded.updated_at,
+        ended_at = excluded.ended_at
+    `),
+		deleteRow: db.prepare(`DELETE FROM flow_runs WHERE flow_id = ?`),
+		clearRows: db.prepare(`DELETE FROM flow_runs`)
+	};
+}
+function hasFlowRunsColumn(db, columnName) {
+	return db.prepare(`PRAGMA table_info(flow_runs)`).all().some((row) => row.name === columnName);
+}
+function ensureSchema$1(db) {
+	db.exec(`
+    CREATE TABLE IF NOT EXISTS flow_runs (
+      flow_id TEXT PRIMARY KEY,
+      shape TEXT,
+      sync_mode TEXT NOT NULL DEFAULT 'managed',
+      owner_key TEXT NOT NULL,
+      requester_origin_json TEXT,
+      controller_id TEXT,
+      revision INTEGER NOT NULL DEFAULT 0,
+      status TEXT NOT NULL,
+      notify_policy TEXT NOT NULL,
+      goal TEXT NOT NULL,
+      current_step TEXT,
+      blocked_task_id TEXT,
+      blocked_summary TEXT,
+      state_json TEXT,
+      wait_json TEXT,
+      cancel_requested_at INTEGER,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL,
+      ended_at INTEGER
+    );
+  `);
+	if (!hasFlowRunsColumn(db, "owner_key") && hasFlowRunsColumn(db, "owner_session_key")) {
+		db.exec(`ALTER TABLE flow_runs ADD COLUMN owner_key TEXT;`);
+		db.exec(`
+      UPDATE flow_runs
+      SET owner_key = owner_session_key
+      WHERE owner_key IS NULL
+    `);
+	}
+	if (!hasFlowRunsColumn(db, "shape")) db.exec(`ALTER TABLE flow_runs ADD COLUMN shape TEXT;`);
+	if (!hasFlowRunsColumn(db, "sync_mode")) {
+		db.exec(`ALTER TABLE flow_runs ADD COLUMN sync_mode TEXT;`);
+		if (hasFlowRunsColumn(db, "shape")) db.exec(`
+        UPDATE flow_runs
+        SET sync_mode = CASE
+          WHEN shape = 'single_task' THEN 'task_mirrored'
+          ELSE 'managed'
+        END
+        WHERE sync_mode IS NULL
+      `);
+		else db.exec(`
+        UPDATE flow_runs
+        SET sync_mode = 'managed'
+        WHERE sync_mode IS NULL
+      `);
+	}
+	if (!hasFlowRunsColumn(db, "controller_id")) db.exec(`ALTER TABLE flow_runs ADD COLUMN controller_id TEXT;`);
+	db.exec(`
+    UPDATE flow_runs
+    SET controller_id = 'core/legacy-restored'
+    WHERE sync_mode = 'managed'
+      AND (controller_id IS NULL OR trim(controller_id) = '')
+  `);
+	if (!hasFlowRunsColumn(db, "revision")) {
+		db.exec(`ALTER TABLE flow_runs ADD COLUMN revision INTEGER;`);
+		db.exec(`
+      UPDATE flow_runs
+      SET revision = 0
+      WHERE revision IS NULL
+    `);
+	}
+	if (!hasFlowRunsColumn(db, "blocked_task_id")) db.exec(`ALTER TABLE flow_runs ADD COLUMN blocked_task_id TEXT;`);
+	if (!hasFlowRunsColumn(db, "blocked_summary")) db.exec(`ALTER TABLE flow_runs ADD COLUMN blocked_summary TEXT;`);
+	if (!hasFlowRunsColumn(db, "state_json")) db.exec(`ALTER TABLE flow_runs ADD COLUMN state_json TEXT;`);
+	if (!hasFlowRunsColumn(db, "wait_json")) db.exec(`ALTER TABLE flow_runs ADD COLUMN wait_json TEXT;`);
+	if (!hasFlowRunsColumn(db, "cancel_requested_at")) db.exec(`ALTER TABLE flow_runs ADD COLUMN cancel_requested_at INTEGER;`);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_flow_runs_status ON flow_runs(status);`);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_flow_runs_owner_key ON flow_runs(owner_key);`);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_flow_runs_updated_at ON flow_runs(updated_at);`);
+}
+function ensureFlowRegistryPermissions(pathname) {
+	const dir = resolveTaskFlowRegistryDir(process.env);
+	mkdirSync(dir, {
+		recursive: true,
+		mode: FLOW_REGISTRY_DIR_MODE
+	});
+	chmodSync(dir, FLOW_REGISTRY_DIR_MODE);
+	for (const suffix of FLOW_REGISTRY_SIDECAR_SUFFIXES) {
+		const candidate = `${pathname}${suffix}`;
+		if (!existsSync(candidate)) continue;
+		chmodSync(candidate, FLOW_REGISTRY_FILE_MODE);
+	}
+}
+function openFlowRegistryDatabase() {
+	const pathname = resolveTaskFlowRegistrySqlitePath(process.env);
+	if (cachedDatabase$1 && cachedDatabase$1.path === pathname) return cachedDatabase$1;
+	if (cachedDatabase$1) {
+		cachedDatabase$1.db.close();
+		cachedDatabase$1 = null;
+	}
+	ensureFlowRegistryPermissions(pathname);
+	const { DatabaseSync } = requireNodeSqlite();
+	const db = new DatabaseSync(pathname);
+	db.exec(`PRAGMA journal_mode = WAL;`);
+	db.exec(`PRAGMA synchronous = NORMAL;`);
+	db.exec(`PRAGMA busy_timeout = 5000;`);
+	ensureSchema$1(db);
+	ensureFlowRegistryPermissions(pathname);
+	cachedDatabase$1 = {
+		db,
+		path: pathname,
+		statements: createStatements$1(db)
+	};
+	return cachedDatabase$1;
+}
+function withWriteTransaction$1(write) {
+	const { db, path, statements } = openFlowRegistryDatabase();
+	db.exec("BEGIN IMMEDIATE");
+	try {
+		write(statements);
+		db.exec("COMMIT");
+		ensureFlowRegistryPermissions(path);
+	} catch (error) {
+		db.exec("ROLLBACK");
+		throw error;
+	}
+}
+function loadTaskFlowRegistryStateFromSqlite() {
+	const { statements } = openFlowRegistryDatabase();
+	const rows = statements.selectAll.all();
+	return { flows: new Map(rows.map((row) => [row.flow_id, rowToFlowRecord(row)])) };
+}
+function saveTaskFlowRegistryStateToSqlite(snapshot) {
+	withWriteTransaction$1((statements) => {
+		statements.clearRows.run();
+		for (const flow of snapshot.flows.values()) statements.upsertRow.run(bindFlowRecord(flow));
+	});
+}
+function upsertTaskFlowRegistryRecordToSqlite(flow) {
+	const store = openFlowRegistryDatabase();
+	store.statements.upsertRow.run(bindFlowRecord(flow));
+	ensureFlowRegistryPermissions(store.path);
+}
+function deleteTaskFlowRegistryRecordFromSqlite(flowId) {
+	const store = openFlowRegistryDatabase();
+	store.statements.deleteRow.run(flowId);
+	ensureFlowRegistryPermissions(store.path);
+}
+function closeTaskFlowRegistrySqliteStore() {
+	if (!cachedDatabase$1) return;
+	cachedDatabase$1.db.close();
+	cachedDatabase$1 = null;
+}
+let configuredFlowRegistryStore = {
+	loadSnapshot: loadTaskFlowRegistryStateFromSqlite,
+	saveSnapshot: saveTaskFlowRegistryStateToSqlite,
+	upsertFlow: upsertTaskFlowRegistryRecordToSqlite,
+	deleteFlow: deleteTaskFlowRegistryRecordFromSqlite,
+	close: closeTaskFlowRegistrySqliteStore
+};
+let configuredFlowRegistryObservers = null;
+function getTaskFlowRegistryStore() {
+	return configuredFlowRegistryStore;
+}
+function getTaskFlowRegistryObservers() {
+	return configuredFlowRegistryObservers;
+}
+//#endregion
+//#region src/tasks/task-flow-registry.ts
+const log$1 = createSubsystemLogger("tasks/task-flow-registry");
+const flows = /* @__PURE__ */ new Map();
+let restoreAttempted$1 = false;
+let restoreFailureMessage = null;
+function cloneStructuredValue(value) {
+	if (value === void 0) return;
+	return structuredClone(value);
+}
+function cloneFlowRecord(record) {
+	return {
+		...record,
+		...record.requesterOrigin ? { requesterOrigin: cloneStructuredValue(record.requesterOrigin) } : {},
+		...record.stateJson !== void 0 ? { stateJson: cloneStructuredValue(record.stateJson) } : {},
+		...record.waitJson !== void 0 ? { waitJson: cloneStructuredValue(record.waitJson) } : {}
+	};
+}
+function normalizeRestoredFlowRecord(record) {
+	const syncMode = record.syncMode === "task_mirrored" ? "task_mirrored" : "managed";
+	const controllerId = syncMode === "managed" ? normalizeOptionalString(record.controllerId) ?? "core/legacy-restored" : void 0;
+	return {
+		...record,
+		syncMode,
+		ownerKey: assertFlowOwnerKey(record.ownerKey),
+		...record.requesterOrigin ? { requesterOrigin: cloneStructuredValue(record.requesterOrigin) } : {},
+		...controllerId ? { controllerId } : {},
+		currentStep: normalizeOptionalString(record.currentStep),
+		blockedTaskId: normalizeOptionalString(record.blockedTaskId),
+		blockedSummary: normalizeOptionalString(record.blockedSummary),
+		...record.stateJson !== void 0 ? { stateJson: cloneStructuredValue(record.stateJson) } : {},
+		...record.waitJson !== void 0 ? { waitJson: cloneStructuredValue(record.waitJson) } : {},
+		revision: Math.max(0, record.revision),
+		cancelRequestedAt: record.cancelRequestedAt ?? void 0,
+		endedAt: record.endedAt ?? void 0
+	};
+}
+function snapshotFlowRecords(source) {
+	return [...source.values()].map((record) => cloneFlowRecord(record));
+}
+function emitFlowRegistryObserverEvent(createEvent) {
+	const observers = getTaskFlowRegistryObservers();
+	if (!observers?.onEvent) return;
+	try {
+		observers.onEvent(createEvent());
+	} catch {}
+}
+function ensureNotifyPolicy$1(notifyPolicy) {
+	return notifyPolicy ?? "done_only";
+}
+function normalizeJsonBlob(value) {
+	return value === void 0 ? void 0 : cloneStructuredValue(value);
+}
+function assertFlowOwnerKey(ownerKey) {
+	const normalized = normalizeOptionalString(ownerKey);
+	if (!normalized) throw new Error("Flow ownerKey is required.");
+	return normalized;
+}
+function assertControllerId(controllerId) {
+	const normalized = normalizeOptionalString(controllerId);
+	if (!normalized) throw new Error("Managed flow controllerId is required.");
+	return normalized;
+}
+function resolveFlowBlockedSummary(task) {
+	if (task.status !== "succeeded" || task.terminalOutcome !== "blocked") return;
+	return normalizeOptionalString(task.terminalSummary) ?? normalizeOptionalString(task.progressSummary);
+}
+function deriveTaskFlowStatusFromTask(task) {
+	if (task.status === "queued") return "queued";
+	if (task.status === "running") return "running";
+	if (task.status === "succeeded") return task.terminalOutcome === "blocked" ? "blocked" : "succeeded";
+	if (task.status === "cancelled") return "cancelled";
+	if (task.status === "lost") return "lost";
+	return "failed";
+}
+function ensureFlowRegistryReady() {
+	if (restoreAttempted$1) return;
+	restoreAttempted$1 = true;
+	try {
+		const restored = getTaskFlowRegistryStore().loadSnapshot();
+		flows.clear();
+		for (const [flowId, flow] of restored.flows) flows.set(flowId, normalizeRestoredFlowRecord(flow));
+		restoreFailureMessage = null;
+	} catch (error) {
+		flows.clear();
+		restoreFailureMessage = formatErrorMessage(error);
+		log$1.warn("Failed to restore task-flow registry", { error });
+		return;
+	}
+	emitFlowRegistryObserverEvent(() => ({
+		kind: "restored",
+		flows: snapshotFlowRecords(flows)
+	}));
+}
+function getTaskFlowRegistryRestoreFailure() {
+	ensureFlowRegistryReady();
+	return restoreFailureMessage;
+}
+function persistFlowRegistry() {
+	getTaskFlowRegistryStore().saveSnapshot({ flows: new Map(snapshotFlowRecords(flows).map((flow) => [flow.flowId, flow])) });
+}
+function persistFlowUpsert(flow) {
+	const store = getTaskFlowRegistryStore();
+	if (store.upsertFlow) {
+		store.upsertFlow(cloneFlowRecord(flow));
+		return;
+	}
+	persistFlowRegistry();
+}
+function persistFlowDelete(flowId) {
+	const store = getTaskFlowRegistryStore();
+	if (store.deleteFlow) {
+		store.deleteFlow(flowId);
+		return;
+	}
+	persistFlowRegistry();
+}
+function buildFlowRecord(params) {
+	const now = params.createdAt ?? Date.now();
+	const syncMode = params.syncMode ?? "managed";
+	const controllerId = syncMode === "managed" ? assertControllerId(params.controllerId) : void 0;
+	return {
+		flowId: crypto.randomUUID(),
+		syncMode,
+		ownerKey: assertFlowOwnerKey(params.ownerKey),
+		...params.requesterOrigin ? { requesterOrigin: cloneStructuredValue(params.requesterOrigin) } : {},
+		...controllerId ? { controllerId } : {},
+		revision: Math.max(0, params.revision ?? 0),
+		status: params.status ?? "queued",
+		notifyPolicy: ensureNotifyPolicy$1(params.notifyPolicy),
+		goal: params.goal,
+		currentStep: normalizeOptionalString(params.currentStep),
+		blockedTaskId: normalizeOptionalString(params.blockedTaskId),
+		blockedSummary: normalizeOptionalString(params.blockedSummary),
+		...normalizeJsonBlob(params.stateJson) !== void 0 ? { stateJson: normalizeJsonBlob(params.stateJson) } : {},
+		...normalizeJsonBlob(params.waitJson) !== void 0 ? { waitJson: normalizeJsonBlob(params.waitJson) } : {},
+		...params.cancelRequestedAt != null ? { cancelRequestedAt: params.cancelRequestedAt } : {},
+		createdAt: now,
+		updatedAt: params.updatedAt ?? now,
+		...params.endedAt != null ? { endedAt: params.endedAt } : {}
+	};
+}
+function applyFlowPatch(current, patch) {
+	const controllerId = patch.controllerId === void 0 ? current.controllerId : normalizeOptionalString(patch.controllerId);
+	if (current.syncMode === "managed") assertControllerId(controllerId);
+	return {
+		...current,
+		...patch.status ? { status: patch.status } : {},
+		...patch.notifyPolicy ? { notifyPolicy: patch.notifyPolicy } : {},
+		...patch.goal ? { goal: patch.goal } : {},
+		controllerId,
+		currentStep: patch.currentStep === void 0 ? current.currentStep : normalizeOptionalString(patch.currentStep),
+		blockedTaskId: patch.blockedTaskId === void 0 ? current.blockedTaskId : normalizeOptionalString(patch.blockedTaskId),
+		blockedSummary: patch.blockedSummary === void 0 ? current.blockedSummary : normalizeOptionalString(patch.blockedSummary),
+		stateJson: patch.stateJson === void 0 ? current.stateJson : normalizeJsonBlob(patch.stateJson),
+		waitJson: patch.waitJson === void 0 ? current.waitJson : normalizeJsonBlob(patch.waitJson),
+		cancelRequestedAt: patch.cancelRequestedAt === void 0 ? current.cancelRequestedAt : patch.cancelRequestedAt ?? void 0,
+		revision: current.revision + 1,
+		updatedAt: patch.updatedAt ?? Date.now(),
+		endedAt: patch.endedAt === void 0 ? current.endedAt : patch.endedAt ?? void 0
+	};
+}
+function writeFlowRecord(next, previous) {
+	flows.set(next.flowId, next);
+	persistFlowUpsert(next);
+	emitFlowRegistryObserverEvent(() => ({
+		kind: "upserted",
+		flow: cloneFlowRecord(next),
+		...previous ? { previous: cloneFlowRecord(previous) } : {}
+	}));
+	return cloneFlowRecord(next);
+}
+function createFlowRecord(params) {
+	ensureFlowRegistryReady();
+	return writeFlowRecord(buildFlowRecord(params));
+}
+function createManagedTaskFlow(params) {
+	return createFlowRecord({
+		...params,
+		syncMode: "managed",
+		controllerId: assertControllerId(params.controllerId)
+	});
+}
+function createTaskFlowForTask(params) {
+	const terminalFlowStatus = deriveTaskFlowStatusFromTask(params.task);
+	const endedAt = terminalFlowStatus === "succeeded" || terminalFlowStatus === "blocked" || terminalFlowStatus === "failed" || terminalFlowStatus === "cancelled" || terminalFlowStatus === "lost" ? params.task.endedAt ?? params.task.lastEventAt ?? params.task.createdAt : void 0;
+	return createFlowRecord({
+		syncMode: "task_mirrored",
+		ownerKey: params.task.ownerKey,
+		requesterOrigin: params.requesterOrigin,
+		status: terminalFlowStatus,
+		notifyPolicy: params.task.notifyPolicy,
+		goal: normalizeOptionalString(params.task.label) ?? (params.task.task.trim() || "Background task"),
+		blockedTaskId: terminalFlowStatus === "blocked" ? normalizeOptionalString(params.task.taskId) : void 0,
+		blockedSummary: resolveFlowBlockedSummary(params.task),
+		createdAt: params.task.createdAt,
+		updatedAt: params.task.lastEventAt ?? params.task.createdAt,
+		...endedAt !== void 0 ? { endedAt } : {}
+	});
+}
+function updateFlowRecordByIdUnchecked(flowId, patch) {
+	ensureFlowRegistryReady();
+	const current = flows.get(flowId);
+	if (!current) return null;
+	return writeFlowRecord(applyFlowPatch(current, patch), current);
+}
+function updateFlowRecordByIdExpectedRevision(params) {
+	ensureFlowRegistryReady();
+	const current = flows.get(params.flowId);
+	if (!current) return {
+		applied: false,
+		reason: "not_found"
+	};
+	if (current.revision !== params.expectedRevision) return {
+		applied: false,
+		reason: "revision_conflict",
+		current: cloneFlowRecord(current)
+	};
+	return {
+		applied: true,
+		flow: writeFlowRecord(applyFlowPatch(current, params.patch), current)
+	};
+}
+function setFlowWaiting(params) {
+	return updateFlowRecordByIdExpectedRevision({
+		flowId: params.flowId,
+		expectedRevision: params.expectedRevision,
+		patch: {
+			status: normalizeOptionalString(params.blockedTaskId) || normalizeOptionalString(params.blockedSummary) ? "blocked" : "waiting",
+			currentStep: params.currentStep,
+			stateJson: params.stateJson,
+			waitJson: params.waitJson,
+			blockedTaskId: params.blockedTaskId,
+			blockedSummary: params.blockedSummary,
+			endedAt: null,
+			updatedAt: params.updatedAt
+		}
+	});
+}
+function resumeFlow(params) {
+	return updateFlowRecordByIdExpectedRevision({
+		flowId: params.flowId,
+		expectedRevision: params.expectedRevision,
+		patch: {
+			status: params.status ?? "queued",
+			currentStep: params.currentStep,
+			stateJson: params.stateJson,
+			waitJson: null,
+			blockedTaskId: null,
+			blockedSummary: null,
+			endedAt: null,
+			updatedAt: params.updatedAt
+		}
+	});
+}
+function finishFlow(params) {
+	const endedAt = params.endedAt ?? params.updatedAt ?? Date.now();
+	return updateFlowRecordByIdExpectedRevision({
+		flowId: params.flowId,
+		expectedRevision: params.expectedRevision,
+		patch: {
+			status: "succeeded",
+			currentStep: params.currentStep,
+			stateJson: params.stateJson,
+			waitJson: null,
+			blockedTaskId: null,
+			blockedSummary: null,
+			endedAt,
+			updatedAt: params.updatedAt ?? endedAt
+		}
+	});
+}
+function failFlow(params) {
+	const endedAt = params.endedAt ?? params.updatedAt ?? Date.now();
+	return updateFlowRecordByIdExpectedRevision({
+		flowId: params.flowId,
+		expectedRevision: params.expectedRevision,
+		patch: {
+			status: "failed",
+			currentStep: params.currentStep,
+			stateJson: params.stateJson,
+			waitJson: null,
+			blockedTaskId: params.blockedTaskId,
+			blockedSummary: params.blockedSummary,
+			endedAt,
+			updatedAt: params.updatedAt ?? endedAt
+		}
+	});
+}
+function requestFlowCancel(params) {
+	return updateFlowRecordByIdExpectedRevision({
+		flowId: params.flowId,
+		expectedRevision: params.expectedRevision,
+		patch: {
+			cancelRequestedAt: params.cancelRequestedAt ?? params.updatedAt ?? Date.now(),
+			updatedAt: params.updatedAt
+		}
+	});
+}
+function syncFlowFromTask(task) {
+	const flowId = task.parentFlowId?.trim();
+	if (!flowId) return null;
+	const flow = getTaskFlowById(flowId);
+	if (!flow) return null;
+	if (flow.syncMode !== "task_mirrored") return flow;
+	const terminalFlowStatus = deriveTaskFlowStatusFromTask(task);
+	const isTerminal = terminalFlowStatus === "succeeded" || terminalFlowStatus === "blocked" || terminalFlowStatus === "failed" || terminalFlowStatus === "cancelled" || terminalFlowStatus === "lost";
+	return updateFlowRecordByIdUnchecked(flowId, {
+		status: terminalFlowStatus,
+		notifyPolicy: task.notifyPolicy,
+		goal: normalizeOptionalString(task.label) ?? (task.task.trim() || "Background task"),
+		blockedTaskId: terminalFlowStatus === "blocked" ? task.taskId.trim() || null : null,
+		blockedSummary: terminalFlowStatus === "blocked" ? resolveFlowBlockedSummary(task) ?? null : null,
+		waitJson: null,
+		updatedAt: task.lastEventAt ?? Date.now(),
+		...isTerminal ? { endedAt: task.endedAt ?? task.lastEventAt ?? Date.now() } : { endedAt: null }
+	});
+}
+function getTaskFlowById(flowId) {
+	ensureFlowRegistryReady();
+	const flow = flows.get(flowId);
+	return flow ? cloneFlowRecord(flow) : void 0;
+}
+function listTaskFlowsForOwnerKey(ownerKey) {
+	ensureFlowRegistryReady();
+	const normalizedOwnerKey = ownerKey.trim();
+	if (!normalizedOwnerKey) return [];
+	return [...flows.values()].filter((flow) => flow.ownerKey.trim() === normalizedOwnerKey).map((flow) => cloneFlowRecord(flow)).toSorted((left, right) => right.createdAt - left.createdAt);
+}
+function findLatestTaskFlowForOwnerKey(ownerKey) {
+	const flow = listTaskFlowsForOwnerKey(ownerKey)[0];
+	return flow ? cloneFlowRecord(flow) : void 0;
+}
+function resolveTaskFlowForLookupToken(token) {
+	const lookup = token.trim();
+	if (!lookup) return;
+	return getTaskFlowById(lookup) ?? findLatestTaskFlowForOwnerKey(lookup);
+}
+function listTaskFlowRecords() {
+	ensureFlowRegistryReady();
+	return [...flows.values()].map((flow) => cloneFlowRecord(flow)).toSorted((left, right) => right.createdAt - left.createdAt);
+}
+function deleteTaskFlowRecordById(flowId) {
+	ensureFlowRegistryReady();
+	const current = flows.get(flowId);
+	if (!current) return false;
+	flows.delete(flowId);
+	persistFlowDelete(flowId);
+	emitFlowRegistryObserverEvent(() => ({
+		kind: "deleted",
+		flowId,
+		previous: cloneFlowRecord(current)
+	}));
+	return true;
+}
+//#endregion
+//#region src/tasks/task-registry.store.sqlite.ts
+let cachedDatabase = null;
+const TASK_REGISTRY_DIR_MODE = 448;
+const TASK_REGISTRY_FILE_MODE = 384;
+const TASK_REGISTRY_SIDECAR_SUFFIXES = [
+	"",
+	"-shm",
+	"-wal"
+];
+function normalizeNumber(value) {
+	if (typeof value === "bigint") return Number(value);
+	return typeof value === "number" ? value : void 0;
+}
+function serializeJson(value) {
+	return value == null ? null : JSON.stringify(value);
+}
+function parseJsonValue(raw) {
+	if (!raw?.trim()) return;
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return;
+	}
+}
+function rowToTaskRecord(row) {
+	const startedAt = normalizeNumber(row.started_at);
+	const endedAt = normalizeNumber(row.ended_at);
+	const lastEventAt = normalizeNumber(row.last_event_at);
+	const cleanupAfter = normalizeNumber(row.cleanup_after);
+	const requesterSessionKey = row.scope_kind === "system" ? "" : row.requester_session_key?.trim() || row.owner_key;
+	return {
+		taskId: row.task_id,
+		runtime: row.runtime,
+		...row.task_kind ? { taskKind: row.task_kind } : {},
+		...row.source_id ? { sourceId: row.source_id } : {},
+		requesterSessionKey,
+		ownerKey: row.owner_key,
+		scopeKind: row.scope_kind,
+		...row.child_session_key ? { childSessionKey: row.child_session_key } : {},
+		...row.parent_flow_id ? { parentFlowId: row.parent_flow_id } : {},
+		...row.parent_task_id ? { parentTaskId: row.parent_task_id } : {},
+		...row.agent_id ? { agentId: row.agent_id } : {},
+		...row.run_id ? { runId: row.run_id } : {},
+		...row.label ? { label: row.label } : {},
+		task: row.task,
+		status: row.status,
+		deliveryStatus: row.delivery_status,
+		notifyPolicy: row.notify_policy,
+		createdAt: normalizeNumber(row.created_at) ?? 0,
+		...startedAt != null ? { startedAt } : {},
+		...endedAt != null ? { endedAt } : {},
+		...lastEventAt != null ? { lastEventAt } : {},
+		...cleanupAfter != null ? { cleanupAfter } : {},
+		...row.error ? { error: row.error } : {},
+		...row.progress_summary ? { progressSummary: row.progress_summary } : {},
+		...row.terminal_summary ? { terminalSummary: row.terminal_summary } : {},
+		...row.terminal_outcome ? { terminalOutcome: row.terminal_outcome } : {}
+	};
+}
+function rowToTaskDeliveryState(row) {
+	const requesterOrigin = parseJsonValue(row.requester_origin_json);
+	const lastNotifiedEventAt = normalizeNumber(row.last_notified_event_at);
+	return {
+		taskId: row.task_id,
+		...requesterOrigin ? { requesterOrigin } : {},
+		...lastNotifiedEventAt != null ? { lastNotifiedEventAt } : {}
+	};
+}
+function bindTaskRecordBase(record) {
+	return {
+		task_id: record.taskId,
+		runtime: record.runtime,
+		task_kind: record.taskKind ?? null,
+		source_id: record.sourceId ?? null,
+		requester_session_key: record.scopeKind === "system" ? "" : record.requesterSessionKey,
+		owner_key: record.ownerKey,
+		scope_kind: record.scopeKind,
+		child_session_key: record.childSessionKey ?? null,
+		parent_flow_id: record.parentFlowId ?? null,
+		parent_task_id: record.parentTaskId ?? null,
+		agent_id: record.agentId ?? null,
+		run_id: record.runId ?? null,
+		label: record.label ?? null,
+		task: record.task,
+		status: record.status,
+		delivery_status: record.deliveryStatus,
+		notify_policy: record.notifyPolicy,
+		created_at: record.createdAt,
+		started_at: record.startedAt ?? null,
+		ended_at: record.endedAt ?? null,
+		last_event_at: record.lastEventAt ?? null,
+		cleanup_after: record.cleanupAfter ?? null,
+		error: record.error ?? null,
+		progress_summary: record.progressSummary ?? null,
+		terminal_summary: record.terminalSummary ?? null,
+		terminal_outcome: record.terminalOutcome ?? null
+	};
+}
+function bindTaskDeliveryState(state) {
+	return {
+		task_id: state.taskId,
+		requester_origin_json: serializeJson(state.requesterOrigin),
+		last_notified_event_at: state.lastNotifiedEventAt ?? null
+	};
+}
+function createStatements(db) {
+	return {
+		selectAll: db.prepare(`
+      SELECT
+        task_id,
+        runtime,
+        task_kind,
+        source_id,
+        requester_session_key,
+        owner_key,
+        scope_kind,
+        child_session_key,
+        parent_flow_id,
+        parent_task_id,
+        agent_id,
+        run_id,
+        label,
+        task,
+        status,
+        delivery_status,
+        notify_policy,
+        created_at,
+        started_at,
+        ended_at,
+        last_event_at,
+        cleanup_after,
+        error,
+        progress_summary,
+        terminal_summary,
+        terminal_outcome
+      FROM task_runs
+      ORDER BY created_at ASC, task_id ASC
+    `),
+		selectAllDeliveryStates: db.prepare(`
+      SELECT
+        task_id,
+        requester_origin_json,
+        last_notified_event_at
+      FROM task_delivery_state
+      ORDER BY task_id ASC
+    `),
+		upsertRow: db.prepare(`
+      INSERT INTO task_runs (
+        task_id,
+        runtime,
+        task_kind,
+        source_id,
+        requester_session_key,
+        owner_key,
+        scope_kind,
+        child_session_key,
+        parent_flow_id,
+        parent_task_id,
+        agent_id,
+        run_id,
+        label,
+        task,
+        status,
+        delivery_status,
+        notify_policy,
+        created_at,
+        started_at,
+        ended_at,
+        last_event_at,
+        cleanup_after,
+        error,
+        progress_summary,
+        terminal_summary,
+        terminal_outcome
+      ) VALUES (
+        @task_id,
+        @runtime,
+        @task_kind,
+        @source_id,
+        @requester_session_key,
+        @owner_key,
+        @scope_kind,
+        @child_session_key,
+        @parent_flow_id,
+        @parent_task_id,
+        @agent_id,
+        @run_id,
+        @label,
+        @task,
+        @status,
+        @delivery_status,
+        @notify_policy,
+        @created_at,
+        @started_at,
+        @ended_at,
+        @last_event_at,
+        @cleanup_after,
+        @error,
+        @progress_summary,
+        @terminal_summary,
+        @terminal_outcome
+      )
+      ON CONFLICT(task_id) DO UPDATE SET
+        runtime = excluded.runtime,
+        task_kind = excluded.task_kind,
+        source_id = excluded.source_id,
+        requester_session_key = excluded.requester_session_key,
+        owner_key = excluded.owner_key,
+        scope_kind = excluded.scope_kind,
+        child_session_key = excluded.child_session_key,
+        parent_flow_id = excluded.parent_flow_id,
+        parent_task_id = excluded.parent_task_id,
+        agent_id = excluded.agent_id,
+        run_id = excluded.run_id,
+        label = excluded.label,
+        task = excluded.task,
+        status = excluded.status,
+        delivery_status = excluded.delivery_status,
+        notify_policy = excluded.notify_policy,
+        created_at = excluded.created_at,
+        started_at = excluded.started_at,
+        ended_at = excluded.ended_at,
+        last_event_at = excluded.last_event_at,
+        cleanup_after = excluded.cleanup_after,
+        error = excluded.error,
+        progress_summary = excluded.progress_summary,
+        terminal_summary = excluded.terminal_summary,
+        terminal_outcome = excluded.terminal_outcome
+    `),
+		replaceDeliveryState: db.prepare(`
+      INSERT OR REPLACE INTO task_delivery_state (
+        task_id,
+        requester_origin_json,
+        last_notified_event_at
+      ) VALUES (
+        @task_id,
+        @requester_origin_json,
+        @last_notified_event_at
+      )
+    `),
+		deleteRow: db.prepare(`DELETE FROM task_runs WHERE task_id = ?`),
+		deleteDeliveryState: db.prepare(`DELETE FROM task_delivery_state WHERE task_id = ?`),
+		clearRows: db.prepare(`DELETE FROM task_runs`),
+		clearDeliveryStates: db.prepare(`DELETE FROM task_delivery_state`)
+	};
+}
+function hasTaskRunsColumn(db, columnName) {
+	return db.prepare(`PRAGMA table_info(task_runs)`).all().some((row) => row.name === columnName);
+}
+function migrateLegacyOwnerColumns(db) {
+	if (!hasTaskRunsColumn(db, "owner_key")) db.exec(`ALTER TABLE task_runs ADD COLUMN owner_key TEXT;`);
+	if (!hasTaskRunsColumn(db, "requester_session_key")) db.exec(`ALTER TABLE task_runs ADD COLUMN requester_session_key TEXT;`);
+	if (!hasTaskRunsColumn(db, "scope_kind")) db.exec(`ALTER TABLE task_runs ADD COLUMN scope_kind TEXT NOT NULL DEFAULT 'session';`);
+	if (hasTaskRunsColumn(db, "requester_session_key")) db.exec(`
+      UPDATE task_runs
+      SET owner_key = requester_session_key
+      WHERE owner_key IS NULL
+    `);
+	db.exec(`
+    UPDATE task_runs
+    SET owner_key = CASE
+      WHEN trim(COALESCE(owner_key, '')) <> '' THEN trim(owner_key)
+      ELSE 'system:' || runtime || ':' || COALESCE(NULLIF(source_id, ''), task_id)
+    END
+  `);
+	db.exec(`
+    UPDATE task_runs
+    SET scope_kind = CASE
+      WHEN scope_kind = 'system' THEN 'system'
+      WHEN owner_key LIKE 'system:%' THEN 'system'
+      ELSE 'session'
+    END
+  `);
+	db.exec(`
+    UPDATE task_runs
+    SET requester_session_key = CASE
+      WHEN scope_kind = 'system' THEN ''
+      WHEN trim(COALESCE(requester_session_key, '')) <> '' THEN trim(requester_session_key)
+      ELSE owner_key
+    END
+  `);
+}
+function ensureSchema(db) {
+	db.exec(`
+    CREATE TABLE IF NOT EXISTS task_runs (
+      task_id TEXT PRIMARY KEY,
+      runtime TEXT NOT NULL,
+      task_kind TEXT,
+      source_id TEXT,
+      requester_session_key TEXT,
+      owner_key TEXT NOT NULL,
+      scope_kind TEXT NOT NULL,
+      child_session_key TEXT,
+      parent_flow_id TEXT,
+      parent_task_id TEXT,
+      agent_id TEXT,
+      run_id TEXT,
+      label TEXT,
+      task TEXT NOT NULL,
+      status TEXT NOT NULL,
+      delivery_status TEXT NOT NULL,
+      notify_policy TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      started_at INTEGER,
+      ended_at INTEGER,
+      last_event_at INTEGER,
+      cleanup_after INTEGER,
+      error TEXT,
+      progress_summary TEXT,
+      terminal_summary TEXT,
+      terminal_outcome TEXT
+    );
+  `);
+	migrateLegacyOwnerColumns(db);
+	if (!hasTaskRunsColumn(db, "task_kind")) db.exec(`ALTER TABLE task_runs ADD COLUMN task_kind TEXT;`);
+	if (!hasTaskRunsColumn(db, "parent_flow_id")) db.exec(`ALTER TABLE task_runs ADD COLUMN parent_flow_id TEXT;`);
+	db.exec(`
+    CREATE TABLE IF NOT EXISTS task_delivery_state (
+      task_id TEXT PRIMARY KEY,
+      requester_origin_json TEXT,
+      last_notified_event_at INTEGER
+    );
+  `);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_task_runs_run_id ON task_runs(run_id);`);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_task_runs_status ON task_runs(status);`);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_task_runs_runtime_status ON task_runs(runtime, status);`);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_task_runs_cleanup_after ON task_runs(cleanup_after);`);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_task_runs_last_event_at ON task_runs(last_event_at);`);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_task_runs_owner_key ON task_runs(owner_key);`);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_task_runs_parent_flow_id ON task_runs(parent_flow_id);`);
+	db.exec(`CREATE INDEX IF NOT EXISTS idx_task_runs_child_session_key ON task_runs(child_session_key);`);
+}
+function ensureTaskRegistryPermissions(pathname) {
+	const dir = resolveTaskRegistryDir(process.env);
+	mkdirSync(dir, {
+		recursive: true,
+		mode: TASK_REGISTRY_DIR_MODE
+	});
+	chmodSync(dir, TASK_REGISTRY_DIR_MODE);
+	for (const suffix of TASK_REGISTRY_SIDECAR_SUFFIXES) {
+		const candidate = `${pathname}${suffix}`;
+		if (!existsSync(candidate)) continue;
+		chmodSync(candidate, TASK_REGISTRY_FILE_MODE);
+	}
+}
+function openTaskRegistryDatabase() {
+	const pathname = resolveTaskRegistrySqlitePath(process.env);
+	if (cachedDatabase && cachedDatabase.path === pathname) return cachedDatabase;
+	if (cachedDatabase) {
+		cachedDatabase.db.close();
+		cachedDatabase = null;
+	}
+	ensureTaskRegistryPermissions(pathname);
+	const { DatabaseSync } = requireNodeSqlite();
+	const db = new DatabaseSync(pathname);
+	db.exec(`PRAGMA journal_mode = WAL;`);
+	db.exec(`PRAGMA synchronous = NORMAL;`);
+	db.exec(`PRAGMA busy_timeout = 5000;`);
+	ensureSchema(db);
+	ensureTaskRegistryPermissions(pathname);
+	cachedDatabase = {
+		db,
+		path: pathname,
+		statements: createStatements(db)
+	};
+	return cachedDatabase;
+}
+function withWriteTransaction(write) {
+	const { db, path, statements } = openTaskRegistryDatabase();
+	db.exec("BEGIN IMMEDIATE");
+	try {
+		write(statements);
+		db.exec("COMMIT");
+		ensureTaskRegistryPermissions(path);
+	} catch (error) {
+		db.exec("ROLLBACK");
+		throw error;
+	}
+}
+function loadTaskRegistryStateFromSqlite() {
+	const { statements } = openTaskRegistryDatabase();
+	const taskRows = statements.selectAll.all();
+	const deliveryRows = statements.selectAllDeliveryStates.all();
+	return {
+		tasks: new Map(taskRows.map((row) => [row.task_id, rowToTaskRecord(row)])),
+		deliveryStates: new Map(deliveryRows.map((row) => [row.task_id, rowToTaskDeliveryState(row)]))
+	};
+}
+function saveTaskRegistryStateToSqlite(snapshot) {
+	withWriteTransaction((statements) => {
+		statements.clearDeliveryStates.run();
+		statements.clearRows.run();
+		for (const task of snapshot.tasks.values()) statements.upsertRow.run(bindTaskRecordBase(task));
+		for (const state of snapshot.deliveryStates.values()) statements.replaceDeliveryState.run(bindTaskDeliveryState(state));
+	});
+}
+function upsertTaskRegistryRecordToSqlite(task) {
+	openTaskRegistryDatabase().statements.upsertRow.run(bindTaskRecordBase(task));
+}
+function upsertTaskWithDeliveryStateToSqlite(params) {
+	withWriteTransaction((statements) => {
+		statements.upsertRow.run(bindTaskRecordBase(params.task));
+		if (params.deliveryState) statements.replaceDeliveryState.run(bindTaskDeliveryState(params.deliveryState));
+		else statements.deleteDeliveryState.run(params.task.taskId);
+	});
+}
+function deleteTaskRegistryRecordFromSqlite(taskId) {
+	const store = openTaskRegistryDatabase();
+	store.statements.deleteRow.run(taskId);
+	store.statements.deleteDeliveryState.run(taskId);
+}
+function deleteTaskAndDeliveryStateFromSqlite(taskId) {
+	withWriteTransaction((statements) => {
+		statements.deleteRow.run(taskId);
+		statements.deleteDeliveryState.run(taskId);
+	});
+}
+function upsertTaskDeliveryStateToSqlite(state) {
+	openTaskRegistryDatabase().statements.replaceDeliveryState.run(bindTaskDeliveryState(state));
+}
+function deleteTaskDeliveryStateFromSqlite(taskId) {
+	openTaskRegistryDatabase().statements.deleteDeliveryState.run(taskId);
+}
+function closeTaskRegistrySqliteStore() {
+	if (!cachedDatabase) return;
+	cachedDatabase.db.close();
+	cachedDatabase = null;
+}
+let configuredTaskRegistryStore = {
+	loadSnapshot: loadTaskRegistryStateFromSqlite,
+	saveSnapshot: saveTaskRegistryStateToSqlite,
+	upsertTaskWithDeliveryState: upsertTaskWithDeliveryStateToSqlite,
+	upsertTask: upsertTaskRegistryRecordToSqlite,
+	deleteTaskWithDeliveryState: deleteTaskAndDeliveryStateFromSqlite,
+	deleteTask: deleteTaskRegistryRecordFromSqlite,
+	upsertDeliveryState: upsertTaskDeliveryStateToSqlite,
+	deleteDeliveryState: deleteTaskDeliveryStateFromSqlite,
+	close: closeTaskRegistrySqliteStore
+};
+let configuredTaskRegistryObservers = null;
+function getTaskRegistryStore() {
+	return configuredTaskRegistryStore;
+}
+function getTaskRegistryObservers() {
+	return configuredTaskRegistryObservers;
+}
+//#endregion
+//#region src/tasks/task-registry.ts
+const log = createSubsystemLogger("tasks/registry");
+const DEFAULT_TASK_RETENTION_MS = 10080 * 6e4;
+const tasks = /* @__PURE__ */ new Map();
+const taskDeliveryStates = /* @__PURE__ */ new Map();
+const taskIdsByRunId = /* @__PURE__ */ new Map();
+const taskIdsByOwnerKey = /* @__PURE__ */ new Map();
+const taskIdsByParentFlowId = /* @__PURE__ */ new Map();
+const taskIdsByRelatedSessionKey = /* @__PURE__ */ new Map();
+const tasksWithPendingDelivery = /* @__PURE__ */ new Set();
+let listenerStarted = false;
+let restoreAttempted = false;
+const TASK_REGISTRY_DELIVERY_RUNTIME_OVERRIDE_KEY = Symbol.for("genesis.taskRegistry.deliveryRuntimeOverride");
+const TASK_REGISTRY_CONTROL_RUNTIME_OVERRIDE_KEY = Symbol.for("genesis.taskRegistry.controlRuntimeOverride");
+const require = createRequire(import.meta.url);
+const TASK_REGISTRY_CONTROL_RUNTIME_CANDIDATES = ["./task-registry-control.runtime.js", "./task-registry-control.runtime.ts"];
+let deliveryRuntimePromise = null;
+let controlRuntimePromise = null;
+var ParentFlowLinkError = class extends Error {
+	constructor(code, message, details) {
+		super(message);
+		this.code = code;
+		this.details = details;
+		this.name = "ParentFlowLinkError";
+	}
+};
+function isParentFlowLinkError(error) {
+	return error instanceof ParentFlowLinkError;
+}
+function isActiveTaskStatus(status) {
+	return status === "queued" || status === "running";
+}
+function isTerminalFlowStatus(status) {
+	return status === "succeeded" || status === "failed" || status === "cancelled" || status === "lost";
+}
+function assertTaskOwner(params) {
+	if (!params.ownerKey.trim() && params.scopeKind !== "system") throw new Error("Task ownerKey is required.");
+}
+function assertParentFlowLinkAllowed(params) {
+	const flowId = params.parentFlowId?.trim();
+	if (!flowId) return;
+	if (params.scopeKind !== "session") throw new ParentFlowLinkError("scope_kind_not_session", "Only session-scoped tasks can link to flows.", { flowId });
+	const flow = getTaskFlowById(flowId);
+	if (!flow) throw new ParentFlowLinkError("parent_flow_not_found", `Parent flow not found: ${flowId}`, { flowId });
+	if (normalizeOptionalString(flow.ownerKey) !== normalizeOptionalString(params.ownerKey)) throw new ParentFlowLinkError("owner_key_mismatch", "Task ownerKey must match parent flow ownerKey.", { flowId });
+	if (flow.cancelRequestedAt != null) throw new ParentFlowLinkError("cancel_requested", "Parent flow cancellation has already been requested.", {
+		flowId,
+		status: flow.status
+	});
+	if (isTerminalFlowStatus(flow.status)) throw new ParentFlowLinkError("terminal", `Parent flow is already ${flow.status}.`, {
+		flowId,
+		status: flow.status
+	});
+}
+function cloneTaskRecord(record) {
+	return { ...record };
+}
+function cloneTaskDeliveryState(state) {
+	return {
+		...state,
+		...state.requesterOrigin ? { requesterOrigin: { ...state.requesterOrigin } } : {}
+	};
+}
+function snapshotTaskRecords(source) {
+	return [...source.values()].map((record) => cloneTaskRecord(record));
+}
+function emitTaskRegistryObserverEvent(createEvent) {
+	const observers = getTaskRegistryObservers();
+	if (!observers?.onEvent) return;
+	try {
+		observers.onEvent(createEvent());
+	} catch (error) {
+		log.warn("Task registry observer failed", {
+			event: "task-registry",
+			error
+		});
+	}
+}
+function persistTaskUpsert(task) {
+	const store = getTaskRegistryStore();
+	const deliveryState = taskDeliveryStates.get(task.taskId);
+	if (store.upsertTaskWithDeliveryState) {
+		store.upsertTaskWithDeliveryState({
+			task,
+			...deliveryState ? { deliveryState } : {}
+		});
+		return;
+	}
+	if (store.upsertTask) {
+		store.upsertTask(task);
+		return;
+	}
+	store.saveSnapshot({
+		tasks,
+		deliveryStates: taskDeliveryStates
+	});
+}
+function persistTaskDelete(taskId) {
+	const store = getTaskRegistryStore();
+	if (store.deleteTaskWithDeliveryState) {
+		store.deleteTaskWithDeliveryState(taskId);
+		return;
+	}
+	if (store.deleteTask) {
+		store.deleteTask(taskId);
+		return;
+	}
+	store.saveSnapshot({
+		tasks,
+		deliveryStates: taskDeliveryStates
+	});
+}
+function persistTaskDeliveryStateUpsert(state) {
+	const store = getTaskRegistryStore();
+	if (store.upsertDeliveryState) {
+		store.upsertDeliveryState(state);
+		return;
+	}
+	store.saveSnapshot({
+		tasks,
+		deliveryStates: taskDeliveryStates
+	});
+}
+function persistTaskDeliveryStateDelete(taskId) {
+	const store = getTaskRegistryStore();
+	if (store.deleteDeliveryState) {
+		store.deleteDeliveryState(taskId);
+		return;
+	}
+	store.saveSnapshot({
+		tasks,
+		deliveryStates: taskDeliveryStates
+	});
+}
+function ensureDeliveryStatus(params) {
+	if (params.scopeKind === "system") return "not_applicable";
+	return params.ownerKey.trim() ? "pending" : "parent_missing";
+}
+function ensureNotifyPolicy(params) {
+	if (params.notifyPolicy) return params.notifyPolicy;
+	return (params.deliveryStatus ?? ensureDeliveryStatus({
+		ownerKey: params.ownerKey,
+		scopeKind: params.scopeKind
+	})) === "not_applicable" ? "silent" : "done_only";
+}
+function resolveTaskScopeKind(params) {
+	if (params.scopeKind) return params.scopeKind;
+	return params.requesterSessionKey.trim() ? "session" : "system";
+}
+function resolveTaskRequesterSessionKey(params) {
+	const requesterSessionKey = params.requesterSessionKey?.trim();
+	if (requesterSessionKey) return requesterSessionKey;
+	if (params.scopeKind === "system") return "";
+	return params.ownerKey?.trim() ?? "";
+}
+function resolveTaskOwnerKey(params) {
+	return params.ownerKey?.trim() || params.requesterSessionKey.trim();
+}
+function normalizeTaskSummary(value) {
+	return value?.replace(/\s+/g, " ").trim() || void 0;
+}
+function normalizeTaskStatus(value) {
+	return value === "running" || value === "queued" || value === "succeeded" || value === "failed" || value === "timed_out" || value === "cancelled" || value === "lost" ? value : "queued";
+}
+function normalizeTaskTerminalOutcome(value) {
+	return value === "succeeded" || value === "blocked" ? value : void 0;
+}
+function resolveTaskTerminalOutcome(params) {
+	const normalized = normalizeTaskTerminalOutcome(params.terminalOutcome);
+	if (normalized) return normalized;
+	return params.status === "succeeded" ? "succeeded" : void 0;
+}
+function appendTaskEvent(event) {
+	const summary = normalizeTaskSummary(event.summary);
+	return {
+		at: event.at,
+		kind: event.kind,
+		...summary ? { summary } : {}
+	};
+}
+function loadTaskRegistryDeliveryRuntime() {
+	const deliveryRuntimeOverride = globalThis[TASK_REGISTRY_DELIVERY_RUNTIME_OVERRIDE_KEY];
+	if (deliveryRuntimeOverride) return Promise.resolve(deliveryRuntimeOverride);
+	deliveryRuntimePromise ??= import("./task-registry-delivery-runtime-D-Za0_P9.js");
+	return deliveryRuntimePromise;
+}
+function loadTaskRegistryControlRuntime() {
+	const controlRuntimeOverride = globalThis[TASK_REGISTRY_CONTROL_RUNTIME_OVERRIDE_KEY];
+	if (controlRuntimeOverride) return Promise.resolve(controlRuntimeOverride);
+	controlRuntimePromise ??= Promise.resolve().then(() => {
+		for (const candidate of TASK_REGISTRY_CONTROL_RUNTIME_CANDIDATES) try {
+			return require(candidate);
+		} catch {}
+		throw new Error("Failed to load task registry control runtime.");
+	});
+	return controlRuntimePromise;
+}
+function addRunIdIndex(taskId, runId) {
+	const trimmed = runId?.trim();
+	if (!trimmed) return;
+	let ids = taskIdsByRunId.get(trimmed);
+	if (!ids) {
+		ids = /* @__PURE__ */ new Set();
+		taskIdsByRunId.set(trimmed, ids);
+	}
+	ids.add(taskId);
+}
+function addIndexedKey(index, key, taskId) {
+	let ids = index.get(key);
+	if (!ids) {
+		ids = /* @__PURE__ */ new Set();
+		index.set(key, ids);
+	}
+	ids.add(taskId);
+}
+function deleteIndexedKey(index, key, taskId) {
+	const ids = index.get(key);
+	if (!ids) return;
+	ids.delete(taskId);
+	if (ids.size === 0) index.delete(key);
+}
+function getTaskRelatedSessionIndexKeys(task) {
+	return [...new Set([normalizeOptionalString(task.ownerKey), normalizeOptionalString(task.childSessionKey)].filter(Boolean))];
+}
+function addOwnerKeyIndex(taskId, task) {
+	const key = normalizeOptionalString(task.ownerKey);
+	if (!key) return;
+	addIndexedKey(taskIdsByOwnerKey, key, taskId);
+}
+function deleteOwnerKeyIndex(taskId, task) {
+	const key = normalizeOptionalString(task.ownerKey);
+	if (!key) return;
+	deleteIndexedKey(taskIdsByOwnerKey, key, taskId);
+}
+function addParentFlowIdIndex(taskId, task) {
+	const key = task.parentFlowId?.trim();
+	if (!key) return;
+	addIndexedKey(taskIdsByParentFlowId, key, taskId);
+}
+function deleteParentFlowIdIndex(taskId, task) {
+	const key = task.parentFlowId?.trim();
+	if (!key) return;
+	deleteIndexedKey(taskIdsByParentFlowId, key, taskId);
+}
+function addRelatedSessionKeyIndex(taskId, task) {
+	for (const sessionKey of getTaskRelatedSessionIndexKeys(task)) addIndexedKey(taskIdsByRelatedSessionKey, sessionKey, taskId);
+}
+function deleteRelatedSessionKeyIndex(taskId, task) {
+	for (const sessionKey of getTaskRelatedSessionIndexKeys(task)) deleteIndexedKey(taskIdsByRelatedSessionKey, sessionKey, taskId);
+}
+function rebuildRunIdIndex() {
+	taskIdsByRunId.clear();
+	for (const [taskId, task] of tasks.entries()) addRunIdIndex(taskId, task.runId);
+}
+function rebuildOwnerKeyIndex() {
+	taskIdsByOwnerKey.clear();
+	for (const [taskId, task] of tasks.entries()) addOwnerKeyIndex(taskId, task);
+}
+function rebuildParentFlowIdIndex() {
+	taskIdsByParentFlowId.clear();
+	for (const [taskId, task] of tasks.entries()) addParentFlowIdIndex(taskId, task);
+}
+function rebuildRelatedSessionKeyIndex() {
+	taskIdsByRelatedSessionKey.clear();
+	for (const [taskId, task] of tasks.entries()) addRelatedSessionKeyIndex(taskId, task);
+}
+function getTasksByRunId(runId) {
+	const ids = taskIdsByRunId.get(runId.trim());
+	if (!ids || ids.size === 0) return [];
+	return [...ids].map((taskId) => tasks.get(taskId)).filter((task) => Boolean(task));
+}
+function taskRunScopeKey(task) {
+	return [
+		task.runtime,
+		task.scopeKind,
+		normalizeOptionalString(task.ownerKey) ?? "",
+		normalizeOptionalString(task.childSessionKey) ?? ""
+	].join("\0");
+}
+function getTasksByRunScope(params) {
+	const matches = getTasksByRunId(params.runId).filter((task) => !params.runtime || task.runtime === params.runtime);
+	const sessionKey = normalizeOptionalString(params.sessionKey);
+	if (sessionKey) {
+		const childMatches = matches.filter((task) => normalizeOptionalString(task.childSessionKey) === sessionKey);
+		if (childMatches.length > 0) return childMatches;
+		return matches.filter((task) => task.scopeKind === "session" && normalizeOptionalString(task.ownerKey) === sessionKey);
+	}
+	return new Set(matches.map((task) => taskRunScopeKey(task))).size <= 1 ? matches : [];
+}
+function getPeerTasksForDelivery(task) {
+	if (!task.runId?.trim()) return [];
+	return getTasksByRunId(task.runId).filter((candidate) => candidate.runtime === task.runtime && candidate.scopeKind === task.scopeKind && (normalizeOptionalString(candidate.ownerKey) ?? "") === (normalizeOptionalString(task.ownerKey) ?? "") && (normalizeOptionalString(candidate.childSessionKey) ?? "") === (normalizeOptionalString(task.childSessionKey) ?? ""));
+}
+function taskLookupPriority(task) {
+	return task.runtime === "cli" ? 1 : 0;
+}
+function pickPreferredRunIdTask(matches) {
+	return [...matches].toSorted((left, right) => {
+		const priorityDiff = taskLookupPriority(left) - taskLookupPriority(right);
+		if (priorityDiff !== 0) return priorityDiff;
+		return left.createdAt - right.createdAt;
+	})[0];
+}
+function compareTasksNewestFirst(left, right) {
+	const createdAtDiff = right.createdAt - left.createdAt;
+	if (createdAtDiff !== 0) return createdAtDiff;
+	return (right.insertionIndex ?? 0) - (left.insertionIndex ?? 0);
+}
+function findExistingTaskForCreate(params) {
+	const runId = params.runId?.trim();
+	const runScopeMatches = runId ? getTasksByRunId(runId).filter((task) => task.runtime === params.runtime && task.scopeKind === params.scopeKind && (normalizeOptionalString(task.ownerKey) ?? "") === (normalizeOptionalString(params.ownerKey) ?? "") && (normalizeOptionalString(task.childSessionKey) ?? "") === (normalizeOptionalString(params.childSessionKey) ?? "") && (normalizeOptionalString(task.parentFlowId) ?? "") === (normalizeOptionalString(params.parentFlowId) ?? "")) : [];
+	const exact = runId ? runScopeMatches.find((task) => (normalizeOptionalString(task.label) ?? "") === (normalizeOptionalString(params.label) ?? "") && (normalizeOptionalString(task.task) ?? "") === (normalizeOptionalString(params.task) ?? "")) : void 0;
+	if (exact) return exact;
+	if (!runId || params.runtime !== "acp") return;
+	if (runScopeMatches.length === 0) return;
+	return pickPreferredRunIdTask(runScopeMatches);
+}
+function mergeExistingTaskForCreate(existing, params) {
+	const patch = {};
+	const requesterOrigin = normalizeDeliveryContext(params.requesterOrigin);
+	const currentDeliveryState = taskDeliveryStates.get(existing.taskId);
+	if (requesterOrigin && !currentDeliveryState?.requesterOrigin) upsertTaskDeliveryState({
+		taskId: existing.taskId,
+		requesterOrigin,
+		lastNotifiedEventAt: currentDeliveryState?.lastNotifiedEventAt
+	});
+	if (params.sourceId?.trim() && !existing.sourceId?.trim()) patch.sourceId = params.sourceId.trim();
+	if (params.taskKind?.trim() && !existing.taskKind?.trim()) patch.taskKind = params.taskKind.trim();
+	if (params.parentFlowId?.trim() && !existing.parentFlowId?.trim()) {
+		assertParentFlowLinkAllowed({
+			ownerKey: existing.ownerKey,
+			scopeKind: existing.scopeKind,
+			parentFlowId: params.parentFlowId
+		});
+		patch.parentFlowId = params.parentFlowId.trim();
+	}
+	if (params.parentTaskId?.trim() && !existing.parentTaskId?.trim()) patch.parentTaskId = params.parentTaskId.trim();
+	if (params.agentId?.trim() && !existing.agentId?.trim()) patch.agentId = params.agentId.trim();
+	const nextLabel = params.label?.trim();
+	if (params.preferMetadata) {
+		if (nextLabel && (normalizeOptionalString(existing.label) ?? "") !== nextLabel) patch.label = nextLabel;
+		const nextTask = params.task.trim();
+		if (nextTask && (normalizeOptionalString(existing.task) ?? "") !== nextTask) patch.task = nextTask;
+	} else if (nextLabel && !existing.label?.trim()) patch.label = nextLabel;
+	if (params.deliveryStatus === "pending" && existing.deliveryStatus !== "delivered") patch.deliveryStatus = "pending";
+	const notifyPolicy = ensureNotifyPolicy({
+		notifyPolicy: params.notifyPolicy,
+		deliveryStatus: params.deliveryStatus,
+		ownerKey: existing.ownerKey,
+		scopeKind: existing.scopeKind
+	});
+	if (notifyPolicy !== existing.notifyPolicy && existing.notifyPolicy === "silent") patch.notifyPolicy = notifyPolicy;
+	if (Object.keys(patch).length === 0) return cloneTaskRecord(existing);
+	return updateTask(existing.taskId, patch) ?? cloneTaskRecord(existing);
+}
+function taskTerminalDeliveryIdempotencyKey(task) {
+	const outcome = task.status === "succeeded" ? task.terminalOutcome ?? "default" : "default";
+	return `task-terminal:${task.taskId}:${task.status}:${outcome}`;
+}
+function resolveTaskStateChangeIdempotencyKey(params) {
+	if (params.owner.flowId) return `flow-event:${params.owner.flowId}:${params.task.taskId}:${params.latestEvent.at}:${params.latestEvent.kind}`;
+	return `task-event:${params.task.taskId}:${params.latestEvent.at}:${params.latestEvent.kind}`;
+}
+function resolveTaskTerminalIdempotencyKey(task) {
+	const owner = resolveTaskDeliveryOwner(task);
+	if (owner.flowId) {
+		const outcome = task.status === "succeeded" ? task.terminalOutcome ?? "default" : "default";
+		return `flow-terminal:${owner.flowId}:${task.taskId}:${task.status}:${outcome}`;
+	}
+	return taskTerminalDeliveryIdempotencyKey(task);
+}
+function getLinkedFlowForDelivery(task) {
+	const flowId = task.parentFlowId?.trim();
+	if (!flowId || task.scopeKind !== "session") return;
+	const flow = getTaskFlowById(flowId);
+	if (!flow) return;
+	if (normalizeOptionalString(flow.ownerKey) !== normalizeOptionalString(task.ownerKey)) return;
+	return flow;
+}
+function resolveTaskDeliveryOwner(task) {
+	const flow = getLinkedFlowForDelivery(task);
+	if (flow) return {
+		sessionKey: flow.ownerKey.trim(),
+		requesterOrigin: normalizeDeliveryContext(flow.requesterOrigin ?? taskDeliveryStates.get(task.taskId)?.requesterOrigin),
+		flowId: flow.flowId
+	};
+	if (task.scopeKind !== "session") return {};
+	return {
+		sessionKey: task.ownerKey.trim(),
+		requesterOrigin: normalizeDeliveryContext(taskDeliveryStates.get(task.taskId)?.requesterOrigin)
+	};
+}
+function syncManagedFlowCancellationFromTask(task) {
+	const flowId = task.parentFlowId?.trim();
+	if (!flowId) return;
+	let flow = getTaskFlowById(flowId);
+	if (!flow || flow.syncMode !== "managed" || flow.cancelRequestedAt == null || isTerminalFlowStatus(flow.status)) return;
+	if (listTasksForFlowId(flowId).some((candidate) => isActiveTaskStatus(candidate.status))) return;
+	const endedAt = task.endedAt ?? task.lastEventAt ?? Date.now();
+	for (let attempt = 0; attempt < 2; attempt += 1) {
+		const result = updateFlowRecordByIdExpectedRevision({
+			flowId,
+			expectedRevision: flow.revision,
+			patch: {
+				status: "cancelled",
+				blockedTaskId: null,
+				blockedSummary: null,
+				waitJson: null,
+				endedAt,
+				updatedAt: endedAt
+			}
+		});
+		if (result.applied || result.reason === "not_found") return;
+		flow = result.current;
+		if (!flow || flow.syncMode !== "managed" || flow.cancelRequestedAt == null || isTerminalFlowStatus(flow.status)) return;
+		if (listTasksForFlowId(flowId).some((candidate) => isActiveTaskStatus(candidate.status))) return;
+	}
+}
+function restoreTaskRegistryOnce() {
+	if (restoreAttempted) return;
+	restoreAttempted = true;
+	try {
+		const restored = getTaskRegistryStore().loadSnapshot();
+		if (restored.tasks.size === 0 && restored.deliveryStates.size === 0) return;
+		for (const [taskId, task] of restored.tasks.entries()) tasks.set(taskId, task);
+		for (const [taskId, state] of restored.deliveryStates.entries()) taskDeliveryStates.set(taskId, state);
+		rebuildRunIdIndex();
+		rebuildOwnerKeyIndex();
+		rebuildParentFlowIdIndex();
+		rebuildRelatedSessionKeyIndex();
+		emitTaskRegistryObserverEvent(() => ({
+			kind: "restored",
+			tasks: snapshotTaskRecords(tasks)
+		}));
+	} catch (error) {
+		log.warn("Failed to restore task registry", { error });
+	}
+}
+function ensureTaskRegistryReady() {
+	restoreTaskRegistryOnce();
+	ensureListener();
+}
+function updateTask(taskId, patch) {
+	const current = tasks.get(taskId);
+	if (!current) return null;
+	const next = {
+		...current,
+		...patch
+	};
+	if (isTerminalTaskStatus(next.status) && typeof next.cleanupAfter !== "number") next.cleanupAfter = (next.endedAt ?? next.lastEventAt ?? Date.now()) + DEFAULT_TASK_RETENTION_MS;
+	const sessionIndexChanged = normalizeOptionalString(current.ownerKey) !== normalizeOptionalString(next.ownerKey) || normalizeOptionalString(current.childSessionKey) !== normalizeOptionalString(next.childSessionKey);
+	const parentFlowIndexChanged = current.parentFlowId?.trim() !== next.parentFlowId?.trim();
+	tasks.set(taskId, next);
+	if (patch.runId && patch.runId !== current.runId) rebuildRunIdIndex();
+	if (sessionIndexChanged) {
+		deleteOwnerKeyIndex(taskId, current);
+		addOwnerKeyIndex(taskId, next);
+		deleteRelatedSessionKeyIndex(taskId, current);
+		addRelatedSessionKeyIndex(taskId, next);
+	}
+	if (parentFlowIndexChanged) {
+		deleteParentFlowIdIndex(taskId, current);
+		addParentFlowIdIndex(taskId, next);
+	}
+	persistTaskUpsert(next);
+	try {
+		syncFlowFromTask(next);
+	} catch (error) {
+		log.warn("Failed to sync parent flow from task update", {
+			taskId,
+			flowId: next.parentFlowId,
+			error
+		});
+	}
+	try {
+		syncManagedFlowCancellationFromTask(next);
+	} catch (error) {
+		log.warn("Failed to finalize managed flow cancellation from task update", {
+			taskId,
+			flowId: next.parentFlowId,
+			error
+		});
+	}
+	emitTaskRegistryObserverEvent(() => ({
+		kind: "upserted",
+		task: cloneTaskRecord(next),
+		previous: cloneTaskRecord(current)
+	}));
+	return cloneTaskRecord(next);
+}
+function upsertTaskDeliveryState(state) {
+	const current = taskDeliveryStates.get(state.taskId);
+	const next = {
+		taskId: state.taskId,
+		...state.requesterOrigin ? { requesterOrigin: normalizeDeliveryContext(state.requesterOrigin) } : {},
+		...state.lastNotifiedEventAt != null ? { lastNotifiedEventAt: state.lastNotifiedEventAt } : {}
+	};
+	if (!next.requesterOrigin && typeof next.lastNotifiedEventAt !== "number" && !current) return cloneTaskDeliveryState({ taskId: state.taskId });
+	taskDeliveryStates.set(state.taskId, next);
+	persistTaskDeliveryStateUpsert(next);
+	return cloneTaskDeliveryState(next);
+}
+function getTaskDeliveryState(taskId) {
+	const state = taskDeliveryStates.get(taskId);
+	return state ? cloneTaskDeliveryState(state) : void 0;
+}
+function canDeliverTaskToRequesterOrigin(task) {
+	const origin = resolveTaskDeliveryOwner(task).requesterOrigin;
+	const channel = origin?.channel?.trim();
+	const to = origin?.to?.trim();
+	return Boolean(channel && to && isDeliverableMessageChannel(channel));
+}
+function resolveMissingOwnerDeliveryStatus(task) {
+	return task.scopeKind === "system" ? "not_applicable" : "parent_missing";
+}
+function queueTaskSystemEvent(task, text) {
+	const owner = resolveTaskDeliveryOwner(task);
+	const ownerKey = owner.sessionKey?.trim();
+	if (!ownerKey) return false;
+	enqueueSystemEvent(text, {
+		sessionKey: ownerKey,
+		contextKey: `task:${task.taskId}`,
+		deliveryContext: owner.requesterOrigin
+	});
+	requestHeartbeatNow({
+		reason: "background-task",
+		sessionKey: ownerKey
+	});
+	return true;
+}
+function queueBlockedTaskFollowup(task) {
+	const followupText = formatTaskBlockedFollowupMessage(task);
+	if (!followupText) return false;
+	const owner = resolveTaskDeliveryOwner(task);
+	const ownerKey = owner.sessionKey?.trim();
+	if (!ownerKey) return false;
+	enqueueSystemEvent(followupText, {
+		sessionKey: ownerKey,
+		contextKey: `task:${task.taskId}:blocked-followup`,
+		deliveryContext: owner.requesterOrigin
+	});
+	requestHeartbeatNow({
+		reason: "background-task-blocked",
+		sessionKey: ownerKey
+	});
+	return true;
+}
+async function maybeDeliverTaskTerminalUpdate(taskId) {
+	ensureTaskRegistryReady();
+	const current = tasks.get(taskId);
+	if (!current || !shouldAutoDeliverTaskTerminalUpdate(current)) return current ? cloneTaskRecord(current) : null;
+	if (tasksWithPendingDelivery.has(taskId)) return cloneTaskRecord(current);
+	tasksWithPendingDelivery.add(taskId);
+	try {
+		const latest = tasks.get(taskId);
+		if (!latest || !shouldAutoDeliverTaskTerminalUpdate(latest)) return latest ? cloneTaskRecord(latest) : null;
+		if (shouldSuppressDuplicateTerminalDelivery({
+			task: latest,
+			preferredTaskId: (latest.runId ? pickPreferredRunIdTask(getPeerTasksForDelivery(latest)) : void 0)?.taskId
+		})) return updateTask(taskId, {
+			deliveryStatus: "not_applicable",
+			lastEventAt: Date.now()
+		});
+		const owner = resolveTaskDeliveryOwner(latest);
+		const ownerSessionKey = owner.sessionKey?.trim();
+		if (!ownerSessionKey) return updateTask(taskId, {
+			deliveryStatus: resolveMissingOwnerDeliveryStatus(latest),
+			lastEventAt: Date.now()
+		});
+		const eventText = formatTaskTerminalMessage(latest);
+		if (!canDeliverTaskToRequesterOrigin(latest)) try {
+			queueTaskSystemEvent(latest, eventText);
+			if (latest.terminalOutcome === "blocked") queueBlockedTaskFollowup(latest);
+			return updateTask(taskId, {
+				deliveryStatus: "session_queued",
+				lastEventAt: Date.now()
+			});
+		} catch (error) {
+			log.warn("Failed to queue background task session delivery", {
+				taskId,
+				ownerKey: latest.ownerKey,
+				error
+			});
+			return updateTask(taskId, {
+				deliveryStatus: "failed",
+				lastEventAt: Date.now()
+			});
+		}
+		try {
+			const { sendMessage } = await loadTaskRegistryDeliveryRuntime();
+			const requesterAgentId = parseAgentSessionKey(ownerSessionKey)?.agentId;
+			const idempotencyKey = resolveTaskTerminalIdempotencyKey(latest);
+			await sendMessage({
+				channel: owner.requesterOrigin?.channel,
+				to: owner.requesterOrigin?.to ?? "",
+				accountId: owner.requesterOrigin?.accountId,
+				threadId: owner.requesterOrigin?.threadId,
+				content: eventText,
+				agentId: requesterAgentId,
+				idempotencyKey,
+				mirror: {
+					sessionKey: ownerSessionKey,
+					agentId: requesterAgentId,
+					idempotencyKey
+				}
+			});
+			if (latest.terminalOutcome === "blocked") queueBlockedTaskFollowup(latest);
+			return updateTask(taskId, {
+				deliveryStatus: "delivered",
+				lastEventAt: Date.now()
+			});
+		} catch (error) {
+			log.warn("Failed to deliver background task update", {
+				taskId,
+				ownerKey: ownerSessionKey,
+				requesterOrigin: owner.requesterOrigin,
+				error
+			});
+			try {
+				queueTaskSystemEvent(latest, eventText);
+				if (latest.terminalOutcome === "blocked") queueBlockedTaskFollowup(latest);
+			} catch (fallbackError) {
+				log.warn("Failed to queue background task fallback event", {
+					taskId,
+					ownerKey: latest.ownerKey,
+					error: fallbackError
+				});
+			}
+			return updateTask(taskId, {
+				deliveryStatus: "failed",
+				lastEventAt: Date.now()
+			});
+		}
+	} finally {
+		tasksWithPendingDelivery.delete(taskId);
+	}
+}
+async function maybeDeliverTaskStateChangeUpdate(taskId, latestEvent) {
+	ensureTaskRegistryReady();
+	const current = tasks.get(taskId);
+	if (!current || !shouldAutoDeliverTaskStateChange(current)) return current ? cloneTaskRecord(current) : null;
+	const deliveryState = getTaskDeliveryState(taskId);
+	if (!latestEvent || (deliveryState?.lastNotifiedEventAt ?? 0) >= latestEvent.at) return cloneTaskRecord(current);
+	const eventText = formatTaskStateChangeMessage(current, latestEvent);
+	if (!eventText) return cloneTaskRecord(current);
+	try {
+		const owner = resolveTaskDeliveryOwner(current);
+		const ownerSessionKey = owner.sessionKey?.trim();
+		if (!ownerSessionKey) return updateTask(taskId, {
+			deliveryStatus: resolveMissingOwnerDeliveryStatus(current),
+			lastEventAt: Date.now()
+		});
+		if (!canDeliverTaskToRequesterOrigin(current)) {
+			queueTaskSystemEvent(current, eventText);
+			upsertTaskDeliveryState({
+				taskId,
+				requesterOrigin: deliveryState?.requesterOrigin,
+				lastNotifiedEventAt: latestEvent.at
+			});
+			return updateTask(taskId, { lastEventAt: Date.now() });
+		}
+		const { sendMessage } = await loadTaskRegistryDeliveryRuntime();
+		const requesterAgentId = parseAgentSessionKey(ownerSessionKey)?.agentId;
+		const idempotencyKey = resolveTaskStateChangeIdempotencyKey({
+			task: current,
+			latestEvent,
+			owner
+		});
+		await sendMessage({
+			channel: owner.requesterOrigin?.channel,
+			to: owner.requesterOrigin?.to ?? "",
+			accountId: owner.requesterOrigin?.accountId,
+			threadId: owner.requesterOrigin?.threadId,
+			content: eventText,
+			agentId: requesterAgentId,
+			idempotencyKey,
+			mirror: {
+				sessionKey: ownerSessionKey,
+				agentId: requesterAgentId,
+				idempotencyKey
+			}
+		});
+		upsertTaskDeliveryState({
+			taskId,
+			requesterOrigin: deliveryState?.requesterOrigin,
+			lastNotifiedEventAt: latestEvent.at
+		});
+		return updateTask(taskId, { lastEventAt: Date.now() });
+	} catch (error) {
+		log.warn("Failed to deliver background task state change", {
+			taskId,
+			ownerKey: current.ownerKey,
+			error
+		});
+		return cloneTaskRecord(current);
+	}
+}
+function setTaskCleanupAfterById(params) {
+	ensureTaskRegistryReady();
+	return updateTask(params.taskId, { cleanupAfter: params.cleanupAfter });
+}
+function markTaskTerminalById(params) {
+	ensureTaskRegistryReady();
+	return updateTask(params.taskId, {
+		status: params.status,
+		endedAt: params.endedAt,
+		lastEventAt: params.lastEventAt ?? params.endedAt,
+		...params.error !== void 0 ? { error: params.error } : {},
+		...params.terminalSummary !== void 0 ? { terminalSummary: normalizeTaskSummary(params.terminalSummary) } : {},
+		...params.terminalOutcome !== void 0 ? { terminalOutcome: resolveTaskTerminalOutcome({
+			status: params.status,
+			terminalOutcome: params.terminalOutcome
+		}) } : {}
+	});
+}
+function markTaskLostById(params) {
+	ensureTaskRegistryReady();
+	return updateTask(params.taskId, {
+		status: "lost",
+		endedAt: params.endedAt,
+		lastEventAt: params.lastEventAt ?? params.endedAt,
+		...params.error !== void 0 ? { error: params.error } : {},
+		...params.cleanupAfter !== void 0 ? { cleanupAfter: params.cleanupAfter } : {}
+	});
+}
+function updateTasksByRunId(params) {
+	const matches = getTasksByRunScope(params);
+	if (matches.length === 0) return [];
+	const updated = [];
+	for (const match of matches) {
+		const task = updateTask(match.taskId, params.patch);
+		if (task) updated.push(task);
+	}
+	return updated;
+}
+function ensureListener() {
+	if (listenerStarted) return;
+	listenerStarted = true;
+	onAgentEvent((evt) => {
+		restoreTaskRegistryOnce();
+		const scopedTasks = getTasksByRunScope({
+			runId: evt.runId,
+			sessionKey: evt.sessionKey
+		});
+		if (scopedTasks.length === 0) return;
+		const now = evt.ts || Date.now();
+		for (const current of scopedTasks) {
+			if (isTerminalTaskStatus(current.status)) continue;
+			const patch = { lastEventAt: now };
+			if (evt.stream === "lifecycle") {
+				const phase = typeof evt.data?.phase === "string" ? evt.data.phase : void 0;
+				const startedAt = typeof evt.data?.startedAt === "number" ? evt.data.startedAt : current.startedAt;
+				const endedAt = typeof evt.data?.endedAt === "number" ? evt.data.endedAt : void 0;
+				if (startedAt) patch.startedAt = startedAt;
+				if (phase === "start") patch.status = "running";
+				else if (phase === "end") {
+					patch.status = evt.data?.aborted === true ? "timed_out" : "succeeded";
+					patch.endedAt = endedAt ?? now;
+				} else if (phase === "error") {
+					patch.status = "failed";
+					patch.endedAt = endedAt ?? now;
+					patch.error = typeof evt.data?.error === "string" ? evt.data.error : current.error;
+				}
+			} else if (evt.stream === "error") patch.error = typeof evt.data?.error === "string" ? evt.data.error : current.error;
+			const stateChangeEvent = patch.status && patch.status !== current.status ? appendTaskEvent({
+				at: now,
+				kind: patch.status,
+				summary: patch.status === "failed" ? patch.error ?? current.error : patch.status === "succeeded" ? current.terminalSummary : void 0
+			}) : void 0;
+			if (updateTask(current.taskId, patch)) {
+				maybeDeliverTaskStateChangeUpdate(current.taskId, stateChangeEvent);
+				maybeDeliverTaskTerminalUpdate(current.taskId);
+			}
+		}
+	});
+}
+function createTaskRecord(params) {
+	ensureTaskRegistryReady();
+	const requesterSessionKey = resolveTaskRequesterSessionKey(params);
+	const scopeKind = resolveTaskScopeKind({
+		scopeKind: params.scopeKind,
+		requesterSessionKey
+	});
+	const ownerKey = resolveTaskOwnerKey({
+		requesterSessionKey,
+		ownerKey: params.ownerKey
+	});
+	assertTaskOwner({
+		ownerKey,
+		scopeKind
+	});
+	assertParentFlowLinkAllowed({
+		ownerKey,
+		scopeKind,
+		parentFlowId: params.parentFlowId
+	});
+	const existing = findExistingTaskForCreate({
+		runtime: params.runtime,
+		ownerKey,
+		scopeKind,
+		childSessionKey: params.childSessionKey,
+		parentFlowId: params.parentFlowId,
+		runId: params.runId,
+		label: params.label,
+		task: params.task
+	});
+	if (existing) return mergeExistingTaskForCreate(existing, params);
+	const now = Date.now();
+	const taskId = crypto.randomUUID();
+	const status = normalizeTaskStatus(params.status);
+	const deliveryStatus = params.deliveryStatus ?? ensureDeliveryStatus({
+		ownerKey,
+		scopeKind
+	});
+	const notifyPolicy = ensureNotifyPolicy({
+		notifyPolicy: params.notifyPolicy,
+		deliveryStatus,
+		ownerKey,
+		scopeKind
+	});
+	const lastEventAt = params.lastEventAt ?? params.startedAt ?? now;
+	const record = {
+		taskId,
+		runtime: params.runtime,
+		taskKind: normalizeOptionalString(params.taskKind),
+		sourceId: normalizeOptionalString(params.sourceId),
+		requesterSessionKey,
+		ownerKey,
+		scopeKind,
+		childSessionKey: params.childSessionKey,
+		parentFlowId: normalizeOptionalString(params.parentFlowId),
+		parentTaskId: normalizeOptionalString(params.parentTaskId),
+		agentId: normalizeOptionalString(params.agentId),
+		runId: normalizeOptionalString(params.runId),
+		label: normalizeOptionalString(params.label),
+		task: params.task,
+		status,
+		deliveryStatus,
+		notifyPolicy,
+		createdAt: now,
+		startedAt: params.startedAt,
+		lastEventAt,
+		cleanupAfter: params.cleanupAfter,
+		progressSummary: normalizeTaskSummary(params.progressSummary),
+		terminalSummary: normalizeTaskSummary(params.terminalSummary),
+		terminalOutcome: resolveTaskTerminalOutcome({
+			status,
+			terminalOutcome: params.terminalOutcome
+		})
+	};
+	if (isTerminalTaskStatus(record.status) && typeof record.cleanupAfter !== "number") record.cleanupAfter = (record.endedAt ?? record.lastEventAt ?? record.createdAt) + DEFAULT_TASK_RETENTION_MS;
+	tasks.set(taskId, record);
+	upsertTaskDeliveryState({
+		taskId,
+		requesterOrigin: normalizeDeliveryContext(params.requesterOrigin)
+	});
+	addRunIdIndex(taskId, record.runId);
+	addOwnerKeyIndex(taskId, record);
+	addParentFlowIdIndex(taskId, record);
+	addRelatedSessionKeyIndex(taskId, record);
+	persistTaskUpsert(record);
+	try {
+		syncFlowFromTask(record);
+	} catch (error) {
+		log.warn("Failed to sync parent flow from task create", {
+			taskId: record.taskId,
+			flowId: record.parentFlowId,
+			error
+		});
+	}
+	emitTaskRegistryObserverEvent(() => ({
+		kind: "upserted",
+		task: cloneTaskRecord(record)
+	}));
+	if (isTerminalTaskStatus(record.status)) maybeDeliverTaskTerminalUpdate(taskId);
+	return cloneTaskRecord(record);
+}
+function updateTaskStateByRunId(params) {
+	ensureTaskRegistryReady();
+	const matches = getTasksByRunScope(params);
+	if (matches.length === 0) return [];
+	const updated = [];
+	for (const current of matches) {
+		const patch = {};
+		const nextStatus = params.status ? normalizeTaskStatus(params.status) : current.status;
+		const eventAt = params.lastEventAt ?? params.endedAt ?? Date.now();
+		if (params.status) patch.status = normalizeTaskStatus(params.status);
+		if (params.startedAt != null) patch.startedAt = params.startedAt;
+		if (params.endedAt != null) patch.endedAt = params.endedAt;
+		if (params.lastEventAt != null) patch.lastEventAt = params.lastEventAt;
+		if (params.error !== void 0) patch.error = params.error;
+		if (params.progressSummary !== void 0) patch.progressSummary = normalizeTaskSummary(params.progressSummary);
+		if (params.terminalSummary !== void 0) patch.terminalSummary = normalizeTaskSummary(params.terminalSummary);
+		if (params.terminalOutcome !== void 0) patch.terminalOutcome = resolveTaskTerminalOutcome({
+			status: nextStatus,
+			terminalOutcome: params.terminalOutcome
+		});
+		const eventSummary = normalizeTaskSummary(params.eventSummary) ?? (nextStatus === "failed" ? normalizeTaskSummary(params.error ?? current.error) : nextStatus === "succeeded" ? normalizeTaskSummary(params.terminalSummary ?? current.terminalSummary) : void 0);
+		const nextEvent = params.status && params.status !== current.status || Boolean(normalizeTaskSummary(params.eventSummary)) ? appendTaskEvent({
+			at: eventAt,
+			kind: params.status && normalizeTaskStatus(params.status) !== current.status ? normalizeTaskStatus(params.status) : "progress",
+			summary: eventSummary
+		}) : void 0;
+		const task = updateTask(current.taskId, patch);
+		if (task) {
+			updated.push(task);
+			maybeDeliverTaskStateChangeUpdate(task.taskId, nextEvent);
+			maybeDeliverTaskTerminalUpdate(task.taskId);
+		}
+	}
+	return updated;
+}
+function updateTaskDeliveryByRunId(params) {
+	ensureTaskRegistryReady();
+	return updateTasksByRunId({
+		runId: params.runId,
+		runtime: params.runtime,
+		sessionKey: params.sessionKey,
+		patch: { deliveryStatus: params.deliveryStatus }
+	});
+}
+function markTaskRunningByRunId(params) {
+	return updateTaskStateByRunId({
+		runId: params.runId,
+		runtime: params.runtime,
+		sessionKey: params.sessionKey,
+		status: "running",
+		startedAt: params.startedAt,
+		lastEventAt: params.lastEventAt,
+		progressSummary: params.progressSummary,
+		eventSummary: params.eventSummary
+	});
+}
+function recordTaskProgressByRunId(params) {
+	return updateTaskStateByRunId({
+		runId: params.runId,
+		runtime: params.runtime,
+		sessionKey: params.sessionKey,
+		lastEventAt: params.lastEventAt,
+		progressSummary: params.progressSummary,
+		eventSummary: params.eventSummary
+	});
+}
+function markTaskTerminalByRunId(params) {
+	return updateTaskStateByRunId({
+		runId: params.runId,
+		runtime: params.runtime,
+		sessionKey: params.sessionKey,
+		status: params.status,
+		startedAt: params.startedAt,
+		endedAt: params.endedAt,
+		lastEventAt: params.lastEventAt,
+		error: params.error,
+		progressSummary: params.progressSummary,
+		terminalSummary: params.terminalSummary,
+		terminalOutcome: params.terminalOutcome
+	});
+}
+function setTaskRunDeliveryStatusByRunId(params) {
+	return updateTaskDeliveryByRunId(params);
+}
+function updateTaskNotifyPolicyById(params) {
+	ensureTaskRegistryReady();
+	return updateTask(params.taskId, {
+		notifyPolicy: params.notifyPolicy,
+		lastEventAt: Date.now()
+	});
+}
+function linkTaskToFlowById(params) {
+	ensureTaskRegistryReady();
+	const flowId = params.flowId.trim();
+	if (!flowId) return null;
+	const current = tasks.get(params.taskId);
+	if (!current) return null;
+	if (current.parentFlowId?.trim()) return cloneTaskRecord(current);
+	assertParentFlowLinkAllowed({
+		ownerKey: current.ownerKey,
+		scopeKind: current.scopeKind,
+		parentFlowId: flowId
+	});
+	return updateTask(params.taskId, { parentFlowId: flowId });
+}
+async function cancelTaskById(params) {
+	ensureTaskRegistryReady();
+	const task = tasks.get(params.taskId.trim());
+	if (!task) return {
+		found: false,
+		cancelled: false,
+		reason: "Task not found."
+	};
+	if (task.status === "succeeded" || task.status === "failed" || task.status === "timed_out" || task.status === "lost" || task.status === "cancelled") return {
+		found: true,
+		cancelled: false,
+		reason: "Task is already terminal.",
+		task: cloneTaskRecord(task)
+	};
+	const childSessionKey = task.childSessionKey?.trim();
+	try {
+		if (task.runtime !== "cli") {
+			if (!childSessionKey) return {
+				found: true,
+				cancelled: false,
+				reason: "Task has no cancellable child session.",
+				task: cloneTaskRecord(task)
+			};
+			if (task.runtime === "acp") {
+				const { getAcpSessionManager } = await loadTaskRegistryControlRuntime();
+				await getAcpSessionManager().cancelSession({
+					cfg: params.cfg,
+					sessionKey: childSessionKey,
+					reason: "task-cancel"
+				});
+			} else if (task.runtime === "subagent") {
+				const { killSubagentRunAdmin } = await loadTaskRegistryControlRuntime();
+				const result = await killSubagentRunAdmin({
+					cfg: params.cfg,
+					sessionKey: childSessionKey
+				});
+				if (!result.found || !result.killed) return {
+					found: true,
+					cancelled: false,
+					reason: result.found ? "Subagent was not running." : "Subagent task not found.",
+					task: cloneTaskRecord(task)
+				};
+			} else return {
+				found: true,
+				cancelled: false,
+				reason: "Task runtime does not support cancellation yet.",
+				task: cloneTaskRecord(task)
+			};
+		}
+		const updated = updateTask(task.taskId, {
+			status: "cancelled",
+			endedAt: Date.now(),
+			lastEventAt: Date.now(),
+			error: "Cancelled by operator."
+		});
+		if (updated) maybeDeliverTaskTerminalUpdate(updated.taskId);
+		return {
+			found: true,
+			cancelled: true,
+			task: updated ?? cloneTaskRecord(task)
+		};
+	} catch (error) {
+		return {
+			found: true,
+			cancelled: false,
+			reason: formatErrorMessage(error),
+			task: cloneTaskRecord(task)
+		};
+	}
+}
+function listTaskRecords() {
+	ensureTaskRegistryReady();
+	return [...tasks.values()].map((task, insertionIndex) => Object.assign({}, cloneTaskRecord(task), { insertionIndex })).toSorted(compareTasksNewestFirst).map(({ insertionIndex: _, ...task }) => task);
+}
+function getTaskById(taskId) {
+	ensureTaskRegistryReady();
+	const task = tasks.get(taskId.trim());
+	return task ? cloneTaskRecord(task) : void 0;
+}
+function findTaskByRunId(runId) {
+	ensureTaskRegistryReady();
+	const task = pickPreferredRunIdTask(getTasksByRunId(runId));
+	return task ? cloneTaskRecord(task) : void 0;
+}
+function listTasksFromIndex(index, key) {
+	const ids = index.get(key);
+	if (!ids || ids.size === 0) return [];
+	return [...ids].map((taskId, insertionIndex) => {
+		const task = tasks.get(taskId);
+		return task ? Object.assign({}, cloneTaskRecord(task), { insertionIndex }) : null;
+	}).filter((task) => Boolean(task)).toSorted(compareTasksNewestFirst).map(({ insertionIndex: _, ...task }) => task);
+}
+function listTasksForSessionKey(sessionKey) {
+	ensureTaskRegistryReady();
+	const key = normalizeOptionalString(sessionKey);
+	if (!key) return [];
+	return listTasksFromIndex(taskIdsByRelatedSessionKey, key);
+}
+function listTasksForAgentId(agentId) {
+	ensureTaskRegistryReady();
+	const lookup = agentId.trim();
+	if (!lookup) return [];
+	return snapshotTaskRecords(tasks).filter((task) => task.agentId?.trim() === lookup).toSorted(compareTasksNewestFirst);
+}
+function listTasksForOwnerKey(ownerKey) {
+	ensureTaskRegistryReady();
+	const key = normalizeOptionalString(ownerKey);
+	if (!key) return [];
+	return listTasksFromIndex(taskIdsByOwnerKey, key);
+}
+function listTasksForFlowId(flowId) {
+	ensureTaskRegistryReady();
+	const key = flowId.trim();
+	if (!key) return [];
+	return listTasksFromIndex(taskIdsByParentFlowId, key);
+}
+function findLatestTaskForRelatedSessionKey(sessionKey) {
+	const task = listTasksForRelatedSessionKey(sessionKey)[0];
+	return task ? cloneTaskRecord(task) : void 0;
+}
+function listTasksForRelatedSessionKey(sessionKey) {
+	ensureTaskRegistryReady();
+	const key = normalizeOptionalString(sessionKey);
+	if (!key) return [];
+	return listTasksFromIndex(taskIdsByRelatedSessionKey, key);
+}
+function resolveTaskForLookupToken(token) {
+	const lookup = token.trim();
+	if (!lookup) return;
+	return getTaskById(lookup) ?? findTaskByRunId(lookup) ?? findLatestTaskForRelatedSessionKey(lookup);
+}
+function deleteTaskRecordById(taskId) {
+	ensureTaskRegistryReady();
+	const current = tasks.get(taskId);
+	if (!current) return false;
+	deleteOwnerKeyIndex(taskId, current);
+	deleteParentFlowIdIndex(taskId, current);
+	deleteRelatedSessionKeyIndex(taskId, current);
+	tasks.delete(taskId);
+	taskDeliveryStates.delete(taskId);
+	rebuildRunIdIndex();
+	persistTaskDelete(taskId);
+	persistTaskDeliveryStateDelete(taskId);
+	emitTaskRegistryObserverEvent(() => ({
+		kind: "deleted",
+		taskId: current.taskId,
+		previous: cloneTaskRecord(current)
+	}));
+	return true;
+}
+//#endregion
+export { finishFlow as A, setTaskRunDeliveryStatusByRunId as C, deleteTaskFlowRecordById as D, createTaskFlowForTask as E, requestFlowCancel as F, resolveTaskFlowForLookupToken as I, resumeFlow as L, getTaskFlowRegistryRestoreFailure as M, listTaskFlowRecords as N, failFlow as O, listTaskFlowsForOwnerKey as P, setFlowWaiting as R, setTaskCleanupAfterById as S, createManagedTaskFlow as T, markTaskTerminalById as _, findTaskByRunId as a, recordTaskProgressByRunId as b, linkTaskToFlowById as c, listTasksForFlowId as d, listTasksForOwnerKey as f, markTaskRunningByRunId as g, markTaskLostById as h, ensureTaskRegistryReady as i, getTaskFlowById as j, findLatestTaskFlowForOwnerKey as k, listTaskRecords as l, listTasksForSessionKey as m, createTaskRecord as n, getTaskById as o, listTasksForRelatedSessionKey as p, deleteTaskRecordById as r, isParentFlowLinkError as s, cancelTaskById as t, listTasksForAgentId as u, markTaskTerminalByRunId as v, updateTaskNotifyPolicyById as w, resolveTaskForLookupToken as x, maybeDeliverTaskTerminalUpdate as y, updateFlowRecordByIdExpectedRevision as z };