@sapiom/harness 0.1.5 → 0.2.0

package/dist/core/resume-brief.js

@@ -0,0 +1,404 @@
+/**
+ * The "portable continue" brief: a bounded markdown reconstruction of a prior
+ * session, rendered from the SessionRecord our own events already produce (see
+ * core/session-record.ts).
+ *
+ * Why this exists rather than a vendor resume: `claude --resume` / `codex
+ * resume` only work when that agent, on this machine, still holds that
+ * conversation. H1 (SAP-2057) made us stop pretending otherwise; this is the
+ * other half — for every row where the agent does NOT hold it, start a fresh
+ * session seeded with what we recorded. Because the input is our normalized
+ * record and the output is plain text, the same code path serves claude-code
+ * (`--append-system-prompt`) and codex (`developer_instructions`), and would
+ * serve a harness with no prompt flag at all via post-ready injection.
+ *
+ * HONESTY IS THE PRODUCT HERE. A brief that reads like restored memory is
+ * worse than no brief: the agent will assert a file's contents or a command's
+ * outcome it never saw. So the header says outright that this is a
+ * reconstruction, `record.limitations` are spelled out, and every omission
+ * (dropped turns, clamped text, capped file lists) is stated in the text
+ * rather than silently applied.
+ *
+ * BUDGET. The brief is capped at `maxTokens` (default
+ * {@link RESUME_BRIEF_DEFAULT_MAX_TOKENS}), estimated at
+ * {@link CHARS_PER_TOKEN} characters per token — deliberately a crude
+ * estimator, since the consumer is a system prompt with room to spare, not a
+ * hard API limit, and a tokenizer dependency here would have to be right for
+ * two different vendors' tokenizers anyway. What gets squeezed, in order:
+ *
+ *   1. turns, oldest-first — the newest are the ones that explain what is in
+ *      flight right now, and an old turn is the most verbose thing here per
+ *      unit of usefulness;
+ *   2. the derived digests (files written, commands run). They go AFTER turns,
+ *      not before, because they are hard-capped ({@link MAX_FILES} /
+ *      {@link MAX_COMMANDS}) at a few hundred tokens for a whole session,
+ *      where each turn costs a comparable amount on its own — trading a
+ *      whole-session view for one more ancient turn is a bad deal. They can
+ *      also be recovered by looking at the repository, so this only bites
+ *      once every turn is already gone;
+ *   3. only then the rolling summary, tail-clamped. It is squeezed last
+ *      because it is the one section that is a lossy fold of turns already
+ *      dropped in step 1: cutting it loses history nothing else carries.
+ *
+ * The honesty header and the identity block are never dropped — a brief
+ * without them is a lie, not a shorter brief — so they act as a floor of
+ * roughly {@link RESUME_BRIEF_MIN_TOKENS} tokens that a smaller `maxTokens`
+ * cannot squeeze below.
+ */
+import * as path from "node:path";
+/** Default token ceiling for a brief — see the module header on the estimate. */
+export const RESUME_BRIEF_DEFAULT_MAX_TOKENS = 6000;
+/** Turns considered before budgeting; the budget may keep fewer, never more. */
+export const RESUME_BRIEF_DEFAULT_MAX_TURNS = 12;
+/**
+ * Characters per token. Roughly right for English prose and code across both
+ * vendors' tokenizers, and biased the safe way: real text averages slightly
+ * more than 4 chars/token, so this over-counts and lands under the ceiling.
+ */
+export const CHARS_PER_TOKEN = 4;
+/**
+ * Floor the budget can never squeeze below — the honesty header plus the
+ * identity block. Approximate (it moves with the header's wording); it exists
+ * so callers can reason about "what does maxTokens: 200 even mean" rather than
+ * as an assertion about exact size.
+ */
+export const RESUME_BRIEF_MIN_TOKENS = 400;
+/** Per-turn clamps, so one pathological prompt can't consume the whole budget. */
+const MAX_PROMPT_CHARS = 1200;
+const MAX_ASSISTANT_CHARS = 1200;
+/** How much of a tool call's target (path or command) to show. */
+const MAX_TOOL_TARGET_CHARS = 80;
+/** Tool calls listed per turn before the rest are counted rather than named. */
+const MAX_TOOLS_PER_TURN = 12;
+/** Entries in the derived digests. */
+const MAX_FILES = 30;
+const MAX_COMMANDS = 10;
+const MAX_COMMAND_CHARS = 120;
+/** The marker `truncateForPayload` (core/collector/normalizer.ts) leaves. */
+const CLAMP_MARKER = "…[truncated]";
+/** The crude char-count estimate the budget is enforced against. */
+export function estimateBriefTokens(text) {
+    return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+/** Clamp `text` to `maxChars`, marking the cut so nothing reads as complete
+ *  when it isn't. */
+function clamp(text, maxChars) {
+    const trimmed = text.trim();
+    if (trimmed.length <= maxChars)
+        return trimmed;
+    return `${trimmed.slice(0, maxChars).trimEnd()}${CLAMP_MARKER}`;
+}
+/**
+ * The tool's target as a human would name it: the file it edited, the command
+ * it ran, or — failing both — a clamped slice of the raw input.
+ *
+ * `toolInput` is a string on the wire for both harnesses: claude-code's
+ * normalizer stores `JSON.stringify(tool_input)` and codex's tailer stores the
+ * function call's raw `arguments`, so a JSON parse covers both and a plain
+ * string (an untruncated free-text argument) falls through to the raw slice.
+ * Never throws on malformed input — a brief must render from whatever was
+ * recorded, including a payload the collector truncated mid-JSON.
+ */
+export function describeToolTarget(call, cwd) {
+    const parsed = parseToolInput(call.input);
+    if (parsed) {
+        const filePath = firstString(parsed, ["file_path", "filePath", "notebook_path", "path"]);
+        if (filePath)
+            return clamp(displayPath(filePath, cwd), MAX_TOOL_TARGET_CHARS);
+        const command = readCommand(parsed);
+        if (command)
+            return clamp(command, MAX_TOOL_TARGET_CHARS);
+    }
+    if (!call.input)
+        return null;
+    // No structure to read — show a slice of what was recorded rather than
+    // nothing, on one line so a turn's tool list stays scannable.
+    return clamp(call.input.replace(/\s+/g, " "), MAX_TOOL_TARGET_CHARS);
+}
+function parseToolInput(input) {
+    if (!input)
+        return null;
+    try {
+        const parsed = JSON.parse(input);
+        return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)
+            ? parsed
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+function firstString(source, keys) {
+    for (const key of keys) {
+        const value = source[key];
+        if (typeof value === "string" && value.length > 0)
+            return value;
+    }
+    return null;
+}
+/** claude-code's Bash carries `command` as a string; codex's shell tool carries
+ *  it as an argv array (`["bash", "-lc", "…"]`). Both read as one line here. */
+function readCommand(source) {
+    const command = source.command;
+    if (typeof command === "string" && command.length > 0)
+        return command.replace(/\s+/g, " ").trim();
+    if (Array.isArray(command)) {
+        const joined = command.filter((part) => typeof part === "string").join(" ").trim();
+        return joined.length > 0 ? joined.replace(/\s+/g, " ") : null;
+    }
+    return null;
+}
+/** Paths under the session's cwd read far better relative; anything else (or a
+ *  record with no recorded cwd) stays absolute so it's never ambiguous. */
+function displayPath(filePath, cwd) {
+    if (!cwd || !path.isAbsolute(filePath))
+        return filePath;
+    const relative = path.relative(cwd, filePath);
+    return relative && !relative.startsWith("..") ? relative : filePath;
+}
+/** Tools whose input names a file the session wrote to. Read-only tools are
+ *  deliberately excluded: "files touched" that includes everything the agent
+ *  merely looked at stops being a signal. */
+const WRITE_TOOL_NAMES = new Set([
+    "write",
+    "edit",
+    "multiedit",
+    "notebookedit",
+    "update",
+    "apply_patch",
+    "str_replace_editor",
+]);
+const SHELL_TOOL_NAMES = new Set(["bash", "shell", "run_terminal_cmd", "local_shell"]);
+/**
+ * Files touched and commands run, derived from `tool.call` inputs. Exported
+ * for tests and because the same derivation is worth reusing anywhere that
+ * needs "what did this session actually do to the tree".
+ */
+export function deriveDigests(record) {
+    const fileCounts = new Map();
+    const commands = [];
+    const seenCommands = new Set();
+    for (const turn of record.turns) {
+        for (const call of turn.toolCalls) {
+            const name = (call.name ?? "").toLowerCase();
+            const parsed = parseToolInput(call.input);
+            if (WRITE_TOOL_NAMES.has(name)) {
+                const filePath = parsed
+                    ? firstString(parsed, ["file_path", "filePath", "notebook_path", "path"])
+                    : null;
+                if (filePath) {
+                    const display = displayPath(filePath, record.cwd);
+                    fileCounts.set(display, (fileCounts.get(display) ?? 0) + 1);
+                }
+            }
+            else if (SHELL_TOOL_NAMES.has(name)) {
+                const command = parsed ? readCommand(parsed) : null;
+                if (command && !seenCommands.has(command)) {
+                    seenCommands.add(command);
+                    commands.push(clamp(command, MAX_COMMAND_CHARS));
+                }
+            }
+        }
+    }
+    // Insertion order is chronological; both digests read newest-first, which is
+    // what a reader scanning for "where did this leave off" wants.
+    const files = [...fileCounts.entries()].reverse().map(([display, count]) => ({ display, count }));
+    return {
+        files: files.slice(0, MAX_FILES),
+        totalFiles: files.length,
+        commands: commands.reverse().slice(0, MAX_COMMANDS),
+        totalCommands: commands.length,
+    };
+}
+/** Plain-language wording for each machine-readable gap on the record.
+ *  Addressed to the agent reading the brief, so it says what to do about the
+ *  gap rather than merely naming it — the web view (web/src/lib/
+ *  session-record-view.ts) words the same codes for a human reader. */
+const LIMITATION_PROSE = {
+    "truncated-tool-output": "Tool output was size-capped when recorded. Any command result quoted below may be cut off — re-run it rather than trusting the excerpt.",
+    "assistant-narration-gap": "Only the final assistant message of each turn was recorded. Whatever was said between tool calls — including reasoning for a change — is missing.",
+    "missing-assistant-text": "At least one turn has no assistant text at all (Codex records none). Those turns show prompts and tool calls only.",
+    "incomplete-final-turn": "The last turn never completed — the session ended mid-turn, so its work may be half-applied.",
+    "compacted-archive": "This brief was built from the session's archived copy, whose tool inputs and results are clipped to keep it bounded. The conversation is whole, but any payload quoted below is an excerpt — re-read the file or re-run the command rather than trusting it.",
+    "dropped-early-turns": "The archived copy had room only for the most recent turns; earlier ones are gone. Treat what follows as the tail of a longer session — ask before assuming why something earlier was done.",
+};
+function renderTurn(turn, cwd) {
+    const lines = [];
+    const when = turn.promptAt ?? turn.completedAt;
+    lines.push(`### Turn ${turn.index}${when ? ` · ${when}` : ""}${turn.incomplete ? " · never completed" : ""}`);
+    if (turn.prompt !== null) {
+        lines.push("", "**Prompt:**", "", blockquote(clamp(turn.prompt, MAX_PROMPT_CHARS)));
+    }
+    else {
+        lines.push("", "**Prompt:** _not recorded — our recording started mid-turn, or the agent started this turn itself._");
+    }
+    if (turn.toolCalls.length > 0) {
+        const shown = turn.toolCalls.slice(0, MAX_TOOLS_PER_TURN).map((call) => {
+            const target = describeToolTarget(call, cwd);
+            return `\`${call.name ?? "unknown tool"}\`${target ? ` ${target}` : ""}`;
+        });
+        const overflow = turn.toolCalls.length - shown.length;
+        lines.push("", `**Tools:** ${shown.join(" · ")}${overflow > 0 ? ` · …and ${overflow} more` : ""}`);
+    }
+    if (turn.assistantText !== null) {
+        lines.push("", "**Reply:**", "", blockquote(clamp(turn.assistantText, MAX_ASSISTANT_CHARS)));
+    }
+    else if (!turn.incomplete) {
+        lines.push("", "**Reply:** _not recorded._");
+    }
+    return lines.join("\n");
+}
+function blockquote(text) {
+    return text
+        .split("\n")
+        .map((line) => `> ${line}`)
+        .join("\n");
+}
+/**
+ * The fixed preamble. Never dropped by the budget: an unlabelled
+ * reconstruction is the failure mode this whole feature exists to avoid.
+ */
+const HONESTY_HEADER = `# Continuing a prior session — reconstruction, not restored context
+
+You are a **fresh session**. The agent that ran the session described below is
+gone and none of its context is loaded. What follows was assembled by the
+Sapiom Harness from its own recorded events — it is a briefing about that
+session, not a replay of it, and it is partial by construction.
+
+Treat every claim here as something a colleague told you, not as something you
+remember. Before you rely on any of it — what a file contains, what a command
+returned, whether a task was finished — check the current state of the
+repository yourself. If the brief and the working tree disagree, the working
+tree is right.`;
+/**
+ * Render a bounded brief for `record`. Pure and synchronous; the caller
+ * supplies the rolling summary and any registry-only context (title, branch,
+ * bound workflow) it can resolve.
+ */
+export function buildResumeBrief(record, options = {}) {
+    const maxTokens = options.maxTokens ?? RESUME_BRIEF_DEFAULT_MAX_TOKENS;
+    const maxTurns = options.maxTurns ?? RESUME_BRIEF_DEFAULT_MAX_TURNS;
+    const budgetChars = Math.max(0, maxTokens) * CHARS_PER_TOKEN;
+    const identity = renderIdentity(record, options);
+    // The floor: these two are unconditional, so everything else is budgeted
+    // against whatever remains after them.
+    const fixed = `${HONESTY_HEADER}\n\n${identity}`;
+    const digests = deriveDigests(record);
+    const renderedTurns = (maxTurns > 0 ? record.turns.slice(-maxTurns) : []).map((turn) => renderTurn(turn, record.cwd));
+    // Mutable knobs, squeezed in the order the module header documents: the
+    // derived digests first (recoverable from the tree), then turns oldest-first,
+    // then — only if the summary alone still overflows — the summary itself.
+    let summaryText = options.summary?.trim() ?? "";
+    let keepFiles = true;
+    let keepCommands = true;
+    let keptTurns = renderedTurns.length;
+    const assemble = () => {
+        const parts = [fixed];
+        const summarySection = renderSummary(summaryText);
+        if (summarySection)
+            parts.push(summarySection);
+        const dropped = [];
+        const filesSection = keepFiles ? renderFiles(digests) : null;
+        if (filesSection)
+            parts.push(filesSection);
+        else if (!keepFiles && digests.files.length > 0)
+            dropped.push("files written");
+        const commandsSection = keepCommands ? renderCommands(digests) : null;
+        if (commandsSection)
+            parts.push(commandsSection);
+        else if (!keepCommands && digests.commands.length > 0)
+            dropped.push("commands run");
+        if (record.turns.length > 0) {
+            const heading = ["## Recent turns"];
+            const omitted = record.turns.length - keptTurns;
+            if (omitted > 0) {
+                heading.push("", `_The earliest ${omitted} of ${record.turns.length} recorded turns are omitted here to fit the context budget._`);
+            }
+            if (keptTurns === 0)
+                heading.push("", "_No turns fit the context budget._");
+            parts.push(heading.join("\n"));
+            parts.push(...renderedTurns.slice(renderedTurns.length - keptTurns));
+        }
+        if (dropped.length > 0) {
+            parts.push(`_Also omitted to fit the context budget: ${dropped.join(", ")}._`);
+        }
+        return parts.join("\n\n").trimEnd() + "\n";
+    };
+    const over = () => assemble().length > budgetChars;
+    // 1. Turns, oldest-first.
+    while (keptTurns > 0 && over())
+        keptTurns -= 1;
+    // 2. Derived digests, once no turn is left to give. Commands go first — the
+    //    shorter list, and the one most cheaply reconstructed from the repo.
+    if (over())
+        keepCommands = false;
+    if (over())
+        keepFiles = false;
+    // 3. Last resort. Only reachable when the fixed preamble plus the summary
+    //    alone overflow, which means either the summary was produced outside its
+    //    own ≤500-word contract or `maxTokens` is below the preamble floor. Each
+    //    pass strictly shortens `summaryText`, so this terminates.
+    while (summaryText.length > 0 && over()) {
+        const overflow = assemble().length - budgetChars;
+        summaryText = clamp(summaryText, Math.max(0, summaryText.length - overflow - CLAMP_MARKER.length));
+        if (summaryText === CLAMP_MARKER)
+            summaryText = "";
+    }
+    return assemble();
+}
+function renderIdentity(record, options) {
+    const lines = ["## What the prior session was", ""];
+    if (options.title)
+        lines.push(`- **Title:** ${options.title}`);
+    lines.push(`- **Directory:** ${record.cwd ?? "not recorded"}`);
+    if (options.gitBranch)
+        lines.push(`- **Git branch:** ${options.gitBranch}`);
+    lines.push(`- **Agent:** ${record.harness}`);
+    if (options.workflow) {
+        const { name, path: workflowPath, definitionId } = options.workflow;
+        lines.push(`- **Bound workflow:** ${name} (\`${workflowPath}\`)${definitionId !== null ? ` — definition ${definitionId}` : " — not yet linked to a deployed definition"}`);
+    }
+    else {
+        lines.push("- **Bound workflow:** none");
+    }
+    const span = [record.startedAt, record.endedAt].filter(Boolean).join(" → ");
+    if (span)
+        lines.push(`- **Ran:** ${span}`);
+    lines.push(`- **Recorded turns:** ${record.turnCount}`);
+    if (record.limitations.length > 0) {
+        lines.push("", "**Known gaps in this reconstruction:**", "");
+        for (const limitation of record.limitations)
+            lines.push(`- ${LIMITATION_PROSE[limitation]}`);
+    }
+    return lines.join("\n");
+}
+function renderSummary(summary) {
+    const trimmed = summary?.trim();
+    if (!trimmed)
+        return null;
+    return `## Rolling summary of the prior session\n\n${trimmed}`;
+}
+function renderFiles(digests) {
+    if (digests.files.length === 0)
+        return null;
+    const lines = ["## Files the prior session wrote to", "", "_Derived from recorded tool calls, newest first._", ""];
+    for (const file of digests.files) {
+        lines.push(`- \`${file.display}\`${file.count > 1 ? ` (${file.count} edits)` : ""}`);
+    }
+    if (digests.totalFiles > digests.files.length) {
+        lines.push(`- …and ${digests.totalFiles - digests.files.length} more`);
+    }
+    return lines.join("\n");
+}
+function renderCommands(digests) {
+    if (digests.commands.length === 0)
+        return null;
+    const lines = ["## Shell commands it ran", "", "_Distinct commands, newest first._", ""];
+    for (const command of digests.commands)
+        lines.push(`- \`${command}\``);
+    if (digests.totalCommands > digests.commands.length) {
+        lines.push(`- …and ${digests.totalCommands - digests.commands.length} more`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=resume-brief.js.map

package/dist/core/resume-brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-brief.js","sourceRoot":"","sources":["../../src/core/resume-brief.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AASlC,iFAAiF;AACjF,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAK,CAAC;AACrD,gFAAgF;AAChF,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AACjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,kFAAkF;AAClF,MAAM,gBAAgB,GAAG,IAAK,CAAC;AAC/B,MAAM,mBAAmB,GAAG,IAAK,CAAC;AAClC,kEAAkE;AAClE,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,gFAAgF;AAChF,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAC9B,sCAAsC;AACtC,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,6EAA6E;AAC7E,MAAM,YAAY,GAAG,cAAc,CAAC;AA6BpC,oEAAoE;AACpE,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;AAClD,CAAC;AAED;qBACqB;AACrB,SAAS,KAAK,CAAC,IAAY,EAAE,QAAgB;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC;IAC/C,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;AAClE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA2B,EAAE,GAAkB;IAChF,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;QACzF,IAAI,QAAQ;YAAE,OAAO,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,qBAAqB,CAAC,CAAC;QAC9E,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,OAAO;YAAE,OAAO,KAAK,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAC7B,uEAAuE;IACvE,8DAA8D;IAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,qBAAqB,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,cAAc,CAAC,KAAoB;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5E,CAAC,CAAE,MAAkC;YACrC,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,MAA+B,EAAE,IAAuB;IAC3E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;gFACgF;AAChF,SAAS,WAAW,CAAC,MAA+B;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClG,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACnG,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;2EAC2E;AAC3E,SAAS,WAAW,CAAC,QAAgB,EAAE,GAAkB;IACvD,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtE,CAAC;AAED;;6CAE6C;AAC7C,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,OAAO;IACP,MAAM;IACN,WAAW;IACX,cAAc;IACd,QAAQ;IACR,aAAa;IACb,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC;AAYvF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,MAAM;oBACrB,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;oBACzE,CAAC,CAAC,IAAI,CAAC;gBACT,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;oBAClD,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;iBAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACpD,IAAI,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1C,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBAC1B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,+DAA+D;IAC/D,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAClG,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;QAChC,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;QACnD,aAAa,EAAE,QAAQ,CAAC,MAAM;KAC/B,CAAC;AACJ,CAAC;AAED;;;uEAGuE;AACvE,MAAM,gBAAgB,GAA4C;IAChE,uBAAuB,EACrB,yIAAyI;IAC3I,yBAAyB,EACvB,mJAAmJ;IACrJ,wBAAwB,EACtB,oHAAoH;IACtH,uBAAuB,EACrB,8FAA8F;IAChG,mBAAmB,EACjB,8PAA8P;IAChQ,qBAAqB,EACnB,4LAA4L;CAC/L,CAAC;AAEF,SAAS,UAAU,CAAC,IAAuB,EAAE,GAAkB;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE9G,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,qGAAqG,CAAC,CAAC;IACxH,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACrE,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC7C,OAAO,KAAK,IAAI,CAAC,IAAI,IAAI,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3E,CAAC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,QAAQ,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC/F,CAAC;SAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,4BAA4B,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;SAC1B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,cAAc,GAAG;;;;;;;;;;;eAWR,CAAC;AAEhB;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAqB,EACrB,UAAmC,EAAE;IAErC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,+BAA+B,CAAC;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,8BAA8B,CAAC;IACpE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,eAAe,CAAC;IAE7D,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,yEAAyE;IACzE,uCAAuC;IACvC,MAAM,KAAK,GAAG,GAAG,cAAc,OAAO,QAAQ,EAAE,CAAC;IAEjD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,aAAa,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACrF,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAC7B,CAAC;IAEF,wEAAwE;IACxE,8EAA8E;IAC9E,yEAAyE;IACzE,IAAI,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,IAAI,YAAY,GAAG,IAAI,CAAC;IACxB,IAAI,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC;IAErC,MAAM,QAAQ,GAAG,GAAW,EAAE;QAC5B,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,cAAc;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,IAAI,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;aACtC,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/E,MAAM,eAAe,GAAG,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,IAAI,eAAe;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;aAC5C,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAEpF,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;YAChD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CACV,EAAE,EACF,iBAAiB,OAAO,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,8DAA8D,CACjH,CAAC;YACJ,CAAC;YACD,IAAI,SAAS,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,oCAAoC,CAAC,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,4CAA4C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7C,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,GAAY,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC;IAE5D,0BAA0B;IAC1B,OAAO,SAAS,GAAG,CAAC,IAAI,IAAI,EAAE;QAAE,SAAS,IAAI,CAAC,CAAC;IAC/C,4EAA4E;IAC5E,yEAAyE;IACzE,IAAI,IAAI,EAAE;QAAE,YAAY,GAAG,KAAK,CAAC;IACjC,IAAI,IAAI,EAAE;QAAE,SAAS,GAAG,KAAK,CAAC;IAC9B,0EAA0E;IAC1E,6EAA6E;IAC7E,6EAA6E;IAC7E,+DAA+D;IAC/D,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC;QACjD,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACnG,IAAI,WAAW,KAAK,YAAY;YAAE,WAAW,GAAG,EAAE,CAAC;IACrD,CAAC;IAED,OAAO,QAAQ,EAAE,CAAC;AACpB,CAAC;AAED,SAAS,cAAc,CAAC,MAAqB,EAAE,OAAgC;IAC7E,MAAM,KAAK,GAAG,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;IACpD,IAAI,OAAO,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,GAAG,IAAI,cAAc,EAAE,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;QACpE,KAAK,CAAC,IAAI,CACR,yBAAyB,IAAI,OAAO,YAAY,MAC9C,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,iBAAiB,YAAY,EAAE,CAAC,CAAC,CAAC,4CAC5D,EAAE,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5E,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,yBAAyB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAExD,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,wCAAwC,EAAE,EAAE,CAAC,CAAC;QAC7D,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,aAAa,CAAC,OAAkC;IACvD,MAAM,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,8CAA8C,OAAO,EAAE,CAAC;AACjE,CAAC;AAED,SAAS,WAAW,CAAC,OAAuB;IAC1C,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,qCAAqC,EAAE,EAAE,EAAE,mDAAmD,EAAE,EAAE,CAAC,CAAC;IACnH,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,OAAuB;IAC7C,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,KAAK,GAAG,CAAC,0BAA0B,EAAE,EAAE,EAAE,oCAAoC,EAAE,EAAE,CAAC,CAAC;IACzF,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,IAAI,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,UAAU,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,OAAO,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/core/rolling-summary.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Rolling session summary — the thing that makes rehydration good rather than
+ * merely possible.
+ *
+ * A resume brief built from the last N turns alone tells a fresh session what
+ * just happened; it cannot tell it what the session was *for*. So, opt-in, we
+ * periodically fold the whole record down to a ≤500-word summary and cache it
+ * at `<generated>/<harnessSessionId>/summary.md`. The brief
+ * (core/resume-brief.ts) picks it up when it's there and degrades cleanly to
+ * last-N-turns when it isn't — which is the default, since this is
+ * setting-gated (`HarnessSettings.rollingSummary`).
+ *
+ * NEVER BLOCKS A TURN. Everything here is fire-and-forget off the ingest path:
+ * `noteEvent` returns synchronously, the fold runs as a headless one-shot
+ * `TaskManager` job (a separate process, a cheap model, `--max-turns 1` — the
+ * bounded shape `HarnessAdapter.launchTask` exists for), and every failure
+ * mode short-circuits to "no summary". A user's session must never be slower,
+ * or fail, because a summary didn't happen.
+ *
+ * The task does not write the file itself. It is asked for the summary text
+ * and nothing else; we write `summary.md` from its `resultText` when it
+ * completes. Two reasons: the target lives under `<generated>/`, outside the
+ * session's cwd — which codex's `workspace-write` sandbox forbids and
+ * claude-code's `acceptEdits` shouldn't be asked to reach — and a task that
+ * writes its own output can half-write it, where a task that returns text
+ * either produces a whole summary or none.
+ *
+ * WHERE IT DOESN'T WORK: `launchTask` is optional on the adapter contract and
+ * codex has no non-interactive mode wired for it, so a codex session simply
+ * never produces a summary and its briefs are last-N-turns. That is a real
+ * gap, stated rather than papered over; the brief is honest either way.
+ */
+import type { AnalyticsEvent, BackgroundTask, HarnessKind, SessionRecord } from "../shared/types.js";
+/** Filename under `<generated>/<harnessSessionId>/`. */
+export declare const ROLLING_SUMMARY_FILE = "summary.md";
+/** Completed turns that must accumulate before a re-fold is worth its cost. */
+export declare const ROLLING_SUMMARY_TURN_INTERVAL = 10;
+/** The contract stated in the prompt, and the clamp applied to what comes back. */
+export declare const ROLLING_SUMMARY_MAX_WORDS = 500;
+/**
+ * Model alias for the fold. A summary of text we already hold is the cheapest
+ * possible LLM job — pinning a small model here keeps an opt-in background
+ * feature from quietly costing what the user's own session does.
+ */
+export declare const ROLLING_SUMMARY_MODEL = "haiku";
+/** Hard turn cap: one turn in, one summary out. */
+export declare const ROLLING_SUMMARY_MAX_TURNS = 1;
+/** Macro id the task is registered under — also TaskManager's dedupe key, so
+ *  a session can never have two folds in flight at once. */
+export declare const ROLLING_SUMMARY_MACRO_ID = "rolling-summary";
+/**
+ * Token budget for the material handed to the fold. Larger than a brief's
+ * (this is throwaway input to a cheap model, not a system prompt competing
+ * with the user's own context) but still bounded, so a marathon session can't
+ * turn one fold into a huge request.
+ */
+export declare const ROLLING_SUMMARY_INPUT_MAX_TOKENS = 20000;
+/** Absolute path of a session's cached summary. */
+export declare function rollingSummaryPath(generatedRoot: string, harnessSessionId: string): string;
+/**
+ * The cached summary for a session, or null when there is none — never throws.
+ * A brief that fails to find a summary is a brief without one, not an error.
+ */
+export declare function readRollingSummary(generatedRoot: string, harnessSessionId: string): Promise<string | null>;
+/** Trim `text` to at most `maxWords` words, marking the cut. */
+export declare function clampToWords(text: string, maxWords?: number): string;
+/**
+ * The one-shot prompt handed to `launchTask`. The material is the record
+ * rendered by {@link buildResumeBrief} at a larger budget — deliberately the
+ * same renderer the brief uses, so the fold reads exactly the shape a future
+ * brief will present, and there is one place where "what a record looks like
+ * as text" is defined.
+ *
+ * `previous` is folded back in rather than discarded: the record itself is
+ * capped at the input budget, so on a long session the earliest turns are
+ * already gone from the material, and the last summary is the only surviving
+ * account of them.
+ */
+export declare function buildRollingSummaryPrompt(record: SessionRecord, previous: string | null): string;
+/** What the summarizer needs from the outside world. All injectable, so the
+ *  unit tests drive it without a filesystem or a spawned process. */
+export interface RollingSummarizerDeps {
+    /** Root the per-session generated dirs live under. */
+    generatedRoot: string;
+    /** The `HarnessSettings.rollingSummary` gate, re-read per fold so toggling
+     *  the setting takes effect without a restart. Never throws. */
+    enabled: () => Promise<boolean>;
+    /** Reads the reconstructed record for a session (SessionRecordReader.read). */
+    readRecord: (harnessSessionId: string) => Promise<SessionRecord | null>;
+    /** The live session, for the harness kind and cwd the task runs as. Returns
+     *  undefined once the session is gone from the registry. */
+    getSession: (harnessSessionId: string) => {
+        harness: HarnessKind;
+        cwd: string;
+    } | undefined;
+    /** TaskManager.run, narrowed to what this needs. */
+    runTask: (req: {
+        macroId: string;
+        label: string;
+        harnessSessionId: string;
+        harness: HarnessKind;
+        cwd: string;
+        prompt: string;
+        model: string;
+        maxTurns: number;
+    }) => Promise<BackgroundTask>;
+    /** Completed turns between folds. Default {@link ROLLING_SUMMARY_TURN_INTERVAL}. */
+    turnInterval?: number;
+    /** Diagnostics sink. Defaults to console.error — a fold failing is worth a
+     *  log line and nothing more. */
+    onError?: (err: unknown) => void;
+}
+export interface RollingSummarizer {
+    /**
+     * Feed one normalized analytics event. Synchronous and total: it counts
+     * `turn.completed`, triggers a fold on the interval and on `session.end`,
+     * and ignores everything else. Any work it starts is detached.
+     */
+    noteEvent(event: AnalyticsEvent): void;
+    /**
+     * Feed a task status change (TaskManager.onStatusChange). A completed fold
+     * task's `resultText` is what becomes `summary.md`.
+     */
+    noteTaskStatus(task: BackgroundTask): void;
+    /** Resolves when no fold this summarizer started is still in flight. For
+     *  tests and for shutdown; production callers never need to await it. */
+    idle(): Promise<void>;
+}
+export declare function createRollingSummarizer(deps: RollingSummarizerDeps): RollingSummarizer;
+//# sourceMappingURL=rolling-summary.d.ts.map

package/dist/core/rolling-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolling-summary.d.ts","sourceRoot":"","sources":["../../src/core/rolling-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGrG,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,+EAA+E;AAC/E,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAC7C,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C;4DAC4D;AAC5D,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAC1D;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,QAAS,CAAC;AAEvD,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAkC,GAAG,MAAM,CAI/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CA+BhG;AAED;qEACqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB;oEACgE;IAChE,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,+EAA+E;IAC/E,UAAU,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACxE;gEAC4D;IAC5D,UAAU,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,WAAW,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC5F,oDAAoD;IACpD,OAAO,EAAE,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,WAAW,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9B,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;qCACiC;IACjC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3C;6EACyE;IACzE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,CAgGtF"}