@svenroth-ai/shipwright 0.24.1-next.0

package/server/dist/core/session-jsonl-io.js

@@ -0,0 +1,128 @@
+/*
+ * Low-level disk access for the session-JSONL reader: the torn-read retry
+ * envelope, the positional tail read, and the newline scan. Split out of
+ * `session-watcher.ts` by iterate-2026-07-21-transcript-positional-tail-read —
+ * "how we touch the disk safely" vs. that module's "what we look for".
+ *
+ * WHY POSITIONAL. `readChunk` used to load the ENTIRE file and then slice, so a
+ * bounded-tail request cost an unbounded read. Measured over this project's real
+ * corpus (203 transcripts, median 2.6 MB, max 138 MB, 82 % over 1 MB): a full
+ * sweep moved 917 MB in 229 ms; the same sweep with a 512 KB positional tail
+ * moves 101 MB in 37 ms. Per poll on the largest transcript, 30.9 ms → 0.12 ms.
+ * The shape is the point — the old cost was O(file size) and grew for the life
+ * of a session, while a positional read is flat.
+ *
+ * CONCURRENCY CONTRACT, stated precisely because both external reviewers went
+ * for it: the read runs through the EOF observed by the OPEN HANDLE's own
+ * fstat, not "EOF at completion".
+ *   - APPEND mid-read → the new bytes are simply deferred to the next poll.
+ *     Safe, because the cursor (`toByte`) always follows what was delivered, so
+ *     the caller resumes exactly where the content stopped.
+ *   - TRUNCATION mid-read → the read comes up short, and we re-stat so the
+ *     caller clamps against the size that actually exists now. That is what
+ *     the whole-file reader did implicitly (it clamped against the bytes it
+ *     obtained), and reproducing it is what keeps the swap behavior-preserving.
+ */
+import { open } from "node:fs/promises";
+const openForReadOnly = (p) => open(p, "r");
+/**
+ * Read `[fromByte, EOF)` of `p`. Reads only what was asked for — the whole
+ * point of this module. `fromByte` is clamped into `[0, size]`.
+ */
+export async function readTailFromDisk(p, fromByte, openForRead = openForReadOnly) {
+    const fh = await openForRead(p);
+    try {
+        const { size } = await fh.stat();
+        const start = Math.min(Math.max(fromByte, 0), size);
+        const length = size - start;
+        if (length <= 0)
+            return { bytes: Buffer.alloc(0), size };
+        // allocUnsafe, deliberately: every byte in [0, off) is written by the loop
+        // below and ONLY that region is ever returned, so no uninitialised memory
+        // can escape. Buffer.alloc would add a full-length memset to the
+        // `fromByte: 0` callers, which legitimately read whole 100 MB+ files.
+        const buf = Buffer.allocUnsafe(length);
+        let off = 0;
+        while (off < length) {
+            const { bytesRead } = await fh.read(buf, off, length - off, start + off);
+            if (bytesRead === 0)
+                break; // EOF — the file shrank under us
+            off += bytesRead;
+        }
+        if (off === length)
+            return { bytes: buf, size };
+        // Short read ⇒ truncation. Re-stat so the caller clamps against what exists
+        // now; never let the re-stat INFLATE the clamp past what this read covered.
+        let effective = size;
+        try {
+            effective = Math.min(size, (await fh.stat()).size);
+        }
+        catch {
+            /* keep the opening size — a failed re-stat must not lose the bytes we did read */
+        }
+        // The bytes in hand live at `start`. Reporting a smaller `size` makes the
+        // caller clamp `from` DOWN to it, so anything past the new end would be
+        // handed back under an offset it never occupied. Drop it instead of
+        // relabelling it: the whole-file reader, clamping `from` against the
+        // shrunken length it read, delivered exactly this much and no more.
+        const deliverable = Math.max(0, Math.min(off, effective - start));
+        return { bytes: buf.subarray(0, deliverable), size: effective };
+    }
+    finally {
+        try {
+            await fh.close();
+        }
+        catch {
+            /*
+             * A close failure must never replace the real I/O error: `readWithRetry`
+             * classifies on `err.code`, so surfacing EPERM-from-close instead of the
+             * actual read error would change RETRY behavior, not merely the message.
+             * On a read-only handle a close error is not actionable either way.
+             */
+        }
+    }
+}
+// ---------- torn-read retry (moved verbatim from session-watcher.ts) ----------
+/*
+ * WHY THE ENVELOPE IS THIS WIDE, kept with the code it explains: it is the Plan
+ * D'' round-1 BLOCKER fix (+ the Gemini BLOCKER). PoC finding 4 showed torn
+ * reads do NOT actually fire on NTFS at the write rates Claude emits, so the
+ * six attempts are insurance against AV scanners / OneDrive sync / Defender
+ * rather than a response to an observed failure. Moved here verbatim by
+ * iterate-2026-07-22-…-single-walk: the collapse of session-watcher.ts's header
+ * would otherwise have deleted the only record of it (internal review, LOW-7).
+ */
+const RETRY_DELAYS_MS = [50, 100, 200, 400, 800, 1600];
+const RETRY_ERROR_CODES = new Set(["EBUSY", "EPERM", "EACCES", "ENOENT"]);
+/** D06/F24 — discovery passes this so ENOENT (absent) is an authoritative miss. */
+export const ENOENT_FATAL = new Set(["ENOENT"]);
+/** 6-attempt exponential backoff over Windows fs errors; `fatalCodes` bails
+ * immediately on the given codes (e.g. ENOENT for discovery). */
+export async function readWithRetry(op, fatalCodes) {
+    let lastErr;
+    for (let i = 0; i < RETRY_DELAYS_MS.length; i++) {
+        try {
+            return await op();
+        }
+        catch (err) {
+            lastErr = err;
+            const code = err?.code;
+            if (!code || !RETRY_ERROR_CODES.has(code) || fatalCodes?.has(code)) {
+                throw err; // non-retryable (permissions, syntax) or caller-fatal
+            }
+            if (i === RETRY_DELAYS_MS.length - 1)
+                break;
+            await new Promise((r) => setTimeout(r, RETRY_DELAYS_MS[i]));
+        }
+    }
+    throw lastErr;
+}
+/** Index of the last `byte` in `buf`, or -1. */
+export function lastIndexOfByte(buf, byte) {
+    for (let i = buf.length - 1; i >= 0; i--) {
+        if (buf[i] === byte)
+            return i;
+    }
+    return -1;
+}
+//# sourceMappingURL=session-jsonl-io.js.map

