@maudecode/talaria-web 1.17.2 → 1.19.0

package/dist/sessions/recovery.js

@@ -0,0 +1,322 @@
+/**
+ * Session recovery audit and safe repair (Python `api/session_recovery.py`, TAL-259). The store writes
+ * a shrink backup 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 { existsSync } from 'node:fs';
+import { updateDocument } from './storage/document.js';
+import { str } from '../util.js';
+import { isSafeSessionId, Session } from './session.js';
+import { normalizeAgentSessionSource, openStateDbReadonly } from './state-db.js';
+/** 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 TERMINAL_TURN_EVENTS = new Set(['completed', 'interrupted']);
+const createdAt = (event) => { const value = Number(event.created_at ?? 0); return Number.isFinite(value) ? value : 0; };
+const WORKTREE_FIELDS = ['worktree_path', 'worktree_branch', 'worktree_repo_root', 'worktree_created_at'];
+const isDict = (v) => Boolean(v) && typeof v === 'object' && !Array.isArray(v);
+/**
+ * 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 async function recoveryStampingSince(documents) {
+    return (await updateDocument(documents, 'recovery', 'stamping-since', (value) => {
+        const stored = Number(typeof value === 'string' ? value.trim() : '');
+        if (Number.isFinite(stored) && stored > 0)
+            return { value, result: stored };
+        const now = Date.now() / 1000;
+        return { value: `${String(now)}\n`, result: now };
+    }, { replaceInvalid: true }));
+}
+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, persisted) {
+    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) || persisted.has(sid))
+                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. */
+async 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,
+    }, (await store.deps.defaults(profile)));
+    return session.toDocument();
+}
+// ── turn journal (read-only) ─────────────────────────────────────────────
+/** 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(live, 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 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', Array.isArray(live?.messages) ? live.messages.length : -1), 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 };
+}
+async function scan(deps) {
+    const persisted = await deps.store.persistedIds();
+    return { liveIds: [...persisted].sort(), issues: await deps.store.diagnose(), db: readStateDb(deps.stateDbPath, persisted), tombstoned: await deps.store.loadDeletedTombstone() };
+}
+async function readOnlyRecovery(deps, sid, profile) {
+    if (profile === undefined) {
+        try {
+            profile = (await deps.store.loadMetadataOnly(sid))?.profile ?? deps.profile;
+        }
+        catch {
+            profile = deps.profile;
+        }
+    }
+    return deps.isReadOnly(sid, profile);
+}
+export async function auditSessionRecovery(deps) {
+    const s = await scan(deps);
+    const items = [];
+    const reportedDeleted = new Set();
+    for (const issue of s.issues) {
+        const { profile } = issue;
+        const finding = { ...issue };
+        delete finding.profile;
+        delete finding.revision;
+        delete finding.backupRevision;
+        if (finding.kind === 'index_missing_file' && s.tombstoned.has(finding.session_id))
+            continue;
+        if (finding.kind === 'orphan_backup') {
+            if (s.tombstoned.has(finding.session_id)) {
+                reportedDeleted.add(finding.session_id);
+                finding.kind = 'state_db_deleted_webui_tombstone';
+                finding.category = 'unsafe_to_repair';
+                finding.recommendation = 'deleted_session_skipped';
+            }
+            else if (!s.db.has(finding.session_id)) {
+                finding.kind = 'orphan_backup_without_state_row';
+                finding.category = 'unsafe_to_repair';
+                finding.recommendation = 'manual_review';
+            }
+        }
+        if (finding.recommendation === 'restore_from_bak' && await readOnlyRecovery(deps, finding.session_id, profile)) {
+            finding.category = 'unsafe_to_repair';
+            finding.recommendation = 'manual_review';
+        }
+        items.push(finding);
+    }
+    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 await deps.store.deps.storage.journals.recoveryEvents()) {
+        let doc = null;
+        try {
+            if (await deps.store.exists(sid))
+                doc = { messages: await deps.store.readMessages(sid, { start: 0, end: Infinity }) };
+        }
+        catch { /* corrupt */ }
+        items.push(...pendingJournalTurns(doc, sid, events));
+    }
+    for (const finding of items)
+        if (finding.recommendation === 'materialize_from_state_db' && await readOnlyRecovery(deps, finding.session_id)) {
+            finding.category = 'unsafe_to_repair';
+            finding.recommendation = 'manual_review';
+        }
+    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 };
+}
+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));
+}
+async function restoreBackups(deps, s) {
+    const { store } = deps;
+    const orphans = s.issues.filter((i) => i.kind === 'orphan_backup' && !s.tombstoned.has(i.session_id) && s.db.has(i.session_id));
+    const result = { scanned: s.liveIds.length + orphans.length, restored: 0, orphaned_backups: orphans.length, details: [] };
+    for (const issue of [...s.issues.filter((i) => i.kind === 'shrunken_live'), ...orphans]) {
+        const sid = issue.session_id;
+        await store.withLock(sid, async () => {
+            if (!await store.exists(sid) && await store.wasDeleted(sid))
+                return;
+            const counts = { live_messages: issue.live_messages, bak_messages: issue.bak_messages };
+            if (await readOnlyRecovery(deps, sid, issue.profile)) {
+                result.details.push({ session_id: sid, restored: false, ...counts, skipped: 'read_only' });
+                return;
+            }
+            if (busy(store, sid)) {
+                result.details.push({ session_id: sid, restored: false, ...counts, skipped: 'session_active' });
+                return;
+            }
+            try {
+                if (!await store.repair(issue)) {
+                    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;
+            }
+            result.restored += 1;
+            result.details.push({ session_id: sid, restored: true, ...counts });
+            deps.log(`[webui] WARNING: session recovery restored ${sid} from its backup (live=${String(issue.live_messages)} -> bak=${String(issue.bak_messages)} messages)`);
+        });
+    }
+    return result;
+}
+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, async () => {
+            if (await store.wasDeleted(row.id))
+                return;
+            if (await readOnlyRecovery(deps, row.id)) {
+                result.details.push({ session_id: row.id, materialized: false, skipped: 'read_only' });
+                return;
+            }
+            if (busy(store, row.id)) {
+                result.details.push({ session_id: row.id, materialized: false, skipped: 'session_active' });
+                return;
+            }
+            try {
+                if (await store.exists(row.id)) {
+                    result.details.push({ session_id: row.id, materialized: false, skipped: 'sidecar_appeared_during_reconcile' });
+                    return;
+                }
+                await store.save(new Session((await sidecarFromStateDbRow(row, store, deps.profile)), (await store.deps.defaults(deps.profile))), { touchUpdatedAt: false, skipIndex: true });
+            }
+            catch (error) {
+                result.details.push({ session_id: row.id, materialized: false, error: error.message });
+                return;
+            }
+            store.sessions.delete(row.id);
+            result.materialized += 1;
+            result.details.push({ session_id: row.id, materialized: true, messages: row.messages.length });
+        });
+    }
+    return result;
+}
+export async function repairSafeSessionRecovery(deps) {
+    const before = await auditSessionRecovery(deps);
+    const s = await scan(deps);
+    const backupRepair = await restoreBackups(deps, s);
+    const sidecarRepair = await materializeSidecars(deps, s);
+    const reindex = backupRepair.restored || sidecarRepair.materialized || !await deps.store.hasIndex() || before.items.some((i) => i.recommendation === 'rebuild_index');
+    if (reindex) {
+        try {
+            await deps.store.rebuildIndex({ diskOnly: true });
+        }
+        catch (error) {
+            deps.log(`[webui] WARNING: session recovery index rebuild failed: ${error.message}`);
+        }
+    }
+    const after = await 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

@@ -1,7 +1,11 @@
+import type { DocumentBackend } from './storage/backend.js';
 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);
