@abraca/mcp 1.6.0 → 1.8.0

package/dist/abracadabra-mcp.esm.js

@@ -20145,6 +20145,17 @@ var AbracadabraMCPServer = class {
 	getTrashMap() {
 		return this._activeConnection?.doc.getMap("doc-trash") ?? null;
 	}
+	/** Get plugin names enabled in the active space via space-plugins Y.Map. */
+	getEnabledPluginNames() {
+		const doc = this._activeConnection?.doc;
+		if (!doc) return [];
+		const pluginsMap = doc.getMap("space-plugins");
+		const names = [];
+		pluginsMap.forEach((value, key) => {
+			if ((value?.toJSON ? value.toJSON() : value)?.enabled) names.push(key);
+		});
+		return names;
+	}
 	/**
 	* Get or create a child provider for a given document ID.
 	* Caches providers and waits for sync before returning.
@@ -20431,6 +20442,724 @@ function docToSpaceMeta(doc) {
 	};
 }
 
+//#endregion
+//#region packages/mcp/src/converters/page-types.ts
+const PAGE_TYPES = {
+	doc: {
+		key: "doc",
+		label: "Document",
+		icon: "file-text",
+		description: "Rich text document with real-time collaboration",
+		core: true,
+		supportsChildren: true
+	},
+	kanban: {
+		key: "kanban",
+		label: "Kanban",
+		icon: "kanban",
+		description: "Drag-and-drop task board with columns and cards",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Column",
+		grandchildLabel: "Card",
+		defaultMetaFields: [{
+			type: "select",
+			key: "kanbanColumnWidth",
+			options: [
+				"narrow",
+				"default",
+				"wide"
+			],
+			label: "Column Width"
+		}]
+	},
+	gallery: {
+		key: "gallery",
+		label: "Gallery",
+		icon: "images",
+		description: "Visual grid of items with rich content",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Item",
+		metaSchema: [
+			{
+				type: "location",
+				latKey: "geoLat",
+				lngKey: "geoLng",
+				label: "Location"
+			},
+			{
+				type: "datetime",
+				key: "datetimeStart",
+				label: "Date"
+			},
+			{
+				type: "tags",
+				key: "tags",
+				label: "Tags"
+			},
+			{
+				type: "rating",
+				key: "rating",
+				max: 5,
+				label: "Rating"
+			},
+			{
+				type: "icon",
+				key: "icon",
+				label: "Icon"
+			},
+			{
+				type: "colorPreset",
+				key: "color",
+				presets: [
+					"#6366f1",
+					"#ec4899",
+					"#f97316",
+					"#22c55e",
+					"#3b82f6",
+					"#a855f7"
+				],
+				label: "Color"
+			}
+		],
+		defaultMetaFields: [
+			{
+				type: "number",
+				key: "galleryColumns",
+				min: 1,
+				max: 6,
+				step: 1,
+				label: "Columns"
+			},
+			{
+				type: "select",
+				key: "galleryAspect",
+				options: [
+					"square",
+					"4:3",
+					"3:2",
+					"16:9",
+					"free"
+				],
+				label: "Aspect Ratio"
+			},
+			{
+				type: "select",
+				key: "galleryCardStyle",
+				options: [
+					"default",
+					"compact",
+					"detailed"
+				],
+				label: "Card Style"
+			},
+			{
+				type: "toggle",
+				key: "galleryShowLabels",
+				label: "Show Labels"
+			},
+			{
+				type: "select",
+				key: "gallerySortBy",
+				options: [
+					"manual",
+					"date",
+					"name",
+					"rating"
+				],
+				label: "Sort"
+			}
+		]
+	},
+	table: {
+		key: "table",
+		label: "Table",
+		icon: "table",
+		description: "Collaborative spreadsheet with custom fields",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Column",
+		grandchildLabel: "Row",
+		defaultMetaFields: [{
+			type: "select",
+			key: "tableMode",
+			options: ["hierarchy", "flat"],
+			label: "Mode"
+		}, {
+			type: "select",
+			key: "tableSortDir",
+			options: ["asc", "desc"],
+			label: "Sort Direction"
+		}]
+	},
+	outline: {
+		key: "outline",
+		label: "Outline",
+		icon: "list-tree",
+		description: "Hierarchical outline with keyboard navigation",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Item",
+		defaultDepth: -1
+	},
+	checklist: {
+		key: "checklist",
+		label: "Checklist",
+		icon: "check-square",
+		description: "Collaborative checklist with sub-tasks, drag-and-drop, and due dates",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Task",
+		defaultDepth: -1,
+		metaSchema: [
+			{
+				type: "toggle",
+				key: "checked",
+				label: "Done"
+			},
+			{
+				type: "select",
+				key: "priority",
+				options: [
+					"none",
+					"low",
+					"medium",
+					"high"
+				],
+				label: "Priority"
+			},
+			{
+				type: "date",
+				key: "dateEnd",
+				label: "Due date"
+			}
+		],
+		defaultMetaFields: [{
+			type: "select",
+			key: "checklistFilter",
+			options: [
+				"all",
+				"active",
+				"completed"
+			],
+			label: "Filter"
+		}, {
+			type: "select",
+			key: "checklistSort",
+			options: [
+				"manual",
+				"priority",
+				"due"
+			],
+			label: "Sort"
+		}]
+	},
+	graph: {
+		key: "graph",
+		label: "Graph",
+		icon: "git-fork",
+		description: "Force-directed knowledge graph — full document tree as nodes & edges",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Node",
+		defaultMetaFields: [{
+			type: "toggle",
+			key: "showRefEdges",
+			label: "Show Ref Edges",
+			default: true
+		}]
+	},
+	timeline: {
+		key: "timeline",
+		label: "Timeline",
+		icon: "gantt-chart",
+		description: "Gantt-style project timeline with epics and tasks",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Epic",
+		grandchildLabel: "Task",
+		metaSchema: [
+			{
+				type: "daterange",
+				startKey: "dateStart",
+				endKey: "dateEnd"
+			},
+			{
+				type: "slider",
+				key: "taskProgress",
+				min: 0,
+				max: 100,
+				label: "Progress"
+			},
+			{
+				type: "colorPreset",
+				key: "color",
+				presets: [
+					"#6366f1",
+					"#818cf8",
+					"#f97316",
+					"#22c55e",
+					"#3b82f6",
+					"#a855f7"
+				],
+				label: "Color"
+			}
+		]
+	},
+	calendar: {
+		key: "calendar",
+		label: "Calendar",
+		icon: "calendar",
+		description: "Event calendar with month, week, and day views",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Event",
+		metaSchema: [
+			{
+				type: "datetimerange",
+				startKey: "datetimeStart",
+				endKey: "datetimeEnd",
+				allDayKey: "allDay"
+			},
+			{
+				type: "colorPreset",
+				key: "color",
+				presets: [
+					"#6366f1",
+					"#ec4899",
+					"#f97316",
+					"#22c55e",
+					"#3b82f6",
+					"#a855f7"
+				],
+				label: "Color"
+			},
+			{
+				type: "icon",
+				key: "icon",
+				label: "Icon"
+			}
+		],
+		defaultMetaFields: [
+			{
+				type: "select",
+				key: "calendarWeekStart",
+				options: ["sun", "mon"],
+				label: "Week Starts"
+			},
+			{
+				type: "select",
+				key: "calendarView",
+				options: [
+					"month",
+					"week",
+					"day"
+				],
+				label: "Default View"
+			},
+			{
+				type: "toggle",
+				key: "calendarShowWeekNumbers",
+				label: "Show Week Numbers"
+			}
+		]
+	},
+	map: {
+		key: "map",
+		label: "Map",
+		icon: "map",
+		description: "Collaborative world map with shared markers",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Location",
+		defaultMetaFields: [{
+			type: "toggle",
+			key: "mapShowLabels",
+			label: "Show Labels",
+			default: true
+		}]
+	},
+	dashboard: {
+		key: "dashboard",
+		label: "Dashboard",
+		icon: "layout-dashboard",
+		description: "Arrange documents as draggable icons with optional widget views",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Item"
+	},
+	call: {
+		key: "call",
+		label: "Call",
+		icon: "phone",
+		description: "Video call room with live audio and screen sharing",
+		core: true,
+		supportsChildren: false
+	},
+	chart: {
+		key: "chart",
+		label: "Chart",
+		icon: "bar-chart-3",
+		description: "Charts — manual data points or aggregation over document trees",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Data Point",
+		grandchildLabel: "Data Point",
+		metaSchema: [
+			{
+				type: "number",
+				key: "number",
+				step: .01,
+				label: "Value"
+			},
+			{
+				type: "colorPreset",
+				key: "color",
+				presets: [
+					"#6366f1",
+					"#ec4899",
+					"#f97316",
+					"#22c55e",
+					"#3b82f6",
+					"#a855f7",
+					"#14b8a6",
+					"#eab308"
+				],
+				label: "Color"
+			},
+			{
+				type: "tags",
+				key: "tags",
+				label: "Tags"
+			}
+		],
+		defaultMetaFields: [
+			{
+				type: "select",
+				key: "chartType",
+				options: [
+					"bar",
+					"stacked bar",
+					"line",
+					"donut",
+					"treemap"
+				],
+				label: "Chart Type"
+			},
+			{
+				type: "select",
+				key: "chartMetric",
+				options: [
+					"value",
+					"type",
+					"tag",
+					"status",
+					"priority",
+					"activity",
+					"completion"
+				],
+				label: "Metric"
+			},
+			{
+				type: "select",
+				key: "chartColorScheme",
+				options: [
+					"default",
+					"warm",
+					"cool",
+					"mono"
+				],
+				label: "Colors"
+			},
+			{
+				type: "number",
+				key: "chartLimit",
+				min: 3,
+				max: 30,
+				step: 1,
+				label: "Max Items"
+			},
+			{
+				type: "toggle",
+				key: "chartShowLegend",
+				label: "Show Legend",
+				default: true
+			},
+			{
+				type: "toggle",
+				key: "chartShowValues",
+				label: "Show Values"
+			}
+		]
+	},
+	sheets: {
+		key: "sheets",
+		label: "Sheets",
+		icon: "grid-3x3",
+		description: "Spreadsheet — cells, formulas, and formatting in a collaborative grid",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Column",
+		grandchildLabel: "Cell",
+		defaultMetaFields: [
+			{
+				type: "number",
+				key: "sheetsDefaultColWidth",
+				min: 40,
+				max: 500,
+				step: 10,
+				label: "Column Width"
+			},
+			{
+				type: "number",
+				key: "sheetsDefaultRowHeight",
+				min: 20,
+				max: 100,
+				step: 2,
+				label: "Row Height"
+			},
+			{
+				type: "toggle",
+				key: "sheetsShowGridlines",
+				label: "Gridlines"
+			}
+		]
+	},
+	slides: {
+		key: "slides",
+		label: "Slides",
+		icon: "presentation",
+		description: "Presentation slides with two-axis navigation",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Slide",
+		grandchildLabel: "Sub-slide",
+		metaSchema: [{
+			type: "select",
+			key: "slidesTransition",
+			options: [
+				"none",
+				"fade",
+				"slide"
+			],
+			label: "Transition"
+		}, {
+			type: "colorPreset",
+			key: "color",
+			presets: [
+				"#6366f1",
+				"#ec4899",
+				"#f97316",
+				"#22c55e",
+				"#3b82f6",
+				"#a855f7"
+			],
+			label: "Accent"
+		}],
+		defaultMetaFields: [{
+			type: "select",
+			key: "slidesTheme",
+			options: ["dark", "light"],
+			label: "Theme"
+		}]
+	},
+	overview: {
+		key: "overview",
+		label: "Overview",
+		icon: "radar",
+		description: "Space home — activity, people, stats, and health at a glance",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Page"
+	},
+	spatial: {
+		key: "spatial",
+		label: "Spatial",
+		icon: "box",
+		description: "3D scene with collaborative objects and real-time presence",
+		core: false,
+		plugin: "spatial",
+		supportsChildren: true,
+		childLabel: "Object",
+		grandchildLabel: "Part",
+		defaultDepth: -1,
+		metaSchema: [
+			{
+				type: "select",
+				key: "spShape",
+				options: [
+					"box",
+					"sphere",
+					"cylinder",
+					"cone",
+					"plane",
+					"torus",
+					"glb"
+				],
+				label: "Shape"
+			},
+			{
+				type: "colorPreset",
+				key: "color",
+				presets: [
+					"#6366f1",
+					"#ef4444",
+					"#22c55e",
+					"#3b82f6",
+					"#f97316",
+					"#a855f7",
+					"#ec4899",
+					"#14b8a6"
+				],
+				label: "Color"
+			},
+			{
+				type: "slider",
+				key: "spOpacity",
+				min: 0,
+				max: 100,
+				label: "Opacity"
+			},
+			{
+				type: "number",
+				key: "spX",
+				step: .1,
+				label: "X"
+			},
+			{
+				type: "number",
+				key: "spY",
+				step: .1,
+				label: "Y"
+			},
+			{
+				type: "number",
+				key: "spZ",
+				step: .1,
+				label: "Z"
+			},
+			{
+				type: "number",
+				key: "spRX",
+				min: -180,
+				max: 180,
+				step: 1,
+				label: "Rot X"
+			},
+			{
+				type: "number",
+				key: "spRY",
+				min: -180,
+				max: 180,
+				step: 1,
+				label: "Rot Y"
+			},
+			{
+				type: "number",
+				key: "spRZ",
+				min: -180,
+				max: 180,
+				step: 1,
+				label: "Rot Z"
+			},
+			{
+				type: "number",
+				key: "spSX",
+				min: .01,
+				max: 100,
+				step: .1,
+				label: "Scale X"
+			},
+			{
+				type: "number",
+				key: "spSY",
+				min: .01,
+				max: 100,
+				step: .1,
+				label: "Scale Y"
+			},
+			{
+				type: "number",
+				key: "spSZ",
+				min: .01,
+				max: 100,
+				step: .1,
+				label: "Scale Z"
+			}
+		],
+		defaultMetaFields: [{
+			type: "toggle",
+			key: "spatialGridVisible",
+			label: "Show Grid",
+			default: true
+		}]
+	},
+	media: {
+		key: "media",
+		label: "Media",
+		icon: "disc-3",
+		description: "Media player with synced listening and playlists",
+		core: false,
+		plugin: "media",
+		supportsChildren: true,
+		childLabel: "Track",
+		defaultDepth: -1,
+		metaSchema: [{
+			type: "tags",
+			key: "tags",
+			label: "Tags"
+		}],
+		defaultMetaFields: [{
+			type: "select",
+			key: "mediaRepeat",
+			options: [
+				"off",
+				"all",
+				"one"
+			],
+			label: "Repeat"
+		}, {
+			type: "toggle",
+			key: "mediaShuffle",
+			label: "Shuffle"
+		}]
+	},
+	coder: {
+		key: "coder",
+		label: "Coder",
+		icon: "code-2",
+		description: "Collaborative multi-file coding environment",
+		core: false,
+		plugin: "coder",
+		supportsChildren: true,
+		childLabel: "File",
+		defaultDepth: -1,
+		metaSchema: [{
+			type: "select",
+			key: "fileType",
+			options: [
+				"vue",
+				"ts",
+				"js",
+				"css",
+				"json",
+				"folder"
+			],
+			label: "Type"
+		}, {
+			type: "toggle",
+			key: "entry",
+			label: "Entry Point"
+		}]
+	}
+};
+const TYPE_ALIASES = { desktop: "dashboard" };
+function resolvePageType(key) {
+	if (!key) return void 0;
+	return PAGE_TYPES[TYPE_ALIASES[key] ?? key];
+}
+
 //#endregion
 //#region packages/mcp/src/tools/tree.ts
 /**
@@ -20596,7 +21325,7 @@ function registerTreeTools(mcp, server) {
 	mcp.tool("create_document", "Create a new document in the tree. Returns the new document ID.", {
 		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."),
+		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.")
 	}, async ({ parentId, label, type, meta }) => {
 		server.setAutoStatus("creating");
@@ -20757,7 +21486,7 @@ function registerTreeTools(mcp, server) {
 	});
 	mcp.tool("change_document_type", "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({
@@ -20842,6 +21571,27 @@ function registerTreeTools(mcp, server) {
 			}, null, 2)
 		}] };
 	});
+	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)
+		}] };
+	});
 }
 
 //#endregion
@@ -22137,7 +22887,7 @@ function registerMetaTools(mcp, server) {
 	});
 	mcp.tool("update_metadata", "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.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({
@@ -22704,24 +23454,38 @@ If you are adding content to an existing space, call \`get_document_tree(rootId:
 
 ## Page Types Reference
 
+### Core Types (always available)
+
 | Type | Children Are | Grandchildren Are | Depth | Key Meta on Children |
 |------|-------------|-------------------|-------|---------------------|
 | **doc** | Sub-documents | Sub-sub-documents | ∞ | — |
 | **kanban** | Columns | Cards | 2 | color, icon on cards |
 | **table** | Columns | Cells (positional rows) | 2 | — |
-| **calendar** | Events | — | 1 | datetimeStart, datetimeEnd, allDay, color |
+| **calendar** | Events | — | 1 | datetimeStart, datetimeEnd, allDay, color, icon |
 | **timeline** | Epics | Tasks | 2 | dateStart, dateEnd, taskProgress, color |
 | **checklist** | Tasks | Sub-tasks | ∞ | checked, priority, dateEnd |
 | **outline** | Items | Sub-items | ∞ | — |
-| **mindmap** | Central nodes | Branches | ∞ | mmX, mmY |
 | **graph** | Nodes | — | 1 | graphX, graphY, graphPinned, color |
-| **gallery** | Items | — | 1 | geoLat, geoLng, datetimeStart, tags |
+| **gallery** | Items | — | 1 | geoLat, geoLng, datetimeStart, tags, rating, icon, color |
 | **map** | Markers/Lines | Points (for lines) | 2 | geoType, geoLat, geoLng, icon, color |
-| **dashboard** | Items | — | 1 | deskX, deskY, deskMode |
-| **spatial** | Objects | Sub-parts | ∞ | spShape, spX/Y/Z, spColor, spOpacity |
-| **media** | Tracks | — | 1 | tags |
-| **slides** | Slides | — | 1 | — |
-| **whiteboard** | Objects | — | 1 | wbX, wbY, wbW, wbH |
+| **slides** | Slides | Sub-slides | 2 | slidesTransition, color |
+| **dashboard** | Items | — | 1 | deskX, deskY, deskZ, deskMode |
+| **chart** | Data points | Data points | 2 | number (value), color, tags |
+| **sheets** | Columns | Cells | 2 | formula, bold, italic, textColor, bgColor, align |
+| **overview** | Pages | — | 1 | — |
+| **call** | — (no children) | — | 0 | — |
+
+Alias: \`desktop\` → \`dashboard\`.
+
+### Plugin Types (require plugin enabled on the server)
+
+| Type | Plugin | Children Are | Grandchildren Are | Depth | Key Meta on Children |
+|------|--------|-------------|-------------------|-------|---------------------|
+| **spatial** | spatial | Objects | Sub-parts | ∞ | spShape, spX/Y/Z, spRX/RY/RZ, spSX/SY/SZ, color, spOpacity |
+| **media** | media | Tracks | — | ∞ | tags |
+| **coder** | coder | Files/Folders | — | ∞ | fileType, entry |
+
+> Spatial uses the universal \`color\` key for object color — there is no \`spColor\`.
 
 ---
 
@@ -22794,18 +23558,65 @@ If you are adding content to an existing space, call \`get_document_tree(rootId:
 4. Modes: \`"icon"\` (small), \`"widget-sm"\` (240×180), \`"widget-lg"\` (400×320)
 5. Grid uses 80px cells
 
-**Spatial (3D scene):**
+**Spatial (3D scene)** *(requires spatial plugin):*
 1. \`create_document(parentId, "3D Scene", "spatial")\`
 2. Create objects: \`create_document(sceneId, "Red Cube")\`
-3. Set 3D properties: \`update_metadata(objId, { spShape: "box", spColor: "#ef4444", spX: 0, spY: 1, spZ: 0, spSX: 2, spSY: 2, spSZ: 2 })\`
-4. Shapes: \`"box"\`, \`"sphere"\`, \`"cylinder"\`, \`"cone"\`, \`"plane"\`, \`"torus"\`, \`"glb"\` (uploaded 3D model)
+3. Set 3D properties: \`update_metadata(objId, { spShape: "box", color: "#ef4444", spX: 0, spY: 1, spZ: 0, spSX: 2, spSY: 2, spSZ: 2 })\`
+4. Shapes: \`"box"\`, \`"sphere"\`, \`"cylinder"\`, \`"cone"\`, \`"plane"\`, \`"torus"\`, \`"glb"\` (uploaded 3D model — set \`spModelUploadId\` and \`spModelDocId\`)
 5. Rotation (degrees): \`spRX\`, \`spRY\`, \`spRZ\`. Scale: \`spSX\`, \`spSY\`, \`spSZ\` (default 1). Opacity: \`spOpacity\` (0–100)
+6. Use the universal \`color\` key — **never \`spColor\`**
 
 **Outline (nested items):**
 1. \`create_document(parentId, "Meeting Notes", "outline")\`
 2. Create items: \`create_document(outlineId, "Agenda Item 1")\`
 3. Create sub-items (unlimited depth): \`create_document(itemId, "Sub-point")\`
 
+**Slides (presentation with two-axis nav):**
+1. \`create_document(parentId, "Q1 Review", "slides")\`
+2. Create slides as direct children: \`create_document(deckId, "Intro")\`
+3. Create sub-slides (vertical navigation) as grandchildren: \`create_document(slideId, "Deep dive")\`
+4. Per-slide transition: \`update_metadata(slideId, { slidesTransition: "fade", color: "#6366f1" })\`
+5. Deck-level theme: \`update_metadata(deckId, { slidesTheme: "dark" })\`
+
+**Chart (data viz — manual or aggregation):**
+1. \`create_document(parentId, "Sales", "chart")\`
+2. Configure: \`update_metadata(chartId, { chartType: "bar", chartMetric: "value", chartShowLegend: true, chartLimit: 10 })\`
+3. Modes:
+   - **Manual data points**: create children with \`number\` (value) and optional \`tags\`/\`color\`
+     \`create_document(chartId, "Q1")\` then \`update_metadata(dpId, { number: 42500, color: "#6366f1" })\`
+   - **Aggregation**: set \`chartMetric\` to \`"type"\`/\`"tag"\`/\`"status"\`/\`"priority"\`/\`"activity"\`/\`"completion"\` and point the chart at a subtree — it aggregates the descendants' meta automatically
+4. Chart types: \`"bar"\`, \`"stacked bar"\`, \`"line"\`, \`"donut"\`, \`"treemap"\`
+5. Color schemes: \`"default"\`, \`"warm"\`, \`"cool"\`, \`"mono"\`
+
+**Sheets (spreadsheet with formulas):**
+1. \`create_document(parentId, "Budget", "sheets")\`
+2. Create columns: \`create_document(sheetId, "A")\`, \`create_document(sheetId, "B")\`
+3. Create cells under columns (positional rows, like \`table\`)
+4. Formulas on cells: \`update_metadata(cellId, { formula: "=A1+B1" })\`
+5. Cell formatting: \`update_metadata(cellId, { bold: true, bgColor: "#fef3c7", align: "right" })\`
+6. Deck config: \`update_metadata(sheetId, { sheetsDefaultColWidth: 120, sheetsDefaultRowHeight: 28, sheetsShowGridlines: true, sheetsFreezeRows: 1, sheetsFreezeCols: 1 })\`
+
+**Overview (space home):**
+1. \`create_document(parentId, "Home", "overview")\`
+2. No children required — renders activity, people, stats from the surrounding space
+3. Children (if any) show as linked pages
+
+**Call (video room):**
+1. \`create_document(parentId, "Daily Standup", "call")\`
+2. Video rooms have **no children** — do not add documents underneath
+
+**Coder (multi-file collaborative editor)** *(requires coder plugin):*
+1. \`create_document(parentId, "My App", "coder")\`
+2. Create files/folders: \`create_document(projectId, "App.vue")\`, \`create_document(projectId, "src")\`
+3. Set file type: \`update_metadata(fileId, { fileType: "vue", entry: true })\`
+4. \`fileType\` options: \`"vue"\`, \`"ts"\`, \`"js"\`, \`"css"\`, \`"json"\`, \`"folder"\`
+5. Mark the entry file with \`entry: true\` — the renderer uses it as the preview root
+
+**Media (audio/video playlist)** *(requires media plugin):*
+1. \`create_document(parentId, "Focus Mix", "media")\`
+2. Create tracks: \`create_document(playlistId, "Track 1")\` — attach audio/video file via upload tool
+3. Playlist config: \`update_metadata(playlistId, { mediaRepeat: "all", mediaShuffle: false })\`
+
 ---
 
 ## Document References
@@ -22880,22 +23691,55 @@ In the **graph** page type, document references (embeds and links) create visibl
 |-----|------|-----------|--------|
 | \`kanbanColumnWidth\` | string | kanban | "narrow", "default", "wide" |
 | \`galleryColumns\` | number | gallery | 1–6 |
-| \`galleryAspect\` | string | gallery | "square", "4:3", "16:9" |
+| \`galleryAspect\` | string | gallery | "square", "4:3", "3:2", "16:9", "free" |
+| \`galleryCardStyle\` | string | gallery | "default", "compact", "detailed" |
+| \`galleryShowLabels\` | boolean | gallery | show item labels |
+| \`gallerySortBy\` | string | gallery | "manual", "date", "name", "rating" |
 | \`calendarView\` | string | calendar | "month", "week", "day" |
 | \`calendarWeekStart\` | string | calendar | "sun", "mon" |
+| \`calendarShowWeekNumbers\` | boolean | calendar | — |
 | \`tableMode\` | string | table | "hierarchy", "flat" |
+| \`tableSortKey\` | string | table | meta key to sort by |
+| \`tableSortDir\` | string | table | "asc", "desc" |
+| \`timelineZoom\` | string | timeline | "week", "month", "quarter" |
+| \`timelinePixelsPerDay\` | number | timeline | zoom granularity |
+| \`timelineCenterDate\` | string | timeline | ISO date to center view |
+| \`checklistFilter\` | string | checklist | "all", "active", "completed" |
+| \`checklistSort\` | string | checklist | "manual", "priority", "due" |
+| \`mapShowLabels\` | boolean | map | — |
+| \`graphSpacing\` | string | graph | "compact", "default", "spacious" |
+| \`graphShowLabels\` | boolean | graph | — |
+| \`graphEdgeThickness\` | string | graph | "thin", "normal", "thick" |
 | \`showRefEdges\` | boolean | graph | show doc-reference edges |
-
-### Spatial 3D Keys (for spatial children)
+| \`mmSpacing\` | string | mindmap-layout | spacing between branches |
+| \`spatialGridVisible\` | boolean | spatial | show ground grid |
+| \`slidesTheme\` | string | slides | "dark", "light" |
+| \`chartType\` | string | chart | "bar", "stacked bar", "line", "donut", "treemap" |
+| \`chartMetric\` | string | chart | "value", "type", "tag", "status", "priority", "activity", "completion" |
+| \`chartColorScheme\` | string | chart | "default", "warm", "cool", "mono" |
+| \`chartLimit\` | number | chart | 3–30 (max items) |
+| \`chartShowLegend\` | boolean | chart | — |
+| \`chartShowValues\` | boolean | chart | — |
+| \`sheetsDefaultColWidth\` | number | sheets | 40–500 |
+| \`sheetsDefaultRowHeight\` | number | sheets | 20–100 |
+| \`sheetsShowGridlines\` | boolean | sheets | — |
+| \`sheetsFreezeRows\` | number | sheets | frozen rows count |
+| \`sheetsFreezeCols\` | number | sheets | frozen cols count |
+| \`mediaRepeat\` | string | media | "off", "all", "one" (plugin) |
+| \`mediaShuffle\` | boolean | media | plugin |
+
+### Spatial 3D Keys (for spatial children — requires spatial plugin)
 
 | Key | Type | Default | Meaning |
 |-----|------|---------|---------|
 | \`spShape\` | string | — | "box", "sphere", "cylinder", "cone", "plane", "torus", "glb" |
-| \`spColor\` | string | — | CSS color |
+| \`color\` | string | — | CSS color — universal key, **not** \`spColor\` |
 | \`spOpacity\` | number | 100 | 0–100 |
 | \`spX\`, \`spY\`, \`spZ\` | number | 0 | Position |
 | \`spRX\`, \`spRY\`, \`spRZ\` | number | 0 | Rotation (degrees) |
 | \`spSX\`, \`spSY\`, \`spSZ\` | number | 1 | Scale |
+| \`spModelUploadId\` | string | — | GLB upload ID (when \`spShape: "glb"\`) |
+| \`spModelDocId\` | string | — | Doc ID that owns the GLB upload |
 
 ### Dashboard Keys (for dashboard children)
 
@@ -22905,6 +23749,28 @@ In the **graph** page type, document references (embeds and links) create visibl
 | \`deskZ\` | number | Z-index (layering) |
 | \`deskMode\` | string | "icon", "widget-sm" (240×180), "widget-lg" (400×320) |
 
+### Sheets Cell Formatting (per-cell meta)
+
+| Key | Type | Meaning |
+|-----|------|---------|
+| \`formula\` | string | Cell formula (e.g. "=A1+B1") |
+| \`bold\` | boolean | — |
+| \`italic\` | boolean | — |
+| \`textColor\` | string | CSS color |
+| \`bgColor\` | string | CSS color |
+| \`align\` | string | "left", "center", "right" |
+
+### Coder Keys (for coder children — plugin)
+
+| Key | Type | Meaning |
+|-----|------|---------|
+| \`fileType\` | string | "vue", "ts", "js", "css", "json", "folder" |
+| \`entry\` | boolean | Mark this file as the preview entry point |
+
+### Discovering What Metadata Applies
+
+Use the \`list_page_types\` tool to enumerate all known page types and their declared \`metaSchema\` (fields that apply to children/descendants) and \`defaultMetaFields\` (renderer config fields on the page itself). It's the authoritative list of what meta keys make sense for any given page type.
+
 ---
 
 ## Content Structure
@@ -22987,8 +23853,11 @@ Always clear fields when done by setting them to \`null\`.
 | **Outline** | \`outline:editing\` | nodeId | Editing an outline node |
 | **Gallery** | \`gallery:focused\` | itemId | Item hovered/selected |
 | **Timeline** | \`timeline:focused\` | taskId | Task selected |
-| **Mindmap** | \`mindmap:focused\` | nodeId | Node selected/edited |
 | **Graph** | \`graph:focused\` | nodeId | Node hovered/selected |
+| **Slides** | \`slides:current\` | slideId | Slide being presented |
+| **Spatial** | \`spatial:selected\`, \`spatial:camera\` | objectId / camera state | plugin |
+| **Media** | \`media:playing\`, \`media:position\` | trackId / 0–1 | plugin |
+| **Coder** | \`coder:activeFile\` | fileId | plugin |
 | **Map** | \`map:focused\` | markerId | Marker hovered/selected |
 | **Doc** | \`doc:scroll\` | 0–1 number | Scroll position in document |