package/server/dist/core/session-jsonl-io.js.map

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

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

@@ -0,0 +1,81 @@
+export type ParsedSessionEvent = UserEvent | AssistantEvent | AttachmentEvent | QueueOpEvent | FileSnapshotEvent | AiTitleEvent | LastPromptEvent | SystemEvent | CustomTitleEvent | AgentNameEvent | PermissionModeEvent | UnknownEvent;
+export interface BaseSessionEvent {
+    sessionId?: string;
+    timestamp?: string;
+    uuid?: string;
+    parentUuid?: string | null;
+}
+export interface UserEvent extends BaseSessionEvent {
+    kind: "user";
+    content: unknown;
+}
+export interface AssistantEvent extends BaseSessionEvent {
+    kind: "assistant";
+    content: unknown;
+    model?: string;
+}
+export interface AttachmentEvent extends BaseSessionEvent {
+    kind: "attachment";
+    attachment: unknown;
+}
+export interface QueueOpEvent extends BaseSessionEvent {
+    kind: "queue-operation";
+    operation: string;
+    detail?: unknown;
+}
+export interface FileSnapshotEvent extends BaseSessionEvent {
+    kind: "file-history-snapshot";
+    snapshot: unknown;
+    isSnapshotUpdate?: boolean;
+}
+export interface AiTitleEvent extends BaseSessionEvent {
+    kind: "ai-title";
+    title: string;
+}
+export interface LastPromptEvent extends BaseSessionEvent {
+    kind: "last-prompt";
+    prompt: unknown;
+}
+export interface SystemEvent extends BaseSessionEvent {
+    kind: "system";
+    text: string;
+    subtype?: string;
+}
+export interface CustomTitleEvent extends BaseSessionEvent {
+    kind: "custom-title";
+    title: string;
+}
+export interface AgentNameEvent extends BaseSessionEvent {
+    kind: "agent-name";
+    name: string;
+}
+export interface PermissionModeEvent extends BaseSessionEvent {
+    kind: "permission-mode";
+    mode: string;
+}
+export interface UnknownEvent extends BaseSessionEvent {
+    kind: "unknown";
+    originalType: string;
+    raw: Record<string, unknown>;
+}
+export interface ParseResult {
+    events: ParsedSessionEvent[];
+    malformedLines: number;
+    /** Index (in `events`) of the last fully parsed line — useful for incremental offset tracking. */
+    lastValidLineIndex: number;
+}
+export declare function parseSessionJsonl(content: string): ParseResult;
+export interface ToolUseBlock {
+    id: string;
+    name: string;
+    input: unknown;
+    /** Index into the parsed events array of the assistant message that carried it. */
+    atAssistantEvent: number;
+}
+export interface ToolResultBlock {
+    toolUseId: string;
+    atUserEvent: number;
+}
+export declare function extractToolUses(events: ParsedSessionEvent[]): ToolUseBlock[];
+export declare function extractToolResults(events: ParsedSessionEvent[]): ToolResultBlock[];
+//# sourceMappingURL=session-parser.d.ts.map

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

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

