@excalimate/mcp-server 0.2.0 → 0.3.0

package/dist/server/queryTools.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+export function registerQueryTools(server, ctx, geometry) {
+    server.tool('are_items_in_line', 'Check if the given items are aligned horizontally or vertically (within a tolerance).', {
+        ids: z.array(z.string()).describe('Element IDs to check'),
+        axis: z.enum(['horizontal', 'vertical']).describe('Alignment axis'),
+        tolerance: z.number().optional().describe('Max deviation in scene units (default 10)'),
+    }, async ({ ids, axis, tolerance = 10 }) => {
+        const state = ctx.getState();
+        const centers = [];
+        for (const id of ids) {
+            const el = state.scene.elements.find((e) => e.id === id);
+            if (!el)
+                return { content: [{ type: 'text', text: `Element "${id}" not found.` }] };
+            const b = geometry.getElementBounds(el);
+            centers.push({ id, cx: (b.minX + b.maxX) / 2, cy: (b.minY + b.maxY) / 2 });
+        }
+        const values = centers.map(c => axis === 'horizontal' ? c.cy : c.cx);
+        const avg = values.reduce((a, b) => a + b, 0) / values.length;
+        const maxDev = Math.max(...values.map(v => Math.abs(v - avg)));
+        const aligned = maxDev <= tolerance;
+        const details = centers.map(c => `${c.id}: (${Math.round(c.cx)}, ${Math.round(c.cy)})`).join(', ');
+        return { content: [{ type: 'text', text: `${aligned ? '✅ Aligned' : '❌ Not aligned'} (max deviation: ${Math.round(maxDev)}px, tolerance: ${tolerance}px). Centers: ${details}` }] };
+    });
+    server.tool('is_camera_centered', 'Check if the camera is centered on the scene content (horizontally, vertically, or both).', {
+        axis: z.enum(['horizontal', 'vertical', 'both']).describe('Which axis to check'),
+        time: z.number().min(0).default(0).describe('Time in ms to check at'),
+        tolerance: z.number().optional().describe('Max deviation (default 20)'),
+    }, async ({ axis, time, tolerance = 20 }) => {
+        const state = ctx.getState();
+        let sMinX = Infinity;
+        let sMinY = Infinity;
+        let sMaxX = -Infinity;
+        let sMaxY = -Infinity;
+        for (const el of state.scene.elements) {
+            const b = geometry.getElementBounds(el);
+            if (b.minX < sMinX)
+                sMinX = b.minX;
+            if (b.minY < sMinY)
+                sMinY = b.minY;
+            if (b.maxX > sMaxX)
+                sMaxX = b.maxX;
+            if (b.maxY > sMaxY)
+                sMaxY = b.maxY;
+        }
+        const sceneCX = (sMinX + sMaxX) / 2;
+        const sceneCY = (sMinY + sMaxY) / 2;
+        const cam = geometry.getCameraRectAt(state, time);
+        const dxOk = Math.abs(cam.cx - sceneCX) <= tolerance;
+        const dyOk = Math.abs(cam.cy - sceneCY) <= tolerance;
+        const ok = axis === 'horizontal' ? dxOk : axis === 'vertical' ? dyOk : dxOk && dyOk;
+        return { content: [{ type: 'text', text: `${ok ? '✅ Centered' : '❌ Not centered'} (scene center: ${Math.round(sceneCX)},${Math.round(sceneCY)}, camera center: ${Math.round(cam.cx)},${Math.round(cam.cy)}, offsets: dx=${Math.round(cam.cx - sceneCX)} dy=${Math.round(cam.cy - sceneCY)})` }] };
+    });
+    server.tool('items_visible_in_camera', 'Check what percentage of items are visible in the camera frame at a given time.', {
+        time: z.number().min(0).default(0).describe('Time in ms'),
+    }, async ({ time }) => {
+        const state = ctx.getState();
+        const cam = geometry.getCameraRectAt(state, time);
+        const elements = state.scene.elements.filter((e) => !e.isDeleted && e.id !== '__camera_frame__');
+        let visible = 0;
+        const details = [];
+        for (const el of elements) {
+            const b = geometry.getAnimatedBoundsAt(state, el.id, time);
+            if (!b)
+                continue;
+            const opTrack = state.timeline.tracks.find((t) => t.targetId === el.id && t.property === 'opacity');
+            const opacity = opTrack ? geometry.interpolateTrackAt(opTrack, time) : 1;
+            const inView = b.maxX > cam.left && b.minX < cam.right && b.maxY > cam.top && b.minY < cam.bottom;
+            const isVisible = inView && opacity > 0.01;
+            if (isVisible)
+                visible++;
+            details.push(`${el.id}: ${isVisible ? '✅' : '❌'} (opacity=${(opacity * 100).toFixed(0)}%, inView=${inView})`);
+        }
+        const pct = elements.length > 0 ? Math.round(visible / elements.length * 100) : 0;
+        return { content: [{ type: 'text', text: `${visible}/${elements.length} items visible (${pct}%) at ${time}ms.\n${details.join('\n')}` }] };
+    });
+    server.tool('animations_of_item', 'Returns a timeline description of all animations an item goes through.', {
+        targetId: z.string().describe('Element ID'),
+    }, async ({ targetId }) => {
+        const state = ctx.getState();
+        const tracks = state.timeline.tracks.filter((t) => t.targetId === targetId);
+        if (tracks.length === 0) {
+            return { content: [{ type: 'text', text: `No animations for "${targetId}".` }] };
+        }
+        const lines = [`Animations for "${targetId}":`];
+        for (const track of tracks) {
+            if (track.keyframes.length === 0)
+                continue;
+            lines.push(`  ${track.property}:`);
+            for (let i = 0; i < track.keyframes.length; i++) {
+                const kf = track.keyframes[i];
+                const next = track.keyframes[i + 1];
+                if (next) {
+                    const fromLabel = track.property === 'opacity' ? `${(kf.value * 100).toFixed(0)}%` : String(kf.value);
+                    const toLabel = track.property === 'opacity' ? `${(next.value * 100).toFixed(0)}%` : String(next.value);
+                    const direction = next.value > kf.value ? '↑' : next.value < kf.value ? '↓' : '→';
+                    lines.push(`    ${kf.time}ms ${fromLabel} ${direction} ${toLabel} ${next.time}ms (${kf.easing})`);
+                }
+                else {
+                    const label = track.property === 'opacity' ? `${(kf.value * 100).toFixed(0)}%` : String(kf.value);
+                    lines.push(`    ${kf.time}ms ${label} (hold)`);
+                }
+            }
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    });
+}
+//# sourceMappingURL=queryTools.js.map

package/dist/server/queryTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryTools.js","sourceRoot":"","sources":["../../src/server/queryTools.ts"],"names":[],"mappings":"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"}

package/dist/server/referenceText.d.ts

@@ -0,0 +1,3 @@
+export declare const REFERENCE_TEXT = "# Excalimate MCP Reference\n\n## Excalidraw Element Format\n\nEvery element has these base properties:\n```json\n{\n  \"id\": \"unique-id\",\n  \"type\": \"rectangle|ellipse|diamond|arrow|line|text|freedraw|image\",\n  \"x\": 100, \"y\": 200,\n  \"width\": 300, \"height\": 150,\n  \"angle\": 0,\n  \"strokeColor\": \"#1e1e1e\",\n  \"backgroundColor\": \"transparent\",\n  \"fillStyle\": \"solid\",\n  \"strokeWidth\": 2,\n  \"roughness\": 1,\n  \"opacity\": 100,\n  \"groupIds\": [],\n  \"isDeleted\": false\n}\n```\n\n### Text Elements\n```json\n{\n  \"type\": \"text\",\n  \"text\": \"Hello World\",\n  \"fontSize\": 20,\n  \"fontFamily\": 5,\n  \"textAlign\": \"center\",\n  \"verticalAlign\": \"middle\"\n}\n```\n\n### Arrow/Line Elements\n```json\n{\n  \"type\": \"arrow\",\n  \"points\": [[0, 0], [200, 100]],\n  \"startArrowhead\": null,\n  \"endArrowhead\": \"arrow\",\n  \"startBinding\": null,\n  \"endBinding\": null\n}\n```\n\n### Bound Text (Label on Shape)\nCreate a text element with `containerId` pointing to the shape:\n```json\n{ \"type\": \"text\", \"containerId\": \"shape-id\", ... }\n```\nAnd add to the shape: `\"boundElements\": [{\"id\": \"text-id\", \"type\": \"text\"}]`\n\n## Color Palettes\n\n**Stroke**: #1e1e1e, #e03131, #2f9e44, #1971c2, #f08c00, #6741d9, #0c8599, #e8590c\n**Background**: transparent, #ffc9c9, #b2f2bb, #a5d8ff, #ffec99, #d0bfff, #99e9f2, #ffd8a8\n\n## Animatable Properties\n\n| Property | Range | Description |\n|----------|-------|-------------|\n| opacity | 0\u20131 | Element visibility (0=hidden, 1=visible) |\n| translateX | px | Horizontal position offset |\n| translateY | px | Vertical position offset |\n| scaleX | 0.1+ | Horizontal scale (1=normal) |\n| scaleY | 0.1+ | Vertical scale (1=normal) |\n| rotation | degrees | Rotation angle |\n| drawProgress | 0\u20131 | Stroke draw-on progress (for lines/arrows) |\n\n## Easing Types\n\nlinear, easeIn, easeOut, easeInOut, easeInQuad, easeOutQuad, easeInOutQuad,\neaseInCubic, easeOutCubic, easeInOutCubic, easeInBack, easeOutBack, easeInOutBack,\neaseInElastic, easeOutElastic, easeInBounce, easeOutBounce, step\n\n## Workflow\n\n1. Call `read_me` (this tool) to get the reference\n2. Call `create_scene` with Excalidraw elements JSON (or `clear_scene` to start fresh)\n3. Call `add_keyframe` or `add_keyframes_batch` to animate elements\n4. Use `create_sequence` for reveal animations\n5. Call `set_clip_range` to set export bounds\n6. Call `save_checkpoint` to persist\n7. User opens the checkpoint in the Excalimate web app for preview/export\n\nUse `clear_scene` to reset everything (elements + animations) or `clear_animation` to keep elements but remove all keyframes.\n\n## Example: Fade-in Rectangle\n\n```\n1. create_scene: [{\"id\":\"rect1\",\"type\":\"rectangle\",\"x\":100,\"y\":100,\"width\":200,\"height\":100,...}]\n2. add_keyframe: {targetId:\"rect1\", property:\"opacity\", time:0, value:0}\n3. add_keyframe: {targetId:\"rect1\", property:\"opacity\", time:1000, value:1, easing:\"easeOut\"}\n```\n";
+export declare const EXAMPLES_TEXT = "# Excalimate \u2014 Few-Shot Examples\n\n## Example 1: Single Rectangle\n```\ncreate_scene({ elements: '[{\"id\":\"box1\",\"type\":\"rectangle\",\"x\":200,\"y\":150,\"width\":250,\"height\":120,\"strokeColor\":\"#1971c2\",\"backgroundColor\":\"#a5d8ff\",\"fillStyle\":\"solid\"}]' })\n```\n\n## Example 2: Rectangle with Bound Text Label\n```\ncreate_scene({ elements: '[{\"id\":\"server\",\"type\":\"rectangle\",\"x\":100,\"y\":100,\"width\":200,\"height\":80,\"strokeColor\":\"#1e1e1e\",\"backgroundColor\":\"#a5d8ff\",\"fillStyle\":\"solid\",\"boundElements\":[{\"id\":\"server-label\",\"type\":\"text\"}]},{\"id\":\"server-label\",\"type\":\"text\",\"x\":140,\"y\":125,\"width\":120,\"height\":30,\"text\":\"API Server\",\"fontSize\":20,\"fontFamily\":5,\"textAlign\":\"center\",\"verticalAlign\":\"middle\",\"containerId\":\"server\"}]' })\n```\n\n## Example 3: Two Shapes Connected by Arrow\n```\ncreate_scene({ elements: '[{\"id\":\"A\",\"type\":\"rectangle\",\"x\":100,\"y\":200,\"width\":150,\"height\":80,\"strokeColor\":\"#1e1e1e\",\"backgroundColor\":\"#b2f2bb\",\"fillStyle\":\"solid\"},{\"id\":\"B\",\"type\":\"rectangle\",\"x\":500,\"y\":200,\"width\":150,\"height\":80,\"strokeColor\":\"#1e1e1e\",\"backgroundColor\":\"#a5d8ff\",\"fillStyle\":\"solid\"},{\"id\":\"arrow1\",\"type\":\"arrow\",\"x\":250,\"y\":240,\"width\":250,\"height\":0,\"points\":[[0,0],[250,0]],\"endArrowhead\":\"arrow\",\"startBinding\":{\"elementId\":\"A\",\"focus\":0,\"gap\":1},\"endBinding\":{\"elementId\":\"B\",\"focus\":0,\"gap\":1}}]' })\n```\n\n## Example 4: Ellipse and Diamond\n```\nadd_elements({ elements: '[{\"id\":\"circle1\",\"type\":\"ellipse\",\"x\":300,\"y\":100,\"width\":120,\"height\":120,\"strokeColor\":\"#e03131\",\"backgroundColor\":\"#ffc9c9\",\"fillStyle\":\"solid\"},{\"id\":\"diamond1\",\"type\":\"diamond\",\"x\":500,\"y\":90,\"width\":140,\"height\":140,\"strokeColor\":\"#6741d9\",\"backgroundColor\":\"#d0bfff\",\"fillStyle\":\"solid\"}]' })\n```\n\n## Example 5: Multi-Point Line\n```\nadd_elements({ elements: '[{\"id\":\"line1\",\"type\":\"line\",\"x\":100,\"y\":300,\"width\":400,\"height\":80,\"points\":[[0,0],[200,-80],[400,0]],\"strokeColor\":\"#e03131\",\"strokeWidth\":3}]' })\n```\n\n## Example 6: Standalone Text\n```\nadd_elements({ elements: '[{\"id\":\"title\",\"type\":\"text\",\"x\":200,\"y\":50,\"width\":300,\"height\":50,\"text\":\"Architecture Overview\",\"fontSize\":36,\"fontFamily\":5,\"textAlign\":\"center\",\"strokeColor\":\"#1e1e1e\"}]' })\n```\n\n---\n\n# Animation Examples\n\n## Example 7: Fade In\n```\nadd_keyframe({ targetId: \"box1\", property: \"opacity\", time: 0, value: 0 })\nadd_keyframe({ targetId: \"box1\", property: \"opacity\", time: 800, value: 1, easing: \"easeOut\" })\n```\n\n## Example 8: Slide In from Left\n```\nadd_keyframes_batch({ keyframes: '[{\"targetId\":\"box1\",\"property\":\"translateX\",\"time\":0,\"value\":-300},{\"targetId\":\"box1\",\"property\":\"translateX\",\"time\":1000,\"value\":0,\"easing\":\"easeOutCubic\"},{\"targetId\":\"box1\",\"property\":\"opacity\",\"time\":0,\"value\":0},{\"targetId\":\"box1\",\"property\":\"opacity\",\"time\":500,\"value\":1,\"easing\":\"easeOut\"}]' })\n```\n\n## Example 9: Pop In from Center (Scale Up with Bounce)\n```\nadd_keyframes_batch({ keyframes: '[{\"targetId\":\"box1\",\"property\":\"scaleX\",\"time\":0,\"value\":0.3,\"scaleOrigin\":\"center\"},{\"targetId\":\"box1\",\"property\":\"scaleY\",\"time\":0,\"value\":0.3,\"scaleOrigin\":\"center\"},{\"targetId\":\"box1\",\"property\":\"scaleX\",\"time\":600,\"value\":1,\"easing\":\"easeOutBack\",\"scaleOrigin\":\"center\"},{\"targetId\":\"box1\",\"property\":\"scaleY\",\"time\":600,\"value\":1,\"easing\":\"easeOutBack\",\"scaleOrigin\":\"center\"},{\"targetId\":\"box1\",\"property\":\"opacity\",\"time\":0,\"value\":0},{\"targetId\":\"box1\",\"property\":\"opacity\",\"time\":300,\"value\":1}]' })\n```\n\n## Example 9b: Scale from Bottom Edge\n```\nadd_scale_animation({ targetId: \"box1\", origin: \"bottom\", keyframes: '[{\"time\":0,\"scaleX\":1,\"scaleY\":0},{\"time\":800,\"scaleX\":1,\"scaleY\":1,\"easing\":\"easeOutCubic\"}]' })\n```\nScale origins: center, top-left, top-right, bottom-left, bottom-right, top, bottom, left, right.\nAdd \"scaleOrigin\" per scaleX/scaleY keyframe in add_keyframes_batch, or use add_scale_animation for a single element.\n\n## Example 10: Draw In an Arrow (Stroke Animation)\n```\nadd_keyframe({ targetId: \"arrow1\", property: \"drawProgress\", time: 0, value: 0 })\nadd_keyframe({ targetId: \"arrow1\", property: \"drawProgress\", time: 1200, value: 1, easing: \"easeInOut\" })\n```\n\n## Example 11: Sequential Reveal \u2014 A \u2192 Arrow \u2192 B (Most Common Pattern)\n```\nadd_keyframes_batch({ keyframes: '[\n  {\"targetId\":\"A\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"A\",\"property\":\"opacity\",\"time\":600,\"value\":1,\"easing\":\"easeOut\"},\n  {\"targetId\":\"arrow1\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"arrow1\",\"property\":\"opacity\",\"time\":600,\"value\":0},\n  {\"targetId\":\"arrow1\",\"property\":\"opacity\",\"time\":700,\"value\":1},\n  {\"targetId\":\"arrow1\",\"property\":\"drawProgress\",\"time\":600,\"value\":0},\n  {\"targetId\":\"arrow1\",\"property\":\"drawProgress\",\"time\":1800,\"value\":1,\"easing\":\"easeInOut\"},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":1800,\"value\":0},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":2400,\"value\":1,\"easing\":\"easeOut\"}\n]' })\n```\n\n## Example 12: Bidirectional Flow \u2014 A \u2194 B\n```\nadd_keyframes_batch({ keyframes: '[\n  {\"targetId\":\"A\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"A\",\"property\":\"opacity\",\"time\":500,\"value\":1,\"easing\":\"easeOut\"},\n  {\"targetId\":\"arrowAB\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"arrowAB\",\"property\":\"opacity\",\"time\":500,\"value\":1},\n  {\"targetId\":\"arrowAB\",\"property\":\"drawProgress\",\"time\":500,\"value\":0},\n  {\"targetId\":\"arrowAB\",\"property\":\"drawProgress\",\"time\":1500,\"value\":1,\"easing\":\"easeInOut\"},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":1500,\"value\":0},\n  {\"targetId\":\"B\",\"property\":\"opacity\",\"time\":2000,\"value\":1,\"easing\":\"easeOut\"},\n  {\"targetId\":\"arrowBA\",\"property\":\"opacity\",\"time\":0,\"value\":0},\n  {\"targetId\":\"arrowBA\",\"property\":\"opacity\",\"time\":2000,\"value\":1},\n  {\"targetId\":\"arrowBA\",\"property\":\"drawProgress\",\"time\":2000,\"value\":0},\n  {\"targetId\":\"arrowBA\",\"property\":\"drawProgress\",\"time\":3000,\"value\":1,\"easing\":\"easeInOut\"}\n]' })\n```\n\n## Example 13: Staggered Reveal via create_sequence\n```\ncreate_sequence({ elementIds: [\"title\",\"box1\",\"arrow1\",\"box2\",\"arrow2\",\"box3\"], property: \"opacity\", startTime: 0, delay: 400, duration: 600 })\n```\nResult: title at 0ms, box1 at 400ms, arrow1 at 800ms, box2 at 1200ms, arrow2 at 1600ms, box3 at 2000ms.\n\n## Example 14: Camera Pan\n```\nset_camera_frame({ x: 300, y: 200, width: 800, aspectRatio: \"16:9\" })\nadd_camera_keyframe({ property: \"translateX\", time: 0, value: -200 })\nadd_camera_keyframe({ property: \"translateX\", time: 3000, value: 200, easing: \"easeInOut\" })\n```\n\n## Example 15: Camera Zoom In\n```\nadd_camera_keyframe({ property: \"scaleX\", time: 0, value: 2 })\nadd_camera_keyframe({ property: \"scaleY\", time: 0, value: 2 })\nadd_camera_keyframe({ property: \"scaleX\", time: 2000, value: 1, easing: \"easeInOutCubic\" })\nadd_camera_keyframe({ property: \"scaleY\", time: 2000, value: 1, easing: \"easeInOutCubic\" })\n```\n\n## Example 16: Clip Range + Save\n```\nset_clip_range({ start: 0, end: 5000 })\nsave_checkpoint({ id: \"my-animation\" })\n```\n\n---\n\n# Tips\n\n1. Always call create_scene first (or clear_scene to start fresh), then animate.\n2. Use add_keyframes_batch for efficiency \u2014 one call for many keyframes.\n3. Use create_sequence for simple staggered reveals.\n4. Bound text inherits container animation \u2014 animating arrow opacity also hides its label.\n5. drawProgress only works on arrows and lines.\n6. easeOutBack gives a nice bounce for pop-in effects.\n7. easeInOutCubic is the best general-purpose easing.\n8. Set elements to opacity 0 at time 0 if they should appear later.\n9. Set clip range before saving \u2014 it defines what gets exported.\n10. Camera scale > 1 = zoomed out, < 1 = zoomed in.\n11. Use delete_items to remove elements AND their animation tracks in one call.\n12. Verify your work with animations_of_item, items_visible_in_camera, are_items_in_line, is_camera_centered.\n\n## Example 17: Verify Animation\n```\nanimations_of_item({ targetId: \"box1\" })\n// Returns:\n//   opacity:\n//     0ms 0% \u2191 100% 600ms (easeOut)\n\nitems_visible_in_camera({ time: 1000 })\n// Returns: 5/8 items visible (62%) at 1000ms\n\nare_items_in_line({ ids: [\"box1\",\"box2\",\"box3\"], axis: \"horizontal\" })\n// Returns: \u2705 Aligned (max deviation: 3px)\n\nis_camera_centered({ axis: \"both\", time: 0 })\n// Returns: \u2705 Centered (offsets: dx=5 dy=2)\n```\n\n## Example 18: Delete and Rebuild\n```\ndelete_items({ ids: [\"old_box\", \"old_arrow\"] })\n// Removes elements + all their animation tracks\n\nclear_scene()\n// Nuclear option: removes everything\n```\n";
+//# sourceMappingURL=referenceText.d.ts.map

package/dist/server/referenceText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceText.d.ts","sourceRoot":"","sources":["../../src/server/referenceText.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,w9FAgG1B,CAAC;AAEF,eAAO,MAAM,aAAa,m0SAyKzB,CAAC"}

package/dist/server/referenceText.js

@@ -0,0 +1,268 @@
+export const REFERENCE_TEXT = `# Excalimate MCP Reference
+
+## Excalidraw Element Format
+
+Every element has these base properties:
+\`\`\`json
+{
+  "id": "unique-id",
+  "type": "rectangle|ellipse|diamond|arrow|line|text|freedraw|image",
+  "x": 100, "y": 200,
+  "width": 300, "height": 150,
+  "angle": 0,
+  "strokeColor": "#1e1e1e",
+  "backgroundColor": "transparent",
+  "fillStyle": "solid",
+  "strokeWidth": 2,
+  "roughness": 1,
+  "opacity": 100,
+  "groupIds": [],
+  "isDeleted": false
+}
+\`\`\`
+
+### Text Elements
+\`\`\`json
+{
+  "type": "text",
+  "text": "Hello World",
+  "fontSize": 20,
+  "fontFamily": 5,
+  "textAlign": "center",
+  "verticalAlign": "middle"
+}
+\`\`\`
+
+### Arrow/Line Elements
+\`\`\`json
+{
+  "type": "arrow",
+  "points": [[0, 0], [200, 100]],
+  "startArrowhead": null,
+  "endArrowhead": "arrow",
+  "startBinding": null,
+  "endBinding": null
+}
+\`\`\`
+
+### Bound Text (Label on Shape)
+Create a text element with \`containerId\` pointing to the shape:
+\`\`\`json
+{ "type": "text", "containerId": "shape-id", ... }
+\`\`\`
+And add to the shape: \`"boundElements": [{"id": "text-id", "type": "text"}]\`
+
+## Color Palettes
+
+**Stroke**: #1e1e1e, #e03131, #2f9e44, #1971c2, #f08c00, #6741d9, #0c8599, #e8590c
+**Background**: transparent, #ffc9c9, #b2f2bb, #a5d8ff, #ffec99, #d0bfff, #99e9f2, #ffd8a8
+
+## Animatable Properties
+
+| Property | Range | Description |
+|----------|-------|-------------|
+| opacity | 0–1 | Element visibility (0=hidden, 1=visible) |
+| translateX | px | Horizontal position offset |
+| translateY | px | Vertical position offset |
+| scaleX | 0.1+ | Horizontal scale (1=normal) |
+| scaleY | 0.1+ | Vertical scale (1=normal) |
+| rotation | degrees | Rotation angle |
+| drawProgress | 0–1 | Stroke draw-on progress (for lines/arrows) |
+
+## Easing Types
+
+linear, easeIn, easeOut, easeInOut, easeInQuad, easeOutQuad, easeInOutQuad,
+easeInCubic, easeOutCubic, easeInOutCubic, easeInBack, easeOutBack, easeInOutBack,
+easeInElastic, easeOutElastic, easeInBounce, easeOutBounce, step
+
+## Workflow
+
+1. Call \`read_me\` (this tool) to get the reference
+2. Call \`create_scene\` with Excalidraw elements JSON (or \`clear_scene\` to start fresh)
+3. Call \`add_keyframe\` or \`add_keyframes_batch\` to animate elements
+4. Use \`create_sequence\` for reveal animations
+5. Call \`set_clip_range\` to set export bounds
+6. Call \`save_checkpoint\` to persist
+7. User opens the checkpoint in the Excalimate web app for preview/export
+
+Use \`clear_scene\` to reset everything (elements + animations) or \`clear_animation\` to keep elements but remove all keyframes.
+
+## Example: Fade-in Rectangle
+
+\`\`\`
+1. create_scene: [{"id":"rect1","type":"rectangle","x":100,"y":100,"width":200,"height":100,...}]
+2. add_keyframe: {targetId:"rect1", property:"opacity", time:0, value:0}
+3. add_keyframe: {targetId:"rect1", property:"opacity", time:1000, value:1, easing:"easeOut"}
+\`\`\`
+`;
+export const EXAMPLES_TEXT = `# Excalimate — Few-Shot Examples
+
+## Example 1: Single Rectangle
+\`\`\`
+create_scene({ elements: '[{"id":"box1","type":"rectangle","x":200,"y":150,"width":250,"height":120,"strokeColor":"#1971c2","backgroundColor":"#a5d8ff","fillStyle":"solid"}]' })
+\`\`\`
+
+## Example 2: Rectangle with Bound Text Label
+\`\`\`
+create_scene({ elements: '[{"id":"server","type":"rectangle","x":100,"y":100,"width":200,"height":80,"strokeColor":"#1e1e1e","backgroundColor":"#a5d8ff","fillStyle":"solid","boundElements":[{"id":"server-label","type":"text"}]},{"id":"server-label","type":"text","x":140,"y":125,"width":120,"height":30,"text":"API Server","fontSize":20,"fontFamily":5,"textAlign":"center","verticalAlign":"middle","containerId":"server"}]' })
+\`\`\`
+
+## Example 3: Two Shapes Connected by Arrow
+\`\`\`
+create_scene({ elements: '[{"id":"A","type":"rectangle","x":100,"y":200,"width":150,"height":80,"strokeColor":"#1e1e1e","backgroundColor":"#b2f2bb","fillStyle":"solid"},{"id":"B","type":"rectangle","x":500,"y":200,"width":150,"height":80,"strokeColor":"#1e1e1e","backgroundColor":"#a5d8ff","fillStyle":"solid"},{"id":"arrow1","type":"arrow","x":250,"y":240,"width":250,"height":0,"points":[[0,0],[250,0]],"endArrowhead":"arrow","startBinding":{"elementId":"A","focus":0,"gap":1},"endBinding":{"elementId":"B","focus":0,"gap":1}}]' })
+\`\`\`
+
+## Example 4: Ellipse and Diamond
+\`\`\`
+add_elements({ elements: '[{"id":"circle1","type":"ellipse","x":300,"y":100,"width":120,"height":120,"strokeColor":"#e03131","backgroundColor":"#ffc9c9","fillStyle":"solid"},{"id":"diamond1","type":"diamond","x":500,"y":90,"width":140,"height":140,"strokeColor":"#6741d9","backgroundColor":"#d0bfff","fillStyle":"solid"}]' })
+\`\`\`
+
+## Example 5: Multi-Point Line
+\`\`\`
+add_elements({ elements: '[{"id":"line1","type":"line","x":100,"y":300,"width":400,"height":80,"points":[[0,0],[200,-80],[400,0]],"strokeColor":"#e03131","strokeWidth":3}]' })
+\`\`\`
+
+## Example 6: Standalone Text
+\`\`\`
+add_elements({ elements: '[{"id":"title","type":"text","x":200,"y":50,"width":300,"height":50,"text":"Architecture Overview","fontSize":36,"fontFamily":5,"textAlign":"center","strokeColor":"#1e1e1e"}]' })
+\`\`\`
+
+---
+
+# Animation Examples
+
+## Example 7: Fade In
+\`\`\`
+add_keyframe({ targetId: "box1", property: "opacity", time: 0, value: 0 })
+add_keyframe({ targetId: "box1", property: "opacity", time: 800, value: 1, easing: "easeOut" })
+\`\`\`
+
+## Example 8: Slide In from Left
+\`\`\`
+add_keyframes_batch({ keyframes: '[{"targetId":"box1","property":"translateX","time":0,"value":-300},{"targetId":"box1","property":"translateX","time":1000,"value":0,"easing":"easeOutCubic"},{"targetId":"box1","property":"opacity","time":0,"value":0},{"targetId":"box1","property":"opacity","time":500,"value":1,"easing":"easeOut"}]' })
+\`\`\`
+
+## Example 9: Pop In from Center (Scale Up with Bounce)
+\`\`\`
+add_keyframes_batch({ keyframes: '[{"targetId":"box1","property":"scaleX","time":0,"value":0.3,"scaleOrigin":"center"},{"targetId":"box1","property":"scaleY","time":0,"value":0.3,"scaleOrigin":"center"},{"targetId":"box1","property":"scaleX","time":600,"value":1,"easing":"easeOutBack","scaleOrigin":"center"},{"targetId":"box1","property":"scaleY","time":600,"value":1,"easing":"easeOutBack","scaleOrigin":"center"},{"targetId":"box1","property":"opacity","time":0,"value":0},{"targetId":"box1","property":"opacity","time":300,"value":1}]' })
+\`\`\`
+
+## Example 9b: Scale from Bottom Edge
+\`\`\`
+add_scale_animation({ targetId: "box1", origin: "bottom", keyframes: '[{"time":0,"scaleX":1,"scaleY":0},{"time":800,"scaleX":1,"scaleY":1,"easing":"easeOutCubic"}]' })
+\`\`\`
+Scale origins: center, top-left, top-right, bottom-left, bottom-right, top, bottom, left, right.
+Add "scaleOrigin" per scaleX/scaleY keyframe in add_keyframes_batch, or use add_scale_animation for a single element.
+
+## Example 10: Draw In an Arrow (Stroke Animation)
+\`\`\`
+add_keyframe({ targetId: "arrow1", property: "drawProgress", time: 0, value: 0 })
+add_keyframe({ targetId: "arrow1", property: "drawProgress", time: 1200, value: 1, easing: "easeInOut" })
+\`\`\`
+
+## Example 11: Sequential Reveal — A → Arrow → B (Most Common Pattern)
+\`\`\`
+add_keyframes_batch({ keyframes: '[
+  {"targetId":"A","property":"opacity","time":0,"value":0},
+  {"targetId":"A","property":"opacity","time":600,"value":1,"easing":"easeOut"},
+  {"targetId":"arrow1","property":"opacity","time":0,"value":0},
+  {"targetId":"arrow1","property":"opacity","time":600,"value":0},
+  {"targetId":"arrow1","property":"opacity","time":700,"value":1},
+  {"targetId":"arrow1","property":"drawProgress","time":600,"value":0},
+  {"targetId":"arrow1","property":"drawProgress","time":1800,"value":1,"easing":"easeInOut"},
+  {"targetId":"B","property":"opacity","time":0,"value":0},
+  {"targetId":"B","property":"opacity","time":1800,"value":0},
+  {"targetId":"B","property":"opacity","time":2400,"value":1,"easing":"easeOut"}
+]' })
+\`\`\`
+
+## Example 12: Bidirectional Flow — A ↔ B
+\`\`\`
+add_keyframes_batch({ keyframes: '[
+  {"targetId":"A","property":"opacity","time":0,"value":0},
+  {"targetId":"A","property":"opacity","time":500,"value":1,"easing":"easeOut"},
+  {"targetId":"arrowAB","property":"opacity","time":0,"value":0},
+  {"targetId":"arrowAB","property":"opacity","time":500,"value":1},
+  {"targetId":"arrowAB","property":"drawProgress","time":500,"value":0},
+  {"targetId":"arrowAB","property":"drawProgress","time":1500,"value":1,"easing":"easeInOut"},
+  {"targetId":"B","property":"opacity","time":0,"value":0},
+  {"targetId":"B","property":"opacity","time":1500,"value":0},
+  {"targetId":"B","property":"opacity","time":2000,"value":1,"easing":"easeOut"},
+  {"targetId":"arrowBA","property":"opacity","time":0,"value":0},
+  {"targetId":"arrowBA","property":"opacity","time":2000,"value":1},
+  {"targetId":"arrowBA","property":"drawProgress","time":2000,"value":0},
+  {"targetId":"arrowBA","property":"drawProgress","time":3000,"value":1,"easing":"easeInOut"}
+]' })
+\`\`\`
+
+## Example 13: Staggered Reveal via create_sequence
+\`\`\`
+create_sequence({ elementIds: ["title","box1","arrow1","box2","arrow2","box3"], property: "opacity", startTime: 0, delay: 400, duration: 600 })
+\`\`\`
+Result: title at 0ms, box1 at 400ms, arrow1 at 800ms, box2 at 1200ms, arrow2 at 1600ms, box3 at 2000ms.
+
+## Example 14: Camera Pan
+\`\`\`
+set_camera_frame({ x: 300, y: 200, width: 800, aspectRatio: "16:9" })
+add_camera_keyframe({ property: "translateX", time: 0, value: -200 })
+add_camera_keyframe({ property: "translateX", time: 3000, value: 200, easing: "easeInOut" })
+\`\`\`
+
+## Example 15: Camera Zoom In
+\`\`\`
+add_camera_keyframe({ property: "scaleX", time: 0, value: 2 })
+add_camera_keyframe({ property: "scaleY", time: 0, value: 2 })
+add_camera_keyframe({ property: "scaleX", time: 2000, value: 1, easing: "easeInOutCubic" })
+add_camera_keyframe({ property: "scaleY", time: 2000, value: 1, easing: "easeInOutCubic" })
+\`\`\`
+
+## Example 16: Clip Range + Save
+\`\`\`
+set_clip_range({ start: 0, end: 5000 })
+save_checkpoint({ id: "my-animation" })
+\`\`\`
+
+---
+
+# Tips
+
+1. Always call create_scene first (or clear_scene to start fresh), then animate.
+2. Use add_keyframes_batch for efficiency — one call for many keyframes.
+3. Use create_sequence for simple staggered reveals.
+4. Bound text inherits container animation — animating arrow opacity also hides its label.
+5. drawProgress only works on arrows and lines.
+6. easeOutBack gives a nice bounce for pop-in effects.
+7. easeInOutCubic is the best general-purpose easing.
+8. Set elements to opacity 0 at time 0 if they should appear later.
+9. Set clip range before saving — it defines what gets exported.
+10. Camera scale > 1 = zoomed out, < 1 = zoomed in.
+11. Use delete_items to remove elements AND their animation tracks in one call.
+12. Verify your work with animations_of_item, items_visible_in_camera, are_items_in_line, is_camera_centered.
+
+## Example 17: Verify Animation
+\`\`\`
+animations_of_item({ targetId: "box1" })
+// Returns:
+//   opacity:
+//     0ms 0% ↑ 100% 600ms (easeOut)
+
+items_visible_in_camera({ time: 1000 })
+// Returns: 5/8 items visible (62%) at 1000ms
+
+are_items_in_line({ ids: ["box1","box2","box3"], axis: "horizontal" })
+// Returns: ✅ Aligned (max deviation: 3px)
+
+is_camera_centered({ axis: "both", time: 0 })
+// Returns: ✅ Centered (offsets: dx=5 dy=2)
+\`\`\`
+
+## Example 18: Delete and Rebuild
+\`\`\`
+delete_items({ ids: ["old_box", "old_arrow"] })
+// Removes elements + all their animation tracks
+
+clear_scene()
+// Nuclear option: removes everything
+\`\`\`
+`;
+//# sourceMappingURL=referenceText.js.map

package/dist/server/referenceText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceText.js","sourceRoot":"","sources":["../../src/server/referenceText.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgG7B,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyK5B,CAAC"}

package/dist/server/sceneTools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { StateContext } from './stateContext.js';
+export declare function registerSceneTools(server: McpServer, ctx: StateContext, normalizeElements: (elements: any[]) => any[]): void;
+//# sourceMappingURL=sceneTools.d.ts.map

package/dist/server/sceneTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneTools.d.ts","sourceRoot":"","sources":["../../src/server/sceneTools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,YAAY,EACjB,iBAAiB,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,GAC5C,IAAI,CAsHN"}

package/dist/server/sceneTools.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+export function registerSceneTools(server, ctx, normalizeElements) {
+    ctx.mutatingTool('create_scene', 'Create or replace the Excalidraw scene with the given elements.', { elements: z.string().describe('JSON string of Excalidraw elements array') }, async ({ elements }) => {
+        try {
+            const parsed = JSON.parse(elements);
+            if (!Array.isArray(parsed))
+                return { content: [{ type: 'text', text: 'Error: elements must be a JSON array' }] };
+            const state = ctx.getState();
+            state.scene.elements = normalizeElements(parsed);
+            return { content: [{ type: 'text', text: `Scene created with ${parsed.length} elements.` }] };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error parsing elements: ${e}` }] };
+        }
+    });
+    ctx.mutatingTool('add_elements', 'Add elements to the existing scene.', { elements: z.string().describe('JSON string of elements to add') }, async ({ elements }) => {
+        try {
+            const parsed = JSON.parse(elements);
+            if (!Array.isArray(parsed))
+                return { content: [{ type: 'text', text: 'Error: must be array' }] };
+            const state = ctx.getState();
+            state.scene.elements.push(...normalizeElements(parsed));
+            return { content: [{ type: 'text', text: `Added ${parsed.length} elements. Total: ${state.scene.elements.length}.` }] };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error: ${e}` }] };
+        }
+    });
+    ctx.mutatingTool('remove_elements', 'Remove elements by their IDs.', { ids: z.array(z.string()).describe('Array of element IDs to remove') }, async ({ ids }) => {
+        const state = ctx.getState();
+        const idSet = new Set(ids);
+        const before = state.scene.elements.length;
+        state.scene.elements = state.scene.elements.filter((el) => !idSet.has(el.id));
+        const removed = before - state.scene.elements.length;
+        return { content: [{ type: 'text', text: `Removed ${removed} elements. Total: ${state.scene.elements.length}.` }] };
+    });
+    ctx.mutatingTool('update_elements', 'Update properties of existing elements.', { updates: z.string().describe('JSON string of array [{id, ...properties}]') }, async ({ updates }) => {
+        try {
+            const parsed = JSON.parse(updates);
+            if (!Array.isArray(parsed))
+                return { content: [{ type: 'text', text: 'Error: must be array' }] };
+            const state = ctx.getState();
+            // Build id→index map for O(1) lookups instead of O(n) findIndex per update
+            const indexById = new Map();
+            for (let i = 0; i < state.scene.elements.length; i++) {
+                indexById.set(state.scene.elements[i].id, i);
+            }
+            let updated = 0;
+            for (const upd of parsed) {
+                const idx = indexById.get(upd.id);
+                if (idx !== undefined) {
+                    state.scene.elements[idx] = { ...state.scene.elements[idx], ...upd };
+                    updated++;
+                }
+            }
+            return { content: [{ type: 'text', text: `Updated ${updated} elements.` }] };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error: ${e}` }] };
+        }
+    });
+    server.tool('get_scene', 'Return the current scene elements as JSON.', {}, async () => ({
+        content: [{ type: 'text', text: JSON.stringify(ctx.getState().scene.elements, null, 2) }],
+    }));
+    ctx.mutatingTool('clear_scene', 'Clear all elements and all animation tracks. Resets the scene to a blank canvas.', {}, async () => {
+        const state = ctx.getState();
+        state.scene.elements = [];
+        state.scene.files = {};
+        state.timeline.tracks = [];
+        return { content: [{ type: 'text', text: 'Scene and all animations cleared.' }] };
+    });
+    ctx.mutatingTool('delete_items', 'Delete specific elements and all their animation tracks. Batch operation.', {
+        ids: z.array(z.string()).describe('Element IDs to delete'),
+    }, async ({ ids }) => {
+        const state = ctx.getState();
+        const idSet = new Set(ids);
+        const beforeEl = state.scene.elements.length;
+        const beforeTr = state.timeline.tracks.length;
+        state.scene.elements = state.scene.elements.filter((el) => !idSet.has(el.id));
+        state.timeline.tracks = state.timeline.tracks.filter((t) => !idSet.has(t.targetId));
+        const removedEl = beforeEl - state.scene.elements.length;
+        const removedTr = beforeTr - state.timeline.tracks.length;
+        return { content: [{ type: 'text', text: `Deleted ${removedEl} elements and ${removedTr} animation tracks.` }] };
+    });
+}
+//# sourceMappingURL=sceneTools.js.map

package/dist/server/sceneTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneTools.js","sourceRoot":"","sources":["../../src/server/sceneTools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,kBAAkB,CAChC,MAAiB,EACjB,GAAiB,EACjB,iBAA6C;IAE7C,GAAG,CAAC,YAAY,CACd,cAAc,EACd,iEAAiE,EACjE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC,EAAE,EAC7E,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sCAAsC,EAAE,CAAC,EAAE,CAAC;YAC1H,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC7B,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACjD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,MAAM,CAAC,MAAM,YAAY,EAAE,CAAC,EAAE,CAAC;QACzG,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,2BAA2B,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACxF,CAAC;IACH,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,YAAY,CACd,cAAc,EACd,qCAAqC,EACrC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,EACnE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,EAAE,CAAC;YAC1G,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC7B,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;YACxD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,qBAAqB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC;QACnI,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,YAAY,CACd,iBAAiB,EACjB,+BAA+B,EAC/B,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,EACvE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC3C,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,OAAO,qBAAqB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC;IAC/H,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,YAAY,CACd,iBAAiB,EACjB,yCAAyC,EACzC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC,EAAE,EAC9E,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,EAAE,CAAC;YAC1G,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC7B,2EAA2E;YAC3E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;YAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrD,SAAS,CAAC,GAAG,CAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAS,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACxD,CAAC;YACD,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAClC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACtB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;oBACrE,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,OAAO,YAAY,EAAE,CAAC,EAAE,CAAC;QACxF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACvE,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,WAAW,EACX,4CAA4C,EAC5C,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnG,CAAC,CACH,CAAC;IAEF,GAAG,CAAC,YAAY,CACd,aAAa,EACb,kFAAkF,EAClF,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC7B,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC;QAC1B,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;QACvB,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC,EAAE,CAAC;IAC7F,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,YAAY,CACd,cAAc,EACd,2EAA2E,EAC3E;QACE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;KAC3D,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QAC9C,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACnF,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzF,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACzD,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QAC1D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,SAAS,iBAAiB,SAAS,oBAAoB,EAAE,CAAC,EAAE,CAAC;IAC5H,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/shareTools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP tool: share_project
+ *
+ * Creates an E2E encrypted share URL containing the complete project state.
+ * Uses AES-256-GCM encryption — the key is returned to the AI in the URL
+ * hash fragment and never stored on the server.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { StateContext } from './stateContext.js';
+export declare function registerShareTools(server: McpServer, ctx: StateContext, serverPort: number): void;
+//# sourceMappingURL=shareTools.d.ts.map

package/dist/server/shareTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shareTools.d.ts","sourceRoot":"","sources":["../../src/server/shareTools.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAwBtD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,MAAM,GACjB,IAAI,CA6DN"}