@imgly/codesign-mcp 0.1.5 → 0.1.7

package/dist/tools/preview.d.ts

@@ -2,11 +2,14 @@ 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 TelemetrySink } from './spans.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;
+    /** Diagnostics telemetry port. Absent → no-op (no timing overhead beyond a few clocks). */
+    telemetry?: TelemetrySink;
 }
 export declare function createPreviewTool<E = unknown>(opts: CreatePreviewToolOptions<E>): CodesignMcpToolRegistration;
 //# sourceMappingURL=preview.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/tools/preview.ts"],"names":[],"mappings":"AAQA,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;AAChE,OAAO,EAKL,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AA6CpB,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;IAClB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAUD,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAC3C,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAChC,2BAA2B,CAsG7B"}

package/dist/tools/preview.js

@@ -4,6 +4,8 @@
 // (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).
+import { performance } from 'node:perf_hooks';
+import { SpanRecorder, NOOP_TELEMETRY_SINK, summarizeResult, toErrorShape } from './spans.js';
 const MAX_DIMENSION_PX = 1800;
 const DEFAULT_TARGET_WIDTH = 512;
 const DESCRIPTION = [
@@ -40,64 +42,97 @@ function bytesToBase64(bytes) {
 }
 export function createPreviewTool(opts) {
     const { store, session, engineLock } = opts;
+    const telemetry = opts.telemetry ?? NOOP_TELEMETRY_SINK;
     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) {
+            const rec = new SpanRecorder();
+            const startedAt = performance.now();
+            let result;
+            let threw;
+            let revision;
+            try {
+                result = await (async () => {
+                    const args = (rawArgs ?? {});
+                    if (typeof args.blockId !== 'number') {
                         return {
                             isError: true,
                             content: [
                                 {
                                     type: 'text',
-                                    text: 'preview: no engine state to render. Run `edit` first, or pass `revision` to load a specific revision.'
+                                    text: 'preview: `blockId` (integer) is required.'
                                 }
                             ]
                         };
                     }
-                    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 }
-                    ]
-                };
-            });
+                    // Load (if a revision was given) and export read the shared engine across
+                    // awaits — serialize against any concurrent engine-touching tool call.
+                    const beforeLock = performance.now();
+                    return engineLock.runExclusive(async () => {
+                        rec.add('lock_wait', performance.now() - beforeLock);
+                        let slot;
+                        if (args.revision !== undefined) {
+                            const revId = args.revision;
+                            revision = revId;
+                            const rev = await rec.time('workspace_read', () => store.read(revId));
+                            slot = await rec.time('engine_scene_load', async () => {
+                                await session.populate(revId, rev.scene);
+                                return session.acquire(revId);
+                            });
+                        }
+                        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 rec.time('engine_execute', () => eng.block.export(args.blockId, mimeType, exportOpts));
+                        const bytes = new Uint8Array(await blob.arrayBuffer());
+                        return {
+                            content: [
+                                { type: 'image', data: bytesToBase64(bytes), mimeType }
+                            ]
+                        };
+                    });
+                })();
+                return result;
+            }
+            catch (err) {
+                threw = err;
+                throw err;
+            }
+            finally {
+                telemetry.record({
+                    tool: 'preview',
+                    succeeded: threw === undefined && result?.isError !== true,
+                    totalMs: performance.now() - startedAt,
+                    spans: rec.list(),
+                    args: rawArgs,
+                    ...(result !== undefined ? { result: summarizeResult(result) } : {}),
+                    ...(revision ? { revision } : {}),
+                    ...(threw ? { error: toErrorShape(threw) } : {})
+                });
+            }
         }
     };
 }

package/dist/tools/preview.js.map