package/server/dist/core/session-parser.js

@@ -0,0 +1,168 @@
+/*
+ * Server-side session JSONL parser.
+ *
+ * Used by inbox-derive (server-side) to inspect tool_use / tool_result
+ * correlation across an entire JSONL. Client has its own renderer-oriented
+ * parser at webui/client/src/poc-external/session-parser.ts (promoted to
+ * the final shape in Sub-iterate 2). The two parsers intentionally share
+ * no code because the workspaces don't share a tsconfig rootDir; the
+ * schemas are small and the drift risk is low.
+ *
+ * Unknown top-level types pass through as `{ kind: "unknown", raw }` so
+ * future CLI additions (slash events, plan events, custom plugin hooks)
+ * are never silently dropped.
+ */
+export function parseSessionJsonl(content) {
+    if (!content)
+        return { events: [], malformedLines: 0, lastValidLineIndex: -1 };
+    const lines = content.split("\n");
+    const events = [];
+    let malformed = 0;
+    let lastValid = -1;
+    for (const line of lines) {
+        if (!line)
+            continue;
+        let raw;
+        try {
+            raw = JSON.parse(line);
+        }
+        catch {
+            malformed++;
+            continue;
+        }
+        events.push(parseOne(raw));
+        lastValid = events.length - 1;
+    }
+    return { events, malformedLines: malformed, lastValidLineIndex: lastValid };
+}
+function parseOne(raw) {
+    const base = {
+        sessionId: typeof raw.sessionId === "string" ? raw.sessionId : undefined,
+        timestamp: typeof raw.timestamp === "string" ? raw.timestamp : undefined,
+        uuid: typeof raw.uuid === "string" ? raw.uuid : undefined,
+        parentUuid: typeof raw.parentUuid === "string" || raw.parentUuid === null
+            ? raw.parentUuid
+            : undefined,
+    };
+    const type = typeof raw.type === "string" ? raw.type : "";
+    switch (type) {
+        case "user":
+            return {
+                ...base,
+                kind: "user",
+                content: raw.message?.content ?? raw.message,
+            };
+        case "assistant": {
+            const msg = raw.message;
+            return {
+                ...base,
+                kind: "assistant",
+                content: msg?.content ?? raw.message,
+                model: typeof msg?.model === "string" ? msg.model : undefined,
+            };
+        }
+        case "attachment":
+            return { ...base, kind: "attachment", attachment: raw.attachment };
+        case "queue-operation":
+            return {
+                ...base,
+                kind: "queue-operation",
+                operation: typeof raw.operation === "string" ? raw.operation : "unknown",
+                detail: raw.content,
+            };
+        case "file-history-snapshot":
+            return {
+                ...base,
+                kind: "file-history-snapshot",
+                snapshot: raw.snapshot,
+                isSnapshotUpdate: Boolean(raw.isSnapshotUpdate),
+            };
+        case "ai-title":
+            return {
+                ...base,
+                kind: "ai-title",
+                title: typeof raw.title === "string"
+                    ? raw.title
+                    : "",
+            };
+        case "last-prompt":
+            return { ...base, kind: "last-prompt", prompt: raw.prompt };
+        case "system": {
+            const content = typeof raw.content === "string" ? raw.content : "";
+            const text = content || (typeof raw.text === "string" ? (raw.text) : "");
+            return {
+                ...base,
+                kind: "system",
+                text,
+                subtype: typeof raw.subtype === "string" ? raw.subtype : undefined,
+            };
+        }
+        case "custom-title": {
+            const title = typeof raw.customTitle === "string"
+                ? (raw.customTitle)
+                : typeof raw.title === "string"
+                    ? (raw.title)
+                    : "";
+            return { ...base, kind: "custom-title", title };
+        }
+        case "agent-name": {
+            const name = typeof raw.agentName === "string"
+                ? (raw.agentName)
+                : typeof raw.name === "string"
+                    ? (raw.name)
+                    : "";
+            return { ...base, kind: "agent-name", name };
+        }
+        case "permission-mode": {
+            const mode = typeof raw.permissionMode === "string"
+                ? (raw.permissionMode)
+                : typeof raw.mode === "string"
+                    ? (raw.mode)
+                    : "";
+            return { ...base, kind: "permission-mode", mode };
+        }
+        default:
+            return { ...base, kind: "unknown", originalType: type || "(no-type)", raw };
+    }
+}
+export function extractToolUses(events) {
+    const out = [];
+    events.forEach((e, idx) => {
+        if (e.kind !== "assistant")
+            return;
+        const content = e.content;
+        if (!Array.isArray(content))
+            return;
+        for (const block of content) {
+            if (block && typeof block === "object") {
+                const b = block;
+                if (b.type === "tool_use" &&
+                    typeof b.id === "string" &&
+                    typeof b.name === "string") {
+                    out.push({ id: b.id, name: b.name, input: b.input, atAssistantEvent: idx });
+                }
+            }
+        }
+    });
+    return out;
+}
+export function extractToolResults(events) {
+    const out = [];
+    events.forEach((e, idx) => {
+        if (e.kind !== "user")
+            return;
+        const content = e.content;
+        if (!Array.isArray(content))
+            return;
+        for (const block of content) {
+            if (block && typeof block === "object") {
+                const b = block;
+                if (b.type === "tool_result" && typeof b.tool_use_id === "string") {
+                    out.push({ toolUseId: b.tool_use_id, atUserEvent: idx });
+                }
+            }
+        }
+    });
+    return out;
+}
+//# sourceMappingURL=session-parser.js.map

