agenthub-multiagent-mcp 1.12.0 → 1.13.0

package/dist/brain/backend.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Brain backend selector (§1.3 finish-agenthub-v1-backlog).
+ *
+ * `AGENTHUB_BRAIN_BACKEND=memvid` (default) → MemvidBrain (.mv2 files)
+ * `AGENTHUB_BRAIN_BACKEND=jsonl`             → JsonlBrain (legacy .jsonl files)
+ *
+ * The selector is lazy + cached so tests can flip the env var before first use.
+ */
+import type { BrainBackend } from "./types.js";
+export declare function getBrain(): BrainBackend;
+export declare function resetBrainBackendCache(): void;
+//# sourceMappingURL=backend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/brain/backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO/C,wBAAgB,QAAQ,IAAI,YAAY,CAevC;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C"}

package/dist/brain/backend.js

@@ -0,0 +1,33 @@
+/**
+ * Brain backend selector (§1.3 finish-agenthub-v1-backlog).
+ *
+ * `AGENTHUB_BRAIN_BACKEND=memvid` (default) → MemvidBrain (.mv2 files)
+ * `AGENTHUB_BRAIN_BACKEND=jsonl`             → JsonlBrain (legacy .jsonl files)
+ *
+ * The selector is lazy + cached so tests can flip the env var before first use.
+ */
+import { memvidBrain } from "./memvidBrain.js";
+import { jsonlBrain } from "./jsonlBrain.js";
+let cached = null;
+let cachedBackendName = null;
+export function getBrain() {
+    const requested = (process.env.AGENTHUB_BRAIN_BACKEND ?? "memvid").toLowerCase();
+    if (cached && cachedBackendName === requested)
+        return cached;
+    switch (requested) {
+        case "jsonl":
+            cached = jsonlBrain;
+            break;
+        case "memvid":
+        default:
+            cached = memvidBrain;
+            break;
+    }
+    cachedBackendName = requested;
+    return cached;
+}
+export function resetBrainBackendCache() {
+    cached = null;
+    cachedBackendName = null;
+}
+//# sourceMappingURL=backend.js.map

package/dist/brain/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/brain/backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,IAAI,MAAM,GAAwB,IAAI,CAAC;AACvC,IAAI,iBAAiB,GAAkB,IAAI,CAAC;AAE5C,MAAM,UAAU,QAAQ;IACtB,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjF,IAAI,MAAM,IAAI,iBAAiB,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAE7D,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,OAAO;YACV,MAAM,GAAG,UAAU,CAAC;YACpB,MAAM;QACR,KAAK,QAAQ,CAAC;QACd;YACE,MAAM,GAAG,WAAW,CAAC;YACrB,MAAM;IACV,CAAC;IACD,iBAAiB,GAAG,SAAS,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,IAAI,CAAC;IACd,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC"}

package/dist/brain/jsonlBrain.d.ts

@@ -0,0 +1,17 @@
+/**
+ * JSONL Brain — BrainBackend adapter over the existing localBrain.ts functions.
+ *
+ * Preserved as the fallback when AGENTHUB_BRAIN_BACKEND=jsonl, and as a
+ * disaster-recovery path if memvid proves unstable on a given platform.
+ */
+import type { BrainBackend, SessionInput, SessionRecord, SearchHit, BrainInfo } from "./types.js";
+export declare class JsonlBrain implements BrainBackend {
+    getBrainPath(agentId: string): string;
+    appendSession(agentId: string, session: SessionInput): Promise<number>;
+    search(agentId: string, query: string, limit?: number): Promise<SearchHit[]>;
+    recall(agentId: string, sessionNumber: number): Promise<SessionRecord | null>;
+    getSessionCount(agentId: string): Promise<number>;
+    listBrains(): Promise<BrainInfo[]>;
+}
+export declare const jsonlBrain: JsonlBrain;
+//# sourceMappingURL=jsonlBrain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsonlBrain.d.ts","sourceRoot":"","sources":["../../src/brain/jsonlBrain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAElG,qBAAa,UAAW,YAAW,YAAY;IAC7C,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAa/B,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAUtE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAIvE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAc7E,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjD,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;CAGzC;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/brain/jsonlBrain.js