@@ -1 +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"]}
+{"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 { performance } from 'node:perf_hooks';\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';\nimport {\n  SpanRecorder,\n  NOOP_TELEMETRY_SINK,\n  summarizeResult,\n  toErrorShape,\n  type TelemetrySink\n} from './spans.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  /** Diagnostics telemetry port. Absent → no-op (no timing overhead beyond a few clocks). */\n  telemetry?: TelemetrySink;\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  const telemetry = opts.telemetry ?? NOOP_TELEMETRY_SINK;\n  return {\n    name: 'preview',\n    description: DESCRIPTION,\n    inputSchema: PREVIEW_INPUT_SCHEMA,\n    call: async (rawArgs) => {\n      const rec = new SpanRecorder();\n      const startedAt = performance.now();\n      type CallResult = Awaited<\n        ReturnType<CodesignMcpToolRegistration['call']>\n      >;\n      let result: CallResult | undefined;\n      let threw: unknown;\n      let revision: string | undefined;\n      try {\n        result = await (async (): Promise<CallResult> => {\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          const beforeLock = performance.now();\n          return engineLock.runExclusive(async () => {\n            rec.add('lock_wait', performance.now() - beforeLock);\n            let slot: EngineSlot<E>;\n            if (args.revision !== undefined) {\n              const revId = args.revision;\n              revision = revId;\n              const rev = await rec.time('workspace_read', () =>\n                store.read(revId)\n              );\n              slot = await rec.time('engine_scene_load', async () => {\n                await session.populate(revId, rev.scene);\n                return session.acquire(revId);\n              });\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 rec.time('engine_execute', () =>\n              eng.block.export(args.blockId, mimeType, exportOpts)\n            );\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        return result;\n      } catch (err) {\n        threw = err;\n        throw err;\n      } finally {\n        telemetry.record({\n          tool: 'preview',\n          succeeded: threw === undefined && result?.isError !== true,\n          totalMs: performance.now() - startedAt,\n          spans: rec.list(),\n          args: rawArgs,\n          ...(result !== undefined ? { result: summarizeResult(result) } : {}),\n          ...(revision ? { revision } : {}),\n          ...(threw ? { error: toErrorShape(threw) } : {})\n        });\n      }\n    }\n  };\n}\n"]}

package/dist/tools/result.d.ts

@@ -1,6 +1,6 @@
 import type { ImageContent, TextContent } from './content-types.js';
 /**
- * The strict return contract for `design_exec`.
+ * The strict return contract for `edit`.
  *
  * The function body must return undefined, a single MessagePart, or an array
  * of MessageParts. Anything else throws an educational error so the LLM

package/dist/tools/result.js

@@ -47,9 +47,9 @@ function inspect(value) {
     return typeof value;
 }
 function badShape(value) {
-    return new Error(`design_exec must return undefined, a MessagePart, or MessagePart[]. Got: ${inspect(value)}. ` +
+    return new Error(`edit 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.`);
+        `prefer the preview tool — it renders + encodes for you.`);
 }
 //# sourceMappingURL=result.js.map

package/dist/tools/result.js.map

@@ -1 +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"]}
+{"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,qEAAqE,OAAO,CAAC,KAAK,CAAC,IAAI;QACrF,iFAAiF;QACjF,uFAAuF;QACvF,yDAAyD,CAC5D,CAAC;AACJ,CAAC","sourcesContent":["import type { ImageContent, TextContent } from './content-types.js';\n\n/**\n * The strict return contract for `edit`.\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    `edit 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 preview tool — it renders + encodes for you.`\n  );\n}\n"]}

package/dist/tools/spans.d.ts

@@ -0,0 +1,45 @@
+export interface Span {
+    phase: string;
+    ms: number;
+}
+export declare class SpanRecorder {
+    private readonly spans;
+    /** Time an async phase; records its wall-time as a Span even if it throws. */
+    time<T>(phase: string, fn: () => Promise<T>): Promise<T>;
+    /** Record a pre-measured phase (e.g. lock-wait computed by the caller). */
+    add(phase: string, ms: number): void;
+    list(): Span[];
+}
+export interface ToolCallReport {
+    tool: string;
+    succeeded: boolean;
+    totalMs: number;
+    spans: Span[];
+    error?: {
+        message: string;
+        stack?: string;
+    };
+    args?: unknown;
+    /** The tool's return value, summarized (large base64 blobs dropped). */
+    result?: unknown;
+    revision?: string;
+    session?: string;
+}
+export interface TelemetrySink {
+    record(report: ToolCallReport): void;
+}
+/** The off-switch: injected when diagnostics is disabled. */
+export declare const NOOP_TELEMETRY_SINK: TelemetrySink;
+export declare function toErrorShape(err: unknown): {
+    message: string;
+    stack?: string;
+};
+/**
+ * Shrink a tool result for the diagnostics log: keep the shape (content parts,
+ * text, mime types, isError). Small text (URLs, JSON summaries) passes through.
+ * Image payloads are kept up to MAX_INLINE_IMAGE_CHARS so the viewer can render
+ * them; any other large inline base64 blob is dropped to a length marker so it
+ * doesn't bloat every log line. Non-result shapes are returned as-is.
+ */
+export declare function summarizeResult(result: unknown): unknown;
+//# sourceMappingURL=spans.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spans.d.ts","sourceRoot":"","sources":["../../src/tools/spans.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAEpC,8EAA8E;IACxE,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS9D,2EAA2E;IAC3E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAIpC,IAAI,IAAI,IAAI,EAAE;CAGf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CACtC;AAED,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,EAAE,aAA+B,CAAC;AAElE,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAOA;AAWD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAoBxD"}

