@svenroth-ai/shipwright 0.27.0 → 0.29.0

package/server/dist/core/session-info/collect.js

@@ -0,0 +1,248 @@
+/*
+ * One-pass fact collector over the lines of ONE session/subagent JSONL.
+ * Pure (string in, facts out) so the same code serves the session file and
+ * every `subagents/agent-*.jsonl`. Cheap `includes()` pre-filters keep the
+ * JSON.parse bill off the (many, large) lines that cannot matter.
+ */
+import path from "node:path";
+const OUTPUT_TOOLS = new Set(["Write", "Edit", "NotebookEdit", "MultiEdit"]);
+export function newFacts() {
+    return {
+        pendingUse: new Set(),
+        toolResults: new Map(),
+        outputUses: new Map(),
+        outputAttempts: new Map(),
+        usage: null,
+        usageSeq: -1,
+        compactions: [],
+        bridgeSeen: false,
+        outputs: new Map(),
+        notifications: new Map(),
+        agentToolUses: new Map(),
+        firstTs: null,
+        lastTs: null,
+        lastAssistantText: null,
+        model: null,
+        seq: 0,
+    };
+}
+export const TEXT_CAP = 4000;
+const capText = (s) => (s && s.length > TEXT_CAP ? `${s.slice(0, TEXT_CAP)}…` : s);
+const num = (v) => (typeof v === "number" && Number.isFinite(v) ? v : null);
+const str = (v) => (typeof v === "string" ? v : null);
+/** Windows-style when the string looks like a drive/UNC path, else POSIX. */
+function normalizeAbsolute(p, cwd) {
+    const isWin = (s) => /^[A-Za-z]:[\\/]/.test(s) || s.startsWith("\\\\");
+    if (isWin(p))
+        return path.win32.normalize(p);
+    if (p.startsWith("/"))
+        return cwd && isWin(cwd) ? null : path.posix.normalize(p);
+    if (!cwd || !(isWin(cwd) || cwd.startsWith("/")))
+        return null; // relative path with no absolute cwd to anchor it — unknowable
+    return isWin(cwd) ? path.win32.resolve(cwd, p) : path.posix.resolve(cwd, p);
+}
+export function outputKey(p) {
+    return /^[A-Za-z]:|^\\\\/.test(p) ? p.toLowerCase() : p;
+}
+function textOf(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return null;
+    const parts = content
+        .filter((b) => !!b && b.type === "text" && typeof b.text === "string")
+        .map((b) => b.text);
+    return parts.length ? parts.join("\n") : null;
+}
+const NOTIF_RE = /<task-notification>([\s\S]*?)<\/task-notification>/g;
+/** First `<name>…</name>` content, by plain string search — `name` is never a pattern. */
+export const tag = (body, name) => {
+    const open = `<${name}>`;
+    const start = body.indexOf(open);
+    if (start < 0)
+        return null;
+    const from = start + open.length;
+    const end = body.indexOf(`</${name}>`, from);
+    return end < 0 ? null : body.slice(from, end).trim();
+};
+function takeNotifications(text, into, at) {
+    for (const m of text.matchAll(NOTIF_RE)) {
+        const body = m[1];
+        const taskId = tag(body, "task-id");
+        if (!taskId)
+            continue;
+        const d = tag(body, "duration_ms");
+        const t = tag(body, "subagent_tokens");
+        const u = tag(body, "tool_uses");
+        // Later notifications win: an agent can be resumed and notify again.
+        into.set(taskId, {
+            at,
+            taskId,
+            toolUseId: tag(body, "tool-use-id"),
+            status: tag(body, "status"),
+            durationMs: d && /^\d+$/.test(d) ? Number(d) : null,
+            tokens: t && /^\d+$/.test(t) ? Number(t) : null,
+            toolUses: u && /^\d+$/.test(u) ? Number(u) : null,
+        });
+    }
+}
+/** Cheap timestamp peek so non-matching lines never reach JSON.parse. */
+export function quickTimestamp(line) {
+    const i = line.lastIndexOf('"timestamp":"');
+    if (i === -1)
+        return null;
+    const j = line.indexOf('"', i + 13);
+    return j === -1 || j - i > 60 ? null : line.slice(i + 13, j);
+}
+function retractAttempt(f, key, id) {
+    const list = (f.outputAttempts.get(key) ?? []).filter((a) => a.id !== id);
+    f.outputAttempts.set(key, list);
+    const out = f.outputs.get(key);
+    if (!out)
+        return;
+    if (!list.length) {
+        f.outputs.delete(key);
+        return;
+    }
+    out.firstAt = list[0].ts;
+    out.lastAt = list[list.length - 1].ts;
+    out.tool = list[list.length - 1].tool;
+}
+export function ingestLine(f, line, agentId) {
+    f.seq++;
+    const hasNotif = line.includes("<task-notification>") && line.includes("<task-id>");
+    const mayMatter = hasNotif ||
+        line.includes('"assistant"') ||
+        line.includes('"bridge-session"') ||
+        line.includes('"compact_boundary"') ||
+        line.includes('"tool_result"');
+    const lineTs = quickTimestamp(line);
+    if (lineTs) {
+        if (!f.firstTs)
+            f.firstTs = lineTs;
+        f.lastTs = lineTs;
+    }
+    if (!mayMatter)
+        return;
+    let o;
+    try {
+        const parsed = JSON.parse(line);
+        if (!parsed || typeof parsed !== "object")
+            return;
+        o = parsed;
+    }
+    catch {
+        return; // torn / non-JSON line
+    }
+    const type = o.type;
+    const ts = str(o.timestamp);
+    if (ts) {
+        if (lineTs === null || lineTs !== ts)
+            f.lastTs = ts; // the record's own stamp beats the cheap peek
+        if (!f.firstTs || f.firstTs === lineTs)
+            f.firstTs = ts;
+    }
+    if (type === "bridge-session") {
+        f.bridgeSeen = true;
+        return;
+    }
+    if (type === "attachment")
+        return; // prompt snapshots quote tool docs verbatim; never facts
+    const msg = o.message;
+    if (hasNotif && (type === "user" || type === "queue-operation")) {
+        const text = textOf(msg?.content) ?? str(o.content);
+        if (text)
+            takeNotifications(text, f.notifications, ts);
+    }
+    if (type === "user" && Array.isArray(msg?.content) && line.includes('"tool_result"')) {
+        const tur = (o.toolUseResult ?? {});
+        const single = msg.content.filter((b) => b?.type === "tool_result").length === 1;
+        for (const b of msg.content) {
+            if (!b || b.type !== "tool_result" || !str(b.tool_use_id))
+                continue;
+            const id = b.tool_use_id;
+            // A background launch is acknowledged by an immediate non-error result; it is NOT completion.
+            if (single && (tur.isAsync === true || tur.status === "async_launched"))
+                continue;
+            const isError = b.is_error === true;
+            f.pendingUse.delete(id);
+            f.toolResults.set(id, {
+                at: ts,
+                isError,
+                // toolUseResult describes ONE result; only trust it when the line carries exactly one.
+                status: single ? str(tur.status) : null,
+                durationMs: single ? num(tur.totalDurationMs) : null,
+                tokens: single ? num(tur.totalTokens) : null,
+                toolUses: single ? num(tur.totalToolUseCount) : null,
+            });
+            const key = f.outputUses.get(id);
+            if (isError && key)
+                retractAttempt(f, key, id);
+        }
+        return;
+    }
+    if (type === "system" && o.subtype === "compact_boundary") {
+        const cm = (o.compactMetadata ?? {});
+        f.compactions.push({ at: ts, preTokens: num(cm.preTokens), postTokens: num(cm.postTokens), seq: f.seq });
+        return;
+    }
+    if (type !== "assistant" || !msg || (o.isSidechain === true && agentId === null))
+        return;
+    const model = str(msg.model);
+    const usage = msg.usage;
+    if (model !== "<synthetic>") {
+        if (model)
+            f.model = model;
+        if (usage) {
+            f.usage = {
+                tokens: (num(usage.input_tokens) ?? 0) + (num(usage.cache_read_input_tokens) ?? 0) + (num(usage.cache_creation_input_tokens) ?? 0),
+                model,
+                at: ts,
+            };
+            f.usageSeq = f.seq;
+        }
+    }
+    const content = msg.content;
+    if (!Array.isArray(content))
+        return;
+    let text = null;
+    for (const b of content) {
+        if (!b || typeof b !== "object")
+            continue;
+        if (b.type === "text" && typeof b.text === "string" && b.text.trim())
+            text = b.text;
+        if (b.type !== "tool_use")
+            continue;
+        if (str(b.id))
+            f.pendingUse.add(b.id);
+        const name = str(b.name);
+        const input = (b.input ?? {});
+        if ((name === "Agent" || name === "Task") && str(b.id)) {
+            f.agentToolUses.set(b.id, { background: input.run_in_background === true, prompt: capText(str(input.prompt)), description: capText(str(input.description)) });
+        }
+        else if (name && OUTPUT_TOOLS.has(name)) {
+            const raw = str(input.file_path) ?? str(input.notebook_path);
+            const abs = raw ? normalizeAbsolute(raw, str(o.cwd)) : null;
+            if (!abs)
+                continue;
+            const key = outputKey(abs);
+            const prev = f.outputs.get(key);
+            const tool = name;
+            if (str(b.id))
+                f.outputUses.set(b.id, key);
+            const list = f.outputAttempts.get(key) ?? [];
+            list.push({ id: str(b.id), ts, tool });
+            f.outputAttempts.set(key, list);
+            if (prev) {
+                prev.lastAt = ts ?? prev.lastAt;
+                prev.tool = name;
+            }
+            else {
+                f.outputs.set(key, { path: abs, tool: name, firstAt: ts, lastAt: ts, agentId });
+            }
+        }
+    }
+    if (text)
+        f.lastAssistantText = capText(text);
+}
+//# sourceMappingURL=collect.js.map

