@excalimate/mcp-server 0.1.0 → 0.3.0

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":"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"}

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"}

package/dist/server/shareTools.js

@@ -0,0 +1,81 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * 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 crypto from 'node:crypto';
+import { z } from 'zod';
+import { promisify } from 'node:util';
+import { gzip } from 'node:zlib';
+const gzipAsync = promisify(gzip);
+/**
+ * Encrypt data with AES-256-GCM.
+ * Returns: [IV (12 bytes)] [ciphertext + GCM auth tag]
+ */
+function encrypt(plaintext) {
+    const key = crypto.randomBytes(32); // 256-bit key
+    const iv = crypto.randomBytes(12); // 96-bit IV for GCM
+    const cipher = crypto.createCipheriv('aes-256-gcm', key, iv);
+    const enc = Buffer.concat([cipher.update(plaintext), cipher.final()]);
+    const tag = cipher.getAuthTag(); // 16 bytes
+    // Layout: [IV (12)] [ciphertext] [GCM tag (16)]
+    const result = Buffer.concat([iv, enc, tag]);
+    // Export key as base64url (no padding) for shortest URL
+    const keyBase64url = key.toString('base64url');
+    return { encrypted: result, keyBase64url };
+}
+export function registerShareTools(server, ctx, serverPort) {
+    server.tool('share_project', 'Create an E2E encrypted share URL for the current project. The URL contains the encryption key in the hash fragment (never sent to the server). Returns the shareable URL.', {
+        baseUrl: z.string().optional().describe('Base URL for the share link (default: https://excalimate.com)'),
+    }, async ({ baseUrl }) => {
+        const state = ctx.getState();
+        if (!state.scene.elements || state.scene.elements.length === 0) {
+            return { content: [{ type: 'text', text: 'Error: No elements in the scene. Create a scene first.' }] };
+        }
+        try {
+            // Build the full project payload
+            const payload = JSON.stringify({
+                scene: state.scene,
+                timeline: state.timeline,
+                clipStart: state.clipStart,
+                clipEnd: state.clipEnd,
+                cameraFrame: state.cameraFrame,
+            });
+            // Compress + encrypt
+            const compressed = await gzipAsync(Buffer.from(payload, 'utf-8'));
+            const { encrypted, keyBase64url } = encrypt(compressed);
+            // Upload to the local share endpoint
+            const shareUrl = `http://localhost:${serverPort}/share`;
+            const response = await fetch(shareUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/octet-stream' },
+                body: new Uint8Array(encrypted),
+            });
+            if (!response.ok) {
+                const err = await response.text();
+                return { content: [{ type: 'text', text: `Error uploading share: ${err}` }] };
+            }
+            const { id } = await response.json();
+            // Build the shareable URL — key in hash fragment (never sent to server)
+            const appBase = baseUrl ?? 'https://excalimate.com';
+            const fullUrl = `${appBase}/#share=${id},${keyBase64url}`;
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Share URL created:\n${fullUrl}\n\n` +
+                            `Elements: ${state.scene.elements.length}, ` +
+                            `Tracks: ${state.timeline.tracks.length}, ` +
+                            `Encrypted size: ${(encrypted.length / 1024).toFixed(1)} KB\n\n` +
+                            `The encryption key is in the URL hash — the server only stores an encrypted blob it cannot read.`,
+                    }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: `Error creating share: ${e}` }] };
+        }
+    });
+}
+//# sourceMappingURL=shareTools.js.map

package/dist/server/shareTools.js.map

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

package/dist/server/stateContext.d.ts

@@ -0,0 +1,21 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ServerState } from '../types.js';
+export type StateChangeListener = (delta: Partial<ServerState>) => void;
+export declare function getSharedState(): ServerState;
+export interface StateContext {
+    getState: () => ServerState;
+    updateState: (newState: ServerState) => void;
+    emitChange: () => void;
+    /** Mark a state area as dirty for delta broadcasting. */
+    markDirty: (area: 'scene' | 'timeline' | 'clip' | 'cameraFrame' | 'all') => void;
+    mutatingTool: (name: string, description: string, schema: any, handler: (args: any) => Promise<{
+        content: {
+            type: 'text';
+            text: string;
+        }[];
+    }>, 
+    /** Which state areas this tool modifies (for delta broadcasting). Defaults to 'all'. */
+    dirtyAreas?: Array<'scene' | 'timeline' | 'clip' | 'cameraFrame'>) => void;
+}
+export declare function createStateContext(serverId: string, server: McpServer, onStateChange?: StateChangeListener): StateContext;
+//# sourceMappingURL=stateContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stateContext.d.ts","sourceRoot":"","sources":["../../src/server/stateContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;AAKxE,wBAAgB,cAAc,IAAI,WAAW,CAAyB;AAEtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,WAAW,CAAC;IAC5B,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,yDAAyD;IACzD,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,aAAa,GAAG,KAAK,KAAK,IAAI,CAAC;IACjF,YAAY,EAAE,CACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;IAC9E,wFAAwF;IACxF,UAAU,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,aAAa,CAAC,KAC9D,IAAI,CAAC;CACX;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,EACjB,aAAa,CAAC,EAAE,mBAAmB,GAClC,YAAY,CAgFd"}

package/dist/server/stateContext.js

@@ -0,0 +1,85 @@
+import { createDefaultState } from '../state.js';
+let _activeState = createDefaultState();
+let _activeServerId = null;
+export function getSharedState() { return _activeState; }
+export function createStateContext(serverId, server, onStateChange) {
+    if (_activeServerId !== null) {
+        console.warn(`[excalimate] New server ${serverId} replacing active server ${_activeServerId}. ` +
+            'Concurrent MCP sessions share the same state (single-tenant design).');
+    }
+    _activeServerId = serverId;
+    // ── Delta broadcasting with debounce ───────────────────────────
+    // Track which top-level state areas are dirty via flags set by tools.
+    // When the debounced emit fires, only serialize and broadcast the
+    // dirty fields. This avoids serializing the entire scene+timeline
+    // on every keyframe addition.
+    let _emitTimer = null;
+    const _dirty = { scene: false, timeline: false, clip: false, cameraFrame: false };
+    /** Mark a state area as dirty so it's included in the next broadcast. */
+    function markDirty(area) {
+        if (area === 'all') {
+            _dirty.scene = _dirty.timeline = _dirty.clip = _dirty.cameraFrame = true;
+        }
+        else {
+            _dirty[area] = true;
+        }
+    }
+    const emitChange = () => {
+        // Default: mark everything dirty (tools that don't specify get full broadcast).
+        // Specific tools can call markDirty() before emitChange() for fine-grained deltas.
+        if (!_dirty.scene && !_dirty.timeline && !_dirty.clip && !_dirty.cameraFrame) {
+            markDirty('all');
+        }
+        if (_emitTimer)
+            clearTimeout(_emitTimer);
+        _emitTimer = setTimeout(() => {
+            _emitTimer = null;
+            try {
+                if (!onStateChange)
+                    return;
+                const delta = {};
+                if (_dirty.scene)
+                    delta.scene = _activeState.scene;
+                if (_dirty.timeline)
+                    delta.timeline = _activeState.timeline;
+                if (_dirty.clip) {
+                    delta.clipStart = _activeState.clipStart;
+                    delta.clipEnd = _activeState.clipEnd;
+                }
+                if (_dirty.cameraFrame)
+                    delta.cameraFrame = _activeState.cameraFrame;
+                // Reset dirty flags
+                _dirty.scene = _dirty.timeline = _dirty.clip = _dirty.cameraFrame = false;
+                if (Object.keys(delta).length === 0)
+                    return;
+                onStateChange(delta);
+            }
+            catch (err) {
+                console.error('emitChange failed:', err);
+            }
+        }, 50);
+    };
+    server.__getState = () => _activeState;
+    const updateState = (newState) => {
+        _activeState = newState;
+    };
+    const mutatingTool = (name, description, schema, handler, dirtyAreas) => {
+        server.tool(name, description, schema, async (args) => {
+            const result = await handler(args);
+            if (dirtyAreas) {
+                for (const area of dirtyAreas)
+                    markDirty(area);
+            }
+            emitChange();
+            return result;
+        });
+    };
+    return {
+        getState: () => _activeState,
+        updateState,
+        emitChange,
+        markDirty,
+        mutatingTool,
+    };
+}
+//# sourceMappingURL=stateContext.js.map

package/dist/server/stateContext.js.map

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

package/dist/server.d.ts

@@ -1,13 +1,8 @@
-/**
- * Excalimate MCP Server
- *
- * Provides tools for creating Excalidraw scenes, animating them with keyframes,
- * and exporting the results. Designed for AI agent integration via MCP.
- */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { CheckpointStore } from './checkpoint-store.js';
-import type { ServerState } from './types.js';
-export type StateChangeListener = (state: ServerState) => void;
-export declare function getSharedState(): ServerState;
-export declare function createServer(store: CheckpointStore, onStateChange?: StateChangeListener): McpServer;
+import { getSharedState } from './server/stateContext.js';
+import type { StateChangeListener } from './server/stateContext.js';
+export { getSharedState };
+export type { StateChangeListener } from './server/stateContext.js';
+export declare function createServer(store: CheckpointStore, onStateChange?: StateChangeListener, serverPort?: number): McpServer;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAkD,MAAM,YAAY,CAAC;AAG9F,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAK/D,wBAAgB,cAAc,IAAI,WAAW,CAAyB;AAEtE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,aAAa,CAAC,EAAE,mBAAmB,GAClC,SAAS,CAqvBX"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAa7D,OAAO,EAAsB,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,aAAa,CAAC,EAAE,mBAAmB,EACnC,UAAU,GAAE,MAAa,GACxB,SAAS,CAyBX"}