agenthub-multiagent-mcp 1.14.1 → 1.15.1

package/dist/brain/journal.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Session Journal — crash-safe, fire-and-forget event log for real-time
+ * session durability without polluting the sealed `.mv2` brain.
+ *
+ * Location: `~/.claude/brains/journal/<sanitized-agent-id>.jsonl`
+ *
+ * Design goals:
+ *   1. **Zero LLM token cost** — filesystem-only, no network per event.
+ *   2. **Zero measurable perf impact** — async `appendFile`, fire-and-forget,
+ *      never awaited by the hot path. ~50–200μs per write on SSDs.
+ *   3. **Bounded power-cut loss** — no explicit fsync (fsync would add 2–10ms
+ *      per event). Worst-case loss is OS write-buffer depth, typically <5s on
+ *      Windows NTFS. Accept that; `.mv2` summary at session close is the
+ *      durable record.
+ *   4. **Clean `.mv2`** — journals are summarized into a single `.mv2` frame
+ *      on session end. `.mv2` BM25 search quality stays high.
+ *   5. **Recoverable** — if Claude Code crashes or power dies mid-session, the
+ *      JSONL survives (up to the OS flush boundary). On next startup we
+ *      summarize it into `.mv2` and archive.
+ *
+ * Event schema:
+ *   { "t": "2026-04-23T...", "e": "tool", "n": "save_decision",
+ *     "s": "ok", "p": { ...truncated args... } }
+ */
+export interface JournalEvent {
+    t: string;
+    e: "tool" | "session_start" | "session_end" | "error";
+    n?: string;
+    s?: "ok" | "err";
+    p?: unknown;
+}
+export declare function getJournalPath(agentId: string): string;
+/**
+ * Is this tool call worth journaling? Keep the allowlist in sync with the
+ * set of tools that represent real work worth recovering on crash.
+ */
+export declare function shouldJournal(toolName: string): boolean;
+/**
+ * Fire-and-forget append. Never throws, never awaits on the hot path.
+ * Returns void synchronously; I/O runs on the event-loop tail, serialized
+ * per-path to avoid Windows file-sharing violations.
+ */
+export declare function logEvent(agentId: string, event: JournalEvent): void;
+/**
+ * Test helper: await all pending writes for an agent. Not used in production.
+ * Exported so unit tests can assert against fully-flushed state without polling.
+ */
+export declare function flushPending(agentId: string): Promise<void>;
+/**
+ * Test helper: reset internal state. Not used in production.
+ */
+export declare function _resetForTest(): void;
+/** Convenience: log a tool call event. */
+export declare function logTool(agentId: string, toolName: string, args: unknown, ok: boolean): void;
+/** Returns true if a journal file exists for this agent. */
+export declare function hasJournal(agentId: string): Promise<boolean>;
+/** Read all events from the journal. Returns [] if missing/corrupt. */
+export declare function readEvents(agentId: string): Promise<JournalEvent[]>;
+/**
+ * Rename the journal to an archived path so a fresh session starts clean.
+ * Returns the archive path, or null if no journal existed.
+ */
+export declare function archive(agentId: string): Promise<string | null>;
+/**
+ * List agents that have an active (non-archived) journal file. Used on
+ * startup to recover journals from crashed prior sessions.
+ */
+export declare function listAgentsWithJournal(): string[];
+/**
+ * Summarize a list of journal events into a single text block suitable for
+ * a `.mv2` frame body. Deterministic ordering, compact format.
+ */
+export declare function summarizeEvents(events: JournalEvent[]): {
+    summary: string;
+    content: string;
+};
+//# sourceMappingURL=journal.d.ts.map

package/dist/brain/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/brain/journal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA6CH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;IACtD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IACjB,CAAC,CAAC,EAAE,OAAO,CAAC;CACb;AAUD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAsBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAWD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAkBnE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,0CAA0C;AAC1C,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,OAAO,GACV,IAAI,CASN;AAED,4DAA4D;AAC5D,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlE;AAED,uEAAuE;AACvE,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAmBzE;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBrE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAUhD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CA+BA"}

package/dist/brain/journal.js

