@imgly/codesign-mcp 0.1.0

package/dist/tools/open-editor.js

@@ -0,0 +1,62 @@
+const DESCRIPTION = "Get a URL the human can open to view the design in CE.SDK. With `revision`, returns the design's " +
+    "stable URL — the viewer keeps it live, re-rendering as you `edit`, so print it ONCE and don't re-emit " +
+    "a fresh URL every turn. Add `pin: true` for a frozen permalink to that exact revision (for 'look at " +
+    "exactly this' or comparing revisions). Omit `revision` for the workspace landing page (mini-studio). " +
+    'The viewer is read-only — agent edits remain authoritative.';
+export function createOpenEditorTool(opts) {
+    return {
+        name: 'open_editor',
+        description: DESCRIPTION,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                revision: {
+                    type: 'string',
+                    description: 'Any revision in the design. Omit to get the workspace landing page.'
+                },
+                pin: {
+                    type: 'boolean',
+                    description: 'When true, return a frozen permalink to this exact revision instead of the live design URL.'
+                }
+            },
+            additionalProperties: false
+        },
+        call: async (rawArgs) => {
+            const args = (rawArgs ?? {});
+            try {
+                if (args.revision === undefined) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({ url: opts.urlBuilder.forStudio() })
+                            }
+                        ]
+                    };
+                }
+                // historyOf returns the chain root-first; [0] is the design root.
+                const chain = await opts.store.historyOf(args.revision);
+                const root = chain[0].id;
+                const url = args.pin
+                    ? opts.urlBuilder.forPinnedRevision(root, args.revision)
+                    : opts.urlBuilder.forDesign(root);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ url }) }]
+                };
+            }
+            catch (err) {
+                const code = err.code;
+                const msg = code === 'ENOENT'
+                    ? `unknown revision ${args.revision}`
+                    : err instanceof Error
+                        ? err.message
+                        : String(err);
+                return {
+                    isError: true,
+                    content: [{ type: 'text', text: `open_editor: ${msg}` }]
+                };
+            }
+        }
+    };
+}
+//# sourceMappingURL=open-editor.js.map

package/dist/tools/open-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-editor.js","sourceRoot":"","sources":["../../src/tools/open-editor.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,GACf,mGAAmG;IACnG,wGAAwG;IACxG,sGAAsG;IACtG,uGAAuG;IACvG,6DAA6D,CAAC;AAEhE,MAAM,UAAU,oBAAoB,CAClC,IAAiC;IAEjC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAiB;oBACvB,WAAW,EACT,qEAAqE;iBACxE;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,SAAkB;oBACxB,WAAW,EACT,6FAA6F;iBAChG;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAyC,CAAC;YACrE,IAAI,CAAC;gBACH,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAChC,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;6BAC3D;yBACF;qBACF,CAAC;gBACJ,CAAC;gBACD,kEAAkE;gBAClE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACxD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG;oBAClB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC;oBACxD,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBACpC,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;iBACpE,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAC;gBAC7C,MAAM,GAAG,GACP,IAAI,KAAK,QAAQ;oBACf,CAAC,CAAC,oBAAoB,IAAI,CAAC,QAAQ,EAAE;oBACrC,CAAC,CAAC,GAAG,YAAY,KAAK;wBACpB,CAAC,CAAC,GAAG,CAAC,OAAO;wBACb,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,gBAAgB,GAAG,EAAE,EAAE,CAAC;iBAClE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { RevisionStore } from '../revisions/store.js';\nimport type { CodesignMcpToolRegistration } from '../server.js';\nimport type { ViewerUrlBuilder } from '../viewer/url-builder.js';\n\nexport interface CreateOpenEditorToolOptions {\n  urlBuilder: ViewerUrlBuilder;\n  /** Resolves a revision to its design root (the root revision id). */\n  store: RevisionStore;\n}\n\nconst DESCRIPTION =\n  \"Get a URL the human can open to view the design in CE.SDK. With `revision`, returns the design's \" +\n  \"stable URL — the viewer keeps it live, re-rendering as you `edit`, so print it ONCE and don't re-emit \" +\n  \"a fresh URL every turn. Add `pin: true` for a frozen permalink to that exact revision (for 'look at \" +\n  \"exactly this' or comparing revisions). Omit `revision` for the workspace landing page (mini-studio). \" +\n  'The viewer is read-only — agent edits remain authoritative.';\n\nexport function createOpenEditorTool(\n  opts: CreateOpenEditorToolOptions\n): CodesignMcpToolRegistration {\n  return {\n    name: 'open_editor',\n    description: DESCRIPTION,\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        revision: {\n          type: 'string' as const,\n          description:\n            'Any revision in the design. Omit to get the workspace landing page.'\n        },\n        pin: {\n          type: 'boolean' as const,\n          description:\n            'When true, return a frozen permalink to this exact revision instead of the live design URL.'\n        }\n      },\n      additionalProperties: false\n    },\n    call: async (rawArgs) => {\n      const args = (rawArgs ?? {}) as { revision?: string; pin?: boolean };\n      try {\n        if (args.revision === undefined) {\n          return {\n            content: [\n              {\n                type: 'text' as const,\n                text: JSON.stringify({ url: opts.urlBuilder.forStudio() })\n              }\n            ]\n          };\n        }\n        // historyOf returns the chain root-first; [0] is the design root.\n        const chain = await opts.store.historyOf(args.revision);\n        const root = chain[0].id;\n        const url = args.pin\n          ? opts.urlBuilder.forPinnedRevision(root, args.revision)\n          : opts.urlBuilder.forDesign(root);\n        return {\n          content: [{ type: 'text' as const, text: JSON.stringify({ url }) }]\n        };\n      } catch (err) {\n        const code = (err as { code?: string }).code;\n        const msg =\n          code === 'ENOENT'\n            ? `unknown revision ${args.revision}`\n            : err instanceof Error\n              ? err.message\n              : String(err);\n        return {\n          isError: true,\n          content: [{ type: 'text' as const, text: `open_editor: ${msg}` }]\n        };\n      }\n    }\n  };\n}\n"]}