package/dist/tools/spans.js

@@ -0,0 +1,77 @@
+// packages/codesign-mcp/src/tools/spans.ts
+//
+// The narrow, telemetry-agnostic port the design tools depend on. Tools time
+// their phases with a SpanRecorder and hand a ToolCallReport to an injected
+// TelemetrySink; they import NOTHING from src/diagnostics/, so they stay
+// extractable. The MCP side bridges TelemetrySink -> DiagnosticsSink (adapter).
+import { performance } from 'node:perf_hooks';
+export class SpanRecorder {
+    constructor() {
+        this.spans = [];
+    }
+    /** Time an async phase; records its wall-time as a Span even if it throws. */
+    async time(phase, fn) {
+        const start = performance.now();
+        try {
+            return await fn();
+        }
+        finally {
+            this.spans.push({ phase, ms: performance.now() - start });
+        }
+    }
+    /** Record a pre-measured phase (e.g. lock-wait computed by the caller). */
+    add(phase, ms) {
+        this.spans.push({ phase, ms });
+    }
+    list() {
+        return this.spans.slice();
+    }
+}
+/** The off-switch: injected when diagnostics is disabled. */
+export const NOOP_TELEMETRY_SINK = { record() { } };
+export function toErrorShape(err) {
+    if (err instanceof Error) {
+        return err.stack
+            ? { message: err.message, stack: err.stack }
+            : { message: err.message };
+    }
+    return { message: String(err) };
+}
+/** Non-image base64 `data` past this length is dropped from the report. */
+const MAX_INLINE_DATA_CHARS = 256;
+/**
+ * Image `data` is KEPT up to this length so the viewer can render a preview;
+ * beyond it (a huge export, a video frame) we drop the bytes. ~150 KB base64
+ * covers the `preview` tool's default 512-px renders comfortably.
+ */
+const MAX_INLINE_IMAGE_CHARS = 200_000;
+/**
+ * Shrink a tool result for the diagnostics log: keep the shape (content parts,
+ * text, mime types, isError). Small text (URLs, JSON summaries) passes through.
+ * Image payloads are kept up to MAX_INLINE_IMAGE_CHARS so the viewer can render
+ * them; any other large inline base64 blob is dropped to a length marker so it
+ * doesn't bloat every log line. Non-result shapes are returned as-is.
+ */
+export function summarizeResult(result) {
+    if (!result || typeof result !== 'object')
+        return result;
+    const r = result;
+    if (!Array.isArray(r.content))
+        return result;
+    const content = r.content.map((part) => {
+        if (part && typeof part === 'object') {
+            const p = part;
+            if (typeof p.data === 'string') {
+                const isImage = p.type === 'image' ||
+                    (typeof p.mimeType === 'string' && p.mimeType.startsWith('image/'));
+                const cap = isImage ? MAX_INLINE_IMAGE_CHARS : MAX_INLINE_DATA_CHARS;
+                if (p.data.length > cap) {
+                    return { ...p, data: `<${p.data.length} base64 chars omitted>` };
+                }
+            }
+        }
+        return part;
+    });
+    return { ...r, content };
+}
+//# sourceMappingURL=spans.js.map

