@ashlr/hub 3.8.0 → 3.9.0

package/dist/core/verse/session-handoff.js

@@ -0,0 +1,551 @@
+/**
+ * Seat-to-seat handoff: a DETERMINISTIC, ZERO-SPEND note that lets a fresh
+ * session (same seat, a larger window, or another vendor) pick up where a long
+ * one left off.
+ *
+ * Not to be confused with `handoff.ts`, which is the typed planner-to-worker
+ * contract for the local fan-out. This module reads a session's own event log
+ * and writes prose for the next agent to read as its first message.
+ *
+ * WHY DETERMINISTIC: asking the current seat to summarise itself costs a paid
+ * turn (and is refused under local-only). Everything below is assembled from
+ * `events.jsonl` plus a bounded `git diff --stat` per root, so the preview is
+ * free, instant, reproducible, and allowed in every policy mode. When the
+ * operator DOES want the agent's own summary, the UI sends a normal turn to the
+ * current session first and re-previews with `includeLastAssistant: true` — the
+ * spend is then an ordinary, visible, operator-initiated turn.
+ *
+ * NOTHING HERE STARTS A MODEL CALL. The new session's first turn is spent only
+ * when the operator presses send on the pre-filled composer.
+ *
+ * SECTIONS, highest priority first. When the note would exceed
+ * VERSE_HANDOFF_MAX_CHARS the LOWEST-priority sections are dropped, one whole
+ * section at a time, and named in `stats.truncated`:
+ *
+ *   focus         the operator's focus line for the new session
+ *   goal          the first user message (the original ask)
+ *   latest-asks   the last three user messages after it
+ *   state         the last assistant message, abridged (head + tail) — or
+ *                 verbatim (capped) when `includeLastAssistant`, in which
+ *                 case it is the reply to the canned summary request
+ *
+ * CONTROL TURNS ARE NOT ASKS. Two kinds of user message are Verse talking to
+ * the agent, not the operator stating work: the canned
+ * VERSE_HANDOFF_SUMMARY_REQUEST ("Ask this seat to summarize first") and the
+ * `/compact [focus]` that "Compact now" sends. Neither may become the goal or
+ * a latest request: the footer tells the next agent to "continue with the
+ * latest request", and a new chat told to continue with "Write the handoff
+ * note…" writes another handoff note instead of doing the work.
+ *   files         files the agent read or edited, from tool inputs (≤ 60)
+ *   commands      shell commands it ran (≤ 15, most recent)
+ *   errors        failures it hit (≤ 5, most recent)
+ *   repositories  the roots, each with a bounded `git diff --stat HEAD`
+ *   compactions   how often the CLI compacted (early detail is summaries)
+ *
+ * Every section is `scrubSecrets`'d before it is measured, so the cap holds on
+ * the text that is actually returned. Control characters (NUL above all) are
+ * stripped too: the note becomes the new chat's first turn, and turn text
+ * rides on the CLI's argv, where a NUL makes spawn throw. Individual sections carry their own caps
+ * too (a 64 KB first message must not evict everything else).
+ *
+ * The note PREFERS PATHS TO CONTENTS (the rule `handoff.ts` enforces for the
+ * local fan-out, for the same reason): the next agent has the filesystem, and
+ * a file it reads itself is current where a pasted copy is already stale.
+ */
+import { execFileSync } from 'node:child_process';
+import { isAbsolute, relative, resolve as resolvePath, sep } from 'node:path';
+import { scrubSecrets } from '../util/scrub.js';
+import { estimateTokensFromChars } from './context-math.js';
+import { gitArgs } from './context-fit.js';
+import { isDirectoryPath } from './path-guard.js';
+import { VerseServiceError } from './preferences.js';
+import { stripUnsafeControlChars } from './project-memory.js';
+import { VERSE_HANDOFF_MAX_CHARS, VERSE_HANDOFF_SUMMARY_REQUEST, verseSessionRoots, } from './types.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** First line of every handoff note. Also how a handoff OF a handoff is recognised. */
+export const VERSE_HANDOFF_HEADER = '# Continuing from an earlier Verse session';
+export const VERSE_HANDOFF_FOCUS_MAX_CHARS = 500;
+export const HANDOFF_MAX_FILES = 60;
+export const HANDOFF_MAX_COMMANDS = 15;
+export const HANDOFF_MAX_ERRORS = 5;
+export const HANDOFF_LATEST_ASKS = 3;
+const GOAL_MAX_CHARS = 2_500;
+const ASK_MAX_CHARS = 900;
+const STATE_SUMMARY_HEAD_CHARS = 900;
+const STATE_SUMMARY_TAIL_CHARS = 700;
+const STATE_VERBATIM_MAX_CHARS = 6_000;
+const COMMAND_MAX_CHARS = 200;
+const ERROR_MAX_CHARS = 240;
+/** `git diff --stat` bounds, per root and in total (the preview is a synchronous request). */
+export const HANDOFF_GIT_TIMEOUT_MS = 3_000;
+export const HANDOFF_GIT_MAX_BYTES = 4 * 1024;
+const HANDOFF_GIT_TOTAL_BUDGET_MS = 6_000;
+/** Section names, in priority order (index 0 = kept longest). Reported in `stats.truncated`. */
+export const HANDOFF_SECTIONS = [
+    'focus',
+    'goal',
+    'latest-asks',
+    'state',
+    'files',
+    'commands',
+    'errors',
+    'repositories',
+    'compactions',
+];
+// ---------------------------------------------------------------------------
+// Tool classification (claude / local share Claude Code's names; codex and
+// grok have their own). Names read off real event logs and the CLIs' string
+// tables — see the adapters for where each comes from.
+// ---------------------------------------------------------------------------
+const READ_TOOLS = new Set(['Read', 'NotebookRead', 'read_file', 'hashline_read', 'view']);
+const EDIT_TOOLS = new Set([
+    'Edit', 'Write', 'MultiEdit', 'NotebookEdit', // Claude Code (claude + local seats)
+    'write', 'write_file', 'search_replace', 'hashline_edit', 'edit_file', 'create_file', // grok
+]);
+const COMMAND_TOOLS = new Set(['Bash', 'command_execution', 'run_terminal_command', 'PowerShell', 'shell']);
+const PATH_KEYS = ['file_path', 'notebook_path', 'target_file', 'path', 'filePath', 'filename'];
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function pathFromInput(input) {
+    if (!isObject(input))
+        return null;
+    for (const key of PATH_KEYS) {
+        const value = input[key];
+        if (typeof value === 'string' && value.trim().length > 0 && !value.includes('\0'))
+            return value.trim();
+    }
+    return null;
+}
+function commandFromInput(input) {
+    if (!isObject(input))
+        return null;
+    const command = input['command'];
+    if (typeof command === 'string')
+        return command;
+    if (Array.isArray(command) && command.every((part) => typeof part === 'string'))
+        return command.join(' ');
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Control turns (see the module comment)
+// ---------------------------------------------------------------------------
+function normaliseTurnText(text) {
+    return text.replace(/\r\n?/g, '\n').trim();
+}
+const SUMMARY_REQUEST = normaliseTurnText(VERSE_HANDOFF_SUMMARY_REQUEST);
+/** The canned "summarize first" turn, byte-for-byte (after CRLF/whitespace trim). */
+export function isHandoffSummaryRequest(text) {
+    return normaliseTurnText(text) === SUMMARY_REQUEST;
+}
+/**
+ * A CLI control command Verse itself sends as a turn. Only `/compact` — the one
+ * verb "Compact now" emits — is recognised: a message merely STARTING with a
+ * slash ("/Users/me/app is broken") is an ordinary ask and must stay one.
+ */
+export function isControlCommandTurn(text) {
+    return /^\/compact(?:\s|$)/.test(normaliseTurnText(text));
+}
+// ---------------------------------------------------------------------------
+// Text helpers
+// ---------------------------------------------------------------------------
+function oneLine(text, max) {
+    const collapsed = text.replace(/\s+/g, ' ').trim();
+    return collapsed.length <= max ? collapsed : `${collapsed.slice(0, max - 1).trimEnd()}…`;
+}
+/** Cap a multi-line block, cutting at a line boundary when that keeps most of it. */
+function capBlock(text, max) {
+    const trimmed = text.replace(/\r\n?/g, '\n').trim();
+    if (trimmed.length <= max)
+        return trimmed;
+    const marker = '\n[… truncated]';
+    let cut = trimmed.slice(0, max - marker.length);
+    const newline = cut.lastIndexOf('\n');
+    if (newline >= cut.length * 0.7)
+        cut = cut.slice(0, newline);
+    return `${cut.trimEnd()}${marker}`;
+}
+/** Head + tail of a long message: agents put the verdict first or last. */
+function abridge(text) {
+    const trimmed = text.replace(/\r\n?/g, '\n').trim();
+    if (trimmed.length <= STATE_SUMMARY_HEAD_CHARS + STATE_SUMMARY_TAIL_CHARS + 40)
+        return trimmed;
+    let head = trimmed.slice(0, STATE_SUMMARY_HEAD_CHARS);
+    const headBreak = head.lastIndexOf('\n');
+    if (headBreak >= head.length * 0.6)
+        head = head.slice(0, headBreak);
+    let tail = trimmed.slice(trimmed.length - STATE_SUMMARY_TAIL_CHARS);
+    const tailBreak = tail.indexOf('\n');
+    if (tailBreak !== -1 && tailBreak <= tail.length * 0.4)
+        tail = tail.slice(tailBreak + 1);
+    return `${head.trimEnd()}\n[… middle of the reply omitted …]\n${tail.trimStart()}`;
+}
+function quoteBlock(text) {
+    return text.split('\n').map((line) => (line.length > 0 ? `> ${line}` : '>')).join('\n');
+}
+/** A path as the next agent should read it: relative to the primary root when under it. */
+function displayPath(raw, primary) {
+    const absolute = isAbsolute(raw) ? resolvePath(raw) : resolvePath(primary, raw);
+    const rel = relative(primary, absolute);
+    if (rel.length > 0 && !rel.startsWith('..') && !isAbsolute(rel))
+        return rel.split(sep).join('/');
+    return absolute;
+}
+function extract(session, events) {
+    const primary = session.projectPath;
+    const userMessages = [];
+    let turnCount = 0;
+    let lastAssistant = null;
+    // True while the most recent user message is the canned summary request.
+    let inSummaryReply = false;
+    let summaryReply = null;
+    // Insertion-ordered sets; a file edited after being read counts as edited.
+    const edited = new Map();
+    const read = new Map();
+    const commands = [];
+    const errors = [];
+    const compactions = [];
+    const toolNames = new Map();
+    const noteEdited = (raw) => {
+        const path = displayPath(raw, primary);
+        read.delete(path);
+        edited.delete(path); // re-insert so "most recent" ordering holds
+        edited.set(path, true);
+    };
+    const noteRead = (raw) => {
+        const path = displayPath(raw, primary);
+        if (edited.has(path))
+            return;
+        read.delete(path);
+        read.set(path, true);
+    };
+    for (const event of events) {
+        switch (event.type) {
+            case 'user-message':
+                if (typeof event.text === 'string' && event.text.trim().length > 0) {
+                    turnCount += 1;
+                    const summary = isHandoffSummaryRequest(event.text);
+                    // A new user turn supersedes any earlier summary: only the reply to
+                    // the LATEST message can describe where the session stands now.
+                    inSummaryReply = summary;
+                    summaryReply = null;
+                    if (!summary && !isControlCommandTurn(event.text)) {
+                        userMessages.push({ seq: event.seq, text: event.text });
+                    }
+                }
+                break;
+            case 'assistant-message':
+                if (typeof event.text === 'string' && event.text.trim().length > 0) {
+                    lastAssistant = event.text;
+                    if (inSummaryReply)
+                        summaryReply = event.text;
+                }
+                break;
+            case 'tool-use': {
+                toolNames.set(event.toolUseId, event.name);
+                if (READ_TOOLS.has(event.name)) {
+                    const path = pathFromInput(event.input);
+                    if (path)
+                        noteRead(path);
+                }
+                else if (EDIT_TOOLS.has(event.name)) {
+                    const path = pathFromInput(event.input);
+                    if (path)
+                        noteEdited(path);
+                }
+                else if (event.name === 'file_change' && isObject(event.input) && Array.isArray(event.input['changes'])) {
+                    // codex: one item can touch several files.
+                    for (const change of event.input['changes']) {
+                        if (isObject(change) && typeof change['path'] === 'string' && change['path'].length > 0)
+                            noteEdited(change['path']);
+                    }
+                }
+                else if (COMMAND_TOOLS.has(event.name)) {
+                    const command = commandFromInput(event.input);
+                    if (command && command.trim().length > 0) {
+                        const line = oneLine(command, COMMAND_MAX_CHARS);
+                        // Collapse immediate repeats (the same test run five times is one fact).
+                        if (commands[commands.length - 1] !== line)
+                            commands.push(line);
+                    }
+                }
+                break;
+            }
+            case 'tool-result':
+                if (event.isError) {
+                    const name = toolNames.get(event.toolUseId) ?? 'tool';
+                    const output = typeof event.output === 'string' ? event.output : '';
+                    const firstLines = output.split('\n').map((l) => l.trim()).filter((l) => l.length > 0).slice(0, 2).join(' — ');
+                    errors.push(oneLine(`${name}: ${firstLines || 'failed'}`, ERROR_MAX_CHARS));
+                }
+                break;
+            case 'error':
+                if (typeof event.message === 'string' && event.message.trim().length > 0) {
+                    errors.push(oneLine(event.message, ERROR_MAX_CHARS));
+                }
+                break;
+            case 'compaction':
+                compactions.push({ preTokens: event.preTokens, postTokens: event.postTokens, trigger: event.trigger });
+                break;
+            default:
+                break;
+        }
+    }
+    // Dedupe errors keeping the most recent occurrence of each.
+    const recentErrors = [];
+    for (let i = errors.length - 1; i >= 0 && recentErrors.length < HANDOFF_MAX_ERRORS; i -= 1) {
+        if (!recentErrors.includes(errors[i]))
+            recentErrors.unshift(errors[i]);
+    }
+    const recentCommands = [];
+    for (let i = commands.length - 1; i >= 0 && recentCommands.length < HANDOFF_MAX_COMMANDS; i -= 1) {
+        if (!recentCommands.includes(commands[i]))
+            recentCommands.unshift(commands[i]);
+    }
+    return {
+        userMessages,
+        turnCount,
+        lastAssistant,
+        summaryReply,
+        edited: [...edited.keys()],
+        read: [...read.keys()],
+        commands: recentCommands,
+        errors: recentErrors,
+        compactions,
+    };
+}
+/**
+ * A session started from a handoff has the previous note as its first message.
+ * Its real goal is the "Original goal" section inside that note, not the note.
+ */
+function goalFrom(firstUserText) {
+    if (!firstUserText.startsWith(VERSE_HANDOFF_HEADER))
+        return firstUserText;
+    const match = /\n## Original goal\n+([\s\S]*?)(?:\n## |\n---\n|$)/.exec(firstUserText);
+    if (!match)
+        return firstUserText;
+    return match[1].split('\n').map((line) => line.replace(/^> ?/, '')).join('\n').trim() || firstUserText;
+}
+// ---------------------------------------------------------------------------
+// git diff --stat
+// ---------------------------------------------------------------------------
+/**
+ * `git -C <root> diff --stat HEAD`, hardened and bounded: 3 s, 4 KB, no
+ * external diff drivers or textconv filters (a repo's .gitattributes can name
+ * arbitrary commands), no fsmonitor hook, no index lock. Null when the root is
+ * not a repository, has no commits, or git fails.
+ */
+export function defaultGitDiffStat(root) {
+    if (!isDirectoryPath(root))
+        return null;
+    try {
+        const out = execFileSync('git', gitArgs(root, ['diff', '--stat', '--no-color', '--no-ext-diff', '--no-textconv', 'HEAD']), {
+            encoding: 'utf8',
+            timeout: HANDOFF_GIT_TIMEOUT_MS,
+            maxBuffer: 1024 * 1024,
+            stdio: ['ignore', 'pipe', 'ignore'],
+            env: { ...process.env, GIT_OPTIONAL_LOCKS: '0', GIT_TERMINAL_PROMPT: '0', GIT_PAGER: 'cat', PAGER: 'cat' },
+        });
+        return capGitStat(out);
+    }
+    catch {
+        return null;
+    }
+}
+function capGitStat(raw) {
+    const text = raw.replace(/\r\n?/g, '\n').trimEnd();
+    if (text.trim().length === 0)
+        return '';
+    if (Buffer.byteLength(text, 'utf8') <= HANDOFF_GIT_MAX_BYTES)
+        return text;
+    // Keep the summary line ("N files changed, …"): it is the most informative.
+    const lines = text.split('\n');
+    const summary = lines[lines.length - 1];
+    const kept = [];
+    let bytes = Buffer.byteLength(summary, 'utf8') + 64;
+    for (const line of lines.slice(0, -1)) {
+        const size = Buffer.byteLength(line, 'utf8') + 1;
+        if (bytes + size > HANDOFF_GIT_MAX_BYTES)
+            break;
+        kept.push(line);
+        bytes += size;
+    }
+    const omitted = lines.length - 1 - kept.length;
+    return [...kept, ` … ${omitted} more file${omitted === 1 ? '' : 's'}`, summary].join('\n');
+}
+function header(session, turns, events) {
+    const first = events.length > 0 ? events[0].at.slice(0, 10) : session.createdAt.slice(0, 10);
+    const last = events.length > 0 ? events[events.length - 1].at.slice(0, 10) : session.updatedAt.slice(0, 10);
+    const span = first === last ? first : `${first} → ${last}`;
+    return [
+        VERSE_HANDOFF_HEADER,
+        '',
+        `This chat continues "${oneLine(session.title, 120)}" (${session.engine} · ${session.model}, ${turns} turn${turns === 1 ? '' : 's'}, ${span}).`,
+        'The notes below were assembled mechanically from that session\'s log. Treat them as leads, not ground truth: re-read any file before you change it, and check the working tree rather than trusting a summary of it.',
+    ].join('\n');
+}
+const FOOTER = [
+    '---',
+    'Start by checking the current state of the files and repositories above, then continue with the latest request. If anything here is unclear or contradicts what you find, say so before acting.',
+].join('\n');
+/**
+ * Build the handoff note. Deterministic for a given (session, events, opts,
+ * git output): no clock, no randomness, no model.
+ */
+export function buildHandoffPreview(session, events, opts = {}) {
+    const focusRaw = typeof opts.focus === 'string' ? opts.focus.trim() : '';
+    if (focusRaw.length > VERSE_HANDOFF_FOCUS_MAX_CHARS) {
+        throw new VerseServiceError('VERSE_INVALID', `focus must be at most ${VERSE_HANDOFF_FOCUS_MAX_CHARS} characters`);
+    }
+    const gitDiffStat = opts.gitDiffStat ?? defaultGitDiffStat;
+    const data = extract(session, events);
+    const turns = data.turnCount;
+    const sections = [];
+    if (focusRaw.length > 0) {
+        sections.push({ name: 'focus', text: `## Focus for this session\n\n${focusRaw}` });
+    }
+    if (data.userMessages.length > 0) {
+        const goal = capBlock(goalFrom(data.userMessages[0].text), GOAL_MAX_CHARS);
+        sections.push({ name: 'goal', text: `## Original goal\n\n${quoteBlock(goal)}` });
+    }
+    const later = data.userMessages.slice(1).slice(-HANDOFF_LATEST_ASKS);
+    if (later.length > 0) {
+        const skipped = data.userMessages.length - 1 - later.length;
+        const lines = [`## Latest requests (oldest first${skipped > 0 ? `; ${skipped} earlier omitted` : ''})`, ''];
+        later.forEach((message, index) => {
+            // Continuation lines indented under the number so a multi-line ask stays one item.
+            lines.push(`${index + 1}. ${capBlock(message.text, ASK_MAX_CHARS).replace(/\n/g, '\n   ')}`);
+        });
+        sections.push({ name: 'latest-asks', text: lines.join('\n') });
+    }
+    // With `includeLastAssistant` the operator asked the seat to summarise
+    // itself: the state section is THAT reply (the last text of the turn that
+    // answered the canned request). With no such reply on record — the request
+    // failed, or a later turn superseded it — it is the last reply, as before.
+    const stateText = opts.includeLastAssistant === true && data.summaryReply !== null ? data.summaryReply : data.lastAssistant;
+    if (stateText !== null) {
+        const verbatim = opts.includeLastAssistant === true;
+        const body = verbatim ? capBlock(stateText, STATE_VERBATIM_MAX_CHARS) : abridge(stateText);
+        // Say "abridged" only when something was actually left out.
+        const shortened = body !== stateText.replace(/\r\n?/g, '\n').trim();
+        const title = verbatim
+            ? `## Where it stood (the previous agent's own summary, verbatim${shortened ? ', capped' : ''})`
+            : `## Where it stood (the previous agent's last reply${shortened ? ', abridged' : ''})`;
+        sections.push({ name: 'state', text: `${title}\n\n${quoteBlock(body)}` });
+    }
+    const touched = [...data.edited, ...data.read];
+    if (touched.length > 0) {
+        const lines = ['## Files touched', ''];
+        const editedShown = data.edited.slice(-HANDOFF_MAX_FILES);
+        const readShown = data.read.slice(-(HANDOFF_MAX_FILES - editedShown.length));
+        if (editedShown.length > 0) {
+            lines.push('Edited:');
+            for (const path of editedShown)
+                lines.push(`- ${path}`);
+        }
+        if (readShown.length > 0) {
+            if (editedShown.length > 0)
+                lines.push('');
+            lines.push('Read:');
+            for (const path of readShown)
+                lines.push(`- ${path}`);
+        }
+        const hidden = touched.length - editedShown.length - readShown.length;
+        if (hidden > 0)
+            lines.push('', `(${hidden} more not listed)`);
+        lines.push('', `Relative paths are relative to ${session.projectPath}.`);
+        sections.push({ name: 'files', text: lines.join('\n') });
+    }
+    if (data.commands.length > 0) {
+        sections.push({
+            name: 'commands',
+            text: ['## Commands run (most recent last)', '', ...data.commands.map((c) => `- \`${c.replace(/`/g, "'")}\``)].join('\n'),
+        });
+    }
+    if (data.errors.length > 0) {
+        sections.push({
+            name: 'errors',
+            text: ['## Errors seen (most recent last)', '', ...data.errors.map((e) => `- ${e}`)].join('\n'),
+        });
+    }
+    const roots = verseSessionRoots(session);
+    {
+        const lines = ['## Repositories', ''];
+        const started = Date.now();
+        roots.forEach((root, index) => {
+            lines.push(`- ${root}${index === 0 ? ' (primary)' : ''}`);
+            // The default runs git synchronously on the request thread: bound the
+            // whole loop, not just each call, so eight slow roots cannot stall it.
+            if (opts.gitDiffStat === undefined && Date.now() - started > HANDOFF_GIT_TOTAL_BUDGET_MS) {
+                lines.push('  (diff not collected: time budget spent)');
+                return;
+            }
+            let stat;
+            try {
+                stat = gitDiffStat(root);
+            }
+            catch {
+                stat = null;
+            }
+            if (stat === null)
+                return;
+            const capped = capGitStat(stat);
+            if (capped === null || capped.length === 0) {
+                lines.push('  No uncommitted changes against HEAD.');
+            }
+            else {
+                lines.push('  Uncommitted changes against HEAD (`git diff --stat HEAD`):', '', '  ```', ...capped.split('\n').map((l) => `  ${l}`), '  ```');
+            }
+        });
+        sections.push({ name: 'repositories', text: lines.join('\n') });
+    }
+    const compactionCount = Math.max(session.compactionCount ?? 0, data.compactions.length);
+    if (compactionCount > 0) {
+        const last = data.compactions[data.compactions.length - 1];
+        const detail = last && last.preTokens !== null && last.postTokens !== null
+            ? ` The last one shrank the context from ~${Math.round(last.preTokens / 1000)}k to ~${Math.round(last.postTokens / 1000)}k tokens.`
+            : '';
+        sections.push({
+            name: 'compactions',
+            text: `## Compactions\n\nThe previous session auto-compacted ${compactionCount} time${compactionCount === 1 ? '' : 's'}, so its early turns survived only as summaries.${detail} Details from early in that session may be lost; verify rather than assume.`,
+        });
+    }
+    // Scrub every part BEFORE measuring, so the cap holds on what is returned.
+    const clean = (text) => scrubSecrets(stripUnsafeControlChars(text));
+    const head = clean(header(session, turns, events));
+    const foot = FOOTER;
+    const scrubbed = sections.map((s) => ({ name: s.name, text: clean(s.text) }));
+    const separator = '\n\n';
+    const total = (parts) => [head, ...parts.map((p) => p.text), foot].join(separator).length;
+    const kept = [...scrubbed];
+    const dropped = [];
+    while (kept.length > 0 && total(kept) > VERSE_HANDOFF_MAX_CHARS) {
+        // Drop the lowest-priority section still present.
+        let worst = 0;
+        for (let i = 1; i < kept.length; i += 1) {
+            if (HANDOFF_SECTIONS.indexOf(kept[i].name) > HANDOFF_SECTIONS.indexOf(kept[worst].name))
+                worst = i;
+        }
+        dropped.push(kept[worst].name);
+        kept.splice(worst, 1);
+    }
+    let text = [head, ...kept.map((p) => p.text), foot].join(separator);
+    // Unreachable with the per-section caps above, but the contract is a hard cap.
+    if (text.length > VERSE_HANDOFF_MAX_CHARS)
+        text = text.slice(0, VERSE_HANDOFF_MAX_CHARS);
+    return {
+        sourceSessionId: session.id,
+        sourceTitle: clean(session.title),
+        text,
+        stats: {
+            chars: text.length,
+            estTokens: estimateTokensFromChars(text.length),
+            turnsCovered: turns,
+            filesTouched: touched.length,
+            truncated: dropped,
+        },
+    };
+}
+//# sourceMappingURL=session-handoff.js.map

