@abraca/mcp 1.0.12 → 1.0.18

package/src/tools/content.ts

@@ -17,6 +17,9 @@ export function registerContentTools(mcp: McpServer, server: AbracadabraMCPServe
     },
     async ({ docId }) => {
       try {
+        server.setAutoStatus('reading', docId)
+        server.setActiveToolCall({ name: 'read_document', target: docId })
+
         const provider = await server.getChildProvider(docId)
         const fragment = provider.document.getXmlFragment('default')
 
@@ -48,6 +51,8 @@ export function registerContentTools(mcp: McpServer, server: AbracadabraMCPServe
           children.sort((a: any, b: any) => ((treeMap.get(a.id)?.order ?? 0) - (treeMap.get(b.id)?.order ?? 0)))
         }
 
+        server.setActiveToolCall(null)
+
         const result: Record<string, unknown> = { label, type, meta, markdown, children }
         return {
           content: [{
@@ -56,6 +61,7 @@ export function registerContentTools(mcp: McpServer, server: AbracadabraMCPServe
           }],
         }
       } catch (error: any) {
+        server.setActiveToolCall(null)
         return {
           content: [{ type: 'text', text: `Error reading document: ${error.message}` }],
           isError: true,
@@ -66,7 +72,7 @@ export function registerContentTools(mcp: McpServer, server: AbracadabraMCPServe
 
   mcp.tool(
     'write_document',
-    'Write markdown content to a document. Parses the markdown and writes it to the Y.js CRDT document, which syncs in real-time to all connected clients. Supports optional YAML frontmatter for title and metadata.',
+    'Write markdown content to a document. Parses the markdown and writes it to the Y.js CRDT document, which syncs in real-time to all connected clients. Supports optional YAML frontmatter for title and metadata. Use ![[docId]] to embed another document as a block, or [[docId|label]] for inline doc links.',
     {
       docId: z.string().describe('Document ID to write to.'),
       markdown: z.string().describe('Markdown content to write. Can include YAML frontmatter with title and metadata fields.'),
@@ -74,6 +80,9 @@ export function registerContentTools(mcp: McpServer, server: AbracadabraMCPServe
     },
     async ({ docId, markdown, mode }) => {
       try {
+        server.setAutoStatus('writing', docId)
+        server.setActiveToolCall({ name: 'write_document', target: docId })
+
         const writeMode = mode ?? 'replace'
         const provider = await server.getChildProvider(docId)
         const doc = provider.document
@@ -119,10 +128,13 @@ export function registerContentTools(mcp: McpServer, server: AbracadabraMCPServe
         server.setFocusedDoc(docId)
         server.setDocCursor(docId, fragment.length)
 
+        server.setActiveToolCall(null)
+
         return {
           content: [{ type: 'text', text: `Document ${docId} updated (${writeMode} mode)` }],
         }
       } catch (error: any) {
+        server.setActiveToolCall(null)
         return {
           content: [{ type: 'text', text: `Error writing document: ${error.message}` }],
           isError: true,

package/src/tools/hooks.ts

@@ -0,0 +1,42 @@
+/**
+ * Hook tools — provides Claude Code hook configuration for activity bridging.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
+import type { HookBridge } from '../hook-bridge.ts'
+
+export function registerHookTools(mcp: McpServer, hookBridge: HookBridge) {
+  mcp.tool(
+    'get_hook_config',
+    'Returns Claude Code hook configuration JSON for bridging activity to the Abracadabra dashboard. Copy the "hooks" object into your .claude/settings.local.json to enable real-time activity indicators (tool calls, subagents, etc.) visible to all connected users.',
+    {},
+    async () => {
+      const port = hookBridge.port
+      if (!port) {
+        return {
+          content: [{ type: 'text', text: 'Hook bridge is not running.' }],
+          isError: true,
+        }
+      }
+
+      const url = `http://127.0.0.1:${port}/hook`
+      const hookEntry = { type: 'http', url, timeout: 3 }
+
+      const config = {
+        hooks: {
+          PreToolUse: [{ hooks: [hookEntry] }],
+          PostToolUse: [{ hooks: [hookEntry] }],
+          SubagentStart: [{ hooks: [hookEntry] }],
+          SubagentStop: [{ hooks: [hookEntry] }],
+          Stop: [{ hooks: [hookEntry] }],
+        },
+      }
+
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify(config, null, 2),
+        }],
+      }
+    },
+  )
+}

package/src/tools/meta.ts

@@ -38,7 +38,7 @@ export function registerMetaTools(mcp: McpServer, server: AbracadabraMCPServer)
     'Update metadata fields on a document. Merges the provided fields into existing metadata.',
     {
       docId: z.string().describe('Document ID.'),
-      meta: z.record(z.unknown()).describe('Metadata fields to update (merged with existing). Standard PageMeta keys: color (hex string), icon (Lucide kebab-case name like "star"/"code-2"/"users" — NEVER emoji), dateStart, dateEnd, datetimeStart, datetimeEnd, allDay, tags, checked, priority (0-4), status, rating, url, taskProgress (0-100), subtitle, note. Set a key to null to clear it.'),
+      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 }) => {
       const treeMap = server.getTreeMap()

package/src/tools/tree.ts

@@ -182,13 +182,19 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
     {
       parentId: z.string().optional().describe('Parent document ID. Omit for top-level pages. Use a document ID for nested/child pages.'),
       label: z.string().describe('Display name / title for the document.'),
-      type: z.string().optional().describe('Page type: "doc", "kanban", "calendar", "table", "outline", "gallery", "slides", "timeline", "whiteboard", "map", "dashboard", "mindmap", "graph". Omit to inherit parent view.'),
+      type: z.string().optional().describe('Page type — sets how this document renders. "doc" (rich text), "kanban" (columns → cards), "table" (columns → cells, positional rows), "calendar" (events with datetimeStart/End), "timeline" (epics → tasks with dateStart/End + taskProgress), "checklist" (tasks with checked/priority, unlimited nesting), "outline" (nested items, unlimited depth), "gallery" (image/media items), "map" (markers/lines with geoLat/geoLng), "graph" (knowledge graph nodes), "dashboard" (positioned widgets with deskX/deskY/deskMode), "mindmap" (connected nodes), "spatial" (3D objects with spShape/spX/spY/spZ), "media" (audio/video tracks), "slides" (slide deck), "whiteboard" (freeform canvas). Omit to inherit parent view. Only set on the parent page, NEVER on child items.'),
       meta: z.record(z.unknown()).optional().describe('Initial metadata (PageMeta fields: color as hex string, icon as Lucide kebab-case name like "star"/"code-2"/"users" — never emoji, dateStart, dateEnd, priority 0-4, tags array, etc). Omit icon entirely to use page type default.'),
     },
     async ({ parentId, label, type, meta }) => {
+      server.setAutoStatus('creating')
+      server.setActiveToolCall({ name: 'create_document', target: label })
+
       const treeMap = server.getTreeMap()
       const rootDoc = server.rootDocument
-      if (!treeMap || !rootDoc) return { content: [{ type: 'text', text: 'Not connected' }] }
+      if (!treeMap || !rootDoc) {
+        server.setActiveToolCall(null)
+        return { content: [{ type: 'text', text: 'Not connected' }] }
+      }
 
       const id = crypto.randomUUID()
       const normalizedParent = normalizeRootId(parentId, server)
@@ -205,6 +211,9 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
         })
       })
 
+      server.setFocusedDoc(id)
+      server.setActiveToolCall(null)
+
       return {
         content: [{
           type: 'text',
@@ -360,6 +369,8 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
         order: Date.now(),
       })
 
+      server.setFocusedDoc(newId)
+
       return {
         content: [{
           type: 'text',