@@ -0,0 +1,276 @@
+/**
+ * Session Journal — crash-safe, fire-and-forget event log for real-time
+ * session durability without polluting the sealed `.mv2` brain.
+ *
+ * Location: `~/.claude/brains/journal/<sanitized-agent-id>.jsonl`
+ *
+ * Design goals:
+ *   1. **Zero LLM token cost** — filesystem-only, no network per event.
+ *   2. **Zero measurable perf impact** — async `appendFile`, fire-and-forget,
+ *      never awaited by the hot path. ~50–200μs per write on SSDs.
+ *   3. **Bounded power-cut loss** — no explicit fsync (fsync would add 2–10ms
+ *      per event). Worst-case loss is OS write-buffer depth, typically <5s on
+ *      Windows NTFS. Accept that; `.mv2` summary at session close is the
+ *      durable record.
+ *   4. **Clean `.mv2`** — journals are summarized into a single `.mv2` frame
+ *      on session end. `.mv2` BM25 search quality stays high.
+ *   5. **Recoverable** — if Claude Code crashes or power dies mid-session, the
+ *      JSONL survives (up to the OS flush boundary). On next startup we
+ *      summarize it into `.mv2` and archive.
+ *
+ * Event schema:
+ *   { "t": "2026-04-23T...", "e": "tool", "n": "save_decision",
+ *     "s": "ok", "p": { ...truncated args... } }
+ */
+import { appendFile, mkdir, readFile, rename, stat, unlink } from "fs/promises";
+import { existsSync, readdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+const JOURNAL_DIR_NAME = "journal";
+const MAX_PAYLOAD_CHARS = 500;
+/**
+ * Tools worth journaling. Everything else (heartbeats, reads, list/get,
+ * searches) is pure noise and is skipped to keep journals tight.
+ */
+const JOURNALED_TOOLS = new Set([
+    "save_decision",
+    "save_note",
+    "save_codebase_insight",
+    "save_blocker",
+    "clear_blocker",
+    "agent_start_work",
+    "agent_complete_task",
+    "agent_report_blocked",
+    "agent_report_failure",
+    "accept_task",
+    "decline_task",
+    "claim_ticket_task",
+    "create_task",
+    "update_ticket",
+    "add_comment",
+    "submit_plan",
+    "submit_code_review",
+    "reach_checkpoint",
+    "send_message",
+    "broadcast",
+    "send_to_channel",
+    "reply",
+    "brain_write_knowledge",
+    "openspec_publish",
+    "create_epic",
+    "create_story",
+    "sync_context",
+    "session_close_report",
+]);
+function sanitizeAgentId(agentId) {
+    return agentId.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+function getJournalDir() {
+    return join(homedir(), ".claude", "brains", JOURNAL_DIR_NAME);
+}
+export function getJournalPath(agentId) {
+    return join(getJournalDir(), `${sanitizeAgentId(agentId)}.jsonl`);
+}
+async function ensureJournalDir() {
+    await mkdir(getJournalDir(), { recursive: true });
+}
+/**
+ * Truncate an arbitrary JS value to a compact JSON-safe payload.
+ * Keeps the journal bounded per event — an accidental 10MB `content` field
+ * won't balloon the file.
+ */
+function truncatePayload(payload) {
+    if (payload === undefined || payload === null)
+        return payload;
+    try {
+        const json = JSON.stringify(payload);
+        if (json.length <= MAX_PAYLOAD_CHARS)
+            return payload;
+        return { _truncated: true, preview: json.slice(0, MAX_PAYLOAD_CHARS) };
+    }
+    catch {
+        return { _truncated: true, preview: String(payload).slice(0, MAX_PAYLOAD_CHARS) };
+    }
+}
+/**
+ * Is this tool call worth journaling? Keep the allowlist in sync with the
+ * set of tools that represent real work worth recovering on crash.
+ */
+export function shouldJournal(toolName) {
+    return JOURNALED_TOOLS.has(toolName);
+}
+/**
+ * Per-path serialized write queue. Multiple concurrent appendFile calls against
+ * the same path on Windows can trip EBUSY / ERROR_SHARING_VIOLATION because
+ * each call opens its own handle. Chaining via a per-path promise serializes
+ * writes without blocking the caller — the caller still returns synchronously.
+ */
+const writeQueues = new Map();
+let dirEnsured = false;
+/**
+ * Fire-and-forget append. Never throws, never awaits on the hot path.
+ * Returns void synchronously; I/O runs on the event-loop tail, serialized
+ * per-path to avoid Windows file-sharing violations.
+ */
+export function logEvent(agentId, event) {
+    if (!agentId)
+        return;
+    const path = getJournalPath(agentId);
+    const line = JSON.stringify(event) + "\n";
+    const prev = writeQueues.get(path) ?? Promise.resolve();
+    const next = prev
+        .then(async () => {
+        if (!dirEnsured) {
+            await ensureJournalDir();
+            dirEnsured = true;
+        }
+        await appendFile(path, line, { encoding: "utf8" });
+    })
+        .catch(() => {
+        // Best-effort. Journal is a crash-safety net, not a correctness dependency.
+    });
+    writeQueues.set(path, next);
+}
+/**
+ * Test helper: await all pending writes for an agent. Not used in production.
+ * Exported so unit tests can assert against fully-flushed state without polling.
+ */
+export async function flushPending(agentId) {
+    const path = getJournalPath(agentId);
+    const pending = writeQueues.get(path);
+    if (pending)
+        await pending;
+}
+/**
+ * Test helper: reset internal state. Not used in production.
+ */
+export function _resetForTest() {
+    writeQueues.clear();
+    dirEnsured = false;
+}
+/** Convenience: log a tool call event. */
+export function logTool(agentId, toolName, args, ok) {
+    if (!shouldJournal(toolName))
+        return;
+    logEvent(agentId, {
+        t: new Date().toISOString(),
+        e: "tool",
+        n: toolName,
+        s: ok ? "ok" : "err",
+        p: truncatePayload(args),
+    });
+}
+/** Returns true if a journal file exists for this agent. */
+export async function hasJournal(agentId) {
+    try {
+        await stat(getJournalPath(agentId));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Read all events from the journal. Returns [] if missing/corrupt. */
+export async function readEvents(agentId) {
+    const path = getJournalPath(agentId);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const events = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            events.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Skip malformed lines (e.g. a torn write at the tail from a power cut).
+        }
+    }
+    return events;
+}
+/**
+ * Rename the journal to an archived path so a fresh session starts clean.
+ * Returns the archive path, or null if no journal existed.
+ */
+export async function archive(agentId) {
+    const path = getJournalPath(agentId);
+    if (!existsSync(path))
+        return null;
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const dest = `${path}.archived.${stamp}`;
+    try {
+        await rename(path, dest);
+        return dest;
+    }
+    catch {
+        // If rename fails (e.g. locked on Windows), fall back to delete.
+        try {
+            await unlink(path);
+        }
+        catch {
+            // Swallow — worst case, next session re-summarizes the same content (idempotent enough).
+        }
+        return null;
+    }
+}
+/**
+ * List agents that have an active (non-archived) journal file. Used on
+ * startup to recover journals from crashed prior sessions.
+ */
+export function listAgentsWithJournal() {
+    const dir = getJournalDir();
+    if (!existsSync(dir))
+        return [];
+    const result = [];
+    for (const file of readdirSync(dir)) {
+        if (!file.endsWith(".jsonl"))
+            continue;
+        if (file.includes(".archived."))
+            continue;
+        result.push(file.slice(0, -".jsonl".length));
+    }
+    return result;
+}
+/**
+ * Summarize a list of journal events into a single text block suitable for
+ * a `.mv2` frame body. Deterministic ordering, compact format.
+ */
+export function summarizeEvents(events) {
+    if (events.length === 0) {
+        return { summary: "empty journal", content: "" };
+    }
+    const counts = new Map();
+    for (const ev of events) {
+        if (ev.e !== "tool" || !ev.n)
+            continue;
+        counts.set(ev.n, (counts.get(ev.n) ?? 0) + 1);
+    }
+    const topTools = [...counts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .map(([n, c]) => `${n}×${c}`)
+        .join(", ");
+    const first = events[0];
+    const last = events[events.length - 1];
+    const summary = `journal: ${events.length} events — ${topTools}`;
+    const content = [
+        `start=${first.t}`,
+        `end=${last.t}`,
+        `events=${events.length}`,
+        `tools=${topTools}`,
+        "",
+        ...events.map((ev) => {
+            const base = `${ev.t} ${ev.e}${ev.n ? " " + ev.n : ""}${ev.s ? " " + ev.s : ""}`;
+            const payload = ev.p !== undefined ? " " + JSON.stringify(ev.p) : "";
+            return base + payload;
+        }),
+    ].join("\n");
+    return { summary, content };
+}
+//# sourceMappingURL=journal.js.map

package/dist/brain/journal.js.map

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

package/dist/brain/journal.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for the crash-safe session journal.
+ */
+export {};
+//# sourceMappingURL=journal.test.d.ts.map

package/dist/brain/journal.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.test.d.ts","sourceRoot":"","sources":["../../src/brain/journal.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/brain/journal.test.js

@@ -0,0 +1,151 @@
+/**
+ * Unit tests for the crash-safe session journal.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+let tempHome;
+vi.mock("os", async () => {
+    const actual = await vi.importActual("os");
+    return {
+        ...actual,
+        homedir: () => process.env.__TEST_HOME__ ?? actual.homedir(),
+    };
+});
+async function importJournal() {
+    return await import("./journal.js");
+}
+describe("journal", () => {
+    beforeEach(async () => {
+        tempHome = mkdtempSync(join(tmpdir(), "journal-test-"));
+        process.env.__TEST_HOME__ = tempHome;
+        vi.resetModules();
+        const j = await importJournal();
+        j._resetForTest();
+    });
+    afterEach(() => {
+        rmSync(tempHome, { recursive: true, force: true });
+        delete process.env.__TEST_HOME__;
+    });
+    it("shouldJournal accepts allowlisted tools and rejects noise", async () => {
+        const j = await importJournal();
+        expect(j.shouldJournal("save_decision")).toBe(true);
+        expect(j.shouldJournal("agent_complete_task")).toBe(true);
+        expect(j.shouldJournal("heartbeat")).toBe(false);
+        expect(j.shouldJournal("check_inbox")).toBe(false);
+        expect(j.shouldJournal("list_agents")).toBe(false);
+        expect(j.shouldJournal("brain_search")).toBe(false);
+    });
+    it("logTool writes a JSONL line to the journal file", async () => {
+        const j = await importJournal();
+        j.logTool("agent-x", "save_decision", { what: "use bun", why: "speed" }, true);
+        // Fire-and-forget — give the event loop a tick to flush.
+        await j.flushPending("agent-x");
+        const path = j.getJournalPath("agent-x");
+        expect(existsSync(path)).toBe(true);
+        const raw = readFileSync(path, "utf8").trim();
+        const parsed = JSON.parse(raw);
+        expect(parsed.e).toBe("tool");
+        expect(parsed.n).toBe("save_decision");
+        expect(parsed.s).toBe("ok");
+        expect(parsed.p).toEqual({ what: "use bun", why: "speed" });
+        expect(typeof parsed.t).toBe("string");
+    });
+    it("logTool skips non-allowlisted tools silently", async () => {
+        const j = await importJournal();
+        j.logTool("agent-x", "heartbeat", {}, true);
+        await j.flushPending("agent-x");
+        expect(await j.hasJournal("agent-x")).toBe(false);
+    });
+    it("logTool truncates oversized payloads", async () => {
+        const j = await importJournal();
+        const huge = "x".repeat(5000);
+        j.logTool("agent-x", "save_note", { body: huge }, true);
+        await j.flushPending("agent-x");
+        const events = await j.readEvents("agent-x");
+        expect(events).toHaveLength(1);
+        const payload = events[0].p;
+        expect(payload._truncated).toBe(true);
+        expect(payload.preview.length).toBeLessThanOrEqual(500);
+    });
+    it("readEvents tolerates torn final line from a power-cut scenario", async () => {
+        const j = await importJournal();
+        const dir = join(tempHome, ".claude", "brains", "journal");
+        mkdirSync(dir, { recursive: true });
+        const path = j.getJournalPath("agent-x");
+        const good = JSON.stringify({ t: "2026-04-23T00:00:00Z", e: "tool", n: "save_decision", s: "ok" });
+        // Second line is truncated mid-JSON — simulates a power-cut append.
+        writeFileSync(path, good + "\n" + '{"t":"2026-04-23T00:00:01Z","e":"tool","n":"save_no', "utf8");
+        const events = await j.readEvents("agent-x");
+        expect(events).toHaveLength(1);
+        expect(events[0].n).toBe("save_decision");
+    });
+    it("archive renames the journal so the next session starts clean", async () => {
+        const j = await importJournal();
+        j.logTool("agent-x", "save_decision", { a: 1 }, true);
+        await j.flushPending("agent-x");
+        expect(await j.hasJournal("agent-x")).toBe(true);
+        const dest = await j.archive("agent-x");
+        expect(dest).not.toBeNull();
+        expect(existsSync(dest)).toBe(true);
+        expect(await j.hasJournal("agent-x")).toBe(false);
+    });
+    it("listAgentsWithJournal returns active journals and excludes archives", async () => {
+        const j = await importJournal();
+        j.logTool("agent-a", "save_decision", {}, true);
+        j.logTool("agent-b", "save_note", {}, true);
+        await j.flushPending("agent-a");
+        await j.flushPending("agent-b");
+        await j.archive("agent-b");
+        const active = j.listAgentsWithJournal();
+        expect(active).toContain("agent-a");
+        expect(active).not.toContain("agent-b");
+    });
+    it("summarizeEvents produces counts and deterministic content", async () => {
+        const j = await importJournal();
+        const events = [
+            { t: "2026-04-23T00:00:00Z", e: "tool", n: "save_decision", s: "ok" },
+            { t: "2026-04-23T00:00:01Z", e: "tool", n: "save_decision", s: "ok" },
+            { t: "2026-04-23T00:00:02Z", e: "tool", n: "save_note", s: "ok" },
+        ];
+        const { summary, content } = j.summarizeEvents(events);
+        expect(summary).toContain("3 events");
+        expect(summary).toContain("save_decision×2");
+        expect(summary).toContain("save_note×1");
+        expect(content).toContain("start=2026-04-23T00:00:00Z");
+        expect(content).toContain("end=2026-04-23T00:00:02Z");
+        expect(content).toContain("events=3");
+    });
+    it("summarizeEvents handles empty input without throwing", async () => {
+        const j = await importJournal();
+        const { summary, content } = j.summarizeEvents([]);
+        expect(summary).toBe("empty journal");
+        expect(content).toBe("");
+    });
+    it("serializes 5000 concurrent appends without dropping events (Windows sharing-violation regression)", async () => {
+        const j = await importJournal();
+        const N = 5000;
+        const start = Date.now();
+        for (let i = 0; i < N; i++) {
+            j.logTool("stress-agent", "save_decision", { i }, true);
+        }
+        const syncMs = Date.now() - start;
+        await j.flushPending("stress-agent");
+        const events = await j.readEvents("stress-agent");
+        expect(events).toHaveLength(N);
+        // Synchronous call cost must stay negligible. 5000 × <0.5ms = <2.5s.
+        expect(syncMs).toBeLessThan(2500);
+    }, 30_000);
+    it("sanitizes agent ids with unsafe characters in the filename", async () => {
+        const j = await importJournal();
+        j.logTool("agent/../../etc/passwd", "save_decision", {}, true);
+        await j.flushPending("agent/../../etc/passwd");
+        const dir = join(tempHome, ".claude", "brains", "journal");
+        const files = readdirSync(dir);
+        expect(files).toHaveLength(1);
+        expect(files[0]).not.toContain("/");
+        expect(files[0]).not.toContain("..");
+    });
+});
+//# sourceMappingURL=journal.test.js.map

package/dist/brain/journal.test.js.map

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

package/dist/hooks/brainCapture.d.ts

@@ -30,10 +30,37 @@ interface BrainCaptureData {
  */
 export declare function captureOnTaskComplete(client: ApiClient, data: BrainCaptureData): Promise<void>;
 /**
- * Capture a brain session summary on disconnect.
- * Called from the agent_disconnect handler.
+ * Flush the current session to both the org brain (server-side `brain_sessions`
+ * row) and the local `.mv2` file. Does NOT delete the agent from the registry.
+ *
+ * Safe to call from process-exit signal handlers (SIGINT/SIGTERM) — the agent
+ * stays registered so the next Claude Code start can reconnect to the same
+ * agent_id. Idempotent; calling twice in quick succession produces two session
+ * rows but that's acceptable (cheap, no data loss).
+ */
+export declare function flushSessionToBrain(client: ApiClient, agentId: string, project?: string): Promise<void>;
+/**
+ * Capture a brain session summary on explicit agent_disconnect.
+ * Thin wrapper over flushSessionToBrain — the tool handler performs the
+ * actual registry delete separately.
  */
 export declare function captureOnDisconnect(client: ApiClient, agentId: string, project?: string): Promise<void>;
+/**
+ * Recover journals left behind by crashed/power-cut sessions. For each orphaned
+ * journal file under `~/.claude/brains/journal/`, summarize the events into a
+ * single `.mv2` frame and archive the journal.
+ *
+ * Called on MCP server startup (before the new agent's session starts), so the
+ * prior session's work makes it into the searchable brain even if the previous
+ * process never got a chance to run its shutdown handler.
+ *
+ * Skips `excludeAgentId` (the currently-registering agent) when provided — its
+ * own journal will be summarized at session close, not at startup.
+ */
+export declare function recoverOrphanedJournals(excludeAgentId?: string): Promise<{
+    recovered: number;
+    failed: number;
+}>;
 /**
  * Extract decisions from the local context store.
  * Reads the decisions saved via save_decision tool during this session.

package/dist/hooks/brainCapture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brainCapture.d.ts","sourceRoot":"","sources":["../../src/hooks/brainCapture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9C,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CA6Ff;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GACd,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAUtC"}
+{"version":3,"file":"brainCapture.d.ts","sourceRoot":"","sources":["../../src/hooks/brainCapture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CA6Ff;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAyEf;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BhD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GACd,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAUtC"}