package/server/dist/core/session-parser.js.map

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

package/server/dist/core/session-watcher-debug.d.ts

@@ -0,0 +1,7 @@
+export interface AwaitingLaunchProbe {
+    readdirFailed(uuid: string, dir: string): void;
+    hit(uuid: string, encodedCwd: string, size: number): void;
+    miss(uuid: string, subs: string[]): void;
+}
+export declare function awaitingLaunchProbe(): AwaitingLaunchProbe | null;
+//# sourceMappingURL=session-watcher-debug.d.ts.map

package/server/dist/core/session-watcher-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-watcher-debug.d.ts","sourceRoot":"","sources":["../../src/core/session-watcher-debug.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC1C;AAED,wBAAgB,mBAAmB,IAAI,mBAAmB,GAAG,IAAI,CAiBhE"}

package/server/dist/core/session-watcher-debug.js

@@ -0,0 +1,31 @@
+/* eslint-disable no-console */
+/*
+ * The `SHIPWRIGHT_DEBUG_AWAITING_LAUNCH` operator probe for
+ * `SessionWatcher.findByUuid`. Split out of `session-watcher.ts` by
+ * iterate-2026-07-22-transcript-cursor-single-walk, which needed the lines and
+ * found this the least arbitrary thing to move: an env-gated field diagnostic
+ * is not "what we look for on disk", and its runbook prose is operator
+ * documentation that was living in a hot read path.
+ *
+ * Iterate v0.8.2 AC-5 (awaiting-launch state lag). The known-good lower bound
+ * is ~5–15 s for Claude's first JSONL write plus a 2–5 s server poll cadence
+ * (~20 s total). If the field reports >30 s, the most likely cause is an
+ * encoded-cwd mismatch — the pty was started under one cwd but `Set-Location`'d
+ * before launch, while `task.cwd` records the original. The probe deliberately
+ * reports BOTH the directories walked AND the no-match outcome, so the operator
+ * can compare what was scanned against the encoded cwd they expected.
+ *
+ * Returns `null` when disabled so the caller pays one null-check per walk
+ * rather than an env read per branch.
+ */
+export function awaitingLaunchProbe() {
+    const flag = process.env.SHIPWRIGHT_DEBUG_AWAITING_LAUNCH;
+    if (flag !== "1" && flag !== "true")
+        return null;
+    return {
+        readdirFailed: (uuid, dir) => console.log(`[awaiting-launch] readdir(projectsDir) failed for uuid=${uuid} dir=${dir}`),
+        hit: (uuid, encodedCwd, size) => console.log(`[awaiting-launch] HIT uuid=${uuid} encodedCwd=${encodedCwd} size=${size}`),
+        miss: (uuid, subs) => console.log(`[awaiting-launch] miss uuid=${uuid} walked=${subs.length} encodedCwds=${subs.slice(0, 8).join(",")}${subs.length > 8 ? ",…" : ""}`),
+    };
+}
+//# sourceMappingURL=session-watcher-debug.js.map

