@sapiom/harness 0.1.5 → 0.2.0

package/dist/core/record-archive.js

@@ -0,0 +1,465 @@
+/**
+ * Durable session records — what makes session history outlive the raw event
+ * log it was rebuilt from.
+ *
+ * THE PROBLEM. `events.ndjson` is an analytics sink with an analytics sink's
+ * retention: 50 MB / 30 days, truncated oldest-first (core/collector/
+ * store-retention.ts). Once session history is *built on* that file
+ * (core/session-record.ts), the sweep silently deletes history — a session a
+ * user can read today is gone next month, with no way to tell "never existed"
+ * from "swept". A record the user can open is a product surface; a byte cap on
+ * an append-only debug log is not the right lifetime for it.
+ *
+ * THE FIX. At session end we fold the record once and write a compacted copy to
+ * `~/.sapiom/harness/records/<harnessSessionId>.json`. It is bounded (see the
+ * caps below), it is one file per conversation, and it survives every sweep of
+ * the ndjson because it isn't in it. The ndjson goes back to being what it is:
+ * the raw analytics sink.
+ *
+ * WHY NOT UNDER `<generated>/<sessionId>/`, which the ticket suggested and
+ * which already has a retention sweep: that directory is deleted the moment a
+ * session's pty exits (server/index.ts's "exited" handler calls
+ * removeGeneratedSessionDir — every file in it is regenerated on the next
+ * launch), and whatever survives that is swept 7 days after it goes stale.
+ * Both lifetimes are *shorter* than the 30 days of events the archive exists to
+ * outlive, so a record written there would die sooner than the log it was meant
+ * to survive. Records get their own root and their own policy instead.
+ *
+ * COMPACTION is lossy, on purpose, and says so. Tool inputs and tool results
+ * are the bulk of the bytes (`tool.call` was ~80% of observed event volume) and
+ * the least useful part of a record read weeks later, so they are clipped hard;
+ * prompts and assistant text — the conversation — are clipped only at the
+ * collector's own field cap, so in practice they are kept whole. Every loss
+ * lands in `SessionRecord.limitations` (`compacted-archive`,
+ * `dropped-early-turns`) and the UI renders it as prose, per this epic's rule
+ * that a reconstruction never gets to imply it is complete.
+ *
+ * SIZE CEILING, stated exactly: a record is compacted to at most
+ * {@link RECORD_MAX_BYTES} by clipping fields and then dropping whole turns
+ * oldest-first — but never below one turn. A single turn with hundreds of tool
+ * calls can therefore exceed the per-record cap; the store's total-bytes cap
+ * ({@link RECORDS_MAX_TOTAL_BYTES}, enforced against real file sizes) is the
+ * hard bound, and one outsized record just crowds out older ones sooner.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { PAYLOAD_TRUNCATION_MARKER } from "./collector/normalizer.js";
+import { childPath } from "./path-safety.js";
+/** Tool input, clipped hard: a 40 KB Edit payload is not what makes a
+ *  months-old record worth keeping, and it is most of its bytes. */
+export const RECORDS_MAX_TOOL_INPUT_CHARS = 512;
+/** Tool result, same reasoning. The collector already caps these at 16 KB. */
+export const RECORDS_MAX_TOOL_RESPONSE_CHARS = 512;
+/** Prompts and assistant text — the conversation itself. Set at the
+ *  collector's own field cap (normalizer.ts's MAX_FIELD_LENGTH), so this
+ *  clips nothing the log didn't already clip. Kept as our own constant
+ *  because the archive's contract is "the conversation survives whole". */
+export const RECORDS_MAX_TEXT_CHARS = 4000;
+/** Per-record byte ceiling — see the module header for the one case that
+ *  legitimately exceeds it. ~64 KB holds a long session comfortably once tool
+ *  payloads are clipped. */
+export const RECORD_MAX_BYTES = 64 * 1024;
+/** Whole-store byte ceiling. A third of the raw sink's 50 MB, for two orders
+ *  of magnitude more sessions: at 64 KB worst-case per record it guarantees
+ *  256 archived conversations, and at realistic sizes holds thousands. */
+export const RECORDS_MAX_TOTAL_BYTES = 16 * 1024 * 1024;
+/** Age ceiling. Deliberately far longer than the events' 30 days — the whole
+ *  point of the archive is to outlive them — while still bounded, so an
+ *  install that runs for years doesn't accumulate forever. */
+export const RECORDS_MAX_AGE_MS = 365 * 24 * 60 * 60 * 1000;
+// ---------------------------------------------------------------------------
+// Compaction — pure
+// ---------------------------------------------------------------------------
+/**
+ * Clip a nullable string to `maxChars`, wearing the same marker the collector
+ * uses — so an archive-clipped tool result is recognized as truncated by
+ * exactly the test the collector's own truncation is (see session-record.ts).
+ *
+ * An existing marker is UNWRAPPED first and its count folded into the new one.
+ * Two things fall out of that, both load-bearing: the collector's 16 KB tool
+ * results (which already end in a marker, and are the bytes worth taking) get
+ * clipped rather than waved through, and clipping is idempotent — a second pass
+ * finds a body already at the cap and returns it untouched, instead of eating
+ * the marker and shaving another 23 characters off the text every time a
+ * record is re-archived.
+ */
+function clip(value, maxChars) {
+    if (value === null)
+        return null;
+    const marker = PAYLOAD_TRUNCATION_MARKER.exec(value);
+    const body = marker ? value.slice(0, value.length - marker[0].length) : value;
+    if (body.length <= maxChars)
+        return value;
+    const omitted = body.length - maxChars + (marker ? Number(marker[1]) : 0);
+    return `${body.slice(0, maxChars)}…[truncated ${omitted} chars]`;
+}
+/**
+ * The bounded, archivable form of a record: fields clipped, oldest turns
+ * dropped if it still doesn't fit, and every loss declared in `limitations`.
+ *
+ * Pure and idempotent — compacting an already-compacted record clips nothing
+ * further and drops nothing further, which matters because a re-archive
+ * (a session that ends twice, a backfill) must not shrink a record a little
+ * more each time.
+ *
+ * `turnCount` and `eventCount` deliberately keep their pre-compaction values:
+ * they describe the conversation that happened, not the excerpt that survived.
+ * A history row's turn count therefore doesn't change when its record is
+ * archived, and `dropped-early-turns` is what tells the reader that `turns`
+ * holds fewer than `turnCount` of them.
+ */
+export function compactSessionRecord(record, options = {}) {
+    const maxBytes = options.maxBytes ?? RECORD_MAX_BYTES;
+    const maxToolInputChars = options.maxToolInputChars ?? RECORDS_MAX_TOOL_INPUT_CHARS;
+    const maxToolResponseChars = options.maxToolResponseChars ?? RECORDS_MAX_TOOL_RESPONSE_CHARS;
+    const maxTextChars = options.maxTextChars ?? RECORDS_MAX_TEXT_CHARS;
+    const archivedAt = options.archivedAt ?? new Date().toISOString();
+    const clipped = record.turns.map((turn) => ({
+        ...turn,
+        prompt: clip(turn.prompt, maxTextChars),
+        assistantText: clip(turn.assistantText, maxTextChars),
+        toolCalls: turn.toolCalls.map((call) => {
+            const responseSummary = clip(call.responseSummary, maxToolResponseChars);
+            return {
+                ...call,
+                input: clip(call.input, maxToolInputChars),
+                responseSummary,
+                // Recomputed rather than carried: a response this pass shortened is
+                // truncated whether or not the collector had already truncated it.
+                responseTruncated: call.responseTruncated || responseSummary !== call.responseSummary,
+            };
+        }),
+    }));
+    // Cumulative-bytes pass rather than re-serializing the record per dropped
+    // turn (the same shape store-retention.ts's size cap uses, and for the same
+    // reason: a marathon session shouldn't cost O(n²) to archive).
+    const turnBytes = clipped.map((turn) => Buffer.byteLength(JSON.stringify(turn), "utf8") + 1);
+    // Measured against the record this function will RETURN, at its largest: the
+    // stamp is set and both archive limitation codes may be added. Measuring the
+    // (smaller) input's header instead would let the result overshoot the cap by
+    // their bytes — a cap that is only nearly a cap isn't one.
+    const headerBytes = Buffer.byteLength(JSON.stringify({
+        ...record,
+        turns: [],
+        archivedAt,
+        limitations: [...new Set([...record.limitations, "compacted-archive", "dropped-early-turns"])],
+    }), "utf8");
+    let total = turnBytes.reduce((sum, n) => sum + n, headerBytes);
+    let dropCount = 0;
+    // Never drop the last turn: an empty archive is strictly worse than one that
+    // overshoots the cap, and the store's total-bytes cap still bounds the whole.
+    while (dropCount < clipped.length - 1 && total > maxBytes) {
+        total -= turnBytes[dropCount];
+        dropCount += 1;
+    }
+    const turns = dropCount > 0 ? clipped.slice(dropCount) : clipped;
+    const limitations = new Set(record.limitations);
+    // Judged on the turns that SURVIVED: a clip inside a turn that was dropped
+    // wholesale is already covered by `dropped-early-turns`, and claiming
+    // "content was shortened" for text nobody can look for reads as a second,
+    // separate loss.
+    if (turns.some((turn, index) => turnChangedByCompaction(record.turns[dropCount + index], turn))) {
+        limitations.add("compacted-archive");
+    }
+    // `truncated-tool-output` can newly become true here: a result the collector
+    // kept whole may have been clipped by this pass.
+    if (turns.some((turn) => turn.toolCalls.some((call) => call.responseTruncated))) {
+        limitations.add("truncated-tool-output");
+    }
+    if (dropCount > 0)
+        limitations.add("dropped-early-turns");
+    return { ...record, turns, limitations: [...limitations], archivedAt };
+}
+function turnChangedByCompaction(before, after) {
+    if (before.prompt !== after.prompt)
+        return true;
+    if (before.assistantText !== after.assistantText)
+        return true;
+    return before.toolCalls.some((call, index) => call.input !== after.toolCalls[index].input ||
+        call.responseSummary !== after.toolCalls[index].responseSummary);
+}
+// ---------------------------------------------------------------------------
+// Store
+// ---------------------------------------------------------------------------
+/** Every id a record should be findable by. A conversation is addressed by its
+ *  primary session id, by any session that resumed it, and by the agent's own
+ *  session id (transcript-sourced history rows only have the latter). */
+function keysFor(record) {
+    const keys = [record.harnessSessionId, ...record.mergedSessionIds];
+    if (record.agentSessionId)
+        keys.push(record.agentSessionId);
+    return [...new Set(keys.filter((key) => key.length > 0))];
+}
+const EMPTY_INDEX = { byKey: new Map(), records: [], dirMtimeMs: -1 };
+function parseRecord(text) {
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return null;
+    const candidate = parsed;
+    // A file without these can't be placed or rendered, so it isn't a record as
+    // far as the archive is concerned — treated as absent, never thrown on.
+    if (typeof candidate.harnessSessionId !== "string")
+        return null;
+    if (!Array.isArray(candidate.turns) || !Array.isArray(candidate.mergedSessionIds))
+        return null;
+    if (typeof candidate.archivedAt !== "string")
+        return null;
+    return candidate;
+}
+export function createRecordArchive(options) {
+    const root = options.root;
+    const maxRecordBytes = options.maxRecordBytes ?? RECORD_MAX_BYTES;
+    const maxTotalBytes = options.maxTotalBytes ?? RECORDS_MAX_TOTAL_BYTES;
+    const maxAgeMs = options.maxAgeMs ?? RECORDS_MAX_AGE_MS;
+    const now = options.now ?? (() => Date.now());
+    const onError = options.onError ?? ((err) => console.error("[harness] session record archive:", err));
+    /**
+     * Cached directory index. Invalidated by the root's mtime, which changes when
+     * a file is created or removed — so a second harness boot writing to the same
+     * root is picked up. (Coarse-mtime filesystems can hide a foreign write made
+     * within the same second as our scan; it self-heals on the next one. Our own
+     * writes update the cache directly and never depend on that.)
+     */
+    let cache = null;
+    /**
+     * Serializes the two mutating operations. Both archive triggers
+     * (server/index.ts: the `session.end` event and the session's exit) can fire
+     * for one session within the same millisecond, and a sweep can land on top —
+     * so without this, two writes race for the same temp path and one of them
+     * renames a file the other already moved. Reads stay outside the queue: they
+     * only ever open a whole file that a rename put there atomically.
+     */
+    let queue = Promise.resolve();
+    function enqueue(run) {
+        const next = queue.catch(() => { }).then(run);
+        queue = next.catch(() => { });
+        return next;
+    }
+    /** Distinguishes temp files written in the same millisecond by the same pid. */
+    let tmpCounter = 0;
+    function fileFor(harnessSessionId) {
+        return childPath(root, `${harnessSessionId}.json`);
+    }
+    async function buildIndex(dirMtimeMs) {
+        const entries = await fs.readdir(root, { withFileTypes: true }).catch(() => null);
+        if (!entries)
+            return { ...EMPTY_INDEX, dirMtimeMs };
+        const byKey = new Map();
+        const records = [];
+        for (const entry of entries) {
+            if (!entry.isFile() || !entry.name.endsWith(".json"))
+                continue;
+            const file = childPath(root, entry.name);
+            if (!file)
+                continue;
+            const text = await fs.readFile(file, "utf8").catch(() => null);
+            if (text === null)
+                continue;
+            const record = parseRecord(text);
+            if (!record)
+                continue;
+            const summary = {
+                harnessSessionId: record.harnessSessionId,
+                keys: keysFor(record),
+                turnCount: record.turnCount,
+                archivedAt: record.archivedAt,
+                bytes: Buffer.byteLength(text, "utf8"),
+                file,
+            };
+            records.push(summary);
+            for (const key of summary.keys) {
+                // First writer wins per key, and records are visited in readdir order,
+                // so a stray duplicate (two archives claiming one agent session) can't
+                // make the lookup depend on which one was read last: the primary file
+                // named after the requested id is still found by the direct hit in
+                // read(), which never consults this map.
+                if (!byKey.has(key))
+                    byKey.set(key, summary);
+            }
+        }
+        records.sort((a, b) => (a.archivedAt < b.archivedAt ? 1 : a.archivedAt > b.archivedAt ? -1 : 0));
+        return { byKey, records, dirMtimeMs };
+    }
+    async function index() {
+        const stat = await fs.stat(root).catch(() => null);
+        if (!stat) {
+            cache = null;
+            return EMPTY_INDEX;
+        }
+        if (cache && cache.dirMtimeMs === stat.mtimeMs)
+            return cache;
+        const built = await buildIndex(stat.mtimeMs);
+        cache = built;
+        return built;
+    }
+    async function readFile(file) {
+        const text = await fs.readFile(file, "utf8").catch(() => null);
+        return text === null ? null : parseRecord(text);
+    }
+    async function writeRecord(record) {
+        // Nothing to preserve: a session that recorded no turn at all reads the
+        // same after the sweep as before it ("no recorded events"), and writing a
+        // turn-less file would spend the store's budget saying so.
+        if (record.turns.length === 0)
+            return null;
+        const file = fileFor(record.harnessSessionId);
+        if (!file) {
+            onError(new Error(`refusing to archive a record with an unsafe session id "${record.harnessSessionId}"`));
+            return null;
+        }
+        const compacted = compactSessionRecord(record, {
+            maxBytes: maxRecordBytes,
+            archivedAt: new Date(now()).toISOString(),
+        });
+        const body = `${JSON.stringify(compacted)}\n`;
+        // Atomic replace (temp + rename in the same directory), so a crash
+        // mid-write can never leave a half-written record where a whole one was.
+        tmpCounter += 1;
+        const tmpFile = path.join(root, `.record-tmp-${process.pid}-${now()}-${tmpCounter}.json`);
+        try {
+            await fs.mkdir(root, { recursive: true });
+            await fs.writeFile(tmpFile, body, "utf8");
+            await fs.rename(tmpFile, file);
+        }
+        catch (err) {
+            await fs.unlink(tmpFile).catch(() => undefined);
+            onError(err);
+            return null;
+        }
+        // Keep the cache correct without re-reading every file: upsert this
+        // summary and adopt the root's new mtime as the one we're current with.
+        const summary = {
+            harnessSessionId: compacted.harnessSessionId,
+            keys: keysFor(compacted),
+            turnCount: compacted.turnCount,
+            archivedAt: compacted.archivedAt,
+            bytes: Buffer.byteLength(body, "utf8"),
+            file,
+        };
+        if (cache) {
+            const records = cache.records.filter((entry) => entry.file !== file);
+            records.unshift(summary);
+            const byKey = new Map(cache.byKey);
+            for (const key of summary.keys)
+                byKey.set(key, summary);
+            const stat = await fs.stat(root).catch(() => null);
+            cache = { byKey, records, dirMtimeMs: stat?.mtimeMs ?? -1 };
+        }
+        return compacted;
+    }
+    async function sweepRecords() {
+        const { records } = await index();
+        if (records.length === 0)
+            return [];
+        // Oldest first — both caps evict in that order.
+        const oldestFirst = [...records].reverse();
+        const cutoffMs = now() - maxAgeMs;
+        let totalBytes = oldestFirst.reduce((sum, entry) => sum + entry.bytes, 0);
+        const doomed = [];
+        for (const entry of oldestFirst) {
+            const archivedMs = Date.parse(entry.archivedAt);
+            const expired = !Number.isNaN(archivedMs) && archivedMs < cutoffMs;
+            if (!expired && totalBytes <= maxTotalBytes)
+                break;
+            doomed.push(entry);
+            totalBytes -= entry.bytes;
+        }
+        const removed = [];
+        for (const entry of doomed) {
+            try {
+                await fs.unlink(entry.file);
+                removed.push(entry.harnessSessionId);
+            }
+            catch {
+                // Leave it for the next sweep rather than aborting the rest.
+            }
+        }
+        if (removed.length > 0)
+            cache = null;
+        return removed;
+    }
+    return {
+        write(record) {
+            return enqueue(() => writeRecord(record));
+        },
+        async read(id) {
+            // Direct hit first — the overwhelmingly common case (a row addressed by
+            // the id its record is filed under) costs one file read and never builds
+            // the directory index.
+            const direct = fileFor(id);
+            if (direct) {
+                const record = await readFile(direct);
+                if (record)
+                    return record;
+            }
+            const summary = (await index()).byKey.get(id);
+            if (!summary)
+                return null;
+            return readFile(summary.file);
+        },
+        async has(id) {
+            const direct = fileFor(id);
+            if (direct) {
+                const stat = await fs.stat(direct).catch(() => null);
+                if (stat?.isFile())
+                    return true;
+            }
+            return (await index()).byKey.has(id);
+        },
+        async list() {
+            return [...(await index()).records];
+        },
+        sweep() {
+            return enqueue(sweepRecords);
+        },
+    };
+}
+/** Default ceiling for one backfill pass. High enough to cover a typical
+ *  install's whole history on the first boot after this shipped, low enough
+ *  that a pathological log doesn't turn boot into a write storm. Whatever is
+ *  left is archived by the next boot's pass. */
+export const RECORDS_BACKFILL_MAX = 200;
+/**
+ * Archive conversations the event log still holds but the archive doesn't.
+ *
+ * Two things need this, and neither is covered by archiving at session end:
+ * sessions that ended without one (the harness force-killed, the machine
+ * rebooted), and every session that ended *before* this feature existed — whose
+ * history would otherwise disappear at its 30-day mark with the archive looking
+ * on. Idempotent: a conversation already archived is skipped, so the steady
+ * state after the first pass is "nothing to do".
+ *
+ * Never throws. Returns the ids it archived.
+ */
+export async function backfillSessionRecords(options) {
+    const maxRecords = options.maxRecords ?? RECORDS_BACKFILL_MAX;
+    const ids = await options.conversationIds();
+    const archived = [];
+    let remaining = 0;
+    for (const id of ids) {
+        if (options.isLiveSession?.(id))
+            continue;
+        if (await options.archive.has(id))
+            continue;
+        if (archived.length >= maxRecords) {
+            remaining += 1;
+            continue;
+        }
+        const record = await options.readFromEvents(id);
+        if (!record)
+            continue;
+        const written = await options.archive.write(record);
+        if (written)
+            archived.push(id);
+    }
+    if (remaining > 0)
+        options.onCapped?.(remaining);
+    return archived;
+}
+//# sourceMappingURL=record-archive.js.map

