@nxuss/lemma 1.44.0 → 1.45.0

package/dist/cjs/utils/OpenCodeSession.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * OpenCode sessions → the hand-off. OpenCode has no SessionEnd hook and no transcript file: its
+ * plugin gets the session from the SDK (`client.session.messages`, `client.session.children`) as
+ * `{ info, parts }` messages, and subagents are child sessions the `task` tool creates. The plugin
+ * `lemma init` installs sends that snapshot here when the session goes idle (and before a
+ * compaction); it is rewritten as a Claude Code shaped transcript, subagents beside it in
+ * `<name>/subagents/agent-<id>.jsonl` + `.meta.json`, so captureSession builds the same hand-off
+ * it builds for Claude Code instead of a second implementation drifting from the first.
+ *
+ * Measured on OpenCode 1.19.3 (session snapshot from a real `opencode run` with a `task` subagent):
+ * tool parts carry `state.input` with `filePath` (read/edit/write) or `command` (bash), and `patch`
+ * parts list the files the step changed on disk, which also catches edits made through bash.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toClaudeEvents = toClaudeEvents;
+exports.writeClaudeTranscript = writeClaudeTranscript;
+exports.captureOpenCodeSession = captureOpenCodeSession;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const SessionCapture_1 = require("./SessionCapture");
+const HostRecall_1 = require("../subconscious/HostRecall");
+const AtomicFile_1 = require("./AtomicFile");
+const TRANSCRIPT_DIR = path_1.default.join(os_1.default.tmpdir(), 'lemma-opencode');
+const KEEP_MS = 3 * 24 * 60 * 60 * 1000;
+/** OpenCode tool ids → the names SessionCapture knows. MCP tools arrive as `<server>_<tool>`. */
+const TOOL_NAMES = { read: 'Read', edit: 'Edit', write: 'Write', multiedit: 'MultiEdit', bash: 'Bash', task: 'Agent', grep: 'Grep', glob: 'Glob', list: 'LS' };
+const FILE_TOOLS = new Set(['Read', 'Edit', 'Write', 'MultiEdit']);
+function toolName(tool) {
+    if (TOOL_NAMES[tool])
+        return TOOL_NAMES[tool];
+    const lemma = /^lemma_(.+)$/.exec(tool);
+    return lemma ? `mcp__lemma__${lemma[1]}` : tool;
+}
+/** Files named in an apply_patch body (the tool GPT models get in OpenCode). */
+function patchFiles(patchText) {
+    if (typeof patchText !== 'string')
+        return [];
+    return [...patchText.matchAll(/^\*\*\* (?:Add|Update|Delete) File: (.+)$/gm)].map((m) => m[1].trim());
+}
+const iso = (ms, fallback) => (typeof ms === 'number' && ms > 0 ? new Date(ms).toISOString() : fallback);
+/** One OpenCode session as Claude Code transcript events (one JSON object per line). */
+function toClaudeEvents(messages, directory, sidechain) {
+    const lines = [];
+    const extra = sidechain ? { isSidechain: true, agentId: sidechain } : {};
+    const push = (timestamp, o) => lines.push(JSON.stringify({ timestamp, ...extra, ...o }));
+    const abs = (f) => path_1.default.resolve(directory, f);
+    let n = 0;
+    for (const m of messages ?? []) {
+        const role = m?.info?.role;
+        const at = iso(m?.info?.time?.created, new Date(0).toISOString());
+        for (const p of m?.parts ?? []) {
+            if (p?.type === 'text' && typeof p.text === 'string' && p.text.trim() && !p.synthetic) {
+                push(at, role === 'user'
+                    ? { type: 'user', message: { role: 'user', content: p.text } }
+                    : { type: 'assistant', message: { role: 'assistant', content: [{ type: 'text', text: p.text }] } });
+            }
+            else if (p?.type === 'patch' && Array.isArray(p.files)) {
+                // The step's on-disk changes, whichever tool made them.
+                for (const f of p.files)
+                    if (typeof f === 'string')
+                        push(at, { type: 'assistant', message: { role: 'assistant', content: [{ type: 'tool_use', id: `patch-${n++}`, name: 'Edit', input: { file_path: abs(f) } }] } });
+            }
+            else if (p?.type === 'tool' && typeof p.tool === 'string') {
+                const st = p.state ?? {};
+                const start = iso(st.time?.start, at);
+                const name = toolName(p.tool);
+                const input = { ...(st.input && typeof st.input === 'object' ? st.input : {}) };
+                if (FILE_TOOLS.has(name) && typeof input.filePath === 'string')
+                    input.file_path = abs(input.filePath);
+                const id = p.callID || `call-${n++}`;
+                const files = /^(apply_)?patch$/.test(p.tool) ? patchFiles(input.patchText) : [];
+                if (files.length) {
+                    for (const f of files)
+                        push(start, { type: 'assistant', message: { role: 'assistant', content: [{ type: 'tool_use', id: `${id}-${n++}`, name: 'Edit', input: { file_path: abs(f) } }] } });
+                    continue;
+                }
+                push(start, { type: 'assistant', message: { role: 'assistant', content: [{ type: 'tool_use', id, name, input }] } });
+                if (st.status === 'completed' || st.status === 'error') {
+                    const content = st.status === 'error' ? String(st.error ?? '') : String(st.output ?? '');
+                    push(iso(st.time?.end, start), { type: 'user', message: { role: 'user', content: [{ type: 'tool_result', tool_use_id: id, content }] } });
+                }
+            }
+        }
+    }
+    return lines;
+}
+/** The description the parent gave each subagent: the `task` call whose metadata names the child session. */
+function taskDescriptions(messages) {
+    const out = new Map();
+    for (const m of messages ?? [])
+        for (const p of m?.parts ?? []) {
+            if (p?.type !== 'tool' || p.tool !== 'task')
+                continue;
+            const child = p.state?.metadata?.sessionId;
+            const description = p.state?.input?.description;
+            if (typeof child === 'string' && typeof description === 'string')
+                out.set(child, description);
+        }
+    return out;
+}
+function prune(dir) {
+    try {
+        for (const name of fs_1.default.readdirSync(dir)) {
+            const f = path_1.default.join(dir, name);
+            if (Date.now() - fs_1.default.statSync(f).mtimeMs > KEEP_MS)
+                fs_1.default.rmSync(f, { recursive: true, force: true });
+        }
+    }
+    catch {
+        // a leftover temp file costs nothing
+    }
+}
+/** Writes the snapshot as `<dir>/<session>.jsonl` plus its subagents, and returns the transcript path. */
+function writeClaudeTranscript(snap, dir = TRANSCRIPT_DIR) {
+    fs_1.default.mkdirSync(dir, { recursive: true });
+    prune(dir);
+    const safe = (id) => id.replace(/[^A-Za-z0-9_-]/g, '_');
+    const base = path_1.default.join(dir, safe(snap.sessionID));
+    (0, AtomicFile_1.writeFileAtomic)(`${base}.jsonl`, toClaudeEvents(snap.messages, snap.directory).join('\n'));
+    const subdir = path_1.default.join(base, 'subagents');
+    fs_1.default.rmSync(subdir, { recursive: true, force: true });
+    const descriptions = taskDescriptions(snap.messages);
+    for (const child of snap.children ?? []) {
+        const id = child?.session?.id;
+        if (typeof id !== 'string')
+            continue;
+        fs_1.default.mkdirSync(subdir, { recursive: true });
+        fs_1.default.writeFileSync(path_1.default.join(subdir, `agent-${safe(id)}.jsonl`), toClaudeEvents(child.messages, snap.directory, id).join('\n'));
+        const description = descriptions.get(id) ?? child.session.title?.replace(/\s*\(@\S+ subagent\)\s*$/, '');
+        fs_1.default.writeFileSync(path_1.default.join(subdir, `agent-${safe(id)}.meta.json`), JSON.stringify({ ...(child.session.agent ? { agentType: child.session.agent } : {}), ...(description ? { description } : {}) }));
+    }
+    return `${base}.jsonl`;
+}
+/**
+ * Save (or refresh) the session's hand-off. OpenCode has no session end: `session.idle` fires after
+ * every turn, so this runs in the mid-session mode (PreCompact's): it refreshes one hand-off in place
+ * and never marks the session done. `compacting` also returns the text to put back in the context.
+ */
+function captureOpenCodeSession(snap, opts = {}) {
+    if (!snap || typeof snap.sessionID !== 'string' || typeof snap.directory !== 'string' || !Array.isArray(snap.messages))
+        return { skipped: 'no-transcript' };
+    const transcript = writeClaudeTranscript(snap);
+    const res = (0, SessionCapture_1.captureSession)({ session_id: snap.sessionID, transcript_path: transcript, cwd: snap.directory }, snap.directory, undefined, { preCompact: true });
+    if (!opts.compacting)
+        return res;
+    const recall = (0, HostRecall_1.compactRecall)({ source: 'compact', session_id: snap.sessionID, cwd: snap.directory }, snap.directory);
+    return recall ? { ...res, text: recall.text } : res;
+}
+//# sourceMappingURL=OpenCodeSession.js.map