package/dist/tools/spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.js","sourceRoot":"","sources":["../../src/tools/spans.ts"],"names":[],"mappings":"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","sourcesContent":["// packages/codesign-mcp/src/tools/spans.ts\n//\n// The narrow, telemetry-agnostic port the design tools depend on. Tools time\n// their phases with a SpanRecorder and hand a ToolCallReport to an injected\n// TelemetrySink; they import NOTHING from src/diagnostics/, so they stay\n// extractable. The MCP side bridges TelemetrySink -> DiagnosticsSink (adapter).\nimport { performance } from 'node:perf_hooks';\n\nexport interface Span {\n  phase: string;\n  ms: number;\n}\n\nexport class SpanRecorder {\n  private readonly spans: Span[] = [];\n\n  /** Time an async phase; records its wall-time as a Span even if it throws. */\n  async time<T>(phase: string, fn: () => Promise<T>): Promise<T> {\n    const start = performance.now();\n    try {\n      return await fn();\n    } finally {\n      this.spans.push({ phase, ms: performance.now() - start });\n    }\n  }\n\n  /** Record a pre-measured phase (e.g. lock-wait computed by the caller). */\n  add(phase: string, ms: number): void {\n    this.spans.push({ phase, ms });\n  }\n\n  list(): Span[] {\n    return this.spans.slice();\n  }\n}\n\nexport interface ToolCallReport {\n  tool: string;\n  succeeded: boolean;\n  totalMs: number;\n  spans: Span[];\n  error?: { message: string; stack?: string };\n  args?: unknown;\n  /** The tool's return value, summarized (large base64 blobs dropped). */\n  result?: unknown;\n  revision?: string;\n  session?: string;\n}\n\nexport interface TelemetrySink {\n  record(report: ToolCallReport): void;\n}\n\n/** The off-switch: injected when diagnostics is disabled. */\nexport const NOOP_TELEMETRY_SINK: TelemetrySink = { record() {} };\n\nexport function toErrorShape(err: unknown): {\n  message: string;\n  stack?: string;\n} {\n  if (err instanceof Error) {\n    return err.stack\n      ? { message: err.message, stack: err.stack }\n      : { message: err.message };\n  }\n  return { message: String(err) };\n}\n\n/** Non-image base64 `data` past this length is dropped from the report. */\nconst MAX_INLINE_DATA_CHARS = 256;\n/**\n * Image `data` is KEPT up to this length so the viewer can render a preview;\n * beyond it (a huge export, a video frame) we drop the bytes. ~150 KB base64\n * covers the `preview` tool's default 512-px renders comfortably.\n */\nconst MAX_INLINE_IMAGE_CHARS = 200_000;\n\n/**\n * Shrink a tool result for the diagnostics log: keep the shape (content parts,\n * text, mime types, isError). Small text (URLs, JSON summaries) passes through.\n * Image payloads are kept up to MAX_INLINE_IMAGE_CHARS so the viewer can render\n * them; any other large inline base64 blob is dropped to a length marker so it\n * doesn't bloat every log line. Non-result shapes are returned as-is.\n */\nexport function summarizeResult(result: unknown): unknown {\n  if (!result || typeof result !== 'object') return result;\n  const r = result as { content?: unknown };\n  if (!Array.isArray(r.content)) return result;\n  const content = r.content.map((part) => {\n    if (part && typeof part === 'object') {\n      const p = part as { type?: unknown; data?: unknown; mimeType?: unknown };\n      if (typeof p.data === 'string') {\n        const isImage =\n          p.type === 'image' ||\n          (typeof p.mimeType === 'string' && p.mimeType.startsWith('image/'));\n        const cap = isImage ? MAX_INLINE_IMAGE_CHARS : MAX_INLINE_DATA_CHARS;\n        if (p.data.length > cap) {\n          return { ...p, data: `<${p.data.length} base64 chars omitted>` };\n        }\n      }\n    }\n    return part;\n  });\n  return { ...r, content };\n}\n"]}

package/dist/tools/telemetry-wrapper.d.ts

