@astramindapp/mcp-server 0.24.1 → 0.27.0

package/dist/server.js

@@ -12,33 +12,29 @@
  * integration path to use for its runtime, how to authenticate, and the
  * session protocol — without having to be told.
  *
- * Tools (24):
- *   mind_query        — Semantic search across the knowledge graph
- *   mind_remember     — Store/manage content in the graph (auto-categorized)
- *   mind_folders      — Organize documents into folders (list/create/rename/
- *                       move/delete/move_documents)
- *   mind_context      — Get structured always-loaded context (soul/user/rules)
- *   mind_life         — Goals, projects, tasks, calendar (incl. bulk_delete)
- *   mind_tasks        — Site-wide assignable, reportable work items
- *   mind_crm          — Read/write contacts, interactions, and activities
- *   mind_graph        — Get graph statistics, diagnostics, and labels
- *   mind_admin        — Admin-only user and featured mind management
- *   mind_sense        — MINDsense emotional intelligence layer
- *   mind_research     — Deep research agent jobs
- *   mind_train        — Self-training and chat-to-KG sessions
- *   mind_social       — Public feed posts, communities, and social feed
- *   mind_profile      — Profile, prompts, and model preferences
- *   mind_insights     — ALE insights and analytics
- *   mind_automate     — Automations and triggers
- *   mind_notify       — Notifications management
- *   mind_agents       — Admin-only Agent Command Center (registry, heartbeat,
- *                       probe, status — for the agent fleet)
- *   mind_tickets      — Admin-only agent ticket queue (file, view, answer,
- *                       triage, resolve client feedback / bugs / ideas)
- *   mind_accounts     — Multi-MIND accounts: discover/create MINDs, manage
- *                       owners and viewers, send invitations
- *   mind_list_templates / mind_get_template / mind_save_typed /
- *   mind_bootstrap_templates — the 16 Front Layer typed-document templates
+ * Tools (45):
+ *   Memory & knowledge — mind_query, mind_remember, mind_folders,
+ *     mind_folder_routes, mind_folder_suggest, mind_share (document share
+ *     links), mind_context, mind_graph, mind_insights, mind_research,
+ *     mind_train
+ *   Life & work — mind_life, mind_focuses, mind_tasks, mind_automate,
+ *     mind_notify, mind_checklists (Kanon checklists)
+ *   Agent sessions — mind_sessions (log this session into MIND Chat →
+ *     Agents; see the AGENT SESSION PROTOCOL in ./integration-guide)
+ *   People — mind_crm
+ *   Social & profile — mind_social, mind_social_analytics, mind_profile,
+ *     mind_personas
+ *   Intelligence & trading — mind_sense, mind_trader, mind_osint
+ *   Front Layer templates — mind_list_templates, mind_get_template,
+ *     mind_save_typed, mind_bootstrap_templates
+ *   Fleet & admin (admin key) — mind_agents, mind_tickets, mind_admin,
+ *     mind_accounts
+ *   Full-coverage apps (v0.25.0) — mind_mindmap (MIND Mind Map),
+ *     mind_moneymind (MoneyMIND), mind_budget (13-week cash flow),
+ *     mind_sheets (Airtable-style tables), mind_email (Email Manager),
+ *     mind_sign (e-signature), mind_invoices (Invoice Agent),
+ *     mind_books (MIND Books accounting), mind_timer (Tempo time tracking),
+ *     mind_forms (Quill forms), mind_library (bookshelf)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMindMcpServer = createMindMcpServer;
@@ -58,6 +54,15 @@ const err = (t) => ({
 const ok = (result) => ({
     content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
 });
+// Required-field guard for the generic action-dispatch tools (mind_mindmap,
+// mind_moneymind, mind_budget, mind_sheets, mind_email, mind_checklists,
+// mind_sign, mind_invoices, mind_books, mind_timer, mind_forms, mind_library).
+// Returns an error string naming every missing field, or null when all are
+// present — call sites do `const m = need(args, [...]); if (m) return err(m);`
+const need = (args, fields) => {
+    const missing = fields.filter((f) => args[f] === undefined || args[f] === null || args[f] === "");
+    return missing.length ? `Error: ${missing.join(", ")} required for this action.` : null;
+};
 // Backend detail strings beat raw JSON dumps: FastAPI returns
 // {"detail": "..."} (or {"detail": {"message": "..."}}) — surface the
 // human sentence, never the wire body (CLAUDE.md lesson #6).
@@ -81,7 +86,7 @@ const apiDetail = (e) => {
 function createMindMcpServer(client) {
     const server = new mcp_js_1.McpServer({
         name: "mind",
-        version: "0.24.1",
+        version: "0.27.0",
     }, {
         // Returned to every client in the MCP `initialize` response — the first
         // thing any connecting agent sees about how to integrate with MIND.
@@ -91,7 +96,7 @@ function createMindMcpServer(client) {
     // The full integration playbook, readable on demand by any MCP client.
     server.registerResource("integration-guide", "mind://integration-guide", {
         title: "MIND Integration Guide",
-        description: "Complete playbook for integrating any AI agent with MIND — the three integration paths (MCP server, OpenClaw plugin, REST API), authentication, the session protocol, all 23 tools, REST endpoint mapping, and common recipes.",
+        description: "Complete playbook for integrating any AI agent with MIND — the three integration paths (MCP server, OpenClaw plugin, REST API), authentication, the session protocol, all 45 tools, REST endpoint mapping, and common recipes.",
         mimeType: "text/markdown",
     }, async (uri) => ({
         contents: [
@@ -102,10 +107,105 @@ function createMindMcpServer(client) {
             },
         ],
     }));
+    // ─── mind://agent-standard ──────────────────────────────
+    // The full MIND Agent Operating Standard (AGENTS.md, verbatim — see
+    // AGENT_STANDARD_MD in ./integration-guide.ts for provenance and the
+    // refresh recipe). SERVER_INSTRUCTIONS names this resource as mandatory
+    // reading in its "═══ MANDATORY PROTOCOLS ═══" section so an unauthenticated
+    // client sees the pointer even before it can read this resource.
+    server.registerResource("agent-standard", "mind://agent-standard", {
+        title: "The MIND Agent Operating Standard",
+        description: "The full, binding operating constitution for a MIND-connected agent (AGENTS.md, verbatim) — Law Zero, the boot protocol, session sync, the inactivity and termination protocols, the action-time gates, the sense catalog, and the memory contract. SERVER_INSTRUCTIONS names this as mandatory reading; this resource is the complete text.",
+        mimeType: "text/markdown",
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "text/markdown",
+                text: integration_guide_js_1.AGENT_STANDARD_MD,
+            },
+        ],
+    }));
+    // ─── sync-local-docs-to-mind prompt ─────────────────────
+    // Standard prompt shipped WITH the server so any connected agent can back
+    // up the user's durable local documents into MIND without being taught
+    // the procedure from scratch. Body lives in integration-guide.ts beside
+    // SERVER_INSTRUCTIONS and INTEGRATION_GUIDE so all shipped copy is in one
+    // place. MCP prompt arguments are always strings.
+    server.registerPrompt("sync-local-docs-to-mind", {
+        title: "Sync local documents into MIND",
+        description: "Back up every durable document on this machine into the user's MIND, skipping code, junk and secrets. Safe by default: reports what it would upload before uploading anything.",
+        argsSchema: {
+            root: zod_1.z.string().optional().describe("Directory to scan. Default: the current working directory."),
+            dry_run: zod_1.z
+                .string()
+                .optional()
+                .describe('"true" (default) reports the plan without writing. "false" performs the upload.'),
+            since: zod_1.z.string().optional().describe("Only consider files modified after this ISO date."),
+        },
+    }, async ({ root, dry_run, since }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: (0, integration_guide_js_1.buildSyncLocalDocsPrompt)({ root, dry_run, since }),
+                },
+            },
+        ],
+    }));
+    // ─── sync-agent-session prompt ───────────────────────────
+    // Standard prompt shipped WITH the server so any connected agent can adopt
+    // the AGENT SESSION PROTOCOL (see integration-guide.ts) without being
+    // taught the procedure from scratch. Body lives in integration-guide.ts
+    // beside SERVER_INSTRUCTIONS and buildSyncLocalDocsPrompt so all shipped
+    // copy is in one place — see AGENT_SESSION_PROTOCOL_BODY there, which is
+    // also embedded verbatim in SERVER_INSTRUCTIONS and (compact) in the
+    // mind_sessions tool description below, so a client that only reads tool
+    // descriptions still follows it.
+    server.registerPrompt("sync-agent-session", {
+        title: "Adopt the Agent Session Protocol",
+        description: "Log this agent's live session into MIND Chat → Agents so Anthony can read and reply to it. Returns the full open/append/close/handoff protocol, addressed to your runtime.",
+        argsSchema: {
+            runtime: zod_1.z.string().optional().describe('Your runtime name, e.g. "claude-code", "codex", "cursor". Default: "your runtime".'),
+            source_key: zod_1.z.string().optional().describe('The MIND Chat sidebar toggle you were assigned, e.g. "claude-code-1". Default: "your-source-key".'),
+        },
+    }, async ({ runtime, source_key }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: (0, integration_guide_js_1.buildSyncAgentSessionPrompt)({ runtime, source_key }),
+                },
+            },
+        ],
+    }));
+    // ─── adopt-agent-standard prompt ─────────────────────────
+    // Same content as the mind://agent-standard resource (AGENT_STANDARD_MD —
+    // see integration-guide.ts for provenance and the refresh recipe), offered
+    // as a prompt for clients that call prompts/get rather than reading MCP
+    // resources. SERVER_INSTRUCTIONS points every connecting agent at whichever
+    // of the two ("the resource ... or the adopt-agent-standard prompt") its
+    // host actually supports.
+    server.registerPrompt("adopt-agent-standard", {
+        title: "Adopt the MIND Agent Operating Standard",
+        description: "Returns the full MIND Agent Operating Standard (AGENTS.md, verbatim) — Law Zero, the boot protocol, session sync, the inactivity and termination protocols, the action-time gates, the sense catalog, and the memory contract. Read this before acting on behalf of an owner for the first time.",
+    }, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: integration_guide_js_1.AGENT_STANDARD_MD,
+                },
+            },
+        ],
+    }));
     // ─── mind_query ─────────────────────────────────────────
     // Semantic search across the user's knowledge graph.
     // Replaces flat MEMORY.md — returns only relevant memories.