@@ -0,0 +1,50 @@
+/**
+ * JSONL Brain — BrainBackend adapter over the existing localBrain.ts functions.
+ *
+ * Preserved as the fallback when AGENTHUB_BRAIN_BACKEND=jsonl, and as a
+ * disaster-recovery path if memvid proves unstable on a given platform.
+ */
+import * as localBrain from "./localBrain.js";
+export class JsonlBrain {
+    getBrainPath(agentId) {
+        // localBrain has a private getBrainPath; recover it via listBrains if needed.
+        // For now, we do not publicly expose localBrain's path helper; return a best-effort path.
+        const entry = localBrain.listBrains().find((b) => b.agentId === agentId);
+        if (entry)
+            return entry.path;
+        // Fallback: mirror localBrain's sanitization for callers like the migration
+        // script that need a target path before any session exists.
+        const safe = agentId.replace(/[^a-zA-Z0-9_-]/g, "_");
+        const { join } = require("path");
+        const { homedir } = require("os");
+        return join(homedir(), ".claude", "brains", `${safe}.jsonl`);
+    }
+    async appendSession(agentId, session) {
+        return localBrain.appendSession(agentId, session.summary, session.content, session.files_changed, session.outcome);
+    }
+    async search(agentId, query, limit = 5) {
+        return localBrain.search(agentId, query, limit);
+    }
+    async recall(agentId, sessionNumber) {
+        const entry = localBrain.recall(agentId, sessionNumber);
+        if (!entry)
+            return null;
+        return {
+            session_number: entry.session_number,
+            agent_id: entry.agent_id,
+            timestamp: entry.timestamp,
+            summary: entry.summary,
+            content: entry.content,
+            files_changed: entry.files_changed,
+            outcome: entry.outcome,
+        };
+    }
+    async getSessionCount(agentId) {
+        return localBrain.getSessionCount(agentId);
+    }
+    async listBrains() {
+        return localBrain.listBrains();
+    }
+}
+export const jsonlBrain = new JsonlBrain();
+//# sourceMappingURL=jsonlBrain.js.map

package/dist/brain/jsonlBrain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonlBrain.js","sourceRoot":"","sources":["../../src/brain/jsonlBrain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAG9C,MAAM,OAAO,UAAU;IACrB,YAAY,CAAC,OAAe;QAC1B,8EAA8E;QAC9E,0FAA0F;QAC1F,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;QACzE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC;QAC7B,4EAA4E;QAC5E,4DAA4D;QAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACrD,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,OAAqB;QACxD,OAAO,UAAU,CAAC,aAAa,CAC7B,OAAO,EACP,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,OAAO,CAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,KAAa,EAAE,KAAK,GAAG,CAAC;QACpD,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,aAAqB;QACjD,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO;YACL,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAe;QACnC,OAAO,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC"}

package/dist/brain/memvidBrain.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Memvid Brain — .mv2-backed per-agent session store (§1.2 finish-agenthub-v1-backlog).
+ *
+ * Storage: ~/.claude/brains/<agent-id>.mv2
+ *
+ * Encoding conventions (session_number must survive a round-trip through memvid's
+ * document model, which stores metadata as inline "key: value" text lines):
+ *   - title:    `[session <N>] <summary>`      — N is extractable via regex
+ *   - text:     full session content           — indexed by BM25
+ *   - metadata: { session_number, agent_id, timestamp, files_changed (JSON), outcome, summary }
+ *     Memvid serializes each metadata field as a "key: value" line appended to the
+ *     document's searchable body, so they round-trip through find().text.
+ *
+ * Search is lexical (BM25) by default — works everywhere including Windows.
+ * Semantic search is opt-in via AGENTHUB_BRAIN_EMBEDDINGS=openai|openrouter and the
+ * usual OpenAI-compatible env vars. Not wired in this file yet (future phase).
+ */
+import type { BrainBackend, SessionInput, SessionRecord, SearchHit, BrainInfo } from "./types.js";
+export declare class MemvidBrain implements BrainBackend {
+    getBrainPath(agentId: string): string;
+    appendSession(agentId: string, session: SessionInput): Promise<number>;
+    search(agentId: string, query: string, limit?: number): Promise<SearchHit[]>;
+    recall(agentId: string, sessionNumber: number): Promise<SessionRecord | null>;
+    getSessionCount(agentId: string): Promise<number>;
+    listBrains(): Promise<BrainInfo[]>;
+}
+export declare const memvidBrain: MemvidBrain;
+//# sourceMappingURL=memvidBrain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memvidBrain.d.ts","sourceRoot":"","sources":["../../src/brain/memvidBrain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAmJlG,qBAAa,WAAY,YAAW,YAAY;IAC9C,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI/B,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BtE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA0BvE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAmB7E,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAYjD,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;CAwBzC;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/brain/memvidBrain.js