package/dist/tools/preview.d.ts

@@ -0,0 +1,12 @@
+import type { Mutex } from '../engine/mutex.js';
+import type { EngineSession } from '../engine/session.js';
+import type { RevisionStore } from '../revisions/store.js';
+import type { CodesignMcpToolRegistration } from '../server.js';
+export interface CreatePreviewToolOptions<E = unknown> {
+    store: RevisionStore;
+    session: EngineSession<E>;
+    /** Guards the shared engine — load-then-export must not interleave with another session's edit (see engine/mutex.ts). */
+    engineLock: Mutex;
+}
+export declare function createPreviewTool<E = unknown>(opts: CreatePreviewToolOptions<E>): CodesignMcpToolRegistration;
+//# sourceMappingURL=preview.d.ts.map

package/dist/tools/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/tools/preview.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AA6ChE,MAAM,WAAW,wBAAwB,CAAC,CAAC,GAAG,OAAO;IACnD,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,yHAAyH;IACzH,UAAU,EAAE,KAAK,CAAC;CACnB;AAUD,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAChC,2BAA2B,CAgE7B"}

package/dist/tools/preview.js

@@ -0,0 +1,104 @@
+// packages/codesign-mcp/src/tools/preview.ts
+//
+// `preview` — renders a block to an inline image. Adds an optional `revision`
+// (spec §6.1): when supplied and the engine slot is at a different revision,
+// the session loads that revision before exporting. Without `revision`, renders
+// the engine's current state (uses `session.currentSlot()` — side-effect-free).
+const MAX_DIMENSION_PX = 1800;
+const DEFAULT_TARGET_WIDTH = 512;
+const DESCRIPTION = [
+    'Render a block (almost always a page) to an inline image so you can see the result.',
+    '',
+    "`blockId` is REQUIRED — preview the page you're working on, not the scene root.",
+    '',
+    "Optional `revision`: if supplied, loads that revision into the engine before rendering. Without it, renders the engine's current state (almost always what you want directly after `edit`).",
+    '',
+    "Defaults: format='webp', width=512. Width/height clamped at 1800 px (Anthropic many-image limit)."
+].join('\n');
+const PREVIEW_INPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        blockId: { type: 'integer' },
+        revision: {
+            type: 'string',
+            description: "Revision id; defaults to the engine's current state."
+        },
+        format: { enum: ['webp', 'png', 'jpeg'] },
+        width: { type: 'integer', minimum: 1 },
+        height: { type: 'integer', minimum: 1 }
+    },
+    required: ['blockId'],
+    additionalProperties: false
+};
+function bytesToBase64(bytes) {
+    if (typeof Buffer !== 'undefined')
+        return Buffer.from(bytes).toString('base64');
+    let s = '';
+    for (let i = 0; i < bytes.length; i++)
+        s += String.fromCharCode(bytes[i]);
+    return btoa(s);
+}
+export function createPreviewTool(opts) {
+    const { store, session, engineLock } = opts;
+    return {
+        name: 'preview',
+        description: DESCRIPTION,
+        inputSchema: PREVIEW_INPUT_SCHEMA,
+        call: async (rawArgs) => {
+            const args = (rawArgs ?? {});
+            if (typeof args.blockId !== 'number') {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'preview: `blockId` (integer) is required.'
+                        }
+                    ]
+                };
+            }
+            // Load (if a revision was given) and export read the shared engine across
+            // awaits — serialize against any concurrent engine-touching tool call.
+            return engineLock.runExclusive(async () => {
+                let slot;
+                if (args.revision !== undefined) {
+                    const rev = await store.read(args.revision);
+                    await session.populate(args.revision, rev.scene);
+                    slot = await session.acquire(args.revision);
+                }
+                else {
+                    // No revision: render the current engine state via the side-effect-free
+                    // currentSlot accessor (does NOT reset). If no slot is warm, error.
+                    const current = session.currentSlot();
+                    if (!current) {
+                        return {
+                            isError: true,
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: 'preview: no engine state to render. Run `edit` first, or pass `revision` to load a specific revision.'
+                                }
+                            ]
+                        };
+                    }
+                    slot = current;
+                }
+                const eng = slot.engine;
+                const format = args.format ?? 'webp';
+                const mimeType = `image/${format}`;
+                const targetWidth = Math.min(args.width ?? DEFAULT_TARGET_WIDTH, MAX_DIMENSION_PX);
+                const exportOpts = { targetWidth };
+                if (args.height !== undefined)
+                    exportOpts.targetHeight = Math.min(args.height, MAX_DIMENSION_PX);
+                const blob = await eng.block.export(args.blockId, mimeType, exportOpts);
+                const bytes = new Uint8Array(await blob.arrayBuffer());
+                return {
+                    content: [
+                        { type: 'image', data: bytesToBase64(bytes), mimeType }
+                    ]
+                };
+            });
+        }
+    };
+}
+//# sourceMappingURL=preview.js.map