@@ -15,22 +19,26 @@ export interface RelayConfig {
     publisher_id: string;
     key_id: string;
     private_key_path: string;
+    private_key_document?: string;
     profiles: Record<string, RelayProfile>;
 }
 /** Python `RelayConfig._validated_origin`: a bare origin with no path, query, credentials, or fragment. */
 export declare function validatedOrigin(raw: string, httpsOnly?: boolean): string;
-export declare function relayStatePath(stateDir: string): string;
 /** Python `RelayConfig.from_state`: null when absent or a v1 file (registration is required again); throws on corruption. */
-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. */
+export declare function loadRelayConfig(documents: DocumentBackend): Promise<RelayConfig | null>;
+export declare function saveRelayConfig(documents: DocumentBackend, config: RelayConfig): Promise<void>;
+/** The profile identity lives in the selected backend, with the JSON adapter retaining its old private file. */
+export declare function profileIdentity(deps: Pick<RelayPublisherDeps, 'documents' | 'profileHome'>, profile: string): Promise<string>;
+/**
+ * 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;
@@ -42,12 +50,15 @@ export declare class PresenceLeases {
     };
 }
 export interface RelayPublisherDeps {
+    documents: DocumentBackend;
     registry: StreamRegistry;
     pending: PendingPrompts;
     store: SessionStore;
     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;
@@ -67,8 +78,8 @@ export interface RelayState {
 export declare class RelayPublisher {
     readonly config: RelayConfig;
     private readonly deps;
-    private readonly key;
-    private readonly revisionPath;
+    private key;
+    private startedUnsupportedLogged;
     private lastRevision;
     private terminal;
     private readonly disabledProfiles;
@@ -82,31 +93,42 @@ export declare class RelayPublisher {
     private timer;
     private failures;
     constructor(config: RelayConfig, deps: RelayPublisherDeps);
+    initialize(): Promise<void>;
     /** Carry unpublished terminal state, queued views, and the revision floor from the publisher being replaced. */
     inherit(previous: RelayPublisher): void;
