remoteclaw 0.0.0 → 0.1.0-next.2abd2fa

package/dist/sessions--PykPynp.js

@@ -0,0 +1,2593 @@
+import { t as __exportAll } from "./rolldown-runtime-Cbj13DAv.js";
+import { Q as normalizeE164, dn as resolveRequiredHomeDir, o as createSubsystemLogger } from "./entry.js";
+import { n as isPidAlive, t as resolveProcessScopedMap } from "./process-scoped-map-PEvnG75N.js";
+import { c as normalizeMainKey, g as normalizeOptionalAccountId, l as resolveAgentIdFromSessionKey, r as buildAgentMainSessionKey, s as normalizeAgentId, t as DEFAULT_AGENT_ID } from "./session-key-C2n-VILA.js";
+import { _ as parseDurationMs, i as loadConfig, v as parseByteSize } from "./config-FHu9Bn4R.js";
+import { c as normalizeHyphenSlug, t as getChannelDock } from "./dock-BqNINg7k.js";
+import { c as normalizeMessageChannel, s as listDeliverableMessageChannels } from "./message-channel-uWMAiywE.js";
+import { t as normalizeChatType } from "./chat-type-CYPyHAj-.js";
+import { n as resolveConversationLabel } from "./conversation-label-C4SDz4sT.js";
+import { r as normalizeChannelId } from "./plugins-BflZz0sp.js";
+import { a as hasToolCall, c as resolveSessionFilePath, d as resolveSessionTranscriptPathInDir, f as resolveSessionTranscriptsDir, h as validateSessionId, i as extractToolCallNames, l as resolveSessionFilePathOptions, m as resolveStorePath, n as stripMessageIdHints, o as SAFE_SESSION_ID_RE, p as resolveSessionTranscriptsDirForAgent, s as resolveDefaultSessionStorePath, t as stripEnvelope, u as resolveSessionTranscriptPath } from "./chat-envelope-DEZ-5RY8.js";
+import { n as hasInterSessionUserProvenance } from "./input-provenance-xUsSMOsz.js";
+import { t as stripInboundMetadata } from "./strip-inbound-meta-DjKcSFaW.js";
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import crypto from "node:crypto";
+
+//#region src/config/sessions/group.ts
+const getGroupSurfaces = () => new Set([...listDeliverableMessageChannels(), "webchat"]);
+function normalizeGroupLabel(raw) {
+	return normalizeHyphenSlug(raw);
+}
+function shortenGroupId(value) {
+	const trimmed = value?.trim() ?? "";
+	if (!trimmed) return "";
+	if (trimmed.length <= 14) return trimmed;
+	return `${trimmed.slice(0, 6)}...${trimmed.slice(-4)}`;
+}
+function buildGroupDisplayName(params) {
+	const providerKey = (params.provider?.trim().toLowerCase() || "group").trim();
+	const groupChannel = params.groupChannel?.trim();
+	const space = params.space?.trim();
+	const subject = params.subject?.trim();
+	const detail = (groupChannel && space ? `${space}${groupChannel.startsWith("#") ? "" : "#"}${groupChannel}` : groupChannel || subject || space || "") || "";
+	const fallbackId = params.id?.trim() || 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 = typeof ctx.From === "string" ? ctx.From.trim() : "";
+	const chatType = ctx.ChatType?.trim().toLowerCase();
+	const normalizedChatType = chatType === "channel" ? "channel" : chatType === "group" ? "group" : void 0;
+	const isWhatsAppGroupId = from.toLowerCase().endsWith("@g.us");
+	if (!(normalizedChatType === "group" || normalizedChatType === "channel" || from.includes(":group:") || from.includes(":channel:") || isWhatsAppGroupId)) return null;
+	const providerHint = ctx.Provider?.trim().toLowerCase();
+	const parts = from.split(":").filter(Boolean);
+	const head = parts[0]?.trim().toLowerCase() ?? "";
+	const headIsSurface = head ? getGroupSurfaces().has(head) : false;
+	const provider = headIsSurface ? head : providerHint ?? (isWhatsAppGroupId ? "whatsapp" : void 0);
+	if (!provider) return null;
+	const second = parts[1]?.trim().toLowerCase();
+	const secondIsKind = second === "group" || second === "channel";
+	const kind = secondIsKind ? second : from.includes(":channel:") || normalizedChatType === "channel" ? "channel" : "group";
+	const finalId = (headIsSurface ? secondIsKind ? parts.slice(2).join(":") : parts.slice(1).join(":") : from).trim().toLowerCase();
+	if (!finalId) return null;
+	return {
+		key: `${provider}:${kind}:${finalId}`,
+		channel: provider,
+		id: finalId,
+		chatType: kind === "channel" ? "channel" : "group"
+	};
+}
+
+//#endregion
+//#region src/config/sessions/artifacts.ts
+const ARCHIVE_TIMESTAMP_RE = /^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}(?:\.\d{3})?Z$/;
+const LEGACY_STORE_BACKUP_RE = /^sessions\.json\.bak\.\d+$/;
+function hasArchiveSuffix(fileName, reason) {
+	const marker = `.${reason}.`;
+	const index = fileName.lastIndexOf(marker);
+	if (index < 0) return false;
+	const raw = fileName.slice(index + marker.length);
+	return ARCHIVE_TIMESTAMP_RE.test(raw);
+}
+function isSessionArchiveArtifactName(fileName) {
+	if (LEGACY_STORE_BACKUP_RE.test(fileName)) return true;
+	return hasArchiveSuffix(fileName, "deleted") || hasArchiveSuffix(fileName, "reset") || hasArchiveSuffix(fileName, "bak");
+}
+function isPrimarySessionTranscriptFileName(fileName) {
+	if (fileName === "sessions.json") return false;
+	if (!fileName.endsWith(".jsonl")) return false;
+	return !isSessionArchiveArtifactName(fileName);
+}
+function formatSessionArchiveTimestamp(nowMs = Date.now()) {
+	return new Date(nowMs).toISOString().replaceAll(":", "-");
+}
+function restoreSessionArchiveTimestamp(raw) {
+	const [datePart, timePart] = raw.split("T");
+	if (!datePart || !timePart) return raw;
+	return `${datePart}T${timePart.replace(/-/g, ":")}`;
+}
+function parseSessionArchiveTimestamp(fileName, reason) {
+	const marker = `.${reason}.`;
+	const index = fileName.lastIndexOf(marker);
+	if (index < 0) return null;
+	const raw = fileName.slice(index + marker.length);
+	if (!raw) return null;
+	if (!ARCHIVE_TIMESTAMP_RE.test(raw)) return null;
+	const timestamp = Date.parse(restoreSessionArchiveTimestamp(raw));
+	return Number.isNaN(timestamp) ? null : timestamp;
+}
+
+//#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?.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) {
+	const label = resolveConversationLabel(ctx)?.trim();
+	const provider = normalizeMessageChannel(typeof ctx.OriginatingChannel === "string" && ctx.OriginatingChannel || ctx.Surface || ctx.Provider);
+	const surface = ctx.Surface?.trim().toLowerCase();
+	const chatType = normalizeChatType(ctx.ChatType) ?? void 0;
+	const from = ctx.From?.trim();
+	const to = (typeof ctx.OriginatingTo === "string" ? ctx.OriginatingTo : ctx.To)?.trim() ?? void 0;
+	const accountId = ctx.AccountId?.trim();
+	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 (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 normalizedChannel = normalizeChannelId(channel);
+	const isChannelProvider = Boolean(normalizedChannel && getChannelDock(normalizedChannel)?.capabilities.chatTypes.includes("channel"));
+	const nextGroupChannel = explicitChannel ?? ((resolution.chatType === "channel" || isChannelProvider) && subject && subject.startsWith("#") ? 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);
+	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/main-session.ts
+function resolveMainSessionKey(cfg) {
+	if (cfg?.session?.scope === "global") return "global";
+	const agents = cfg?.agents?.list ?? [];
+	return buildAgentMainSessionKey({
+		agentId: normalizeAgentId(agents.find((agent) => agent?.default)?.id ?? agents[0]?.id ?? DEFAULT_AGENT_ID),
+		mainKey: normalizeMainKey(cfg?.session?.mainKey)
+	});
+}
+function resolveMainSessionKeyFromConfig() {
+	return resolveMainSessionKey(loadConfig());
+}
+function resolveAgentMainSessionKey(params) {
+	const mainKey = normalizeMainKey(params.cfg?.session?.mainKey);
+	return buildAgentMainSessionKey({
+		agentId: params.agentId,
+		mainKey
+	});
+}
+function resolveExplicitAgentSessionKey(params) {
+	const agentId = params.agentId?.trim();
+	if (!agentId) return;
+	return resolveAgentMainSessionKey({
+		cfg: params.cfg,
+		agentId
+	});
+}
+function canonicalizeMainSessionAlias(params) {
+	const raw = params.sessionKey.trim();
+	if (!raw) return raw;
+	const agentId = normalizeAgentId(params.agentId);
+	const mainKey = normalizeMainKey(params.cfg?.session?.mainKey);
+	const agentMainSessionKey = buildAgentMainSessionKey({
+		agentId,
+		mainKey
+	});
+	const agentMainAliasKey = buildAgentMainSessionKey({
+		agentId,
+		mainKey: "main"
+	});
+	const isMainAlias = raw === "main" || raw === mainKey || raw === agentMainSessionKey || raw === agentMainAliasKey;
+	if (params.cfg?.session?.scope === "global" && isMainAlias) return "global";
+	if (isMainAlias) return agentMainSessionKey;
+	return raw;
+}
+
+//#endregion
+//#region src/config/sessions/types.ts
+function normalizeRuntimeField(value) {
+	const trimmed = value?.trim();
+	return trimmed ? trimmed : void 0;
+}
+function normalizeSessionRuntimeModelFields(entry) {
+	const normalizedModel = normalizeRuntimeField(entry.model);
+	const normalizedProvider = normalizeRuntimeField(entry.modelProvider);
+	let next = entry;
+	if (!normalizedModel) {
+		if (entry.model !== void 0 || entry.modelProvider !== void 0) {
+			next = { ...next };
+			delete next.model;
+			delete next.modelProvider;
+		}
+		return next;
+	}
+	if (entry.model !== normalizedModel) {
+		if (next === entry) next = { ...next };
+		next.model = normalizedModel;
+	}
+	if (!normalizedProvider) {
+		if (entry.modelProvider !== void 0) {
+			if (next === entry) next = { ...next };
+			delete next.modelProvider;
+		}
+		return next;
+	}
+	if (entry.modelProvider !== normalizedProvider) {
+		if (next === entry) next = { ...next };
+		next.modelProvider = normalizedProvider;
+	}
+	return next;
+}
+function setSessionRuntimeModel(entry, runtime) {
+	const provider = runtime.provider.trim();
+	const model = runtime.model.trim();
+	if (!provider || !model) return false;
+	entry.modelProvider = provider;
+	entry.model = model;
+	return true;
+}
+function mergeSessionEntry(existing, patch) {
+	const sessionId = patch.sessionId ?? existing?.sessionId ?? crypto.randomUUID();
+	const updatedAt = Math.max(existing?.updatedAt ?? 0, patch.updatedAt ?? 0, Date.now());
+	if (!existing) return normalizeSessionRuntimeModelFields({
+		...patch,
+		sessionId,
+		updatedAt
+	});
+	const next = {
+		...existing,
+		...patch,
+		sessionId,
+		updatedAt
+	};
+	if (Object.hasOwn(patch, "model") && !Object.hasOwn(patch, "modelProvider")) {
+		const patchedModel = normalizeRuntimeField(patch.model);
+		const existingModel = normalizeRuntimeField(existing.model);
+		if (patchedModel && patchedModel !== existingModel) delete next.modelProvider;
+	}
+	return normalizeSessionRuntimeModelFields(next);
+}
+function resolveFreshSessionTotalTokens(entry) {
+	const total = entry?.totalTokens;
+	if (typeof total !== "number" || !Number.isFinite(total) || total < 0) return;
+	if (entry?.totalTokensFresh === false) return;
+	return total;
+}
+function isSessionTotalTokensFresh(entry) {
+	return resolveFreshSessionTotalTokens(entry) !== void 0;
+}
+const DEFAULT_RESET_TRIGGER = "/new";
+const DEFAULT_RESET_TRIGGERS = ["/new", "/reset"];
+const DEFAULT_IDLE_MINUTES = 60;
+
+//#endregion
+//#region src/config/sessions/reset.ts
+const DEFAULT_RESET_MODE = "daily";
+const DEFAULT_RESET_AT_HOUR = 4;
+const THREAD_SESSION_MARKERS = [":thread:", ":topic:"];
+const GROUP_SESSION_MARKERS = [":group:", ":channel:"];
+function isThreadSessionKey(sessionKey) {
+	const normalized = (sessionKey ?? "").toLowerCase();
+	if (!normalized) return false;
+	return THREAD_SESSION_MARKERS.some((marker) => normalized.includes(marker));
+}
+function resolveSessionResetType(params) {
+	if (params.isThread || isThreadSessionKey(params.sessionKey)) return "thread";
+	if (params.isGroup) return "group";
+	const normalized = (params.sessionKey ?? "").toLowerCase();
+	if (GROUP_SESSION_MARKERS.some((marker) => normalized.includes(marker))) return "group";
+	return "direct";
+}
+function resolveThreadFlag(params) {
+	if (params.messageThreadId != null) return true;
+	if (params.threadLabel?.trim()) return true;
+	if (params.threadStarterBody?.trim()) return true;
+	if (params.parentSessionKey?.trim()) return true;
+	return isThreadSessionKey(params.sessionKey);
+}
+function resolveDailyResetAtMs(now, atHour) {
+	const normalizedAtHour = normalizeResetAtHour(atHour);
+	const resetAt = new Date(now);
+	resetAt.setHours(normalizedAtHour, 0, 0, 0);
+	if (now < resetAt.getTime()) resetAt.setDate(resetAt.getDate() - 1);
+	return resetAt.getTime();
+}
+function resolveSessionResetPolicy(params) {
+	const sessionCfg = params.sessionCfg;
+	const baseReset = params.resetOverride ?? sessionCfg?.reset;
+	const typeReset = params.resetOverride ? void 0 : sessionCfg?.resetByType?.[params.resetType] ?? (params.resetType === "direct" ? (sessionCfg?.resetByType)?.dm : void 0);
+	const hasExplicitReset = Boolean(baseReset || sessionCfg?.resetByType);
+	const legacyIdleMinutes = params.resetOverride ? void 0 : sessionCfg?.idleMinutes;
+	const mode = typeReset?.mode ?? baseReset?.mode ?? (!hasExplicitReset && legacyIdleMinutes != null ? "idle" : DEFAULT_RESET_MODE);
+	const atHour = normalizeResetAtHour(typeReset?.atHour ?? baseReset?.atHour ?? DEFAULT_RESET_AT_HOUR);
+	const idleMinutesRaw = typeReset?.idleMinutes ?? baseReset?.idleMinutes ?? legacyIdleMinutes;
+	let idleMinutes;
+	if (idleMinutesRaw != null) {
+		const normalized = Math.floor(idleMinutesRaw);
+		if (Number.isFinite(normalized)) idleMinutes = Math.max(normalized, 1);
+	} else if (mode === "idle") idleMinutes = DEFAULT_IDLE_MINUTES;
+	return {
+		mode,
+		atHour,
+		idleMinutes
+	};
+}
+function resolveChannelResetConfig(params) {
+	const resetByChannel = params.sessionCfg?.resetByChannel;
+	if (!resetByChannel) return;
+	const normalized = normalizeMessageChannel(params.channel);
+	const fallback = params.channel?.trim().toLowerCase();
+	const key = normalized ?? fallback;
+	if (!key) return;
+	return resetByChannel[key] ?? resetByChannel[key.toLowerCase()];
+}
+function evaluateSessionFreshness(params) {
+	const dailyResetAt = params.policy.mode === "daily" ? resolveDailyResetAtMs(params.now, params.policy.atHour) : void 0;
+	const idleExpiresAt = params.policy.idleMinutes != null ? params.updatedAt + params.policy.idleMinutes * 6e4 : void 0;
+	const staleDaily = dailyResetAt != null && params.updatedAt < dailyResetAt;
+	const staleIdle = idleExpiresAt != null && params.now > idleExpiresAt;
+	return {
+		fresh: !(staleDaily || staleIdle),
+		dailyResetAt,
+		idleExpiresAt
+	};
+}
+function normalizeResetAtHour(value) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return DEFAULT_RESET_AT_HOUR;
+	const normalized = Math.floor(value);
+	if (!Number.isFinite(normalized)) return DEFAULT_RESET_AT_HOUR;
+	if (normalized < 0) return 0;
+	if (normalized > 23) return 23;
+	return normalized;
+}
+
+//#endregion
+//#region src/config/sessions/session-key.ts
+function deriveSessionKey(scope, ctx) {
+	if (scope === "global") return "global";
+	const resolvedGroup = resolveGroupSessionKey(ctx);
+	if (resolvedGroup) return resolvedGroup.key;
+	return (ctx.From ? normalizeE164(ctx.From) : "") || "unknown";
+}
+/**
+* Resolve the session key with a canonical direct-chat bucket (default: "main").
+* All non-group direct chats collapse to this bucket; groups stay isolated.
+*/
+function resolveSessionKey(scope, ctx, mainKey) {
+	const explicit = ctx.SessionKey?.trim();
+	if (explicit) return explicit.toLowerCase();
+	const raw = deriveSessionKey(scope, ctx);
+	if (scope === "global") return raw;
+	const canonical = buildAgentMainSessionKey({
+		agentId: DEFAULT_AGENT_ID,
+		mainKey: normalizeMainKey(mainKey)
+	});
+	if (!(raw.includes(":group:") || raw.includes(":channel:"))) return canonical;
+	return `agent:${DEFAULT_AGENT_ID}:${raw}`;
+}
+
+//#endregion
+//#region src/agents/session-write-lock.ts
+const CLEANUP_SIGNALS = [
+	"SIGINT",
+	"SIGTERM",
+	"SIGQUIT",
+	"SIGABRT"
+];
+const CLEANUP_STATE_KEY = Symbol.for("remoteclaw.sessionWriteLockCleanupState");
+const HELD_LOCKS_KEY = Symbol.for("remoteclaw.sessionWriteLockHeldLocks");
+const WATCHDOG_STATE_KEY = Symbol.for("remoteclaw.sessionWriteLockWatchdogState");
+const DEFAULT_STALE_MS = 1800 * 1e3;
+const DEFAULT_MAX_HOLD_MS = 300 * 1e3;
+const DEFAULT_WATCHDOG_INTERVAL_MS = 6e4;
+const DEFAULT_TIMEOUT_GRACE_MS = 120 * 1e3;
+const HELD_LOCKS = resolveProcessScopedMap(HELD_LOCKS_KEY);
+function resolveCleanupState() {
+	const proc = process;
+	if (!proc[CLEANUP_STATE_KEY]) proc[CLEANUP_STATE_KEY] = {
+		registered: false,
+		cleanupHandlers: /* @__PURE__ */ new Map()
+	};
+	return proc[CLEANUP_STATE_KEY];
+}
+function resolveWatchdogState() {
+	const proc = process;
+	if (!proc[WATCHDOG_STATE_KEY]) proc[WATCHDOG_STATE_KEY] = {
+		started: false,
+		intervalMs: DEFAULT_WATCHDOG_INTERVAL_MS
+	};
+	return proc[WATCHDOG_STATE_KEY];
+}
+function resolvePositiveMs(value, fallback, opts = {}) {
+	if (typeof value !== "number" || Number.isNaN(value) || value <= 0) return fallback;
+	if (value === Number.POSITIVE_INFINITY) return opts.allowInfinity ? value : fallback;
+	if (!Number.isFinite(value)) return fallback;
+	return value;
+}
+async function releaseHeldLock(normalizedSessionFile, held, opts = {}) {
+	if (HELD_LOCKS.get(normalizedSessionFile) !== held) return false;
+	if (opts.force) held.count = 0;
+	else {
+		held.count -= 1;
+		if (held.count > 0) return false;
+	}
+	if (held.releasePromise) {
+		await held.releasePromise.catch(() => void 0);
+		return true;
+	}
+	HELD_LOCKS.delete(normalizedSessionFile);
+	held.releasePromise = (async () => {
+		try {
+			await held.handle.close();
+		} catch {}
+		try {
+			await fsp.rm(held.lockPath, { force: true });
+		} catch {}
+	})();
+	try {
+		await held.releasePromise;
+		return true;
+	} finally {
+		held.releasePromise = void 0;
+	}
+}
+/**
+* Synchronously release all held locks.
+* Used during process exit when async operations aren't reliable.
+*/
+function releaseAllLocksSync() {
+	for (const [sessionFile, held] of HELD_LOCKS) {
+		try {
+			if (typeof held.handle.close === "function") held.handle.close().catch(() => {});
+		} catch {}
+		try {
+			fs.rmSync(held.lockPath, { force: true });
+		} catch {}
+		HELD_LOCKS.delete(sessionFile);
+	}
+}
+async function runLockWatchdogCheck(nowMs = Date.now()) {
+	let released = 0;
+	for (const [sessionFile, held] of HELD_LOCKS.entries()) {
+		const heldForMs = nowMs - held.acquiredAt;
+		if (heldForMs <= held.maxHoldMs) continue;
+		console.warn(`[session-write-lock] releasing lock held for ${heldForMs}ms (max=${held.maxHoldMs}ms): ${held.lockPath}`);
+		if (await releaseHeldLock(sessionFile, held, { force: true })) released += 1;
+	}
+	return released;
+}
+function ensureWatchdogStarted(intervalMs) {
+	const watchdogState = resolveWatchdogState();
+	if (watchdogState.started) return;
+	watchdogState.started = true;
+	watchdogState.intervalMs = intervalMs;
+	watchdogState.timer = setInterval(() => {
+		runLockWatchdogCheck().catch(() => {});
+	}, intervalMs);
+	watchdogState.timer.unref?.();
+}
+function handleTerminationSignal(signal) {
+	releaseAllLocksSync();
+	const cleanupState = resolveCleanupState();
+	if (process.listenerCount(signal) === 1) {
+		const handler = cleanupState.cleanupHandlers.get(signal);
+		if (handler) {
+			process.off(signal, handler);
+			cleanupState.cleanupHandlers.delete(signal);
+		}
+		try {
+			process.kill(process.pid, signal);
+		} catch {}
+	}
+}
+function registerCleanupHandlers() {
+	const cleanupState = resolveCleanupState();
+	if (!cleanupState.registered) {
+		cleanupState.registered = true;
+		process.on("exit", () => {
+			releaseAllLocksSync();
+		});
+	}
+	ensureWatchdogStarted(DEFAULT_WATCHDOG_INTERVAL_MS);
+	for (const signal of CLEANUP_SIGNALS) {
+		if (cleanupState.cleanupHandlers.has(signal)) continue;
+		try {
+			const handler = () => handleTerminationSignal(signal);
+			cleanupState.cleanupHandlers.set(signal, handler);
+			process.on(signal, handler);
+		} catch {}
+	}
+}
+async function readLockPayload(lockPath) {
+	try {
+		const raw = await fsp.readFile(lockPath, "utf8");
+		const parsed = JSON.parse(raw);
+		const payload = {};
+		if (typeof parsed.pid === "number") payload.pid = parsed.pid;
+		if (typeof parsed.createdAt === "string") payload.createdAt = parsed.createdAt;
+		return payload;
+	} catch {
+		return null;
+	}
+}
+function inspectLockPayload(payload, staleMs, nowMs) {
+	const pid = typeof payload?.pid === "number" ? payload.pid : null;
+	const pidAlive = pid !== null ? isPidAlive(pid) : false;
+	const createdAt = typeof payload?.createdAt === "string" ? payload.createdAt : null;
+	const createdAtMs = createdAt ? Date.parse(createdAt) : NaN;
+	const ageMs = Number.isFinite(createdAtMs) ? Math.max(0, nowMs - createdAtMs) : null;
+	const staleReasons = [];
+	if (pid === null) staleReasons.push("missing-pid");
+	else if (!pidAlive) staleReasons.push("dead-pid");
+	if (ageMs === null) staleReasons.push("invalid-createdAt");
+	else if (ageMs > staleMs) staleReasons.push("too-old");
+	return {
+		pid,
+		pidAlive,
+		createdAt,
+		ageMs,
+		stale: staleReasons.length > 0,
+		staleReasons
+	};
+}
+function lockInspectionNeedsMtimeStaleFallback(details) {
+	return details.stale && details.staleReasons.every((reason) => reason === "missing-pid" || reason === "invalid-createdAt");
+}
+async function shouldReclaimContendedLockFile(lockPath, details, staleMs, nowMs) {
+	if (!details.stale) return false;
+	if (!lockInspectionNeedsMtimeStaleFallback(details)) return true;
+	try {
+		const stat = await fsp.stat(lockPath);
+		return Math.max(0, nowMs - stat.mtimeMs) > staleMs;
+	} catch (error) {
+		return error?.code !== "ENOENT";
+	}
+}
+async function cleanStaleLockFiles(params) {
+	const sessionsDir = path.resolve(params.sessionsDir);
+	const staleMs = resolvePositiveMs(params.staleMs, DEFAULT_STALE_MS);
+	const removeStale = params.removeStale !== false;
+	const nowMs = params.nowMs ?? Date.now();
+	let entries = [];
+	try {
+		entries = await fsp.readdir(sessionsDir, { withFileTypes: true });
+	} catch (err) {
+		if (err.code === "ENOENT") return {
+			locks: [],
+			cleaned: []
+		};
+		throw err;
+	}
+	const locks = [];
+	const cleaned = [];
+	const lockEntries = entries.filter((entry) => entry.name.endsWith(".jsonl.lock")).toSorted((a, b) => a.name.localeCompare(b.name));
+	for (const entry of lockEntries) {
+		const lockPath = path.join(sessionsDir, entry.name);
+		const lockInfo = {
+			lockPath,
+			...inspectLockPayload(await readLockPayload(lockPath), staleMs, nowMs),
+			removed: false
+		};
+		if (lockInfo.stale && removeStale) {
+			await fsp.rm(lockPath, { force: true });
+			lockInfo.removed = true;
+			cleaned.push(lockInfo);
+			params.log?.warn?.(`removed stale session lock: ${lockPath} (${lockInfo.staleReasons.join(", ") || "unknown"})`);
+		}
+		locks.push(lockInfo);
+	}
+	return {
+		locks,
+		cleaned
+	};
+}
+async function acquireSessionWriteLock(params) {
+	registerCleanupHandlers();
+	const timeoutMs = resolvePositiveMs(params.timeoutMs, 1e4, { allowInfinity: true });
+	const staleMs = resolvePositiveMs(params.staleMs, DEFAULT_STALE_MS);
+	const maxHoldMs = resolvePositiveMs(params.maxHoldMs, DEFAULT_MAX_HOLD_MS);
+	const sessionFile = path.resolve(params.sessionFile);
+	const sessionDir = path.dirname(sessionFile);
+	await fsp.mkdir(sessionDir, { recursive: true });
+	let normalizedDir = sessionDir;
+	try {
+		normalizedDir = await fsp.realpath(sessionDir);
+	} catch {}
+	const normalizedSessionFile = path.join(normalizedDir, path.basename(sessionFile));
+	const lockPath = `${normalizedSessionFile}.lock`;
+	const allowReentrant = params.allowReentrant ?? true;
+	const held = HELD_LOCKS.get(normalizedSessionFile);
+	if (allowReentrant && held) {
+		held.count += 1;
+		return { release: async () => {
+			await releaseHeldLock(normalizedSessionFile, held);
+		} };
+	}
+	const startedAt = Date.now();
+	let attempt = 0;
+	while (Date.now() - startedAt < timeoutMs) {
+		attempt += 1;
+		let handle = null;
+		try {
+			handle = await fsp.open(lockPath, "wx");
+			const createdAt = (/* @__PURE__ */ new Date()).toISOString();
+			await handle.writeFile(JSON.stringify({
+				pid: process.pid,
+				createdAt
+			}, null, 2), "utf8");
+			const createdHeld = {
+				count: 1,
+				handle,
+				lockPath,
+				acquiredAt: Date.now(),
+				maxHoldMs
+			};
+			HELD_LOCKS.set(normalizedSessionFile, createdHeld);
+			return { release: async () => {
+				await releaseHeldLock(normalizedSessionFile, createdHeld);
+			} };
+		} catch (err) {
+			if (handle) {
+				try {
+					await handle.close();
+				} catch {}
+				try {
+					await fsp.rm(lockPath, { force: true });
+				} catch {}
+			}
+			if (err.code !== "EEXIST") throw err;
+			const payload = await readLockPayload(lockPath);
+			const nowMs = Date.now();
+			if (await shouldReclaimContendedLockFile(lockPath, inspectLockPayload(payload, staleMs, nowMs), staleMs, nowMs)) {
+				await fsp.rm(lockPath, { force: true });
+				continue;
+			}
+			const delay = Math.min(1e3, 50 * attempt);
+			await new Promise((r) => setTimeout(r, delay));
+		}
+	}
+	const payload = await readLockPayload(lockPath);
+	const owner = typeof payload?.pid === "number" ? `pid=${payload.pid}` : "unknown";
+	throw new Error(`session file locked (timeout ${timeoutMs}ms): ${owner} ${lockPath}`);
+}
+const __testing = {
+	cleanupSignals: [...CLEANUP_SIGNALS],
+	handleTerminationSignal,
+	releaseAllLocksSync,
+	runLockWatchdogCheck
+};
+
+//#endregion
+//#region src/utils/directive-tags.ts
+const AUDIO_TAG_RE = /\[\[\s*audio_as_voice\s*\]\]/gi;
+const REPLY_TAG_RE = /\[\[\s*(?:reply_to_current|reply_to\s*:\s*([^\]\n]+))\s*\]\]/gi;
+function normalizeDirectiveWhitespace(text) {
+	return text.replace(/[ \t]+/g, " ").replace(/[ \t]*\n[ \t]*/g, "\n").trim();
+}
+function stripInlineDirectiveTagsForDisplay(text) {
+	if (!text) return {
+		text,
+		changed: false
+	};
+	const stripped = text.replace(AUDIO_TAG_RE, "").replace(REPLY_TAG_RE, "");
+	return {
+		text: stripped,
+		changed: stripped !== text
+	};
+}
+function isMessageTextPart(part) {
+	return Boolean(part) && part?.type === "text" && typeof part.text === "string";
+}
+/**
+* Strips inline directive tags from message text blocks while preserving message shape.
+* Empty post-strip text stays empty-string to preserve caller semantics.
+*/
+function stripInlineDirectiveTagsFromMessageForDisplay(message) {
+	if (!message) return message;
+	if (!Array.isArray(message.content)) return message;
+	const cleaned = message.content.map((part) => {
+		if (!part || typeof part !== "object") return part;
+		const record = part;
+		if (!isMessageTextPart(record)) return part;
+		return {
+			...record,
+			text: stripInlineDirectiveTagsForDisplay(record.text).text
+		};
+	});
+	return {
+		...message,
+		content: cleaned
+	};
+}
+function parseInlineDirectives(text, options = {}) {
+	const { currentMessageId, stripAudioTag = true, stripReplyTags = true } = options;
+	if (!text) return {
+		text: "",
+		audioAsVoice: false,
+		replyToCurrent: false,
+		hasAudioTag: false,
+		hasReplyTag: false
+	};
+	let cleaned = text;
+	let audioAsVoice = false;
+	let hasAudioTag = false;
+	let hasReplyTag = false;
+	let sawCurrent = false;
+	let lastExplicitId;
+	cleaned = cleaned.replace(AUDIO_TAG_RE, (match) => {
+		audioAsVoice = true;
+		hasAudioTag = true;
+		return stripAudioTag ? " " : match;
+	});
+	cleaned = cleaned.replace(REPLY_TAG_RE, (match, idRaw) => {
+		hasReplyTag = true;
+		if (idRaw === void 0) sawCurrent = true;
+		else {
+			const id = idRaw.trim();
+			if (id) lastExplicitId = id;
+		}
+		return stripReplyTags ? " " : match;
+	});
+	cleaned = normalizeDirectiveWhitespace(cleaned);
+	const replyToId = lastExplicitId ?? (sawCurrent ? currentMessageId?.trim() || void 0 : void 0);
+	return {
+		text: cleaned,
+		audioAsVoice,
+		replyToId,
+		replyToExplicitId: lastExplicitId,
+		replyToCurrent: sawCurrent,
+		hasAudioTag,
+		hasReplyTag
+	};
+}
+
+//#endregion
+//#region src/gateway/chat-sanitize.ts
+function stripEnvelopeFromContentWithRole(content, stripUserEnvelope) {
+	let changed = false;
+	return {
+		content: content.map((item) => {
+			if (!item || typeof item !== "object") return item;
+			const entry = item;
+			if (entry.type !== "text" || typeof entry.text !== "string") return item;
+			const inboundStripped = stripInboundMetadata(entry.text);
+			const stripped = stripUserEnvelope ? stripMessageIdHints(stripEnvelope(inboundStripped)) : inboundStripped;
+			if (stripped === entry.text) return item;
+			changed = true;
+			return {
+				...entry,
+				text: stripped
+			};
+		}),
+		changed
+	};
+}
+function stripEnvelopeFromMessage(message) {
+	if (!message || typeof message !== "object") return message;
+	const entry = message;
+	const stripUserEnvelope = (typeof entry.role === "string" ? entry.role.toLowerCase() : "") === "user";
+	let changed = false;
+	const next = { ...entry };
+	if (typeof entry.content === "string") {
+		const inboundStripped = stripInboundMetadata(entry.content);
+		const stripped = stripUserEnvelope ? stripMessageIdHints(stripEnvelope(inboundStripped)) : inboundStripped;
+		if (stripped !== entry.content) {
+			next.content = stripped;
+			changed = true;
+		}
+	} else if (Array.isArray(entry.content)) {
+		const updated = stripEnvelopeFromContentWithRole(entry.content, stripUserEnvelope);
+		if (updated.changed) {
+			next.content = updated.content;
+			changed = true;
+		}
+	} else if (typeof entry.text === "string") {
+		const inboundStripped = stripInboundMetadata(entry.text);
+		const stripped = stripUserEnvelope ? stripMessageIdHints(stripEnvelope(inboundStripped)) : inboundStripped;
+		if (stripped !== entry.text) {
+			next.text = stripped;
+			changed = true;
+		}
+	}
+	return changed ? next : message;
+}
+function stripEnvelopeFromMessages(messages) {
+	if (messages.length === 0) return messages;
+	let changed = false;
+	const next = messages.map((message) => {
+		const stripped = stripEnvelopeFromMessage(message);
+		if (stripped !== message) changed = true;
+		return stripped;
+	});
+	return changed ? next : messages;
+}
+
+//#endregion
+//#region src/gateway/session-utils.fs.ts
+const sessionTitleFieldsCache = /* @__PURE__ */ new Map();
+const MAX_SESSION_TITLE_FIELDS_CACHE_ENTRIES = 5e3;
+function readSessionTitleFieldsCacheKey(filePath, opts) {
+	return `${filePath}\t${opts?.includeInterSession === true ? "1" : "0"}`;
+}
+function getCachedSessionTitleFields(cacheKey, stat) {
+	const cached = sessionTitleFieldsCache.get(cacheKey);
+	if (!cached) return null;
+	if (cached.mtimeMs !== stat.mtimeMs || cached.size !== stat.size) {
+		sessionTitleFieldsCache.delete(cacheKey);
+		return null;
+	}
+	sessionTitleFieldsCache.delete(cacheKey);
+	sessionTitleFieldsCache.set(cacheKey, cached);
+	return {
+		firstUserMessage: cached.firstUserMessage,
+		lastMessagePreview: cached.lastMessagePreview
+	};
+}
+function setCachedSessionTitleFields(cacheKey, stat, value) {
+	sessionTitleFieldsCache.set(cacheKey, {
+		...value,
+		mtimeMs: stat.mtimeMs,
+		size: stat.size
+	});
+	while (sessionTitleFieldsCache.size > MAX_SESSION_TITLE_FIELDS_CACHE_ENTRIES) {
+		const oldestKey = sessionTitleFieldsCache.keys().next().value;
+		if (typeof oldestKey !== "string" || !oldestKey) break;
+		sessionTitleFieldsCache.delete(oldestKey);
+	}
+}
+function readSessionMessages(sessionId, storePath, sessionFile) {
+	const filePath = resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile).find((p) => fs.existsSync(p));
+	if (!filePath) return [];
+	const lines = fs.readFileSync(filePath, "utf-8").split(/\r?\n/);
+	const messages = [];
+	for (const line of lines) {
+		if (!line.trim()) continue;
+		try {
+			const parsed = JSON.parse(line);
+			if (parsed?.message) {
+				messages.push(parsed.message);
+				continue;
+			}
+			if (parsed?.type === "compaction") {
+				const ts = typeof parsed.timestamp === "string" ? Date.parse(parsed.timestamp) : NaN;
+				const timestamp = Number.isFinite(ts) ? ts : Date.now();
+				messages.push({
+					role: "system",
+					content: [{
+						type: "text",
+						text: "Compaction"
+					}],
+					timestamp,
+					__remoteclaw: {
+						kind: "compaction",
+						id: typeof parsed.id === "string" ? parsed.id : void 0
+					}
+				});
+			}
+		} catch {}
+	}
+	return messages;
+}
+function resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile, agentId) {
+	const candidates = [];
+	const pushCandidate = (resolve) => {
+		try {
+			candidates.push(resolve());
+		} catch {}
+	};
+	if (storePath) {
+		const sessionsDir = path.dirname(storePath);
+		if (sessionFile) pushCandidate(() => resolveSessionFilePath(sessionId, { sessionFile }, {
+			sessionsDir,
+			agentId
+		}));
+		pushCandidate(() => resolveSessionTranscriptPathInDir(sessionId, sessionsDir));
+	} else if (sessionFile) if (agentId) pushCandidate(() => resolveSessionFilePath(sessionId, { sessionFile }, { agentId }));
+	else {
+		const trimmed = sessionFile.trim();
+		if (trimmed) candidates.push(path.resolve(trimmed));
+	}
+	if (agentId) pushCandidate(() => resolveSessionTranscriptPath(sessionId, agentId));
+	const home = resolveRequiredHomeDir(process.env, os.homedir);
+	const legacyDir = path.join(home, ".remoteclaw", "sessions");
+	pushCandidate(() => resolveSessionTranscriptPathInDir(sessionId, legacyDir));
+	return Array.from(new Set(candidates));
+}
+function canonicalizePathForComparison$1(filePath) {
+	const resolved = path.resolve(filePath);
+	try {
+		return fs.realpathSync(resolved);
+	} catch {
+		return resolved;
+	}
+}
+function archiveFileOnDisk(filePath, reason) {
+	const archived = `${filePath}.${reason}.${formatSessionArchiveTimestamp()}`;
+	fs.renameSync(filePath, archived);
+	return archived;
+}
+/**
+* Archives all transcript files for a given session.
+* Best-effort: silently skips files that don't exist or fail to rename.
+*/
+function archiveSessionTranscripts(opts) {
+	const archived = [];
+	const storeDir = opts.restrictToStoreDir && opts.storePath ? canonicalizePathForComparison$1(path.dirname(opts.storePath)) : null;
+	for (const candidate of resolveSessionTranscriptCandidates(opts.sessionId, opts.storePath, opts.sessionFile, opts.agentId)) {
+		const candidatePath = canonicalizePathForComparison$1(candidate);
+		if (storeDir) {
+			const relative = path.relative(storeDir, candidatePath);
+			if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) continue;
+		}
+		if (!fs.existsSync(candidatePath)) continue;
+		try {
+			archived.push(archiveFileOnDisk(candidatePath, opts.reason));
+		} catch {}
+	}
+	return archived;
+}
+async function cleanupArchivedSessionTranscripts(opts) {
+	if (!Number.isFinite(opts.olderThanMs) || opts.olderThanMs < 0) return {
+		removed: 0,
+		scanned: 0
+	};
+	const now = opts.nowMs ?? Date.now();
+	const reason = opts.reason ?? "deleted";
+	const directories = Array.from(new Set(opts.directories.map((dir) => path.resolve(dir))));
+	let removed = 0;
+	let scanned = 0;
+	for (const dir of directories) {
+		const entries = await fs.promises.readdir(dir).catch(() => []);
+		for (const entry of entries) {
+			const timestamp = parseSessionArchiveTimestamp(entry, reason);
+			if (timestamp == null) continue;
+			scanned += 1;
+			if (now - timestamp <= opts.olderThanMs) continue;
+			const fullPath = path.join(dir, entry);
+			if (!(await fs.promises.stat(fullPath).catch(() => null))?.isFile()) continue;
+			await fs.promises.rm(fullPath).catch(() => void 0);
+			removed += 1;
+		}
+	}
+	return {
+		removed,
+		scanned
+	};
+}
+function jsonUtf8Bytes(value) {
+	try {
+		return Buffer.byteLength(JSON.stringify(value), "utf8");
+	} catch {
+		return Buffer.byteLength(String(value), "utf8");
+	}
+}
+function capArrayByJsonBytes(items, maxBytes) {
+	if (items.length === 0) return {
+		items,
+		bytes: 2
+	};
+	const parts = items.map((item) => jsonUtf8Bytes(item));
+	let bytes = 2 + parts.reduce((a, b) => a + b, 0) + (items.length - 1);
+	let start = 0;
+	while (bytes > maxBytes && start < items.length - 1) {
+		bytes -= parts[start] + 1;
+		start += 1;
+	}
+	return {
+		items: start > 0 ? items.slice(start) : items,
+		bytes
+	};
+}
+const MAX_LINES_TO_SCAN = 10;
+function readSessionTitleFieldsFromTranscript(sessionId, storePath, sessionFile, agentId, opts) {
+	const filePath = resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile, agentId).find((p) => fs.existsSync(p));
+	if (!filePath) return {
+		firstUserMessage: null,
+		lastMessagePreview: null
+	};
+	let stat;
+	try {
+		stat = fs.statSync(filePath);
+	} catch {
+		return {
+			firstUserMessage: null,
+			lastMessagePreview: null
+		};
+	}
+	const cacheKey = readSessionTitleFieldsCacheKey(filePath, opts);
+	const cached = getCachedSessionTitleFields(cacheKey, stat);
+	if (cached) return cached;
+	if (stat.size === 0) {
+		const empty = {
+			firstUserMessage: null,
+			lastMessagePreview: null
+		};
+		setCachedSessionTitleFields(cacheKey, stat, empty);
+		return empty;
+	}
+	let fd = null;
+	try {
+		fd = fs.openSync(filePath, "r");
+		const size = stat.size;
+		let firstUserMessage = null;
+		try {
+			const chunk = readTranscriptHeadChunk(fd);
+			if (chunk) firstUserMessage = extractFirstUserMessageFromTranscriptChunk(chunk, opts);
+		} catch {}
+		let lastMessagePreview = null;
+		try {
+			lastMessagePreview = readLastMessagePreviewFromOpenTranscript({
+				fd,
+				size
+			});
+		} catch {}
+		const result = {
+			firstUserMessage,
+			lastMessagePreview
+		};
+		setCachedSessionTitleFields(cacheKey, stat, result);
+		return result;
+	} catch {
+		return {
+			firstUserMessage: null,
+			lastMessagePreview: null
+		};
+	} finally {
+		if (fd !== null) try {
+			fs.closeSync(fd);
+		} catch {}
+	}
+}
+function extractTextFromContent(content) {
+	if (typeof content === "string") return stripInlineDirectiveTagsForDisplay(content).text.trim() || null;
+	if (!Array.isArray(content)) return null;
+	for (const part of content) {
+		if (!part || typeof part.text !== "string") continue;
+		if (part.type === "text" || part.type === "output_text" || part.type === "input_text") {
+			const normalized = stripInlineDirectiveTagsForDisplay(part.text).text.trim();
+			if (normalized) return normalized;
+		}
+	}
+	return null;
+}
+function readTranscriptHeadChunk(fd, maxBytes = 8192) {
+	const buf = Buffer.alloc(maxBytes);
+	const bytesRead = fs.readSync(fd, buf, 0, buf.length, 0);
+	if (bytesRead <= 0) return null;
+	return buf.toString("utf-8", 0, bytesRead);
+}
+function extractFirstUserMessageFromTranscriptChunk(chunk, opts) {
+	const lines = chunk.split(/\r?\n/).slice(0, MAX_LINES_TO_SCAN);
+	for (const line of lines) {
+		if (!line.trim()) continue;
+		try {
+			const msg = JSON.parse(line)?.message;
+			if (msg?.role !== "user") continue;
+			if (opts?.includeInterSession !== true && hasInterSessionUserProvenance(msg)) continue;
+			const text = extractTextFromContent(msg.content);
+			if (text) return text;
+		} catch {}
+	}
+	return null;
+}
+const LAST_MSG_MAX_BYTES = 16384;
+const LAST_MSG_MAX_LINES = 20;
+function readLastMessagePreviewFromOpenTranscript(params) {
+	const readStart = Math.max(0, params.size - LAST_MSG_MAX_BYTES);
+	const readLen = Math.min(params.size, LAST_MSG_MAX_BYTES);
+	const buf = Buffer.alloc(readLen);
+	fs.readSync(params.fd, buf, 0, readLen, readStart);
+	const tailLines = buf.toString("utf-8").split(/\r?\n/).filter((l) => l.trim()).slice(-LAST_MSG_MAX_LINES);
+	for (let i = tailLines.length - 1; i >= 0; i--) {
+		const line = tailLines[i];
+		try {
+			const msg = JSON.parse(line)?.message;
+			if (msg?.role !== "user" && msg?.role !== "assistant") continue;
+			const text = extractTextFromContent(msg.content);
+			if (text) return text;
+		} catch {}
+	}
+	return null;
+}
+const PREVIEW_READ_SIZES = [
+	64 * 1024,
+	256 * 1024,
+	1024 * 1024
+];
+const PREVIEW_MAX_LINES = 200;
+function normalizeRole(role, isTool) {
+	if (isTool) return "tool";
+	switch ((role ?? "").toLowerCase()) {
+		case "user": return "user";
+		case "assistant": return "assistant";
+		case "system": return "system";
+		case "tool": return "tool";
+		default: return "other";
+	}
+}
+function truncatePreviewText(text, maxChars) {
+	if (maxChars <= 0 || text.length <= maxChars) return text;
+	if (maxChars <= 3) return text.slice(0, maxChars);
+	return `${text.slice(0, maxChars - 3)}...`;
+}
+function extractPreviewText(message) {
+	if (typeof message.content === "string") {
+		const normalized = stripInlineDirectiveTagsForDisplay(message.content).text.trim();
+		return normalized ? normalized : null;
+	}
+	if (Array.isArray(message.content)) {
+		const parts = message.content.map((entry) => typeof entry?.text === "string" ? stripInlineDirectiveTagsForDisplay(entry.text).text : "").filter((text) => text.trim().length > 0);
+		if (parts.length > 0) return parts.join("\n").trim();
+	}
+	if (typeof message.text === "string") {
+		const normalized = stripInlineDirectiveTagsForDisplay(message.text).text.trim();
+		return normalized ? normalized : null;
+	}
+	return null;
+}
+function isToolCall(message) {
+	return hasToolCall(message);
+}
+function extractToolNames(message) {
+	return extractToolCallNames(message);
+}
+function extractMediaSummary(message) {
+	if (!Array.isArray(message.content)) return null;
+	for (const entry of message.content) {
+		const raw = typeof entry?.type === "string" ? entry.type.trim().toLowerCase() : "";
+		if (!raw || raw === "text" || raw === "toolcall" || raw === "tool_call") continue;
+		return `[${raw}]`;
+	}
+	return null;
+}
+function buildPreviewItems(messages, maxItems, maxChars) {
+	const items = [];
+	for (const message of messages) {
+		const toolCall = isToolCall(message);
+		const role = normalizeRole(message.role, toolCall);
+		let text = extractPreviewText(message);
+		if (!text) {
+			const toolNames = extractToolNames(message);
+			if (toolNames.length > 0) {
+				const shown = toolNames.slice(0, 2);
+				const overflow = toolNames.length - shown.length;
+				text = `call ${shown.join(", ")}`;
+				if (overflow > 0) text += ` +${overflow}`;
+			}
+		}
+		if (!text) text = extractMediaSummary(message);
+		if (!text) continue;
+		let trimmed = text.trim();
+		if (!trimmed) continue;
+		if (role === "user") trimmed = stripEnvelope(trimmed);
+		trimmed = truncatePreviewText(trimmed, maxChars);
+		items.push({
+			role,
+			text: trimmed
+		});
+	}
+	if (items.length <= maxItems) return items;
+	return items.slice(-maxItems);
+}
+function readRecentMessagesFromTranscript(filePath, maxMessages, readBytes) {
+	let fd = null;
+	try {
+		fd = fs.openSync(filePath, "r");
+		const size = fs.fstatSync(fd).size;
+		if (size === 0) return [];
+		const readStart = Math.max(0, size - readBytes);
+		const readLen = Math.min(size, readBytes);
+		const buf = Buffer.alloc(readLen);
+		fs.readSync(fd, buf, 0, readLen, readStart);
+		const tailLines = buf.toString("utf-8").split(/\r?\n/).filter((l) => l.trim()).slice(-PREVIEW_MAX_LINES);
+		const collected = [];
+		for (let i = tailLines.length - 1; i >= 0; i--) {
+			const line = tailLines[i];
+			try {
+				const msg = JSON.parse(line)?.message;
+				if (msg && typeof msg === "object") {
+					collected.push(msg);
+					if (collected.length >= maxMessages) break;
+				}
+			} catch {}
+		}
+		return collected.toReversed();
+	} catch {
+		return [];
+	} finally {
+		if (fd !== null) fs.closeSync(fd);
+	}
+}
+function readSessionPreviewItemsFromTranscript(sessionId, storePath, sessionFile, agentId, maxItems, maxChars) {
+	const filePath = resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile, agentId).find((p) => fs.existsSync(p));
+	if (!filePath) return [];
+	const boundedItems = Math.max(1, Math.min(maxItems, 50));
+	const boundedChars = Math.max(20, Math.min(maxChars, 2e3));
+	for (const readSize of PREVIEW_READ_SIZES) {
+		const messages = readRecentMessagesFromTranscript(filePath, boundedItems, readSize);
+		if (messages.length > 0 || readSize === PREVIEW_READ_SIZES[PREVIEW_READ_SIZES.length - 1]) return buildPreviewItems(messages, boundedItems, boundedChars);
+	}
+	return [];
+}
+
+//#endregion
+//#region src/utils/account-id.ts
+function normalizeAccountId(value) {
+	return normalizeOptionalAccountId(value);
+}
+
+//#endregion
+//#region src/utils/delivery-context.ts
+function normalizeDeliveryContext(context) {
+	if (!context) return;
+	const channel = typeof context.channel === "string" ? normalizeMessageChannel(context.channel) ?? context.channel.trim() : void 0;
+	const to = typeof context.to === "string" ? context.to.trim() : void 0;
+	const accountId = normalizeAccountId(context.accountId);
+	const threadId = typeof context.threadId === "number" && Number.isFinite(context.threadId) ? Math.trunc(context.threadId) : typeof context.threadId === "string" ? context.threadId.trim() : void 0;
+	const normalizedThreadId = typeof threadId === "string" ? threadId ? threadId : void 0 : threadId;
+	if (!channel && !to && !accountId && normalizedThreadId == null) return;
+	const normalized = {
+		channel: channel || void 0,
+		to: to || void 0,
+		accountId
+	};
+	if (normalizedThreadId != null) normalized.threadId = normalizedThreadId;
+	return normalized;
+}
+function normalizeSessionDeliveryFields(source) {
+	if (!source) return {
+		deliveryContext: void 0,
+		lastChannel: void 0,
+		lastTo: void 0,
+		lastAccountId: void 0,
+		lastThreadId: void 0
+	};
+	const merged = mergeDeliveryContext(normalizeDeliveryContext({
+		channel: source.lastChannel ?? source.channel,
+		to: source.lastTo,
+		accountId: source.lastAccountId,
+		threadId: source.lastThreadId
+	}), normalizeDeliveryContext(source.deliveryContext));
+	if (!merged) return {
+		deliveryContext: void 0,
+		lastChannel: void 0,
+		lastTo: void 0,
+		lastAccountId: void 0,
+		lastThreadId: void 0
+	};
+	return {
+		deliveryContext: merged,
+		lastChannel: merged.channel,
+		lastTo: merged.to,
+		lastAccountId: merged.accountId,
+		lastThreadId: merged.threadId
+	};
+}
+function deliveryContextFromSession(entry) {
+	if (!entry) return;
+	return normalizeSessionDeliveryFields({
+		channel: entry.channel,
+		lastChannel: entry.lastChannel,
+		lastTo: entry.lastTo,
+		lastAccountId: entry.lastAccountId,
+		lastThreadId: entry.lastThreadId ?? entry.deliveryContext?.threadId ?? entry.origin?.threadId,
+		deliveryContext: entry.deliveryContext
+	}).deliveryContext;
+}
+function mergeDeliveryContext(primary, fallback) {
+	const normalizedPrimary = normalizeDeliveryContext(primary);
+	const normalizedFallback = normalizeDeliveryContext(fallback);
+	if (!normalizedPrimary && !normalizedFallback) return;
+	return normalizeDeliveryContext({
+		channel: normalizedPrimary?.channel ?? normalizedFallback?.channel,
+		to: normalizedPrimary?.to ?? normalizedFallback?.to,
+		accountId: normalizedPrimary?.accountId ?? normalizedFallback?.accountId,
+		threadId: normalizedPrimary?.threadId ?? normalizedFallback?.threadId
+	});
+}
+
+//#endregion
+//#region src/config/cache-utils.ts
+function resolveCacheTtlMs(params) {
+	const { envValue, defaultTtlMs } = params;
+	if (envValue) {
+		const parsed = Number.parseInt(envValue, 10);
+		if (Number.isFinite(parsed) && parsed >= 0) return parsed;
+	}
+	return defaultTtlMs;
+}
+function isCacheEnabled(ttlMs) {
+	return ttlMs > 0;
+}
+function getFileMtimeMs(filePath) {
+	try {
+		return fs.statSync(filePath).mtimeMs;
+	} catch {
+		return;
+	}
+}
+
+//#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$1(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 = params.activeSessionKey?.trim().toLowerCase();
+		const sessionIdRefCounts = buildSessionIdRefCounts(params.store);
+		const entryChunkBytesByKey = buildStoreEntryChunkSizeMap(params.store);
+		const keys = Object.keys(params.store).toSorted((a, b) => {
+			return getEntryUpdatedAt$1(params.store[a]) - getEntryUpdatedAt$1(params.store[b]);
+		});
+		for (const key of keys) {
+			if (total <= highWaterBytes) break;
+			if (activeSessionKey && key.trim().toLowerCase() === 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.ts
+const log = createSubsystemLogger("sessions/store");
+const SESSION_STORE_CACHE = /* @__PURE__ */ new Map();
+const DEFAULT_SESSION_STORE_TTL_MS = 45e3;
+function isSessionStoreRecord(value) {
+	return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function getSessionStoreTtl() {
+	return resolveCacheTtlMs({
+		envValue: process.env.REMOTECLAW_SESSION_CACHE_TTL_MS,
+		defaultTtlMs: DEFAULT_SESSION_STORE_TTL_MS
+	});
+}
+function isSessionStoreCacheEnabled() {
+	return isCacheEnabled(getSessionStoreTtl());
+}
+function isSessionStoreCacheValid(entry) {
+	const now = Date.now();
+	const ttl = getSessionStoreTtl();
+	return now - entry.loadedAt <= ttl;
+}
+function invalidateSessionStoreCache(storePath) {
+	SESSION_STORE_CACHE.delete(storePath);
+}
+function normalizeSessionEntryDelivery(entry) {
+	const normalized = normalizeSessionDeliveryFields({
+		channel: entry.channel,
+		lastChannel: entry.lastChannel,
+		lastTo: entry.lastTo,
+		lastAccountId: entry.lastAccountId,
+		lastThreadId: entry.lastThreadId ?? entry.deliveryContext?.threadId ?? entry.origin?.threadId,
+		deliveryContext: entry.deliveryContext
+	});
+	const nextDelivery = normalized.deliveryContext;
+	const sameDelivery = (entry.deliveryContext?.channel ?? void 0) === nextDelivery?.channel && (entry.deliveryContext?.to ?? void 0) === nextDelivery?.to && (entry.deliveryContext?.accountId ?? void 0) === nextDelivery?.accountId && (entry.deliveryContext?.threadId ?? void 0) === nextDelivery?.threadId;
+	const sameLast = entry.lastChannel === normalized.lastChannel && entry.lastTo === normalized.lastTo && entry.lastAccountId === normalized.lastAccountId && entry.lastThreadId === normalized.lastThreadId;
+	if (sameDelivery && sameLast) return entry;
+	return {
+		...entry,
+		deliveryContext: nextDelivery,
+		lastChannel: normalized.lastChannel,
+		lastTo: normalized.lastTo,
+		lastAccountId: normalized.lastAccountId,
+		lastThreadId: normalized.lastThreadId
+	};
+}
+function removeThreadFromDeliveryContext(context) {
+	if (!context || context.threadId == null) return context;
+	const next = { ...context };
+	delete next.threadId;
+	return next;
+}
+function normalizeStoreSessionKey(sessionKey) {
+	return sessionKey.trim().toLowerCase();
+}
+function resolveStoreSessionEntry(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 (candidateKey.toLowerCase() !== normalizedKey) continue;
+		legacyKeySet.add(candidateKey);
+		const candidateUpdatedAt = candidateEntry?.updatedAt ?? 0;
+		if (!existing || candidateUpdatedAt > existingUpdatedAt) {
+			existing = candidateEntry;
+			existingUpdatedAt = candidateUpdatedAt;
+		}
+	}
+	return {
+		normalizedKey,
+		existing,
+		legacyKeys: [...legacyKeySet]
+	};
+}
+function normalizeSessionStore(store) {
+	for (const [key, entry] of Object.entries(store)) {
+		if (!entry) continue;
+		const normalized = normalizeSessionEntryDelivery(normalizeSessionRuntimeModelFields(entry));
+		if (normalized !== entry) store[key] = normalized;
+	}
+}
+function clearSessionStoreCacheForTest() {
+	SESSION_STORE_CACHE.clear();
+	for (const queue of LOCK_QUEUES.values()) for (const task of queue.pending) task.reject(/* @__PURE__ */ new Error("session store queue cleared for test"));
+	LOCK_QUEUES.clear();
+}
+/** Expose lock queue size for tests. */
+function getSessionStoreLockQueueSizeForTest() {
+	return LOCK_QUEUES.size;
+}
+async function withSessionStoreLockForTest(storePath, fn, opts = {}) {
+	return await withSessionStoreLock(storePath, fn, opts);
+}
+function loadSessionStore(storePath, opts = {}) {
+	if (!opts.skipCache && isSessionStoreCacheEnabled()) {
+		const cached = SESSION_STORE_CACHE.get(storePath);
+		if (cached && isSessionStoreCacheValid(cached)) {
+			if (getFileMtimeMs(storePath) === cached.mtimeMs) return structuredClone(cached.store);
+			invalidateSessionStoreCache(storePath);
+		}
+	}
+	let store = {};
+	let mtimeMs = getFileMtimeMs(storePath);
+	const maxReadAttempts = process.platform === "win32" ? 3 : 1;
+	const retryBuf = maxReadAttempts > 1 ? new Int32Array(new SharedArrayBuffer(4)) : void 0;
+	for (let attempt = 0; attempt < maxReadAttempts; attempt++) try {
+		const raw = fs.readFileSync(storePath, "utf-8");
+		if (raw.length === 0 && attempt < maxReadAttempts - 1) {
+			Atomics.wait(retryBuf, 0, 0, 50);
+			continue;
+		}
+		const parsed = JSON.parse(raw);
+		if (isSessionStoreRecord(parsed)) store = parsed;
+		mtimeMs = getFileMtimeMs(storePath) ?? mtimeMs;
+		break;
+	} catch {
+		if (attempt < maxReadAttempts - 1) {
+			Atomics.wait(retryBuf, 0, 0, 50);
+			continue;
+		}
+	}
+	for (const entry of Object.values(store)) {
+		if (!entry || typeof entry !== "object") continue;
+		const rec = entry;
+		if (typeof rec.channel !== "string" && typeof rec.provider === "string") {
+			rec.channel = rec.provider;
+			delete rec.provider;
+		}
+		if (typeof rec.lastChannel !== "string" && typeof rec.lastProvider === "string") {
+			rec.lastChannel = rec.lastProvider;
+			delete rec.lastProvider;
+		}
+		if (typeof rec.groupChannel !== "string" && typeof rec.room === "string") {
+			rec.groupChannel = rec.room;
+			delete rec.room;
+		} else if ("room" in rec) delete rec.room;
+	}
+	if (!opts.skipCache && isSessionStoreCacheEnabled()) SESSION_STORE_CACHE.set(storePath, {
+		store: structuredClone(store),
+		loadedAt: Date.now(),
+		storePath,
+		mtimeMs
+	});
+	return structuredClone(store);
+}
+function readSessionUpdatedAt(params) {
+	try {
+		return resolveStoreSessionEntry({
+			store: loadSessionStore(params.storePath),
+			sessionKey: params.sessionKey
+		}).existing?.updatedAt;
+	} catch {
+		return;
+	}
+}
+const DEFAULT_SESSION_PRUNE_AFTER_MS = 720 * 60 * 60 * 1e3;
+const DEFAULT_SESSION_MAX_ENTRIES = 500;
+const DEFAULT_SESSION_ROTATE_BYTES = 10485760;
+const DEFAULT_SESSION_MAINTENANCE_MODE = "warn";
+const DEFAULT_SESSION_DISK_BUDGET_HIGH_WATER_RATIO = .8;
+function resolvePruneAfterMs(maintenance) {
+	const raw = maintenance?.pruneAfter ?? maintenance?.pruneDays;
+	if (raw === void 0 || raw === null || raw === "") return DEFAULT_SESSION_PRUNE_AFTER_MS;
+	try {
+		return parseDurationMs(String(raw).trim(), { defaultUnit: "d" });
+	} catch {
+		return DEFAULT_SESSION_PRUNE_AFTER_MS;
+	}
+}
+function resolveRotateBytes(maintenance) {
+	const raw = maintenance?.rotateBytes;
+	if (raw === void 0 || raw === null || raw === "") return DEFAULT_SESSION_ROTATE_BYTES;
+	try {
+		return parseByteSize(String(raw).trim(), { defaultUnit: "b" });
+	} catch {
+		return DEFAULT_SESSION_ROTATE_BYTES;
+	}
+}
+function resolveResetArchiveRetentionMs(maintenance, pruneAfterMs) {
+	const raw = maintenance?.resetArchiveRetention;
+	if (raw === false) return null;
+	if (raw === void 0 || raw === null || raw === "") return pruneAfterMs;
+	try {
+		return parseDurationMs(String(raw).trim(), { defaultUnit: "d" });
+	} catch {
+		return pruneAfterMs;
+	}
+}
+function resolveMaxDiskBytes(maintenance) {
+	const raw = maintenance?.maxDiskBytes;
+	if (raw === void 0 || raw === null || raw === "") return null;
+	try {
+		return parseByteSize(String(raw).trim(), { defaultUnit: "b" });
+	} catch {
+		return null;
+	}
+}
+function resolveHighWaterBytes(maintenance, maxDiskBytes) {
+	const computeDefault = () => {
+		if (maxDiskBytes == null) return null;
+		if (maxDiskBytes <= 0) return 0;
+		return Math.max(1, Math.min(maxDiskBytes, Math.floor(maxDiskBytes * DEFAULT_SESSION_DISK_BUDGET_HIGH_WATER_RATIO)));
+	};
+	if (maxDiskBytes == null) return null;
+	const raw = maintenance?.highWaterBytes;
+	if (raw === void 0 || raw === null || raw === "") return computeDefault();
+	try {
+		const parsed = parseByteSize(String(raw).trim(), { defaultUnit: "b" });
+		return Math.min(parsed, maxDiskBytes);
+	} catch {
+		return computeDefault();
+	}
+}
+/**
+* Resolve maintenance settings from remoteclaw.json (`session.maintenance`).
+* Falls back to built-in defaults when config is missing or unset.
+*/
+function resolveMaintenanceConfig() {
+	let maintenance;
+	try {
+		maintenance = loadConfig().session?.maintenance;
+	} catch {}
+	const pruneAfterMs = resolvePruneAfterMs(maintenance);
+	const maxDiskBytes = resolveMaxDiskBytes(maintenance);
+	return {
+		mode: maintenance?.mode ?? DEFAULT_SESSION_MAINTENANCE_MODE,
+		pruneAfterMs,
+		maxEntries: maintenance?.maxEntries ?? DEFAULT_SESSION_MAX_ENTRIES,
+		rotateBytes: resolveRotateBytes(maintenance),
+		resetArchiveRetentionMs: resolveResetArchiveRetentionMs(maintenance, pruneAfterMs),
+		maxDiskBytes,
+		highWaterBytes: resolveHighWaterBytes(maintenance, maxDiskBytes)
+	};
+}
+/**
+* Remove entries whose `updatedAt` is older than the configured threshold.
+* Entries without `updatedAt` are kept (cannot determine staleness).
+* Mutates `store` in-place.
+*/
+function pruneStaleEntries(store, overrideMaxAgeMs, opts = {}) {
+	const maxAgeMs = overrideMaxAgeMs ?? resolveMaintenanceConfig().pruneAfterMs;
+	const cutoffMs = Date.now() - maxAgeMs;
+	let pruned = 0;
+	for (const [key, entry] of Object.entries(store)) if (entry?.updatedAt != null && entry.updatedAt < cutoffMs) {
+		opts.onPruned?.({
+			key,
+			entry
+		});
+		delete store[key];
+		pruned++;
+	}
+	if (pruned > 0 && opts.log !== false) log.info("pruned stale session entries", {
+		pruned,
+		maxAgeMs
+	});
+	return pruned;
+}
+/**
+* Cap the store to the N most recently updated entries.
+* Entries without `updatedAt` are sorted last (removed first when over limit).
+* Mutates `store` in-place.
+*/
+function getEntryUpdatedAt(entry) {
+	return entry?.updatedAt ?? Number.NEGATIVE_INFINITY;
+}
+function getActiveSessionMaintenanceWarning(params) {
+	const activeSessionKey = params.activeSessionKey.trim();
+	if (!activeSessionKey) return null;
+	const activeEntry = params.store[activeSessionKey];
+	if (!activeEntry) return null;
+	const cutoffMs = (params.nowMs ?? Date.now()) - params.pruneAfterMs;
+	const wouldPrune = activeEntry.updatedAt != null ? activeEntry.updatedAt < cutoffMs : false;
+	const keys = Object.keys(params.store);
+	const wouldCap = keys.length > params.maxEntries && keys.toSorted((a, b) => getEntryUpdatedAt(params.store[b]) - getEntryUpdatedAt(params.store[a])).slice(params.maxEntries).includes(activeSessionKey);
+	if (!wouldPrune && !wouldCap) return null;
+	return {
+		activeSessionKey,
+		activeUpdatedAt: activeEntry.updatedAt,
+		totalEntries: keys.length,
+		pruneAfterMs: params.pruneAfterMs,
+		maxEntries: params.maxEntries,
+		wouldPrune,
+		wouldCap
+	};
+}
+function capEntryCount(store, overrideMax, opts = {}) {
+	const maxEntries = overrideMax ?? resolveMaintenanceConfig().maxEntries;
+	const keys = Object.keys(store);
+	if (keys.length <= maxEntries) return 0;
+	const toRemove = keys.toSorted((a, b) => {
+		const aTime = getEntryUpdatedAt(store[a]);
+		return getEntryUpdatedAt(store[b]) - aTime;
+	}).slice(maxEntries);
+	for (const key of toRemove) {
+		const entry = store[key];
+		if (entry) opts.onCapped?.({
+			key,
+			entry
+		});
+		delete store[key];
+	}
+	if (opts.log !== false) log.info("capped session entry count", {
+		removed: toRemove.length,
+		maxEntries
+	});
+	return toRemove.length;
+}
+async function getSessionFileSize(storePath) {
+	try {
+		return (await fs.promises.stat(storePath)).size;
+	} catch {
+		return null;
+	}
+}
+/**
+* Rotate the sessions file if it exceeds the configured size threshold.
+* Renames the current file to `sessions.json.bak.{timestamp}` and cleans up
+* old rotation backups, keeping only the 3 most recent `.bak.*` files.
+*/
+async function rotateSessionFile(storePath, overrideBytes) {
+	const maxBytes = overrideBytes ?? resolveMaintenanceConfig().rotateBytes;
+	const fileSize = await getSessionFileSize(storePath);
+	if (fileSize == null) return false;
+	if (fileSize <= maxBytes) return false;
+	const backupPath = `${storePath}.bak.${Date.now()}`;
+	try {
+		await fs.promises.rename(storePath, backupPath);
+		log.info("rotated session store file", {
+			backupPath: path.basename(backupPath),
+			sizeBytes: fileSize
+		});
+	} catch {
+		return false;
+	}
+	try {
+		const dir = path.dirname(storePath);
+		const baseName = path.basename(storePath);
+		const backups = (await fs.promises.readdir(dir)).filter((f) => f.startsWith(`${baseName}.bak.`)).toSorted().toReversed();
+		const maxBackups = 3;
+		if (backups.length > maxBackups) {
+			const toDelete = backups.slice(maxBackups);
+			for (const old of toDelete) await fs.promises.unlink(path.join(dir, old)).catch(() => void 0);
+			log.info("cleaned up old session store backups", { deleted: toDelete.length });
+		}
+	} catch {}
+	return true;
+}
+async function saveSessionStoreUnlocked(storePath, store, opts) {
+	invalidateSessionStoreCache(storePath);
+	normalizeSessionStore(store);
+	if (!opts?.skipMaintenance) {
+		const maintenance = {
+			...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 removedSessionFiles = /* @__PURE__ */ new Map();
+			const pruned = pruneStaleEntries(store, maintenance.pruneAfterMs, { onPruned: ({ entry }) => {
+				if (!removedSessionFiles.has(entry.sessionId) || entry.sessionFile) removedSessionFiles.set(entry.sessionId, entry.sessionFile);
+			} });
+			const capped = capEntryCount(store, maintenance.maxEntries, { onCapped: ({ entry }) => {
+				if (!removedSessionFiles.has(entry.sessionId) || entry.sessionFile) removedSessionFiles.set(entry.sessionId, entry.sessionFile);
+			} });
+			const archivedDirs = /* @__PURE__ */ new Set();
+			const referencedSessionIds = new Set(Object.values(store).map((entry) => entry?.sessionId).filter((id) => Boolean(id)));
+			for (const [sessionId, sessionFile] of removedSessionFiles) {
+				if (referencedSessionIds.has(sessionId)) continue;
+				const archived = archiveSessionTranscripts({
+					sessionId,
+					storePath,
+					sessionFile,
+					reason: "deleted",
+					restrictToStoreDir: true
+				});
+				for (const archivedPath of archived) archivedDirs.add(path.dirname(archivedPath));
+			}
+			if (archivedDirs.size > 0 || maintenance.resetArchiveRetentionMs != null) {
+				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 (process.platform === "win32") {
+		const tmp = `${storePath}.${process.pid}.${crypto.randomUUID()}.tmp`;
+		try {
+			await fs.promises.writeFile(tmp, json, "utf-8");
+			for (let i = 0; i < 5; i++) try {
+				await fs.promises.rename(tmp, storePath);
+				break;
+			} catch {
+				if (i < 4) await new Promise((r) => setTimeout(r, 50 * (i + 1)));
+				if (i === 4) log.warn(`rename failed after 5 attempts: ${storePath}`);
+			}
+		} catch (err) {
+			if ((err && typeof err === "object" && "code" in err ? String(err.code) : null) === "ENOENT") return;
+			throw err;
+		} finally {
+			await fs.promises.rm(tmp, { force: true }).catch(() => void 0);
+		}
+		return;
+	}
+	const tmp = `${storePath}.${process.pid}.${crypto.randomUUID()}.tmp`;
+	try {
+		await fs.promises.writeFile(tmp, json, {
+			mode: 384,
+			encoding: "utf-8"
+		});
+		await fs.promises.rename(tmp, storePath);
+		await fs.promises.chmod(storePath, 384);
+	} catch (err) {
+		if ((err && typeof err === "object" && "code" in err ? String(err.code) : null) === "ENOENT") {
+			try {
+				await fs.promises.mkdir(path.dirname(storePath), { recursive: true });
+				await fs.promises.writeFile(storePath, json, {
+					mode: 384,
+					encoding: "utf-8"
+				});
+				await fs.promises.chmod(storePath, 384);
+			} catch (err2) {
+				if ((err2 && typeof err2 === "object" && "code" in err2 ? String(err2.code) : null) === "ENOENT") return;
+				throw err2;
+			}
+			return;
+		}
+		throw err;
+	} finally {
+		await fs.promises.rm(tmp, { force: true });
+	}
+}
+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 result = await mutator(store);
+		await saveSessionStoreUnlocked(storePath, store, opts);
+		return result;
+	});
+}
+const LOCK_QUEUES = /* @__PURE__ */ new Map();
+function lockTimeoutError(storePath) {
+	return /* @__PURE__ */ new Error(`timeout waiting for session store lock: ${storePath}`);
+}
+function getOrCreateLockQueue(storePath) {
+	const existing = LOCK_QUEUES.get(storePath);
+	if (existing) return existing;
+	const created = {
+		running: false,
+		pending: []
+	};
+	LOCK_QUEUES.set(storePath, created);
+	return created;
+}
+async function drainSessionStoreLockQueue(storePath) {
+	const queue = LOCK_QUEUES.get(storePath);
+	if (!queue || queue.running) return;
+	queue.running = true;
+	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 acquireSessionWriteLock({
+					sessionFile: storePath,
+					timeoutMs: remainingTimeoutMs,
+					staleMs: task.staleMs
+				});
+				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;
+		if (queue.pending.length === 0) LOCK_QUEUES.delete(storePath);
+		else queueMicrotask(() => {
+			drainSessionStoreLockQueue(storePath);
+		});
+	}
+}
+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 = resolveStoreSessionEntry({
+			store,
+			sessionKey
+		});
+		const existing = resolved.existing;
+		if (!existing) return null;
+		const patch = await update(existing);
+		if (!patch) return existing;
+		const next = mergeSessionEntry(existing, patch);
+		store[resolved.normalizedKey] = next;
+		for (const legacyKey of resolved.legacyKeys) delete store[legacyKey];
+		await saveSessionStoreUnlocked(storePath, store, { activeSessionKey: resolved.normalizedKey });
+		return next;
+	});
+}
+async function recordSessionMetaFromInbound(params) {
+	const { storePath, sessionKey, ctx } = params;
+	const createIfMissing = params.createIfMissing ?? true;
+	return await updateSessionStore(storePath, (store) => {
+		const resolved = resolveStoreSessionEntry({
+			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 = 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 = resolveStoreSessionEntry({
+			store,
+			sessionKey
+		});
+		const existing = resolved.existing;
+		const now = Date.now();
+		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 = {
+			updatedAt: Math.max(existing?.updatedAt ?? 0, now),
+			deliveryContext: normalized.deliveryContext,
+			lastChannel: normalized.lastChannel,
+			lastTo: normalized.lastTo,
+			lastAccountId: normalized.lastAccountId,
+			lastThreadId: normalized.lastThreadId
+		};
+		const next = mergeSessionEntry(existing, metaPatch ? {
+			...basePatch,
+			...metaPatch
+		} : basePatch);
+		store[resolved.normalizedKey] = next;
+		for (const legacyKey of resolved.legacyKeys) delete store[legacyKey];
+		await saveSessionStoreUnlocked(storePath, store, { activeSessionKey: resolved.normalizedKey });
+		return next;
+	});
+}
+
+//#endregion
+//#region src/sessions/transcript-events.ts
+const SESSION_TRANSCRIPT_LISTENERS = /* @__PURE__ */ new Set();
+function emitSessionTranscriptUpdate(sessionFile) {
+	const trimmed = sessionFile.trim();
+	if (!trimmed) return;
+	const update = { sessionFile: trimmed };
+	for (const listener of SESSION_TRANSCRIPT_LISTENERS) listener(update);
+}
+
+//#endregion
+//#region src/config/sessions/constants.ts
+/** Session transcript format version (matches pi-coding-agent SessionManager v3 layout). */
+const CURRENT_SESSION_VERSION = 3;
+
+//#endregion
+//#region src/config/sessions/session-file.ts
+async function resolveAndPersistSessionFile(params) {
+	const { sessionId, sessionKey, sessionStore, storePath } = params;
+	const baseEntry = params.sessionEntry ?? sessionStore[sessionKey] ?? {
+		sessionId,
+		updatedAt: Date.now()
+	};
+	const fallbackSessionFile = params.fallbackSessionFile?.trim();
+	const sessionFile = resolveSessionFilePath(sessionId, !baseEntry.sessionFile && fallbackSessionFile ? {
+		...baseEntry,
+		sessionFile: fallbackSessionFile
+	} : baseEntry, {
+		agentId: params.agentId,
+		sessionsDir: params.sessionsDir
+	});
+	const persistedEntry = {
+		...baseEntry,
+		sessionId,
+		updatedAt: Date.now(),
+		sessionFile
+	};
+	if (baseEntry.sessionId !== sessionId || baseEntry.sessionFile !== sessionFile) {
+		sessionStore[sessionKey] = persistedEntry;
+		await updateSessionStore(storePath, (store) => {
+			store[sessionKey] = {
+				...store[sessionKey],
+				...persistedEntry
+			};
+		}, params.activeSessionKey ? { activeSessionKey: params.activeSessionKey } : void 0);
+		return {
+			sessionFile,
+			sessionEntry: persistedEntry
+		};
+	}
+	sessionStore[sessionKey] = persistedEntry;
+	return {
+		sessionFile,
+		sessionEntry: persistedEntry
+	};
+}
+
+//#endregion
+//#region src/config/sessions/transcript.ts
+function stripQuery(value) {
+	const noHash = value.split("#")[0] ?? value;
+	return noHash.split("?")[0] ?? noHash;
+}
+function extractFileNameFromMediaUrl(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return null;
+	const cleaned = stripQuery(trimmed);
+	try {
+		const parsed = new URL(cleaned);
+		const base = path.basename(parsed.pathname);
+		if (!base) return null;
+		try {
+			return decodeURIComponent(base);
+		} catch {
+			return base;
+		}
+	} catch {
+		const base = path.basename(cleaned);
+		if (!base || base === "/" || base === ".") return null;
+		return base;
+	}
+}
+function resolveMirroredTranscriptText(params) {
+	const mediaUrls = params.mediaUrls?.filter((url) => url && url.trim()) ?? [];
+	if (mediaUrls.length > 0) {
+		const names = mediaUrls.map((url) => extractFileNameFromMediaUrl(url)).filter((name) => Boolean(name && name.trim()));
+		if (names.length > 0) return names.join(", ");
+		return "media";
+	}
+	const trimmed = (params.text ?? "").trim();
+	return trimmed ? trimmed : null;
+}
+async function ensureSessionHeader(params) {
+	if (fs.existsSync(params.sessionFile)) return;
+	await fs.promises.mkdir(path.dirname(params.sessionFile), { recursive: true });
+	const header = {
+		type: "session",
+		version: CURRENT_SESSION_VERSION,
+		id: params.sessionId,
+		timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		cwd: process.cwd()
+	};
+	await fs.promises.writeFile(params.sessionFile, `${JSON.stringify(header)}\n`, {
+		encoding: "utf-8",
+		mode: 384
+	});
+}
+async function appendAssistantMessageToSessionTranscript(params) {
+	const sessionKey = params.sessionKey.trim();
+	if (!sessionKey) return {
+		ok: false,
+		reason: "missing sessionKey"
+	};
+	const mirrorText = resolveMirroredTranscriptText({
+		text: params.text,
+		mediaUrls: params.mediaUrls
+	});
+	if (!mirrorText) return {
+		ok: false,
+		reason: "empty text"
+	};
+	const storePath = params.storePath ?? resolveDefaultSessionStorePath(params.agentId);
+	const store = loadSessionStore(storePath, { skipCache: true });
+	const entry = store[sessionKey];
+	if (!entry?.sessionId) return {
+		ok: false,
+		reason: `unknown sessionKey: ${sessionKey}`
+	};
+	let sessionFile;
+	try {
+		sessionFile = (await resolveAndPersistSessionFile({
+			sessionId: entry.sessionId,
+			sessionKey,
+			sessionStore: store,
+			storePath,
+			sessionEntry: entry,
+			agentId: params.agentId,
+			sessionsDir: path.dirname(storePath)
+		})).sessionFile;
+	} catch (err) {
+		return {
+			ok: false,
+			reason: err instanceof Error ? err.message : String(err)
+		};
+	}
+	await ensureSessionHeader({
+		sessionFile,
+		sessionId: entry.sessionId
+	});
+	const line = {
+		type: "message",
+		message: {
+			role: "assistant",
+			content: [{
+				type: "text",
+				text: mirrorText
+			}],
+			api: "openai-responses",
+			provider: "remoteclaw",
+			model: "delivery-mirror",
+			usage: {
+				input: 0,
+				output: 0,
+				cacheRead: 0,
+				cacheWrite: 0,
+				totalTokens: 0,
+				cost: {
+					input: 0,
+					output: 0,
+					cacheRead: 0,
+					cacheWrite: 0,
+					total: 0
+				}
+			},
+			stopReason: "stop",
+			timestamp: Date.now()
+		}
+	};
+	await fs.promises.appendFile(sessionFile, `${JSON.stringify(line)}\n`, "utf-8");
+	emitSessionTranscriptUpdate(sessionFile);
+	return {
+		ok: true,
+		sessionFile
+	};
+}
+
+//#endregion
+//#region src/config/sessions/delivery-info.ts
+/**
+* Extract deliveryContext and threadId from a sessionKey.
+* Supports both :thread: (most channels) and :topic: (Telegram).
+*/
+function parseSessionThreadInfo(sessionKey) {
+	if (!sessionKey) return {
+		baseSessionKey: void 0,
+		threadId: void 0
+	};
+	const topicIndex = sessionKey.lastIndexOf(":topic:");
+	const threadIndex = sessionKey.lastIndexOf(":thread:");
+	const markerIndex = Math.max(topicIndex, threadIndex);
+	const marker = topicIndex > threadIndex ? ":topic:" : ":thread:";
+	return {
+		baseSessionKey: markerIndex === -1 ? sessionKey : sessionKey.slice(0, markerIndex),
+		threadId: (markerIndex === -1 ? void 0 : sessionKey.slice(markerIndex + marker.length))?.trim() || void 0
+	};
+}
+function extractDeliveryInfo(sessionKey) {
+	const { baseSessionKey, threadId } = parseSessionThreadInfo(sessionKey);
+	if (!sessionKey || !baseSessionKey) return {
+		deliveryContext: void 0,
+		threadId
+	};
+	let deliveryContext;
+	try {
+		const store = loadSessionStore(resolveStorePath(loadConfig().session?.store));
+		let entry = store[sessionKey];
+		if (!entry?.deliveryContext && baseSessionKey !== sessionKey) entry = store[baseSessionKey];
+		if (entry?.deliveryContext) deliveryContext = {
+			channel: entry.deliveryContext.channel,
+			to: entry.deliveryContext.to,
+			accountId: entry.deliveryContext.accountId
+		};
+	} catch {}
+	return {
+		deliveryContext,
+		threadId
+	};
+}
+
+//#endregion
+//#region src/config/sessions.ts
+var sessions_exports = /* @__PURE__ */ __exportAll({
+	DEFAULT_IDLE_MINUTES: () => DEFAULT_IDLE_MINUTES,
+	DEFAULT_RESET_AT_HOUR: () => DEFAULT_RESET_AT_HOUR,
+	DEFAULT_RESET_MODE: () => DEFAULT_RESET_MODE,
+	DEFAULT_RESET_TRIGGER: () => DEFAULT_RESET_TRIGGER,
+	DEFAULT_RESET_TRIGGERS: () => DEFAULT_RESET_TRIGGERS,
+	SAFE_SESSION_ID_RE: () => SAFE_SESSION_ID_RE,
+	appendAssistantMessageToSessionTranscript: () => appendAssistantMessageToSessionTranscript,
+	buildGroupDisplayName: () => buildGroupDisplayName,
+	canonicalizeMainSessionAlias: () => canonicalizeMainSessionAlias,
+	capEntryCount: () => capEntryCount,
+	clearSessionStoreCacheForTest: () => clearSessionStoreCacheForTest,
+	deriveGroupSessionPatch: () => deriveGroupSessionPatch,
+	deriveSessionKey: () => deriveSessionKey,
+	deriveSessionMetaPatch: () => deriveSessionMetaPatch,
+	deriveSessionOrigin: () => deriveSessionOrigin,
+	enforceSessionDiskBudget: () => enforceSessionDiskBudget,
+	evaluateSessionFreshness: () => evaluateSessionFreshness,
+	extractDeliveryInfo: () => extractDeliveryInfo,
+	formatSessionArchiveTimestamp: () => formatSessionArchiveTimestamp,
+	getActiveSessionMaintenanceWarning: () => getActiveSessionMaintenanceWarning,
+	getSessionStoreLockQueueSizeForTest: () => getSessionStoreLockQueueSizeForTest,
+	isPrimarySessionTranscriptFileName: () => isPrimarySessionTranscriptFileName,
+	isSessionArchiveArtifactName: () => isSessionArchiveArtifactName,
+	isSessionTotalTokensFresh: () => isSessionTotalTokensFresh,
+	isThreadSessionKey: () => isThreadSessionKey,
+	loadSessionStore: () => loadSessionStore,
+	mergeSessionEntry: () => mergeSessionEntry,
+	normalizeSessionRuntimeModelFields: () => normalizeSessionRuntimeModelFields,
+	parseSessionArchiveTimestamp: () => parseSessionArchiveTimestamp,
+	parseSessionThreadInfo: () => parseSessionThreadInfo,
+	pruneStaleEntries: () => pruneStaleEntries,
+	readSessionUpdatedAt: () => readSessionUpdatedAt,
+	recordSessionMetaFromInbound: () => recordSessionMetaFromInbound,
+	resolveAgentIdFromSessionKey: () => resolveAgentIdFromSessionKey,
+	resolveAgentMainSessionKey: () => resolveAgentMainSessionKey,
+	resolveAndPersistSessionFile: () => resolveAndPersistSessionFile,
+	resolveChannelResetConfig: () => resolveChannelResetConfig,
+	resolveDailyResetAtMs: () => resolveDailyResetAtMs,
+	resolveDefaultSessionStorePath: () => resolveDefaultSessionStorePath,
+	resolveExplicitAgentSessionKey: () => resolveExplicitAgentSessionKey,
+	resolveFreshSessionTotalTokens: () => resolveFreshSessionTotalTokens,
+	resolveGroupSessionKey: () => resolveGroupSessionKey,
+	resolveMainSessionKey: () => resolveMainSessionKey,
+	resolveMainSessionKeyFromConfig: () => resolveMainSessionKeyFromConfig,
+	resolveMaintenanceConfig: () => resolveMaintenanceConfig,
+	resolveMirroredTranscriptText: () => resolveMirroredTranscriptText,
+	resolveSessionFilePath: () => resolveSessionFilePath,
+	resolveSessionFilePathOptions: () => resolveSessionFilePathOptions,
+	resolveSessionKey: () => resolveSessionKey,
+	resolveSessionResetPolicy: () => resolveSessionResetPolicy,
+	resolveSessionResetType: () => resolveSessionResetType,
+	resolveSessionTranscriptPath: () => resolveSessionTranscriptPath,
+	resolveSessionTranscriptPathInDir: () => resolveSessionTranscriptPathInDir,
+	resolveSessionTranscriptsDir: () => resolveSessionTranscriptsDir,
+	resolveSessionTranscriptsDirForAgent: () => resolveSessionTranscriptsDirForAgent,
+	resolveStorePath: () => resolveStorePath,
+	resolveThreadFlag: () => resolveThreadFlag,
+	rotateSessionFile: () => rotateSessionFile,
+	saveSessionStore: () => saveSessionStore,
+	setSessionRuntimeModel: () => setSessionRuntimeModel,
+	snapshotSessionOrigin: () => snapshotSessionOrigin,
+	updateLastRoute: () => updateLastRoute,
+	updateSessionStore: () => updateSessionStore,
+	updateSessionStoreEntry: () => updateSessionStoreEntry,
+	validateSessionId: () => validateSessionId,
+	withSessionStoreLockForTest: () => withSessionStoreLockForTest
+});
+
+//#endregion
+export { snapshotSessionOrigin as $, readSessionTitleFieldsFromTranscript as A, resolveChannelResetConfig as B, normalizeAccountId as C, cleanupArchivedSessionTranscripts as D, capArrayByJsonBytes as E, stripInlineDirectiveTagsForDisplay as F, resolveFreshSessionTotalTokens as G, resolveSessionResetType as H, stripInlineDirectiveTagsFromMessageForDisplay as I, resolveAgentMainSessionKey as J, setSessionRuntimeModel as K, cleanStaleLockFiles as L, stripEnvelopeFromMessage as M, stripEnvelopeFromMessages as N, readSessionMessages as O, parseInlineDirectives as P, deriveSessionMetaPatch as Q, resolveSessionKey as R, normalizeSessionDeliveryFields as S, archiveSessionTranscripts as T, resolveThreadFlag as U, resolveSessionResetPolicy as V, DEFAULT_RESET_TRIGGERS as W, resolveMainSessionKey as X, resolveExplicitAgentSessionKey as Y, resolveMainSessionKeyFromConfig as Z, updateSessionStoreEntry as _, resolveMirroredTranscriptText as a, mergeDeliveryContext as b, capEntryCount as c, readSessionUpdatedAt as d, formatSessionArchiveTimestamp as et, recordSessionMetaFromInbound as f, updateSessionStore as g, updateLastRoute as h, appendAssistantMessageToSessionTranscript as i, resolveSessionTranscriptCandidates as j, readSessionPreviewItemsFromTranscript as k, loadSessionStore as l, saveSessionStore as m, extractDeliveryInfo as n, buildGroupDisplayName as nt, resolveAndPersistSessionFile as o, resolveMaintenanceConfig as p, canonicalizeMainSessionAlias as q, parseSessionThreadInfo as r, resolveGroupSessionKey as rt, CURRENT_SESSION_VERSION as s, sessions_exports as t, isPrimarySessionTranscriptFileName as tt, pruneStaleEntries as u, enforceSessionDiskBudget as v, archiveFileOnDisk as w, normalizeDeliveryContext as x, deliveryContextFromSession as y, evaluateSessionFreshness as z };