package/dist/tools/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../src/tools/preview.ts"],"names":[],"mappings":"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","sourcesContent":["// packages/codesign-mcp/src/tools/preview.ts\n//\n// `preview` — renders a block to an inline image. Adds an optional `revision`\n// (spec §6.1): when supplied and the engine slot is at a different revision,\n// the session loads that revision before exporting. Without `revision`, renders\n// the engine's current state (uses `session.currentSlot()` — side-effect-free).\n\nimport type { Mutex } from '../engine/mutex.js';\nimport type { EngineSession, EngineSlot } from '../engine/session.js';\nimport type { RevisionStore } from '../revisions/store.js';\nimport type { CodesignMcpToolRegistration } from '../server.js';\n\nconst MAX_DIMENSION_PX = 1800;\nconst DEFAULT_TARGET_WIDTH = 512;\n\ninterface MinimalEngine {\n  block: {\n    export(blockId: number, mimeType: string, options?: unknown): Promise<Blob>;\n  };\n}\n\ninterface PreviewArgs {\n  blockId: number;\n  revision?: string;\n  format?: 'webp' | 'png' | 'jpeg';\n  width?: number;\n  height?: number;\n}\n\nconst DESCRIPTION = [\n  'Render a block (almost always a page) to an inline image so you can see the result.',\n  '',\n  \"`blockId` is REQUIRED — preview the page you're working on, not the scene root.\",\n  '',\n  \"Optional `revision`: if supplied, loads that revision into the engine before rendering. Without it, renders the engine's current state (almost always what you want directly after `edit`).\",\n  '',\n  \"Defaults: format='webp', width=512. Width/height clamped at 1800 px (Anthropic many-image limit).\"\n].join('\\n');\n\nconst PREVIEW_INPUT_SCHEMA = {\n  type: 'object' as const,\n  properties: {\n    blockId: { type: 'integer' as const },\n    revision: {\n      type: 'string' as const,\n      description: \"Revision id; defaults to the engine's current state.\"\n    },\n    format: { enum: ['webp', 'png', 'jpeg'] },\n    width: { type: 'integer' as const, minimum: 1 },\n    height: { type: 'integer' as const, minimum: 1 }\n  },\n  required: ['blockId'],\n  additionalProperties: false\n};\n\nexport interface CreatePreviewToolOptions<E = unknown> {\n  store: RevisionStore;\n  session: EngineSession<E>;\n  /** Guards the shared engine — load-then-export must not interleave with another session's edit (see engine/mutex.ts). */\n  engineLock: Mutex;\n}\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n  if (typeof Buffer !== 'undefined')\n    return Buffer.from(bytes).toString('base64');\n  let s = '';\n  for (let i = 0; i < bytes.length; i++) s += String.fromCharCode(bytes[i]);\n  return btoa(s);\n}\n\nexport function createPreviewTool<E = unknown>(\n  opts: CreatePreviewToolOptions<E>\n): CodesignMcpToolRegistration {\n  const { store, session, engineLock } = opts;\n  return {\n    name: 'preview',\n    description: DESCRIPTION,\n    inputSchema: PREVIEW_INPUT_SCHEMA,\n    call: async (rawArgs) => {\n      const args = (rawArgs ?? {}) as PreviewArgs;\n      if (typeof args.blockId !== 'number') {\n        return {\n          isError: true,\n          content: [\n            {\n              type: 'text' as const,\n              text: 'preview: `blockId` (integer) is required.'\n            }\n          ]\n        };\n      }\n      // Load (if a revision was given) and export read the shared engine across\n      // awaits — serialize against any concurrent engine-touching tool call.\n      return engineLock.runExclusive(async () => {\n        let slot: EngineSlot<E>;\n        if (args.revision !== undefined) {\n          const rev = await store.read(args.revision);\n          await session.populate(args.revision, rev.scene);\n          slot = await session.acquire(args.revision);\n        } else {\n          // No revision: render the current engine state via the side-effect-free\n          // currentSlot accessor (does NOT reset). If no slot is warm, error.\n          const current = session.currentSlot();\n          if (!current) {\n            return {\n              isError: true,\n              content: [\n                {\n                  type: 'text' as const,\n                  text: 'preview: no engine state to render. Run `edit` first, or pass `revision` to load a specific revision.'\n                }\n              ]\n            };\n          }\n          slot = current;\n        }\n        const eng = slot.engine as MinimalEngine;\n        const format = args.format ?? 'webp';\n        const mimeType = `image/${format}`;\n        const targetWidth = Math.min(\n          args.width ?? DEFAULT_TARGET_WIDTH,\n          MAX_DIMENSION_PX\n        );\n        const exportOpts: Record<string, unknown> = { targetWidth };\n        if (args.height !== undefined)\n          exportOpts.targetHeight = Math.min(args.height, MAX_DIMENSION_PX);\n        const blob = await eng.block.export(args.blockId, mimeType, exportOpts);\n        const bytes = new Uint8Array(await blob.arrayBuffer());\n        return {\n          content: [\n            { type: 'image' as const, data: bytesToBase64(bytes), mimeType }\n          ]\n        };\n      });\n    }\n  };\n}\n"]}

package/dist/tools/rename.d.ts

@@ -0,0 +1,7 @@
+import type { RevisionStore } from '../revisions/store.js';
+import type { CodesignMcpToolRegistration } from '../server.js';
+export interface CreateRenameToolOptions {
+    store: RevisionStore;
+}
+export declare function createRenameTool(opts: CreateRenameToolOptions): CodesignMcpToolRegistration;
+//# sourceMappingURL=rename.d.ts.map

package/dist/tools/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../src/tools/rename.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,uBAAuB,GAC5B,2BAA2B,CAsC7B"}

package/dist/tools/rename.js

@@ -0,0 +1,39 @@
+export function createRenameTool(opts) {
+    return {
+        name: 'rename',
+        description: "Rename a design. `revision` may be any revision in the lineage; the root's title is updated. Use this when the title set at design creation no longer fits.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                revision: { type: 'string' },
+                title: { type: 'string' }
+            },
+            required: ['revision', 'title'],
+            additionalProperties: false
+        },
+        call: async (rawArgs) => {
+            const args = (rawArgs ?? {});
+            if (typeof args.revision !== 'string' || typeof args.title !== 'string') {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'rename: `revision` and `title` (strings) are required.'
+                        }
+                    ]
+                };
+            }
+            const result = await opts.store.renameRoot(args.revision, args.title);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ ok: true, ...result })
+                    }
+                ]
+            };
+        }
+    };
+}
+//# sourceMappingURL=rename.js.map