-    start(publishInitial?: boolean): void;
+    start(publishInitial?: boolean): Promise<void>;
     stop(): void;
     changed(): void;
     noteTerminal(streamId: string, phase: string): void;
     /** Queue a viewed acknowledgement; the loop sends it after the snapshot carrying the session's terminal state. */
     markViewed(sid: string, profile: string | null): void;
+    /** Bind an unconfigured deletion once, before sending, so retries cannot cross relay or profile identities. */
+    private pendingDeleted;
     /** Send the views queued before the snapshot just published, so the relay already holds every outcome they saw. */
     private flushViews;
     private nextRevision;
     private sleep;
     private run;
     /** Python `build_states`: one row per session with a live or recently terminal run in this profile. */
-    buildStates(profile: string): RelayState[];
+    buildStates(profile: string): Promise<RelayState[]>;
     publishSnapshot(isolatePermanent?: boolean): Promise<void>;
     private publishes;
     /** Validation publish for one newly enrolled profile (Python `publish_profile`). */
     publishProfile(profileId: string, expectedIdentity: string): Promise<void>;
+    private parseStarted;
+    private startedDocument;
+    private mutateStarted;
+    /** 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;
 }
 export interface RelayServiceDeps extends RelayPublisherDeps {
-    stateDir: string;
     env: Record<string, string | undefined>;
     canonicalProfile: (profile: string) => string;
     addListener: (listener: () => void) => () => void;
@@ -123,16 +145,13 @@ export declare class RelayService {
     constructor(deps: RelayServiceDeps);
     current(): RelayPublisher | null;
     /** Python `start_talaria_relay_publisher`: resume from saved state; invalid state disables the publisher. */
-    start(): boolean;
+    start(): Promise<boolean>;
     stop(): void;
     private adopt;
     /** A viewed session clears its finished runs on the relay; without a publisher there is nothing to clear. */
-    markViewed(sid: string): void;
-    /**
-     * A deleted session can never be viewed, so its finished runs are cleared once, under the profile it had (the
-     * store no longer knows it). Later lookups of the same id do not resend.
-     */
-    clearDeleted(sid: string, profile: string | null): void;
+    markViewed(sid: string): Promise<void>;
+    /** Persist before reporting successful deletion, even when publication is unavailable. */
+    clearDeleted(sid: string, profile: string | null): Promise<void>;
     /** Terminal turn events reach the relay even mid-swap (Python `note_talaria_terminal`). */
     noteTerminal(streamId: string, phase: string): void;
     /** Python `configure_talaria_relay_publisher`: validate with a real snapshot before swapping publishers. */