package/server/dist/core/session-info/collect.js.map

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

package/server/dist/core/session-info/line-scan.d.ts

@@ -0,0 +1,20 @@
+import { type OpenForRead } from "../session-jsonl-io.js";
+export declare const SCAN_CHUNK_BYTES: number;
+export declare const MAX_LINE_BYTES: number;
+export interface ScanOptions {
+    chunkBytes?: number;
+    maxLineBytes?: number;
+    openForRead?: OpenForRead;
+    /** Called at the start of every attempt (readWithRetry re-runs the whole scan): reset consumer state here. */
+    onAttempt?: () => void;
+}
+export interface LineScanResult {
+    /** Window began after byte 0 — older history was not seen. */
+    truncated: boolean;
+    scannedBytes: number;
+    sizeBytes: number;
+}
+export declare function scanLines(filePath: string, maxBytes: number, onLine: (line: string) => void, opts?: ScanOptions): Promise<LineScanResult>;
+/** First line of the file (≤ `headBytes`), for the start timestamp when the scan window skipped it. */
+export declare function readFirstLine(filePath: string, headBytes?: number, openForRead?: OpenForRead): Promise<string | null>;
+//# sourceMappingURL=line-scan.d.ts.map

package/server/dist/core/session-info/line-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-scan.d.ts","sourceRoot":"","sources":["../../../src/core/session-info/line-scan.ts"],"names":[],"mappings":"AAcA,OAAO,EAA+B,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvF,eAAO,MAAM,gBAAgB,QAAkB,CAAC;AAChD,eAAO,MAAM,cAAc,QAAkB,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,8GAA8G;IAC9G,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC9B,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,cAAc,CAAC,CA0DzB;AAED,uGAAuG;AACvG,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAa,EACtB,WAAW,GAAE,WAA0B,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB"}