package/dist/tools/rename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../src/tools/rename.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,gBAAgB,CAC9B,IAA6B;IAE7B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,6JAA6J;QAC/J,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;gBACrC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;aACnC;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;YAC/B,oBAAoB,EAAE,KAAK;SAC5B;QACD,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAA0C,CAAC;YACtE,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACxE,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,wDAAwD;yBAC/D;qBACF;iBACF,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACtE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;qBAC9C;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { RevisionStore } from '../revisions/store.js';\nimport type { CodesignMcpToolRegistration } from '../server.js';\n\nexport interface CreateRenameToolOptions {\n  store: RevisionStore;\n}\n\nexport function createRenameTool(\n  opts: CreateRenameToolOptions\n): CodesignMcpToolRegistration {\n  return {\n    name: 'rename',\n    description:\n      \"Rename a design. `revision` may be any revision in the lineage; the root's title is updated. Use this when the title set at design creation no longer fits.\",\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        revision: { type: 'string' as const },\n        title: { type: 'string' as const }\n      },\n      required: ['revision', 'title'],\n      additionalProperties: false\n    },\n    call: async (rawArgs) => {\n      const args = (rawArgs ?? {}) as { revision?: string; title?: string };\n      if (typeof args.revision !== 'string' || typeof args.title !== 'string') {\n        return {\n          isError: true,\n          content: [\n            {\n              type: 'text' as const,\n              text: 'rename: `revision` and `title` (strings) are required.'\n            }\n          ]\n        };\n      }\n      const result = await opts.store.renameRoot(args.revision, args.title);\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: JSON.stringify({ ok: true, ...result })\n          }\n        ]\n      };\n    }\n  };\n}\n"]}

package/dist/tools/result.d.ts

@@ -0,0 +1,12 @@
+import type { ImageContent, TextContent } from './content-types.js';
+/**
+ * The strict return contract for `design_exec`.
+ *
+ * The function body must return undefined, a single MessagePart, or an array
+ * of MessageParts. Anything else throws an educational error so the LLM
+ * learns the rule on first miss.
+ */
+export type MessagePart = TextContent | ImageContent;
+export declare function validatePart(value: unknown): MessagePart;
+export declare function normalizeResult(raw: unknown): MessagePart[];
+//# sourceMappingURL=result.d.ts.map

package/dist/tools/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;AAErD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAcxD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,EAAE,CAI3D"}

package/dist/tools/result.js

@@ -0,0 +1,55 @@
+export function validatePart(value) {
+    if (!value || typeof value !== 'object')
+        throw badShape(value);
+    const v = value;
+    if (v.type === 'text' && typeof v.text === 'string') {
+        return { type: 'text', text: v.text };
+    }
+    if (v.type === 'image' &&
+        typeof v.data === 'string' &&
+        typeof v.mimeType === 'string') {
+        return { type: 'image', data: v.data, mimeType: v.mimeType };
+    }
+    throw badShape(value);
+}
+export function normalizeResult(raw) {
+    if (raw === undefined || raw === null)
+        return [];
+    if (Array.isArray(raw))
+        return raw.map(validatePart);
+    return [validatePart(raw)];
+}
+function inspect(value) {
+    if (value === undefined)
+        return 'undefined';
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return `string("${value.slice(0, 40)}${value.length > 40 ? '…' : ''}")`;
+    if (typeof value === 'number')
+        return `number(${value})`;
+    if (typeof value === 'boolean')
+        return `boolean(${value})`;
+    if (Array.isArray(value))
+        return `array(${value.length} items)`;
+    if (typeof Blob !== 'undefined' && value instanceof Blob)
+        return `Blob(${value.size}B, ${value.type || 'no mime'})`;
+    if (value instanceof Uint8Array)
+        return `Uint8Array(${value.byteLength}B)`;
+    if (value instanceof ArrayBuffer)
+        return `ArrayBuffer(${value.byteLength}B)`;
+    if (typeof value === 'object') {
+        const keys = Object.keys(value)
+            .slice(0, 5)
+            .join(',');
+        return `object({${keys}})`;
+    }
+    return typeof value;
+}
+function badShape(value) {
+    return new Error(`design_exec must return undefined, a MessagePart, or MessagePart[]. Got: ${inspect(value)}. ` +
+        `Wrap explicitly — e.g. return { type: "text", text: String(value) }, or return ` +
+        `{ type: "image", data: "<base64>", mimeType: "image/png" }. For visual verification, ` +
+        `prefer the design_capture tool — it renders + encodes for you.`);
+}
+//# sourceMappingURL=result.js.map