package/dist/core/verse/session-handoff.js.map

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

package/dist/core/verse/session-search.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Keyword search over past Verse sessions — zero spend, no index, no model.
+ *
+ * The corpus is the durable event log the session store already keeps
+ * (`<id>.events.jsonl`). Only what the OPERATOR and the AGENT said is searched
+ * (`user-message`, `assistant-message`): tool inputs and outputs are huge,
+ * noisy and full of file contents that would drown every real hit, and
+ * `text-delta` / `thinking` duplicate or pre-empt the final message.
+ *
+ * MATCHING: every term must occur in ONE message (terms are AND-ed,
+ * case-insensitive; a "double-quoted phrase" is one term). A hit is a message,
+ * so the snippet shown is the place the operator actually remembers.
+ *
+ * SCORING (deterministic given `now`):
+ *   term score  = Σ over terms of (1 + ln(occurrences)) — repetition helps, with
+ *                 diminishing returns, so one message that says "migration" 40
+ *                 times does not bury every other
+ *   title bonus = +1 when every term also appears in the session title
+ *   kind weight = user messages ×1.1 (the operator's own words are what they
+ *                 search for), assistant ×1.0
+ *   recency     = × (0.35 + 0.65 · 0.5^(ageDays / 14)) — a two-week half-life
+ *                 that never drives an old exact match to zero
+ *
+ * BOUNDS — this runs synchronously on the API thread, so it is bounded twice:
+ * the newest ≤ VERSE_SEARCH_MAX_SESSIONS sessions (by updatedAt) and at most
+ * VERSE_SEARCH_MAX_SCAN_CHARS of message text in total. Either bound tripping
+ * sets `truncated`, so the UI can say "searched the most recent N" instead of
+ * implying the whole history was covered. At most VERSE_SEARCH_MAX_HITS_PER_SESSION
+ * hits come from one session so a single long chat cannot fill the list.
+ *
+ * Snippets are whitespace-collapsed, ≤ 240 chars, and `scrubSecrets`'d.
+ */
+import type { VerseEvent, VerseSearchResponse, VerseSession } from './types.js';
+export declare const VERSE_SEARCH_MAX_SESSIONS = 200;
+/** ~20 MB of message text (UTF-16 code units, which is what is actually scanned). */
+export declare const VERSE_SEARCH_MAX_SCAN_CHARS: number;
+export declare const VERSE_SEARCH_DEFAULT_LIMIT = 20;
+export declare const VERSE_SEARCH_MAX_LIMIT = 50;
+export declare const VERSE_SEARCH_MAX_QUERY_CHARS = 200;
+export declare const VERSE_SEARCH_MAX_TERMS = 8;
+export declare const VERSE_SEARCH_MAX_HITS_PER_SESSION = 3;
+export declare const VERSE_SEARCH_SNIPPET_CHARS = 240;
+export interface VerseSearchInput {
+    sessions: VerseSession[];
+    readEvents: (id: string) => VerseEvent[];
+    query: string;
+    limit?: number;
+    /** Injectable clock for the recency weight (tests). Default: the real clock. */
+    now?: () => Date;
+}
+/**
+ * Split a query into lower-cased terms. `"exact phrase"` stays one term;
+ * everything else splits on whitespace. Duplicates collapse. Throws
+ * VERSE_INVALID for an empty or oversized query.
+ */
+export declare function parseSearchQuery(query: string): string[];
+/**
+ * ≤ VERSE_SEARCH_SNIPPET_CHARS of whitespace-collapsed, secret-scrubbed text
+ * around the first match. Scrubbed BEFORE windowing so a redaction can never
+ * push the snippet over its cap or leave half a token at a window edge.
+ */
+export declare function buildSnippet(text: string, firstTerm: string): string;
+export declare function searchSessions(input: VerseSearchInput): VerseSearchResponse;