@@ -0,0 +1,4 @@
+import type { CodesignMcpToolRegistration } from '../server.js';
+import { type TelemetrySink } from './spans.js';
+export declare function wrapWithTelemetry(registration: CodesignMcpToolRegistration, telemetry: TelemetrySink): CodesignMcpToolRegistration;
+//# sourceMappingURL=telemetry-wrapper.d.ts.map

package/dist/tools/telemetry-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-wrapper.d.ts","sourceRoot":"","sources":["../../src/tools/telemetry-wrapper.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAiC,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/E,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,2BAA2B,EACzC,SAAS,EAAE,aAAa,GACvB,2BAA2B,CA+B7B"}

package/dist/tools/telemetry-wrapper.js

@@ -0,0 +1,43 @@
+// packages/codesign-mcp/src/tools/telemetry-wrapper.ts
+//
+// Wraps a tool registration so EVERY call lands in the diagnostics stream —
+// even tools with no internal phase instrumentation. The engine tools
+// (edit/preview/export) self-report a richer ToolCallReport with phase spans;
+// this wrapper covers all the rest, giving a uniform "what ran, with what args,
+// returning what, how long, ok or not" record (with empty spans). It mirrors
+// the engine tools' own finally-block reporting so success/error/timing are
+// computed identically.
+import { performance } from 'node:perf_hooks';
+import { summarizeResult, toErrorShape } from './spans.js';
+export function wrapWithTelemetry(registration, telemetry) {
+    return {
+        ...registration,
+        call: async (rawArgs) => {
+            const startedAt = performance.now();
+            let result;
+            let threw;
+            try {
+                result = await registration.call(rawArgs);
+                return result;
+            }
+            catch (err) {
+                threw = err;
+                throw err;
+            }
+            finally {
+                telemetry.record({
+                    tool: registration.name,
+                    // A tool signals failure two ways: it throws, or it returns
+                    // { isError: true }. Both count as not-succeeded.
+                    succeeded: threw === undefined && result?.isError !== true,
+                    totalMs: performance.now() - startedAt,
+                    spans: [],
+                    args: rawArgs,
+                    ...(result !== undefined ? { result: summarizeResult(result) } : {}),
+                    ...(threw ? { error: toErrorShape(threw) } : {})
+                });
+            }
+        }
+    };
+}
+//# sourceMappingURL=telemetry-wrapper.js.map

package/dist/tools/telemetry-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-wrapper.js","sourceRoot":"","sources":["../../src/tools/telemetry-wrapper.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,4EAA4E;AAC5E,sEAAsE;AACtE,8EAA8E;AAC9E,gFAAgF;AAChF,6EAA6E;AAC7E,4EAA4E;AAC5E,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,YAAY,EAAsB,MAAM,YAAY,CAAC;AAE/E,MAAM,UAAU,iBAAiB,CAC/B,YAAyC,EACzC,SAAwB;IAExB,OAAO;QACL,GAAG,YAAY;QACf,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACtB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAIpC,IAAI,MAA8B,CAAC;YACnC,IAAI,KAAc,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC1C,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,KAAK,GAAG,GAAG,CAAC;gBACZ,MAAM,GAAG,CAAC;YACZ,CAAC;oBAAS,CAAC;gBACT,SAAS,CAAC,MAAM,CAAC;oBACf,IAAI,EAAE,YAAY,CAAC,IAAI;oBACvB,4DAA4D;oBAC5D,kDAAkD;oBAClD,SAAS,EAAE,KAAK,KAAK,SAAS,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI;oBAC1D,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS;oBACtC,KAAK,EAAE,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACjD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// packages/codesign-mcp/src/tools/telemetry-wrapper.ts\n//\n// Wraps a tool registration so EVERY call lands in the diagnostics stream —\n// even tools with no internal phase instrumentation. The engine tools\n// (edit/preview/export) self-report a richer ToolCallReport with phase spans;\n// this wrapper covers all the rest, giving a uniform \"what ran, with what args,\n// returning what, how long, ok or not\" record (with empty spans). It mirrors\n// the engine tools' own finally-block reporting so success/error/timing are\n// computed identically.\nimport { performance } from 'node:perf_hooks';\nimport type { CodesignMcpToolRegistration } from '../server.js';\nimport { summarizeResult, toErrorShape, type TelemetrySink } from './spans.js';\n\nexport function wrapWithTelemetry(\n  registration: CodesignMcpToolRegistration,\n  telemetry: TelemetrySink\n): CodesignMcpToolRegistration {\n  return {\n    ...registration,\n    call: async (rawArgs) => {\n      const startedAt = performance.now();\n      type CallResult = Awaited<\n        ReturnType<CodesignMcpToolRegistration['call']>\n      >;\n      let result: CallResult | undefined;\n      let threw: unknown;\n      try {\n        result = await registration.call(rawArgs);\n        return result;\n      } catch (err) {\n        threw = err;\n        throw err;\n      } finally {\n        telemetry.record({\n          tool: registration.name,\n          // A tool signals failure two ways: it throws, or it returns\n          // { isError: true }. Both count as not-succeeded.\n          succeeded: threw === undefined && result?.isError !== true,\n          totalMs: performance.now() - startedAt,\n          spans: [],\n          args: rawArgs,\n          ...(result !== undefined ? { result: summarizeResult(result) } : {}),\n          ...(threw ? { error: toErrorShape(threw) } : {})\n        });\n      }\n    }\n  };\n}\n"]}