package/dist/core/record-archive.js.map

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

package/dist/core/rehydration.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Portable continue, wiring layer: turns a `rehydrateFrom` id into brief text,
+ * and decides which of the two delivery channels carries it.
+ *
+ * The brief itself is pure (core/resume-brief.ts); this is the part that has to
+ * touch the record reader, the summary cache, and the session registry. Kept
+ * out of server/index.ts so the resolution order — and the honest "there was
+ * nothing recorded for that id" answer — is testable without standing up a
+ * server.
+ *
+ * THE TWO CHANNELS, and why there are two:
+ *
+ * - `launch-flag` — the brief is composed into the generated system-prompt
+ *   file, which claude-code reads via `--append-system-prompt` and codex via
+ *   `developer_instructions` (see core/adapters/codex.ts's header for why it
+ *   uses that rather than `model_instructions_file`). Both shipped harnesses
+ *   use this: no adapter change, no injected keystrokes, and the brief is in
+ *   place before the agent's first token.
+ * - `post-ready-injection` — the universal fallback for a harness with no
+ *   prompt flag at all: wait for the session to report `ready`, then send the
+ *   brief through the ordinary input path. It is gated on readiness because
+ *   writing into a TUI that is sitting on a "trust this directory?" prompt
+ *   feeds the brief to the prompt instead of the agent.
+ *
+ * No adapter shipped today needs the second channel — which is exactly why it
+ * is declared per-adapter rather than inferred: a future adapter that cannot
+ * take a prompt flag says so in one line and the context still gets across,
+ * instead of being silently dropped.
+ */
+import type { HarnessAdapter, SessionRecord, SystemPromptDelivery } from "../shared/types.js";
+import { type ResumeBriefWorkflow } from "./resume-brief.js";
+/**
+ * How a harness receives a rehydration brief. Absent on the adapter means the
+ * fallback, not the flag: an adapter that never wired `systemPromptFile` and
+ * never declared anything would otherwise have its brief written to a file
+ * nothing reads. Failing toward "delivered noisily" beats failing toward
+ * "silently dropped" for a feature whose entire purpose is that the context
+ * arrives.
+ */
+export declare function systemPromptDeliveryFor(adapter: HarnessAdapter | undefined): SystemPromptDelivery;
+/** Context only the caller can resolve — the record carries no title, no git
+ *  branch, and no workflow binding (those live in the session registry and the
+ *  workflow registry respectively). */
+export interface RehydrationContext {
+    title?: string | null;
+    gitBranch?: string | null;
+    workflow?: ResumeBriefWorkflow | null;
+}
+export interface RehydrationDeps {
+    /** `SessionRecordReader.read` — resolves a harnessSessionId or an agent
+     *  session id to the folded record. */
+    readRecord: (id: string) => Promise<SessionRecord | null>;
+    /** The cached rolling summary for one harness session, or null. */
+    readSummary: (harnessSessionId: string) => Promise<string | null>;
+    /** Registry-only context for the record. Optional; the brief renders
+     *  without it, just less specifically. May be async — the git branch, for
+     *  one, is only knowable from an adapter history scan. */
+    resolveContext?: (record: SessionRecord) => RehydrationContext | undefined | Promise<RehydrationContext | undefined>;
+    /** Token ceiling override, forwarded to `buildResumeBrief`. */
+    maxTokens?: number;
+}
+/**
+ * The brief for `rehydrateFrom`, or null when our event log holds nothing for
+ * it — the honest answer, and the one that lets a caller say "this continue
+ * carried no context" rather than opening a fresh session dressed up as a
+ * continuation.
+ *
+ * Never throws: a rehydration that can't be assembled must degrade to a plain
+ * new session, never fail the session-create it is decorating.
+ */
+export declare function buildRehydrationBrief(rehydrateFrom: string, deps: RehydrationDeps): Promise<string | null>;
+//# sourceMappingURL=rehydration.d.ts.map