-    server.tool("mind_query", "Search your MIND knowledge graph. Returns RETRIEVED CONTEXT from the graph — documents, entries, entities and relationships — NOT a finished answer. YOU must read that context and write the answer yourself. Does not use MIND's LLM and costs 0 credits. Use this BEFORE making decisions — MIND is your memory. (Pass retrieve_only=false to have MIND synthesize the answer instead, which spends credits.)", {
+    server.tool("mind_query", "Search the user's MIND knowledge graph — their persistent memory of people, projects, decisions, outcomes and history. Returns RETRIEVED CONTEXT for YOU to read and synthesize — documents, entries, entities and relationships — NOT a finished answer. Does not use MIND's LLM and costs 0 credits. Call this before asserting anything about the user's world, and before saying something does not exist. (Pass retrieve_only=false to have MIND's own LLM write the answer instead, which spends credits.)\n\nHOW TO ASK — this changes answer quality more than any parameter. Ask a rich, specific, full-sentence question; \"what is X\" retrieves poorly. Best results come from retrieve-then-write in one ask: \"Find everything about X, Y and Z, then write <deliverable> in this shape: <template>. Use only what you found; mark anything missing as unknown and do not invent it.\" Name the thing you expect to find — a document title, a person, a project, a date range. If the first answer is thin, change the QUESTION, not the mode — chain a narrower ask.\n\nPICKING A MODE (mechanical): naive reads document text only — best for recalling an exact passage or wording. local walks a named entity and its immediate graph neighbours — best for one specific person, company or thing. global reasons over relationships and themes across the whole graph — best for cross-cutting patterns. hybrid combines local+global graph reasoning but reads no raw document text. mix adds raw document text on top of hybrid and is the most complete; reach for it when hybrid feels thin. hybrid is the default — drop to naive/local/global only when you specifically need that narrower lens.\n\nNEGATIVES ARE THE HIGHEST-RISK ANSWER. An empty or thin result means your query missed — it is never proof the thing does not exist. Before reporting that something is absent, re-ask with different wording and say what you searched.", {
         query: zod_1.z.string().describe("What to search for in your knowledge graph"),
         mode: zod_1.z
             .enum(["mix", "hybrid", "global", "local", "naive"])
@@ -164,7 +264,7 @@ function createMindMcpServer(client) {
     // ─── mind_remember ──────────────────────────────────────
     // Store/manage content in the knowledge graph. Auto-categorized by type.
     // Enhanced: now supports create, delete, search, get, list actions.
-    server.tool("mind_remember", "Store and manage content in your MIND knowledge graph. Use for facts, decisions, learnings, research, notes — anything worth remembering. Auto-categorized. Always log outcomes here after completing tasks. Supports create (default), delete, search, get, and list.\n\n⚠️ PRIVATE vs PUBLIC: `document` and `entry` are PRIVATE to the user's knowledge graph. `feed_post` is a PUBLIC social-media post that appears on the user's public feed for everyone to see. Default to `entry` for all agent outcomes, logs, decisions, and research. NEVER use `feed_post` unless the user explicitly says \"post\", \"share\", \"tweet\", \"feed\", or \"thought to my feed\" — deploy logs, PR notes, work outcomes, and agent activity belong in `entry`, NOT on the public feed.\n\nTitle rule: lessons are titled 'Lesson - Failure - <behavior>' / 'Lesson - Behavior - <behavior>' / 'Lesson - Win - <behavior>'; never put '/' or parentheses in a title, the card is derived from it.", {
+    server.tool("mind_remember", "Store and manage content in your MIND knowledge graph. Use for facts, decisions, learnings, research, notes — anything worth remembering. Auto-categorized. Always log outcomes here after completing tasks. Supports create (default), delete, search, get, and list.\n\n⚠️ PRIVATE vs PUBLIC: `document` and `entry` are PRIVATE to the user's knowledge graph. `feed_post` is a PUBLIC social-media post that appears on the user's public feed for everyone to see. Default to `entry` for all agent outcomes, logs, decisions, and research. NEVER use `feed_post` unless the user explicitly says \"post\", \"share\", \"tweet\", \"feed\", or \"thought to my feed\" — deploy logs, PR notes, work outcomes, and agent activity belong in `entry`, NOT on the public feed.\n\nTitle rule: lessons are titled 'Lesson - Failure - <behavior>' / 'Lesson - Behavior - <behavior>' / 'Lesson - Win - <behavior>'; never put '/' or parentheses in a title, the card is derived from it.\n\nWRITE FOR THE AGENT WHO WILL SEARCH FOR THIS LATER — retrieval quality is decided here, not at query time. State facts in the words someone will later search for. Put the entity name in the first sentence. Inline dates, ids, file paths and numbers rather than saying \"the PR\" or \"yesterday\" — a note that only says \"fixed it\" is unfindable. If this supersedes an earlier note, say so explicitly and name what it replaces, so the older fact can be closed off instead of silently competing with this one.", {
         action: zod_1.z
             .enum(["create", "delete", "search", "get", "list"])
             .optional()
@@ -352,15 +452,28 @@ function createMindMcpServer(client) {
     // ─── mind_folders ───────────────────────────────────────
     // Organize documents into folders. Folders are a presentation layer — the
     // knowledge graph still indexes every document regardless of folder.
-    server.tool("mind_folders", "Organize your MIND documents into folders. Folders are a presentation layer — the knowledge graph still indexes and retrieves across every document regardless of folder. Use mind_remember to create a document, then mind_folders move_documents to file it. Actions: list, create, rename, move, delete, move_documents, set_hint (set the agent-routing hint read by mind_folder_suggest).", {
+    server.tool("mind_folders", "Organize your MIND documents into folders. Folders are a presentation layer — the knowledge graph still indexes and retrieves across every document regardless of folder. Use mind_remember to create a document, then mind_folders move_documents to file it. Actions: list, create, rename, move, delete, move_documents, set_hint, secure, unsecure, unlock, reset_request, reset (Secure Folders — password-gate a folder).", {
         action: zod_1.z
-            .enum(["list", "create", "rename", "move", "delete", "move_documents", "set_hint"])
-            .describe("list (all folders + counts + routing hints), create (new folder; pass routing_hint to enable agent-routing), rename (change a folder's name), move (re-nest a folder), delete (remove a folder — its documents and subfolders move up a level, nothing is deleted), move_documents (file documents into a folder), set_hint (write/clear the routing_hint that mind_folder_suggest reads)"),
+            .enum([
+            "list",
+            "create",
+            "rename",
+            "move",
+            "delete",
+            "move_documents",
+            "set_hint",
+            "secure",
+            "unsecure",
+            "unlock",
+            "reset_request",
+            "reset",
+        ])
+            .describe("list (all folders + counts + routing hints + secure/locked flags), create (new folder; pass routing_hint to enable agent-routing), rename (change a folder's name), move (re-nest a folder), delete (remove a folder — its documents and subfolders move up a level, nothing is deleted), move_documents (file documents into a folder), set_hint (write/clear the routing_hint that mind_folder_suggest reads), secure (password-gate folder_id — pass passphrase; changing an existing passphrase needs an active unlock first), unsecure (turn off secure mode — needs an active unlock), unlock (verify passphrase, mints a 15-minute unlock kept in memory for this session and sent on every later call), reset_request (email a one-time reset link to the account email), reset (complete a reset — pass token + new_passphrase)"),
         name: zod_1.z.string().optional().describe("Folder name — required for create and rename"),
         folder_id: zod_1.z
             .string()
             .optional()
-            .describe("Folder id — the folder to rename/move/delete/set_hint, or the destination for move_documents (omit or pass 'root' to file documents at the top level)"),
+            .describe("Folder id — the folder to rename/move/delete/set_hint/secure/unsecure/unlock/reset_request/reset, or the destination for move_documents (omit or pass 'root' to file documents at the top level)"),
         parent_id: zod_1.z
             .string()
             .optional()
@@ -373,7 +486,23 @@ function createMindMcpServer(client) {
             .string()
             .optional()
             .describe("Free-text instruction answering \"when should MIND save things to this folder?\". Read by mind_folder_suggest to LLM-route new content. Pass on create to set up-front; pass on set_hint to update. Pass empty string to clear (disables the folder from auto-routing)."),
-    }, async ({ action, name, folder_id, parent_id, doc_ids, routing_hint }) => {
+        passphrase: zod_1.z
+            .string()
+            .optional()
+            .describe("Folder passphrase — required for secure and unlock"),
+        new_passphrase: zod_1.z
+            .string()
+            .optional()
+            .describe("New passphrase — required for reset"),
+        token: zod_1.z
+            .string()
+            .optional()
+            .describe("One-time reset token from the reset email — required for reset"),
+        unlock_token: zod_1.z
+            .string()
+            .optional()
+            .describe("Pass the exact `unlock_token` string returned by a prior 'unlock' call here to carry a 15-minute unlock into a later 'secure' (passphrase change) or 'unsecure' call. Not needed for the first time a folder is secured, and not used by list/create/rename/move/delete/move_documents/set_hint/unlock/reset_request/reset. This stdio server keeps unlock tokens in memory for the whole session and normally attaches them automatically (see 'unlock'), so passing this explicitly is usually redundant — but when supplied it takes precedence over the remembered token, so the same request shape works on both this server and the hosted MCP."),
+    }, async ({ action, name, folder_id, parent_id, doc_ids, routing_hint, passphrase, new_passphrase, token, unlock_token }) => {
         try {
             switch (action) {
                 case "list": {
@@ -393,7 +522,8 @@ function createMindMcpServer(client) {
                         const parent = f.parent_id ? byId.get(f.parent_id)?.name ?? "?" : "(top level)";
                         const hint = (f.routing_hint || "").trim();
                         const hintTail = hint ? ` · hint: ${hint.length > 80 ? hint.slice(0, 80) + "…" : hint}` : "";
-                        return `• ${f.name} — ${f.document_count ?? 0} doc(s) · id: ${f.id} · parent: ${parent}${hintTail}`;
+                        const secureTail = f.secure ? (f.locked ? " · 🔒 secure (locked)" : " · 🔓 secure (unlocked)") : "";
+                        return `• ${f.name} — ${f.document_count ?? 0} doc(s) · id: ${f.id} · parent: ${parent}${hintTail}${secureTail}`;
                     });
                     return {
                         content: [
@@ -487,6 +617,73 @@ function createMindMcpServer(client) {
                         ],
                     };
                 }
+                case "secure": {
+                    if (!folder_id)
+                        throw new Error("'folder_id' is required to secure a folder");
+                    if (!passphrase)
+                        throw new Error("'passphrase' is required to secure a folder");
+                    const res = await client.secureFolder(folder_id, passphrase, unlock_token);
+                    return {
+                        content: [
+                            { type: "text", text: `Folder ${res.folder_id} is now secure. Unlock it with action 'unlock' before reading its contents.` },
+                        ],
+                    };
+                }
+                case "unsecure": {
+                    if (!folder_id)
+                        throw new Error("'folder_id' is required to unsecure a folder");
+                    const res = await client.unsecureFolder(folder_id, unlock_token);
+                    client.clearSecureFolderUnlockToken(folder_id);
+                    return {
+                        content: [{ type: "text", text: `Folder ${res.folder_id} is no longer secure.` }],
+                    };
+                }
+                case "unlock": {
+                    if (!folder_id)
+                        throw new Error("'folder_id' is required to unlock a folder");
+                    if (!passphrase)
+                        throw new Error("'passphrase' is required to unlock a folder");
+                    const res = await client.unlockFolder(folder_id, passphrase);
+                    client.setSecureFolderUnlockToken(folder_id, res.unlock_token);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Unlocked. Expires at ${res.expires_at} (15 minutes) — every mind_query / mind_folders / document call this session will see inside it until then.`,
+                            },
+                        ],
+                    };
+                }
+                case "reset_request": {
+                    if (!folder_id)
+                        throw new Error("'folder_id' is required to request a passphrase reset");
+                    const res = await client.requestFolderReset(folder_id);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: res.status === "sent"
+                                    ? `Reset email sent to the account's email address (expires in 15 minutes).`
+                                    : `Reset requested, but email delivery is not configured on this deployment.`,
+                            },
+                        ],
+                    };
+                }
+                case "reset": {
+                    if (!folder_id)
+                        throw new Error("'folder_id' is required to reset a passphrase");
+                    if (!token)
+                        throw new Error("'token' (from the reset email) is required to reset a passphrase");
+                    if (!new_passphrase)
+                        throw new Error("'new_passphrase' is required to reset a passphrase");
+                    const res = await client.resetFolder(folder_id, token, new_passphrase);
+                    client.clearSecureFolderUnlockToken(folder_id);
+                    return {
+                        content: [
+                            { type: "text", text: `Passphrase reset for folder ${res.folder_id}. Unlock it with the new passphrase.` },
+                        ],
+                    };
+                }
                 default:
                     throw new Error(`Unknown action: ${action}`);
             }
@@ -650,7 +847,7 @@ function createMindMcpServer(client) {
     // Get structured always-loaded context.
     // Equivalent to OpenClaw's SOUL.md + USER.md + AGENTS.md bootstrap injection,
     // but backed by the knowledge graph.
-    server.tool("mind_context", "Get your persistent context from MIND — identity, preferences, rules, and recent activity. Returns RETRIEVED CONTEXT (not a finished briefing). YOU synthesize who you are and what matters. Does not use MIND's LLM and costs 0 credits. Call this at the start of every session.", {
+    server.tool("mind_context", "Load the user's persistent context from MIND at session start — identity, preferences, operating rules, current priorities and recent activity. Returns RETRIEVED CONTEXT for YOU to synthesize, NOT a finished briefing. Does not use MIND's LLM and costs 0 credits. Call this at the start of every session.\n\nPass only the `sections` you actually need for the task at hand — a focused payload measurably outperforms the full default set, because the model attends better to fewer, more relevant facts. Every fact carries a date; when two facts conflict, the newer one wins, and say so if you rely on it. An empty `recent` section means nothing was logged, not that nothing happened — follow up with mind_query before assuming a quiet day. This is a snapshot, not the whole graph; for anything specific, follow up with mind_query.", {
         sections: zod_1.z
             .array(zod_1.z.enum(["soul", "user", "rules", "priorities", "recent"]))
             .optional()
@@ -1227,7 +1424,7 @@ function createMindMcpServer(client) {
     // ─── mind_tasks ─────────────────────────────────────────
     // Site-wide tasks: assignable, completable work items that attach to a
     // Life project, a CRM contact, an agent, or stand alone.
-    server.tool("mind_tasks", "Manage site-wide tasks in MIND — assignable, completable, reportable work items. A task can attach to a Life project (parent_type=life_item), a CRM contact (parent_type=contact), an agent (parent_type=agent), or stand alone. Assign tasks to a MIND member, an agent, or an external email. Use action=reports for completion analytics.", {
+    server.tool("mind_tasks", "Manage site-wide tasks — assignable, completable work items that are lighter-weight than a Life project/outcome and simpler than a Kanon checklist item. Reach for mind_tasks for a single actionable to-do (optionally attached to a Life project via parent_type=life_item, a CRM contact via parent_type=contact, or an agent) that needs an owner and a done/not-done state; reach for mind_life when the work is itself a deliverable inside the Focus→Project→Outcome hierarchy, and mind_checklists when you need a multi-item checklist with a progress rollup. Assign tasks to a MIND member, an agent, or an external email. Actions: list/create/get/update/complete/reopen/assign/delete, reports (completion analytics). An empty list means no tasks exist under that filter, not that no work is happening — check mind_life and mind_checklists for the same window before concluding nothing is tracked.", {
         action: zod_1.z
             .enum([
             "list", "create", "get", "update", "complete", "reopen",
@@ -1430,159 +1627,10 @@ function createMindMcpServer(client) {
             };
         }
     });
-    // ─── mind_checklists ────────────────────────────────────
-    // The granular level beneath a Task. Shape: Template → Sections[phase] →
-    // Items. Templates (yours + flagship) instantiate into runs attached to a
-    // task or life item; items are toggled and runs completed (which mirrors the
-    // finished checklist into the knowledge graph).
-    server.tool("mind_checklists", "Manage checklists in MIND — the granular level beneath a Task in the Focus→Project→Outcome→Task→Checklist hierarchy. A checklist attaches to a task (parent_type=task) or a Life item (parent_type=life_item) and groups checkable steps into phase-bucketed sections (pre/run/post). Use list_templates/get_template/create_template for reusable blueprints (including global flagship templates), then create a run from a template_id or inline sections_json, toggle_item to check steps, and complete to finish + mirror it into the knowledge graph.", {
-        action: zod_1.z
-            .enum([
-            "list_templates", "get_template", "create_template",
-            "list", "create", "get", "toggle_item", "complete", "delete",
-        ])
-            .describe("What to do: list_templates/get_template/create_template (blueprints); list/create/get/toggle_item/complete/delete (runs)"),
-        template_id: zod_1.z.string().optional().describe("Template ID — required for get_template; optional on create (instantiate from a template)"),
-        checklist_id: zod_1.z.string().optional().describe("Checklist run ID — required for get/toggle_item/complete/delete"),
-        item_id: zod_1.z.string().optional().describe("Checklist item ID — required for toggle_item"),
-        title: zod_1.z.string().optional().describe("Title (required for create_template; optional for create run)"),
-        description: zod_1.z.string().optional().describe("Template description (create_template)"),
-        parent_type: zod_1.z.string().optional().describe("Attach a run to: task or life_item (required for create + list filter)"),
-        parent_id: zod_1.z.string().optional().describe("ID of the parent task / life item (required for create)"),
-        parent_label: zod_1.z.string().optional().describe("Optional human label for the parent"),
-        sections_json: zod_1.z.string().optional().describe('Inline sections as JSON, e.g. [{"title":"Setup","phase":"pre","items":[{"label":"do x"}]}] — for create_template or an inline create run'),
-    }, async ({ action, template_id, checklist_id, item_id, title, description, parent_type, parent_id, parent_label, sections_json }) => {
-        try {
-            const parseSections = () => {
-                if (!sections_json)
-                    return undefined;
-                const parsed = JSON.parse(sections_json);
-                if (!Array.isArray(parsed))
-                    throw new Error("sections_json must be a JSON array of sections");
-                return parsed;
-            };
-            const fmtTemplate = (t) => {
-                const secCount = (t.sections ?? []).length;
-                const itemCount = (t.sections ?? []).reduce((n, s) => n + (s.items?.length ?? 0), 0);
-                return `• ${t.title}${t.origin === "flagship" ? " ⭐ flagship" : ""} — ${secCount} section(s), ${itemCount} item(s) — id: ${t.template_id}`;
-            };
-            const fmtSections = (sections) => (sections ?? [])
-                .map((s) => {
-                const head = `  [${s.phase}] ${s.title}`;
-                const items = (s.items ?? [])
-                    .map((it) => `    ${it.checked ? "[x]" : "[ ]"} ${it.label} — id: ${it.item_id}`)
-                    .join("\n");
-                return items ? `${head}\n${items}` : head;
-            })
-                .join("\n");
-            const fmtChecklist = (c, withItems = false) => {
-                const p = c.progress ?? { done: 0, total: 0, pct: 0 };
-                const head = `• ${c.title} (${p.done}/${p.total}, ${p.pct}%)` +
-                    `${c.completed_at ? " ✅ complete" : ""}` +
-                    `${c.parent_label ? `, on ${c.parent_label}` : ""} — id: ${c.checklist_id}`;
-                return withItems ? `${head}\n${fmtSections(c.sections ?? [])}` : head;
-            };
-            switch (action) {
-                case "list_templates": {
-                    const result = await client.listChecklistTemplates();
-                    const templates = result.templates ?? [];
-                    if (templates.length === 0) {
-                        return { content: [{ type: "text", text: "No checklist templates found." }] };
-                    }
-                    return {
-                        content: [{
-                                type: "text",
-                                text: `${result.total} template(s):\n` + templates.map(fmtTemplate).join("\n"),
-                            }],
-                    };
-                }
-                case "get_template": {
-                    if (!template_id) {
-                        return { content: [{ type: "text", text: "Error: template_id is required for get_template" }], isError: true };
-                    }
-                    const t = await client.getChecklistTemplate(template_id);
-                    return {
-                        content: [{
-                                type: "text",
-                                text: `${fmtTemplate(t)}${t.description ? `\n${t.description}` : ""}\n${fmtSections(t.sections ?? [])}`,
-                            }],
-                    };
-                }
-                case "create_template": {
-                    if (!title) {
-                        return { content: [{ type: "text", text: "Error: title is required to create a template" }], isError: true };
-                    }
-                    const t = await client.createChecklistTemplate({
-                        title, description, sections: parseSections(),
-                    });
-                    return { content: [{ type: "text", text: `✅ Created template: ${fmtTemplate(t)}` }] };
-                }
-                case "list": {
-                    const result = await client.listChecklists(parent_type, parent_id);
-                    const checklists = result.checklists ?? [];
-                    if (checklists.length === 0) {
-                        return { content: [{ type: "text", text: "No checklists found." }] };
-                    }
-                    return {
-                        content: [{
-                                type: "text",
-                                text: `${result.total} checklist(s):\n` + checklists.map((c) => fmtChecklist(c)).join("\n"),
-                            }],
-                    };
-                }
-                case "create": {
-                    if (!parent_type || !parent_id) {
-                        return { content: [{ type: "text", text: "Error: parent_type and parent_id are required to create a checklist run" }], isError: true };
-                    }
-                    const c = await client.createChecklist({
-                        parent_type, parent_id, parent_label, title,
-                        template_id, sections: parseSections(),
-                    });
-                    return { content: [{ type: "text", text: `✅ Created checklist:\n${fmtChecklist(c, true)}` }] };
-                }
-                case "get": {
-                    if (!checklist_id) {
-                        return { content: [{ type: "text", text: "Error: checklist_id is required for get" }], isError: true };
-                    }
-                    const c = await client.getChecklist(checklist_id);
-                    return { content: [{ type: "text", text: fmtChecklist(c, true) }] };
-                }
-                case "toggle_item": {
-                    if (!checklist_id || !item_id) {
-                        return { content: [{ type: "text", text: "Error: checklist_id and item_id are required for toggle_item" }], isError: true };
-                    }
-                    const c = await client.toggleChecklistItem(checklist_id, item_id);
-                    return { content: [{ type: "text", text: `✅ Toggled item:\n${fmtChecklist(c, true)}` }] };
-                }
-                case "complete": {
-                    if (!checklist_id) {
-                        return { content: [{ type: "text", text: "Error: checklist_id is required for complete" }], isError: true };
-                    }
-                    const c = await client.completeChecklist(checklist_id);
-                    return { content: [{ type: "text", text: `✅ Completed checklist "${c.title}" — mirrored to the knowledge graph.` }] };
-                }
-                case "delete": {
-                    if (!checklist_id) {
-                        return { content: [{ type: "text", text: "Error: checklist_id is required for delete" }], isError: true };
-                    }
-                    await client.deleteChecklist(checklist_id);
-                    return { content: [{ type: "text", text: `🗑️ Deleted checklist ${checklist_id}` }] };
-                }
-                default:
-                    return { content: [{ type: "text", text: `Unknown action: ${action}` }], isError: true };
-            }
-        }
-        catch (err) {
-            return {
-                content: [{ type: "text", text: `mind_checklists error: ${err instanceof Error ? err.message : String(err)}` }],
-                isError: true,
-            };
-        }
-    });
     // ─── mind_crm ───────────────────────────────────────────
     // Read/write contacts, interactions, and activities.
     // Enhanced: delete, get, log_activity, list_activities.
-    server.tool("mind_crm", "Manage contacts and relationships in MIND CRM. Use for tracking people, companies, leads, interaction history, and activity logging.", {
+    server.tool("mind_crm", "Manage contacts and relationships in MIND CRM — the system of record for people, companies, leads and prospects, separate from the knowledge graph's document/entry memory. Reach for this (not mind_query) when you need to create, update, or list a specific contact record, or log/read a dated interaction history — reach for mind_query when you want a synthesized answer about a relationship drawn from everything MIND knows. Actions: list/create/update/delete/get contacts, log_activity (record an interaction), list_activities (interaction history). An empty list or 'No contacts found' means no CRM records exist yet, not that the person is unknown to MIND — check mind_query before concluding a relationship is undocumented.", {
         action: zod_1.z
             .enum(["list", "create", "update", "delete", "get", "log_activity", "list_activities"])
             .describe("What to do: list/create/update/delete/get contacts, log_activity (record interaction), list_activities (view interaction history)"),
@@ -1734,7 +1782,7 @@ function createMindMcpServer(client) {
     // ─── mind_graph ─────────────────────────────────────────
     // Get graph statistics, diagnostics, and labels.
     // Enhanced: action param with stats (default), diagnostics, labels.
-    server.tool("mind_graph", "Get MIND knowledge graph statistics, diagnostics, and label details. Use to check graph health, growth, and entity breakdown.", {
+    server.tool("mind_graph", "Get MIND knowledge graph statistics and diagnostics — entity/relationship counts, growth, label breakdown, and health status. Use this for a quantitative pulse-check on the graph itself (e.g. before a large ingestion, or to cite \"MIND has N entities\"); it does not search or retrieve content, so for facts, people or history use mind_query instead. Actions: stats (default overview), diagnostics (health check), labels (entity type breakdown). A low or zero count can mean an empty tenant OR a scoping/auth issue reading the wrong account — verify with mind_query on a known fact before treating a small graph as evidence nothing has been logged.", {
         action: zod_1.z
             .enum(["stats", "diagnostics", "labels"])
             .optional()
@@ -2190,7 +2238,7 @@ function createMindMcpServer(client) {
     // ═══════════════════════════════════════════════════════════
     // ─── mind_sense ─────────────────────────────────────────
     // MINDsense emotional intelligence layer.
-    server.tool("mind_sense", "Access MINDsense emotional intelligence — the user's living emotional state, signal history, emotional timeline, and KG entity weights. Use this to understand how the user is feeling and what emotionally significant events have occurred.", {
+    server.tool("mind_sense", "Access MINDsense — the user's live emotional state, signal history, spikes and emotionally-weighted entities, derived from valence/arousal signal processing rather than asked directly. Reach for this before a sensitive conversation, when deciding how hard to push on a topic, or when asked \"how am I feeling\" / \"read the room\"; reach for mind_query instead for factual history about what happened. Actions: state (current snapshot), signals (recent raw signals), timeline (historical trend), kg_weights (which entities carry emotional weight), spikes (notable events, some unacknowledged), acknowledge (clear a spike), summary (AI-written recap). No signals in the lookback window means nothing was captured in that period, not that the user was neutral — widen `days` before concluding calm.", {
         action: zod_1.z
             .enum(["state", "signals", "timeline", "kg_weights", "spikes", "acknowledge", "summary"])
             .describe("Action: state (current emotion), signals (recent signals), timeline (historical), kg_weights (emotionally weighted entities), spikes (recent spikes), acknowledge (ack a spike), summary (AI emotional summary)"),
@@ -2289,7 +2337,7 @@ function createMindMcpServer(client) {
     });
     // ─── mind_research ──────────────────────────────────────
     // Deep research agent jobs.
-    server.tool("mind_research", "Launch and manage deep research jobs. Research runs autonomously — it gathers information, analyzes it, and stores findings in the knowledge graph. Use for competitive analysis, market research, technical deep-dives.", {
+    server.tool("mind_research", "Launch and track autonomous deep-research jobs — MIND gathers sources, synthesizes them, and writes findings into the knowledge graph as it goes. Use this for a genuinely open-ended investigation (competitive analysis, market research, a technical deep-dive) that would take multiple search rounds; use mind_query for a quick fact lookup instead. Actions: start (launch, returns job_id), status (poll progress and read the summary once complete), list (all jobs). A job still 'running' has no findings yet — poll status again rather than treating a thin or missing summary as a negative result; once complete, read the findings via mind_query rather than re-reading the raw job.", {
         action: zod_1.z
             .enum(["start", "status", "list"])
             .describe("Action: start (launch research), status (check job progress), list (view all jobs)"),
@@ -2356,7 +2404,7 @@ function createMindMcpServer(client) {
     });
     // ─── mind_train ─────────────────────────────────────────
     // Self-training and chat-to-KG sessions.
-    server.tool("mind_train", "Train MIND's knowledge graph. Start guided training sessions to teach it about yourself, or save existing chat conversations into the knowledge graph for persistent memory.", {
+    server.tool("mind_train", "Run guided or freeform sessions that teach MIND about the user through conversation, or extract an existing chat transcript into the knowledge graph as durable memories — this is how unstructured conversation becomes queryable facts, distinct from mind_remember (one explicit fact) or mind_query (reading facts back). Actions: start (begin a session, optionally typed: basics/network/expertise/history/goals/freeform), chat (send the next training message), status (progress + items learned so far), list_sessions, pause/resume, save_chat (extract a chat session_id into the graph). 'Items learned: 0' or an empty list_sessions means no training has happened yet in this account, not that the user has nothing worth learning — check mind_query for what's already there before starting a duplicate session.", {
         action: zod_1.z
             .enum(["start", "chat", "status", "list_sessions", "pause", "resume", "save_chat"])
             .describe("Action: start (begin training), chat (send message), status (check progress), list_sessions (view past), pause/resume (control session), save_chat (save chat to KG)"),
@@ -2679,7 +2727,7 @@ function createMindMcpServer(client) {
     });
     // ─── mind_profile ───────────────────────────────────────
     // Profile, prompts, and model preferences.
-    server.tool("mind_profile", "Manage your MIND profile, AI prompt settings, and model preferences. Update your bio, set custom system prompts for chat and thought generation, and choose your preferred LLM model.", {
+    server.tool("mind_profile", "Manage the user's own MIND profile, public-chat prompt, and model preferences — bio, display name, the system prompt used at their public /m/{username} chat surface, and their default LLM model. This is account/identity settings, not knowledge-graph content — for what MIND knows about the user, use mind_context or mind_query instead. Actions: get/update (profile fields), get_chat_prompt/set_chat_prompt, get_thought_prompt/set_thought_prompt, get_model/set_model/list_models. 'No custom prompt set' on get_chat_prompt/get_thought_prompt means the platform default applies, not that chat is unconfigured — call list_models before set_model if unsure a model id is valid, since an unrecognized id fails at the provider, not here.", {
         action: zod_1.z
             .enum([
             "get", "update",
@@ -2799,7 +2847,7 @@ function createMindMcpServer(client) {
     });
     // ─── mind_insights ──────────────────────────────────────
     // ALE insights and analytics.
-    server.tool("mind_insights", "Access insights from MIND's Autonomous Learning Engine — patterns detected in your knowledge graph, weekly summaries, and proactive intelligence. Also trigger on-demand analysis.", {
+    server.tool("mind_insights", "Read what MIND's Autonomous Learning Engine has already noticed about the user without being asked — patterns, weekly summaries, and proactive intelligence generated in the background — or trigger a fresh analysis pass on demand. Reach for this when the user asks \"what have you noticed\" or \"anything I'm missing\"; reach for mind_query when you already know what you're looking for. Actions: list (recent insights), unread_count, view (read one, marks it seen), feedback (rate helpful/not_helpful — tunes future insights), analyze (trigger a new pass now), weekly_summary, context (raw ALE state). 'No insights available' means the engine hasn't generated any yet for this account or period — call analyze to trigger a fresh pass rather than assuming nothing is happening in the graph.", {
         action: zod_1.z
             .enum(["list", "unread_count", "view", "feedback", "analyze", "weekly_summary", "context"])
             .describe("Action: list (recent insights), unread_count, view (mark seen), feedback (rate), analyze (trigger analysis), weekly_summary, context (ALE context)"),
@@ -2889,7 +2937,7 @@ function createMindMcpServer(client) {
     });
     // ─── mind_automate ──────────────────────────────────────
     // Automations and triggers.
-    server.tool("mind_automate", "Create and manage automations in MIND — scheduled workflows, event triggers, and rules that run automatically. Connect CRM events to actions, schedule recurring tasks, and build custom pipelines.", {
+    server.tool("mind_automate", "Create and manage MIND-native automations — scheduled or event-triggered rules that run without a human or agent invoking them each time (e.g. a weekly CRM digest, a webhook that logs an event to a life project). This is for recurring MIND-internal work, not a general task scheduler for external systems. Actions: list/create/update/delete, run_now (fire immediately for testing), history (execution log). `trigger_config`/`action_config` are JSON strings, not objects — pass valid JSON or the call throws. An empty list means no automations are configured in this account yet, not that scheduled work isn't happening elsewhere.", {
         action: zod_1.z
             .enum(["list", "create", "update", "delete", "run_now", "history"])
             .describe("Action: list/create/update/delete automations, run_now (trigger immediately), history (execution log)"),
@@ -3025,7 +3073,7 @@ function createMindMcpServer(client) {
     });
     // ─── mind_notify ────────────────────────────────────────
     // Notifications management.
-    server.tool("mind_notify", "Read and manage MIND notifications — alerts, reminders, insight notifications, and system messages.", {
+    server.tool("mind_notify", "Read and manage the user's MIND notification inbox — alerts, reminders, insight pings, and system messages generated by other MIND features. It is not a way to send a notification yourself. Use this to check what MIND has already surfaced to the user, or to clear it down; for the underlying event (why an insight fired, what an alert refers to) follow up with the originating tool (mind_insights, mind_sense, etc.) or mind_query. Actions: list, mark_read, mark_all_read, stats (total/unread/read counts). 'No notifications' or unread:0 means nothing has been pushed to the inbox — a quiet inbox and a quiet graph are different claims.", {
         action: zod_1.z
             .enum(["list", "mark_read", "mark_all_read", "stats"])
             .describe("Action: list (view notifications), mark_read (single), mark_all_read (all), stats (overview)"),
@@ -3080,6 +3128,207 @@ function createMindMcpServer(client) {
             };
         }
     });
+    // ─── mind_sessions ──────────────────────────────────────
+    // "Agent Sessions in MIND Chat" — logs THIS agent's own live session into
+    // MIND as a tagged Agent Session so Anthony can read the transcript and
+    // reply from MIND Chat → Agents. Backed by
+    // backend/routes/agent_session_routes.py, prefix
+    // /developer/v1/agent-sessions. See the full AGENT SESSION PROTOCOL in
+    // integration-guide.ts (embedded verbatim in SERVER_INSTRUCTIONS and the
+    // sync-agent-session prompt) — the compact version below is repeated here
+    // so a client that only ever reads tool descriptions still gets it.
+    server.tool("mind_sessions", "Log THIS agent's own live session into MIND Chat → Agents, so Anthony can read the transcript and reply — his reply reaches you on your next turn. Distinct from mind_remember (one durable fact) and mind_train (teaching the KG): this is the live, turn-by-turn session log, mirrored into a MIND document when you close it.\n\n" +
+        "PROTOCOL (do this every session): " +
+        "1) CONNECT — as soon as mind_context succeeds, call action=open with source_key (your assigned MIND Chat toggle, e.g. \"claude-code-1\"), external_session_id (your runtime's own session id), runtime, title (first user ask, 6-10 words), machine/cwd/repo/branch/model. If `resumed` is true, read `tail` before answering, and answer everything in `pending_replies` first — those arrived while you were away. " +
+        "2) EVERY TURN — after you finish replying, call action=append with the user's message and your final reply (role user / assistant); tool calls go in as role=tool one-line summaries, never raw payloads. Check `pending_replies` on the response and answer them next turn. action=reply is a shortcut for appending a single assistant-role message when you have no user message to log alongside it. " +
+        "3) IDLE — MIND marks the session idle after 30 minutes with no append; the next append revives it, nothing to do meanwhile. " +
+        "4) TERMINATE — on exit, compaction, or \"done\", call action=close with a summary (what was asked, what shipped with ids/PR numbers, what is still undone); MIND mirrors the transcript into your Sessions folder as a document. " +
+        "5) HANDOFF — to pass the conversation to another agent, call action=handoff with to_source_key=<their toggle>; they see it in their session list with the transcript as context. " +
+        "Never claim a session is synced without the session_id MIND returned. Never log secrets or raw tool payloads.\n\n" +
+        "Actions: open, append, close, list, get, reply (alias for append of one assistant message), inbox (undelivered mind-origin replies), handoff, sources (source_action=list|create|update|delete manages the MIND Chat sidebar toggles — auto-created on first open with an unknown source_key).", {
+        action: zod_1.z
+            .enum(["open", "append", "close", "list", "get", "reply", "inbox", "handoff", "sources"])
+            .describe("Which agent-session operation to perform."),
+        // open
+        source_key: zod_1.z.string().optional().describe("Your assigned MIND Chat sidebar toggle slug, e.g. \"claude-code-1\" — required for open; also filters list; also required for sources action=create (as the new source's key)."),
+        external_session_id: zod_1.z.string().optional().describe("Your runtime's own session id — required for open. Idempotent: opening the same (source_key, external_session_id) again resumes the existing session instead of creating a new one."),
+        runtime: zod_1.z.string().optional().describe("Runtime name, e.g. \"claude-code\", \"codex\", \"cursor\", \"openclaw\", \"grok\", \"n8n\", \"custom\" — open (used if the source is auto-created); sources action=create/update."),
+        source_label: zod_1.z.string().optional().describe("Human-readable label for an auto-created source on open, e.g. \"Claude Code 1\" — defaults to the titlecased source_key if omitted."),
+        title: zod_1.z.string().optional().describe("Session title (first user ask, 6-10 words) — open (initial) or append (updates it)."),
+        machine: zod_1.z.string().optional().describe("Machine identifier — open."),
+        cwd: zod_1.z.string().optional().describe("Working directory — open."),
+        repo: zod_1.z.string().optional().describe("Repository name — open."),
+        branch: zod_1.z.string().optional().describe("Git branch — open."),
+        model: zod_1.z.string().optional().describe("LLM model in use — open."),
+        tags: zod_1.z.array(zod_1.z.string()).optional().describe("Freeform tags — open."),
+        // append / reply
+        session_id: zod_1.z.string().optional().describe("Session id returned by open — required for append/close/get/inbox/handoff."),
+        messages: zod_1.z
+            .array(zod_1.z.object({
+            role: zod_1.z.enum(["user", "assistant", "system", "tool"]),
+            content: zod_1.z.string(),
+            origin: zod_1.z.enum(["agent"]).optional(),
+            meta: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+            created_at: zod_1.z.string().optional(),
+        }))
+            .optional()
+            .describe("Messages to append, in order — required for append. Tool-call messages should be role=tool, one-line summaries only, never raw payloads."),
+        content: zod_1.z.string().optional().describe("Message text — required for reply (appended as a single role=assistant message)."),
+        // close
+        summary: zod_1.z.string().optional().describe("What was asked, what shipped (with ids/PR numbers), what is still undone — close. If omitted, MIND builds one from the transcript."),
+        // list / close (status set) share this field
+        status: zod_1.z.enum(["active", "idle", "ended"]).optional().describe("close: pass \"ended\" to explicitly close (default when summary is given). list: filter sessions by status."),
+        q: zod_1.z.string().optional().describe("Free-text search over title/preview — list."),
+        limit: zod_1.z.number().int().optional().describe("Max results — list (default 30) / get (default 200, messages)."),
+        before: zod_1.z.string().optional().describe("Pagination cursor (last_activity_at) — list."),
+        before_seq: zod_1.z.number().int().optional().describe("Return messages with seq before this value — get."),
+        // handoff
+        to_source_key: zod_1.z.string().optional().describe("Target source's key to hand this session off to — required for handoff."),
+        // sources
+        source_action: zod_1.z.enum(["list", "create", "update", "delete"]).optional().describe("Sub-action for action=sources (default list)."),
+        source_id: zod_1.z.string().optional().describe("Source id — required for sources action=update/delete."),
+        key: zod_1.z.string().optional().describe("New source's key slug — required for sources action=create."),
+        label: zod_1.z.string().optional().describe("Source label, e.g. \"Claude Code 1\" — sources action=create (required) / update."),
+        color: zod_1.z.string().optional().describe("Sidebar chip color — sources action=create/update."),
+        wake_url: zod_1.z.string().optional().describe("Optional push endpoint MIND POSTs {session_id, reply} to (fire-and-forget, 5s timeout) when the user replies — sources action=create/update."),
+        force: zod_1.z.boolean().optional().describe("sources action=delete: also delete the source's sessions instead of failing 409 when sessions exist."),
+    }, async (args) => {
+        const { action } = args;
+        try {
+            switch (action) {
+                case "open": {
+                    const { source_key, external_session_id } = args;
+                    if (!source_key)
+                        return err("Error: 'source_key' is required for open.");
+                    if (!external_session_id)
+                        return err("Error: 'external_session_id' is required for open.");
+                    return ok(await client.openAgentSession({
+                        source_key,
+                        external_session_id,
+                        runtime: args.runtime,
+                        source_label: args.source_label,
+                        title: args.title,
+                        machine: args.machine,
+                        cwd: args.cwd,
+                        repo: args.repo,
+                        branch: args.branch,
+                        model: args.model,
+                        tags: args.tags,
+                    }));
+                }
+                case "append": {
+                    const { session_id, messages } = args;
+                    if (!session_id)
+                        return err("Error: 'session_id' is required for append.");
+                    if (!messages?.length)
+                        return err("Error: 'messages' (at least one) is required for append.");
+                    return ok(await client.appendAgentSession(session_id, messages, args.title));
+                }
+                case "reply": {
+                    const { session_id, content } = args;
+                    if (!session_id)
+                        return err("Error: 'session_id' is required for reply.");
+                    if (!content)
+                        return err("Error: 'content' is required for reply.");
+                    return ok(await client.appendAgentSession(session_id, [{ role: "assistant", content }]));
+                }
+                case "close": {
+                    const { session_id } = args;
+                    if (!session_id)
+                        return err("Error: 'session_id' is required for close.");
+                    return ok(await client.closeAgentSession(session_id, {
+                        summary: args.summary,
+                        status: args.status === "ended" ? "ended" : undefined,
+                    }));
+                }
+                case "list":
+                    return ok(await client.listAgentSessions({
+                        source_key: args.source_key,
+                        status: args.status,
+                        q: args.q,
+                        limit: args.limit,
+                        before: args.before,
+                    }));
+                case "get": {
+                    const { session_id } = args;
+                    if (!session_id)
+                        return err("Error: 'session_id' is required for get.");
+                    return ok(await client.getAgentSession(session_id, {
+                        limit: args.limit,
+                        before_seq: args.before_seq,
+                    }));
+                }
+                case "inbox": {
+                    const { session_id } = args;
+                    if (!session_id)
+                        return err("Error: 'session_id' is required for inbox.");
+                    return ok(await client.agentSessionInbox(session_id));
+                }
+                case "handoff": {
+                    const { session_id, to_source_key } = args;
+                    if (!session_id)
+                        return err("Error: 'session_id' is required for handoff.");
+                    if (!to_source_key)
+                        return err("Error: 'to_source_key' is required for handoff.");
+                    return ok(await client.handoffAgentSession(session_id, to_source_key));
+                }
+                case "sources": {
+                    const sourceAction = args.source_action ?? "list";
+                    switch (sourceAction) {
+                        case "list":
+                            return ok(await client.listAgentSessionSources());
+                        case "create": {
+                            const { key, label, runtime } = args;
+                            if (!key)
+                                return err("Error: 'key' is required for sources action=create.");
+                            if (!label)
+                                return err("Error: 'label' is required for sources action=create.");
+                            if (!runtime)
+                                return err("Error: 'runtime' is required for sources action=create.");
+                            return ok(await client.createAgentSessionSource({
+                                key,
+                                label,
+                                runtime,
+                                color: args.color,
+                                wake_url: args.wake_url,
+                            }));
+                        }
+                        case "update": {
+                            const { source_id } = args;
+                            if (!source_id)
+                                return err("Error: 'source_id' is required for sources action=update.");
+                            return ok(await client.updateAgentSessionSource(source_id, {
+                                label: args.label,
+                                runtime: args.runtime,
+                                color: args.color,
+                                wake_url: args.wake_url,
+                            }));
+                        }
+                        case "delete": {
+                            const { source_id } = args;
+                            if (!source_id)
+                                return err("Error: 'source_id' is required for sources action=delete.");
+                            await client.deleteAgentSessionSource(source_id, args.force);
+                            return ok({ ok: true, source_id });
+                        }
+                        default: {
+                            const _exhaustive = sourceAction;
+                            return err(`Unknown source_action: ${_exhaustive}`);
+                        }
+                    }
+                }
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_sessions ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_sessions error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
     // ─── MIND Front Layer (typed-document taxonomy / "MIND Sense") ─────────────
     // Three tools that expose the 16 typed-document templates and the typed-save flow.
     // The same templates power the developer API endpoints under /v1/templates.
@@ -5007,6 +5256,1317 @@ function createMindMcpServer(client) {
             return err(`mind_trader error: ${e instanceof Error ? e.message : String(e)}`);
         }
     });
+    // ═══════════════════════════════════════════════════════════════════
+    // FULL-COVERAGE APP TOOLS (v0.25.0) — mind_mindmap, mind_moneymind,
+    // mind_budget, mind_sheets, mind_email, mind_checklists, mind_sign,
+    // mind_invoices, mind_books, mind_timer, mind_forms, mind_library
+    // ═══════════════════════════════════════════════════════════════════
+    // ─── mind_mindmap ───────────────────────────────────────
+    server.tool("mind_mindmap", "MIND Mind Map — visual mind-mapping canvases at m-i-n-d.ai/#/mind-map. Actions: list, get, create, update, delete, get_shared (read a publicly shared map, no auth needed). Sharing, collaborators and AI generation from a prompt or project stay in the web app at m-i-n-d.ai/#/mind-map.", {
+        action: zod_1.z
+            .enum(["list", "get", "create", "update", "delete", "get_shared"])
+            .describe("Which mind-map operation to perform."),
+        map_id: zod_1.z.string().optional().describe("Mind map id — required for get/update/delete."),
+        name: zod_1.z.string().optional().describe("Map name/title — create/update (defaults to 'Untitled map' on create)."),
+        data: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("Map contents: {nodes, edges, camera, defaults, nextId, notes} — create/update."),
+        thumbnail: zod_1.z.string().optional().describe("Base64/data-url thumbnail image — create/update."),
+        share_id: zod_1.z.string().optional().describe("Public share id — required for get_shared."),
+    }, async (args) => {
+        const { action } = args;
+        try {
+            switch (action) {
+                case "list":
+                    return ok(await client.call("GET", "/mindmaps", args));
+                case "get": {
+                    const m = need(args, ["map_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", "/mindmaps/{map_id}", args, ["map_id"]));
+                }
+                case "create":
+                    return ok(await client.call("POST", "/mindmaps", args, [], [], ["name", "data", "thumbnail"]));
+                case "update": {
+                    const m = need(args, ["map_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PUT", "/mindmaps/{map_id}", args, ["map_id"], [], ["name", "data", "thumbnail"]));
+                }
+                case "delete": {
+                    const m = need(args, ["map_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", "/mindmaps/{map_id}", args, ["map_id"]));
+                }
+                case "get_shared": {
+                    const m = need(args, ["share_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", "/mindmaps/shared/{share_id}", args, ["share_id"]));
+                }
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_mindmap ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_mindmap error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_moneymind ─────────────────────────────────────
+    server.tool("mind_moneymind", "MoneyMIND — personal finance at m-i-n-d.ai/#/moneyMIND: accounts, transactions, categories, budgets, recurring bills, net worth, goals, credit, alerts, bill negotiation, bank statements. Actions: overview, accounts_list, account_create, account_update, account_delete, transactions_list, transaction_create, transaction_update, transaction_split, spending_summary, categories_list, category_create, rules_list, rule_create, rule_delete, budgets_list, budget_set, budget_delete, recurring_list, recurring_update, recurring_cancel, networth, networth_manual, networth_snapshot, goals_list, goal_create, goal_update, goal_delete, credit, alerts_config, alerts_config_set, alerts_feed, negotiate_list, negotiate_create, statements_list, statement_get, statement_delete. Note: rule_create's REST body field 'action' is exposed here as `rule_action` (an 'action' field would collide with this tool's own dispatch key).", {
+        action: zod_1.z
+            .enum([
+            "overview", "accounts_list", "account_create", "account_update", "account_delete",
+            "transactions_list", "transaction_create", "transaction_update", "transaction_split",
+            "spending_summary", "categories_list", "category_create", "rules_list", "rule_create", "rule_delete",
+            "budgets_list", "budget_set", "budget_delete", "recurring_list", "recurring_update", "recurring_cancel",
+            "networth", "networth_manual", "networth_snapshot", "goals_list", "goal_create", "goal_update", "goal_delete",
+            "credit", "alerts_config", "alerts_config_set", "alerts_feed", "negotiate_list", "negotiate_create",
+            "statements_list", "statement_get", "statement_delete",
+        ])
+            .describe("Which MoneyMIND operation to perform."),
+        account_id: zod_1.z.string().optional().describe("Account id — account_update/account_delete; also filters transactions_list."),
+        name: zod_1.z.string().optional().describe("Display name — account_create/category_create/goal_create/goal_update/networth_manual."),
+        type: zod_1.z.enum(["checking", "savings", "credit", "loan", "investment", "manual"]).optional().describe("Account type — account_create (default 'manual')."),
+        balance_cents: zod_1.z.number().int().optional().describe("Balance in cents — account_create/account_update."),
+        institution: zod_1.z.string().optional().describe("Bank/institution name — account_create/account_update."),
+        mask: zod_1.z.string().optional().describe("Last-4 account mask — account_create."),
+        currency: zod_1.z.string().optional().describe("ISO currency code — account_create (default 'USD')."),
+        hidden: zod_1.z.boolean().optional().describe("Hide from overview — account_update/recurring_update."),
+        txn_id: zod_1.z.string().optional().describe("Transaction id — transaction_update/transaction_split."),
+        from: zod_1.z.string().optional().describe("Start date (YYYY-MM-DD) — transactions_list filter."),
+        to: zod_1.z.string().optional().describe("End date (YYYY-MM-DD) — transactions_list filter."),
+        category: zod_1.z.string().optional().describe("Category name — transactions_list filter / transaction_create / transaction_update; also the path segment for budget_set/budget_delete."),
+        search: zod_1.z.string().optional().describe("Free-text search — transactions_list filter."),
+        limit: zod_1.z.number().int().optional().describe("Max results — transactions_list."),
+        cursor: zod_1.z.string().optional().describe("Pagination cursor — transactions_list."),
+        recurring: zod_1.z.boolean().optional().describe("Filter to recurring transactions — transactions_list."),
+        excluded: zod_1.z.boolean().optional().describe("Filter by excluded flag — transactions_list filter; also set on transaction_update."),
+        date: zod_1.z.string().optional().describe("Transaction date (YYYY-MM-DD) — required for transaction_create."),
+        amount_cents: zod_1.z.number().int().optional().describe("Amount in cents — required for transaction_create."),
+        merchant: zod_1.z.string().optional().describe("Merchant name — transaction_create (required)/transaction_update."),
+        notes: zod_1.z.string().optional().describe("Free-text notes — transaction_update/negotiate context fields elsewhere."),
+        splits: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{category, amount_cents}] — transaction_split (required) / transaction_update."),
+        period: zod_1.z.string().optional().describe("Summary period, e.g. 'month' — spending_summary (default 'month')."),
+        anchor: zod_1.z.string().optional().describe("Anchor date (YYYY-MM-DD) for spending_summary."),
+        group: zod_1.z.string().optional().describe("Category group — category_create (default 'Other')."),
+        icon: zod_1.z.string().optional().describe("Icon name — category_create."),
+        color: zod_1.z.string().optional().describe("Color hex/token — category_create."),
+        match: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("{field: 'merchant'|'raw_name'|'amount_cents', op: 'contains'|'equals'|'starts_with'|'gt'|'lt', value} — required for rule_create."),
+        rule_action: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("{set_category?, exclude?, assign_bill?} — required for rule_create. Maps to the REST body field named 'action'."),
+        rule_id: zod_1.z.string().optional().describe("Rule id — required for rule_delete."),
+        limit_cents: zod_1.z.number().int().optional().describe("Monthly limit in cents — required for budget_set."),
+        rollover: zod_1.z.boolean().optional().describe("Roll unused budget forward — budget_set."),
+        recurring_id: zod_1.z.string().optional().describe("Recurring bill id — recurring_update/recurring_cancel."),
+        status: zod_1.z.string().optional().describe("New status ('active'|'inactive'|'cancel_requested'|'cancelled') — recurring_update."),
+        reason: zod_1.z.string().optional().describe("Cancellation reason — recurring_cancel."),
+        kind: zod_1.z.enum(["asset", "liability"]).optional().describe("Manual net-worth item kind — networth_manual (default 'asset')."),
+        value_cents: zod_1.z.number().int().optional().describe("Value in cents — required for networth_manual."),
+        goal_id: zod_1.z.string().optional().describe("Savings goal id — goal_update/goal_delete."),
+        target_cents: zod_1.z.number().int().optional().describe("Goal target in cents — required for goal_create; goal_update."),
+        mode: zod_1.z.enum(["autopilot", "custom"]).optional().describe("Goal funding mode — goal_create (default 'custom')/goal_update."),
+        ambition: zod_1.z.string().optional().describe("Free-text ambition note — goal_create/goal_update."),
+        monthly_cents: zod_1.z.number().int().optional().describe("Monthly contribution in cents — goal_create/goal_update."),
+        saved_cents: zod_1.z.number().int().optional().describe("Amount saved so far in cents — goal_update."),
+        alert_type: zod_1.z.string().optional().describe("Alert type key — required for alerts_config_set. Maps to the REST body field 'type'."),
+        enabled: zod_1.z.boolean().optional().describe("Enable/disable the alert — alerts_config_set (default true)."),
+        threshold_cents: zod_1.z.number().int().optional().describe("Alert threshold in cents — alerts_config_set."),
+        channels: zod_1.z.array(zod_1.z.string()).optional().describe("Notification channels — alerts_config_set."),
+        bill_id: zod_1.z.string().optional().describe("Bill id to negotiate — negotiate_create."),
+        provider: zod_1.z.string().optional().describe("Provider/company name — required for negotiate_create."),
+        statement_doc_id: zod_1.z.string().optional().describe("Linked statement document id — negotiate_create."),
+        statement_id: zod_1.z.string().optional().describe("Bank statement id — required for statement_get/statement_delete."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/developer/v1/moneymind";
+        try {
+            switch (action) {
+                case "overview":
+                    return ok(await client.call("GET", `${base}/overview`, args));
+                case "accounts_list":
+                    return ok(await client.call("GET", `${base}/accounts`, args));
+                case "account_create":
+                    return ok(await client.call("POST", `${base}/accounts`, args, [], [], ["name", "type", "balance_cents", "institution", "mask", "currency"]));
+                case "account_update": {
+                    const m = need(args, ["account_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/accounts/{account_id}`, args, ["account_id"], [], ["name", "balance_cents", "hidden", "institution"]));
+                }
+                case "account_delete": {
+                    const m = need(args, ["account_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/accounts/{account_id}`, args, ["account_id"]));
+                }
+                case "transactions_list":
+                    return ok(await client.call("GET", `${base}/transactions`, args, [], [
+                        "from", "to", "account_id", "category", "search", "limit", "cursor", "recurring", "excluded",
+                    ]));
+                case "transaction_create": {
+                    const m = need(args, ["date", "amount_cents", "merchant", "account_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/transactions`, args, [], [], ["date", "amount_cents", "merchant", "category", "account_id", "notes"]));
+                }
+                case "transaction_update": {
+                    const m = need(args, ["txn_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/transactions/{txn_id}`, args, ["txn_id"], [], ["category", "notes", "excluded", "splits", "merchant"]));
+                }
+                case "transaction_split": {
+                    const m = need(args, ["txn_id", "splits"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/transactions/{txn_id}/split`, args, ["txn_id"], [], ["splits"]));
+                }
+                case "spending_summary":
+                    return ok(await client.call("GET", `${base}/spending/summary`, args, [], ["period", "anchor"]));
+                case "categories_list":
+                    return ok(await client.call("GET", `${base}/categories`, args));
+                case "category_create": {
+                    const m = need(args, ["name"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/categories`, args, [], [], ["name", "group", "icon", "color"]));
+                }
+                case "rules_list":
+                    return ok(await client.call("GET", `${base}/rules`, args));
+                case "rule_create": {
+                    const m = need(args, ["match", "rule_action"]);
+                    if (m)
+                        return err(m);
+                    const body = { ...args, action: args.rule_action };
+                    return ok(await client.call("POST", `${base}/rules`, body, [], [], ["match", "action"]));
+                }
+                case "rule_delete": {
+                    const m = need(args, ["rule_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/rules/{rule_id}`, args, ["rule_id"]));
+                }
+                case "budgets_list":
+                    return ok(await client.call("GET", `${base}/budgets`, args));
+                case "budget_set": {
+                    const m = need(args, ["category", "limit_cents"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PUT", `${base}/budgets/{category}`, args, ["category"], [], ["limit_cents", "rollover"]));
+                }
+                case "budget_delete": {
+                    const m = need(args, ["category"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/budgets/{category}`, args, ["category"]));
+                }
+                case "recurring_list":
+                    return ok(await client.call("GET", `${base}/recurring`, args));
+                case "recurring_update": {
+                    const m = need(args, ["recurring_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/recurring/{recurring_id}`, args, ["recurring_id"], [], ["status", "category", "hidden"]));
+                }
+                case "recurring_cancel": {
+                    const m = need(args, ["recurring_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/recurring/{recurring_id}/cancel`, args, ["recurring_id"], [], ["reason"]));
+                }
+                case "networth":
+                    return ok(await client.call("GET", `${base}/networth`, args));
+                case "networth_manual": {
+                    const m = need(args, ["name", "value_cents"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/networth/manual`, args, [], [], ["name", "kind", "value_cents"]));
+                }
+                case "networth_snapshot":
+                    return ok(await client.call("POST", `${base}/networth/snapshot`, args));
+                case "goals_list":
+                    return ok(await client.call("GET", `${base}/goals`, args));
+                case "goal_create": {
+                    const m = need(args, ["name", "target_cents"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/goals`, args, [], [], ["name", "target_cents", "mode", "ambition", "monthly_cents"]));
+                }
+                case "goal_update": {
+                    const m = need(args, ["goal_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/goals/{goal_id}`, args, ["goal_id"], [], [
+                        "name", "target_cents", "saved_cents", "monthly_cents", "ambition", "mode",
+                    ]));
+                }
+                case "goal_delete": {
+                    const m = need(args, ["goal_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/goals/{goal_id}`, args, ["goal_id"]));
+                }
+                case "credit":
+                    return ok(await client.call("GET", `${base}/credit`, args));
+                case "alerts_config":
+                    return ok(await client.call("GET", `${base}/alerts/config`, args));
+                case "alerts_config_set": {
+                    const m = need(args, ["alert_type"]);
+                    if (m)
+                        return err(m);
+                    const body = { ...args, type: args.alert_type };
+                    return ok(await client.call("PUT", `${base}/alerts/config`, body, [], [], ["type", "enabled", "threshold_cents", "channels"]));
+                }
+                case "alerts_feed":
+                    return ok(await client.call("GET", `${base}/alerts/feed`, args));
+                case "negotiate_list":
+                    return ok(await client.call("GET", `${base}/negotiate`, args));
+                case "negotiate_create": {
+                    const m = need(args, ["provider"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/negotiate`, args, [], [], ["bill_id", "recurring_id", "provider", "statement_doc_id"]));
+                }
+                case "statements_list":
+                    return ok(await client.call("GET", `${base}/statements`, args));
+                case "statement_get": {
+                    const m = need(args, ["statement_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/statements/{statement_id}`, args, ["statement_id"]));
+                }
+                case "statement_delete": {
+                    const m = need(args, ["statement_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/statements/{statement_id}`, args, ["statement_id"]));
+                }
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_moneymind ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_moneymind error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_budget ────────────────────────────────────────
+    server.tool("mind_budget", "MIND Budget — 13-week cash-flow planner at m-i-n-d.ai/#/budget. Actions: overview, set_cells, set_starting, set_rows, row_create, row_update, row_delete, rows_reorder, row_cancel, row_restore, set_goals, set_quarter, variance, roll_forward, autofill_from_statement, autofill_accept, build_from_statements, build_accept, automanage_health.", {
+        action: zod_1.z
+            .enum([
+            "overview", "set_cells", "set_starting", "set_rows", "row_create", "row_update", "row_delete",
+            "rows_reorder", "row_cancel", "row_restore", "set_goals", "set_quarter", "variance", "roll_forward",
+            "autofill_from_statement", "autofill_accept", "build_from_statements", "build_accept", "automanage_health",
+        ])
+            .describe("Which 13-week budget operation to perform."),
+        cells: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{quarter_id, layer: 'projected'|'actual', row_id, week_index 0-12, amount_cents}] — set_cells."),
+        quarter_id: zod_1.z.string().optional().describe("Quarter id — set_starting (required), variance (required), roll_forward/autofill_*/build_* (required)."),
+        layer: zod_1.z.enum(["projected", "actual"]).optional().describe("Which layer to write — set_starting (required)."),
+        starting_cents: zod_1.z.number().int().optional().describe("Starting cash balance in cents — required for set_starting."),
+        rows: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{id?, label, group: 'receipt'|'paidout'|'paidout2', order}] — set_rows (replaces the whole row set)."),
+        row_id: zod_1.z.string().optional().describe("Row id — row_update/row_delete/row_cancel/row_restore."),
+        label: zod_1.z.string().optional().describe("Row label — required for row_create; row_update."),
+        group: zod_1.z.enum(["receipt", "paidout", "paidout2"]).optional().describe("Row group — row_create (default 'paidout')/row_update."),
+        order: zod_1.z.number().int().optional().describe("Sort order — row_create/row_update."),
+        category: zod_1.z.string().optional().describe("Category tag — row_create/row_update."),
+        orders: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{id, order}] — rows_reorder."),
+        from_week: zod_1.z.number().int().optional().describe("Week index 0-12 to cancel from — row_cancel (defaults to current week)."),
+        note: zod_1.z.string().optional().describe("Free-text note — row_cancel."),
+        goals: zod_1.z.array(zod_1.z.string()).optional().describe("Headline goal strings — set_goals."),
+        label_text: zod_1.z.string().optional().describe("Quarter label, e.g. 'Q1 2027' — set_quarter. Maps to the REST body field 'label'."),
+        start_date: zod_1.z.string().optional().describe("Quarter start date (YYYY-MM-DD) — set_quarter."),
+        carry_ending: zod_1.z.boolean().optional().describe("Carry the previous quarter's ending balance forward — set_quarter (default true)."),
+        threshold_pct: zod_1.z.number().optional().describe("Variance alert threshold percent — variance (server default 20)."),
+        create_next: zod_1.z.boolean().optional().describe("Create the next quarter — roll_forward (default true)."),
+        as_of: zod_1.z.string().optional().describe("As-of date (YYYY-MM-DD) — roll_forward."),
+        transactions: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{date, amount?, amount_cents?, merchant?, description?, category?, direction?}] — autofill_from_statement/build_from_statements."),
+        apply: zod_1.z.boolean().optional().describe("Apply the autofill immediately — autofill_from_statement (default false)."),
+        proposal_ids: zod_1.z.array(zod_1.z.string()).optional().describe("Which autofill proposals to accept — autofill_accept (empty = accept all)."),
+        replace_rows: zod_1.z.boolean().optional().describe("Replace existing rows — build_from_statements/build_accept (default true)."),
+        align_to_statement: zod_1.z.boolean().optional().describe("Align cells to statement dates — build_from_statements (default true)."),
+        proposal: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("The full BuildProposal object returned by build_from_statements — required for build_accept."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/developer/v1/budget";
+        try {
+            switch (action) {
+                case "overview":
+                    return ok(await client.call("GET", `${base}/overview`, args));
+                case "set_cells":
+                    return ok(await client.call("PUT", `${base}/cells`, args, [], [], ["cells"]));
+                case "set_starting": {
+                    const m = need(args, ["quarter_id", "layer", "starting_cents"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PUT", `${base}/starting`, args, [], [], ["quarter_id", "layer", "starting_cents"]));
+                }
+                case "set_rows":
+                    return ok(await client.call("PUT", `${base}/rows`, args, [], [], ["rows"]));
+                case "row_create": {
+                    const m = need(args, ["label"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/rows`, args, [], [], ["label", "group", "order", "category"]));
+                }
+                case "row_update": {
+                    const m = need(args, ["row_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/rows/{row_id}`, args, ["row_id"], [], ["label", "group", "order", "category"]));
+                }
+                case "row_delete": {
+                    const m = need(args, ["row_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/rows/{row_id}`, args, ["row_id"]));
+                }
+                case "rows_reorder":
+                    return ok(await client.call("POST", `${base}/rows/reorder`, args, [], [], ["orders"]));
+                case "row_cancel": {
+                    const m = need(args, ["row_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/rows/{row_id}/cancel`, args, ["row_id"], [], ["quarter_id", "from_week", "note"]));
+                }
+                case "row_restore": {
+                    const m = need(args, ["row_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/rows/{row_id}/restore`, args, ["row_id"]));
+                }
+                case "set_goals":
+                    return ok(await client.call("PUT", `${base}/goals`, args, [], [], ["goals"]));
+                case "set_quarter": {
+                    const body = { ...args, label: args.label_text };
+                    return ok(await client.call("POST", `${base}/quarter`, body, [], [], ["label", "start_date", "carry_ending"]));
+                }
+                case "variance": {
+                    const m = need(args, ["quarter_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/variance`, args, [], ["quarter_id", "threshold_pct"]));
+                }
+                case "roll_forward":
+                    return ok(await client.call("POST", `${base}/roll-forward`, args, [], [], ["quarter_id", "create_next", "as_of"]));
+                case "autofill_from_statement": {
+                    const m = need(args, ["quarter_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/autofill-from-statement`, args, [], [], ["quarter_id", "transactions", "apply"]));
+                }
+                case "autofill_accept": {
+                    const m = need(args, ["quarter_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/autofill/accept`, args, [], [], ["quarter_id", "proposal_ids"]));
+                }
+                case "build_from_statements": {
+                    const m = need(args, ["quarter_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/build-from-statements`, args, [], [], [
+                        "quarter_id", "transactions", "replace_rows", "align_to_statement",
+                    ]));
+                }
+                case "build_accept": {
+                    const m = need(args, ["quarter_id", "proposal"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/build/accept`, args, [], [], ["quarter_id", "proposal"]));
+                }
+                case "automanage_health":
+                    return ok(await client.call("GET", `${base}/automanage/health`, args));
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_budget ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_budget error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_sheets ────────────────────────────────────────
+    server.tool("mind_sheets", "MIND Sheets — Airtable-style tables at m-i-n-d.ai/#/sheets. Actions: tables_list, table_create, table_update, table_delete, column_add, column_update, column_delete, columns_reorder, rows_list, row_create, row_update, row_delete, rows_bulk_delete, export_csv (returns raw CSV text).", {
+        action: zod_1.z
+            .enum([
+            "tables_list", "table_create", "table_update", "table_delete", "column_add", "column_update",
+            "column_delete", "columns_reorder", "rows_list", "row_create", "row_update", "row_delete",
+            "rows_bulk_delete", "export_csv",
+        ])
+            .describe("Which sheets operation to perform."),
+        table_id: zod_1.z.string().optional().describe("Table id — every action except tables_list/table_create."),
+        name: zod_1.z.string().optional().describe("Table name (table_create required/table_update required) or column name (column_add required/column_update)."),
+        columns: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{name, type, options?, width?}] — table_create initial columns."),
+        column_id: zod_1.z.string().optional().describe("Column id — column_update/column_delete."),
+        type: zod_1.z.string().optional().describe("Column type: text|number|select|date|checkbox|url — required for column_add; column_update."),
+        options: zod_1.z.array(zod_1.z.string()).optional().describe("Select-type options — column_add/column_update."),
+        width: zod_1.z.number().int().optional().describe("Column width in px — column_update."),
+        column_ids: zod_1.z.array(zod_1.z.string()).optional().describe("New column order — required for columns_reorder."),
+        limit: zod_1.z.number().int().optional().describe("Max rows — rows_list (default 500, max 2000)."),
+        offset: zod_1.z.number().int().optional().describe("Row offset — rows_list (default 0)."),
+        row_id: zod_1.z.string().optional().describe("Row id — row_update/row_delete."),
+        cells: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("{column_id: value, ...} — row_create/row_update (required)."),
+        row_ids: zod_1.z.array(zod_1.z.string()).optional().describe("Row ids to delete — required for rows_bulk_delete."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/sheets";
+        try {
+            switch (action) {
+                case "tables_list":
+                    return ok(await client.call("GET", `${base}/tables`, args));
+                case "table_create": {
+                    const m = need(args, ["name"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/tables`, args, [], [], ["name", "columns"]));
+                }
+                case "table_update": {
+                    const m = need(args, ["table_id", "name"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/tables/{table_id}`, args, ["table_id"], [], ["name"]));
+                }
+                case "table_delete": {
+                    const m = need(args, ["table_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/tables/{table_id}`, args, ["table_id"]));
+                }
+                case "column_add": {
+                    const m = need(args, ["table_id", "name", "type"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/tables/{table_id}/columns`, args, ["table_id"], [], ["name", "type", "options"]));
+                }
+                case "column_update": {
+                    const m = need(args, ["table_id", "column_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/tables/{table_id}/columns/{column_id}`, args, ["table_id", "column_id"], [], [
+                        "name", "type", "options", "width",
+                    ]));
+                }
+                case "column_delete": {
+                    const m = need(args, ["table_id", "column_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/tables/{table_id}/columns/{column_id}`, args, ["table_id", "column_id"]));
+                }
+                case "columns_reorder": {
+                    const m = need(args, ["table_id", "column_ids"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/tables/{table_id}/columns/reorder`, args, ["table_id"], [], ["column_ids"]));
+                }
+                case "rows_list": {
+                    const m = need(args, ["table_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/tables/{table_id}/rows`, args, ["table_id"], ["limit", "offset"]));
+                }
+                case "row_create": {
+                    const m = need(args, ["table_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/tables/{table_id}/rows`, args, ["table_id"], [], ["cells"]));
+                }
+                case "row_update": {
+                    const m = need(args, ["table_id", "row_id", "cells"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/tables/{table_id}/rows/{row_id}`, args, ["table_id", "row_id"], [], ["cells"]));
+                }
+                case "row_delete": {
+                    const m = need(args, ["table_id", "row_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/tables/{table_id}/rows/{row_id}`, args, ["table_id", "row_id"]));
+                }
+                case "rows_bulk_delete": {
+                    const m = need(args, ["table_id", "row_ids"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/tables/{table_id}/rows/bulk_delete`, args, ["table_id"], [], ["row_ids"]));
+                }
+                case "export_csv": {
+                    const m = need(args, ["table_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/tables/{table_id}/export.csv`, args, ["table_id"]));
+                }
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_sheets ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_sheets error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_email ─────────────────────────────────────────
+    server.tool("mind_email", "MIND Email Manager at m-i-n-d.ai/#/email. Actions: status, inbox, thread, message, search, sync, action (archive/trash/mark_read/mark_unread/star/unstar a batch of messages), draft (AI-draft a reply or new email, no send), draft_save, send (⚠️ OUTWARD — sends a real email; confirm with the user before calling), voice, voice_pref_set, voice_pref_clear, voice_rebuild. Note: the REST body field 'action' on the `action` operation is exposed here as `email_action` (an 'action' field would collide with this tool's own dispatch key).", {
+        action: zod_1.z
+            .enum(["status", "inbox", "thread", "message", "search", "sync", "action", "draft", "draft_save", "send", "voice", "voice_pref_set", "voice_pref_clear", "voice_rebuild"])
+            .describe("Which email operation to perform."),
+        mode: zod_1.z.string().optional().describe("Mailbox mode, e.g. 'user' — most actions (default 'user')."),
+        thread_id: zod_1.z.string().optional().describe("Thread id — required for action=thread."),
+        message_id: zod_1.z.string().optional().describe("Message id — required for action=message; also draft (reply target)/draft_save (required)."),
+        q: zod_1.z.string().optional().describe("Search query — required for search."),
+        limit: zod_1.z.number().int().optional().describe("Max results — search/inbox (as 'top')."),
+        top: zod_1.z.number().int().optional().describe("Max results to sync/list — inbox/sync (default 25)."),
+        page_token: zod_1.z.string().optional().describe("Pagination token — inbox."),
+        unread_only: zod_1.z.boolean().optional().describe("Only unread messages — inbox."),
+        message_ids: zod_1.z.array(zod_1.z.string()).optional().describe("Message ids to act on — required for action='action'."),
+        email_action: zod_1.z.enum(["archive", "trash", "mark_read", "mark_unread", "star", "unstar"]).optional().describe("Which mailbox action to apply — required for action='action'. Maps to the REST body field 'action'."),
+        instructions: zod_1.z.string().optional().describe("Free-text drafting instructions — draft."),
+        thread_context: zod_1.z.string().optional().describe("Pre-fetched thread context to skip a lookup — draft."),
+        remember_instruction: zod_1.z.boolean().optional().describe("Promote the instruction to a standing voice correction — draft."),
+        body_text: zod_1.z.string().optional().describe("Draft/send body text — draft_save (required)/send."),
+        to: zod_1.z.array(zod_1.z.string()).optional().describe("Recipient addresses — send (required unless reply_to_message_id is set)."),
+        cc: zod_1.z.array(zod_1.z.string()).optional().describe("CC addresses — send."),
+        subject: zod_1.z.string().optional().describe("Subject line — send."),
+        body: zod_1.z.string().optional().describe("Send body (HTML/plain) — send (either body or body_text required)."),
+        reply_to_message_id: zod_1.z.string().optional().describe("Reply target message id — send."),
+        instruction: zod_1.z.string().optional().describe("Voice instruction text — required for voice_pref_set/voice_pref_clear."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/email";
+        try {
+            switch (action) {
+                case "status":
+                    return ok(await client.call("GET", `${base}/status`, args, [], ["mode"]));
+                case "inbox":
+                    return ok(await client.call("GET", `${base}/inbox`, args, [], ["mode", "top", "page_token", "unread_only"]));
+                case "thread": {
+                    const m = need(args, ["thread_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/thread/{thread_id}`, args, ["thread_id"], ["mode"]));
+                }
+                case "message": {
+                    const m = need(args, ["message_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/message/{message_id}`, args, ["message_id"], ["mode"]));
+                }
+                case "search": {
+                    const m = need(args, ["q"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/search`, args, [], ["mode", "q", "limit"]));
+                }
+                case "sync":
+                    return ok(await client.call("POST", `${base}/sync`, args, [], [], ["mode", "top"]));
+                case "action": {
+                    const m = need(args, ["message_ids", "email_action"]);
+                    if (m)
+                        return err(m);
+                    const body = { ...args, action: args.email_action };
+                    return ok(await client.call("POST", `${base}/action`, body, [], [], ["mode", "message_ids", "action"]));
+                }
+                case "draft":
+                    return ok(await client.call("POST", `${base}/draft`, args, [], [], [
+                        "mode", "message_id", "instructions", "thread_context", "remember_instruction",
+                    ]));
+                case "draft_save": {
+                    const m = need(args, ["message_id", "body_text"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/draft/save`, args, [], [], ["mode", "message_id", "body_text"]));
+                }
+                case "send": {
+                    if (!args.body && !args.body_text)
+                        return err("Error: body or body_text required for send.");
+                    return ok(await client.call("POST", `${base}/send`, args, [], [], [
+                        "mode", "to", "cc", "subject", "body", "body_text", "reply_to_message_id",
+                    ]));
+                }
+                case "voice":
+                    return ok(await client.call("GET", `${base}/voice`, args));
+                case "voice_pref_set": {
+                    const m = need(args, ["instruction"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/voice/pref`, args, [], [], ["instruction"]));
+                }
+                case "voice_pref_clear": {
+                    const m = need(args, ["instruction"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/voice/pref`, args, [], [], ["instruction"]));
+                }
+                case "voice_rebuild":
+                    return ok(await client.call("POST", `${base}/voice/rebuild`, args));
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_email ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_email error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_checklists ────────────────────────────────────
+    server.tool("mind_checklists", "Kanon checklists at kanon.theastraway.com, attached to Life items or tasks. Actions: templates_list, template_get, template_create, template_update, template_delete, list, get, create, update, delete, toggle_item, complete, progress (rollup for a parent_type+parent_id).", {
+        action: zod_1.z
+            .enum(["templates_list", "template_get", "template_create", "template_update", "template_delete", "list", "get", "create", "update", "delete", "toggle_item", "complete", "progress"])
+            .describe("Which checklist operation to perform."),
+        template_id: zod_1.z.string().optional().describe("Checklist template id — template_get/template_update/template_delete (required); create (instantiate from a template)."),
+        title: zod_1.z.string().optional().describe("Title — template_create (required)/template_update; create/update (checklist title)."),
+        description: zod_1.z.string().optional().describe("Long description — template_create/template_update."),
+        sections: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{section_id?, title, phase: 'pre'|'run'|'post', items: [{item_id?, label, note?, checked?, assignee?}]}] — template_create/template_update; create/update (inline sections, alternative to template_id)."),
+        origin: zod_1.z.enum(["user", "flagship"]).optional().describe("Template origin — template_create (default 'user')."),
+        schedule: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("Recurrence config — template_create/template_update; create/update."),
+        checklist_id: zod_1.z.string().optional().describe("Checklist id — get/update/delete/toggle_item/complete (required)."),
+        parent_type: zod_1.z.enum(["life_item", "task"]).optional().describe("Parent type — create (required); list/progress filter (progress requires it)."),
+        parent_id: zod_1.z.string().optional().describe("Parent id (a Life item_id or task id) — create (required); list/progress filter (progress requires it)."),
+        parent_label: zod_1.z.string().optional().describe("Human-readable parent label — create."),
+        assigned_to: zod_1.z.string().optional().describe("Assignee (e.g. 'Dae') — create/update."),
+        item_id: zod_1.z.string().optional().describe("Checklist item id — required for toggle_item."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/developer/v1/checklists";
+        try {
+            switch (action) {
+                case "templates_list":
+                    return ok(await client.call("GET", `${base}/templates`, args));
+                case "template_get": {
+                    const m = need(args, ["template_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/templates/{template_id}`, args, ["template_id"]));
+                }
+                case "template_create": {
+                    const m = need(args, ["title"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/templates`, args, [], [], ["title", "description", "sections", "origin", "schedule"]));
+                }
+                case "template_update": {
+                    const m = need(args, ["template_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/templates/{template_id}`, args, ["template_id"], [], ["title", "description", "sections", "schedule"]));
+                }
+                case "template_delete": {
+                    const m = need(args, ["template_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/templates/{template_id}`, args, ["template_id"]));
+                }
+                case "list":
+                    return ok(await client.call("GET", base, args, [], ["parent_type", "parent_id"]));
+                case "get": {
+                    const m = need(args, ["checklist_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/{checklist_id}`, args, ["checklist_id"]));
+                }
+                case "create": {
+                    const m = need(args, ["parent_type", "parent_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", base, args, [], [], [
+                        "parent_type", "parent_id", "parent_label", "template_id", "title", "sections", "schedule", "assigned_to",
+                    ]));
+                }
+                case "update": {
+                    const m = need(args, ["checklist_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/{checklist_id}`, args, ["checklist_id"], [], ["title", "sections", "schedule", "assigned_to"]));
+                }
+                case "delete": {
+                    const m = need(args, ["checklist_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/{checklist_id}`, args, ["checklist_id"]));
+                }
+                case "toggle_item": {
+                    const m = need(args, ["checklist_id", "item_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/{checklist_id}/items/{item_id}/toggle`, args, ["checklist_id", "item_id"]));
+                }
+                case "complete": {
+                    const m = need(args, ["checklist_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/{checklist_id}/complete`, args, ["checklist_id"]));
+                }
+                case "progress": {
+                    const m = need(args, ["parent_type", "parent_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/progress`, args, [], ["parent_type", "parent_id"]));
+                }
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_checklists ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_checklists error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_sign ──────────────────────────────────────────
+    server.tool("mind_sign", "MIND Sign — e-signature envelopes at m-i-n-d.ai/#/mindsign. Actions: list, get, create (JSON variant — document by pdf_url or pdf_base64), setup, fields, send (⚠️ OUTWARD — emails every signer; confirm with the user before calling), resend (⚠️ OUTWARD — re-emails one signer; confirm with the user before calling), void, delete, audit, certificate, download_url (returns a download link string, no binary transferred through MCP).", {
+        action: zod_1.z
+            .enum(["list", "get", "create", "setup", "fields", "send", "resend", "void", "delete", "audit", "certificate", "download_url"])
+            .describe("Which e-signature operation to perform."),
+        envelope_id: zod_1.z.string().optional().describe("Envelope id — every action except list/create."),
+        status: zod_1.z.enum(["draft", "sent", "completed", "voided"]).optional().describe("Filter by status — list."),
+        q: zod_1.z.string().optional().describe("Free-text search — list."),
+        limit: zod_1.z.number().int().optional().describe("Max results — list (default 50, 1-200)."),
+        offset: zod_1.z.number().int().optional().describe("Pagination offset — list (default 0)."),
+        include_deleted: zod_1.z.boolean().optional().describe("Include soft-deleted envelopes — list/get."),
+        title: zod_1.z.string().optional().describe("Envelope title — required for create."),
+        pdf_url: zod_1.z.string().optional().describe("Source PDF URL — create (exactly one of pdf_url/pdf_base64 required)."),
+        pdf_base64: zod_1.z.string().optional().describe("Source PDF as base64 — create (exactly one of pdf_url/pdf_base64 required)."),
+        signers: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{name, email}] — required for create/setup."),
+        fields: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{page, x, y, w, h, type: 'signature'|'initials'|'name'|'date'|'text', signer_index?, label?, default_value?, required?, font_size?}] — required for create/setup/fields."),
+        message: zod_1.z.string().optional().describe("Message to signers — create/send/resend."),
+        send: zod_1.z.boolean().optional().describe("Send immediately on create — create (default false)."),
+        signing_order: zod_1.z.enum(["parallel", "sequential"]).optional().describe("Signing order — create/setup."),
+        only_email: zod_1.z.string().optional().describe("Send only to this signer's email — send."),
+        signer_email: zod_1.z.string().optional().describe("Signer email to resend to — required for resend."),
+        reason: zod_1.z.string().optional().describe("Void reason — void."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/api/sign/envelopes";
+        try {
+            switch (action) {
+                case "list":
+                    return ok(await client.call("GET", base, args, [], ["status", "q", "limit", "offset", "include_deleted"]));
+                case "get": {
+                    const m = need(args, ["envelope_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/{envelope_id}`, args, ["envelope_id"], ["include_deleted"]));
+                }
+                case "create": {
+                    const m = need(args, ["title", "signers", "fields"]);
+                    if (m)
+                        return err(m);
+                    if (!args.pdf_url && !args.pdf_base64)
+                        return err("Error: pdf_url or pdf_base64 required for create.");
+                    return ok(await client.call("POST", `${base}/json`, args, [], [], [
+                        "title", "pdf_url", "pdf_base64", "signers", "fields", "message", "send", "signing_order",
+                    ]));
+                }
+                case "setup": {
+                    const m = need(args, ["envelope_id", "fields", "signers"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PUT", `${base}/{envelope_id}/setup`, args, ["envelope_id"], [], ["fields", "signers", "signing_order"]));
+                }
+                case "fields": {
+                    const m = need(args, ["envelope_id", "fields"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/{envelope_id}/fields`, args, ["envelope_id"], [], ["fields"]));
+                }
+                case "send": {
+                    const m = need(args, ["envelope_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/{envelope_id}/send`, args, ["envelope_id"], [], ["message", "only_email"]));
+                }
+                case "resend": {
+                    const m = need(args, ["envelope_id", "signer_email"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/{envelope_id}/resend`, args, ["envelope_id"], [], ["signer_email", "message"]));
+                }
+                case "void": {
+                    const m = need(args, ["envelope_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/{envelope_id}/void`, args, ["envelope_id"], [], ["reason"]));
+                }
+                case "delete": {
+                    const m = need(args, ["envelope_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/{envelope_id}`, args, ["envelope_id"]));
+                }
+                case "audit": {
+                    const m = need(args, ["envelope_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/{envelope_id}/audit`, args, ["envelope_id"]));
+                }
+                case "certificate": {
+                    const m = need(args, ["envelope_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/{envelope_id}/certificate`, args, ["envelope_id"]));
+                }
+                case "download_url": {
+                    const m = need(args, ["envelope_id"]);
+                    if (m)
+                        return err(m);
+                    return ok({ download_url: `https://www.m-i-n-d.ai/api/sign/envelopes/${encodeURIComponent(String(args.envelope_id))}/download` });
+                }
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_sign ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_sign error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_invoices ──────────────────────────────────────
+    server.tool("mind_invoices", "Invoice Agent at m-i-n-d.ai/#/invoiceagent. Actions: list, get, create, update, delete, ask (ask a question about an invoice), invite (⚠️ OUTWARD — emails the bill-to party a payment link; confirm with the user before calling), pdf_url (returns a PDF link string, no binary transferred through MCP), received (invoices billed to you).", {
+        action: zod_1.z.enum(["list", "get", "create", "update", "delete", "ask", "invite", "pdf_url", "received"]).describe("Which invoice operation to perform."),
+        invoice_id: zod_1.z.string().optional().describe("Invoice id — every action except list/create/received."),
+        limit: zod_1.z.number().int().optional().describe("Max results — list (default 100)/received (default 100)."),
+        invoice_number: zod_1.z.string().optional().describe("Invoice number — create/update."),
+        issue_date: zod_1.z.string().optional().describe("Issue date (YYYY-MM-DD) — create/update."),
+        due_date: zod_1.z.string().optional().describe("Due date (YYYY-MM-DD) — create/update."),
+        bill_from: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("{name, company?, email?, address_line_1?, address_line_2?, city?, region?, postal_code?, country?, tax_id?} — required for create; update."),
+        bill_to: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("Same shape as bill_from — required for create; update."),
+        line_items: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{description, quantity?, unit_price?, tier?, agent_slug?, project_id?, line_kind?, period_start?, period_end?, market_value?, market_price?, market_note?, net_price?, justification?}] — create/update."),
+        tax_rate: zod_1.z.number().optional().describe("Tax rate (e.g. 0.0825) — create/update."),
+        discount_amount: zod_1.z.number().optional().describe("Flat discount amount — create/update."),
+        currency: zod_1.z.string().optional().describe("Currency code — create/update (default 'USD')."),
+        notes: zod_1.z.string().optional().describe("Free-text notes — create/update."),
+        payment_terms: zod_1.z.string().optional().describe("Payment terms string — create/update (default 'Net 15')."),
+        logo_data_url: zod_1.z.string().optional().describe("Logo image as a data URL — create/update."),
+        status: zod_1.z.enum(["draft", "sent", "paid", "overdue", "void"]).optional().describe("Invoice status — update."),
+        question: zod_1.z.string().optional().describe("Question about the invoice — required for ask."),
+        outstanding_only: zod_1.z.boolean().optional().describe("Only unpaid received invoices — received (default true)."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/invoices";
+        try {
+            switch (action) {
+                case "list":
+                    return ok(await client.call("GET", base, args, [], ["limit"]));
+                case "get": {
+                    const m = need(args, ["invoice_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/{invoice_id}`, args, ["invoice_id"]));
+                }
+                case "create": {
+                    const m = need(args, ["bill_from", "bill_to"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", base, args, [], [], [
+                        "invoice_number", "issue_date", "due_date", "bill_from", "bill_to", "line_items",
+                        "tax_rate", "discount_amount", "currency", "notes", "payment_terms", "logo_data_url",
+                    ]));
+                }
+                case "update": {
+                    const m = need(args, ["invoice_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/{invoice_id}`, args, ["invoice_id"], [], [
+                        "invoice_number", "issue_date", "due_date", "bill_from", "bill_to", "line_items",
+                        "tax_rate", "discount_amount", "currency", "notes", "payment_terms", "status", "logo_data_url",
+                    ]));
+                }
+                case "delete": {
+                    const m = need(args, ["invoice_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/{invoice_id}`, args, ["invoice_id"]));
+                }
+                case "ask": {
+                    const m = need(args, ["invoice_id", "question"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/{invoice_id}/ask`, args, ["invoice_id"], [], ["question"]));
+                }
+                case "invite": {
+                    const m = need(args, ["invoice_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/{invoice_id}/invite`, args, ["invoice_id"]));
+                }
+                case "pdf_url": {
+                    const m = need(args, ["invoice_id"]);
+                    if (m)
+                        return err(m);
+                    return ok({ pdf_url: `https://www.m-i-n-d.ai/invoices/${encodeURIComponent(String(args.invoice_id))}/pdf` });
+                }
+                case "received":
+                    return ok(await client.call("GET", `${base}/received`, args, [], ["outstanding_only", "limit"]));
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_invoices ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_invoices error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_books ─────────────────────────────────────────
+    server.tool("mind_books", "MIND Books — small-business accounting at m-i-n-d.ai/#/mind-books. Actions: overview, vendors_list, vendor_create, customers_list, customer_create, accounts, bills, invoices, health.", {
+        action: zod_1.z.enum(["overview", "vendors_list", "vendor_create", "customers_list", "customer_create", "accounts", "bills", "invoices", "health"]).describe("Which MIND Books operation to perform."),
+        display_name: zod_1.z.string().optional().describe("Vendor/customer display name — required for vendor_create/customer_create."),
+        email: zod_1.z.string().optional().describe("Contact email — vendor_create/customer_create."),
+        phone: zod_1.z.string().optional().describe("Contact phone — vendor_create."),
+        note: zod_1.z.string().optional().describe("Free-text note — vendor_create."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/developer/v1/mind-books";
+        try {
+            switch (action) {
+                case "overview":
+                    return ok(await client.call("GET", `${base}/overview`, args));
+                case "vendors_list":
+                    return ok(await client.call("GET", `${base}/vendors`, args));
+                case "vendor_create": {
+                    const m = need(args, ["display_name"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/vendors`, args, [], [], ["display_name", "email", "phone", "note"]));
+                }
+                case "customers_list":
+                    return ok(await client.call("GET", `${base}/customers`, args));
+                case "customer_create": {
+                    const m = need(args, ["display_name"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/customers`, args, [], [], ["display_name", "email"]));
+                }
+                case "accounts":
+                    return ok(await client.call("GET", `${base}/accounts`, args));
+                case "bills":
+                    return ok(await client.call("GET", `${base}/bills`, args));
+                case "invoices":
+                    return ok(await client.call("GET", `${base}/invoices`, args));
+                case "health":
+                    return ok(await client.call("GET", `${base}/health`, args));
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_books ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_books error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_timer ─────────────────────────────────────────
+    server.tool("mind_timer", "Tempo time tracking. Actions: start, stop, current (the running entry, if any), entries_list, entry_create (manual entry), entry_update, entry_delete, summary.", {
+        action: zod_1.z.enum(["start", "stop", "current", "entries_list", "entry_create", "entry_update", "entry_delete", "summary"]).describe("Which timer operation to perform."),
+        description: zod_1.z.string().optional().describe("What you're working on — start/entry_create/entry_update."),
+        entry_id: zod_1.z.string().optional().describe("Time entry id — required for entry_update/entry_delete."),
+        item_id: zod_1.z.string().optional().describe("Life item_id this time is logged against — start/entry_create/entry_update."),
+        project: zod_1.z.string().optional().describe("Free-text project label — start/entry_create/entry_update."),
+        tags: zod_1.z.array(zod_1.z.string()).optional().describe("Tags — start/entry_create/entry_update."),
+        billable: zod_1.z.boolean().optional().describe("Mark billable — start/entry_create/entry_update (default false)."),
+        days: zod_1.z.number().int().optional().describe("How many days back to list — entries_list (default 7, 1-90)."),
+        started_at: zod_1.z.string().optional().describe("Start timestamp (ISO 8601) — required for entry_create; entry_update."),
+        stopped_at: zod_1.z.string().optional().describe("Stop timestamp (ISO 8601) — required for entry_create; entry_update."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/timer";
+        try {
+            switch (action) {
+                case "start":
+                    return ok(await client.call("POST", `${base}/start`, args, [], [], ["description", "item_id", "project", "tags", "billable"]));
+                case "stop":
+                    return ok(await client.call("POST", `${base}/stop`, args));
+                case "current":
+                    return ok(await client.call("GET", `${base}/current`, args));
+                case "entries_list":
+                    return ok(await client.call("GET", `${base}/entries`, args, [], ["days"]));
+                case "entry_create": {
+                    const m = need(args, ["started_at", "stopped_at"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/entries`, args, [], [], [
+                        "description", "item_id", "project", "tags", "billable", "started_at", "stopped_at",
+                    ]));
+                }
+                case "entry_update": {
+                    const m = need(args, ["entry_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/entries/{entry_id}`, args, ["entry_id"], [], [
+                        "description", "project", "item_id", "tags", "billable", "started_at", "stopped_at",
+                    ]));
+                }
+                case "entry_delete": {
+                    const m = need(args, ["entry_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/entries/{entry_id}`, args, ["entry_id"]));
+                }
+                case "summary":
+                    return ok(await client.call("GET", `${base}/summary`, args));
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_timer ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_timer error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_forms ─────────────────────────────────────────
+    server.tool("mind_forms", "Quill forms at m-i-n-d.ai/#/forms — public lead-capture forms that can auto-create CRM contacts / Life items. Actions: list, get, create, update, delete, submissions, public_get (read a published form by its public slug, no auth needed).", {
+        action: zod_1.z.enum(["list", "get", "create", "update", "delete", "submissions", "public_get"]).describe("Which form operation to perform."),
+        form_id: zod_1.z.string().optional().describe("Form id — get/update/delete/submissions (required)."),
+        name: zod_1.z.string().optional().describe("Form name — required for create; update."),
+        description: zod_1.z.string().optional().describe("Form description — create/update."),
+        fields: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).optional().describe("[{field_id?, label, type?, required?, options?, placeholder?, maps_to?}] — create/update."),
+        settings: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional().describe("{create_contact?, create_life_item?, contact_type?, success_message?, accent?} — create/update."),
+        is_published: zod_1.z.boolean().optional().describe("Publish/unpublish the form — update."),
+        slug: zod_1.z.string().optional().describe("Public form slug — required for public_get."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/forms";
+        try {
+            switch (action) {
+                case "list":
+                    return ok(await client.call("GET", base, args));
+                case "get": {
+                    const m = need(args, ["form_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/{form_id}`, args, ["form_id"]));
+                }
+                case "create": {
+                    const m = need(args, ["name"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", base, args, [], [], ["name", "description", "fields", "settings"]));
+                }
+                case "update": {
+                    const m = need(args, ["form_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PATCH", `${base}/{form_id}`, args, ["form_id"], [], ["name", "description", "fields", "settings", "is_published"]));
+                }
+                case "delete": {
+                    const m = need(args, ["form_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/{form_id}`, args, ["form_id"]));
+                }
+                case "submissions": {
+                    const m = need(args, ["form_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/{form_id}/submissions`, args, ["form_id"]));
+                }
+                case "public_get": {
+                    const m = need(args, ["slug"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/public/{slug}`, args, ["slug"]));
+                }
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_forms ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_forms error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_library ───────────────────────────────────────
+    server.tool("mind_library", "MIND Library — personal bookshelf at m-i-n-d.ai/#/library. Actions: authors (author stats), books_list, book_get, book_content (chapter text/table of contents), book_companion (AI reading companion for a book), book_create, book_update, book_delete.", {
+        action: zod_1.z.enum(["authors", "books_list", "book_get", "book_content", "book_companion", "book_create", "book_update", "book_delete"]).describe("Which library operation to perform."),
+        book_id: zod_1.z.string().optional().describe("Book id — every action except authors/books_list/book_create."),
+        q: zod_1.z.string().optional().describe("Free-text search — books_list."),
+        author: zod_1.z.string().optional().describe("Filter by author — books_list."),
+        genre: zod_1.z.string().optional().describe("Filter by genre — books_list."),
+        series: zod_1.z.string().optional().describe("Filter by series — books_list; book_create/book_update."),
+        status: zod_1.z.enum(["unread", "reading", "finished", "abandoned"]).optional().describe("Filter by reading status — books_list; book_create (default 'unread')/book_update."),
+        shelf_id: zod_1.z.string().optional().describe("Filter by shelf id — books_list."),
+        tag: zod_1.z.string().optional().describe("Filter by tag — books_list."),
+        sort: zod_1.z.string().optional().describe("Sort field — books_list (default 'added')."),
+        order: zod_1.z.string().optional().describe("Sort order 'asc'|'desc' — books_list (default 'desc')."),
+        limit: zod_1.z.number().int().optional().describe("Max results — books_list (default 60, 1-500)."),
+        offset: zod_1.z.number().int().optional().describe("Pagination offset — books_list (default 0)."),
+        chapter: zod_1.z.string().optional().describe("Return only this chapter id — book_content."),
+        toc_only: zod_1.z.boolean().optional().describe("Return only the table of contents, no HTML — book_content (default false)."),
+        title: zod_1.z.string().optional().describe("Book title — required for book_create; book_update."),
+        subtitle: zod_1.z.string().optional().describe("Book subtitle — book_create/book_update."),
+        authors: zod_1.z.array(zod_1.z.string()).optional().describe("Author names — book_create/book_update."),
+        genres: zod_1.z.array(zod_1.z.string()).optional().describe("Genres — book_create/book_update."),
+        series_index: zod_1.z.number().optional().describe("Position within the series — book_create/book_update."),
+        isbn10: zod_1.z.string().optional().describe("ISBN-10 — book_create/book_update."),
+        isbn13: zod_1.z.string().optional().describe("ISBN-13 — book_create/book_update."),
+        publisher: zod_1.z.string().optional().describe("Publisher — book_create/book_update."),
+        published_year: zod_1.z.number().int().optional().describe("Publication year — book_create/book_update."),
+        language: zod_1.z.string().optional().describe("Language code — book_create/book_update."),
+        page_count: zod_1.z.number().int().optional().describe("Page count — book_create/book_update."),
+        description: zod_1.z.string().optional().describe("Book description/blurb — book_create/book_update."),
+        cover_url: zod_1.z.string().optional().describe("Cover image URL — book_create/book_update."),
+        tags: zod_1.z.array(zod_1.z.string()).optional().describe("Tags — book_create/book_update."),
+        source: zod_1.z.string().optional().describe("Source of the record — book_create (default 'manual')."),
+        source_id: zod_1.z.string().optional().describe("External source id — book_create."),
+        file_url: zod_1.z.string().optional().describe("Book file URL — book_create/book_update."),
+        file_format: zod_1.z.string().optional().describe("File format, e.g. 'epub'/'pdf' — book_create/book_update."),
+        file_size: zod_1.z.number().int().optional().describe("File size in bytes — book_create/book_update."),
+        progress_pct: zod_1.z.number().int().optional().describe("Reading progress percent 0-100 — book_create (default 0)/book_update."),
+        rating: zod_1.z.number().optional().describe("Rating 0-5 — book_create/book_update."),
+        notes: zod_1.z.string().optional().describe("Free-text notes — book_create/book_update."),
+        date_started: zod_1.z.string().optional().describe("Date started (YYYY-MM-DD) — book_create/book_update."),
+        date_finished: zod_1.z.string().optional().describe("Date finished (YYYY-MM-DD) — book_create/book_update."),
+    }, async (args) => {
+        const { action } = args;
+        const base = "/library";
+        try {
+            switch (action) {
+                case "authors":
+                    return ok(await client.call("GET", `${base}/authors`, args));
+                case "books_list":
+                    return ok(await client.call("GET", `${base}/books`, args, [], [
+                        "q", "author", "genre", "series", "status", "shelf_id", "tag", "sort", "order", "limit", "offset",
+                    ]));
+                case "book_get": {
+                    const m = need(args, ["book_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/books/{book_id}`, args, ["book_id"]));
+                }
+                case "book_content": {
+                    const m = need(args, ["book_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/books/{book_id}/content`, args, ["book_id"], ["chapter", "toc_only"]));
+                }
+                case "book_companion": {
+                    const m = need(args, ["book_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", `${base}/books/{book_id}/companion`, args, ["book_id"]));
+                }
+                case "book_create": {
+                    const m = need(args, ["title"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", `${base}/books`, args, [], [], [
+                        "title", "subtitle", "authors", "genres", "series", "series_index", "isbn10", "isbn13",
+                        "publisher", "published_year", "language", "page_count", "description", "cover_url", "tags",
+                        "source", "source_id", "file_url", "file_format", "file_size", "status", "progress_pct",
+                        "rating", "notes", "date_started", "date_finished",
+                    ]));
+                }
+                case "book_update": {
+                    const m = need(args, ["book_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("PUT", `${base}/books/{book_id}`, args, ["book_id"], [], [
+                        "title", "subtitle", "authors", "genres", "series", "series_index", "isbn10", "isbn13",
+                        "publisher", "published_year", "language", "page_count", "description", "cover_url", "tags",
+                        "file_url", "file_format", "file_size", "status", "progress_pct", "rating", "notes",
+                        "date_started", "date_finished",
+                    ]));
+                }
+                case "book_delete": {
+                    const m = need(args, ["book_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", `${base}/books/{book_id}`, args, ["book_id"]));
+                }
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_library ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_library error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    // ─── mind_share ─────────────────────────────────────────
+    // Share links for one MIND document (distinct from mind_mindmap's own
+    // share/unshare, which are web-app-only). Mirrors the hosted handler
+    // _t_mind_share in backend/routes/mcp_server_routes.py 1:1.
+    server.tool("mind_share", "Create and manage share links for a MIND document. Actions: create (default — mint a new share link), list (this document's share links), list_all (every share link across your documents), revoke (delete one share link).", {
+        action: zod_1.z
+            .enum(["create", "list", "list_all", "revoke"])
+            .optional()
+            .default("create")
+            .describe("Which share operation to perform. Defaults to 'create'."),
+        doc_id: zod_1.z.string().optional().describe("Document id — required for create/list/revoke."),
+        role: zod_1.z.string().optional().describe("Access role granted to the share, e.g. 'viewer' — create."),
+        grantee_username: zod_1.z.string().optional().describe("Share directly with this MIND username instead of a public link — create."),
+        expires_in_days: zod_1.z.number().int().optional().describe("Share link expiry in days — create."),
+        password: zod_1.z.string().optional().describe("Password to protect the share link — create."),
+        share_id: zod_1.z.string().optional().describe("Share id — required for revoke."),
+    }, async (args) => {
+        const { action } = args;
+        try {
+            switch (action) {
+                case "create": {
+                    const m = need(args, ["doc_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("POST", "/developer/v1/documents/{doc_id}/share", args, ["doc_id"], [], [
+                        "role", "grantee_username", "expires_in_days", "password",
+                    ]));
+                }
+                case "list": {
+                    const m = need(args, ["doc_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("GET", "/developer/v1/documents/{doc_id}/share", args, ["doc_id"]));
+                }
+                case "list_all":
+                    return ok(await client.call("GET", "/developer/v1/documents/shares", args));
+                case "revoke": {
+                    const m = need(args, ["doc_id", "share_id"]);
+                    if (m)
+                        return err(m);
+                    return ok(await client.call("DELETE", "/developer/v1/documents/{doc_id}/share/{share_id}", args, ["doc_id", "share_id"]));
+                }
+                default: {
+                    const _exhaustive = action;
+                    return err(`Unknown action: ${_exhaustive}`);
+                }
+            }
+        }
+        catch (e) {
+            if (e instanceof mind_client_js_1.MindApiError)
+                return err(`mind_share ${action} failed (HTTP ${e.status}): ${apiDetail(e)}`);
+            return err(`mind_share error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
     return server;
 }
 //# sourceMappingURL=server.js.map