package/dist/viewer/cesdk-cdn.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Build the cdn.img.ly URL for the `cesdk-js` browser bundle at `version`.
+ * Release/rc builds live at the plain path; nightlies live under
+ * `/nightlies/<version>/…` (version repeated). The channel is derivable from
+ * the version string alone. Single source of truth for the URL shape — used
+ * by the viewer config endpoint AND the bump preflight.
+ */
+export declare function cesdkCdnUrl(version: string): string;
+/**
+ * Read the exact version of the installed `@cesdk/node` (all three CE.SDK
+ * packages are pinned identical). As of 1.77 the package no longer exports
+ * `./package.json`, so resolve the main entry and read the sibling file
+ * directly — mirrors scripts/sync-cesdk-api.ts.
+ */
+export declare function installedCesdkVersion(): string;
+//# sourceMappingURL=cesdk-cdn.d.ts.map

package/dist/viewer/cesdk-cdn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cesdk-cdn.d.ts","sourceRoot":"","sources":["../../src/viewer/cesdk-cdn.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAQ9C"}

package/dist/viewer/cesdk-cdn.js

@@ -0,0 +1,30 @@
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+/**
+ * Build the cdn.img.ly URL for the `cesdk-js` browser bundle at `version`.
+ * Release/rc builds live at the plain path; nightlies live under
+ * `/nightlies/<version>/…` (version repeated). The channel is derivable from
+ * the version string alone. Single source of truth for the URL shape — used
+ * by the viewer config endpoint AND the bump preflight.
+ */
+export function cesdkCdnUrl(version) {
+    const pkgPath = `packages/imgly/cesdk-js/${version}/index.js`;
+    return version.includes('-nightly.')
+        ? `https://cdn.img.ly/nightlies/${version}/${pkgPath}`
+        : `https://cdn.img.ly/${pkgPath}`;
+}
+/**
+ * Read the exact version of the installed `@cesdk/node` (all three CE.SDK
+ * packages are pinned identical). As of 1.77 the package no longer exports
+ * `./package.json`, so resolve the main entry and read the sibling file
+ * directly — mirrors scripts/sync-cesdk-api.ts.
+ */
+export function installedCesdkVersion() {
+    const require = createRequire(import.meta.url);
+    const main = require.resolve('@cesdk/node');
+    const pkgJsonPath = path.join(path.dirname(main), 'package.json');
+    const { version } = JSON.parse(readFileSync(pkgJsonPath, 'utf8'));
+    return version;
+}
+//# sourceMappingURL=cesdk-cdn.js.map

