brains-mcp 1.61.2

package/dist/server.js

@@ -0,0 +1,532 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { getStorageClient } from "./storage/client.js";
+import { DriveAuthError, DriveConflictError, DriveNotFoundError, DrivePermissionError, DriveQuotaError } from "./drive/errors.js";
+import { listPages, listPagesInputSchema } from "./tools/listPages.js";
+import { readPage, readPageInputSchema } from "./tools/readPage.js";
+import { searchPages, searchPagesInputSchema } from "./tools/searchPages.js";
+import { createPage, createPageInputSchema } from "./tools/createPage.js";
+import { createPages, createPagesInputSchema } from "./tools/createPages.js";
+import { patchPage, patchPageInputSchema } from "./tools/patchPage.js";
+import { updatePage, updatePageInputSchema } from "./tools/updatePage.js";
+import { movePage, movePageInputSchema } from "./tools/movePage.js";
+import { appendLog, appendLogInputSchema } from "./tools/appendLog.js";
+import { healthCheck, healthCheckInputSchema } from "./tools/healthCheck.js";
+import { importBrainSource, importBrainSourceInputSchema } from "./tools/importBrainSource.js";
+import { exportWiki, exportWikiInputSchema } from "./tools/exportWiki.js";
+import { importWikiZip, importWikiZipInputSchema } from "./tools/importWikiZip.js";
+import { purgeWiki, purgeWikiInputSchema } from "./tools/purgeWiki.js";
+import { generateClaudeInstructions, generateClaudeInstructionsInputSchema, } from "./tools/generateClaudeInstructions.js";
+import { generateGptInstructions, generateGptInstructionsInputSchema, } from "./tools/generateGptInstructions.js";
+import { resolveProject, resolveProjectInputSchema } from "./tools/resolveProject.js";
+import { initProject, initProjectInputSchema } from "./tools/initProject.js";
+import { pullSessionBundle, pullSessionBundleInputSchema } from "./tools/pullSessionBundle.js";
+import { pushSessionBundle, pushSessionBundleInputSchema, pushSessionBundleJsonSchema } from "./tools/pushSessionBundle.js";
+import { auditIndex, auditIndexInputSchema } from "./tools/auditIndex.js";
+import { readGovernanceAudit, readGovernanceAuditInputSchema } from "./tools/readGovernanceAudit.js";
+import { extractLinks, extractLinksInputSchema } from "./tools/extractLinks.js";
+import { getBacklinks, getBacklinksInputSchema } from "./tools/getBacklinks.js";
+import { getRelated, getRelatedInputSchema } from "./tools/getRelated.js";
+import { suggestLinks, suggestLinksInputSchema } from "./tools/suggestLinks.js";
+import { deletePage, deletePageInputSchema } from "./tools/deletePage.js";
+import { batchDeletePages, batchDeletePagesInputSchema } from "./tools/batchDeletePages.js";
+import { restorePage, restorePageInputSchema, restorePageBaseSchema } from "./tools/restorePage.js";
+import { listArchivedPages, listArchivedPagesInputSchema } from "./tools/listArchivedPages.js";
+import { setWebhook, setWebhookInputSchema } from "./tools/setWebhook.js";
+import { listWebhooks, listWebhooksInputSchema } from "./tools/listWebhooks.js";
+import { removeWebhook, removeWebhookInputSchema } from "./tools/removeWebhook.js";
+import { addWebhookPattern, addWebhookPatternInputSchema } from "./tools/addWebhookPattern.js";
+import { listPageHistory, listPageHistoryInputSchema, readPageVersion, readPageVersionInputSchema, } from "./tools/pageHistory.js";
+import { DEFAULT_ACCESS_CONTEXT, isHiveModeEnabled, } from "./governance/accessControl.js";
+import { shareProject, shareProjectInputSchema } from "./tools/shareProject.js";
+function zodToJsonSchema(schema) {
+    // Minimal inline converter — enough for flat objects with string/boolean/array fields
+    if (schema instanceof z.ZodObject) {
+        const shape = schema._def.shape();
+        const properties = {};
+        const required = [];
+        for (const [key, val] of Object.entries(shape)) {
+            const fieldSchema = val;
+            const isOptional = fieldSchema instanceof z.ZodOptional ||
+                fieldSchema instanceof z.ZodDefault;
+            const inner = unwrapZodSchema(fieldSchema);
+            properties[key] = inferJsonSchemaType(inner);
+            if (!isOptional)
+                required.push(key);
+        }
+        return required.length > 0 ? { type: "object", properties, required } : { type: "object", properties };
+    }
+    return {};
+}
+function unwrapZodSchema(schema) {
+    let current = schema;
+    while (current instanceof z.ZodOptional ||
+        current instanceof z.ZodDefault ||
+        current instanceof z.ZodEffects) {
+        if (current instanceof z.ZodOptional) {
+            current = current._def.innerType;
+            continue;
+        }
+        if (current instanceof z.ZodDefault) {
+            current = current._def.innerType;
+            continue;
+        }
+        current = current._def.schema;
+    }
+    return current;
+}
+function inferJsonSchemaType(schema) {
+    const unwrapped = unwrapZodSchema(schema);
+    if (unwrapped !== schema)
+        return inferJsonSchemaType(unwrapped);
+    if (schema instanceof z.ZodString)
+        return { type: "string" };
+    if (schema instanceof z.ZodBoolean)
+        return { type: "boolean" };
+    if (schema instanceof z.ZodNumber)
+        return { type: "number" };
+    if (schema instanceof z.ZodArray)
+        return { type: "array", items: inferJsonSchemaType(schema._def.type) };
+    if (schema instanceof z.ZodEnum)
+        return { type: "string", enum: schema._def.values };
+    if (schema instanceof z.ZodObject)
+        return zodToJsonSchema(schema);
+    return {};
+}
+function wrapDriveError(err) {
+    let message;
+    if (err instanceof DriveConflictError) {
+        message = `CONFLICT: The page was modified since you last read it. Re-read the page to get the latest revision, then retry your write. (seenRevision=${err.seenRevision}, currentRevision=${err.currentRevision})`;
+    }
+    else if (err instanceof DriveAuthError) {
+        message = `AUTH_ERROR: Google Drive authentication failed. Check that GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN are set and valid. Detail: ${err.message}`;
+    }
+    else if (err instanceof DriveQuotaError) {
+        message = `QUOTA_ERROR: Google Drive rate limit hit. Retry after ${Math.ceil(err.retryAfterMs / 1000)}s.`;
+    }
+    else if (err instanceof DriveNotFoundError) {
+        message = `NOT_FOUND: ${err.message}`;
+    }
+    else if (err instanceof DrivePermissionError) {
+        message = `PERMISSION_ERROR: ${err.message}`;
+    }
+    else {
+        message = err instanceof Error ? err.message : String(err);
+    }
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+export const TOOL_DEFINITIONS = [
+    {
+        name: "list_pages",
+        description: "List wiki pages with optional filtering by tag or status. PRIMARY routing tool: call list_pages first to get a full inventory. When running with Supabase/Postgres index enabled, this is fast with no file reads; otherwise it falls back to a storage scan. Use the returned names to select candidates, then read_page only those candidates.",
+        inputSchema: zodToJsonSchema(listPagesInputSchema),
+        annotations: { title: "List Pages", readOnlyHint: true },
+    },
+    {
+        name: "read_page",
+        description: "Read a wiki page by filename, returning content, frontmatter, fileId, revision, and outbound_link_count. If you already pulled a session bundle, do NOT call this for any page listed in that bundle — its full content is already in your context; read it from there. Otherwise the REQUIRED retrieval workflow is: (1) list_pages first to get inventory, (2) LLM selects candidate files from results, (3) read_page only those candidates, (4) LLM performs synthesis. Do NOT read index.md for routing — when Supabase/Postgres index is enabled the DB index is authoritative; otherwise use list_pages. For small edits, prefer patch_page (especially replace_lines). Use update_page only for intentional full-body rewrites.",
+        inputSchema: zodToJsonSchema(readPageInputSchema),
+        annotations: { title: "Read Page", readOnlyHint: true },
+    },
+    {
+        name: "search_pages",
+        description: "Full-text search across wiki pages. Uses Postgres FTS when Supabase/Postgres index is enabled (fast); falls back to a local scan otherwise. Use for keyword lookups; use list_pages for full inventory and routing.",
+        inputSchema: zodToJsonSchema(searchPagesInputSchema),
+        annotations: { title: "Search Pages", readOnlyHint: true },
+    },
+    {
+        name: "create_page",
+        description: "Create a new wiki page with frontmatter and body content. Name is auto-normalized to a wiki-safe .md path. Returns bytesWritten (UTF-8 byte count of the written file). Ingest responsibility rule: if source material contains stable facts, active tasks, and decisions, you MUST split it across taxonomy folders (canonical/, projects/, decisions/) and keep data/ as raw synthesis only.",
+        inputSchema: zodToJsonSchema(createPageInputSchema),
+        annotations: { title: "Create Page", readOnlyHint: false },
+    },
+    {
+        name: "create_pages",
+        description: "Create multiple pages in one call (fast path for ingest decomposition into canonical/projects/decisions/data). Returns compact timing/count summary by default; set verbose=true for per-page results. Response includes totalBytesWritten (sum of UTF-8 bytes across all created pages) and per-page bytesWritten when verbose=true.",
+        inputSchema: zodToJsonSchema(createPagesInputSchema),
+        annotations: { title: "Create Pages (Batch)", readOnlyHint: false },
+    },
+    {
+        name: "import_brain_source",
+        description: "Deterministic importer for source brain folders. Supports preview mode (execute=false) and execute mode (execute=true) with folder-based routing and car-profile consolidation.",
+        inputSchema: zodToJsonSchema(importBrainSourceInputSchema),
+        annotations: { title: "Import Brain Source", readOnlyHint: false },
+    },
+    {
+        name: "export_wiki",
+        description: "Export wiki pages to a ZIP archive. When outputPath is omitted, returns the ZIP as a base64-encoded string (zipData) — no server filesystem access required, fully agent-reachable. Pass zipData to import_wiki to round-trip without curl. When outputPath is provided, also writes to that server path. Optional: filter by folder prefix (e.g. 'projects/brainsapp') or tags (any matching tag includes the page).",
+        inputSchema: zodToJsonSchema(exportWikiInputSchema),
+        annotations: { title: "Export Wiki", readOnlyHint: true },
+    },
+    {
+        name: "import_wiki",
+        description: "Import a wiki from a ZIP archive. Agent-friendly: pass zipData (base64 from export_wiki) instead of zipPath for fully agent-reachable round-trips. Supports preview (execute=false) and execute (execute=true). Modes: mode='additive' updates/creates ZIP pages without deleting others; mode='replace' mirrors the ZIP exactly (imports all ZIP pages and deletes pages absent from the ZIP, always overwrite). When execute applies changes, response includes instructionRefreshRequired/discoveredFolders/nextAction hints for instruction refresh.",
+        inputSchema: zodToJsonSchema(importWikiZipInputSchema),
+        annotations: { title: "Import Wiki from ZIP", readOnlyHint: false },
+    },
+    {
+        name: "pull_session_bundle",
+        description: "Downloads all relevant wiki pages for your project as a single plain-text bundle (no ZIP decode needed). The returned bundle IS your working set: every listed page is included in full, so do NOT call read_page on any of them afterwards. Work locally in this conversation, then push back with push_session_bundle when done. Measured 10.04s of individual read_page calls versus 3.47s for the same ten pages bundled. For a project, prefer folder=projects/<slug> over tags — folder membership is structural and cannot drift, whereas tags are hand-maintained and frequently incomplete (measured on a real wiki: tags returned 0 of 39 pages for one project and 2 of 49 for another, while the folder selector returned all of them). Use tags only for cross-cutting themes that span folders. If you do not know the project slug, do NOT guess one: list_pages with folder='projects' shows the available projects — resolve the slug first, then pull. Always set maxBytes=150000 to stay within context limits. Paginates via nextCursor. Each entry in the returned 'pages' array includes a 'revision' — pass it back on the matching page in push_session_bundle's pages mode to get conflict protection against other concurrent writers (e.g. a shared project).",
+        inputSchema: zodToJsonSchema(pullSessionBundleInputSchema),
+        annotations: { title: "Pull Session Bundle", readOnlyHint: true },
+    },
+    {
+        name: "push_session_bundle",
+        description: "PREFERRED write-back tool when paired with pull_session_bundle. Two modes: (1) pages mode (recommended) — pass pages=[{name,content,revision?}] for each page you modified; avoids token-limit issues with large bundles. (2) bundle mode (small bundles <20 KB only) — pass bundle string + manifest array. Both modes use the same conflict-strategy semantics. In pages mode, include the 'revision' you got from pull_session_bundle/read_page for each page — if someone else changed that page in the meantime, the write is rejected as a conflict (returned in 'conflicts') instead of overwriting their change; re-read the page, reconcile, and push again with the fresh revision. Omitting revision falls back to conflictStrategy-only behavior (no conflict protection). Returns ok, created, updated, skipped, conflicts, and any per-page errors.",
+        inputSchema: zodToJsonSchema(pushSessionBundleJsonSchema),
+        annotations: { title: "Push Session Bundle", readOnlyHint: false },
+    },
+    {
+        name: "purge_wiki",
+        description: "Permanently delete all wiki pages. Returns a warning and file list when confirm=false. Set confirm=true to proceed. Set exportBeforeDelete=true with exportOutputPath to create a ZIP backup first.",
+        inputSchema: zodToJsonSchema(purgeWikiInputSchema),
+        annotations: { title: "Purge Wiki", readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: "update_page",
+        description: "FULL REWRITE tool: replaces the page body. Requires fileId and revision from read_page to prevent conflicts. Returns bytesWritten (UTF-8 byte count of the written file). Prefer patch_page for targeted edits (use replace_lines when possible); use update_page when intentionally rewriting most/all content. Ingest responsibility rule: when refining ingest docs, distribute content into canonical/, projects/, and decisions/ pages where appropriate instead of leaving everything in data/.",
+        inputSchema: zodToJsonSchema(updatePageInputSchema),
+        annotations: { title: "Update Page (Full Rewrite)", readOnlyHint: false },
+    },
+    {
+        name: "patch_page",
+        description: "PREFERRED EDIT tool for small/medium changes. Patch a page with surgical edits in one call. Returns bytesWritten (UTF-8 byte count of the file after patching). Supports text anchors and line-range replacement (replace_lines with 1-based full-file line numbers), and accepts multiple operations in an array. Each operation MUST include a 'type' field (one of: replace, insert_after, insert_before, append, replace_lines). Example replace op: {\"type\": \"replace\", \"find\": \"## Status\\nOld text\", \"replace\": \"## Status\\nNew text\"}.",
+        inputSchema: zodToJsonSchema(patchPageInputSchema),
+        annotations: { title: "Patch Page (Surgical Edit)", readOnlyHint: false },
+    },
+    {
+        name: "move_page",
+        description: "Archive (prefix with 'archive-') or rename a wiki page. No hard deletion in v1.",
+        inputSchema: zodToJsonSchema(movePageInputSchema),
+        annotations: { title: "Move / Rename Page", readOnlyHint: false },
+    },
+    {
+        name: "append_log",
+        description: "Append an entry to the wiki log. Use for ingest, query, lint, and error events.",
+        inputSchema: zodToJsonSchema(appendLogInputSchema),
+        annotations: { title: "Append Log Entry", readOnlyHint: false },
+    },
+    {
+        name: "health_check",
+        description: "Check server health: storage backend connectivity (Supabase Storage), search index status (Postgres FTS), uptime, and session log status. Call once at session start to confirm the server is reachable before doing work.",
+        inputSchema: zodToJsonSchema(healthCheckInputSchema),
+        annotations: { title: "Health Check", readOnlyHint: true },
+    },
+    {
+        name: "generate_claude_instructions",
+        description: "Refresh the Claude instruction block for an EXISTING Brains-connected project. Returns a markdown block the user can paste into their Claude Project system prompt. For NEW projects, call init_project first — it scaffolds the brain pages and emits the same instruction block.",
+        inputSchema: zodToJsonSchema(generateClaudeInstructionsInputSchema),
+        annotations: { title: "Generate Claude Instructions", readOnlyHint: true },
+    },
+    {
+        name: "generate_gpt_instructions",
+        description: "Refresh the ChatGPT instruction block for an EXISTING Brains-connected project. Returns a markdown block the user can paste into their ChatGPT system prompt. For NEW projects, call init_project first — it scaffolds the brain pages and emits the same instruction block.",
+        inputSchema: zodToJsonSchema(generateGptInstructionsInputSchema),
+        annotations: { title: "Generate GPT Instructions", readOnlyHint: true },
+    },
+    {
+        name: "resolve_project",
+        description: "Call this FIRST when the user refers to a project, vehicle, property, client or topic by name and you do not already know its brains project slug. Turns freeform context into the project slug plus the path to its instruction file, so you can pull the right project instead of guessing a tag. Returns ranked matches with a confidence and an `ambiguous` flag — when ambiguous is true or confidence is low, ask the user rather than loading a project. Does not load anything itself: follow up with pull_session_bundle(folder: \"projects/<slug>\").",
+        inputSchema: zodToJsonSchema(resolveProjectInputSchema),
+        annotations: { title: "Resolve Project", readOnlyHint: true },
+    },
+    {
+        name: "init_project",
+        description: "FIRST CALL for any new Brains setup. Creates the project brain pages (projects/instructions/decisions scaffolding) and returns a ready-to-paste instruction block for Claude or ChatGPT. Idempotent — safe to re-run. To refresh instructions on an already-initialized project, use generate_claude_instructions or generate_gpt_instructions instead.",
+        inputSchema: zodToJsonSchema(initProjectInputSchema),
+        annotations: { title: "Initialize Project", readOnlyHint: false },
+    },
+    {
+        name: "audit_index",
+        description: "Diagnose and repair index/storage drift. Reads the Postgres index, checks each entry against the storage backend, and reports ghost rows (in index but not in storage) and unindexed pages (in storage but not in index). Safe read-only by default. Set cleanup=true to delete ghost rows and re-index missing pages. Writes a log entry when cleanup runs. Requires Postgres index to be configured.",
+        inputSchema: zodToJsonSchema(auditIndexInputSchema),
+        annotations: { title: "Audit Index", readOnlyHint: false },
+    },
+    {
+        name: "read_governance_audit",
+        description: "Read governance audit log entries (Hive mode only). Returns server-side access filter events for classification review. Only accessible to exec+ users (access_level ≥ 4) when BRAINS_HIVE_MODE=true.",
+        inputSchema: zodToJsonSchema(readGovernanceAuditInputSchema),
+        annotations: { title: "Read Governance Audit", readOnlyHint: true },
+    },
+    {
+        name: "extract_links",
+        description: "Run link extraction over a filtered set of wiki pages. Inserts/updates rows in the server-side wiki_links graph for pages where the on-write hook missed (e.g. legacy pages, ingest backfill). Requires at least one of tags or folder. Returns { pagesProcessed, linksExtracted }. NOTE: pagesProcessed=0 means no stale pages remain — that is success, not failure.",
+        inputSchema: zodToJsonSchema(extractLinksInputSchema),
+        annotations: { title: "Extract Links", readOnlyHint: false },
+    },
+    {
+        name: "get_backlinks",
+        description: "Return the list of pages that link TO the given page (incoming references). Uses the server-side wiki_links graph; pages not yet indexed produce empty results — call extract_links first if needed.",
+        inputSchema: zodToJsonSchema(getBacklinksInputSchema),
+        annotations: { title: "Get Backlinks", readOnlyHint: true },
+    },
+    {
+        name: "get_related",
+        description: "Return pages that share outbound link targets with the given page (second-degree neighbors). Uses the server-side wiki_links graph; pages not yet indexed produce empty results — call extract_links first if needed.",
+        inputSchema: zodToJsonSchema(getRelatedInputSchema),
+        annotations: { title: "Get Related Pages", readOnlyHint: true },
+    },
+    {
+        name: "suggest_links",
+        description: "Retroactive linking audit: find wiki pages that lack a '## Related pages' section and return ready-to-apply markdown patches suggesting cross-references. Filters by tags or folder. Uses the server-side link graph (shared outbound targets, backlinks) when available; falls back to tag-overlap heuristics. Never writes — patches require explicit review and confirmation before applying with patch_page.",
+        inputSchema: zodToJsonSchema(suggestLinksInputSchema),
+        annotations: { title: "Suggest Links", readOnlyHint: true },
+    },
+    {
+        name: "delete_page",
+        description: "Archive-then-delete a single wiki page. On confirm=true, writes a recoverable archived_pages row (origin path/folder, content, metadata, deleted_by, optional reason) before deleting from live storage/index. Set confirm=false (default) for a dry-run preview. Protected system pages (instructions/brain-routing.md, decisions/readme.md, history/readme.md, log.md, index.md) cannot be deleted.",
+        inputSchema: zodToJsonSchema(deletePageInputSchema),
+        annotations: { title: "Delete Page", readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: "batch_delete_pages",
+        description: "Archive-then-delete up to 50 wiki pages in one call. For each page, writes a recoverable archived_pages row before deleting from live storage/index. Set confirm=false (default) for a dry-run manifest. Set confirm=true to execute. Protected system pages are silently skipped.",
+        inputSchema: zodToJsonSchema(batchDeletePagesInputSchema),
+        annotations: { title: "Batch Delete Pages", readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: "list_archived_pages",
+        description: "List archived_pages rows for the current user (id, original path/folder, deleted_at, deleted_by, reason, restore status). Use this to discover restore candidates.",
+        inputSchema: zodToJsonSchema(listArchivedPagesInputSchema),
+        annotations: { title: "List Archived Pages", readOnlyHint: true },
+    },
+    {
+        name: "restore_page",
+        description: "Restore a previously archived page by archiveId or originalPath (+ optional deletedAt). Recreates the page at original path or targetPath, re-indexes it, and stamps restored_at/restored_by on the archive row. Enforces page-limit checks.",
+        // Generate from the plain object, NOT the .refine()'d schema — a ZodEffects can
+        // serialize to an empty `{}` and break MCP tool-list validation. Runtime parse
+        // still uses restorePageInputSchema (with the OR constraint) below.
+        inputSchema: zodToJsonSchema(restorePageBaseSchema),
+        annotations: { title: "Restore Archived Page", readOnlyHint: false },
+    },
+    {
+        name: "set_webhook",
+        description: "Create or update an outbound webhook rule. The rule fires a signed POST to the target URL whenever a page matching one of its glob/regex patterns is created or updated. Omit 'id' to create a new rule; pass an existing 'id' to update it. Patterns use glob syntax (e.g. 'projects/brainsapp/open-loop-*.md') or /regex/ syntax.",
+        inputSchema: zodToJsonSchema(setWebhookInputSchema),
+        annotations: { title: "Set Webhook", readOnlyHint: false },
+    },
+    {
+        name: "list_webhooks",
+        description: "List all outbound webhook rules configured for the current user.",
+        inputSchema: zodToJsonSchema(listWebhooksInputSchema),
+        annotations: { title: "List Webhooks", readOnlyHint: true },
+    },
+    {
+        name: "remove_webhook",
+        description: "Permanently delete an outbound webhook rule by ID.",
+        inputSchema: zodToJsonSchema(removeWebhookInputSchema),
+        annotations: { title: "Remove Webhook", readOnlyHint: false, destructiveHint: true },
+    },
+    {
+        name: "add_webhook_pattern",
+        description: "Append a glob or regex pattern to an existing webhook rule's pattern list. Idempotent — adding a pattern that already exists is a no-op.",
+        inputSchema: zodToJsonSchema(addWebhookPatternInputSchema),
+        annotations: { title: "Add Webhook Pattern", readOnlyHint: false },
+    },
+    {
+        name: "list_page_history",
+        description: "List the version history for a wiki page. Returns snapshots captured before each update_page or patch_page call, newest-first. Use read_page_version to retrieve the content of a specific snapshot.",
+        inputSchema: zodToJsonSchema(listPageHistoryInputSchema),
+        annotations: { title: "List Page History", readOnlyHint: true },
+    },
+    {
+        name: "read_page_version",
+        description: "Read a specific historical snapshot of a wiki page. Use list_page_history to get the timestamp key, then call this tool to retrieve the full content of that version.",
+        inputSchema: zodToJsonSchema(readPageVersionInputSchema),
+        annotations: { title: "Read Page Version", readOnlyHint: true },
+    },
+];
+// Beta surface — the 15 tools exposed by default. Other tools are hidden unless
+// BRAINS_EXPANDED_TOOLS=true is set (e.g. local dev, internal staging). Prod ships
+// with no env override → only the beta surface is visible to agents.
+const BETA_VISIBLE_TOOLS = new Set([
+    "list_pages",
+    "read_page",
+    "search_pages",
+    "create_page",
+    "create_pages",
+    "update_page",
+    "patch_page",
+    "move_page",
+    "append_log",
+    "health_check",
+    "pull_session_bundle",
+    "push_session_bundle",
+    "resolve_project",
+    "init_project",
+    "generate_claude_instructions",
+    "generate_gpt_instructions",
+    "set_webhook",
+    "list_webhooks",
+    "remove_webhook",
+    "add_webhook_pattern",
+    "export_wiki",
+    "import_wiki",
+    "purge_wiki",
+    "audit_index",
+    "delete_page",
+    "batch_delete_pages",
+    "list_archived_pages",
+    "restore_page",
+    "list_page_history",
+    "read_page_version",
+]);
+export class ToolNotAvailableError extends Error {
+    constructor(name) {
+        super(`Tool '${name}' is not available in this deployment. Set BRAINS_EXPANDED_TOOLS=true to enable the full tool surface.`);
+        this.name = "ToolNotAvailableError";
+    }
+}
+export function isExpandedToolsEnabled() {
+    return (process.env.BRAINS_EXPANDED_TOOLS ?? "").trim().toLowerCase() === "true";
+}
+export function isToolVisible(name) {
+    if (name === "read_governance_audit")
+        return isHiveModeEnabled();
+    if (isExpandedToolsEnabled())
+        return true;
+    return BETA_VISIBLE_TOOLS.has(name);
+}
+export function getVisibleTools() {
+    return TOOL_DEFINITIONS.filter((t) => isToolVisible(t.name));
+}
+export async function executeToolCall(drive, name, args, userId = "", accessCtx = DEFAULT_ACCESS_CONTEXT) {
+    // Internal-only tool: deliberately bypasses isToolVisible/TOOL_DEFINITIONS
+    // so it never appears in ListTools (public tool list / docs), but stays
+    // callable by name for agent-driven administration. See BRA-368.
+    if (name === "share_project") {
+        return await shareProject(shareProjectInputSchema.parse(args), userId, drive);
+    }
+    if (!isToolVisible(name)) {
+        throw new ToolNotAvailableError(name);
+    }
+    switch (name) {
+        case "list_pages":
+            return await listPages(drive, listPagesInputSchema.parse(args), userId, accessCtx);
+        case "read_page":
+            return await readPage(drive, readPageInputSchema.parse(args), userId, accessCtx);
+        case "search_pages":
+            return await searchPages(drive, searchPagesInputSchema.parse(args), userId, accessCtx);
+        case "create_page":
+            return await createPage(drive, createPageInputSchema.parse(args), userId);
+        case "create_pages":
+            return await createPages(drive, createPagesInputSchema.parse(args), userId);
+        case "import_brain_source":
+            return await importBrainSource(drive, importBrainSourceInputSchema.parse(args), userId);
+        case "export_wiki":
+            return await exportWiki(drive, exportWikiInputSchema.parse(args));
+        case "import_wiki":
+            return await importWikiZip(drive, importWikiZipInputSchema.parse(args), userId);
+        case "pull_session_bundle":
+            return await pullSessionBundle(drive, pullSessionBundleInputSchema.parse(args), userId, accessCtx);
+        case "push_session_bundle":
+            return await pushSessionBundle(drive, pushSessionBundleInputSchema.parse(args), userId);
+        case "purge_wiki":
+            return await purgeWiki(drive, purgeWikiInputSchema.parse(args), userId);
+        case "update_page":
+            return await updatePage(drive, updatePageInputSchema.parse(args), userId);
+        case "patch_page":
+            return await patchPage(drive, patchPageInputSchema.parse(args), userId);
+        case "move_page":
+            return await movePage(drive, movePageInputSchema.parse(args), userId);
+        case "append_log":
+            return await appendLog(drive, appendLogInputSchema.parse(args), userId);
+        case "health_check":
+            return await healthCheck(drive, userId);
+        case "generate_claude_instructions":
+            return await generateClaudeInstructions(generateClaudeInstructionsInputSchema.parse(args), drive, userId);
+        case "generate_gpt_instructions":
+            return await generateGptInstructions(generateGptInstructionsInputSchema.parse(args), drive, userId);
+        case "resolve_project":
+            return await resolveProject(drive, resolveProjectInputSchema.parse(args), userId);
+        case "init_project":
+            return await initProject(drive, initProjectInputSchema.parse(args), userId);
+        case "audit_index":
+            return await auditIndex(drive, auditIndexInputSchema.parse(args), userId);
+        case "read_governance_audit":
+            return await readGovernanceAudit(readGovernanceAuditInputSchema.parse(args), userId);
+        case "extract_links":
+            return await extractLinks(extractLinksInputSchema.parse(args), userId);
+        case "get_backlinks":
+            return await getBacklinks(getBacklinksInputSchema.parse(args), userId, accessCtx);
+        case "get_related":
+            return await getRelated(getRelatedInputSchema.parse(args), userId, accessCtx);
+        case "suggest_links":
+            return await suggestLinks(drive, suggestLinksInputSchema.parse(args), userId);
+        case "delete_page":
+            return await deletePage(drive, deletePageInputSchema.parse(args), userId);
+        case "batch_delete_pages":
+            return await batchDeletePages(drive, batchDeletePagesInputSchema.parse(args), userId);
+        case "list_archived_pages":
+            return await listArchivedPages(listArchivedPagesInputSchema.parse(args), userId);
+        case "restore_page":
+            return await restorePage(drive, restorePageInputSchema.parse(args), userId);
+        case "set_webhook":
+            return await setWebhook(setWebhookInputSchema.parse(args), userId);
+        case "list_webhooks":
+            return await listWebhooks(userId);
+        case "remove_webhook":
+            return await removeWebhook(removeWebhookInputSchema.parse(args), userId);
+        case "add_webhook_pattern":
+            return await addWebhookPattern(addWebhookPatternInputSchema.parse(args), userId);
+        case "list_page_history":
+            return await listPageHistory(drive, listPageHistoryInputSchema.parse(args));
+        case "read_page_version":
+            return await readPageVersion(drive, readPageVersionInputSchema.parse(args));
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+/**
+ * `driveOverride` may be a fixed StorageClient (legacy behavior — resolved
+ * once, reused for the server's lifetime) or a resolver function that is
+ * invoked fresh on every single tool call.
+ *
+ * Long-lived callers (e.g. an MCP session kept open over many requests) MUST
+ * pass a resolver, not a fixed client: baking in a snapshot means any access
+ * change that happens mid-session — most importantly a project-share grant
+ * revocation (BRA-368/BRA-377) — never takes effect until the session ends.
+ * Passing a plain StorageClient is only safe for genuinely single-request or
+ * single-process-lifetime contexts (e.g. the stdio CLI entrypoint).
+ */
+export function createBrainsServer(driveOverride, userId = "", userAccessLevel = 5) {
+    const server = new Server({ name: "brains", version: "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: getVisibleTools(),
+    }));
+    const accessCtx = { userAccessLevel };
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            // Resolved inside the try: a resolver failure (e.g. the grant-lookup
+            // fetch erroring) must go through the same wrapDriveError handling as
+            // any other tool-execution failure, not bypass it as an unhandled
+            // rejection from the MCP transport's perspective.
+            const drive = typeof driveOverride === "function"
+                ? await driveOverride()
+                : driveOverride ?? await getStorageClient();
+            const result = await executeToolCall(drive, name, args, userId, accessCtx);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.startsWith("Unknown tool:")) {
+                return {
+                    content: [{ type: "text", text: err.message }],
+                    isError: true,
+                };
+            }
+            if (err instanceof z.ZodError) {
+                return {
+                    content: [{ type: "text", text: `Invalid arguments: ${err.message}` }],
+                    isError: true,
+                };
+            }
+            return wrapDriveError(err);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/session/bundle.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Combine an array of pages into a single bundle string.
+ * Each page is preceded by a delimiter line containing its name.
+ */
+export declare function serializeBundle(pages: Array<{
+    name: string;
+    content: string;
+}>): string;
+/**
+ * Build the self-describing header prepended to a pulled bundle.
+ *
+ * The working-set contract already exists in seed/instructions and in the
+ * generated per-project instructions ("Do NOT call read_page on pages already
+ * in the bundle"). It was not reaching agents: tool descriptions are in context
+ * on every turn, wiki instruction pages only if the client loaded them, and an
+ * MCP client such as Claude Code never does. Meanwhile read_page's own
+ * description prescribes a "REQUIRED" list_pages -> read_page workflow with no
+ * bundle carve-out, so the contradiction resolved in favour of re-reading —
+ * measured at 10.04s of individual reads versus 3.47s for the same ten pages
+ * bundled (GH #426).
+ *
+ * Stating the contract inside the payload makes it independent of client,
+ * loaded instructions and context trimming: it arrives with the data.
+ *
+ * The header deliberately lists page names in a plain indented list rather than
+ * as `===PAGE: name===` lines. push_session_bundle's manifest parser locates
+ * pages with indexOf on that exact delimiter, so repeating it here would let a
+ * header line shadow the real one. parseBundle ignores everything before the
+ * first delimiter, so both round-trip paths are unaffected.
+ */
+export declare function buildBundleHeader(pages: Array<{
+    name: string;
+}>, options?: {
+    truncated?: boolean;
+    filter?: string;
+    totalMatching?: number;
+    /**
+     * Conventional project entry points (`readme.md`, `status.md`,
+     * `open-loops.md`, `index.md`) that matched the filter but did not fit.
+     * Named rather than counted: an agent cannot act on "20 of 132", but it can
+     * act on "status.md is missing" (GH #462).
+     */
+    omittedConventional?: string[];
+}): string;
+/**
+ * Parse a bundle string back into named pages.
+ * Throws if the bundle contains no valid page delimiters.
+ */
+export declare function parseBundle(bundle: string): Array<{
+    name: string;
+    content: string;
+}>;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/session/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/session/bundle.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAKvF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9B,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GACL,MAAM,CAgDR;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BpF"}