package/server/dist/core/session-info/line-scan.js

@@ -0,0 +1,109 @@
+/*
+ * Bounded, read-only, line-oriented scan of a (possibly 100 MB+) session JSONL.
+ *
+ * Reads the NEWEST `maxBytes` of the file in fixed-size POSITIONAL chunks via
+ * the same open/stat/read shape as `session-jsonl-io.ts` (never a whole-file
+ * read — CLAUDE.md rule 6) wrapped in its `readWithRetry` torn-read envelope.
+ * Lines are cut on 0x0A only and decoded per line, so a multi-byte character
+ * can never be split across a chunk (rule 5). When the window starts mid-line
+ * the first (partial) line is dropped; a record above MAX_LINE_BYTES is skipped
+ * undecoded (huge tool results hold none of the facts we collect).
+ */
+import { open } from "node:fs/promises";
+import { ENOENT_FATAL, readWithRetry } from "../session-jsonl-io.js";
+export const SCAN_CHUNK_BYTES = 4 * 1024 * 1024;
+export const MAX_LINE_BYTES = 8 * 1024 * 1024;
+const openReadOnly = (p) => open(p, "r");
+export async function scanLines(filePath, maxBytes, onLine, opts = {}) {
+    const chunkBytes = opts.chunkBytes ?? SCAN_CHUNK_BYTES;
+    const maxLine = opts.maxLineBytes ?? MAX_LINE_BYTES;
+    const openForRead = opts.openForRead ?? openReadOnly;
+    // The file was just located, so ENOENT means "gone": fail fast instead of burning the ~3 s retry budget.
+    return readWithRetry(async () => {
+        opts.onAttempt?.();
+        const fh = await openForRead(filePath);
+        try {
+            const { size } = await fh.stat();
+            const start = Math.max(0, size - maxBytes);
+            let pos = start;
+            let carry = Buffer.alloc(0);
+            // Drop the first line only when the window really begins mid-line.
+            let dropFirst = false;
+            if (start > 0) {
+                const prev = Buffer.alloc(1);
+                const { bytesRead } = await fh.read(prev, 0, 1, start - 1);
+                dropFirst = bytesRead === 1 && prev[0] !== 0x0a;
+            }
+            let skipping = false; // inside an over-long line
+            while (pos < size) {
+                const len = Math.min(chunkBytes, size - pos);
+                const buf = Buffer.allocUnsafe(len);
+                let off = 0;
+                while (off < len) {
+                    const { bytesRead } = await fh.read(buf, off, len - off, pos + off);
+                    if (bytesRead === 0)
+                        break;
+                    off += bytesRead;
+                }
+                if (off === 0)
+                    break; // file shrank under us
+                pos += off;
+                const data = carry.length ? Buffer.concat([carry, buf.subarray(0, off)]) : buf.subarray(0, off);
+                let lineStart = 0;
+                for (let i = data.indexOf(0x0a); i !== -1; i = data.indexOf(0x0a, lineStart)) {
+                    if (dropFirst)
+                        dropFirst = false;
+                    else if (skipping)
+                        skipping = false;
+                    else if (i > lineStart && i - lineStart <= maxLine)
+                        onLine(data.toString("utf8", lineStart, i));
+                    lineStart = i + 1;
+                }
+                carry = Buffer.from(data.subarray(lineStart));
+                if (carry.length > maxLine) {
+                    carry = Buffer.alloc(0);
+                    if (!dropFirst)
+                        skipping = true;
+                }
+            }
+            // Final line without a trailing newline (a live session mid-write may
+            // leave a torn one — JSON.parse failure is the consumer's concern).
+            if (!dropFirst && !skipping && carry.length)
+                onLine(carry.toString("utf8"));
+            return { truncated: start > 0, scannedBytes: Math.min(size, maxBytes), sizeBytes: size };
+        }
+        finally {
+            try {
+                await fh.close();
+            }
+            catch {
+                /* a close failure must not mask the real I/O error (see session-jsonl-io.ts) */
+            }
+        }
+    }, ENOENT_FATAL);
+}
+/** First line of the file (≤ `headBytes`), for the start timestamp when the scan window skipped it. */
+export async function readFirstLine(filePath, headBytes = 256 * 1024, openForRead = openReadOnly) {
+    return readWithRetry(async () => {
+        const fh = await openForRead(filePath);
+        try {
+            const { size } = await fh.stat();
+            const len = Math.min(size, headBytes);
+            if (len <= 0)
+                return null;
+            const buf = Buffer.allocUnsafe(len);
+            const { bytesRead } = await fh.read(buf, 0, len, 0);
+            const nl = buf.subarray(0, bytesRead).indexOf(0x0a);
+            return buf.toString("utf8", 0, nl === -1 ? bytesRead : nl);
+        }
+        finally {
+            try {
+                await fh.close();
+            }
+            catch {
+                /* see above */
+            }
+        }
+    }, ENOENT_FATAL);
+}
+//# sourceMappingURL=line-scan.js.map