package/dist/cjs/utils/OpenCodeSession.js.map

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

package/dist/cjs/utils/SessionCapture.d.ts

@@ -33,14 +33,36 @@ export interface SessionDigest {
     /** Timestamp of the first transcript event: where "commits made during this session" starts. */
     startedAt?: string;
     /** The last test/build/lint run the agent made and how it ended; unset when the output didn't say. */
-    lastVerdict?: {
-        command: string;
-        passed: boolean;
-        headline: string;
-    };
+    lastVerdict?: Verdict;
+    /** What the session's subagents did, when asked for (digestTranscript's `subagents` option). Not counted in the fields above. */
+    subagents?: SubagentDigest[];
 }
-/** Reads the transcript (JSONL, one event per line) into the few facts capture needs. */
-export declare function digestTranscript(transcriptPath: string): SessionDigest | null;
+export interface Verdict {
+    command: string;
+    passed: boolean;
+    headline: string;
+    /** Timestamp of the run's result, when the transcript had one: which of several agents ran last. */
+    at?: string;
+}
+/** One subagent's share of the work, from its own transcript. */
+export interface SubagentDigest {
+    agentId: string;
+    /** What the parent called it (the Agent tool's description), from the host's meta file. */
+    description?: string;
+    agentType?: string;
+    startedAt?: string;
+    toolCalls: number;
+    edited: string[];
+    lastVerdict?: Verdict;
+}
+/**
+ * Reads the transcript (JSONL, one event per line) into the few facts capture needs. The fields
+ * describe the main agent only; `subagents: true` adds what each subagent did, read from the
+ * sidechain events in this file and from the host's per-subagent transcripts next to it.
+ */
+export declare function digestTranscript(transcriptPath: string, opts?: {
+    subagents?: boolean;
+}): SessionDigest | null;
 /**
  * Where a session that edited code left off, from the transcript and git alone. The task is the
  * person's first prompt, uncut up to a limit, because that is where a multi-part plan lives; "what

package/dist/cjs/utils/SessionCapture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionCapture.d.ts","sourceRoot":"","sources":["../../../src/utils/SessionCapture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAA0C,UAAU,EAAE,MAAM,4BAA4B,CAAC;AA2BhG,eAAO,MAAM,YAAY,wBAAwB,CAAC;AASlD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;IACzB,0GAA0G;IAC1G,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sGAAsG;IACtG,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACtE;AAkCD,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA+D7E;AA+BD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CA0B9F;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhE;AAsBD,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,eAAe,GAAG,UAAU,GAAG,kBAAkB,GAAG,cAAc,GAAG,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;CACzI;AAED,0GAA0G;AAC1G,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,oBAAoB,CAqE5I;AAuBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWtH"}
+{"version":3,"file":"SessionCapture.d.ts","sourceRoot":"","sources":["../../../src/utils/SessionCapture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAA0C,UAAU,EAAE,MAAM,4BAA4B,CAAC;AA2BhG,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAkBlD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;IACzB,0GAA0G;IAC1G,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sGAAsG;IACtG,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iIAAiI;IACjI,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,oGAAoG;IACpG,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA2CD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,aAAa,GAAG,IAAI,CAYjH;AA2LD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAyC9F;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhE;AAsBD,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,eAAe,GAAG,UAAU,GAAG,kBAAkB,GAAG,cAAc,GAAG,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,CAAC;CACzI;AAED,0GAA0G;AAC1G,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,oBAAoB,CAwE5I;AAuBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWtH"}

package/dist/cjs/utils/SessionCapture.js

@@ -62,9 +62,18 @@ const AGENT_NOTE_MARK = "AGENT'S NOTE";
 const MAX_AGENT_NOTE_CHARS = 1500;
 const MAX_HANDOFF_FILES = 10;
 const MAX_SAID_CHARS = 700;
+/** Subagent transcripts read per session (newest first) and the bytes read from each: an orchestrator can spawn dozens. */
+const MAX_SUBAGENT_TRANSCRIPTS = 30;
+const MAX_SUBAGENT_BYTES = 2 * 1024 * 1024;
+const SUBAGENT_HEAD_BYTES = 128 * 1024;
+const SUBAGENT_TAIL_BYTES = 1536 * 1024;
+const MAX_SUBAGENT_LINES = 6;
+const MAX_DESCRIPTION_CHARS = 80;
 const REMEMBERED_SESSIONS = 50;
 /** Tools that mean the agent already wrote (or deliberately declined to write) its own memory. */
 const OWN_MEMORY_TOOL = /^mcp__lemma__(store|update|forget)_memory$/;
