@abraca/mcp 1.8.0 → 1.9.1

package/src/tools/channel.ts

@@ -23,7 +23,6 @@ export function registerChannelTools(mcp: McpServer, server: AbracadabraMCPServe
         const treeMap = server.getTreeMap()
         const rootDoc = server.rootDocument
         if (!treeMap || !rootDoc) {
-          server.setActiveToolCall(null)
           return { content: [{ type: 'text' as const, text: 'Not connected' }], isError: true }
         }
 
@@ -51,13 +50,11 @@ export function registerChannelTools(mcp: McpServer, server: AbracadabraMCPServe
           server.clearAiTask(task_id)
         }
 
-        server.setActiveToolCall(null)
 
         return {
           content: [{ type: 'text' as const, text: JSON.stringify({ replyDocId: replyId, parentId: doc_id }) }],
         }
       } catch (error: any) {
-        server.setActiveToolCall(null)
         return {
           content: [{ type: 'text' as const, text: `Error: ${error.message}` }],
           isError: true,
@@ -80,17 +77,30 @@ export function registerChannelTools(mcp: McpServer, server: AbracadabraMCPServe
           return { content: [{ type: 'text' as const, text: 'Not connected' }], isError: true }
         }
 
+        // Normalize literal escape sequences. Some LLM outputs emit the
+        // 2-char `\n` / `\t` / `\r` instead of the real control chars, which
+        // then render literally in the chat (markdown renderer can't see a
+        // newline where there is just "\n"). Convert them back to real chars.
+        const normalized = text
+          .replace(/\\r\\n/g, '\n')
+          .replace(/\\n/g, '\n')
+          .replace(/\\t/g, '\t')
+          .replace(/\\r/g, '\n')
+
+        // Order matters: clear status + tool pill FIRST so the dashboard's
+        // typing-indicator filter (which hides typing while an activeToolCall
+        // exists) doesn't swallow the burst. Then emit the typing frame, then
+        // the actual chat:send. The clear also flushes toolHistory + turnId.
+        server.setAutoStatus(null)
+        server.sendTypingIndicator(channel)
+
         rootProvider.sendStateless(JSON.stringify({
           type: 'chat:send',
           channel,
-          content: text,
+          content: normalized,
           sender_name: server.agentName,
         }))
 
-        // Clear thinking/typing status after sending the reply
-        server.setAutoStatus(null)
-        server.setActiveToolCall(null)
-
         return { content: [{ type: 'text' as const, text: `Sent to ${channel}` }] }
       } catch (error: any) {
         return {

package/src/tools/content.ts

@@ -51,8 +51,6 @@ 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: [{
@@ -61,7 +59,6 @@ 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,
@@ -128,13 +125,11 @@ 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/files.ts

@@ -15,6 +15,8 @@ export function registerFileTools(mcp: McpServer, server: AbracadabraMCPServer)
       docId: z.string().describe('Document ID.'),
     },
     async ({ docId }) => {
+      server.setAutoStatus('reading', docId)
+      server.setActiveToolCall({ name: 'list_uploads', target: docId })
       try {
         const uploads = await server.client.listUploads(docId)
         return {
@@ -41,6 +43,8 @@ export function registerFileTools(mcp: McpServer, server: AbracadabraMCPServer)
       filename: z.string().optional().describe('Override filename (defaults to basename of filePath).'),
     },
     async ({ docId, filePath, filename }) => {
+      server.setAutoStatus('uploading', docId)
+      server.setActiveToolCall({ name: 'upload_file', target: path.basename(filePath) })
       try {
         const resolvedPath = path.resolve(filePath)
         const data = fs.readFileSync(resolvedPath)
@@ -71,6 +75,8 @@ export function registerFileTools(mcp: McpServer, server: AbracadabraMCPServer)
       saveTo: z.string().describe('Absolute local file path to save the download.'),
     },
     async ({ docId, uploadId, saveTo }) => {
+      server.setAutoStatus('reading', docId)
+      server.setActiveToolCall({ name: 'download_file', target: path.basename(saveTo) })
       try {
         const blob = await server.client.getUpload(docId, uploadId)
         const buffer = Buffer.from(await blob.arrayBuffer())
@@ -96,6 +102,8 @@ export function registerFileTools(mcp: McpServer, server: AbracadabraMCPServer)
       uploadId: z.string().describe('Upload ID to delete.'),
     },
     async ({ docId, uploadId }) => {
+      server.setAutoStatus('writing', docId)
+      server.setActiveToolCall({ name: 'delete_file', target: uploadId })
       try {
         await server.client.deleteUpload(docId, uploadId)
         return { content: [{ type: 'text', text: `Deleted upload ${uploadId}` }] }

package/src/tools/meta.ts

@@ -17,17 +17,14 @@ export function registerMetaTools(mcp: McpServer, server: AbracadabraMCPServer)
       server.setActiveToolCall({ name: 'get_metadata', target: docId })
       const treeMap = server.getTreeMap()
       if (!treeMap) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: 'Not connected' }] }
       }
 
       const entry = treeMap.get(docId)
       if (!entry) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: `Document ${docId} not found` }] }
       }
 
-      server.setActiveToolCall(null)
       return {
         content: [{
           type: 'text',
@@ -47,20 +44,18 @@ 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). Universal keys: color (hex), icon (Lucide kebab-case — NEVER emoji), dateStart/dateEnd, datetimeStart/datetimeEnd, allDay, timeStart/timeEnd, 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, coverDocId, dateTaken. Geo/Map (children): geoType ("marker"|"line"|"measure"), geoLat, geoLng, geoDescription. Spatial 3D (children, plugin: spatial): spShape ("box"|"sphere"|"cylinder"|"cone"|"plane"|"torus"|"glb"), spX/spY/spZ, spRX/spRY/spRZ (deg), spSX/spSY/spSZ (scale), spOpacity (0-100), spModelUploadId, spModelDocId — spatial uses the universal `color` key, NOT spColor. Dashboard (children): deskX, deskY, deskZ, deskMode ("icon"|"widget-sm"|"widget-lg"). Mindmap-layout (children): mmX, mmY. Graph-layout (children): graphX, graphY, graphPinned. Slides (children): slidesTransition ("none"|"fade"|"slide"). Coder (children, plugin: coder): fileType ("vue"|"ts"|"js"|"css"|"json"|"folder"), entry (bool). Cell formatting (sheets cells): bold, italic, textColor, bgColor, align ("left"|"center"|"right"), formula. Renderer config (on the PAGE doc itself, not children): kanbanColumnWidth ("narrow"|"default"|"wide"), galleryColumns (1-6), galleryAspect ("square"|"4:3"|"3:2"|"16:9"|"free"), galleryCardStyle ("default"|"compact"|"detailed"), galleryShowLabels, gallerySortBy ("manual"|"date"|"name"|"rating"), calendarView ("month"|"week"|"day"), calendarWeekStart ("sun"|"mon"), calendarShowWeekNumbers, tableMode ("hierarchy"|"flat"), tableSortKey, tableSortDir ("asc"|"desc"), timelineZoom ("week"|"month"|"quarter"), timelinePixelsPerDay, timelineCenterDate (ISO date), checklistFilter ("all"|"active"|"completed"), checklistSort ("manual"|"priority"|"due"), mapShowLabels, graphSpacing ("compact"|"default"|"spacious"), graphShowLabels, graphEdgeThickness ("thin"|"normal"|"thick"), showRefEdges, mmSpacing, spatialGridVisible, slidesTheme ("dark"|"light"), chartType ("bar"|"stacked bar"|"line"|"donut"|"treemap"), chartMetric ("value"|"type"|"tag"|"status"|"priority"|"activity"|"completion"), chartColorScheme ("default"|"warm"|"cool"|"mono"), chartLimit (3-30), chartShowLegend, chartShowValues, sheetsDefaultColWidth (40-500), sheetsDefaultRowHeight (20-100), sheetsShowGridlines, sheetsFreezeRows, sheetsFreezeCols, mediaRepeat ("off"|"all"|"one"), mediaShuffle. Set a key to null to clear it.'),
+      meta: z.record(z.string(), 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, timeStart/timeEnd, 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, coverDocId, dateTaken. Geo/Map (children): geoType ("marker"|"line"|"measure"), geoLat, geoLng, geoDescription. Spatial 3D (children, plugin: spatial): spShape ("box"|"sphere"|"cylinder"|"cone"|"plane"|"torus"|"glb"), spX/spY/spZ, spRX/spRY/spRZ (deg), spSX/spSY/spSZ (scale), spOpacity (0-100), spModelUploadId, spModelDocId — spatial uses the universal `color` key, NOT spColor. Dashboard (children): deskX, deskY, deskZ, deskMode ("icon"|"widget-sm"|"widget-lg"). Mindmap-layout (children): mmX, mmY. Graph-layout (children): graphX, graphY, graphPinned. Slides (children): slidesTransition ("none"|"fade"|"slide"). Coder (children, plugin: coder): fileType ("vue"|"ts"|"js"|"css"|"json"|"folder"), entry (bool). Cell formatting (sheets cells): bold, italic, textColor, bgColor, align ("left"|"center"|"right"), formula. Renderer config (on the PAGE doc itself, not children): kanbanColumnWidth ("narrow"|"default"|"wide"), galleryColumns (1-6), galleryAspect ("square"|"4:3"|"3:2"|"16:9"|"free"), galleryCardStyle ("default"|"compact"|"detailed"), galleryShowLabels, gallerySortBy ("manual"|"date"|"name"|"rating"), calendarView ("month"|"week"|"day"), calendarWeekStart ("sun"|"mon"), calendarShowWeekNumbers, tableMode ("hierarchy"|"flat"), tableSortKey, tableSortDir ("asc"|"desc"), timelineZoom ("week"|"month"|"quarter"), timelinePixelsPerDay, timelineCenterDate (ISO date), checklistFilter ("all"|"active"|"completed"), checklistSort ("manual"|"priority"|"due"), mapShowLabels, graphSpacing ("compact"|"default"|"spacious"), graphShowLabels, graphEdgeThickness ("thin"|"normal"|"thick"), showRefEdges, mmSpacing, spatialGridVisible, slidesTheme ("dark"|"light"), chartType ("bar"|"stacked bar"|"line"|"donut"|"treemap"), chartMetric ("value"|"type"|"tag"|"status"|"priority"|"activity"|"completion"), chartColorScheme ("default"|"warm"|"cool"|"mono"), chartLimit (3-30), chartShowLegend, chartShowValues, sheetsDefaultColWidth (40-500), sheetsDefaultRowHeight (20-100), sheetsShowGridlines, sheetsFreezeRows, sheetsFreezeCols, mediaRepeat ("off"|"all"|"one"), mediaShuffle. 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) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: 'Not connected' }] }
       }
 
       const entry = treeMap.get(docId)
       if (!entry) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: `Document ${docId} not found` }] }
       }
 