package/dist/core/rehydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehydration.d.ts","sourceRoot":"","sources":["../../src/core/rehydration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE/E;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,oBAAoB,CAEjG;AAED;;uCAEuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B;2CACuC;IACvC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC1D,mEAAmE;IACnE,WAAW,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClE;;8DAE0D;IAC1D,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,aAAa,KAClB,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAC9E,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBxB"}

package/dist/core/rehydration.js

@@ -0,0 +1,72 @@
+/**
+ * Portable continue, wiring layer: turns a `rehydrateFrom` id into brief text,
+ * and decides which of the two delivery channels carries it.
+ *
+ * The brief itself is pure (core/resume-brief.ts); this is the part that has to
+ * touch the record reader, the summary cache, and the session registry. Kept
+ * out of server/index.ts so the resolution order — and the honest "there was
+ * nothing recorded for that id" answer — is testable without standing up a
+ * server.
+ *
+ * THE TWO CHANNELS, and why there are two:
+ *
+ * - `launch-flag` — the brief is composed into the generated system-prompt
+ *   file, which claude-code reads via `--append-system-prompt` and codex via
+ *   `developer_instructions` (see core/adapters/codex.ts's header for why it
+ *   uses that rather than `model_instructions_file`). Both shipped harnesses
+ *   use this: no adapter change, no injected keystrokes, and the brief is in
+ *   place before the agent's first token.
+ * - `post-ready-injection` — the universal fallback for a harness with no
+ *   prompt flag at all: wait for the session to report `ready`, then send the
+ *   brief through the ordinary input path. It is gated on readiness because
+ *   writing into a TUI that is sitting on a "trust this directory?" prompt
+ *   feeds the brief to the prompt instead of the agent.
+ *
+ * No adapter shipped today needs the second channel — which is exactly why it
+ * is declared per-adapter rather than inferred: a future adapter that cannot
+ * take a prompt flag says so in one line and the context still gets across,
+ * instead of being silently dropped.
+ */
+import { buildResumeBrief } from "./resume-brief.js";
+/**
+ * How a harness receives a rehydration brief. Absent on the adapter means the
+ * fallback, not the flag: an adapter that never wired `systemPromptFile` and
+ * never declared anything would otherwise have its brief written to a file
+ * nothing reads. Failing toward "delivered noisily" beats failing toward
+ * "silently dropped" for a feature whose entire purpose is that the context
+ * arrives.
+ */
+export function systemPromptDeliveryFor(adapter) {
+    return adapter?.systemPromptDelivery ?? "post-ready-injection";
+}
+/**
+ * The brief for `rehydrateFrom`, or null when our event log holds nothing for
+ * it — the honest answer, and the one that lets a caller say "this continue
+ * carried no context" rather than opening a fresh session dressed up as a
+ * continuation.
+ *
+ * Never throws: a rehydration that can't be assembled must degrade to a plain
+ * new session, never fail the session-create it is decorating.
+ */
+export async function buildRehydrationBrief(rehydrateFrom, deps) {
+    const record = await deps.readRecord(rehydrateFrom).catch(() => null);
+    if (!record)
+        return null;
+    // A conversation can span several harness sessions (a resume, or an adopt),
+    // each with its own summary file. Newest-last is the fold that saw the most,
+    // so walk backwards and take the first one that exists rather than merging
+    // several partial accounts of the same work.
+    let summary = null;
+    for (const harnessSessionId of [...record.mergedSessionIds].reverse()) {
+        summary = await deps.readSummary(harnessSessionId).catch(() => null);
+        if (summary)
+            break;
+    }
+    const context = (await deps.resolveContext?.(record)) ?? {};
+    return buildResumeBrief(record, {
+        ...context,
+        summary,
+        ...(deps.maxTokens !== undefined ? { maxTokens: deps.maxTokens } : {}),
+    });
+}
+//# sourceMappingURL=rehydration.js.map

package/dist/core/rehydration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehydration.js","sourceRoot":"","sources":["../../src/core/rehydration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAOH,OAAO,EAAE,gBAAgB,EAA4B,MAAM,mBAAmB,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAmC;IACzE,OAAO,OAAO,EAAE,oBAAoB,IAAI,sBAAsB,CAAC;AACjE,CAAC;AA2BD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,aAAqB,EACrB,IAAqB;IAErB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,4EAA4E;IAC5E,6EAA6E;IAC7E,2EAA2E;IAC3E,6CAA6C;IAC7C,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,KAAK,MAAM,gBAAgB,IAAI,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACtE,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,OAAO;YAAE,MAAM;IACrB,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,OAAO,gBAAgB,CAAC,MAAM,EAAE;QAC9B,GAAG,OAAO;QACV,OAAO;QACP,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC,CAAC;AACL,CAAC"}