+/** Lemma's own editing tools: `filePath` is relative to the project root (multi_file_patch carries a list of them). */
+const LEMMA_EDIT_TOOL = /^mcp__lemma__(write_workspace_file|create_workspace_file|apply_workspace_patch|multi_file_patch)$/;
 function textOf(content) {
     if (typeof content === 'string')
         return content;
@@ -81,13 +90,13 @@ function textOf(content) {
  * done; dropping them would leave no hand-off where it matters most. Counts such as `toolCalls`
  * then describe the tail only.
  */
-function readEnds(file, size) {
+function readEnds(file, size, headBytes = HEAD_BYTES, tailBytes = TAIL_BYTES) {
     const fd = fs_1.default.openSync(file, 'r');
     try {
-        const head = Buffer.alloc(HEAD_BYTES);
-        fs_1.default.readSync(fd, head, 0, HEAD_BYTES, 0);
-        const tail = Buffer.alloc(TAIL_BYTES);
-        fs_1.default.readSync(fd, tail, 0, TAIL_BYTES, size - TAIL_BYTES);
+        const head = Buffer.alloc(headBytes);
+        fs_1.default.readSync(fd, head, 0, headBytes, 0);
+        const tail = Buffer.alloc(tailBytes);
+        fs_1.default.readSync(fd, tail, 0, tailBytes, size - tailBytes);
         const h = head.toString('utf8');
         const t = tail.toString('utf8');
         // Drop the partial line at each cut; an unparseable line would be skipped anyway, but a cut
@@ -98,8 +107,24 @@ function readEnds(file, size) {
         fs_1.default.closeSync(fd);
     }
 }
-/** Reads the transcript (JSONL, one event per line) into the few facts capture needs. */
-function digestTranscript(transcriptPath) {
+function parseLines(raw) {
+    const events = [];
+    for (const line of raw.split('\n')) {
+        if (!line)
+            continue;
+        try {
+            events.push(JSON.parse(line));
+        }
+        catch { /* a cut or garbled line */ }
+    }
+    return events;
+}
+/**
+ * Reads the transcript (JSONL, one event per line) into the few facts capture needs. The fields
+ * describe the main agent only; `subagents: true` adds what each subagent did, read from the
+ * sidechain events in this file and from the host's per-subagent transcripts next to it.
+ */
+function digestTranscript(transcriptPath, opts = {}) {
     let raw;
     try {
         const stat = fs_1.default.statSync(transcriptPath);
@@ -108,21 +133,19 @@ function digestTranscript(transcriptPath) {
     catch {
         return null;
     }
+    const events = parseLines(raw);
+    const digest = scan(events.filter((ev) => !ev?.isSidechain));
+    if (opts.subagents)
+        digest.subagents = digestSubagents(transcriptPath, events.filter((ev) => ev?.isSidechain));
+    return digest;
+}
+function scan(events) {
     const digest = { prompt: '', answer: '', toolCalls: 0, edited: [], read: [], storedOwnMemory: false };
     const readCount = new Map();
     const verdictCommands = new Map(); // tool_use id -> command, for verdict-shaped Bash runs
     let edited = false;
-    for (const line of raw.split('\n')) {
-        if (!line)
-            continue;
-        let ev;
-        try {
-            ev = JSON.parse(line);
-        }
-        catch {
-            continue;
-        }
-        if (ev.isSidechain)
+    for (const ev of events) {
+        if (!ev || typeof ev !== 'object')
             continue;
         if (!digest.startedAt && typeof ev.timestamp === 'string')
             digest.startedAt = ev.timestamp;
@@ -138,7 +161,7 @@ function digestTranscript(transcriptPath) {
                 const passed = (0, FixCapture_1.inferVerdict)(output);
                 if (passed === null)
                     continue;
-                digest.lastVerdict = { command, passed, headline: passed ? '' : (0, FixCapture_1.extractFailure)(output).headline };
+                digest.lastVerdict = { command, passed, headline: passed ? '' : (0, FixCapture_1.extractFailure)(output).headline, ...(typeof ev.timestamp === 'string' ? { at: ev.timestamp } : {}) };
             }
         }
         if (ev.type === 'user') {
@@ -170,11 +193,15 @@ function digestTranscript(transcriptPath) {
             }
             if (name === 'Bash')
                 digest.ranAfterEdit = edited;
-            if (typeof file === 'string' && /^(Edit|Write|MultiEdit|NotebookEdit)$/.test(name)) {
+            const lemmaEdits = LEMMA_EDIT_TOOL.test(name)
+                ? [block.input?.filePath, ...(Array.isArray(block.input?.patches) ? block.input.patches.map((x) => x?.filePath) : [])].filter((f) => typeof f === 'string' && !!f)
+                : [];
+            if ((typeof file === 'string' && /^(Edit|Write|MultiEdit|NotebookEdit)$/.test(name)) || lemmaEdits.length) {
                 edited = true;
                 digest.ranAfterEdit = false;
-                if (!digest.edited.includes(file))
-                    digest.edited.push(file);
+                for (const f of lemmaEdits.length ? lemmaEdits : [file])
+                    if (!digest.edited.includes(f))
+                        digest.edited.push(f);
             }
             else if (typeof file === 'string' && name === 'Read') {
                 readCount.set(file, (readCount.get(file) ?? 0) + 1);
@@ -184,6 +211,94 @@ function digestTranscript(transcriptPath) {
     digest.read = [...readCount.entries()].sort((a, b) => b[1] - a[1]).map(([f]) => f);
     return digest;
 }
+function readMeta(file) {
+    try {
+        const m = JSON.parse(fs_1.default.readFileSync(file, 'utf8'));
+        return {
+            ...(typeof m?.description === 'string' && m.description.trim() ? { description: m.description.trim() } : {}),
+            ...(typeof m?.agentType === 'string' && m.agentType ? { agentType: m.agentType } : {}),
+        };
+    }
+    catch {
+        return {};
+    }
+}
+function subagentDigest(agentId, events, meta) {
+    const d = scan(events);
+    return { agentId, ...meta, ...(d.startedAt ? { startedAt: d.startedAt } : {}), toolCalls: d.toolCalls, edited: d.edited, ...(d.lastVerdict ? { lastVerdict: d.lastVerdict } : {}) };
+}
+/**
+ * What the session's subagents did. Claude Code writes each one to
+ * `<transcript without .jsonl>/subagents/agent-<id>.jsonl`, with a `.meta.json` beside it naming
+ * the description the parent gave; older builds put the same events in the main transcript,
+ * flagged isSidechain. A subagent found in both is read from its own file, which is whole.
+ * An orchestrator that delegated the edits used to leave an empty hand-off: its own transcript
+ * holds the Agent calls, not the files they changed or the tests they ran.
+ */
+function digestSubagents(transcriptPath, sidechain) {
+    const byId = new Map();
+    const dir = path_1.default.join(transcriptPath.replace(/\.jsonl$/, ''), 'subagents');
+    let files = [];
+    try {
+        files = fs_1.default.readdirSync(dir)
+            .map((name) => /^agent-(.+)\.jsonl$/.exec(name))
+            .filter((m) => !!m)
+            .map((m) => {
+            const file = path_1.default.join(dir, m[0]);
+            const st = fs_1.default.statSync(file);
+            return { id: m[1], file, mtime: st.mtimeMs, size: st.size };
+        })
+            .sort((a, b) => b.mtime - a.mtime)
+            .slice(0, MAX_SUBAGENT_TRANSCRIPTS);
+    }
+    catch {
+        // no subagents directory: a session that delegated nothing, or an older host
+    }
+    for (const f of files) {
+        try {
+            const raw = f.size > MAX_SUBAGENT_BYTES ? readEnds(f.file, f.size, SUBAGENT_HEAD_BYTES, SUBAGENT_TAIL_BYTES) : fs_1.default.readFileSync(f.file, 'utf8');
+            byId.set(f.id, subagentDigest(f.id, parseLines(raw), readMeta(f.file.replace(/\.jsonl$/, '.meta.json'))));
+        }
+        catch {
+            // unreadable: that subagent simply isn't listed
+        }
+    }
+    const inline = new Map();
+    for (const ev of sidechain) {
+        const id = typeof ev.agentId === 'string' && ev.agentId ? ev.agentId : 'sidechain';
+        if (byId.has(id))
+            continue;
+        if (!inline.has(id))
+            inline.set(id, []);
+        inline.get(id).push(ev);
+    }
+    for (const [id, evs] of inline)
+        byId.set(id, subagentDigest(id, evs, {}));
+    return [...byId.values()].sort((a, b) => String(a.startedAt ?? '').localeCompare(String(b.startedAt ?? '')));
+}
+/** Files edited by the main agent first, then by its subagents, once each. */
+function allEdited(digest) {
+    const out = [...digest.edited];
+    for (const s of digest.subagents ?? [])
+        for (const f of s.edited)
+            if (!out.includes(f))
+                out.push(f);
+    return out;
+}
+/** The latest test/build run by any agent of the session, and which subagent ran it (unset for the main agent). */
+function latestVerdict(digest) {
+    let best = digest.lastVerdict ? { verdict: digest.lastVerdict } : null;
+    for (const s of digest.subagents ?? []) {
+        const v = s.lastVerdict;
+        if (!v)
+            continue;
+        // Without timestamps on both there is no telling who ran last, and the run already chosen stands.
+        if (!best || (v.at && best.verdict.at && v.at > best.verdict.at))
+            best = { verdict: v, by: s };
+    }
+    return best;
+}
+const subagentName = (s) => `${s.description ? `"${clip(s.description, MAX_DESCRIPTION_CHARS)}"` : `agent ${s.agentId}`}${s.agentType ? ` (${s.agentType})` : ''}`;
 function seen(root) {
     try {
         const parsed = JSON.parse(fs_1.default.readFileSync(path_1.default.join(root, STATE_FILE), 'utf8'));
@@ -212,6 +327,20 @@ function git(root, args) {
     }
 }
 const clip = (text, max) => (text.length > max ? `${text.slice(0, max)}…` : text);
+/**
+ * A path as the filesystem resolves it. git reports the root resolved (macOS /var and /tmp are links to
+ * /private/…) while a host can report the same files through the link, and path.relative between the two
+ * spellings gave `../../../../var/folders/…/src/tax.js`, and the file was not tracked.
+ */
+function realPath(root, f) {
+    const abs = path_1.default.resolve(root, f);
+    try {
+        return fs_1.default.realpathSync(abs);
+    }
+    catch {
+        return abs; // deleted since: the spelling the host gave is the best there is
+    }
+}
 /**
  * Where a session that edited code left off, from the transcript and git alone. The task is the
  * person's first prompt, uncut up to a limit, because that is where a multi-part plan lives; "what
@@ -219,8 +348,9 @@ const clip = (text, max) => (text.length > max ? `${text.slice(0, max)}…` : te
  * against what changed. Exported for tests.
  */
 function buildHandoff(root, digest, carriedPlan) {
-    const rel = (f) => path_1.default.relative(root, f) || f;
-    const edited = digest.edited.map(rel);
+    // Lemma's edit tools record paths relative to the project root, the host's are absolute.
+    const rel = (f) => path_1.default.relative(root, realPath(root, f)) || f;
+    const edited = allEdited(digest).map(rel);
     // A continuation's own prompt ("continue where we left off") says nothing: the plan is the one
     // the previous hand-off held, carried forward as it was first given.
     const taskBlock = carriedPlan
@@ -238,9 +368,24 @@ function buildHandoff(root, digest, carriedPlan) {
     const commits = digest.startedAt ? git(root, ['log', `--since=${digest.startedAt}`, '-5', '--format=%h %s']) : '';
     const dirty = git(root, ['status', '--porcelain']).split('\n').filter((l) => l && !/\s\.lemma(\/|$)/.test(l));
     lines.push(`GIT${branch ? ` (${branch})` : ''}: ${commits ? `commits this session: ${commits.split('\n').join('; ')}` : 'no commits this session'}; ${dirty.length} uncommitted file(s)${dirty.length ? `: ${dirty.slice(0, MAX_HANDOFF_FILES).map((l) => l.slice(3)).join(', ')}` : ''}`);
-    const v = digest.lastVerdict;
-    if (v)
-        lines.push(`LAST TEST/BUILD RUN: \`${clip(v.command, 100)}\` ${v.passed ? 'passed' : `FAILED${v.headline ? ` — ${clip(v.headline, 160)}` : ''}`}`);
+    const ran = (v) => `\`${clip(v.command, 100)}\` ${v.passed ? 'passed' : `FAILED${v.headline ? ` — ${clip(v.headline, 160)}` : ''}`}`;
+    const last = latestVerdict(digest);
+    if (last)
+        lines.push(`LAST TEST/BUILD RUN${last.by ? ` (by subagent ${subagentName(last.by)})` : ''}: ${ran(last.verdict)}`);
+    const subs = digest.subagents ?? [];
+    const worked = subs.filter((s) => s.edited.length > 0 || s.lastVerdict);
+    if (worked.length) {
+        lines.push('', `SUBAGENTS (${subs.length} ran, ${subs.filter((s) => s.edited.length > 0).length} edited code):`);
+        for (const s of worked.slice(0, MAX_SUBAGENT_LINES)) {
+            const parts = [
+                ...(s.edited.length ? [`edited ${s.edited.slice(0, MAX_FILES).map(rel).join(', ')}${s.edited.length > MAX_FILES ? ', …' : ''}`] : []),
+                ...(s.lastVerdict ? [`last run ${ran(s.lastVerdict)}`] : []),
+            ];
+            lines.push(`- ${subagentName(s)}: ${parts.join('; ')}`);
+        }
+        if (worked.length > MAX_SUBAGENT_LINES)
+            lines.push(`- …and ${worked.length - MAX_SUBAGENT_LINES} more`);
+    }
     if (digest.answer)
         lines.push('', 'LAST SAID BY THE AGENT:', clip(digest.answer, MAX_SAID_CHARS));
     return lines.join('\n');
@@ -294,10 +439,11 @@ function captureSession(payload, cwd, brain, opts = {}) {
     // PreCompact runs mid-session and again at SessionEnd: it must neither be stopped by nor leave the "captured" mark.
     if (!opts.preCompact && sessionId && seen(root).includes(sessionId))
         return { skipped: 'already-captured' };
-    const digest = digestTranscript(p.transcript_path);
+    const digest = digestTranscript(p.transcript_path, { subagents: true });
     if (!digest)
         return { skipped: 'no-transcript' };
-    const handoff = digest.edited.length > 0;
+    const edited = allEdited(digest);
+    const handoff = edited.length > 0;
     if (opts.preCompact && !handoff)
         return { skipped: 'no-edits' }; // only a hand-off is worth re-injecting
     // The closing answer is skipped when the agent wrote its own memory, but the hand-off is not:
@@ -306,7 +452,9 @@ function captureSession(payload, cwd, brain, opts = {}) {
     // task verbatim. Both live side by side: the note is the agent's reading, this is the source.
     if (digest.storedOwnMemory && !handoff)
         return { skipped: 'agent-stored' };
-    if (digest.toolCalls < MIN_TOOL_CALLS)
+    // An orchestrator's own calls are few (it delegates); its subagents' calls are the session's work too.
+    const toolCalls = digest.toolCalls + (digest.subagents ?? []).reduce((n, s) => n + s.toolCalls, 0);
+    if (toolCalls < MIN_TOOL_CALLS)
         return { skipped: 'small-session' };
     if (!digest.prompt)
         return { skipped: 'no-answer' };
@@ -314,10 +462,10 @@ function captureSession(payload, cwd, brain, opts = {}) {
     if (!handoff && digest.answer.length < MIN_ANSWER_CHARS)
         return { skipped: 'no-answer' };
     const inRoot = (f) => {
-        const abs = path_1.default.resolve(root, f);
+        const abs = realPath(root, f);
         return abs.startsWith(root + path_1.default.sep) && fs_1.default.existsSync(abs) ? abs : null;
     };
-    const tracked = (digest.edited.length > 0 ? digest.edited : digest.read)
+    const tracked = (edited.length > 0 ? edited : digest.read)
         .map(inRoot)
         .filter((f) => !!f)
         .slice(0, MAX_FILES);