@maudecode/talaria-web 1.18.0 → 1.20.0

package/dist/sessions/journal.js

@@ -1,31 +1,11 @@
-/**
- * Durable run journal (Python `api/run_journal.py`): one JSONL file per
- * stream under `sessions/_run_journal/<sid>/<stream_id>.jsonl`, contiguous
- * `seq` from 1, `event_id = <stream_id>:<seq>`, fsync on terminal rows.
- */
-import { rmSync } from 'node:fs';
-import { closeSync, existsSync, fsyncSync, lstatSync, mkdirSync, openSync, readdirSync, readFileSync, statSync, unlinkSync, constants as fsConstants } from 'node:fs';
-import { open, readdir, readFile, stat, unlink } from 'node:fs/promises';
-import { setImmediate as nextTurn } from 'node:timers/promises';
-import { atomicWriteTextAsync, writeFully } from '../fs/atomic.js';
-import { join } from 'node:path';
-import { StringDecoder } from 'node:string_decoder';
 import { str } from '../util.js';
 export const RUN_JOURNAL_DIR_NAME = '_run_journal';
 export const TERMINAL_SSE_EVENTS = new Set(['done', 'cancel', 'apperror', 'error', 'stream_end']);
 export const SSE_RELAY_CLOSE_EVENTS = new Set(['stream_end', 'cancel', 'apperror', 'error']);
 const SAFE_ID_RE = /^[A-Za-z0-9_.-]+$/;
-const SESSION_REPLAY_MAX_BYTES = 4 * 1024 * 1024;
-const SESSION_REPLAY_MAX_ROWS = 4096;
-const LIVE_SNAPSHOT_MAX_BYTES = 1024 * 1024;
-const LIVE_SNAPSHOT_MAX_ROWS = 512;
-const RUN_SUMMARY_MAX_BYTES = 4 * 1024 * 1024;
-const RUN_SUMMARY_MAX_ROWS = 512;
-const RUN_EVENTS_PAGE_BYTES = 64 * 1024;
-const PRUNED_SUMMARY_SUFFIX = '.summary.json';
 export function validateId(value, field) {
     const v = value || '';
-    if (!v || !SAFE_ID_RE.test(v))
+    if (!v || !SAFE_ID_RE.test(v) || /^\.+$/.test(v))
         throw new Error(`${field} must match [A-Za-z0-9_.-]+`);
     return v;
 }
@@ -56,591 +36,20 @@ export function terminalStateForEvent(eventName, payload) {
         return state === 'cancelled' ? 'interrupted-by-user' : state === 'interrupted' ? 'interrupted-by-crash' : 'errored';
     return null;
 }