package/dist/viewer/cesdk-cdn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cesdk-cdn.js","sourceRoot":"","sources":["../../src/viewer/cesdk-cdn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,OAAO,GAAG,2BAA2B,OAAO,WAAW,CAAC;IAC9D,OAAO,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAClC,CAAC,CAAC,gCAAgC,OAAO,IAAI,OAAO,EAAE;QACtD,CAAC,CAAC,sBAAsB,OAAO,EAAE,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC;IAClE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAE/D,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { readFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport path from 'node:path';\n\n/**\n * Build the cdn.img.ly URL for the `cesdk-js` browser bundle at `version`.\n * Release/rc builds live at the plain path; nightlies live under\n * `/nightlies/<version>/…` (version repeated). The channel is derivable from\n * the version string alone. Single source of truth for the URL shape — used\n * by the viewer config endpoint AND the bump preflight.\n */\nexport function cesdkCdnUrl(version: string): string {\n  const pkgPath = `packages/imgly/cesdk-js/${version}/index.js`;\n  return version.includes('-nightly.')\n    ? `https://cdn.img.ly/nightlies/${version}/${pkgPath}`\n    : `https://cdn.img.ly/${pkgPath}`;\n}\n\n/**\n * Read the exact version of the installed `@cesdk/node` (all three CE.SDK\n * packages are pinned identical). As of 1.77 the package no longer exports\n * `./package.json`, so resolve the main entry and read the sibling file\n * directly — mirrors scripts/sync-cesdk-api.ts.\n */\nexport function installedCesdkVersion(): string {\n  const require = createRequire(import.meta.url);\n  const main = require.resolve('@cesdk/node');\n  const pkgJsonPath = path.join(path.dirname(main), 'package.json');\n  const { version } = JSON.parse(readFileSync(pkgJsonPath, 'utf8')) as {\n    version: string;\n  };\n  return version;\n}\n"]}

package/dist/viewer/router.d.ts

@@ -15,6 +15,12 @@ export interface CreateViewerRouterOptions {
     cesdkLicense?: string;
     /** Absolute workspace root, forwarded to the `/r/` route for disk streaming. Empty on object-store backends. */
     workspaceRoot?: string;
+    /**
+     * Full cdn.img.ly URL the browser viewer imports the CE.SDK engine from.
+     * Defaults to the installed engine version so the preview can never drift
+     * from the node runtime. Overridable for tests.
+     */
+    cesdkEngineUrl?: string;
 }
 export declare function createViewerRouter(opts: CreateViewerRouterOptions): Router;
 //# sourceMappingURL=router.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/viewer/router.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,MAAM,EACP,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,aAAa,CAAC;IACrB,EAAE,EAAE,WAAW,CAAC;IAChB,WAAW,EAAE,cAAc,CAAC;IAC5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gHAAgH;IAChH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,CAgJ1E"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/viewer/router.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,MAAM,EACP,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,aAAa,CAAC;IACrB,EAAE,EAAE,WAAW,CAAC;IAChB,WAAW,EAAE,cAAc,CAAC;IAC5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gHAAgH;IAChH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,CAmJ1E"}

package/dist/viewer/router.js

@@ -6,9 +6,11 @@
 import { Router } from 'express';
 import { createResourceRoute } from './resource-route.js';
 import { SPA_ASSETS } from './spa-assets.generated.js';
+import { cesdkCdnUrl, installedCesdkVersion } from './cesdk-cdn.js';
 export function createViewerRouter(opts) {
     const { store, fs, broadcaster } = opts;
     const router = Router();
+    const cesdkEngineUrl = opts.cesdkEngineUrl ?? cesdkCdnUrl(installedCesdkVersion());
     // The SPA is mounted at root on the stdio listener (req.baseUrl === "") and
     // under "/viewer" on the HTTP transport (req.baseUrl === "/viewer"). Its
     // HTML/JS address assets and API routes by path, so we inject the live mount
@@ -22,7 +24,8 @@ export function createViewerRouter(opts) {
         // URIs. `req.baseUrl` is "" on the stdio listener, "/viewer" on HTTP.
         res.json({
             license: opts.cesdkLicense ?? '',
-            resourceBase: `${req.baseUrl}/r/`
+            resourceBase: `${req.baseUrl}/r/`,
+            cesdkEngineUrl
         });
     });
     router.use(createResourceRoute({ fs, workspaceRoot: opts.workspaceRoot ?? '' }));