package/dist/tools/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IACD,IACE,CAAC,CAAC,IAAI,KAAK,OAAO;QAClB,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAC9B,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACjD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACrD,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC3B,OAAO,WAAW,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,UAAU,KAAK,GAAG,CAAC;IACzD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,KAAK,GAAG,CAAC;IAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,KAAK,CAAC,MAAM,SAAS,CAAC;IAChE,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,KAAK,YAAY,IAAI;QACtD,OAAO,QAAQ,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,IAAI,SAAS,GAAG,CAAC;IAC5D,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,cAAc,KAAK,CAAC,UAAU,IAAI,CAAC;IAC3E,IAAI,KAAK,YAAY,WAAW;QAAE,OAAO,eAAe,KAAK,CAAC,UAAU,IAAI,CAAC;IAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC;aACtC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,WAAW,IAAI,IAAI,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,IAAI,KAAK,CACd,4EAA4E,OAAO,CAAC,KAAK,CAAC,IAAI;QAC5F,iFAAiF;QACjF,uFAAuF;QACvF,gEAAgE,CACnE,CAAC;AACJ,CAAC","sourcesContent":["import type { ImageContent, TextContent } from './content-types.js';\n\n/**\n * The strict return contract for `design_exec`.\n *\n * The function body must return undefined, a single MessagePart, or an array\n * of MessageParts. Anything else throws an educational error so the LLM\n * learns the rule on first miss.\n */\nexport type MessagePart = TextContent | ImageContent;\n\nexport function validatePart(value: unknown): MessagePart {\n  if (!value || typeof value !== 'object') throw badShape(value);\n  const v = value as Record<string, unknown>;\n  if (v.type === 'text' && typeof v.text === 'string') {\n    return { type: 'text', text: v.text };\n  }\n  if (\n    v.type === 'image' &&\n    typeof v.data === 'string' &&\n    typeof v.mimeType === 'string'\n  ) {\n    return { type: 'image', data: v.data, mimeType: v.mimeType };\n  }\n  throw badShape(value);\n}\n\nexport function normalizeResult(raw: unknown): MessagePart[] {\n  if (raw === undefined || raw === null) return [];\n  if (Array.isArray(raw)) return raw.map(validatePart);\n  return [validatePart(raw)];\n}\n\nfunction inspect(value: unknown): string {\n  if (value === undefined) return 'undefined';\n  if (value === null) return 'null';\n  if (typeof value === 'string')\n    return `string(\"${value.slice(0, 40)}${value.length > 40 ? '…' : ''}\")`;\n  if (typeof value === 'number') return `number(${value})`;\n  if (typeof value === 'boolean') return `boolean(${value})`;\n  if (Array.isArray(value)) return `array(${value.length} items)`;\n  if (typeof Blob !== 'undefined' && value instanceof Blob)\n    return `Blob(${value.size}B, ${value.type || 'no mime'})`;\n  if (value instanceof Uint8Array) return `Uint8Array(${value.byteLength}B)`;\n  if (value instanceof ArrayBuffer) return `ArrayBuffer(${value.byteLength}B)`;\n  if (typeof value === 'object') {\n    const keys = Object.keys(value as object)\n      .slice(0, 5)\n      .join(',');\n    return `object({${keys}})`;\n  }\n  return typeof value;\n}\n\nfunction badShape(value: unknown): Error {\n  return new Error(\n    `design_exec must return undefined, a MessagePart, or MessagePart[]. Got: ${inspect(value)}. ` +\n      `Wrap explicitly — e.g. return { type: \"text\", text: String(value) }, or return ` +\n      `{ type: \"image\", data: \"<base64>\", mimeType: \"image/png\" }. For visual verification, ` +\n      `prefer the design_capture tool — it renders + encodes for you.`\n  );\n}\n"]}

package/dist/tools/save.d.ts

@@ -0,0 +1,19 @@
+import type { Mutex } from '../engine/mutex.js';
+import type { EngineSession } from '../engine/session.js';
+import type { RevisionStore } from '../revisions/store.js';
+import type { CodesignMcpToolRegistration } from '../server.js';
+import type { ViewerUrlBuilder } from '../viewer/url-builder.js';
+import type { WorkspaceFS } from '../workspace/types.js';
+export interface CreateSaveToolOptions<E = unknown> {
+    fs: WorkspaceFS;
+    store: RevisionStore;
+    session: EngineSession<E>;
+    /** Builds the `httpUrl` for workspace-written artifacts (the `/r/` route). */
+    urlBuilder: ViewerUrlBuilder;
+    /** Whether to honour an `outPath` argument (Local: yes; Hosted/sandbox: no). */
+    allowOutPath?: boolean;
+    /** Guards the shared engine — load-then-archive must not interleave with another session's edit. */
+    engineLock: Mutex;
+}
+export declare function createSaveTool<E = unknown>(opts: CreateSaveToolOptions<E>): CodesignMcpToolRegistration;
+//# sourceMappingURL=save.d.ts.map

package/dist/tools/save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../src/tools/save.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA+CzD,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO;IAChD,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,8EAA8E;IAC9E,UAAU,EAAE,gBAAgB,CAAC;IAC7B,gFAAgF;IAChF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oGAAoG;IACpG,UAAU,EAAE,KAAK,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,EACxC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC7B,2BAA2B,CAmF7B"}

package/dist/tools/save.js