@@ -0,0 +1,281 @@
+/**
+ * Memvid Brain — .mv2-backed per-agent session store (§1.2 finish-agenthub-v1-backlog).
+ *
+ * Storage: ~/.claude/brains/<agent-id>.mv2
+ *
+ * Encoding conventions (session_number must survive a round-trip through memvid's
+ * document model, which stores metadata as inline "key: value" text lines):
+ *   - title:    `[session <N>] <summary>`      — N is extractable via regex
+ *   - text:     full session content           — indexed by BM25
+ *   - metadata: { session_number, agent_id, timestamp, files_changed (JSON), outcome, summary }
+ *     Memvid serializes each metadata field as a "key: value" line appended to the
+ *     document's searchable body, so they round-trip through find().text.
+ *
+ * Search is lexical (BM25) by default — works everywhere including Windows.
+ * Semantic search is opt-in via AGENTHUB_BRAIN_EMBEDDINGS=openai|openrouter and the
+ * usual OpenAI-compatible env vars. Not wired in this file yet (future phase).
+ */
+import { use } from "@memvid/sdk";
+import { existsSync, mkdirSync, readdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+const BRAIN_DIR_NAME = "brains";
+const SESSION_TITLE_RE = /^\[session\s+(\d+)\]\s*(.*)$/i;
+function getBrainsDir() {
+    return join(homedir(), ".claude", BRAIN_DIR_NAME);
+}
+function sanitizeAgentId(agentId) {
+    return agentId.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+function ensureBrainsDir() {
+    const dir = getBrainsDir();
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+}
+function getBrainPath(agentId) {
+    return join(getBrainsDir(), `${sanitizeAgentId(agentId)}.mv2`);
+}
+async function openForWrite(path) {
+    return use("basic", path, { mode: "auto" });
+}
+async function openForRead(path) {
+    if (!existsSync(path))
+        return null;
+    return use("basic", path, { mode: "open", readOnly: true });
+}
+/**
+ * Memvid treats `seal()` on a readOnly handle as a mutation and throws.
+ * We still need to release the file handle, but there is no dedicated close()
+ * for readOnly handles. Relying on GC is acceptable — the N-API layer releases
+ * the Rust resources when the JS wrapper is collected.
+ */
+async function closeRead(_mv) {
+    // no-op; see comment above
+}
+/**
+ * Parse `[session N] summary` title. Returns null if the title doesn't match.
+ */
+function parseTitle(title) {
+    if (!title)
+        return null;
+    const m = SESSION_TITLE_RE.exec(title.trim());
+    if (!m)
+        return null;
+    return { sessionNumber: Number(m[1]), summary: m[2] ?? "" };
+}
+/**
+ * Extract a metadata value from memvid's serialized hit text.
+ *
+ * Memvid appends metadata as `key: <JSON-encoded-value>` tokens to the document
+ * body, whitespace-separated (no newlines). Each value is a JSON string/array/
+ * object/number/bool/null.
+ *
+ * Returns the decoded JS value (string, array, etc.) or null if not present.
+ */
+function extractMetaValue(text, key) {
+    if (!text)
+        return null;
+    // Match `<whitespace or start><key>:<space>` then capture a JSON value.
+    // JSON values are: "..." | [...] | {...} | number | true/false/null | unquoted word.
+    const re = new RegExp(`(?:^|\\s)${key}:\\s*("(?:[^"\\\\]|\\\\.)*"|\\[[^\\]]*\\]|\\{[^}]*\\}|-?\\d+(?:\\.\\d+)?|true|false|null|[^\\s]+)`);
+    const m = re.exec(text);
+    if (!m)
+        return null;
+    const raw = m[1];
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+function extractMetaString(text, key) {
+    const v = extractMetaValue(text, key);
+    return typeof v === "string" ? v : v != null ? String(v) : null;
+}
+function extractMetaStringArray(text, key) {
+    const v = extractMetaValue(text, key);
+    return Array.isArray(v) ? v.map(String) : undefined;
+}
+function hitToRecord(agentId, hit) {
+    const parsed = parseTitle(hit?.title);
+    if (!parsed)
+        return null;
+    const text = hit?.text ?? "";
+    const timestamp = extractMetaString(text, "timestamp") ?? new Date().toISOString();
+    const outcomeRaw = extractMetaString(text, "outcome");
+    const outcome = outcomeRaw && outcomeRaw.length > 0 ? outcomeRaw : undefined;
+    const filesChanged = extractMetaStringArray(text, "files_changed");
+    const content = stripMetadataTokens(text);
+    return {
+        session_number: parsed.sessionNumber,
+        agent_id: agentId,
+        timestamp,
+        summary: parsed.summary,
+        content,
+        files_changed: filesChanged && filesChanged.length > 0 ? filesChanged : undefined,
+        outcome,
+    };
+}
+/**
+ * Strip memvid's auto-appended `<key>: <JSON>` metadata tail from a hit's text
+ * to recover the original content. Cuts at the first known metadata key we see.
+ */
+function stripMetadataTokens(text) {
+    if (!text)
+        return "";
+    // Find the earliest occurrence of any known trailing-metadata sentinel.
+    const sentinels = [
+        /\btitle:\s/,
+        /\btags:\s/,
+        /\blabels:\s/,
+        /\bextractous_metadata:\s/,
+        /\bsession_number:\s/,
+        /\bagent_id:\s/,
+        /\btimestamp:\s/,
+        /\bfiles_changed:\s/,
+        /\boutcome:\s/,
+        /\bsummary:\s/,
+    ];
+    let cutIdx = text.length;
+    for (const re of sentinels) {
+        const m = re.exec(text);
+        if (m && m.index < cutIdx)
+            cutIdx = m.index;
+    }
+    return text.slice(0, cutIdx).trim();
+}
+async function nextSessionNumber(agentId) {
+    const path = getBrainPath(agentId);
+    const mv = await openForRead(path);
+    if (!mv)
+        return 1;
+    try {
+        const stats = await mv.stats();
+        return (stats?.frame_count ?? 0) + 1;
+    }
+    finally {
+        await closeRead(mv);
+    }
+}
+export class MemvidBrain {
+    getBrainPath(agentId) {
+        return getBrainPath(agentId);
+    }
+    async appendSession(agentId, session) {
+        ensureBrainsDir();
+        const sessionNumber = session.session_number ?? (await nextSessionNumber(agentId));
+        const timestamp = session.timestamp ?? new Date().toISOString();
+        const path = getBrainPath(agentId);
+        const mv = await openForWrite(path);
+        try {
+            await mv.put({
+                title: `[session ${sessionNumber}] ${session.summary}`,
+                label: sanitizeAgentId(agentId),
+                text: session.content,
+                metadata: {
+                    session_number: sessionNumber,
+                    agent_id: agentId,
+                    timestamp,
+                    summary: session.summary,
+                    files_changed: session.files_changed ?? [],
+                    outcome: session.outcome ?? "",
+                },
+            });
+        }
+        finally {
+            await mv.seal();
+        }
+        return sessionNumber;
+    }
+    async search(agentId, query, limit = 5) {
+        const path = getBrainPath(agentId);
+        const mv = await openForRead(path);
+        if (!mv)
+            return [];
+        try {
+            const res = await mv.find(query, { k: limit, mode: "lex" });
+            const hits = [];
+            for (const rawHit of res.hits ?? []) {
+                const hit = rawHit;
+                const parsed = parseTitle(hit?.title);
+                if (!parsed)
+                    continue;
+                const timestamp = extractMetaString(hit?.text, "timestamp") ?? "";
+                hits.push({
+                    session_number: parsed.sessionNumber,
+                    timestamp,
+                    summary: parsed.summary,
+                    snippet: hit?.snippet ?? "",
+                    score: typeof hit?.score === "number" ? hit.score : 0,
+                });
+            }
+            return hits;
+        }
+        finally {
+            await closeRead(mv);
+        }
+    }
+    async recall(agentId, sessionNumber) {
+        const path = getBrainPath(agentId);
+        const mv = await openForRead(path);
+        if (!mv)
+            return null;
+        try {
+            // Match the title prefix. `[session N]` is distinctive enough.
+            const res = await mv.find(`[session ${sessionNumber}]`, { k: 5, mode: "lex" });
+            for (const hit of res.hits ?? []) {
+                const parsed = parseTitle(hit?.title);
+                if (parsed?.sessionNumber === sessionNumber) {
+                    return hitToRecord(agentId, hit);
+                }
+            }
+            return null;
+        }
+        finally {
+            await closeRead(mv);
+        }
+    }
+    async getSessionCount(agentId) {
+        const path = getBrainPath(agentId);
+        const mv = await openForRead(path);
+        if (!mv)
+            return 0;
+        try {
+            const stats = await mv.stats();
+            return stats?.frame_count ?? 0;
+        }
+        finally {
+            await closeRead(mv);
+        }
+    }
+    async listBrains() {
+        const dir = getBrainsDir();
+        if (!existsSync(dir))
+            return [];
+        const result = [];
+        for (const file of readdirSync(dir)) {
+            if (!file.endsWith(".mv2"))
+                continue;
+            const agentId = file.slice(0, -".mv2".length);
+            const fullPath = join(dir, file);
+            let sessions = 0;
+            try {
+                const mv = await openForRead(fullPath);
+                if (mv) {
+                    const stats = await mv.stats();
+                    sessions = stats?.frame_count ?? 0;
+                    await closeRead(mv);
+                }
+            }
+            catch {
+                // If a .mv2 is locked or corrupted, still list it with 0 sessions.
+                sessions = 0;
+            }
+            result.push({ agentId, sessions, path: fullPath });
+        }
+        return result;
+    }
+}
+export const memvidBrain = new MemvidBrain();
+//# sourceMappingURL=memvidBrain.js.map

package/dist/brain/memvidBrain.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Unit tests for MemvidBrain (§1.5 finish-agenthub-v1-backlog).
+ *
+ * Uses a per-test temp dir as the fake HOME, so `~/.claude/brains/` maps under
+ * that temp dir and real user data is never touched.
+ */
+export {};
+//# sourceMappingURL=memvidBrain.test.d.ts.map

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

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

package/dist/brain/memvidBrain.test.js

@@ -0,0 +1,121 @@
+/**
+ * Unit tests for MemvidBrain (§1.5 finish-agenthub-v1-backlog).
+ *
+ * Uses a per-test temp dir as the fake HOME, so `~/.claude/brains/` maps under
+ * that temp dir and real user data is never touched.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { mkdtempSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+let tempHome;
+function setFakeHome(dir) {
+    // memvidBrain reads `os.homedir()` lazily — patch it via env + module-level mock.
+    if (process.platform === "win32") {
+        process.env.USERPROFILE = dir;
+    }
+    else {
+        process.env.HOME = dir;
+    }
+}
+// Mock os.homedir before the modules under test are imported.
+vi.mock("os", async () => {
+    const actual = await vi.importActual("os");
+    return {
+        ...actual,
+        homedir: () => process.env.__TEST_HOME__ ?? actual.homedir(),
+    };
+});
+async function importMemvidBrain() {
+    // Import lazily so the os mock is applied before the module reads homedir.
+    const mod = await import("./memvidBrain.js");
+    return mod;
+}
+describe("MemvidBrain", () => {
+    beforeEach(() => {
+        tempHome = mkdtempSync(join(tmpdir(), "memvid-brain-test-"));
+        process.env.__TEST_HOME__ = tempHome;
+        setFakeHome(tempHome);
+    });
+    afterEach(() => {
+        try {
+            rmSync(tempHome, { recursive: true, force: true });
+        }
+        catch {
+            // best effort
+        }
+        delete process.env.__TEST_HOME__;
+    });
+    it("round-trip: append, search, recall", async () => {
+        const { MemvidBrain } = await importMemvidBrain();
+        const brain = new MemvidBrain();
+        const agent = "test-agent-1";
+        const sessions = [
+            { summary: "intel deploy", content: "Deployed intel-layer runs." },
+            { summary: "org brain staging", content: "Shipped org brain models and store." },
+            { summary: "FTS5 sanitizer", content: "Hardened FTS5 query sanitizer against punctuation." },
+            { summary: "WS header auth", content: "Migrated WebSocket API key to X-API-Key header." },
+            { summary: "openspec cleanup", content: "Archived 10 changes, reconciled tasks." },
+        ];
+        const appended = [];
+        for (const s of sessions) {
+            const n = await brain.appendSession(agent, s);
+            appended.push(n);
+        }
+        expect(appended).toEqual([1, 2, 3, 4, 5]);
+        expect(await brain.getSessionCount(agent)).toBe(5);
+    });
+    it("search returns the expected session for a lexical query", async () => {
+        const { MemvidBrain } = await importMemvidBrain();
+        const brain = new MemvidBrain();
+        const agent = "test-agent-2";
+        await brain.appendSession(agent, { summary: "intel deploy", content: "Deployed intel-layer runs." });
+        await brain.appendSession(agent, {
+            summary: "FTS5 sanitizer",
+            content: "Hardened FTS5 query sanitizer against reserved tokens.",
+        });
+        await brain.appendSession(agent, { summary: "openspec", content: "Archived changes." });
+        const hits = await brain.search(agent, "FTS5 sanitizer", 5);
+        expect(hits.length).toBeGreaterThan(0);
+        expect(hits[0].summary).toBe("FTS5 sanitizer");
+        expect(hits[0].session_number).toBe(2);
+    });
+    it("recall returns full record for a known session number", async () => {
+        const { MemvidBrain } = await importMemvidBrain();
+        const brain = new MemvidBrain();
+        const agent = "test-agent-3";
+        await brain.appendSession(agent, { summary: "s1", content: "c1" });
+        const n = await brain.appendSession(agent, {
+            summary: "target",
+            content: "the content we want to recall",
+            files_changed: ["a.go", "b.ts"],
+            outcome: "success",
+        });
+        await brain.appendSession(agent, { summary: "s3", content: "c3" });
+        const recalled = await brain.recall(agent, n);
+        expect(recalled).not.toBeNull();
+        expect(recalled?.summary).toBe("target");
+        expect(recalled?.content).toBe("the content we want to recall");
+        expect(recalled?.outcome).toBe("success");
+        expect(recalled?.files_changed).toEqual(["a.go", "b.ts"]);
+        expect(recalled?.session_number).toBe(n);
+    });
+    it("empty brain: search returns [] without error", async () => {
+        const { MemvidBrain } = await importMemvidBrain();
+        const brain = new MemvidBrain();
+        const hits = await brain.search("never-registered-agent", "anything");
+        expect(hits).toEqual([]);
+    });
+    it("empty brain: recall returns null without error", async () => {
+        const { MemvidBrain } = await importMemvidBrain();
+        const brain = new MemvidBrain();
+        const record = await brain.recall("never-registered-agent", 1);
+        expect(record).toBeNull();
+    });
+    it("empty brain: getSessionCount returns 0", async () => {
+        const { MemvidBrain } = await importMemvidBrain();
+        const brain = new MemvidBrain();
+        expect(await brain.getSessionCount("never-registered-agent")).toBe(0);
+    });
+});
+//# sourceMappingURL=memvidBrain.test.js.map

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

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

package/dist/brain/migrate.d.ts

@@ -0,0 +1,36 @@
+/**
+ * JSONL → memvid migration (§1.4 finish-agenthub-v1-backlog).
+ *
+ * For each `~/.claude/brains/<agent>.jsonl`:
+ *   1. Skip if `<agent>.mv2` exists and is newer than the JSONL.
+ *   2. Read JSONL line-by-line; skip malformed lines (log + continue).
+ *   3. Write new entries to `<agent>.mv2.new` via MemvidBrain.appendSession.
+ *   4. Verify written session count matches parsed-JSONL count (hash-verify).
+ *   5. Atomic rename `.mv2.new` → `.mv2`.
+ *   6. Atomic rename `<agent>.jsonl` → `<agent>.jsonl.frozen.<ISO>`.
+ *
+ * If any step fails, the `.mv2.new` tempfile is left for inspection and the
+ * JSONL source is untouched — migration is re-runnable.
+ */
+export interface MigrationResult {
+    agentId: string;
+    skipped: boolean;
+    skipReason?: string;
+    sessionsRead: number;
+    sessionsWritten: number;
+    malformedLines: number;
+    mv2Path: string;
+    frozenPath?: string;
+    elapsedMs: number;
+    error?: string;
+}
+/**
+ * Migrate a single agent's JSONL brain to memvid. Idempotent.
+ */
+export declare function migrateAgent(agentId: string): Promise<MigrationResult>;
+/**
+ * Walk the brains dir, migrate every `<agent>.jsonl` that has no fresh `.mv2`.
+ * Called at MCP boot when backend=memvid.
+ */
+export declare function migrateAllPending(): Promise<MigrationResult[]>;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/brain/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAiBH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoCD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmH5E;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAWpE"}