@abraca/mcp 1.8.0 → 1.8.1

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}"` }] }
     }
   )