@@ -0,0 +1,117 @@
+// packages/codesign-mcp/src/tools/save.ts
+//
+// `save` — emit a self-contained `.zip` archive of a revision (scene + all
+// asset bytes), via CE.SDK `scene.saveToArchive()`. Unlike the removed
+// `export target=scene`, this is an ENGINE operation: the scene is loaded into
+// the shared engine so saveToArchive can resolve `workspace://` asset URIs and
+// bundle the fetched bytes. Output lands at `exports/<shard>/<rev>/archive.zip`
+// and returns the same envelope shape as `export`.
+import { promises as nodeFs } from 'node:fs';
+import { dirname } from 'node:path';
+const DESCRIPTION = [
+    'Save a revision as a portable, self-contained `.zip` archive (scene + all asset bytes bundled). Written into the workspace at `exports/<shard>/<rev>/archive.zip`.',
+    '',
+    'You do NOT need this to persist your work — every `edit` auto-persists to the workspace. Use `save` only to take an editable copy of the design OUT (hand to a human, back it up, move it between servers).',
+    '',
+    'Returns JSON `{ uri, httpUrl?, path?, bytes, format, revision }`. `uri` (a `workspace://` URI) is the durable handle. `httpUrl` is a fetch link tied to this process. `path` (absolute disk path) is returned ONLY when you passed `outPath`.'
+].join('\n');
+// The schema is built per-backend: `outPath` is advertised ONLY when the
+// backend honours it (Local). On Hosted the property is omitted entirely, so
+// an agent never sees an affordance it can't use — it can't try a local path
+// and hit a runtime rejection. The runtime guard in `call` stays as a backstop.
+function buildSaveInputSchema(allowOutPath) {
+    const properties = {
+        revision: { type: 'string' }
+    };
+    if (allowOutPath) {
+        properties.outPath = {
+            type: 'string',
+            description: 'Local-only escape hatch; absolute path.'
+        };
+    }
+    return {
+        type: 'object',
+        properties,
+        required: ['revision'],
+        additionalProperties: false
+    };
+}
+export function createSaveTool(opts) {
+    const { fs, store, session, urlBuilder, allowOutPath = false, engineLock } = opts;
+    return {
+        name: 'save',
+        description: DESCRIPTION,
+        inputSchema: buildSaveInputSchema(allowOutPath),
+        call: async (rawArgs) => {
+            const args = (rawArgs ?? {});
+            if (typeof args.revision !== 'string') {
+                return {
+                    isError: true,
+                    content: [
+                        { type: 'text', text: 'save: `revision` is required.' }
+                    ]
+                };
+            }
+            if (args.outPath !== undefined && !allowOutPath) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'save: `outPath` is not supported on this (hosted) backend. Omit it — the archive is written to the workspace and returned as `httpUrl`; fetch that URL to download the `.zip` to disk.'
+                        }
+                    ]
+                };
+            }
+            const rev = await store.read(args.revision);
+            const revision = args.revision;
+            const sceneBytes = rev.scene;
+            // load-into-engine then archive reads the shared engine across awaits —
+            // serialize against any concurrent engine-touching tool call.
+            const bytes = await engineLock.runExclusive(async () => {
+                await session.populate(revision, sceneBytes);
+                const slot = await session.acquire(revision);
+                const eng = slot.engine;
+                // saveToArchive bundles only assets "accessible when called" — force
+                // every page's resources to finish loading first, else in-flight
+                // assets are silently dropped from the zip (see the handbook's "Font-load barrier: forceLoadResources" section).
+                await eng.block.forceLoadResources(eng.scene.getPages());
+                const blob = await eng.scene.saveToArchive();
+                return new Uint8Array(await blob.arrayBuffer());
+            });
+            const shard = revision.slice(0, 2);
+            const rest = revision.slice(2);
+            const relPath = `exports/${shard}/${rest}/archive.zip`;
+            let absPath;
+            let httpUrl;
+            if (args.outPath !== undefined) {
+                // Local-only escape hatch: write through real disk fs, NOT the
+                // workspace abstraction. The caller chose this path, so echoing it
+                // back is a confirmation, not a workspace-path leak.
+                await nodeFs.mkdir(dirname(args.outPath), { recursive: true });
+                await nodeFs.writeFile(args.outPath, bytes);
+                absPath = args.outPath;
+            }
+            else {
+                await fs.writeFile(relPath, bytes);
+                httpUrl = await urlBuilder.forDownload(relPath);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            uri: `workspace://${relPath}`,
+                            ...(httpUrl ? { httpUrl } : {}),
+                            ...(absPath ? { path: absPath } : {}),
+                            bytes: bytes.byteLength,
+                            format: 'archive',
+                            revision
+                        })
+                    }
+                ]
+            };
+        }
+    };
+}
+//# sourceMappingURL=save.js.map