package/server/dist/core/session-watcher-debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-watcher-debug.js","sourceRoot":"","sources":["../../src/core/session-watcher-debug.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC;IAC1D,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO;QACL,aAAa,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAC3B,OAAO,CAAC,GAAG,CACT,0DAA0D,IAAI,QAAQ,GAAG,EAAE,CAC5E;QACH,GAAG,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAC9B,OAAO,CAAC,GAAG,CACT,8BAA8B,IAAI,eAAe,UAAU,SAAS,IAAI,EAAE,CAC3E;QACH,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CACnB,OAAO,CAAC,GAAG,CACT,+BAA+B,IAAI,WAAW,IAAI,CAAC,MAAM,gBAAgB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACpI;KACJ,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,101 @@
+import { type TailRead } from "./session-jsonl-io.js";
+export declare const PROJECTS_DIR: string;
+export interface JsonlLocation {
+    path: string;
+    encodedCwd: string;
+    mtimeMs: number;
+    sizeBytes: number;
+}
+export interface SessionWatcherDeps {
+    readdir?: (p: string) => Promise<string[]>;
+    stat?: (p: string) => Promise<{
+        mtimeMs: number;
+        size: number;
+        isDirectory: () => boolean;
+    }>;
+    /**
+     * Positional read of `[fromByte, EOF)`. Replaced the former whole-file
+     * `readFile` dep in iterate-2026-07-21-transcript-positional-tail-read — a
+     * bounded-tail request must not cost an unbounded read. The old dep was
+     * removed rather than kept alongside: nothing injected it, so leaving it
+     * would have left an override that silently no longer changes behavior.
+     */
+    readTail?: (p: string, fromByte: number) => Promise<TailRead>;
+    /** Override for tests; defaults to `~/.claude/projects`. */
+    projectsDir?: string;
+}
+export declare class SessionWatcher {
+    private readonly deps;
+    constructor(deps?: SessionWatcherDeps);
+    /**
+     * Resolve the on-disk JSONL for a given pre-bound session UUID.
+     * Returns null if no file matches yet (common during
+     * `awaiting_external_start` before the user pastes). The env-gated
+     * awaiting-launch diagnostic lives in `session-watcher-debug.ts`.
+     */
+    findByUuid(sessionUuid: string): Promise<JsonlLocation | null>;
+    /**
+     * Batch variant of {@link findByUuid} — resolves many session UUIDs in
+     * a SINGLE `~/.claude/projects` walk. `GET /api/external/tasks` uses
+     * this so the board delivers a LIVE JSONL mtime for every task in one
+     * scan (ADR-102 — the Resume-CTA gate must not be fed the stale
+     * persisted `lastJsonlSeenMtimeMs`, which only the transcript endpoint
+     * of the currently-open detail page refreshes).
+     *
+     * Returns a Map keyed by LOWERCASE uuid. UUIDs with no matching file
+     * on disk are simply absent from the result (same as `findByUuid`
+     * returning null). An empty input set short-circuits with no walk.
+     */
+    findManyByUuid(uuids: Set<string>): Promise<Map<string, JsonlLocation>>;
+    /**
+     * Read a byte-range from the JSONL with torn-read retry + UTF-8 safe
+     * chunk trimming. Always returns content ending on `\n` so the client
+     * never sees a partial line (and `\n` is safe to split on even in the
+     * middle of a multi-byte UTF-8 sequence).
+     *
+     * Returns the `JsonlLocation` it read from on success, so a caller needing
+     * the file's mtime/size does not walk `~/.claude/projects` a second time for
+     * an answer this call already had (iterate-2026-07-22-…-single-walk).
+     */
+    readChunk(args: {
+        sessionUuid: string;
+        fromByte: number;
+        expectFingerprint: string | null;
+        /**
+         * Pre-resolved location: "I walked in THIS poll — don't walk again."
+         * For callers that must resolve first anyway (mission-context needs
+         * `sizeBytes` to compute a tail offset; the inbox cold path walks for its
+         * cache). It does not become authoritative over the bytes — the read runs
+         * its own `fstat` — but `size` + `fingerprint` are taken from it, so a
+         * caller relying on `expectFingerprint` for rotation must NOT pass one.
+         * Construct it only via `findByUuid` / `findManyByUuid`; no route may
+         * supply a path from request data.
+         */
+        location?: JsonlLocation | null;
+    }): Promise<TranscriptReadResult>;
+}
+export interface TranscriptChunk {
+    fingerprint: string;
+    size: number;
+    fromByte: number;
+    toByte: number;
+    content: string;
+}
+/**
+ * `location` is REQUIRED on `ok` — deliberately, so every construction site
+ * (including test mocks) has to supply a real one. An optional field would let
+ * a consumer keep a silent `?? findByUuid()` fallback and re-grow the second
+ * walk this shape exists to remove. `rotated` carries none: no caller wants it.
+ */
+export type TranscriptReadResult = {
+    status: "missing";
+} | {
+    status: "rotated";
+    currentFingerprint: string;
+} | {
+    status: "ok";
+    chunk: TranscriptChunk;
+    location: JsonlLocation;
+};
+export declare function computeFingerprint(loc: JsonlLocation): string;
+//# sourceMappingURL=session-watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-watcher.d.ts","sourceRoot":"","sources":["../../src/core/session-watcher.ts"],"names":[],"mappings":"AAyBA,OAAO,EAKL,KAAK,QAAQ,EACd,MAAM,uBAAuB,CAAC;AAG/B,eAAO,MAAM,YAAY,QAA8C,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7F;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9D,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAcD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;gBAExC,IAAI,GAAE,kBAAuB;IAIzC;;;;;OAKG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA0CpE;;;;;;;;;;;OAWG;IACG,cAAc,CAClB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GACjB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAmDtC;;;;;;;;;OASG;IACG,SAAS,CAAC,IAAI,EAAE;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC;;;;;;;;;WASG;QACH,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;KACjC,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAmDlC;AAID,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,CAAC;AAEtE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAE7D"}