@maudecode/talaria-web 1.17.2 → 1.18.0

package/dist/sessions/recovery.js

@@ -0,0 +1,506 @@
+/**
+ * Session recovery audit and safe repair (Python `api/session_recovery.py`, TAL-259). The store writes
+ * `<sid>.json.bak` before any save that shrinks a transcript; the audit classifies every backup, index row, WebUI-origin
+ * state.db row without a sidecar, and pending turn-journal entry as `repairable` or `unsafe_to_repair`, and safe repair
+ * restores, materializes, and reindexes only what is repairable.
+ *
+ * A backup never undoes a deliberate shrink: clear, manual compression, and truncate/retry/undo each leave provenance on
+ * the live sidecar (`clear_generation`, the compression anchor, `intentional_shrink_generation`). A backup older than the
+ * `recovery_stamping_since` marker may predate that provenance, so next to a readable live transcript it goes to manual
+ * review instead.
+ */
+import { closeSync, existsSync, fsyncSync, linkSync, mkdirSync, openSync, readdirSync, readFileSync, renameSync, statSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { atomicWriteText, writeFully } from '../fs/atomic.js';
+import { str } from '../util.js';
+import { isContextCompressionMarker } from './merge.js';
+import { isSafeSessionId, Session } from './session.js';
+import { normalizeAgentSessionSource, openStateDbReadonly } from './state-db.js';
+const STAMPING_MARKER = 'recovery_stamping_since';
+/** Python `STATE_DB_RECOVERY_BUSY_TIMEOUT_MS`: a recovery scan waits out a writer rather than read a lock as "nothing missing". */
+const STATE_DB_RECOVERY_BUSY_TIMEOUT_MS = 5000;
+const SHRINK_GENERATION_RE = /^[0-9a-f]{12}4[0-9a-f]{3}[89ab][0-9a-f]{15}$/;
+const TURN_JOURNAL_DIR = '_turn_journal';
+const TURN_JOURNAL_ID_RE = /^[A-Za-z0-9_.-]+$/;
+const TERMINAL_TURN_EVENTS = new Set(['completed', 'interrupted']);
+const WORKTREE_FIELDS = ['worktree_path', 'worktree_branch', 'worktree_repo_root', 'worktree_created_at'];
+let tmpCounter = 0;
+const isDict = (v) => Boolean(v) && typeof v === 'object' && !Array.isArray(v);
+const isEmptyList = (v) => Array.isArray(v) && v.length === 0;
+/**
+ * Epoch seconds since which this server stamps every deliberate shrink, recorded in the state directory on first start.
+ * A missing or unreadable marker is recorded anew: a later marker only sends more backups to manual review.
+ */
+export function recoveryStampingSince(stateDir) {
+    const path = join(stateDir, STAMPING_MARKER);
+    try {
+        const value = Number(readFileSync(path, 'utf8').trim());
+        if (Number.isFinite(value) && value > 0)
+            return value;
+    }
+    catch { /* record it below */ }
+    const now = Date.now() / 1000;
+    mkdirSync(stateDir, { recursive: true });
+    atomicWriteText(path, `${String(now)}\n`);
+    return now;
+}
+function readDoc(path) {
+    try {
+        const value = JSON.parse(readFileSync(path, 'utf8'));
+        return isDict(value) ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Python `_msg_count`: the transcript length, or -1 when the file is missing, unparseable, or not a session. */
+function messageCount(doc) {
+    return doc && Array.isArray(doc.messages) ? doc.messages.length : -1;
+}
+// ── deliberate-shrink provenance ─────────────────────────────────────────
+/**
+ * Python `_session_records_clear_sentinel` / `_live_supersedes_backup_by_clear_generation`: the live sidecar carries a
+ * clear generation the backup lacks and the clear's boundary reset, and is either the exact cleared shape or has new
+ * messages since.
+ */
+function clearedAfterBackup(live, bak) {
+    const generation = live.clear_generation;
+    if (typeof generation !== 'string' || !generation || bak.clear_generation === generation)
+        return false;
+    if (live.truncation_watermark !== 0 || live.truncation_boundary !== 0)
+        return false;
+    if (Array.isArray(live.messages) && live.messages.length > 0)
+        return true;
+    const nulls = ['active_stream_id', 'pending_user_message', 'pending_started_at', 'pending_user_source'];
+    const lists = ['messages', 'context_messages', 'pending_attachments'];
+    return nulls.every((k) => k in live && live[k] === null) && lists.every((k) => isEmptyList(live[k]));
+}
+/** Python `_session_records_intentional_compress_shrink`: the live sidecar records a context compression. */
+function recordsCompression(live) {
+    if (str(live.compression_anchor_mode).trim().toLowerCase() === 'manual')
+        return true;
+    const shorter = Array.isArray(live.context_messages) && Array.isArray(live.messages) && live.context_messages.length < live.messages.length;
+    if (!shorter)
+        return false;
+    const anchored = str(live.compression_anchor_summary).trim() !== '' && live.compression_anchor_message_key !== null && live.compression_anchor_message_key !== undefined;
+    return anchored || (live.truncation_watermark !== null && live.truncation_watermark !== undefined);
+}
+/**
+ * Python `_backup_predates_intentional_shrink`: the backup still holds the uncompressed context. A backup whose context
+ * carries the compaction marker was written after the compression and stays recoverable.
+ */
+function backupPredatesCompression(live, bak) {
+    const bakContext = Array.isArray(bak.context_messages) ? bak.context_messages : [];
+    if (bakContext.some(isContextCompressionMarker))
+        return false;
+    return bakContext.length > (Array.isArray(live.context_messages) ? live.context_messages.length : 0);
+}
+/** Python `_session_records_intentional_message_shrink`: truncate, retry, or undo stamped a generation the backup lacks. */
+function recordsMessageShrink(live, bak) {
+    const isGeneration = (v) => typeof v === 'string' && SHRINK_GENERATION_RE.test(v);
+    if (!isGeneration(live.intentional_shrink_generation))
+        return false;
+    const backup = bak.intentional_shrink_generation;
+    if (backup === undefined || backup === null)
+        return true;
+    return isGeneration(backup) && backup !== live.intentional_shrink_generation;
+}
+/** Python `inspect_session_recovery_status`: whether `<sid>.json.bak` should replace `<sid>.json`. */
+function inspectBackup(dir, sid, stampingSince) {
+    const livePath = join(dir, `${sid}.json`);
+    let bakMtime;
+    try {
+        bakMtime = statSync(`${livePath}.bak`).mtimeMs / 1000;
+    }
+    catch {
+        return { session_id: sid, live_messages: messageCount(readDoc(livePath)), bak_messages: -1, recommend: 'no_backup' };
+    }
+    const live = readDoc(livePath);
+    const bak = readDoc(`${livePath}.bak`);
+    const base = { session_id: sid, live_messages: messageCount(live), bak_messages: messageCount(bak) };
+    if (base.bak_messages <= base.live_messages)
+        return { ...base, recommend: 'no_action' };
+    // Every guard needs both documents; an unreadable live file is a real loss and restores.
+    if (live && bak) {
+        if (clearedAfterBackup(live, bak))
+            return { ...base, recommend: 'no_action', reason: 'intentional_clear_truncate' };
+        if (recordsCompression(live) && backupPredatesCompression(live, bak))
+            return { ...base, recommend: 'no_action', reason: 'intentional_compress_shrink' };
+        if (recordsMessageShrink(live, bak))
+            return { ...base, recommend: 'no_action', reason: 'intentional_message_shrink' };
+        if (base.live_messages >= 0 && bakMtime < stampingSince)
+            return { ...base, recommend: 'manual_review', reason: 'unstamped_legacy_backup' };
+    }
+    return { ...base, recommend: 'restore' };
+}
+function columns(db, table) {
+    return new Set(db.prepare(`PRAGMA table_info(${table})`).all().map((r) => r.name));
+}
+/** Python `_read_state_db_missing_sidecar_rows` (with empty rows) plus the session ids, from one read-only handle. */
+function readStateDb(path, sessionDir) {
+    const absent = { has: () => true, missing: [], unreadable: false };
+    if (!existsSync(path))
+        return absent;
+    let db;
+    try {
+        db = openStateDbReadonly(path, STATE_DB_RECOVERY_BUSY_TIMEOUT_MS);
+    }
+    catch {
+        return { ...absent, unreadable: true };
+    }
+    try {
+        const cols = columns(db, 'sessions');
+        if (!cols.has('id'))
+            return absent;
+        const ids = new Set(db.prepare('SELECT id FROM sessions').all().map((r) => str(r.id)));
+        const view = { has: (sid) => ids.has(sid), missing: [], unreadable: false };
+        if (!cols.has('source'))
+            return view;
+        const opt = (name, fallback = 'NULL') => (cols.has(name) ? name : `${fallback} AS ${name}`);
+        const select = ['id', opt('title'), opt('model'), opt('started_at', '0'), opt('parent_session_id'), opt('workspace'), ...WORKTREE_FIELDS.map((f) => opt(f))];
+        const order = cols.has('started_at') ? 'COALESCE(started_at, 0) DESC' : 'rowid';
+        const rows = db.prepare(`SELECT ${select.join(', ')} FROM sessions WHERE source = 'webui' ORDER BY ${order}`).all();
+        const msgCols = columns(db, 'messages');
+        const messages = ['session_id', 'role', 'content'].every((c) => msgCols.has(c))
+            ? db.prepare(`SELECT role, content, ${msgCols.has('timestamp') ? 'timestamp' : 'NULL AS timestamp'} FROM messages WHERE session_id = ? ORDER BY ${msgCols.has('timestamp') && msgCols.has('id') ? 'timestamp, id' : 'rowid'}`)
+            : null;
+        for (const row of rows) {
+            const sid = str(row.id).trim();
+            if (!isSafeSessionId(sid) || existsSync(join(sessionDir, `${sid}.json`)))
+                continue;
+            const transcript = (messages?.all(sid) ?? []).map((m) => ({ role: m.role, content: m.content || '', ...(m.timestamp !== null ? { timestamp: m.timestamp } : {}) }));
+            view.missing.push({ ...row, id: sid, messages: transcript });
+        }
+        return view;
+    }
+    catch {
+        return { ...absent, unreadable: true };
+    }
+    finally {
+        db.close();
+    }
+}
+/** Python `_state_db_row_to_sidecar`, through `Session` so the document matches every field the store persists. */
+function sidecarFromStateDbRow(row, store, profile) {
+    const source = 'webui'; // the scan reads only WebUI-origin rows
+    const started = Number(row.started_at) || 0;
+    const last = Number(row.messages.at(-1)?.timestamp) || 0;
+    const workspace = typeof row.workspace === 'string' && row.workspace ? { workspace: row.workspace } : {};
+    const worktree = Object.fromEntries(WORKTREE_FIELDS.map((f) => [f, row[f] || null]));
+    const session = new Session({
+        session_id: row.id, title: str(row.title) || 'Recovered WebUI Session', ...workspace, model: str(row.model) || 'unknown', profile,
+        created_at: started, updated_at: last || started, parent_session_id: row.parent_session_id ?? null, ...worktree,
+        source_tag: source, ...normalizeAgentSessionSource(source), messages: row.messages,
+    }, store.deps.defaults(profile));
+    return session.toDocument();
+}
+// ── turn journal (read-only) ─────────────────────────────────────────────
+const createdAt = (event) => { const n = Number(event.created_at ?? 0); return Number.isFinite(n) ? n : 0; };
+/**
+ * Python `iter_turn_journal_session_ids` + `read_turn_journal`: each session's events across its pid shards
+ * (`<sid>~<pid>.jsonl`) and legacy file, oldest first. Only journals an earlier backend left behind exist; this server
+ * never writes one.
+ */
+function readTurnJournals(sessionDir) {
+    const dir = join(sessionDir, TURN_JOURNAL_DIR);
+    const out = new Map();
+    let names;
+    try {
+        names = readdirSync(dir).sort();
+    }
+    catch {
+        return out;
+    }
+    for (const name of names) {
+        if (!name.endsWith('.jsonl'))
+            continue;
+        const stem = name.slice(0, -'.jsonl'.length);
+        const tilde = stem.indexOf('~');
+        const sid = tilde > 0 ? stem.slice(0, tilde) : stem;
+        if (!TURN_JOURNAL_ID_RE.test(sid))
+            continue;
+        let text;
+        try {
+            if (!statSync(join(dir, name)).isFile())
+                continue;
+            text = readFileSync(join(dir, name), 'utf8');
+        }
+        catch {
+            continue;
+        }
+        const events = out.get(sid) ?? [];
+        for (const line of text.split('\n')) {
+            if (!line.trim())
+                continue;
+            try {
+                const event = JSON.parse(line);
+                if (isDict(event))
+                    events.push(event);
+            }
+            catch { /* a torn line */ }
+        }
+        out.set(sid, events);
+    }
+    for (const events of out.values())
+        events.sort((a, b) => createdAt(a) - createdAt(b));
+    return out;
+}
+/** What a turn sent: its trimmed text and attachment names, or null when it sent nothing identifiable. */
+function turnKey(content, attachments) {
+    const text = str(content || '').trim();
+    const files = (Array.isArray(attachments) ? attachments : []).map((a) => (isDict(a) ? str(a.name || a.filename || a.path) : str(a))).filter(Boolean).sort();
+    return text || files.length ? JSON.stringify([text, files]) : null;
+}
+/** A sidecar user row this long before a journaled turn predates it, so it cannot be that turn's row. */
+const TURN_ROW_CLOCK_SLACK_S = 5;
+/**
+ * Turns whose latest event is not terminal and whose user message never reached the sidecar. A row stamped with the
+ * turn's id (or stream id) is that turn; otherwise rows and turns with the same text and attachments pair up in order,
+ * one row per turn, so a repeated message ("continue") or an attachment-only turn still counts as missing.
+ */
+function pendingJournalTurns(sessionDir, sid, events) {
+    const turns = new Map();
+    for (const event of events) {
+        const id = str(event.turn_id).trim();
+        if (!id)
+            continue;
+        const turn = turns.get(id) ?? { id, ids: new Set([id]), first: createdAt(event), latest: event, key: null };
+        if (createdAt(event) >= createdAt(turn.latest))
+            turn.latest = event;
+        turn.key ??= turnKey(event.content, event.attachments);
+        const streamId = str(event.stream_id).trim();
+        if (streamId)
+            turn.ids.add(streamId);
+        turns.set(id, turn);
+    }
+    if (!turns.size)
+        return [];
+    const live = readDoc(join(sessionDir, `${sid}.json`));
+    const rows = (Array.isArray(live?.messages) ? live.messages : []).filter((m) => isDict(m) && m.role === 'user');
+    const rowTurnIds = new Set(rows.map((m) => str(m._turn_id)).filter(Boolean));
+    const journaled = new Set([...turns.values()].flatMap((t) => [...t.ids]));
+    const unmatched = [...turns.values()].filter((t) => ![...t.ids].some((id) => rowTurnIds.has(id))).sort((a, b) => a.first - b.first);
+    const missing = new Set();
+    for (const key of new Set(unmatched.map((t) => t.key))) {
+        if (key === null)
+            continue;
+        const keyed = unmatched.filter((t) => t.key === key);
+        const earliest = keyed[0].first - TURN_ROW_CLOCK_SLACK_S;
+        const available = rows.filter((m) => !journaled.has(str(m._turn_id)) && turnKey(m.content, m.attachments) === key && !(Number(m.timestamp) < earliest)).length;
+        for (const turn of keyed.slice(available))
+            missing.add(turn);
+    }
+    const items = [];
+    for (const turn of [...missing].sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0))) {
+        if (TERMINAL_TURN_EVENTS.has(str(turn.latest.event)))
+            continue;
+        items.push({ ...item(sid, 'turn_journal_pending_turn', 'repairable', 'audit_only_pending_turn_journal', messageCount(live)), turn_id: turn.id, event: str(turn.latest.event) });
+    }
+    return items;
+}
+// ── audit ────────────────────────────────────────────────────────────────
+function item(session_id, kind, category, recommendation, live_messages = -1, bak_messages = -1) {
+    return { session_id, kind, category, recommendation, live_messages, bak_messages };
+}
+function scan(deps) {
+    const dir = deps.store.sessionDir;
+    let names = [];
+    try {
+        names = readdirSync(dir).sort();
+    }
+    catch { /* no sessions yet; state.db may still hold some */ }
+    const ids = (suffix) => names.filter((n) => n.endsWith(suffix) && !n.startsWith('_')).map((n) => n.slice(0, -suffix.length));
+    return { dir, liveIds: ids('.json'), backupIds: ids('.json.bak'), db: readStateDb(deps.stateDbPath, dir), tombstoned: deps.store.loadDeletedTombstone() };
+}
+/** Python `audit_session_recovery`: a read-only classification of every recovery finding. */
+export function auditSessionRecovery(deps) {
+    const s = scan(deps);
+    const items = [];
+    const live = new Set(s.liveIds);
+    for (const sid of s.backupIds.filter((id) => live.has(id))) {
+        const status = inspectBackup(s.dir, sid, deps.stampingSince);
+        if (status.recommend === 'restore')
+            items.push(item(sid, 'shrunken_live', 'repairable', 'restore_from_bak', status.live_messages, status.bak_messages));
+        if (status.recommend === 'manual_review')
+            items.push(item(sid, 'unstamped_legacy_backup', 'unsafe_to_repair', 'manual_review', status.live_messages, status.bak_messages));
+    }
+    // A deleted session with both a surviving backup and a state.db row is reported once (#5504).
+    const reportedDeleted = new Set();
+    for (const sid of s.backupIds.filter((id) => !live.has(id))) {
+        const bakMessages = messageCount(readDoc(join(s.dir, `${sid}.json.bak`)));
+        if (bakMessages < 0 || !isSafeSessionId(sid))
+            items.push(item(sid, 'malformed_orphan_backup', 'unsafe_to_repair', 'manual_review', -1, bakMessages));
+        else if (s.tombstoned.has(sid)) {
+            reportedDeleted.add(sid);
+            items.push(item(sid, 'state_db_deleted_webui_tombstone', 'unsafe_to_repair', 'deleted_session_skipped', -1, bakMessages));
+        }
+        else if (s.db.has(sid))
+            items.push(item(sid, 'orphan_backup', 'repairable', 'restore_from_bak', -1, bakMessages));
+        else
+            items.push(item(sid, 'orphan_backup_without_state_row', 'unsafe_to_repair', 'manual_review', -1, bakMessages));
+    }
+    if (existsSync(deps.store.indexFile)) {
+        let indexed = null;
+        try {
+            indexed = new Set(deps.store.readIndexEntries().map((e) => e.session_id).filter((id) => typeof id === 'string'));
+        }
+        catch {
+            items.push(item('', 'index_unreadable', 'repairable', 'rebuild_index'));
+        }
+        if (indexed)
+            for (const sid of [...indexed].filter((id) => !live.has(id) && !s.tombstoned.has(id)).sort())
+                items.push(item(sid, 'index_missing_file', 'repairable', 'rebuild_index'));
+        if (indexed)
+            for (const sid of s.liveIds.filter((id) => !indexed.has(id)))
+                items.push(item(sid, 'index_missing_entry', 'repairable', 'rebuild_index', messageCount(readDoc(join(s.dir, `${sid}.json`)))));
+    }
+    for (const row of s.db.missing) {
+        if (reportedDeleted.has(row.id))
+            continue;
+        if (s.tombstoned.has(row.id))
+            items.push(item(row.id, 'state_db_deleted_webui_tombstone', 'unsafe_to_repair', 'deleted_session_skipped'));
+        else if (!row.messages.length)
+            items.push(item(row.id, 'state_db_orphan_webui_row', 'unsafe_to_repair', 'manual_review'));
+        else
+            items.push(item(row.id, 'state_db_missing_sidecar', 'repairable', 'materialize_from_state_db'));
+    }
+    if (s.db.unreadable)
+        items.push(item('', 'state_db_unreadable', 'unsafe_to_repair', 'manual_review'));
+    for (const [sid, events] of readTurnJournals(s.dir))
+        items.push(...pendingJournalTurns(s.dir, sid, events));
+    const summary = { ok: s.liveIds.length, repairable: 0, unsafe_to_repair: 0 };
+    for (const i of items)
+        summary[i.category] += 1;
+    return { status: summary.unsafe_to_repair ? 'needs_manual_review' : summary.repairable ? 'warn' : 'ok', summary, items };
+}
+// ── repair ───────────────────────────────────────────────────────────────
+/** Write `text` to a synced sibling temp file and publish it: replace `target`, or with `create` only when it is absent. */
+function publish(target, text, create) {
+    const tmp = `${target}.recover.tmp.${String(process.pid)}.${String(++tmpCounter)}`;
+    try {
+        const fd = openSync(tmp, 'w');
+        try {
+            writeFully(fd, text);
+            fsyncSync(fd);
+        }
+        finally {
+            closeSync(fd);
+        }
+        if (!create) {
+            renameSync(tmp, target);
+            return true;
+        }
+        // A link never replaces a sidecar a concurrent save created after the check.
+        try {
+            linkSync(tmp, target);
+            return true;
+        }
+        catch (error) {
+            if (error.code === 'EEXIST')
+                return false;
+            throw error;
+        }
+    }
+    finally {
+        try {
+            unlinkSync(tmp);
+        }
+        catch { /* renamed */ }
+    }
+}
+/** A resident session with a live turn would overwrite any restored file on its next save. */
+function busy(store, sid) {
+    const s = store.sessions.get(sid);
+    return Boolean(s && (s.active_stream_id || s.pending_user_message || s.pending_started_at));
+}
+/** Restore shrunken and orphaned sidecars from their backups, each re-checked under the session lock. */
+async function restoreBackups(deps, s) {
+    const { store } = deps;
+    const live = new Set(s.liveIds);
+    const orphans = s.backupIds.filter((sid) => !live.has(sid) && isSafeSessionId(sid) && !s.tombstoned.has(sid) && s.db.has(sid) && messageCount(readDoc(join(s.dir, `${sid}.json.bak`))) >= 0);
+    const result = { scanned: s.liveIds.length + orphans.length, restored: 0, orphaned_backups: orphans.length, details: [] };
+    for (const sid of [...s.backupIds.filter((id) => live.has(id) && isSafeSessionId(id)), ...orphans]) {
+        await store.withLock(sid, () => {
+            const status = inspectBackup(s.dir, sid, deps.stampingSince);
+            const path = store.pathFor(sid);
+            if (status.recommend !== 'restore' || (!existsSync(path) && store.wasDeleted(sid)))
+                return;
+            const counts = { live_messages: status.live_messages, bak_messages: status.bak_messages };
+            if (busy(store, sid)) {
+                result.details.push({ session_id: sid, restored: false, ...counts, skipped: 'session_active' });
+                return;
+            }
+            try {
+                if (!publish(path, readFileSync(`${path}.bak`, 'utf8'), !existsSync(path))) {
+                    result.details.push({ session_id: sid, restored: false, ...counts, skipped: 'sidecar_appeared' });
+                    return;
+                }
+            }
+            catch (error) {
+                result.details.push({ session_id: sid, restored: false, ...counts, error: error.message });
+                return;
+            }
+            store.sessions.delete(sid);
+            store.invalidatePersistedIds();
+            result.restored += 1;
+            result.details.push({ session_id: sid, restored: true, ...counts });
+            deps.log(`[webui] WARNING: session recovery restored ${sid} from .bak (live=${String(status.live_messages)} -> bak=${String(status.bak_messages)} messages)`);
+        });
+    }
+    return result;
+}
+/** Python `recover_missing_sidecars_from_state_db`: create each missing WebUI sidecar that state.db can rebuild. */
+async function materializeSidecars(deps, s) {
+    const { store } = deps;
+    const rows = s.db.missing.filter((row) => row.messages.length && !s.tombstoned.has(row.id));
+    const result = { scanned: rows.length, materialized: 0, details: [] };
+    for (const row of rows) {
+        await store.withLock(row.id, () => {
+            if (store.wasDeleted(row.id))
+                return;
+            if (busy(store, row.id)) {
+                result.details.push({ session_id: row.id, materialized: false, skipped: 'session_active' });
+                return;
+            }
+            try {
+                mkdirSync(s.dir, { recursive: true });
+                if (!publish(store.pathFor(row.id), JSON.stringify(sidecarFromStateDbRow(row, store, deps.profile), null, 2), true)) {
+                    result.details.push({ session_id: row.id, materialized: false, skipped: 'sidecar_appeared_during_reconcile' });
+                    return;
+                }
+            }
+            catch (error) {
+                result.details.push({ session_id: row.id, materialized: false, error: error.message });
+                return;
+            }
+            store.sessions.delete(row.id);
+            store.invalidatePersistedIds();
+            result.materialized += 1;
+            result.details.push({ session_id: row.id, materialized: true, messages: row.messages.length });
+        });
+    }
+    return result;
+}
+/**
+ * Python `repair_safe_session_recovery`: restore repairable backups, materialize missing sidecars from state.db, rebuild
+ * the index from the sidecars on disk, and audit again. `clean` holds only when the second audit has no finding.
+ */
+export async function repairSafeSessionRecovery(deps) {
+    const before = auditSessionRecovery(deps);
+    const s = scan(deps);
+    const backupRepair = await restoreBackups(deps, s);
+    const sidecarRepair = await materializeSidecars(deps, s);
+    const reindex = backupRepair.restored || sidecarRepair.materialized || !existsSync(deps.store.indexFile) || before.items.some((i) => i.recommendation === 'rebuild_index');
+    if (reindex && existsSync(s.dir)) {
+        try {
+            deps.store.rebuildIndex({ diskOnly: true });
+        }
+        catch (error) {
+            deps.log(`[webui] WARNING: session recovery index rebuild failed: ${error.message}`);
+        }
+    }
+    const after = auditSessionRecovery(deps);
+    const clean = after.summary.repairable === 0 && after.summary.unsafe_to_repair === 0;
+    return { clean, ok: clean, repaired: backupRepair.restored + sidecarRepair.materialized, before, backup_repair: backupRepair, sidecar_repair: sidecarRepair, after };
+}
+//# sourceMappingURL=recovery.js.map

package/dist/sessions/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/sessions/recovery.ts"],"names":[],"mappings":"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"}

package/dist/sessions/relay.d.ts

@@ -2,6 +2,9 @@ import type { StreamRegistry } from './streams.js';
 import type { PendingPrompts } from './pending.js';
 import type { SessionStore } from './store.js';
 export declare const PRESENCE_LEASE_SECONDS = 90;
+export declare const PRESENCE_MAX_LEASES = 256;
+/** How long a tab's sequence fence outlives its lease, so a reloaded tab whose clock moved back recovers. */
+export declare const PRESENCE_FENCE_SECONDS: number;
 export declare class RelayPairingError extends Error {
     readonly status: number;
     constructor(message: string, status: number);
@@ -25,12 +28,16 @@ export declare function loadRelayConfig(stateDir: string): RelayConfig | null;
 export declare function saveRelayConfig(stateDir: string, config: RelayConfig): void;
 /** Python `_profile_identity`: a persistent `pfi_<32 hex>` per profile home, minted on first use (0600). */
 export declare function profileIdentity(profileHome: string): string;
-/** Profile-scoped browser activity leases; a fresh active lease mutes alerts for that profile. */
+/**
+ * Profile-scoped browser activity leases; a fresh active lease mutes alerts for that profile.
+ * Each tab's entry also fences its sequence number for PRESENCE_FENCE_SECONDS past lease expiry,
+ * so a delayed lower sequence stays rejected. At most PRESENCE_MAX_LEASES tabs are kept; the least
+ * recently updated tab is evicted first, which drops its fence too.
+ */
 export declare class PresenceLeases {
     private readonly now;
     private readonly leases;
     constructor(now: () => number);
-    private prune;
     private apply;
     renew(profile: string, tabId: string, seq?: number): void;
     revoke(profile: string, tabId: string, seq?: number): void;
@@ -48,6 +55,8 @@ export interface RelayPublisherDeps {
     presence: PresenceLeases;
     profileHome: (profile: string) => string;
     profilesMatch: (row: string | null | undefined, active: string | null | undefined) => boolean;
+    /** The profile's messageful Agent `state.db` sessions (`readImportableAgentSessionRows`). */
+    agentSessions: (profile: string) => Promise<Record<string, unknown>[]>;
     fetch: () => typeof fetch;
     now: () => number;
     log: (line: string) => void;
@@ -69,6 +78,8 @@ export declare class RelayPublisher {
     private readonly deps;
     private readonly key;
     private readonly revisionPath;
+    private readonly startedPath;
+    private startedUnsupportedLogged;
     private lastRevision;
     private terminal;
     private readonly disabledProfiles;
@@ -101,6 +112,14 @@ export declare class RelayPublisher {
     private publishes;
     /** Validation publish for one newly enrolled profile (Python `publish_profile`). */
     publishProfile(profileId: string, expectedIdentity: string): Promise<void>;
+    private loadStarted;
+    private saveStarted;
+    /** Give each enrolled profile without a ledger entry a floor of now; true when the ledger changed. */
+    private trackProfiles;
+    /** Record every messageful Web or Agent session that started in an enrolled profile since tracking began. */
+    private observeStarted;
+    /** Announce each newly observed session once, oldest first, to the relay scope of the profile that owns it. */
+    publishStarted(): Promise<void>;
     private publishProfileSnapshot;
     private putSnapshot;
     private put;