-export class RunJournal {
-    sessionDir;
-    env;
-    constructor(sessionDir, env = {}) {
-        this.sessionDir = sessionDir;
-        this.env = env;
-    }
-    root() {
-        return join(this.sessionDir, RUN_JOURNAL_DIR_NAME);
-    }
-    pathFor(sessionId, runId) {
-        return join(this.root(), validateId(sessionId, 'session_id'), `${validateId(runId, 'run_id')}.jsonl`);
-    }
-    /** Python `delete_run_journal`: remove one session's journal directory; false for a missing or unsafe id. */
-    deleteSession(sessionId) {
-        if (/^\.+$/.test(sessionId))
-            return false;
-        let dir;
-        try {
-            dir = join(this.root(), validateId(sessionId, 'session_id'));
-        }
-        catch {
-            return false;
-        }
-        if (dir === this.root() || !existsSync(dir))
-            return false;
-        try {
-            rmSync(dir, { recursive: true, force: true });
-        }
-        catch {
-            return false;
-        }
-        return !existsSync(dir);
-    }
-    fsyncMode() {
-        const mode = (this.env.HERMES_WEBUI_RUN_JOURNAL_FSYNC ?? 'terminal-only').trim().toLowerCase();
-        return mode === 'eager' ? 'eager' : 'terminal-only';
-    }
-    writer(sessionId, runId) {
-        return new RunJournalWriter(this, sessionId, runId, this.fsyncMode());
-    }
-    static parseLines(text) {
-        const events = [];
-        let malformed = 0;
-        for (const raw of text.split('\n')) {
-            if (!raw.trim())
-                continue;
-            try {
-                const parsed = JSON.parse(raw);
-                if (parsed && typeof parsed === 'object' && !Array.isArray(parsed))
-                    events.push(parsed);
-                else
-                    malformed += 1;
-            }
-            catch {
-                malformed += 1;
-            }
-        }
-        return { events, malformed };
-    }
-    readRunEvents(sessionId, runId, opts = {}) {
-        return [...this.iterRunEvents(sessionId, runId, opts)];
-    }
-    /**
-     * `readRunEvents` one page at a time, so a replay that waits on a slow reader holds one page of the journal rather
-     * than all of it (run-state contract: recovery never parses an unbounded journal in one request).
-     */
-    *iterRunEvents(sessionId, runId, opts = {}) {
-        let fd;
-        try {
-            fd = openSync(this.pathFor(sessionId, runId), fsConstants.O_RDONLY);
-        }
-        catch {
-            return;
-        }
-        try {
-            const page = Buffer.alloc(RUN_EVENTS_PAGE_BYTES);
-            const decoder = new StringDecoder('utf8');
-            let position = 0;
-            let rest = '';
-            for (;;) {
-                let n = 0;
-                try {
-                    n = readSyncAt(fd, page, 0, position);
-                }
-                catch {
-                    n = 0;
-                }
-                position += n;
-                const lines = (rest + (n > 0 ? decoder.write(page.subarray(0, n)) : decoder.end())).split('\n');
-                rest = n > 0 ? lines.pop() ?? '' : '';
-                for (const event of RunJournal.parseLines(lines.join('\n')).events) {
-                    const seq = event.seq || 0;
-                    if (opts.afterSeq !== null && opts.afterSeq !== undefined && seq <= opts.afterSeq)
-                        continue;
-                    if (opts.maxSeq !== null && opts.maxSeq !== undefined && seq > opts.maxSeq)
-                        continue;
-                    yield event;
-                }
-                if (n <= 0)
-                    return;
-            }
-        }
-        finally {
-            closeSync(fd);
-        }
-    }
-    readRunEventTail(sessionId, runId, maxBytes = LIVE_SNAPSHOT_MAX_BYTES, maxRows = LIVE_SNAPSHOT_MAX_ROWS) {
-        const path = this.pathFor(sessionId, runId);
-        let raw;
-        let start = 0;
-        try {
-            const size = statSync(path).size;
-            start = Math.max(0, size - maxBytes);
-            const fd = openSync(path, fsConstants.O_RDONLY);
-            try {
-                raw = Buffer.alloc(Math.min(size, maxBytes));
-                let got = 0;
-                while (got < raw.length) {
-                    const n = readSyncAt(fd, raw, got, start + got);
-                    if (n <= 0)
-                        break;
-                    got += n;
-                }
-                raw = raw.subarray(0, got);
-            }
-            finally {
-                closeSync(fd);
-            }
-        }
-        catch {
-            return { events: [], truncated: false };
-        }
-        return RunJournal.parseTail(raw, start, maxRows);
-    }
-    /** The bounded tail of `raw`, read from byte `start`: drop the partial first line, keep the last `maxRows` rows. */
-    static parseTail(raw, start, maxRows) {
-        let text = raw.toString('utf8');
-        if (start) {
-            const nl = text.indexOf('\n');
-            text = nl < 0 ? '' : text.slice(nl + 1);
-        }
-        const lines = text.split('\n').filter((l) => l.length > 0);
-        const rowsTruncated = lines.length > maxRows;
-        const { events } = RunJournal.parseLines(lines.slice(-maxRows).join('\n'));
-        return { events, truncated: start > 0 || rowsTruncated };
-    }
-    /** `readRunEventTail` off the event loop, plus the identity of the file it read. */
-    static async readTailAsync(path, maxBytes, maxRows) {
-        const handle = await open(path, 'r');
-        try {
-            const st = await handle.stat({ bigint: true });
-            const size = Number(st.size);
-            const start = Math.max(0, size - maxBytes);
-            const raw = Buffer.alloc(Math.min(size, maxBytes));
-            let got = 0;
-            while (got < raw.length) {
-                const { bytesRead } = await handle.read(raw, got, raw.length - got, start + got);
-                if (bytesRead <= 0)
-                    break;
-                got += bytesRead;
-            }
-            return { events: RunJournal.parseTail(raw.subarray(0, got), start, maxRows).events, st };
-        }
-        finally {
-            await handle.close();
-        }
-    }
-    static selectAuthoritativeTerminalEvent(events) {
-        const terminal = events.filter((e) => e.terminal);
-        for (let i = terminal.length - 1; i >= 0; i -= 1)
-            if (terminal[i]?.event !== 'stream_end')
-                return terminal[i] ?? null;
-        return terminal[terminal.length - 1] ?? null;
-    }
-    static summaryFromEvents(sessionId, runId, events) {
-        const last = events[events.length - 1] ?? null;
-        const terminal = RunJournal.selectAuthoritativeTerminalEvent(events);
-        return {
-            session_id: sessionId, run_id: runId, stream_id: runId, event_count: events.length, last_seq: last?.seq ?? 0,
-            last_event_id: last?.event_id ?? null, terminal: Boolean(terminal), terminal_state: terminal ? (terminal.terminal_state ?? 'completed') : (events.length ? 'running' : 'unknown'),
-            last_event: last?.event ?? null,
-        };
-    }
-    loadPrunedSummary(path) {
-        try {
-            const parsed = JSON.parse(readFileSync(path.replace(/\.jsonl$/, PRUNED_SUMMARY_SUFFIX), 'utf8'));
-            return parsed && typeof parsed === 'object' ? parsed : null;
-        }
-        catch {
-            return null;
-        }
-    }
-    latestRunSummary(sessionId, runId) {
-        const path = this.pathFor(sessionId, runId);
-        if (!existsSync(path)) {
-            const pruned = this.loadPrunedSummary(path);
-            if (pruned)
-                return pruned;
-        }
-        const tail = this.readRunEventTail(sessionId, runId, RUN_SUMMARY_MAX_BYTES, RUN_SUMMARY_MAX_ROWS);
-        const summary = RunJournal.summaryFromEvents(sessionId, runId, tail.events);
-        const last = tail.events[tail.events.length - 1];
-        if (last)
-            summary.event_count = last.seq || tail.events.length;
-        summary.journal_truncated = tail.truncated;
-        return summary;
-    }
-    /**
-     * Python `prune_settled_run_journals`: compact terminal journals older than
-     * `HERMES_WEBUI_RUN_JOURNAL_RETENTION_DAYS` (14) into `.summary.json`, keeping
-     * the `HERMES_WEBUI_RUN_JOURNAL_KEEP_RECENT` (3) newest per session and any
-     * path with a live writer.
-     *
-     * The sweep is incremental so requests keep running on the event loop: I/O is
-     * async and it yields after every session and every parsed journal. Sessions
-     * whose metadata already rules out pruning (no more journals than the keep
-     * count, or none past the cutoff) are not parsed, so `terminal` counts only
-     * the journals inspected. `signal` stops the sweep at its next yield;
-     * `pause` replaces the default yield (`setImmediate`).
-     */
-    async pruneSettled(opts = {}) {
-        const result = { examined: 0, terminal: 0, pruned: 0, bytes_reclaimed: 0 };
-        const days = Number.parseFloat(this.env.HERMES_WEBUI_RUN_JOURNAL_RETENTION_DAYS ?? '14');
-        const retention = opts.retentionSeconds ?? (Number.isFinite(days) ? Math.max(0, days) * 86400 : 14 * 86400);
-        const keepEnv = Number.parseInt(this.env.HERMES_WEBUI_RUN_JOURNAL_KEEP_RECENT ?? '3', 10);
-        const keep = opts.keepRecent ?? (Number.isFinite(keepEnv) ? Math.max(0, keepEnv) : 3);
-        const now = opts.now ?? Date.now() / 1000;
-        const cutoff = now - retention;
-        const root = this.root();
-        // Yield to queued requests, then report whether the sweep may continue.
-        const proceed = async () => { await (opts.pause ?? nextTurn)(); return !opts.signal?.aborted; };
-        if (retention <= 0 || !existsSync(root))
-            return result;
-        const sessions = (await readdir(root, { withFileTypes: true })).filter((d) => d.isDirectory() && SAFE_ID_RE.test(d.name)).map((d) => d.name).sort();
-        for (const sid of sessions) {
-            if (!(await proceed()))
-                return result;
-            const dir = join(root, sid);
-            // The session may be deleted while the sweep runs.
-            let names;
-            try {
-                names = (await readdir(dir)).filter((n) => n.endsWith('.jsonl')).sort();
-            }
-            catch {
-                continue;
-            }
-            result.examined += names.length;
-            let expired = 0;
-            for (const name of names) {
-                if (opts.signal?.aborted)
-                    return result;
-                try {
-                    if ((await stat(join(dir, name))).mtimeMs / 1000 <= cutoff)
-                        expired += 1;
-                }
-                catch { /* vanished */ }
-            }
-            if (names.length <= keep || expired === 0)
-                continue;
-            const terminalRuns = [];
-            for (const name of names) {
-                const path = join(dir, name);
-                let tail;
-                try {
-                    tail = await RunJournal.readTailAsync(path, RUN_SUMMARY_MAX_BYTES, RUN_SUMMARY_MAX_ROWS);
-                }
-                catch {
-                    continue;
-                }
-                const summary = RunJournal.summaryFromEvents(sid, name.slice(0, -'.jsonl'.length), tail.events);
-                if (summary.terminal) {
-                    result.terminal += 1;
-                    terminalRuns.push({ st: tail.st, path, summary });
-                }
-                if (!(await proceed()))
-                    return result;
-            }
-            terminalRuns.sort((a, b) => (b.st.mtimeNs > a.st.mtimeNs ? 1 : b.st.mtimeNs < a.st.mtimeNs ? -1 : b.path.localeCompare(a.path)));
-            for (const { st, path, summary } of terminalRuns.slice(keep)) {
-                if (opts.signal?.aborted)
-                    return result;
-                const mtime = Number(st.mtimeNs) / 1e9;
-                if (mtime > cutoff)
-                    continue;
-                // Still the parsed file with no live writer. ctime catches a replacement that reuses the inode, size, and mtime.
-                const stillPrunable = () => {
-                    if (opts.isActive?.(path))
-                        return false;
-                    let cur;
-                    try {
-                        cur = lstatSync(path, { bigint: true });
-                    }
-                    catch {
-                        return false;
-                    }
-                    return cur.isFile() && cur.dev === st.dev && cur.ino === st.ino && cur.size === st.size && cur.mtimeNs === st.mtimeNs && cur.ctimeNs === st.ctimeNs;
-                };
-                if (!stillPrunable())
-                    continue;
-                const size = Number(st.size);
-                if (opts.dryRun) {
-                    result.pruned += 1;
-                    result.bytes_reclaimed += size;
-                    continue;
-                }
-                const summaryPath = path.replace(/\.jsonl$/, PRUNED_SUMMARY_SUFFIX);
-                const pruned = { ...summary, journal_pruned: true, journal_pruned_at: now, original_size: size, original_mtime: mtime };
-                const prior = await readFile(summaryPath, 'utf8').catch(() => null);
-                try {
-                    await atomicWriteTextAsync(summaryPath, JSON.stringify(pruned));
-                }
-                catch {
-                    continue;
-                }
-                // Re-check after the write's async gap; no await separates this check from the unlink.
-                if (!stillPrunable()) {
-                    // Roll back to the summary that was there before, if any.
-                    await (prior === null ? unlink(summaryPath) : atomicWriteTextAsync(summaryPath, prior)).catch(() => undefined);
-                    continue;
-                }
-                try {
-                    unlinkSync(path);
-                }
-                catch {
-                    continue;
-                }
-                result.pruned += 1;
-                result.bytes_reclaimed += size;
-            }
-        }
-        return result;
-    }
-    /** Locate a run across sessions (Python `find_run_summary`). */
-    findRunSummary(runId) {
-        let rid;
-        try {
-            rid = validateId(runId, 'run_id');
-        }
-        catch {
-            return null;
-        }
-        let sessions;
-        try {
-            sessions = readdirSync(this.root());
-        }
-        catch {
-            return null;
-        }
-        for (const sid of sessions) {
-            const path = join(this.root(), sid, `${rid}.jsonl`);
-            if (existsSync(path)) {
-                const summary = this.latestRunSummary(sid, rid);
-                summary.path = path;
-                return summary;
-            }
-        }
-        for (const sid of sessions) {
-            const summaryPath = join(this.root(), sid, `${rid}${PRUNED_SUMMARY_SUFFIX}`);
-            if (existsSync(summaryPath)) {
-                const summary = this.loadPrunedSummary(join(this.root(), sid, `${rid}.jsonl`));
-                if (summary) {
-                    summary.path = summaryPath;
-                    return summary;
-                }
-            }
-        }
-        return null;
-    }
-    sessionJournalFingerprint(sessionId) {
-        let sid;
-        try {
-            sid = validateId(sessionId, 'session_id');
-        }
-        catch {
-            return '0:0:0';
-        }
-        const dir = join(this.root(), sid);
-        let count = 0;
-        let maxMtime = 0;
-        let total = 0;
-        try {
-            for (const name of readdirSync(dir)) {
-                if (!name.endsWith('.jsonl'))
-                    continue;
-                const st = statSync(join(dir, name));
-                count += 1;
-                total += st.size;
-                maxMtime = Math.max(maxMtime, st.mtimeMs);
-            }
-        }
-        catch {
-            return '0:0:0';
-        }
-        return `${String(count)}:${String(maxMtime)}:${String(total)}`;
-    }
-    /** Python `read_session_run_events`: replay rows after an opaque cursor across a session's runs. */
-    readSessionRunEvents(sessionId, afterEventId) {
-        const sid = validateId(sessionId, 'session_id');
-        const rawCursor = (afterEventId ?? '').trim();
-        const parsedCursor = parseRunJournalEventId(rawCursor);
-        const cursorRunId = parsedCursor[0];
-        let cursorSeq = parsedCursor[1];
-        if (rawCursor && cursorRunId !== null) {
-            try {
-                validateId(cursorRunId, 'run_id');
-            }
-            catch {
-                cursorSeq = null;
-            }
-        }
-        if (rawCursor && (cursorRunId === null || cursorSeq === null || cursorSeq <= 0))
-            return { status: 'cursor_invalid', events: [], cursor_run_id: cursorRunId, cursor_seq: cursorSeq };
-        if (!rawCursor)
-            return { status: 'ok', events: [], cursor_run_id: null, cursor_seq: null };
-        const sessionRoot = join(this.root(), sid);
-        const runs = [];
-        let retainedRows = 0;
-        let retainedBytes = 0;
-        let names = [];
-        try {
-            names = readdirSync(sessionRoot).filter((n) => n.endsWith('.jsonl')).sort();
-        }
-        catch {
-            names = [];
-        }
-        for (const name of names) {
-            const runId = name.slice(0, -'.jsonl'.length);
-            try {
-                validateId(runId, 'run_id');
-            }
-            catch {
-                continue;
-            }
-            const path = join(sessionRoot, name);
-            let text;
-            try {
-                text = readFileSync(path, 'utf8');
-            }
-            catch {
-                continue;
-            }
-            retainedBytes += Buffer.byteLength(text);
-            if (retainedBytes > SESSION_REPLAY_MAX_BYTES)
-                return { status: 'replay_limit_bytes', events: [], cursor_run_id: cursorRunId, cursor_seq: cursorSeq };
-            const events = [];
-            let expected = 1;
-            for (const line of text.split('\n')) {
-                if (!line.trim())
-                    continue;
-                let event;
-                try {
-                    event = JSON.parse(line);
-                }
-                catch {
-                    return { status: 'replay_malformed', events: [], cursor_run_id: cursorRunId, cursor_seq: cursorSeq };
-                }
-                const seq = event.seq;
-                if (seq !== expected || event.event_id !== `${runId}:${String(seq)}` || event.run_id !== runId || event.session_id !== sid) {
-                    return { status: 'replay_noncontiguous', events: [], cursor_run_id: cursorRunId, cursor_seq: cursorSeq };
-                }
-                expected += 1;
-                retainedRows += 1;
-                if (retainedRows > SESSION_REPLAY_MAX_ROWS)
-                    return { status: 'replay_limit_rows', events: [], cursor_run_id: cursorRunId, cursor_seq: cursorSeq };
-                events.push(event);
-            }
-            let createdAt = Number.POSITIVE_INFINITY;
-            for (const e of events)
-                createdAt = Math.min(createdAt, e.created_at || 0);
-            if (!Number.isFinite(createdAt)) {
-                try {
-                    createdAt = statSync(path).mtimeMs / 1000;
-                }
-                catch {
-                    createdAt = 0;
-                }
-            }
-            runs.push({ createdAt, runId, events });
-        }
-        runs.sort((a, b) => a.createdAt - b.createdAt || (a.runId < b.runId ? -1 : a.runId > b.runId ? 1 : 0));
-        const cursorIndex = runs.findIndex((r) => r.runId === cursorRunId);
-        if (cursorIndex < 0) {
-            if (cursorRunId && existsSync(join(sessionRoot, `${cursorRunId}${PRUNED_SUMMARY_SUFFIX}`)))
-                return { status: 'cursor_pruned', events: [], cursor_run_id: cursorRunId, cursor_seq: cursorSeq };
-            let foreign = false;
-            try {
-                for (const other of readdirSync(this.root()))
-                    if (other !== sid && cursorRunId && existsSync(join(this.root(), other, `${cursorRunId}.jsonl`)))
-                        foreign = true;
-            }
-            catch { /* none */ }
-            return { status: foreign ? 'cursor_session_mismatch' : 'cursor_run_missing', events: [], cursor_run_id: cursorRunId, cursor_seq: cursorSeq };
-        }
-        const cursorEvents = runs[cursorIndex]?.events ?? [];
-        if (cursorSeq === null || cursorSeq > cursorEvents.length)
-            return { status: 'cursor_event_missing', events: [], cursor_run_id: cursorRunId, cursor_seq: cursorSeq };
-        const replay = cursorEvents.filter((e) => e.seq > (cursorSeq));
-        for (const run of runs.slice(cursorIndex + 1))
-            replay.push(...run.events);
-        return { status: 'ok', events: replay, cursor_run_id: cursorRunId, cursor_seq: cursorSeq };
-    }
-    /** Python `stale_interrupted_event`: a synthetic terminal row for a journal whose worker died. */
-    staleInterruptedEvent(sessionId, runId, afterSeq = null, now = Date.now() / 1000) {
-        const summary = this.latestRunSummary(sessionId, runId);
-        if (summary.terminal || !summary.event_count)
-            return null;
-        const seq = (summary.last_seq || 0) + 1;
-        if (afterSeq !== null && seq <= afterSeq)
-            return null;
-        return {
-            version: 1, event_id: `${runId}:${String(seq)}`, seq, run_id: runId, session_id: sessionId, event: 'apperror', type: 'apperror', created_at: now, terminal: true, terminal_state: 'lost-worker-bookkeeping',
-            payload: { type: 'interrupted', recovery_control: true, message: 'The live worker stopped before this run finished.', hint: 'The transcript was restored to the last journaled event. Start a new turn if you still need the task to continue.', session_id: sessionId, stream_id: runId, journal_last_seq: summary.last_seq },
-            synthetic: true,
-        };
-    }
+export function selectAuthoritativeTerminalEvent(events) {
+    const terminal = events.filter((e) => e.terminal);
+    for (let i = terminal.length - 1; i >= 0; i -= 1)
+        if (terminal[i]?.event !== 'stream_end')
+            return terminal[i] ?? null;
+    return terminal[terminal.length - 1] ?? null;
 }
-import { readSync } from 'node:fs';
-function readSyncAt(fd, buf, offset, position) {
-    return readSync(fd, buf, offset, buf.length - offset, position);
-}
-export class RunJournalWriter {
-    journal;
-    sessionId;
-    runId;
-    fsyncMode;
-    now;
-    fd = null;
-    seq = 0;
-    closed = false;
-    path;
-    constructor(journal, sessionId, runId, fsyncMode, now = () => Date.now() / 1000) {
-        this.journal = journal;
-        this.sessionId = sessionId;
-        this.runId = runId;
-        this.fsyncMode = fsyncMode;
-        this.now = now;
-        this.path = journal.pathFor(sessionId, runId);
-        // Resume the sequence when a journal already exists for this stream id (never in practice; ids are fresh).
-        try {
-            const existing = journal.readRunEvents(sessionId, runId);
-            this.seq = existing[existing.length - 1]?.seq ?? 0;
-        }
-        catch {
-            this.seq = 0;
-        }
-    }
-    appendSseEvent(eventName, payload, meta = {}) {
-        if (this.closed)
-            throw new Error('run journal writer is closed');
-        const name = eventName.trim();
-        if (!name)
-            throw new Error('event_name is required');
-        const terminalState = terminalStateForEvent(name, payload);
-        this.seq += 1;
-        const event = {
-            version: 1, event_id: `${this.runId}:${String(this.seq)}`, seq: this.seq, run_id: this.runId, session_id: this.sessionId, event: name, type: name,
-            created_at: this.now(), terminal: Boolean(terminalState), terminal_state: terminalState, payload: payload ?? {},
-            ...(meta.redacted === undefined ? {} : { redacted: meta.redacted }),
-        };
-        mkdirSync(join(this.path, '..'), { recursive: true });
-        this.fd ??= openSync(this.path, fsConstants.O_CREAT | fsConstants.O_APPEND | fsConstants.O_WRONLY, 0o600);
-        writeFully(this.fd, `${JSON.stringify(event)}\n`);
-        if (this.fsyncMode === 'eager' || terminalState) {
-            try {
-                fsyncSync(this.fd);
-            }
-            catch { /* best effort */ }
-        }
-        if (SSE_RELAY_CLOSE_EVENTS.has(name))
-            this.closeHandle();
-        return event;
-    }
-    closeHandle() {
-        if (this.fd !== null) {
-            try {
-                closeSync(this.fd);
-            }
-            catch { /* ignore */ }
-            this.fd = null;
-        }
-    }
-    close() {
-        this.closeHandle();
-        this.closed = true;
-    }
+export function summaryFromEvents(sessionId, runId, events) {
+    const last = events[events.length - 1] ?? null;
+    const terminal = selectAuthoritativeTerminalEvent(events);
+    return {
+        session_id: sessionId, run_id: runId, stream_id: runId, event_count: events.length, last_seq: last?.seq ?? 0,
+        last_event_id: last?.event_id ?? null, terminal: Boolean(terminal), terminal_state: terminal ? (terminal.terminal_state ?? 'completed') : (events.length ? 'running' : 'unknown'),
+        last_event: last?.event ?? null,
+    };
 }
 //# sourceMappingURL=journal.js.map