@@ -70,7 +65,6 @@ export function registerMetaTools(mcp: McpServer, server: AbracadabraMCPServer)
         updatedAt: Date.now(),
       })
 
-      server.setActiveToolCall(null)
       return { content: [{ type: 'text', text: `Metadata updated for ${docId}` }] }
     }
   )

package/src/tools/svg.ts

@@ -43,7 +43,6 @@ export function registerSvgTools(mcp: McpServer, server: AbracadabraMCPServer) {
 
         const cleanSvg = sanitizeSvg(svg)
         if (!cleanSvg) {
-          server.setActiveToolCall(null)
           return {
             content: [{ type: 'text', text: 'Error: SVG markup was empty or entirely stripped by sanitizer.' }],
             isError: true,
@@ -66,13 +65,11 @@ export function registerSvgTools(mcp: McpServer, server: AbracadabraMCPServer) {
         })
 
         server.setFocusedDoc(docId)
-        server.setActiveToolCall(null)
 
         return {
           content: [{ type: 'text', text: `SVG inserted into document ${docId}${title ? ` ("${title}")` : ''}` }],
         }
       } catch (error: any) {
-        server.setActiveToolCall(null)
         return {
           content: [{ type: 'text', text: `Error writing SVG: ${error.message}` }],
           isError: true,

package/src/tools/tree.ts

@@ -90,7 +90,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       server.setActiveToolCall({ name: 'list_documents' })
       const treeMap = server.getTreeMap()
       if (!treeMap) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: 'Not connected' }] }
       }
 