package/dist/tools/save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../src/tools/save.ts"],"names":[],"mappings":"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","sourcesContent":["// packages/codesign-mcp/src/tools/save.ts\n//\n// `save` — emit a self-contained `.zip` archive of a revision (scene + all\n// asset bytes), via CE.SDK `scene.saveToArchive()`. Unlike the removed\n// `export target=scene`, this is an ENGINE operation: the scene is loaded into\n// the shared engine so saveToArchive can resolve `workspace://` asset URIs and\n// bundle the fetched bytes. Output lands at `exports/<shard>/<rev>/archive.zip`\n// and returns the same envelope shape as `export`.\nimport { promises as nodeFs } from 'node:fs';\nimport { dirname } from 'node:path';\nimport type { Mutex } from '../engine/mutex.js';\nimport type { EngineSession } from '../engine/session.js';\nimport type { RevisionStore } from '../revisions/store.js';\nimport type { CodesignMcpToolRegistration } from '../server.js';\nimport type { ViewerUrlBuilder } from '../viewer/url-builder.js';\nimport type { WorkspaceFS } from '../workspace/types.js';\n\ninterface MinimalArchiveEngine {\n  scene: {\n    getPages(): number[];\n    saveToArchive(): Promise<Blob>;\n  };\n  block: {\n    forceLoadResources(ids: number[]): Promise<void>;\n  };\n}\n\ninterface SaveArgs {\n  revision: string;\n  outPath?: string;\n}\n\nconst DESCRIPTION = [\n  'Save a revision as a portable, self-contained `.zip` archive (scene + all asset bytes bundled). Written into the workspace at `exports/<shard>/<rev>/archive.zip`.',\n  '',\n  'You do NOT need this to persist your work — every `edit` auto-persists to the workspace. Use `save` only to take an editable copy of the design OUT (hand to a human, back it up, move it between servers).',\n  '',\n  'Returns JSON `{ uri, httpUrl?, path?, bytes, format, revision }`. `uri` (a `workspace://` URI) is the durable handle. `httpUrl` is a fetch link tied to this process. `path` (absolute disk path) is returned ONLY when you passed `outPath`.'\n].join('\\n');\n\n// The schema is built per-backend: `outPath` is advertised ONLY when the\n// backend honours it (Local). On Hosted the property is omitted entirely, so\n// an agent never sees an affordance it can't use — it can't try a local path\n// and hit a runtime rejection. The runtime guard in `call` stays as a backstop.\nfunction buildSaveInputSchema(allowOutPath: boolean) {\n  const properties: Record<string, unknown> = {\n    revision: { type: 'string' as const }\n  };\n  if (allowOutPath) {\n    properties.outPath = {\n      type: 'string' as const,\n      description: 'Local-only escape hatch; absolute path.'\n    };\n  }\n  return {\n    type: 'object' as const,\n    properties,\n    required: ['revision'],\n    additionalProperties: false\n  };\n}\n\nexport interface CreateSaveToolOptions<E = unknown> {\n  fs: WorkspaceFS;\n  store: RevisionStore;\n  session: EngineSession<E>;\n  /** Builds the `httpUrl` for workspace-written artifacts (the `/r/` route). */\n  urlBuilder: ViewerUrlBuilder;\n  /** Whether to honour an `outPath` argument (Local: yes; Hosted/sandbox: no). */\n  allowOutPath?: boolean;\n  /** Guards the shared engine — load-then-archive must not interleave with another session's edit. */\n  engineLock: Mutex;\n}\n\nexport function createSaveTool<E = unknown>(\n  opts: CreateSaveToolOptions<E>\n): CodesignMcpToolRegistration {\n  const {\n    fs,\n    store,\n    session,\n    urlBuilder,\n    allowOutPath = false,\n    engineLock\n  } = opts;\n  return {\n    name: 'save',\n    description: DESCRIPTION,\n    inputSchema: buildSaveInputSchema(allowOutPath),\n    call: async (rawArgs) => {\n      const args = (rawArgs ?? {}) as Partial<SaveArgs>;\n      if (typeof args.revision !== 'string') {\n        return {\n          isError: true,\n          content: [\n            { type: 'text' as const, text: 'save: `revision` is required.' }\n          ]\n        };\n      }\n      if (args.outPath !== undefined && !allowOutPath) {\n        return {\n          isError: true,\n          content: [\n            {\n              type: 'text' as const,\n              text: 'save: `outPath` is not supported on this (hosted) backend. Omit it — the archive is written to the workspace and returned as `httpUrl`; fetch that URL to download the `.zip` to disk.'\n            }\n          ]\n        };\n      }\n      const rev = await store.read(args.revision);\n      const revision = args.revision;\n      const sceneBytes = rev.scene;\n      // load-into-engine then archive reads the shared engine across awaits —\n      // serialize against any concurrent engine-touching tool call.\n      const bytes = await engineLock.runExclusive(async () => {\n        await session.populate(revision, sceneBytes);\n        const slot = await session.acquire(revision);\n        const eng = slot.engine as MinimalArchiveEngine;\n        // saveToArchive bundles only assets \"accessible when called\" — force\n        // every page's resources to finish loading first, else in-flight\n        // assets are silently dropped from the zip (see the handbook's \"Font-load barrier: forceLoadResources\" section).\n        await eng.block.forceLoadResources(eng.scene.getPages());\n        const blob = await eng.scene.saveToArchive();\n        return new Uint8Array(await blob.arrayBuffer());\n      });\n      const shard = revision.slice(0, 2);\n      const rest = revision.slice(2);\n      const relPath = `exports/${shard}/${rest}/archive.zip`;\n      let absPath: string | undefined;\n      let httpUrl: string | undefined;\n      if (args.outPath !== undefined) {\n        // Local-only escape hatch: write through real disk fs, NOT the\n        // workspace abstraction. The caller chose this path, so echoing it\n        // back is a confirmation, not a workspace-path leak.\n        await nodeFs.mkdir(dirname(args.outPath), { recursive: true });\n        await nodeFs.writeFile(args.outPath, bytes);\n        absPath = args.outPath;\n      } else {\n        await fs.writeFile(relPath, bytes);\n        httpUrl = await urlBuilder.forDownload(relPath);\n      }\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: JSON.stringify({\n              uri: `workspace://${relPath}`,\n              ...(httpUrl ? { httpUrl } : {}),\n              ...(absPath ? { path: absPath } : {}),\n              bytes: bytes.byteLength,\n              format: 'archive',\n              revision\n            })\n          }\n        ]\n      };\n    }\n  };\n}\n"]}

package/dist/viewer/broadcaster.d.ts

@@ -0,0 +1,13 @@
+import type { Response } from 'express';
+export interface RevisionEvent {
+    revision: string;
+    rootRevision: string;
+}
+export declare class SseBroadcaster {
+    private readonly subs;
+    subscribe(rootRevision: string, res: Response): void;
+    broadcast(event: RevisionEvent): void;
+    subscriberCount(rootRevision: string): number;
+    closeAll(): void;
+}
+//# sourceMappingURL=broadcaster.d.ts.map

package/dist/viewer/broadcaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcaster.d.ts","sourceRoot":"","sources":["../../src/viewer/broadcaster.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IAEzD,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI;IAoBpD,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAOrC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAI7C,QAAQ,IAAI,IAAI;CAMjB"}

package/dist/viewer/broadcaster.js

