@abraca/mcp 1.6.0 → 1.8.1

package/src/tools/awareness.ts

@@ -38,6 +38,7 @@ export function registerAwarenessTools(mcp: McpServer, server: AbracadabraMCPSer
       fields: z.record(z.string(), z.unknown()).describe('Key-value pairs to set on the child document\'s awareness state. Use namespaced keys like "kanban:hovering", "table:editing", "slides:viewing", "outline:editing", "calendar:focused", "gallery:focused", "timeline:focused", "graph:focused", "map:focused", "doc:scroll". Set a key to null to clear it.'),
     },
     async ({ docId, fields }) => {
+      server.setActiveToolCall({ name: 'set_doc_awareness', target: docId })
       try {
         const provider = await server.getChildProvider(docId)
         for (const [key, value] of Object.entries(fields)) {
@@ -58,6 +59,7 @@ export function registerAwarenessTools(mcp: McpServer, server: AbracadabraMCPSer
     'Check the "AI Inbox" document for pending instructions from humans. Returns the inbox content and any pending task sub-documents. Create the inbox as a doc called "AI Inbox" under the hub doc if it does not exist yet. Note: channel-based watching via watch_chat is preferred for real-time use.',
     {},
     async () => {
+      server.setActiveToolCall({ name: 'poll_inbox' })
       try {
         const treeMap = server.getTreeMap()
         const rootDocId = server.rootDocId
@@ -124,6 +126,7 @@ export function registerAwarenessTools(mcp: McpServer, server: AbracadabraMCPSer
       docId: z.string().optional().describe('If provided, list users connected to this specific document. Otherwise lists users from root awareness.'),
     },
     async ({ docId }) => {
+      server.setActiveToolCall({ name: 'list_connected_users', target: docId })
       try {
         let awareness
         if (docId) {

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, 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"). Slides: slidesTransition ("none"|"fade"|"slide"), slidesTheme ("dark"|"light"). Chart: chartType ("bar"|"stacked bar"|"line"|"donut"|"treemap"), chartMetric, chartColorScheme, chartLimit, chartShowLegend, chartShowValues. Sheets: sheetsDefaultColWidth, sheetsDefaultRowHeight, sheetsShowGridlines, sheetsFreezeRows, sheetsFreezeCols. Cell formatting: bold, italic, textColor, bgColor, align, formula. Renderer config (on the page doc itself): kanbanColumnWidth, galleryColumns, galleryAspect, galleryCardStyle, galleryShowLabels, gallerySortBy, calendarView, calendarWeekStart, calendarShowWeekNumbers, tableMode, tableSortDir, checklistFilter, checklistSort, mapShowLabels, spatialGridVisible, showRefEdges, mediaRepeat, 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

@@ -6,6 +6,7 @@ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
 import { z } from 'zod'
 import type { AbracadabraMCPServer } from '../server.ts'
 import type { TreeEntry, PageMeta } from '../converters/types.ts'
+import { PAGE_TYPES, TYPE_ALIASES, resolvePageType } from '../converters/page-types.ts'
 
 /**
  * Normalize a document ID so the hub/root doc ID is treated as the tree root (null).
@@ -89,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' }] }
       }
 
@@ -97,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',
@@ -119,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' }] }
       }
 
@@ -128,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',
@@ -150,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' }] }
       }
 
@@ -188,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.` }],
@@ -207,8 +202,8 @@ 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. "doc" (rich text), "kanban" (columns → cards), "table" (columns → rows with custom fields), "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), "spatial" (3D scene with spShape/spX/spY/spZ), "media" (audio/video player with playlists), "slides" (presentation with transitions), "chart" (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). 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.'),
+      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.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')
@@ -217,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' }] }
       }
 
@@ -237,7 +231,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       })
 
       server.setFocusedDoc(id)
-      server.setActiveToolCall(null)
 
       return {
         content: [{
@@ -260,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}"` }] }
     }
   )
@@ -290,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` }] }
       }
 
@@ -307,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}` }] }
     }
   )
@@ -325,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' }] }
       }
 
@@ -350,7 +336,6 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
         }
       })
 
-      server.setActiveToolCall(null)
       return { content: [{ type: 'text', text: `Deleted ${toDelete.length} document(s)` }] }
     }
   )
@@ -360,26 +345,23 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
     'Change the page type view of a document (data is preserved).',
     {
       id: z.string().describe('Document ID.'),
-      type: z.string().describe('New page type: "doc", "kanban", "table", "calendar", "timeline", "checklist", "outline", "gallery", "map", "graph", "dashboard", "spatial", "media", "slides", "chart", "sheets", "overview", "call".'),
+      type: z.string().describe('New page type. Core: "doc", "kanban", "table", "calendar", "timeline", "checklist", "outline", "gallery", "map", "graph", "dashboard", "slides", "chart", "sheets", "overview", "call". Plugin (require plugin enabled): "spatial", "media", "coder". Switching preserves the tree — children, labels, and meta are all retained; only the view changes.'),
     },
     async ({ id, type }) => {
       server.setAutoStatus('writing')
       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}"` }] }
     }
   )
@@ -442,4 +424,28 @@ export function registerTreeTools(mcp: McpServer, server: AbracadabraMCPServer)
       }
     }
   )
+
+  mcp.tool(
+    'list_page_types',
+    'Enumerate all known Abracadabra page types with their metadata schemas. Returns an array of { key, label, icon, description, core, plugin, supportsChildren, childLabel, grandchildLabel, defaultDepth, metaSchema, defaultMetaFields }. `metaSchema` describes fields that apply to DESCENDANTS (children, grandchildren, ...) of a page of this type. `defaultMetaFields` are view-config fields on the page doc itself. Plugin types (core: false) require the named plugin to be enabled on the server. Use this to discover what meta keys a given renderer supports instead of guessing.',
+    {
+      key: z.string().optional().describe('Filter to a single type by key (e.g. "kanban", "calendar"). Aliases are resolved (e.g. "desktop" → "dashboard"). Omit to list all types.'),
+    },
+    async ({ key }) => {
+      if (key) {
+        const resolved = resolvePageType(key)
+        if (!resolved) {
+          return { content: [{ type: 'text', text: `Unknown page type "${key}". Call list_page_types with no args to see all types.` }] }
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(resolved, null, 2) }] }
+      }
+      const all = Object.values(PAGE_TYPES)
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify({ types: all, aliases: TYPE_ALIASES }, null, 2),
+        }],
+      }
+    }
+  )
 }