@astramindapp/mcp-server 0.22.0 → 0.23.0

package/dist/server.js

@@ -48,7 +48,7 @@ const integration_guide_js_1 = require("./integration-guide.js");
 function createMindMcpServer(client) {
     const server = new mcp_js_1.McpServer({
         name: "mind",
-        version: "0.17.0",
+        version: "0.23.0",
     }, {
         // Returned to every client in the MCP `initialize` response — the first
         // thing any connecting agent sees about how to integrate with MIND.
@@ -1392,6 +1392,155 @@ 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.