@pixelzx/genesis 2026.6.29 → 2026.7.9

package/dist/store-BtHVDH2Q.js

@@ -0,0 +1,910 @@
+import { a as normalizeLowercaseStringOrEmpty, c as normalizeOptionalString, s as normalizeOptionalLowercaseString } from "./string-coerce-DPP_aYVc.js";
+import { t as createSubsystemLogger } from "./subsystem-CNq69MoE.js";
+import { i as normalizeHyphenSlug } from "./string-normalization-Bsx26hdl.js";
+import { i as normalizeChannelId, r as listChannelPlugins, t as getChannelPlugin } from "./registry-BPyvV-id.js";
+import { l as listDeliverableMessageChannels, u as normalizeMessageChannel } from "./message-channel-8hna3ogc.js";
+import "./plugins-DhprD-7C.js";
+import { i as resolveSessionFilePath } from "./paths-CiRFr3OE.js";
+import { a as normalizeSessionDeliveryFields, i as normalizeDeliveryContext, r as mergeDeliveryContext, t as deliveryContextFromSession } from "./delivery-context.shared-DnaA0DbE.js";
+import { i as isSessionStoreCacheEnabled, l as getFileStatSnapshot, n as dropSessionStoreObjectCache, o as setSerializedSessionStore, r as getSerializedSessionStore, s as writeSessionStoreCache } from "./store-cache-B5AHtZqw.js";
+import { a as getActiveSessionMaintenanceWarning, c as rotateSessionFile, i as capEntryCount, n as normalizeSessionStore, o as pruneStaleEntries, r as resolveMaintenanceConfig, t as loadSessionStore } from "./store-load-DLkfg3iM.js";
+import { n as mergeSessionEntry, r as mergeSessionEntryPreserveActivity } from "./types-JTaez-vO.js";
+import { n as isPrimarySessionTranscriptFileName, r as isSessionArchiveArtifactName } from "./artifacts-B_VcrNoo.js";
+import { t as normalizeChatType } from "./chat-type-BzguSVNU.js";
+import { t as resolveConversationLabel } from "./conversation-label-5h41UYmk.js";
+import { n as acquireSessionWriteLock, o as resolveSessionLockMaxHoldFromTimeout } from "./session-write-lock-BRkGnD6K.js";
+import { i as writeTextAtomic } from "./json-files-je-qnbe1.js";
+import { t as LOCK_QUEUES } from "./store-lock-state-DdssjRAz.js";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/config/sessions/group.ts
+const getGroupSurfaces = () => new Set([...listDeliverableMessageChannels(), "webchat"]);
+function resolveLegacyGroupSessionKey(ctx) {
+	for (const plugin of listChannelPlugins()) {
+		const resolved = plugin.messaging?.resolveLegacyGroupSessionKey?.(ctx);
+		if (resolved) return resolved;
+	}
+	return null;
+}
+function normalizeGroupLabel(raw) {
+	return normalizeHyphenSlug(raw);
+}
+function shortenGroupId(value) {
+	const trimmed = normalizeOptionalString(value) ?? "";
+	if (!trimmed) return "";
+	if (trimmed.length <= 14) return trimmed;
+	return `${trimmed.slice(0, 6)}...${trimmed.slice(-4)}`;
+}
+function buildGroupDisplayName(params) {
+	const providerKey = normalizeOptionalLowercaseString(params.provider) ?? "group";
+	const groupChannel = normalizeOptionalString(params.groupChannel);
+	const space = normalizeOptionalString(params.space);
+	const subject = normalizeOptionalString(params.subject);
+	const detail = (groupChannel && space ? `${space}${groupChannel.startsWith("#") ? "" : "#"}${groupChannel}` : groupChannel || subject || space || "") || "";
+	const fallbackId = normalizeOptionalString(params.id) ?? params.key;
+	const rawLabel = detail || fallbackId;
+	let token = normalizeGroupLabel(rawLabel);
+	if (!token) token = normalizeGroupLabel(shortenGroupId(rawLabel));
+	if (!params.groupChannel && token.startsWith("#")) token = token.replace(/^#+/, "");
+	if (token && !/^[@#]/.test(token) && !token.startsWith("g-") && !token.includes("#")) token = `g-${token}`;
+	return token ? `${providerKey}:${token}` : providerKey;
+}
+function resolveGroupSessionKey(ctx) {
+	const from = normalizeOptionalString(ctx.From) ?? "";
+	const chatType = normalizeOptionalLowercaseString(ctx.ChatType);
+	const normalizedChatType = chatType === "channel" ? "channel" : chatType === "group" ? "group" : void 0;
+	const legacyResolution = resolveLegacyGroupSessionKey(ctx);
+	if (!(normalizedChatType === "group" || normalizedChatType === "channel" || from.includes(":group:") || from.includes(":channel:") || legacyResolution !== null)) return null;
+	const providerHint = normalizeOptionalLowercaseString(ctx.Provider);
+	const parts = from.split(":").filter(Boolean);
+	const head = normalizeLowercaseStringOrEmpty(parts[0]);
+	const headIsSurface = head ? getGroupSurfaces().has(head) : false;
+	if (!headIsSurface && !providerHint && legacyResolution) return legacyResolution;
+	const provider = headIsSurface ? head : providerHint ?? legacyResolution?.channel;
+	if (!provider) return null;
+	const second = normalizeOptionalLowercaseString(parts[1]);
+	const secondIsKind = second === "group" || second === "channel";
+	const kind = secondIsKind ? second : from.includes(":channel:") || normalizedChatType === "channel" ? "channel" : "group";
+	const finalId = normalizeLowercaseStringOrEmpty(headIsSurface ? secondIsKind ? parts.slice(2).join(":") : parts.slice(1).join(":") : from);
+	if (!finalId) return null;
+	return {
+		key: `${provider}:${kind}:${finalId}`,
+		channel: provider,
+		id: finalId,
+		chatType: kind === "channel" ? "channel" : "group"
+	};
+}
+//#endregion
+//#region src/config/sessions/metadata.ts
+const mergeOrigin = (existing, next) => {
+	if (!existing && !next) return;
+	const merged = existing ? { ...existing } : {};
+	if (next?.label) merged.label = next.label;
+	if (next?.provider) merged.provider = next.provider;
+	if (next?.surface) merged.surface = next.surface;
+	if (next?.chatType) merged.chatType = next.chatType;
+	if (next?.from) merged.from = next.from;
+	if (next?.to) merged.to = next.to;
+	if (next?.nativeChannelId) merged.nativeChannelId = next.nativeChannelId;
+	if (next?.nativeDirectUserId) merged.nativeDirectUserId = next.nativeDirectUserId;
+	if (next?.accountId) merged.accountId = next.accountId;
+	if (next?.threadId != null && next.threadId !== "") merged.threadId = next.threadId;
+	return Object.keys(merged).length > 0 ? merged : void 0;
+};
+function deriveSessionOrigin(ctx, opts) {
+	const isSystemEventProvider = ctx.Provider === "heartbeat" || ctx.Provider === "cron-event" || ctx.Provider === "exec-event";
+	if (opts?.skipSystemEventOrigin && isSystemEventProvider) return;
+	const label = normalizeOptionalString(resolveConversationLabel(ctx));
+	const provider = normalizeMessageChannel(typeof ctx.OriginatingChannel === "string" && ctx.OriginatingChannel || ctx.Surface || ctx.Provider);
+	const surface = normalizeOptionalLowercaseString(ctx.Surface);
+	const chatType = normalizeChatType(ctx.ChatType) ?? void 0;
+	const from = normalizeOptionalString(ctx.From);
+	const to = normalizeOptionalString(typeof ctx.OriginatingTo === "string" ? ctx.OriginatingTo : ctx.To);
+	const nativeChannelId = normalizeOptionalString(ctx.NativeChannelId);
+	const nativeDirectUserId = normalizeOptionalString(ctx.NativeDirectUserId);
+	const accountId = normalizeOptionalString(ctx.AccountId);
+	const threadId = ctx.MessageThreadId ?? void 0;
+	const origin = {};
+	if (label) origin.label = label;
+	if (provider) origin.provider = provider;
+	if (surface) origin.surface = surface;
+	if (chatType) origin.chatType = chatType;
+	if (from) origin.from = from;
+	if (to) origin.to = to;
+	if (nativeChannelId) origin.nativeChannelId = nativeChannelId;
+	if (nativeDirectUserId) origin.nativeDirectUserId = nativeDirectUserId;
+	if (accountId) origin.accountId = accountId;
+	if (threadId != null && threadId !== "") origin.threadId = threadId;
+	return Object.keys(origin).length > 0 ? origin : void 0;
+}
+function snapshotSessionOrigin(entry) {
+	if (!entry?.origin) return;
+	return { ...entry.origin };
+}
+function deriveGroupSessionPatch(params) {
+	const resolution = params.groupResolution ?? resolveGroupSessionKey(params.ctx);
+	if (!resolution?.channel) return null;
+	const channel = resolution.channel;
+	const subject = params.ctx.GroupSubject?.trim();
+	const space = params.ctx.GroupSpace?.trim();
+	const explicitChannel = params.ctx.GroupChannel?.trim();
+	const subjectLooksChannel = Boolean(subject?.startsWith("#"));
+	const normalizedChannel = subjectLooksChannel && resolution.chatType !== "channel" ? normalizeChannelId(channel) : null;
+	const isChannelProvider = Boolean(normalizedChannel && getChannelPlugin(normalizedChannel)?.capabilities.chatTypes.includes("channel"));
+	const nextGroupChannel = explicitChannel ?? (subjectLooksChannel && subject && (resolution.chatType === "channel" || isChannelProvider) ? subject : void 0);
+	const nextSubject = nextGroupChannel ? void 0 : subject;
+	const patch = {
+		chatType: resolution.chatType ?? "group",
+		channel,
+		groupId: resolution.id
+	};
+	if (nextSubject) patch.subject = nextSubject;
+	if (nextGroupChannel) patch.groupChannel = nextGroupChannel;
+	if (space) patch.space = space;
+	const displayName = buildGroupDisplayName({
+		provider: channel,
+		subject: nextSubject ?? params.existing?.subject,
+		groupChannel: nextGroupChannel ?? params.existing?.groupChannel,
+		space: space ?? params.existing?.space,
+		id: resolution.id,
+		key: params.sessionKey
+	});
+	if (displayName) patch.displayName = displayName;
+	return patch;
+}
+function deriveSessionMetaPatch(params) {
+	const groupPatch = deriveGroupSessionPatch(params);
+	const origin = deriveSessionOrigin(params.ctx, { skipSystemEventOrigin: params.skipSystemEventOrigin });
+	if (!groupPatch && !origin) return null;
+	const patch = groupPatch ? { ...groupPatch } : {};
+	const mergedOrigin = mergeOrigin(params.existing?.origin, origin);
+	if (mergedOrigin) patch.origin = mergedOrigin;
+	return Object.keys(patch).length > 0 ? patch : null;
+}
+//#endregion
+//#region src/config/sessions/disk-budget.ts
+const NOOP_LOGGER = {
+	warn: () => {},
+	info: () => {}
+};
+function canonicalizePathForComparison(filePath) {
+	const resolved = path.resolve(filePath);
+	try {
+		return fs.realpathSync(resolved);
+	} catch {
+		return resolved;
+	}
+}
+function measureStoreBytes(store) {
+	return Buffer.byteLength(JSON.stringify(store, null, 2), "utf-8");
+}
+function measureStoreEntryChunkBytes(key, entry) {
+	const singleEntryStore = JSON.stringify({ [key]: entry }, null, 2);
+	if (!singleEntryStore.startsWith("{\n") || !singleEntryStore.endsWith("\n}")) return measureStoreBytes({ [key]: entry }) - 4;
+	const chunk = singleEntryStore.slice(2, -2);
+	return Buffer.byteLength(chunk, "utf-8");
+}
+function buildStoreEntryChunkSizeMap(store) {
+	const out = /* @__PURE__ */ new Map();
+	for (const [key, entry] of Object.entries(store)) out.set(key, measureStoreEntryChunkBytes(key, entry));
+	return out;
+}
+function getEntryUpdatedAt(entry) {
+	if (!entry) return 0;
+	const updatedAt = entry.updatedAt;
+	return Number.isFinite(updatedAt) ? updatedAt : 0;
+}
+function buildSessionIdRefCounts(store) {
+	const counts = /* @__PURE__ */ new Map();
+	for (const entry of Object.values(store)) {
+		const sessionId = entry?.sessionId;
+		if (!sessionId) continue;
+		counts.set(sessionId, (counts.get(sessionId) ?? 0) + 1);
+	}
+	return counts;
+}
+function resolveSessionTranscriptPathForEntry(params) {
+	if (!params.entry.sessionId) return null;
+	try {
+		const resolved = resolveSessionFilePath(params.entry.sessionId, params.entry, { sessionsDir: params.sessionsDir });
+		const resolvedSessionsDir = canonicalizePathForComparison(params.sessionsDir);
+		const resolvedPath = canonicalizePathForComparison(resolved);
+		const relative = path.relative(resolvedSessionsDir, resolvedPath);
+		if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) return null;
+		return resolvedPath;
+	} catch {
+		return null;
+	}
+}
+function resolveReferencedSessionTranscriptPaths(params) {
+	const referenced = /* @__PURE__ */ new Set();
+	for (const entry of Object.values(params.store)) {
+		const resolved = resolveSessionTranscriptPathForEntry({
+			sessionsDir: params.sessionsDir,
+			entry
+		});
+		if (resolved) referenced.add(canonicalizePathForComparison(resolved));
+	}
+	return referenced;
+}
+async function readSessionsDirFiles(sessionsDir) {
+	const dirEntries = await fs.promises.readdir(sessionsDir, { withFileTypes: true }).catch(() => []);
+	const files = [];
+	for (const dirent of dirEntries) {
+		if (!dirent.isFile()) continue;
+		const filePath = path.join(sessionsDir, dirent.name);
+		const stat = await fs.promises.stat(filePath).catch(() => null);
+		if (!stat?.isFile()) continue;
+		files.push({
+			path: filePath,
+			canonicalPath: canonicalizePathForComparison(filePath),
+			name: dirent.name,
+			size: stat.size,
+			mtimeMs: stat.mtimeMs
+		});
+	}
+	return files;
+}
+async function removeFileIfExists(filePath) {
+	const stat = await fs.promises.stat(filePath).catch(() => null);
+	if (!stat?.isFile()) return 0;
+	await fs.promises.rm(filePath, { force: true }).catch(() => void 0);
+	return stat.size;
+}
+async function removeFileForBudget(params) {
+	const resolvedPath = path.resolve(params.filePath);
+	const canonicalPath = params.canonicalPath ?? canonicalizePathForComparison(resolvedPath);
+	if (params.dryRun) {
+		if (params.simulatedRemovedPaths.has(canonicalPath)) return 0;
+		const size = params.fileSizesByPath.get(canonicalPath) ?? 0;
+		if (size <= 0) return 0;
+		params.simulatedRemovedPaths.add(canonicalPath);
+		return size;
+	}
+	return removeFileIfExists(resolvedPath);
+}
+async function enforceSessionDiskBudget(params) {
+	const maxBytes = params.maintenance.maxDiskBytes;
+	const highWaterBytes = params.maintenance.highWaterBytes;
+	if (maxBytes == null || highWaterBytes == null) return null;
+	const log = params.log ?? NOOP_LOGGER;
+	const dryRun = params.dryRun === true;
+	const sessionsDir = path.dirname(params.storePath);
+	const files = await readSessionsDirFiles(sessionsDir);
+	const fileSizesByPath = new Map(files.map((file) => [file.canonicalPath, file.size]));
+	const simulatedRemovedPaths = /* @__PURE__ */ new Set();
+	const resolvedStorePath = canonicalizePathForComparison(params.storePath);
+	const storeFile = files.find((file) => file.canonicalPath === resolvedStorePath);
+	let projectedStoreBytes = measureStoreBytes(params.store);
+	let total = files.reduce((sum, file) => sum + file.size, 0) - (storeFile?.size ?? 0) + projectedStoreBytes;
+	const totalBefore = total;
+	if (total <= maxBytes) return {
+		totalBytesBefore: totalBefore,
+		totalBytesAfter: total,
+		removedFiles: 0,
+		removedEntries: 0,
+		freedBytes: 0,
+		maxBytes,
+		highWaterBytes,
+		overBudget: false
+	};
+	if (params.warnOnly) {
+		log.warn("session disk budget exceeded (warn-only mode)", {
+			sessionsDir,
+			totalBytes: total,
+			maxBytes,
+			highWaterBytes
+		});
+		return {
+			totalBytesBefore: totalBefore,
+			totalBytesAfter: total,
+			removedFiles: 0,
+			removedEntries: 0,
+			freedBytes: 0,
+			maxBytes,
+			highWaterBytes,
+			overBudget: true
+		};
+	}
+	let removedFiles = 0;
+	let removedEntries = 0;
+	let freedBytes = 0;
+	const referencedPaths = resolveReferencedSessionTranscriptPaths({
+		sessionsDir,
+		store: params.store
+	});
+	const removableFileQueue = files.filter((file) => isSessionArchiveArtifactName(file.name) || isPrimarySessionTranscriptFileName(file.name) && !referencedPaths.has(file.canonicalPath)).toSorted((a, b) => a.mtimeMs - b.mtimeMs);
+	for (const file of removableFileQueue) {
+		if (total <= highWaterBytes) break;
+		const deletedBytes = await removeFileForBudget({
+			filePath: file.path,
+			canonicalPath: file.canonicalPath,
+			dryRun,
+			fileSizesByPath,
+			simulatedRemovedPaths
+		});
+		if (deletedBytes <= 0) continue;
+		total -= deletedBytes;
+		freedBytes += deletedBytes;
+		removedFiles += 1;
+	}
+	if (total > highWaterBytes) {
+		const activeSessionKey = normalizeOptionalLowercaseString(params.activeSessionKey);
+		const sessionIdRefCounts = buildSessionIdRefCounts(params.store);
+		const entryChunkBytesByKey = buildStoreEntryChunkSizeMap(params.store);
+		const keys = Object.keys(params.store).toSorted((a, b) => {
+			return getEntryUpdatedAt(params.store[a]) - getEntryUpdatedAt(params.store[b]);
+		});
+		for (const key of keys) {
+			if (total <= highWaterBytes) break;
+			if (activeSessionKey && normalizeLowercaseStringOrEmpty(key) === activeSessionKey) continue;
+			const entry = params.store[key];
+			if (!entry) continue;
+			const previousProjectedBytes = projectedStoreBytes;
+			delete params.store[key];
+			const chunkBytes = entryChunkBytesByKey.get(key);
+			entryChunkBytesByKey.delete(key);
+			if (typeof chunkBytes === "number" && Number.isFinite(chunkBytes) && chunkBytes >= 0) projectedStoreBytes = Math.max(2, projectedStoreBytes - (chunkBytes + 2));
+			else projectedStoreBytes = measureStoreBytes(params.store);
+			total += projectedStoreBytes - previousProjectedBytes;
+			removedEntries += 1;
+			const sessionId = entry.sessionId;
+			if (!sessionId) continue;
+			const nextRefCount = (sessionIdRefCounts.get(sessionId) ?? 1) - 1;
+			if (nextRefCount > 0) {
+				sessionIdRefCounts.set(sessionId, nextRefCount);
+				continue;
+			}
+			sessionIdRefCounts.delete(sessionId);
+			const transcriptPath = resolveSessionTranscriptPathForEntry({
+				sessionsDir,
+				entry
+			});
+			if (!transcriptPath) continue;
+			const deletedBytes = await removeFileForBudget({
+				filePath: transcriptPath,
+				dryRun,
+				fileSizesByPath,
+				simulatedRemovedPaths
+			});
+			if (deletedBytes <= 0) continue;
+			total -= deletedBytes;
+			freedBytes += deletedBytes;
+			removedFiles += 1;
+		}
+	}
+	if (!dryRun) {
+		if (total > highWaterBytes) log.warn("session disk budget still above high-water target after cleanup", {
+			sessionsDir,
+			totalBytes: total,
+			maxBytes,
+			highWaterBytes,
+			removedFiles,
+			removedEntries
+		});
+		else if (removedFiles > 0 || removedEntries > 0) log.info("applied session disk budget cleanup", {
+			sessionsDir,
+			totalBytesBefore: totalBefore,
+			totalBytesAfter: total,
+			maxBytes,
+			highWaterBytes,
+			removedFiles,
+			removedEntries
+		});
+	}
+	return {
+		totalBytesBefore: totalBefore,
+		totalBytesAfter: total,
+		removedFiles,
+		removedEntries,
+		freedBytes,
+		maxBytes,
+		highWaterBytes,
+		overBudget: true
+	};
+}
+//#endregion
+//#region src/config/sessions/store-entry.ts
+function normalizeStoreSessionKey(sessionKey) {
+	return normalizeLowercaseStringOrEmpty(sessionKey);
+}
+function resolveSessionStoreEntry(params) {
+	const trimmedKey = params.sessionKey.trim();
+	const normalizedKey = normalizeStoreSessionKey(trimmedKey);
+	const legacyKeySet = /* @__PURE__ */ new Set();
+	if (trimmedKey !== normalizedKey && Object.prototype.hasOwnProperty.call(params.store, trimmedKey)) legacyKeySet.add(trimmedKey);
+	let existing = params.store[normalizedKey] ?? (legacyKeySet.size > 0 ? params.store[trimmedKey] : void 0);
+	let existingUpdatedAt = existing?.updatedAt ?? 0;
+	for (const [candidateKey, candidateEntry] of Object.entries(params.store)) {
+		if (candidateKey === normalizedKey) continue;
+		if (normalizeStoreSessionKey(candidateKey) !== normalizedKey) continue;
+		legacyKeySet.add(candidateKey);
+		const candidateUpdatedAt = candidateEntry?.updatedAt ?? 0;
+		if (!existing || candidateUpdatedAt > existingUpdatedAt) {
+			existing = candidateEntry;
+			existingUpdatedAt = candidateUpdatedAt;
+		}
+	}
+	return {
+		normalizedKey,
+		existing,
+		legacyKeys: [...legacyKeySet]
+	};
+}
+//#endregion
+//#region src/config/sessions/store.ts
+const log = createSubsystemLogger("sessions/store");
+let sessionArchiveRuntimePromise = null;
+let sessionWriteLockAcquirerForTests = null;
+function loadSessionArchiveRuntime() {
+	sessionArchiveRuntimePromise ??= import("./session-archive.runtime-BIqBKdzI.js");
+	return sessionArchiveRuntimePromise;
+}
+function removeThreadFromDeliveryContext(context) {
+	if (!context || context.threadId == null) return context;
+	const next = { ...context };
+	delete next.threadId;
+	return next;
+}
+function readSessionUpdatedAt(params) {
+	try {
+		return resolveSessionStoreEntry({
+			store: loadSessionStore(params.storePath),
+			sessionKey: params.sessionKey
+		}).existing?.updatedAt;
+	} catch {
+		return;
+	}
+}
+function updateSessionStoreWriteCaches(params) {
+	const fileStat = getFileStatSnapshot(params.storePath);
+	setSerializedSessionStore(params.storePath, params.serialized);
+	if (!isSessionStoreCacheEnabled()) {
+		dropSessionStoreObjectCache(params.storePath);
+		return;
+	}
+	writeSessionStoreCache({
+		storePath: params.storePath,
+		store: params.store,
+		mtimeMs: fileStat?.mtimeMs,
+		sizeBytes: fileStat?.sizeBytes,
+		serialized: params.serialized
+	});
+}
+function resolveMutableSessionStoreKey(store, sessionKey) {
+	const trimmed = sessionKey.trim();
+	if (!trimmed) return;
+	if (Object.prototype.hasOwnProperty.call(store, trimmed)) return trimmed;
+	const normalized = normalizeStoreSessionKey(trimmed);
+	if (Object.prototype.hasOwnProperty.call(store, normalized)) return normalized;
+	return Object.keys(store).find((key) => normalizeStoreSessionKey(key) === normalized);
+}
+function collectAcpMetadataSnapshot(store) {
+	const snapshot = /* @__PURE__ */ new Map();
+	for (const [sessionKey, entry] of Object.entries(store)) if (entry?.acp) snapshot.set(sessionKey, entry.acp);
+	return snapshot;
+}
+function preserveExistingAcpMetadata(params) {
+	const allowDrop = new Set((params.allowDropSessionKeys ?? []).map((key) => normalizeStoreSessionKey(key)));
+	for (const [previousKey, previousAcp] of params.previousAcpByKey.entries()) {
+		const normalizedKey = normalizeStoreSessionKey(previousKey);
+		if (allowDrop.has(normalizedKey)) continue;
+		const nextKey = resolveMutableSessionStoreKey(params.nextStore, previousKey);
+		if (!nextKey) continue;
+		const nextEntry = params.nextStore[nextKey];
+		if (!nextEntry || nextEntry.acp) continue;
+		params.nextStore[nextKey] = {
+			...nextEntry,
+			acp: previousAcp
+		};
+	}
+}
+async function saveSessionStoreUnlocked(storePath, store, opts) {
+	normalizeSessionStore(store);
+	if (!opts?.skipMaintenance) {
+		const maintenance = opts?.maintenanceConfig ? {
+			...opts.maintenanceConfig,
+			...opts?.maintenanceOverride
+		} : {
+			...resolveMaintenanceConfig(),
+			...opts?.maintenanceOverride
+		};
+		const shouldWarnOnly = maintenance.mode === "warn";
+		const beforeCount = Object.keys(store).length;
+		if (shouldWarnOnly) {
+			const activeSessionKey = opts?.activeSessionKey?.trim();
+			if (activeSessionKey) {
+				const warning = getActiveSessionMaintenanceWarning({
+					store,
+					activeSessionKey,
+					pruneAfterMs: maintenance.pruneAfterMs,
+					maxEntries: maintenance.maxEntries
+				});
+				if (warning) {
+					log.warn("session maintenance would evict active session; skipping enforcement", {
+						activeSessionKey: warning.activeSessionKey,
+						wouldPrune: warning.wouldPrune,
+						wouldCap: warning.wouldCap,
+						pruneAfterMs: warning.pruneAfterMs,
+						maxEntries: warning.maxEntries
+					});
+					await opts?.onWarn?.(warning);
+				}
+			}
+			const diskBudget = await enforceSessionDiskBudget({
+				store,
+				storePath,
+				activeSessionKey: opts?.activeSessionKey,
+				maintenance,
+				warnOnly: true,
+				log
+			});
+			await opts?.onMaintenanceApplied?.({
+				mode: maintenance.mode,
+				beforeCount,
+				afterCount: Object.keys(store).length,
+				pruned: 0,
+				capped: 0,
+				diskBudget
+			});
+		} else {
+			const preserveSessionKeys = opts?.activeSessionKey ? new Set([opts.activeSessionKey]) : void 0;
+			const removedSessionFiles = /* @__PURE__ */ new Map();
+			const pruned = pruneStaleEntries(store, maintenance.pruneAfterMs, {
+				onPruned: ({ entry }) => {
+					rememberRemovedSessionFile(removedSessionFiles, entry);
+				},
+				preserveKeys: preserveSessionKeys
+			});
+			const capped = capEntryCount(store, maintenance.maxEntries, {
+				onCapped: ({ entry }) => {
+					rememberRemovedSessionFile(removedSessionFiles, entry);
+				},
+				preserveKeys: preserveSessionKeys
+			});
+			const archivedDirs = /* @__PURE__ */ new Set();
+			const archivedForDeletedSessions = await archiveRemovedSessionTranscripts({
+				removedSessionFiles,
+				referencedSessionIds: new Set(Object.values(store).map((entry) => entry?.sessionId).filter((id) => Boolean(id))),
+				storePath,
+				reason: "deleted",
+				restrictToStoreDir: true
+			});
+			for (const archivedDir of archivedForDeletedSessions) archivedDirs.add(archivedDir);
+			if (archivedDirs.size > 0 || maintenance.resetArchiveRetentionMs != null) {
+				const { cleanupArchivedSessionTranscripts } = await loadSessionArchiveRuntime();
+				const targetDirs = archivedDirs.size > 0 ? [...archivedDirs] : [path.dirname(path.resolve(storePath))];
+				await cleanupArchivedSessionTranscripts({
+					directories: targetDirs,
+					olderThanMs: maintenance.pruneAfterMs,
+					reason: "deleted"
+				});
+				if (maintenance.resetArchiveRetentionMs != null) await cleanupArchivedSessionTranscripts({
+					directories: targetDirs,
+					olderThanMs: maintenance.resetArchiveRetentionMs,
+					reason: "reset"
+				});
+			}
+			await rotateSessionFile(storePath, maintenance.rotateBytes);
+			const diskBudget = await enforceSessionDiskBudget({
+				store,
+				storePath,
+				activeSessionKey: opts?.activeSessionKey,
+				maintenance,
+				warnOnly: false,
+				log
+			});
+			await opts?.onMaintenanceApplied?.({
+				mode: maintenance.mode,
+				beforeCount,
+				afterCount: Object.keys(store).length,
+				pruned,
+				capped,
+				diskBudget
+			});
+		}
+	}
+	await fs.promises.mkdir(path.dirname(storePath), { recursive: true });
+	const json = JSON.stringify(store, null, 2);
+	if (getSerializedSessionStore(storePath) === json) {
+		updateSessionStoreWriteCaches({
+			storePath,
+			store,
+			serialized: json
+		});
+		return;
+	}
+	if (process.platform === "win32") {
+		for (let i = 0; i < 5; i++) try {
+			await writeSessionStoreAtomic({
+				storePath,
+				store,
+				serialized: json
+			});
+			return;
+		} catch (err) {
+			if (getErrorCode(err) === "ENOENT") return;
+			if (i < 4) {
+				await new Promise((r) => setTimeout(r, 50 * (i + 1)));
+				continue;
+			}
+			log.warn(`atomic write failed after 5 attempts: ${storePath}`);
+		}
+		return;
+	}
+	try {
+		await writeSessionStoreAtomic({
+			storePath,
+			store,
+			serialized: json
+		});
+	} catch (err) {
+		if (getErrorCode(err) === "ENOENT") {
+			try {
+				await writeSessionStoreAtomic({
+					storePath,
+					store,
+					serialized: json
+				});
+			} catch (err2) {
+				if (getErrorCode(err2) === "ENOENT") return;
+				throw err2;
+			}
+			return;
+		}
+		throw err;
+	}
+}
+async function saveSessionStore(storePath, store, opts) {
+	await withSessionStoreLock(storePath, async () => {
+		await saveSessionStoreUnlocked(storePath, store, opts);
+	});
+}
+async function updateSessionStore(storePath, mutator, opts) {
+	return await withSessionStoreLock(storePath, async () => {
+		const store = loadSessionStore(storePath, { skipCache: true });
+		const previousAcpByKey = collectAcpMetadataSnapshot(store);
+		const result = await mutator(store);
+		preserveExistingAcpMetadata({
+			previousAcpByKey,
+			nextStore: store,
+			allowDropSessionKeys: opts?.allowDropAcpMetaSessionKeys
+		});
+		await saveSessionStoreUnlocked(storePath, store, opts);
+		return result;
+	});
+}
+const SESSION_STORE_LOCK_MIN_HOLD_MS = 5e3;
+const SESSION_STORE_LOCK_TIMEOUT_GRACE_MS = 5e3;
+function getErrorCode(error) {
+	if (!error || typeof error !== "object" || !("code" in error)) return null;
+	return String(error.code);
+}
+function rememberRemovedSessionFile(removedSessionFiles, entry) {
+	if (!removedSessionFiles.has(entry.sessionId) || entry.sessionFile) removedSessionFiles.set(entry.sessionId, entry.sessionFile);
+}
+async function archiveRemovedSessionTranscripts(params) {
+	const { archiveSessionTranscripts } = await loadSessionArchiveRuntime();
+	const archivedDirs = /* @__PURE__ */ new Set();
+	for (const [sessionId, sessionFile] of params.removedSessionFiles) {
+		if (params.referencedSessionIds.has(sessionId)) continue;
+		const archived = archiveSessionTranscripts({
+			sessionId,
+			storePath: params.storePath,
+			sessionFile,
+			reason: params.reason,
+			restrictToStoreDir: params.restrictToStoreDir
+		});
+		for (const archivedPath of archived) archivedDirs.add(path.dirname(archivedPath));
+	}
+	return archivedDirs;
+}
+async function writeSessionStoreAtomic(params) {
+	await writeTextAtomic(params.storePath, params.serialized, { mode: 384 });
+	updateSessionStoreWriteCaches({
+		storePath: params.storePath,
+		store: params.store,
+		serialized: params.serialized
+	});
+}
+async function persistResolvedSessionEntry(params) {
+	params.store[params.resolved.normalizedKey] = params.next;
+	for (const legacyKey of params.resolved.legacyKeys) delete params.store[legacyKey];
+	await saveSessionStoreUnlocked(params.storePath, params.store, { activeSessionKey: params.resolved.normalizedKey });
+	return params.next;
+}
+function lockTimeoutError(storePath) {
+	return /* @__PURE__ */ new Error(`timeout waiting for session store lock: ${storePath}`);
+}
+function resolveSessionStoreLockMaxHoldMs(timeoutMs) {
+	if (timeoutMs == null || !Number.isFinite(timeoutMs) || timeoutMs <= 0) return;
+	return resolveSessionLockMaxHoldFromTimeout({
+		timeoutMs,
+		graceMs: SESSION_STORE_LOCK_TIMEOUT_GRACE_MS,
+		minMs: SESSION_STORE_LOCK_MIN_HOLD_MS
+	});
+}
+function getOrCreateLockQueue(storePath) {
+	const existing = LOCK_QUEUES.get(storePath);
+	if (existing) return existing;
+	const created = {
+		running: false,
+		pending: [],
+		drainPromise: null
+	};
+	LOCK_QUEUES.set(storePath, created);
+	return created;
+}
+async function drainSessionStoreLockQueue(storePath) {
+	const queue = LOCK_QUEUES.get(storePath);
+	if (!queue) return;
+	if (queue.drainPromise) {
+		await queue.drainPromise;
+		return;
+	}
+	queue.running = true;
+	queue.drainPromise = (async () => {
+		try {
+			while (queue.pending.length > 0) {
+				const task = queue.pending.shift();
+				if (!task) continue;
+				const remainingTimeoutMs = task.timeoutMs ?? Number.POSITIVE_INFINITY;
+				if (task.timeoutMs != null && remainingTimeoutMs <= 0) {
+					task.reject(lockTimeoutError(storePath));
+					continue;
+				}
+				let lock;
+				let result;
+				let failed;
+				let hasFailure = false;
+				try {
+					lock = await (sessionWriteLockAcquirerForTests ?? acquireSessionWriteLock)({
+						sessionFile: storePath,
+						timeoutMs: remainingTimeoutMs,
+						staleMs: task.staleMs,
+						maxHoldMs: resolveSessionStoreLockMaxHoldMs(task.timeoutMs)
+					});
+					result = await task.fn();
+				} catch (err) {
+					hasFailure = true;
+					failed = err;
+				} finally {
+					await lock?.release().catch(() => void 0);
+				}
+				if (hasFailure) {
+					task.reject(failed);
+					continue;
+				}
+				task.resolve(result);
+			}
+		} finally {
+			queue.running = false;
+			queue.drainPromise = null;
+			if (queue.pending.length === 0) LOCK_QUEUES.delete(storePath);
+			else queueMicrotask(() => {
+				drainSessionStoreLockQueue(storePath);
+			});
+		}
+	})();
+	await queue.drainPromise;
+}
+async function withSessionStoreLock(storePath, fn, opts = {}) {
+	if (!storePath || typeof storePath !== "string") throw new Error(`withSessionStoreLock: storePath must be a non-empty string, got ${JSON.stringify(storePath)}`);
+	const timeoutMs = opts.timeoutMs ?? 1e4;
+	const staleMs = opts.staleMs ?? 3e4;
+	opts.pollIntervalMs;
+	const hasTimeout = timeoutMs > 0 && Number.isFinite(timeoutMs);
+	const queue = getOrCreateLockQueue(storePath);
+	return await new Promise((resolve, reject) => {
+		const task = {
+			fn: async () => await fn(),
+			resolve: (value) => resolve(value),
+			reject,
+			timeoutMs: hasTimeout ? timeoutMs : void 0,
+			staleMs
+		};
+		queue.pending.push(task);
+		drainSessionStoreLockQueue(storePath);
+	});
+}
+async function updateSessionStoreEntry(params) {
+	const { storePath, sessionKey, update } = params;
+	return await withSessionStoreLock(storePath, async () => {
+		const store = loadSessionStore(storePath, { skipCache: true });
+		const resolved = resolveSessionStoreEntry({
+			store,
+			sessionKey
+		});
+		const existing = resolved.existing;
+		if (!existing) return null;
+		const patch = await update(existing);
+		if (!patch) return existing;
+		return await persistResolvedSessionEntry({
+			storePath,
+			store,
+			resolved,
+			next: mergeSessionEntry(existing, patch)
+		});
+	});
+}
+async function recordSessionMetaFromInbound(params) {
+	const { storePath, sessionKey, ctx } = params;
+	const createIfMissing = params.createIfMissing ?? true;
+	return await updateSessionStore(storePath, (store) => {
+		const resolved = resolveSessionStoreEntry({
+			store,
+			sessionKey
+		});
+		const existing = resolved.existing;
+		const patch = deriveSessionMetaPatch({
+			ctx,
+			sessionKey: resolved.normalizedKey,
+			existing,
+			groupResolution: params.groupResolution
+		});
+		if (!patch) {
+			if (existing && resolved.legacyKeys.length > 0) {
+				store[resolved.normalizedKey] = existing;
+				for (const legacyKey of resolved.legacyKeys) delete store[legacyKey];
+			}
+			return existing ?? null;
+		}
+		if (!existing && !createIfMissing) return null;
+		const next = existing ? mergeSessionEntryPreserveActivity(existing, patch) : mergeSessionEntry(existing, patch);
+		store[resolved.normalizedKey] = next;
+		for (const legacyKey of resolved.legacyKeys) delete store[legacyKey];
+		return next;
+	}, { activeSessionKey: normalizeStoreSessionKey(sessionKey) });
+}
+async function updateLastRoute(params) {
+	const { storePath, sessionKey, channel, to, accountId, threadId, ctx } = params;
+	return await withSessionStoreLock(storePath, async () => {
+		const store = loadSessionStore(storePath);
+		const resolved = resolveSessionStoreEntry({
+			store,
+			sessionKey
+		});
+		const existing = resolved.existing;
+		const explicitContext = normalizeDeliveryContext(params.deliveryContext);
+		const inlineContext = normalizeDeliveryContext({
+			channel,
+			to,
+			accountId,
+			threadId
+		});
+		const mergedInput = mergeDeliveryContext(explicitContext, inlineContext);
+		const explicitDeliveryContext = params.deliveryContext;
+		const explicitThreadValue = (explicitDeliveryContext != null && Object.prototype.hasOwnProperty.call(explicitDeliveryContext, "threadId") ? explicitDeliveryContext.threadId : void 0) ?? (threadId != null && threadId !== "" ? threadId : void 0);
+		const merged = mergeDeliveryContext(mergedInput, Boolean(explicitContext?.channel || explicitContext?.to || inlineContext?.channel || inlineContext?.to) && explicitThreadValue == null ? removeThreadFromDeliveryContext(deliveryContextFromSession(existing)) : deliveryContextFromSession(existing));
+		const normalized = normalizeSessionDeliveryFields({ deliveryContext: {
+			channel: merged?.channel,
+			to: merged?.to,
+			accountId: merged?.accountId,
+			threadId: merged?.threadId
+		} });
+		const metaPatch = ctx ? deriveSessionMetaPatch({
+			ctx,
+			sessionKey: resolved.normalizedKey,
+			existing,
+			groupResolution: params.groupResolution
+		}) : null;
+		const basePatch = {
+			deliveryContext: normalized.deliveryContext,
+			lastChannel: normalized.lastChannel,
+			lastTo: normalized.lastTo,
+			lastAccountId: normalized.lastAccountId,
+			lastThreadId: normalized.lastThreadId
+		};
+		return await persistResolvedSessionEntry({
+			storePath,
+			store,
+			resolved,
+			next: mergeSessionEntryPreserveActivity(existing, metaPatch ? {
+				...basePatch,
+				...metaPatch
+			} : basePatch)
+		});
+	});
+}
+//#endregion
+export { updateLastRoute as a, normalizeStoreSessionKey as c, deriveGroupSessionPatch as d, deriveSessionMetaPatch as f, resolveGroupSessionKey as g, buildGroupDisplayName as h, saveSessionStore as i, resolveSessionStoreEntry as l, snapshotSessionOrigin as m, readSessionUpdatedAt as n, updateSessionStore as o, deriveSessionOrigin as p, recordSessionMetaFromInbound as r, updateSessionStoreEntry as s, archiveRemovedSessionTranscripts as t, enforceSessionDiskBudget as u };