@@ -0,0 +1,44 @@
+export class SseBroadcaster {
+    constructor() {
+        this.subs = new Map();
+    }
+    subscribe(rootRevision, res) {
+        res.writeHead(200, {
+            'content-type': 'text/event-stream',
+            'cache-control': 'no-cache',
+            connection: 'keep-alive'
+        });
+        // Initial comment so the client knows the stream is open.
+        res.write(': codesign-mcp viewer\n\n');
+        let set = this.subs.get(rootRevision);
+        if (!set) {
+            set = new Set();
+            this.subs.set(rootRevision, set);
+        }
+        set.add(res);
+        res.on('close', () => {
+            set?.delete(res);
+            if (set && set.size === 0)
+                this.subs.delete(rootRevision);
+        });
+    }
+    broadcast(event) {
+        const set = this.subs.get(event.rootRevision);
+        if (!set)
+            return;
+        const payload = `data: ${JSON.stringify(event)}\n\n`;
+        for (const res of set)
+            res.write(payload);
+    }
+    subscriberCount(rootRevision) {
+        return this.subs.get(rootRevision)?.size ?? 0;
+    }
+    closeAll() {
+        for (const set of this.subs.values()) {
+            for (const res of set)
+                res.end();
+        }
+        this.subs.clear();
+    }
+}
+//# sourceMappingURL=broadcaster.js.map

package/dist/viewer/broadcaster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcaster.js","sourceRoot":"","sources":["../../src/viewer/broadcaster.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,cAAc;IAA3B;QACmB,SAAI,GAAG,IAAI,GAAG,EAAyB,CAAC;IAuC3D,CAAC;IArCC,SAAS,CAAC,YAAoB,EAAE,GAAa;QAC3C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;QACH,0DAA0D;QAC1D,GAAG,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACvC,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACb,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,KAAoB;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;QACrD,KAAK,MAAM,GAAG,IAAI,GAAG;YAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,eAAe,CAAC,YAAoB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,QAAQ;QACN,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,KAAK,MAAM,GAAG,IAAI,GAAG;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF","sourcesContent":["//\n// Per-root SSE fan-out. Keeps `Map<rootRev, Set<Response>>`; broadcasts a\n// JSON-serialised event to every subscriber. Removes subscribers on connection\n// close.\n//\n// The `Response` shape used here is a structural subset of `express.Response`\n// (writeHead, write, end, on('close', cb)) so tests can pass a stub.\nimport type { Response } from 'express';\n\nexport interface RevisionEvent {\n  revision: string;\n  rootRevision: string;\n}\n\nexport class SseBroadcaster {\n  private readonly subs = new Map<string, Set<Response>>();\n\n  subscribe(rootRevision: string, res: Response): void {\n    res.writeHead(200, {\n      'content-type': 'text/event-stream',\n      'cache-control': 'no-cache',\n      connection: 'keep-alive'\n    });\n    // Initial comment so the client knows the stream is open.\n    res.write(': codesign-mcp viewer\\n\\n');\n    let set = this.subs.get(rootRevision);\n    if (!set) {\n      set = new Set();\n      this.subs.set(rootRevision, set);\n    }\n    set.add(res);\n    res.on('close', () => {\n      set?.delete(res);\n      if (set && set.size === 0) this.subs.delete(rootRevision);\n    });\n  }\n\n  broadcast(event: RevisionEvent): void {\n    const set = this.subs.get(event.rootRevision);\n    if (!set) return;\n    const payload = `data: ${JSON.stringify(event)}\\n\\n`;\n    for (const res of set) res.write(payload);\n  }\n\n  subscriberCount(rootRevision: string): number {\n    return this.subs.get(rootRevision)?.size ?? 0;\n  }\n\n  closeAll(): void {\n    for (const set of this.subs.values()) {\n      for (const res of set) res.end();\n    }\n    this.subs.clear();\n  }\n}\n"]}

package/dist/viewer/index.d.ts

@@ -0,0 +1,7 @@
+export { type RevisionEvent, SseBroadcaster } from './broadcaster.js';
+export { type StartViewerListenerOptions, startViewerListener, type ViewerListener } from './listener.js';
+export { type CreateViewerRouterOptions, createViewerRouter } from './router.js';
+export { type MountSessionViewerOptions, mountSessionViewer } from './session-mount.js';
+export { SPA_ASSETS } from './spa-assets.generated.js';
+export { type LocalUrlBuilderOptions, LocalViewerUrlBuilder, viewerBaseFor, type ViewerBaseOptions, type ViewerUrlBuilder } from './url-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/viewer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/viewer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EACL,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,yBAAyB,EAC9B,kBAAkB,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,yBAAyB,EAC9B,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EACL,KAAK,sBAAsB,EAC3B,qBAAqB,EACrB,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAC"}

package/dist/viewer/index.js

@@ -0,0 +1,7 @@
+export { SseBroadcaster } from './broadcaster.js';
+export { startViewerListener } from './listener.js';
+export { createViewerRouter } from './router.js';
+export { mountSessionViewer } from './session-mount.js';
+export { SPA_ASSETS } from './spa-assets.generated.js';
+export { LocalViewerUrlBuilder, viewerBaseFor } from './url-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/viewer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/viewer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAEL,mBAAmB,EAEpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,kBAAkB,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAEL,qBAAqB,EACrB,aAAa,EAGd,MAAM,kBAAkB,CAAC","sourcesContent":["export { type RevisionEvent, SseBroadcaster } from './broadcaster.js';\nexport {\n  type StartViewerListenerOptions,\n  startViewerListener,\n  type ViewerListener\n} from './listener.js';\nexport {\n  type CreateViewerRouterOptions,\n  createViewerRouter\n} from './router.js';\nexport {\n  type MountSessionViewerOptions,\n  mountSessionViewer\n} from './session-mount.js';\nexport { SPA_ASSETS } from './spa-assets.generated.js';\nexport {\n  type LocalUrlBuilderOptions,\n  LocalViewerUrlBuilder,\n  viewerBaseFor,\n  type ViewerBaseOptions,\n  type ViewerUrlBuilder\n} from './url-builder.js';\n"]}