@@ -98,7 +97,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       const entries = readEntries(treeMap)
       const children = childrenOf(entries, targetId)
 
-      server.setActiveToolCall(null)
       return {
         content: [{
           type: 'text',
@@ -120,7 +118,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       server.setActiveToolCall({ name: 'get_document_tree' })
       const treeMap = server.getTreeMap()
       if (!treeMap) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: 'Not connected' }] }
       }
 
@@ -129,7 +126,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       const entries = readEntries(treeMap)
       const tree = buildTree(entries, targetId, maxDepth)
 
-      server.setActiveToolCall(null)
       return {
         content: [{
           type: 'text',
@@ -151,7 +147,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       server.setActiveToolCall({ name: 'find_document', target: query })
       const treeMap = server.getTreeMap()
       if (!treeMap) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: 'Not connected' }] }
       }
 
@@ -189,7 +184,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
         }
       })
 
-      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.` }],
@@ -209,7 +203,7 @@ 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 — sets how this document renders. Core types (always available): "doc" (rich text), "kanban" (columns → cards), "table" (columns → rows, positional), "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" (visual grid with covers/ratings), "map" (markers/lines with geoLat/geoLng), "graph" (force-directed knowledge graph), "dashboard" (positioned widgets with deskX/deskY/deskMode), "slides" (slides → sub-slides with transitions), "chart" (bar/stacked bar/line/donut/treemap from data points or aggregation), "sheets" (spreadsheet with formulas and formatting), "overview" (space home — activity and stats), "call" (video call room, no children). Plugin types (require plugin enabled on the server): "spatial" (3D scene with spShape/spX/spY/spZ + universal color, plugin: spatial), "media" (audio/video player with playlists, plugin: media), "coder" (collaborative multi-file coding env with fileType/entry, plugin: coder). Alias: "desktop" → "dashboard". 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.'),
+      meta: z.record(z.string(), 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')
@@ -218,7 +212,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       const treeMap = server.getTreeMap()
       const rootDoc = server.rootDocument
       if (!treeMap || !rootDoc) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: 'Not connected' }] }
       }
 
@@ -238,7 +231,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       })
 
       server.setFocusedDoc(id)
-      server.setActiveToolCall(null)
 
       return {
         content: [{
@@ -261,19 +253,16 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       server.setActiveToolCall({ name: 'rename_document', target: id })
       const treeMap = server.getTreeMap()
       if (!treeMap) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: 'Not connected' }] }
       }
 
       const raw = treeMap.get(id)
       if (!raw) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: `Document ${id} not found` }] }
       }
 
       const entry = toPlain(raw)
       treeMap.set(id, { ...entry, label, updatedAt: Date.now() })
-      server.setActiveToolCall(null)
       return { content: [{ type: 'text', text: `Renamed to "${label}"` }] }
     }
   )
@@ -291,13 +280,11 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       server.setActiveToolCall({ name: 'move_document', target: id })
       const treeMap = server.getTreeMap()
       if (!treeMap) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: 'Not connected' }] }
       }
 
       const raw = treeMap.get(id)
       if (!raw) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: `Document ${id} not found` }] }
       }
 
@@ -308,7 +295,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
         order: order ?? Date.now(),
         updatedAt: Date.now(),
       })
-      server.setActiveToolCall(null)
       return { content: [{ type: 'text', text: `Moved ${id} to parent ${newParentId}` }] }
     }
   )
@@ -326,7 +312,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       const trashMap = server.getTrashMap()
       const rootDoc = server.rootDocument
       if (!treeMap || !trashMap || !rootDoc) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: 'Not connected' }] }
       }
 
@@ -351,7 +336,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
         }
       })
 
-      server.setActiveToolCall(null)
       return { content: [{ type: 'text', text: `Deleted ${toDelete.length} document(s)` }] }
     }
   )
@@ -368,19 +352,16 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       server.setActiveToolCall({ name: 'change_document_type', target: id })
       const treeMap = server.getTreeMap()
       if (!treeMap) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: 'Not connected' }] }
       }
 
       const raw = treeMap.get(id)
       if (!raw) {
-        server.setActiveToolCall(null)
         return { content: [{ type: 'text', text: `Document ${id} not found` }] }
       }
 
       const entry = toPlain(raw)
       treeMap.set(id, { ...entry, type, updatedAt: Date.now() })
-      server.setActiveToolCall(null)
       return { content: [{ type: 'text', text: `Changed type to "${type}"` }] }
     }
   )