@abraca/mcp 1.0.18 → 1.0.21

package/dist/abracadabra-mcp.esm.js

@@ -19686,6 +19686,7 @@ var AbracadabraMCPServer = class {
 				method: "notifications/claude/channel",
 				params: {
 					content: task.text,
+					instructions: `You MUST use the reply tool with doc_id="${task.docId ?? ""}" and task_id="${task.id}" for your final response. The user CANNOT see plain text output; they only see replies sent via MCP tools. For progress updates during multi-step work, use send_chat_message with channel="group:${task.docId ?? ""}" (e.g. "Looking into that..." or "Found it, writing up results..."). Never output plain text as a substitute for MCP tools.`,
 					meta: {
 						source: "abracadabra",
 						type: "ai_task",
@@ -19748,6 +19749,7 @@ var AbracadabraMCPServer = class {
 				method: "notifications/claude/channel",
 				params: {
 					content: data.content ?? "",
+					instructions: `You MUST use send_chat_message with channel="${channel ?? ""}" for ALL responses — both progress updates and final answers. The user CANNOT see plain text output; they only see messages sent via send_chat_message. When doing multi-step work, send brief status updates via send_chat_message (e.g. "Looking into that..." or "Found it, writing up results...") so the user knows you're working. Never output plain text as a substitute for send_chat_message.`,
 					meta: {
 						source: "abracadabra",
 						type: "chat_message",
@@ -19904,13 +19906,19 @@ function buildTree$1(entries, rootId, maxDepth, currentDepth = 0, visited = /* @
 }
 function registerTreeTools(mcp, server) {
 	mcp.tool("list_documents", "List direct children of a document (defaults to root). Returns id, label, type, meta, order. NOTE: Only returns ONE level. Use find_document to search by name across the full tree, or get_document_tree to see the complete hierarchy.", { parentId: z.string().optional().describe("Parent document ID. Omit for root-level documents.") }, async ({ parentId }) => {
+		server.setAutoStatus("reading");
+		server.setActiveToolCall({ name: "list_documents" });
 		const treeMap = server.getTreeMap();
-		if (!treeMap) return { content: [{
-			type: "text",
-			text: "Not connected"
-		}] };
+		if (!treeMap) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: "Not connected"
+			}] };
+		}
 		const targetId = normalizeRootId(parentId, server);
 		const children = childrenOf$1(readEntries$1(treeMap), targetId);
+		server.setActiveToolCall(null);
 		return { content: [{
 			type: "text",
 			text: JSON.stringify(children, null, 2)
@@ -19920,14 +19928,20 @@ function registerTreeTools(mcp, server) {
 		rootId: z.string().optional().describe("Root document ID to start from. Omit for the entire tree."),
 		depth: z.number().optional().describe("Maximum depth to traverse. Default 3. Use -1 for unlimited.")
 	}, async ({ rootId, depth }) => {
+		server.setAutoStatus("reading");
+		server.setActiveToolCall({ name: "get_document_tree" });
 		const treeMap = server.getTreeMap();
-		if (!treeMap) return { content: [{
-			type: "text",
-			text: "Not connected"
-		}] };
+		if (!treeMap) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: "Not connected"
+			}] };
+		}
 		const targetId = normalizeRootId(rootId, server);
 		const maxDepth = depth ?? 3;
 		const tree = buildTree$1(readEntries$1(treeMap), targetId, maxDepth);
+		server.setActiveToolCall(null);
 		return { content: [{
 			type: "text",
 			text: JSON.stringify(tree, null, 2)
@@ -19937,11 +19951,19 @@ function registerTreeTools(mcp, server) {
 		query: z.string().describe("Search query — matched case-insensitively against document labels (substring match)."),
 		rootId: z.string().optional().describe("Restrict search to descendants of this document. Omit to search the entire tree.")
 	}, async ({ query, rootId }) => {
+		server.setAutoStatus("searching");
+		server.setActiveToolCall({
+			name: "find_document",
+			target: query
+		});
 		const treeMap = server.getTreeMap();
-		if (!treeMap) return { content: [{
-			type: "text",
-			text: "Not connected"
-		}] };
+		if (!treeMap) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: "Not connected"
+			}] };
+		}
 		const entries = readEntries$1(treeMap);
 		const lowerQuery = query.toLowerCase();
 		const normalizedRoot = normalizeRootId(rootId, server);
@@ -19966,6 +19988,7 @@ function registerTreeTools(mcp, server) {
 				path
 			};
 		});
+		server.setActiveToolCall(null);
 		if (results.length === 0) return { content: [{
 			type: "text",
 			text: `No documents found matching "${query}". Try get_document_tree to see the full hierarchy.`
@@ -20025,21 +20048,33 @@ function registerTreeTools(mcp, server) {
 		id: z.string().describe("Document ID to rename."),
 		label: z.string().describe("New display name.")
 	}, async ({ id, label }) => {
+		server.setAutoStatus("writing");
+		server.setActiveToolCall({
+			name: "rename_document",
+			target: id
+		});
 		const treeMap = server.getTreeMap();
-		if (!treeMap) return { content: [{
-			type: "text",
-			text: "Not connected"
-		}] };
+		if (!treeMap) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: "Not connected"
+			}] };
+		}
 		const entry = treeMap.get(id);
-		if (!entry) return { content: [{
-			type: "text",
-			text: `Document ${id} not found`
-		}] };
+		if (!entry) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: `Document ${id} not found`
+			}] };
+		}
 		treeMap.set(id, {
 			...entry,
 			label,
 			updatedAt: Date.now()
 		});
+		server.setActiveToolCall(null);
 		return { content: [{
 			type: "text",
 			text: `Renamed to "${label}"`
@@ -20050,35 +20085,55 @@ function registerTreeTools(mcp, server) {
 		newParentId: z.string().optional().describe("New parent document ID. Omit to move to top level."),
 		order: z.number().optional().describe("New sort order. Defaults to Date.now() (append to end).")
 	}, async ({ id, newParentId, order }) => {
+		server.setAutoStatus("writing");
+		server.setActiveToolCall({
+			name: "move_document",
+			target: id
+		});
 		const treeMap = server.getTreeMap();
-		if (!treeMap) return { content: [{
-			type: "text",
-			text: "Not connected"
-		}] };
+		if (!treeMap) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: "Not connected"
+			}] };
+		}
 		const entry = treeMap.get(id);
-		if (!entry) return { content: [{
-			type: "text",
-			text: `Document ${id} not found`
-		}] };
+		if (!entry) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: `Document ${id} not found`
+			}] };
+		}
 		treeMap.set(id, {
 			...entry,
 			parentId: normalizeRootId(newParentId, server),
 			order: order ?? Date.now(),
 			updatedAt: Date.now()
 		});
+		server.setActiveToolCall(null);
 		return { content: [{
 			type: "text",
 			text: `Moved ${id} to parent ${newParentId}`
 		}] };
 	});
 	mcp.tool("delete_document", "Soft-delete a document and its descendants (moves to trash).", { id: z.string().describe("Document ID to delete.") }, async ({ id }) => {
+		server.setAutoStatus("writing");
+		server.setActiveToolCall({
+			name: "delete_document",
+			target: id
+		});
 		const treeMap = server.getTreeMap();
 		const trashMap = server.getTrashMap();
 		const rootDoc = server.rootDocument;
-		if (!treeMap || !trashMap || !rootDoc) return { content: [{
-			type: "text",
-			text: "Not connected"
-		}] };
+		if (!treeMap || !trashMap || !rootDoc) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: "Not connected"
+			}] };
+		}
 		const toDelete = [id, ...descendantsOf(readEntries$1(treeMap), id).map((e) => e.id)];
 		const now = Date.now();
 		rootDoc.transact(() => {
@@ -20096,6 +20151,7 @@ function registerTreeTools(mcp, server) {
 				treeMap.delete(nid);
 			}
 		});
+		server.setActiveToolCall(null);
 		return { content: [{
 			type: "text",
 			text: `Deleted ${toDelete.length} document(s)`
@@ -20105,21 +20161,33 @@ function registerTreeTools(mcp, server) {
 		id: z.string().describe("Document ID."),
 		type: z.string().describe("New page type (e.g. \"doc\", \"kanban\", \"table\", \"calendar\", \"outline\", \"gallery\", \"slides\", \"timeline\", \"whiteboard\", \"map\", \"dashboard\", \"mindmap\", \"graph\").")
 	}, async ({ id, type }) => {
+		server.setAutoStatus("writing");
+		server.setActiveToolCall({
+			name: "change_document_type",
+			target: id
+		});
 		const treeMap = server.getTreeMap();
-		if (!treeMap) return { content: [{
-			type: "text",
-			text: "Not connected"
-		}] };
+		if (!treeMap) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: "Not connected"
+			}] };
+		}
 		const entry = treeMap.get(id);
-		if (!entry) return { content: [{
-			type: "text",
-			text: `Document ${id} not found`
-		}] };
+		if (!entry) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: `Document ${id} not found`
+			}] };
+		}
 		treeMap.set(id, {
 			...entry,
 			type,
 			updatedAt: Date.now()
 		});
+		server.setActiveToolCall(null);
 		return { content: [{
 			type: "text",
 			text: `Changed type to "${type}"`
@@ -21416,16 +21484,28 @@ function registerContentTools(mcp, server) {
 //#region packages/mcp/src/tools/meta.ts
 function registerMetaTools(mcp, server) {
 	mcp.tool("get_metadata", "Read the metadata (PageMeta) of a document from the tree.", { docId: z.string().describe("Document ID.") }, async ({ docId }) => {
+		server.setAutoStatus("reading", docId);
+		server.setActiveToolCall({
+			name: "get_metadata",
+			target: docId
+		});
 		const treeMap = server.getTreeMap();
-		if (!treeMap) return { content: [{
-			type: "text",
-			text: "Not connected"
-		}] };
+		if (!treeMap) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: "Not connected"
+			}] };
+		}
 		const entry = treeMap.get(docId);
-		if (!entry) return { content: [{
-			type: "text",
-			text: `Document ${docId} not found`
-		}] };
+		if (!entry) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: `Document ${docId} not found`
+			}] };
+		}
+		server.setActiveToolCall(null);
 		return { content: [{
 			type: "text",
 			text: JSON.stringify({
@@ -21440,16 +21520,27 @@ function registerMetaTools(mcp, server) {
 		docId: z.string().describe("Document ID."),
 		meta: z.record(z.unknown()).describe("Metadata fields to update (merged with existing). Universal keys: color (hex), icon (Lucide kebab-case — NEVER emoji), dateStart/dateEnd, datetimeStart/datetimeEnd, allDay, tags (string[]), checked (bool), priority (0=none,1=low,2=med,3=high,4=urgent), status, rating (0-5), url, email, phone, number, unit, subtitle, note, taskProgress (0-100), members ({id,label}[]), coverUploadId. Geo/Map: geoType (\"marker\"|\"line\"|\"measure\"), geoLat, geoLng, geoDescription. Spatial 3D: spShape (\"box\"|\"sphere\"|\"cylinder\"|\"cone\"|\"plane\"|\"torus\"|\"glb\"), spX/spY/spZ, spRX/spRY/spRZ, spSX/spSY/spSZ, spColor, spOpacity (0-100). Dashboard: deskX, deskY, deskZ, deskMode (\"icon\"|\"widget-sm\"|\"widget-lg\"). Renderer config (on the page doc itself): kanbanColumnWidth, galleryColumns, galleryAspect, calendarView, calendarWeekStart, tableMode, showRefEdges. Set a key to null to clear it.")
 	}, async ({ docId, meta }) => {
+		server.setAutoStatus("writing", docId);
+		server.setActiveToolCall({
+			name: "update_metadata",
+			target: docId
+		});
 		const treeMap = server.getTreeMap();
-		if (!treeMap) return { content: [{
-			type: "text",
-			text: "Not connected"
-		}] };
+		if (!treeMap) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: "Not connected"
+			}] };
+		}
 		const entry = treeMap.get(docId);
-		if (!entry) return { content: [{
-			type: "text",
-			text: `Document ${docId} not found`
-		}] };
+		if (!entry) {
+			server.setActiveToolCall(null);
+			return { content: [{
+				type: "text",
+				text: `Document ${docId} not found`
+			}] };
+		}
 		treeMap.set(docId, {
 			...entry,
 			meta: {
@@ -21458,6 +21549,7 @@ function registerMetaTools(mcp, server) {
 			},
 			updatedAt: Date.now()
 		});
+		server.setActiveToolCall(null);
 		return { content: [{
 			type: "text",
 			text: `Metadata updated for ${docId}`
@@ -22523,6 +22615,13 @@ async function main() {
 		capabilities: { experimental: { "claude/channel": {} } },
 		instructions: `Abracadabra is a CRDT collaboration platform where everything is a document in a tree.
 
+## CRITICAL: Responding to Channel Events
+The user CANNOT see your plain text output — they only see messages sent via MCP tools. When you receive a channel event:
+- **Chat messages**: Use send_chat_message with the SAME channel for ALL replies AND progress updates.
+- **AI tasks**: Use reply tool for the final response; use send_chat_message for progress updates.
+- For multi-step work, send brief status updates via send_chat_message so the user sees progress.
+- NEVER output plain text as a response or status update — it is invisible to the user.
+
 ## Quick Start Workflow
 1. list_spaces → note the active space's doc_id (this is the hub/root document)
 2. get_document_tree(rootId: hubDocId) → see the FULL hierarchy before doing anything
@@ -22532,12 +22631,12 @@ async function main() {
 ## Key Concepts
 - Documents form a tree. A kanban board's columns are child documents; cards are grandchildren.
 - A document's label IS its display name everywhere. Children ARE the content (not just the body text).
-- Page types (doc, kanban, table, calendar, timeline, checklist, outline, gallery, map, graph, dashboard, spatial, media, mindmap, etc.) are views over the SAME tree — switching types preserves data.
+- Page types are views over the SAME tree — switching types preserves data.
 - An empty markdown body does NOT mean empty content — always check the children array.
 - Use ![[docId]] in content to embed another document, or [[docId|label]] for inline links.
 
 ## Finding Documents
-- list_documents only shows ONE level of children. If you don't find what you need, use find_document to search the entire tree by name, or get_document_tree to see the full hierarchy.
+- list_documents only shows ONE level of children. Use find_document to search by name, or get_document_tree to see the full hierarchy.
 - NEVER conclude a document doesn't exist after only checking root-level documents.
 
 ## Rules
@@ -22547,12 +22646,6 @@ async function main() {
 - Never rename or write content to the hub document itself.
 - Use universal meta keys (color, icon, dateStart) — never prefix with page type names.
 
-## Channel Events
-Events from the abracadabra channel arrive as <channel source="abracadabra" ...>. They may be:
-- ai:task events from human users (includes sender, doc_id context)
-- chat messages from the platform chat system (includes channel, sender, sender_id)
-When you receive a channel event, read it, do the work using your tools, and reply using the reply tool (for document responses) or send_chat_message (for chat responses).
-
 ## Full Reference
 Read the resource at abracadabra://agent-guide for the complete guide covering page type schemas, metadata reference, awareness/presence, content structure, and detailed examples.`
 	});