package/server/dist/core/session-info/line-scan.js.map

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

package/server/dist/core/session-info/remote-control.d.ts

@@ -0,0 +1,9 @@
+import type { SessionRemoteControl } from "./types.js";
+export declare const CLAUDE_SESSIONS_DIR: string;
+export interface RemoteControlDeps {
+    sessionsDir?: string;
+    isPidAlive?: (pid: number) => boolean;
+}
+export declare function defaultIsPidAlive(pid: number): boolean;
+export declare function detectRemoteControl(sessionUuid: string, bridgeSeenInJsonl: boolean, deps?: RemoteControlDeps): Promise<SessionRemoteControl>;
+//# sourceMappingURL=remote-control.d.ts.map

package/server/dist/core/session-info/remote-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-control.d.ts","sourceRoot":"","sources":["../../../src/core/session-info/remote-control.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,mBAAmB,QAA8C,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQtD;AAED,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,OAAO,EAC1B,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAiC/B"}

package/server/dist/core/session-info/remote-control.js

@@ -0,0 +1,64 @@
+/*
+ * Remote Control detection. Truth source is `~/.claude/sessions/<pid>.json`
+ * (one file per RUNNING claude process, carrying `sessionId` and — while Remote
+ * Control is on — `bridgeSessionId`). A `bridge-session` record in the session
+ * JSONL only proves it was enabled ONCE, so it feeds `onceEnabled`, never
+ * `active`. Liveness is a signal-0 probe: a stale file from a killed process
+ * must not read as "on". Read-only (CLAUDE.md DO-NOT #1).
+ */
+import { readdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { readSmallRegularFile } from "./small-file.js";
+export const CLAUDE_SESSIONS_DIR = path.join(homedir(), ".claude", "sessions");
+export function defaultIsPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM = exists but not ours (alive); ESRCH = gone.
+        return err.code === "EPERM";
+    }
+}
+export async function detectRemoteControl(sessionUuid, bridgeSeenInJsonl, deps = {}) {
+    const dir = deps.sessionsDir ?? CLAUDE_SESSIONS_DIR;
+    const alive = deps.isPidAlive ?? defaultIsPidAlive;
+    const wanted = sessionUuid.toLowerCase();
+    let onceEnabled = bridgeSeenInJsonl;
+    let files = [];
+    try {
+        files = (await readdir(dir)).filter((f) => /^\d+\.json$/.test(f));
+    }
+    catch {
+        return { active: false, onceEnabled, pid: null };
+    }
+    for (const f of files) {
+        let rec;
+        try {
+            const text = await readSmallRegularFile(path.join(dir, f), 64 * 1024);
+            if (text === null)
+                continue;
+            const parsed = JSON.parse(text);
+            // Valid JSON is not necessarily an object (`null`, an array, a number):
+            // these files belong to another program, so one odd file must be
+            // skipped, never allowed to throw out of the whole session-info read.
+            if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed))
+                continue;
+            rec = parsed;
+        }
+        catch {
+            continue; // being rewritten / not JSON
+        }
+        if (typeof rec.sessionId !== "string" || rec.sessionId.toLowerCase() !== wanted)
+            continue;
+        const pid = typeof rec.pid === "number" ? rec.pid : Number(f.replace(/\.json$/, ""));
+        if (typeof rec.bridgeSessionId === "string" && rec.bridgeSessionId) {
+            onceEnabled = true;
+            if (Number.isInteger(pid) && pid > 0 && alive(pid))
+                return { active: true, onceEnabled, pid };
+        }
+    }
+    return { active: false, onceEnabled, pid: null };
+}
+//# sourceMappingURL=remote-control.js.map

package/server/dist/core/session-info/remote-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-control.js","sourceRoot":"","sources":["../../../src/core/session-info/remote-control.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAO/E,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qDAAqD;QACrD,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;IACzD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,iBAA0B,EAC1B,OAA0B,EAAE;IAE5B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,mBAAmB,CAAC;IACpD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC;IACnD,MAAM,MAAM,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,WAAW,GAAG,iBAAiB,CAAC;IACpC,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,GAA4B,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;YACtE,IAAI,IAAI,KAAK,IAAI;gBAAE,SAAS;YAC5B,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,wEAAwE;YACxE,iEAAiE;YACjE,sEAAsE;YACtE,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,SAAS;YACrF,GAAG,GAAG,MAAiC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,6BAA6B;QACzC,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,MAAM;YAAE,SAAS;QAC1F,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACrF,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,IAAI,GAAG,CAAC,eAAe,EAAE,CAAC;YACnE,WAAW,GAAG,IAAI,CAAC;YACnB,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;QAChG,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACnD,CAAC"}

package/server/dist/core/session-info/session-info.d.ts

@@ -0,0 +1,18 @@
+import type { JsonlLocation } from "../session-watcher.js";
+import { type RemoteControlDeps } from "./remote-control.js";
+import type { SessionInfo } from "./types.js";
+export declare const SESSION_SCAN_BYTES: number;
+export declare const SUBAGENT_SCAN_BYTES: number;
+export declare const MAX_SUBAGENTS = 60;
+export declare const MAX_OUTPUTS = 300;
+export interface SessionInfoDeps extends RemoteControlDeps {
+    now?: () => number;
+    /** Test seam: bypass the per-file memo. */
+    noMemo?: boolean;
+}
+/** Test hook: number of real scans performed (memo misses). */
+export declare const scanStats: {
+    scans: number;
+};
+export declare function readSessionInfo(sessionUuid: string, loc: JsonlLocation, deps?: SessionInfoDeps): Promise<SessionInfo>;
+//# sourceMappingURL=session-info.d.ts.map

package/server/dist/core/session-info/session-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-info.d.ts","sourceRoot":"","sources":["../../../src/core/session-info/session-info.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAElF,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,YAAY,CAAC;AAEjE,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AACnD,eAAO,MAAM,mBAAmB,QAAmB,CAAC;AACpD,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,WAAW,MAAM,CAAC;AAI/B,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAOD,+DAA+D;AAC/D,eAAO,MAAM,SAAS;;CAAe,CAAC;AAoEtC,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,aAAa,EAClB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,WAAW,CAAC,CAoEtB"}