@imgly/codesign-mcp 0.1.0 → 0.1.2

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport {\n  CallToolRequestSchema,\n  ErrorCode,\n  GetPromptRequestSchema,\n  ListPromptsRequestSchema,\n  ListResourcesRequestSchema,\n  ListToolsRequestSchema,\n  McpError,\n  ReadResourceRequestSchema\n} from '@modelcontextprotocol/sdk/types.js';\nimport { rewriteSkillLinks } from './cross-ref.js';\nimport { parseFrontmatter } from './frontmatter.js';\nimport { buildSkillReadTools } from './skill-tools.js';\nimport { performance } from 'node:perf_hooks';\nimport type { MetricsRecorder } from './metrics/recorder.js';\n\n/**\n * One tool the server exposes via tools/list + tools/call. Caller-supplied so\n * the engine-bound implementations live near the surface that owns the engine\n * (the demo passes its existing `createDesignTools` output adapted to this\n * shape; an external bootstrap could pass server-side equivalents).\n */\nexport interface CodesignMcpToolRegistration {\n  name: string;\n  description?: string;\n  /** JSON Schema describing the tool's input arguments. */\n  inputSchema: unknown;\n  call: (args: unknown) => Promise<{\n    content: Array<\n      | { type: 'text'; text: string }\n      | { type: 'image'; data: string; mimeType: string }\n    >;\n    isError?: boolean;\n  }>;\n}\n\nexport interface CodesignMcpServerOptions {\n  /** CreativeEngine instance, DI'd by caller. Pass-through to design tools. */\n  engine: unknown;\n  /**\n   * Asset bundle. Keys are forward-slash paths under one of:\n   *   \"docs/<doc>/SKILL.md\"          — entry point for handbook / api / guide\n   *   \"docs/<doc>/<file>\"            — sub-files reachable via the doc tools\n   *   \"prompts/<name>.md\"            — slash-command prompts\n   * Values are file contents.\n   */\n  assets: Record<string, string>;\n  /** URI scheme for resources. Default: \"codesign\". */\n  resourceScheme?: string;\n  /** Tools to expose via tools/list + tools/call. */\n  tools?: CodesignMcpToolRegistration[];\n  /** Optional metrics sink. Absent → tool calls are not timed (no-op). */\n  metrics?: MetricsRecorder;\n  /**\n   * Build identity reported as `serverInfo.version` on `initialize`. A client\n   * (the deploy smoketest) can assert it to confirm it's talking to the\n   * just-deployed build, not a stale container. Default `'dev'`.\n   */\n  buildId?: string;\n}\n\nconst DOC_FILE = /^docs\\/([^/]+)\\/(.+)$/;\nconst PROMPT_FILE = /^prompts\\/([^/]+)\\.md$/;\n\nexport function createCodesignMcpServer(\n  opts: CodesignMcpServerOptions\n): Server {\n  const scheme = opts.resourceScheme ?? 'codesign';\n  const assets = opts.assets;\n\n  // `instructions` is intentionally short — it tells the model what the\n  // server is and STRONGLY directs it to call `codesign_read_codesign_system`\n  // before its first design_exec. Skills are now first-class tools (not MCP\n  // resources buried in an XML block), so discovery happens via tools/list\n  // on every host without needing ReadMcpResourceTool support.\n  //\n  // Why short: Claude Code wraps MCP `instructions` in a <system-reminder>\n  // and truncates long ones mid-stream. Keeping `instructions` under ~1.5 KB\n  // ensures the whole pointer survives any sane truncation.\n  //\n  // The asset-generation hint is included only when an `asset_generate` tool\n  // is actually registered (Local hides it without an API_KEY), so we never\n  // advertise a tool the model can't see in tools/list.\n  const hasAssetGenerate = (opts.tools ?? []).some(\n    (t) => t.name === 'asset_generate'\n  );\n  const instructions = [\n    'This is the **codesign** MCP server. It hosts a CE.SDK CreativeEngine and a persistent design workspace (revision DAG) for vector design + print-quality PDF output.',\n    '',\n    '**Required first step** — before any `edit`, call `handbook` (no args). It teaches the mandatory `parent` argument, dirty-on-throw safety, rewind recovery via `list`/`history`, the typeface schema setFont requires, and the runtime quirks that bite first attempts. Skipping it produces broken output.',\n    '',\n    'Reference docs, on demand:',\n    '- `api({ path?, offset?, limit? })` — CE.SDK TypeScript signatures.',\n    '- `guide({ path? })` — CE.SDK Vanilla JS reference docs / topic guides.',\n    '',\n    'Design tools (after reading the handbook):',\n    '- `edit({ parent, code, title?, note? })` — mutate the canvas; `parent` is REQUIRED (revision id, or null for a new design).',\n    '- `preview({ blockId, revision? })` — render a block to an inline image.',\n    '- `export({ target, format, revision, blockId })` — render a block to pdf/image and write it into the workspace.',\n    '- `save({ revision, outPath? })` — write a self-contained `.zip` archive (scene + assets) of a revision into the workspace.',\n    '',\n    'Workspace tools (for resuming + navigating across designs):',\n    '- `list()` — every design in the workspace, newest first.',\n    '- `history({ revision })` — walk back to the root; how you re-ground after a rewind.',\n    '- `inspect({ revision })` — read one revision in full, including the code that produced it (patterns, not block ids).',\n    '- `rename({ revision, title })` — rename a design.',\n    '- `open_editor({ revision? })` — URL the human can open to view the design.',\n    '- `asset_search({ sourceId?, query? })` — browse asset sources; apply results in `edit`.'\n  ]\n    .concat(\n      hasAssetGenerate\n        ? [\n            '',\n            'Asset generation:',\n            \"- `asset_generate({ kind: 'image', prompt, width?, height? })` — opt-in (Local needs API_KEY); Hosted is cost-gated.\"\n          ]\n        : []\n    )\n    .join('\\n');\n\n  // Build the resource map up-front: URI → rewritten markdown body. Cross-refs\n  // inside doc content are rewritten to absolute MCP URIs so the model never\n  // has to resolve a relative path against a doc dir.\n  const rewrittenContent = new Map<string, string>();\n  for (const [key, content] of Object.entries(assets)) {\n    const m = key.match(DOC_FILE);\n    if (!m) continue;\n    const [, doc, rest] = m;\n    const uri = `${scheme}://docs/${doc}/${rest}`;\n    rewrittenContent.set(uri, rewriteSkillLinks(content, doc, scheme));\n  }\n\n  // Index prompts by name (frontmatter `name`, falling back to filename).\n  const prompts = new Map<string, { description: string; body: string }>();\n  for (const [key, content] of Object.entries(assets)) {\n    const m = key.match(PROMPT_FILE);\n    if (!m) continue;\n    const front = parseFrontmatter(content);\n    const name = front.name ?? m[1];\n    prompts.set(name, {\n      description: front.description ?? '',\n      body: front.body\n    });\n  }\n\n  const server = new Server(\n    { name: 'codesign', version: opts.buildId ?? 'dev' },\n    {\n      capabilities: { resources: {}, prompts: {}, tools: {} },\n      instructions\n    }\n  );\n\n  // `resources/list` advertises only the per-skill SKILL.md (the entry\n  // point), not the 392 nested cesdk-guide files. Sub-files stay readable\n  // via `resources/read` against any cached URI, but skill content discovery\n  // happens through the codesign_read_* tools — those are the universal\n  // surface across MCP hosts.\n  server.setRequestHandler(ListResourcesRequestSchema, async () => ({\n    resources: Array.from(rewrittenContent.keys())\n      .filter((uri) => uri.endsWith('/SKILL.md'))\n      .map((uri) => ({\n        uri,\n        mimeType: 'text/markdown',\n        name: uri.replace(`${scheme}://`, '')\n      }))\n  }));\n\n  server.setRequestHandler(ReadResourceRequestSchema, async (req) => {\n    const text = rewrittenContent.get(req.params.uri);\n    if (text === undefined) {\n      throw new McpError(\n        ErrorCode.InvalidParams,\n        `Unknown resource: ${req.params.uri}`\n      );\n    }\n    return {\n      contents: [{ uri: req.params.uri, mimeType: 'text/markdown', text }]\n    };\n  });\n\n  server.setRequestHandler(ListPromptsRequestSchema, async () => ({\n    prompts: Array.from(prompts.entries()).map(([name, p]) => ({\n      name,\n      description: p.description\n    }))\n  }));\n\n  server.setRequestHandler(GetPromptRequestSchema, async (req) => {\n    const p = prompts.get(req.params.name);\n    if (!p) {\n      throw new McpError(\n        ErrorCode.InvalidParams,\n        `Unknown prompt: ${req.params.name}`\n      );\n    }\n    return {\n      messages: [\n        {\n          role: 'user',\n          content: { type: 'text', text: p.body }\n        }\n      ]\n    };\n  });\n\n  // Tools registered with the server: caller-supplied design tools + the\n  // auto-generated skill-read tools (one per skill in the asset bundle).\n  // The skill tools always come first so Level 1 wording in the design tool\n  // descriptions (\"call codesign_read_codesign_system first\") points at\n  // something the model already sees in tools/list.\n  const tools = new Map<string, CodesignMcpToolRegistration>();\n  for (const t of buildSkillReadTools(assets)) tools.set(t.name, t);\n  for (const t of opts.tools ?? []) tools.set(t.name, t);\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: Array.from(tools.values()).map((t) => ({\n      name: t.name,\n      description: t.description,\n      inputSchema: t.inputSchema as never\n    }))\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (req) => {\n    const t = tools.get(req.params.name);\n    if (!t) {\n      throw new McpError(\n        ErrorCode.InvalidParams,\n        `Unknown tool: ${req.params.name}`\n      );\n    }\n    // No recorder → byte-for-byte the original behaviour (the off-switch).\n    if (!opts.metrics) return await t.call(req.params.arguments ?? {});\n\n    const startedAt = performance.now();\n    let ok = true;\n    try {\n      const res = await t.call(req.params.arguments ?? {});\n      ok = res.isError !== true;\n      return res;\n    } catch (err) {\n      ok = false;\n      throw err;\n    } finally {\n      opts.metrics.record({\n        tool: req.params.name,\n        durationMs: performance.now() - startedAt,\n        ok\n      });\n    }\n  });\n\n  return server;\n}\n"]}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport {\n  CallToolRequestSchema,\n  ErrorCode,\n  GetPromptRequestSchema,\n  ListPromptsRequestSchema,\n  ListResourcesRequestSchema,\n  ListToolsRequestSchema,\n  McpError,\n  ReadResourceRequestSchema\n} from '@modelcontextprotocol/sdk/types.js';\nimport { rewriteSkillLinks } from './cross-ref.js';\nimport { parseFrontmatter } from './frontmatter.js';\nimport { buildSkillReadTools } from './skill-tools.js';\nimport { performance } from 'node:perf_hooks';\nimport type { MetricsRecorder } from './metrics/recorder.js';\n\n/**\n * One tool the server exposes via tools/list + tools/call. Caller-supplied so\n * the engine-bound implementations live near the surface that owns the engine\n * (the demo passes its existing `createDesignTools` output adapted to this\n * shape; an external bootstrap could pass server-side equivalents).\n */\nexport interface CodesignMcpToolRegistration {\n  name: string;\n  description?: string;\n  /** JSON Schema describing the tool's input arguments. */\n  inputSchema: unknown;\n  call: (args: unknown) => Promise<{\n    content: Array<\n      | { type: 'text'; text: string }\n      | { type: 'image'; data: string; mimeType: string }\n    >;\n    isError?: boolean;\n  }>;\n}\n\nexport interface CodesignMcpServerOptions {\n  /**\n   * Asset bundle. Keys are forward-slash paths under one of:\n   *   \"docs/<doc>/SKILL.md\"          — entry point for handbook / api / guide\n   *   \"docs/<doc>/<file>\"            — sub-files reachable via the doc tools\n   *   \"prompts/<name>.md\"            — slash-command prompts\n   * Values are file contents.\n   */\n  assets: Record<string, string>;\n  /** URI scheme for resources. Default: \"codesign\". */\n  resourceScheme?: string;\n  /** Tools to expose via tools/list + tools/call. */\n  tools?: CodesignMcpToolRegistration[];\n  /** Optional metrics sink. Absent → tool calls are not timed (no-op). */\n  metrics?: MetricsRecorder;\n  /**\n   * Build identity reported as `serverInfo.version` on `initialize`. A client\n   * (the deploy smoketest) can assert it to confirm it's talking to the\n   * just-deployed build, not a stale container. Default `'dev'`.\n   */\n  buildId?: string;\n}\n\nconst DOC_FILE = /^docs\\/([^/]+)\\/(.+)$/;\nconst PROMPT_FILE = /^prompts\\/([^/]+)\\.md$/;\n\nexport function createCodesignMcpServer(\n  opts: CodesignMcpServerOptions\n): Server {\n  const scheme = opts.resourceScheme ?? 'codesign';\n  const assets = opts.assets;\n\n  // `instructions` is intentionally short — it tells the model what the\n  // server is and STRONGLY directs it to call `codesign_read_codesign_system`\n  // before its first design_exec. Skills are now first-class tools (not MCP\n  // resources buried in an XML block), so discovery happens via tools/list\n  // on every host without needing ReadMcpResourceTool support.\n  //\n  // Why short: Claude Code wraps MCP `instructions` in a <system-reminder>\n  // and truncates long ones mid-stream. Keeping `instructions` under ~1.5 KB\n  // ensures the whole pointer survives any sane truncation.\n  //\n  // The asset-generation hint is included only when an `asset_generate` tool\n  // is actually registered (Local hides it without an API_KEY), so we never\n  // advertise a tool the model can't see in tools/list.\n  const hasAssetGenerate = (opts.tools ?? []).some(\n    (t) => t.name === 'asset_generate'\n  );\n  const instructions = [\n    'This is the **codesign** MCP server. It hosts a CE.SDK CreativeEngine and a persistent design workspace (revision DAG) for vector design + print-quality PDF output.',\n    '',\n    '**Required first step** — before any `edit`, call `handbook` (no args). It teaches the mandatory `parent` argument, dirty-on-throw safety, rewind recovery via `list`/`history`, the typeface schema setFont requires, and the runtime quirks that bite first attempts. Skipping it produces broken output.',\n    '',\n    'Reference docs, on demand:',\n    '- `api({ path?, offset?, limit? })` — CE.SDK TypeScript signatures.',\n    '- `guide({ path? })` — CE.SDK Vanilla JS reference docs / topic guides.',\n    '',\n    'Design tools (after reading the handbook):',\n    '- `edit({ parent, code, title?, note? })` — mutate the canvas; `parent` is REQUIRED (revision id, or null for a new design).',\n    '- `preview({ blockId, revision? })` — render a block to an inline image.',\n    '- `export({ target, format, revision, blockId })` — render a block to pdf/image and write it into the workspace.',\n    '- `save({ revision, outPath? })` — write a self-contained `.zip` archive (scene + assets) of a revision into the workspace.',\n    '',\n    'Workspace tools (for resuming + navigating across designs):',\n    '- `list()` — every design in the workspace, newest first.',\n    '- `history({ revision })` — walk back to the root; how you re-ground after a rewind.',\n    '- `inspect({ revision })` — read one revision in full, including the code that produced it (patterns, not block ids).',\n    '- `rename({ revision, title })` — rename a design.',\n    '- `open_editor({ revision? })` — URL the human can open to view the design.',\n    '- `asset_search({ sourceId?, query? })` — browse asset sources; apply results in `edit`.'\n  ]\n    .concat(\n      hasAssetGenerate\n        ? [\n            '',\n            'Asset generation:',\n            \"- `asset_generate({ kind: 'image', prompt, width?, height? })` — opt-in (Local needs API_KEY); Hosted is cost-gated.\"\n          ]\n        : []\n    )\n    .join('\\n');\n\n  // Build the resource map up-front: URI → rewritten markdown body. Cross-refs\n  // inside doc content are rewritten to absolute MCP URIs so the model never\n  // has to resolve a relative path against a doc dir.\n  const rewrittenContent = new Map<string, string>();\n  for (const [key, content] of Object.entries(assets)) {\n    const m = key.match(DOC_FILE);\n    if (!m) continue;\n    const [, doc, rest] = m;\n    const uri = `${scheme}://docs/${doc}/${rest}`;\n    rewrittenContent.set(uri, rewriteSkillLinks(content, doc, scheme));\n  }\n\n  // Index prompts by name (frontmatter `name`, falling back to filename).\n  const prompts = new Map<string, { description: string; body: string }>();\n  for (const [key, content] of Object.entries(assets)) {\n    const m = key.match(PROMPT_FILE);\n    if (!m) continue;\n    const front = parseFrontmatter(content);\n    const name = front.name ?? m[1];\n    prompts.set(name, {\n      description: front.description ?? '',\n      body: front.body\n    });\n  }\n\n  const server = new Server(\n    { name: 'codesign', version: opts.buildId ?? 'dev' },\n    {\n      capabilities: { resources: {}, prompts: {}, tools: {} },\n      instructions\n    }\n  );\n\n  // `resources/list` advertises only the per-skill SKILL.md (the entry\n  // point), not the 392 nested cesdk-guide files. Sub-files stay readable\n  // via `resources/read` against any cached URI, but skill content discovery\n  // happens through the codesign_read_* tools — those are the universal\n  // surface across MCP hosts.\n  server.setRequestHandler(ListResourcesRequestSchema, async () => ({\n    resources: Array.from(rewrittenContent.keys())\n      .filter((uri) => uri.endsWith('/SKILL.md'))\n      .map((uri) => ({\n        uri,\n        mimeType: 'text/markdown',\n        name: uri.replace(`${scheme}://`, '')\n      }))\n  }));\n\n  server.setRequestHandler(ReadResourceRequestSchema, async (req) => {\n    const text = rewrittenContent.get(req.params.uri);\n    if (text === undefined) {\n      throw new McpError(\n        ErrorCode.InvalidParams,\n        `Unknown resource: ${req.params.uri}`\n      );\n    }\n    return {\n      contents: [{ uri: req.params.uri, mimeType: 'text/markdown', text }]\n    };\n  });\n\n  server.setRequestHandler(ListPromptsRequestSchema, async () => ({\n    prompts: Array.from(prompts.entries()).map(([name, p]) => ({\n      name,\n      description: p.description\n    }))\n  }));\n\n  server.setRequestHandler(GetPromptRequestSchema, async (req) => {\n    const p = prompts.get(req.params.name);\n    if (!p) {\n      throw new McpError(\n        ErrorCode.InvalidParams,\n        `Unknown prompt: ${req.params.name}`\n      );\n    }\n    return {\n      messages: [\n        {\n          role: 'user',\n          content: { type: 'text', text: p.body }\n        }\n      ]\n    };\n  });\n\n  // Tools registered with the server: caller-supplied design tools + the\n  // auto-generated skill-read tools (one per skill in the asset bundle).\n  // The skill tools always come first so Level 1 wording in the design tool\n  // descriptions (\"call codesign_read_codesign_system first\") points at\n  // something the model already sees in tools/list.\n  const tools = new Map<string, CodesignMcpToolRegistration>();\n  for (const t of buildSkillReadTools(assets)) tools.set(t.name, t);\n  for (const t of opts.tools ?? []) tools.set(t.name, t);\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: Array.from(tools.values()).map((t) => ({\n      name: t.name,\n      description: t.description,\n      inputSchema: t.inputSchema as never\n    }))\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (req) => {\n    const t = tools.get(req.params.name);\n    if (!t) {\n      throw new McpError(\n        ErrorCode.InvalidParams,\n        `Unknown tool: ${req.params.name}`\n      );\n    }\n    // No recorder → byte-for-byte the original behaviour (the off-switch).\n    if (!opts.metrics) return await t.call(req.params.arguments ?? {});\n\n    const startedAt = performance.now();\n    let ok = true;\n    try {\n      const res = await t.call(req.params.arguments ?? {});\n      ok = res.isError !== true;\n      return res;\n    } catch (err) {\n      ok = false;\n      throw err;\n    } finally {\n      opts.metrics.record({\n        tool: req.params.name,\n        durationMs: performance.now() - startedAt,\n        ok\n      });\n    }\n  });\n\n  return server;\n}\n"]}

package/dist/test/test/cli/redirect-console.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=redirect-console.test.d.ts.map

package/dist/test/test/cli/redirect-console.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-console.test.d.ts","sourceRoot":"","sources":["../../../../test/cli/redirect-console.test.ts"],"names":[],"mappings":""}

package/dist/test/test/cli/redirect-console.test.js

@@ -0,0 +1,47 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { redirectConsoleToStderr } from '../../src/cli/redirect-console.js';
+describe('redirectConsoleToStderr', () => {
+    // Snapshot the real console methods so each test starts from a clean slate
+    // and the redirect can't leak into later tests.
+    const original = {
+        log: console.log,
+        info: console.info,
+        warn: console.warn,
+        debug: console.debug,
+        trace: console.trace
+    };
+    // Spy on the fd-1/fd-2 sinks. Inference (rather than an explicit annotation)
+    // keeps vitest's overloaded `write` signature happy.
+    function spyOnStreams() {
+        return {
+            stdout: vi.spyOn(process.stdout, 'write').mockReturnValue(true),
+            stderr: vi.spyOn(process.stderr, 'write').mockReturnValue(true)
+        };
+    }
+    afterEach(() => {
+        Object.assign(console, original);
+        vi.restoreAllMocks();
+    });
+    it('routes the engine log line to stderr, never stdout', () => {
+        const { stdout, stderr } = spyOnStreams();
+        redirectConsoleToStderr();
+        console.log('[UBQ] Engine has been initialized.');
+        expect(stdout).not.toHaveBeenCalled();
+        expect(stderr).toHaveBeenCalledWith('[UBQ] Engine has been initialized.\n');
+    });
+    it.each(['info', 'warn', 'debug', 'trace'])('redirects console.%s to stderr', (method) => {
+        const { stdout, stderr } = spyOnStreams();
+        redirectConsoleToStderr();
+        console[method](`[CreativeEngine] via ${method}`);
+        expect(stdout).not.toHaveBeenCalled();
+        expect(stderr).toHaveBeenCalledWith(`[CreativeEngine] via ${method}\n`);
+    });
+    it('serializes non-string args instead of hitting stdout', () => {
+        const { stdout, stderr } = spyOnStreams();
+        redirectConsoleToStderr();
+        console.log('boot', { revision: 'dc8dd08ac3' }, 42);
+        expect(stdout).not.toHaveBeenCalled();
+        expect(stderr).toHaveBeenCalledWith('boot {"revision":"dc8dd08ac3"} 42\n');
+    });
+});
+//# sourceMappingURL=redirect-console.test.js.map

package/dist/test/test/cli/redirect-console.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-console.test.js","sourceRoot":"","sources":["../../../../test/cli/redirect-console.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,2EAA2E;IAC3E,gDAAgD;IAChD,MAAM,QAAQ,GAAG;QACf,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC;IAEF,6EAA6E;IAC7E,qDAAqD;IACrD,SAAS,YAAY;QACnB,OAAO;YACL,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC;YAC/D,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC;SAChE,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACjC,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1C,uBAAuB,EAAE,CAAC;QAE1B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAElD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,sCAAsC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC,CAClD,gCAAgC,EAChC,CAAC,MAAM,EAAE,EAAE;QACT,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1C,uBAAuB,EAAE,CAAC;QAE1B,OAAO,CAAC,MAAM,CAAC,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;QAElD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,wBAAwB,MAAM,IAAI,CAAC,CAAC;IAC1E,CAAC,CACF,CAAC;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;QAC1C,uBAAuB,EAAE,CAAC;QAE1B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAEpD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,qCAAqC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { afterEach, describe, expect, it, vi } from 'vitest';\nimport { redirectConsoleToStderr } from '../../src/cli/redirect-console.js';\n\ndescribe('redirectConsoleToStderr', () => {\n  // Snapshot the real console methods so each test starts from a clean slate\n  // and the redirect can't leak into later tests.\n  const original = {\n    log: console.log,\n    info: console.info,\n    warn: console.warn,\n    debug: console.debug,\n    trace: console.trace\n  };\n\n  // Spy on the fd-1/fd-2 sinks. Inference (rather than an explicit annotation)\n  // keeps vitest's overloaded `write` signature happy.\n  function spyOnStreams() {\n    return {\n      stdout: vi.spyOn(process.stdout, 'write').mockReturnValue(true),\n      stderr: vi.spyOn(process.stderr, 'write').mockReturnValue(true)\n    };\n  }\n\n  afterEach(() => {\n    Object.assign(console, original);\n    vi.restoreAllMocks();\n  });\n\n  it('routes the engine log line to stderr, never stdout', () => {\n    const { stdout, stderr } = spyOnStreams();\n    redirectConsoleToStderr();\n\n    console.log('[UBQ] Engine has been initialized.');\n\n    expect(stdout).not.toHaveBeenCalled();\n    expect(stderr).toHaveBeenCalledWith('[UBQ] Engine has been initialized.\\n');\n  });\n\n  it.each(['info', 'warn', 'debug', 'trace'] as const)(\n    'redirects console.%s to stderr',\n    (method) => {\n      const { stdout, stderr } = spyOnStreams();\n      redirectConsoleToStderr();\n\n      console[method](`[CreativeEngine] via ${method}`);\n\n      expect(stdout).not.toHaveBeenCalled();\n      expect(stderr).toHaveBeenCalledWith(`[CreativeEngine] via ${method}\\n`);\n    }\n  );\n\n  it('serializes non-string args instead of hitting stdout', () => {\n    const { stdout, stderr } = spyOnStreams();\n    redirectConsoleToStderr();\n\n    console.log('boot', { revision: 'dc8dd08ac3' }, 42);\n\n    expect(stdout).not.toHaveBeenCalled();\n    expect(stderr).toHaveBeenCalledWith('boot {\"revision\":\"dc8dd08ac3\"} 42\\n');\n  });\n});\n"]}

package/dist/test/test/cli/resolve-license.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-license.test.d.ts.map

package/dist/test/test/cli/resolve-license.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-license.test.d.ts","sourceRoot":"","sources":["../../../../test/cli/resolve-license.test.ts"],"names":[],"mappings":""}

package/dist/test/test/cli/resolve-license.test.js

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest';
+import { resolveLicense } from '../../src/cli/resolve-license.js';
+describe('resolveLicense', () => {
+    it('prefers CESDK_LICENSE over the trial', () => {
+        expect(resolveLicense({ CESDK_LICENSE: 'real' }, 'trial')).toBe('real');
+    });
+    it('falls back to the trial when CESDK_LICENSE is unset', () => {
+        expect(resolveLicense({}, 'trial')).toBe('trial');
+    });
+    it('treats a blank CESDK_LICENSE as unset and uses the trial', () => {
+        expect(resolveLicense({ CESDK_LICENSE: '   ' }, 'trial')).toBe('trial');
+    });
+    it('returns undefined when neither is present', () => {
+        expect(resolveLicense({}, '')).toBeUndefined();
+    });
+    it('trims surrounding whitespace from the env license', () => {
+        expect(resolveLicense({ CESDK_LICENSE: '  real  ' }, '')).toBe('real');
+    });
+});
+//# sourceMappingURL=resolve-license.test.js.map

package/dist/test/test/cli/resolve-license.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-license.test.js","sourceRoot":"","sources":["../../../../test/cli/resolve-license.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,cAAc,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,cAAc,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,cAAc,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { resolveLicense } from '../../src/cli/resolve-license.js';\n\ndescribe('resolveLicense', () => {\n  it('prefers CESDK_LICENSE over the trial', () => {\n    expect(resolveLicense({ CESDK_LICENSE: 'real' }, 'trial')).toBe('real');\n  });\n\n  it('falls back to the trial when CESDK_LICENSE is unset', () => {\n    expect(resolveLicense({}, 'trial')).toBe('trial');\n  });\n\n  it('treats a blank CESDK_LICENSE as unset and uses the trial', () => {\n    expect(resolveLicense({ CESDK_LICENSE: '   ' }, 'trial')).toBe('trial');\n  });\n\n  it('returns undefined when neither is present', () => {\n    expect(resolveLicense({}, '')).toBeUndefined();\n  });\n\n  it('trims surrounding whitespace from the env license', () => {\n    expect(resolveLicense({ CESDK_LICENSE: '  real  ' }, '')).toBe('real');\n  });\n});\n"]}

package/dist/test/test/cli/stdio-license.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stdio-license.test.d.ts.map

package/dist/test/test/cli/stdio-license.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-license.test.d.ts","sourceRoot":"","sources":["../../../../test/cli/stdio-license.test.ts"],"names":[],"mappings":""}

package/dist/test/test/cli/stdio-license.test.js

@@ -0,0 +1,19 @@
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { describe, expect, it } from 'vitest';
+const here = path.dirname(fileURLToPath(import.meta.url));
+const CLI = path.resolve(here, '..', '..', 'dist', 'cli.js');
+describe('codesign-mcp stdio license resolution', () => {
+    it('exits 1 with a helpful message when no license and no bundled trial', () => {
+        const r = spawnSync('node', [CLI, 'stdio'], {
+            encoding: 'utf8',
+            // No CESDK_LICENSE; dev build has an empty trial → must refuse to start.
+            env: { PATH: process.env.PATH ?? '' },
+            timeout: 5000
+        });
+        expect(r.status).toBe(1);
+        expect(r.stderr).toContain('no CESDK_LICENSE set and no bundled trial');
+    });
+});
+//# sourceMappingURL=stdio-license.test.js.map

package/dist/test/test/cli/stdio-license.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-license.test.js","sourceRoot":"","sources":["../../../../test/cli/stdio-license.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAE7D,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE;YAC1C,QAAQ,EAAE,MAAM;YAChB,yEAAyE;YACzE,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE;YACrC,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,2CAA2C,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { spawnSync } from 'node:child_process';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { describe, expect, it } from 'vitest';\n\nconst here = path.dirname(fileURLToPath(import.meta.url));\nconst CLI = path.resolve(here, '..', '..', 'dist', 'cli.js');\n\ndescribe('codesign-mcp stdio license resolution', () => {\n  it('exits 1 with a helpful message when no license and no bundled trial', () => {\n    const r = spawnSync('node', [CLI, 'stdio'], {\n      encoding: 'utf8',\n      // No CESDK_LICENSE; dev build has an empty trial → must refuse to start.\n      env: { PATH: process.env.PATH ?? '' },\n      timeout: 5000\n    });\n    expect(r.status).toBe(1);\n    expect(r.stderr).toContain('no CESDK_LICENSE set and no bundled trial');\n  });\n});\n"]}

package/dist/test/test/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/test/test/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../../test/config.test.ts"],"names":[],"mappings":""}

package/dist/test/test/config.test.js

@@ -0,0 +1,91 @@
+import { mkdtempSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { loadConfig, resolveSecret } from '../src/config.js';
+const BASE = { IMGLY_CESDK_LICENSE: 'lic-123' };
+describe('resolveSecret', () => {
+    it('returns the plain env var when no _FILE is set', () => {
+        expect(resolveSecret('X', { X: 'v' })).toBe('v');
+    });
+    it('prefers the _FILE contents (trimmed) over the env var', () => {
+        const dir = mkdtempSync(join(tmpdir(), 'cfg-'));
+        const f = join(dir, 'secret');
+        writeFileSync(f, 'file-value\n');
+        expect(resolveSecret('X', { X: 'env-value', X_FILE: f })).toBe('file-value');
+    });
+    it('returns undefined when neither is set', () => {
+        expect(resolveSecret('X', {})).toBeUndefined();
+    });
+});
+describe('loadConfig', () => {
+    it('applies defaults (header mode, local backend, port 8080)', () => {
+        const cfg = loadConfig(BASE);
+        expect(cfg.cesdkLicense).toBe('lic-123');
+        expect(cfg.auth.mode).toBe('header');
+        expect(cfg.auth.header).toBe('X-Workspace-Id');
+        expect(cfg.workspace.backend).toBe('local');
+        expect(cfg.workspace.dir).toBe('/data');
+        expect(cfg.port).toBe(8080);
+        expect(cfg.maxEngines).toBe(8);
+        expect(cfg.buildId).toBe('dev');
+    });
+    it('reads buildId from IMGLY_BUILD_ID (the deploy-injected git SHA)', () => {
+        expect(loadConfig({ ...BASE, IMGLY_BUILD_ID: 'abc1234' }).buildId).toBe('abc1234');
+    });
+    it('throws when the license is missing', () => {
+        expect(() => loadConfig({})).toThrow(/IMGLY_CESDK_LICENSE/);
+    });
+    it('single mode requires IMGLY_WORKSPACE_ID', () => {
+        expect(() => loadConfig({ ...BASE, IMGLY_WORKSPACE_MODE: 'single' })).toThrow(/IMGLY_WORKSPACE_ID/);
+        const cfg = loadConfig({
+            ...BASE,
+            IMGLY_WORKSPACE_MODE: 'single',
+            IMGLY_WORKSPACE_ID: 'acme'
+        });
+        expect(cfg.auth.fixedWorkspaceId).toBe('acme');
+    });
+    it('s3 backend requires a bucket and reads region/endpoint', () => {
+        expect(() => loadConfig({ ...BASE, IMGLY_WORKSPACE_BACKEND: 's3' })).toThrow(/IMGLY_WORKSPACE_S3_BUCKET/);
+        const cfg = loadConfig({
+            ...BASE,
+            IMGLY_WORKSPACE_BACKEND: 's3',
+            IMGLY_WORKSPACE_S3_BUCKET: 'designs',
+            IMGLY_WORKSPACE_S3_ENDPOINT: 'https://acct.r2.cloudflarestorage.com'
+        });
+        expect(cfg.workspace.backend).toBe('s3');
+        expect(cfg.workspace.s3?.bucket).toBe('designs');
+        expect(cfg.workspace.s3?.region).toBe('auto');
+        expect(cfg.workspace.s3?.endpoint).toBe('https://acct.r2.cloudflarestorage.com');
+    });
+    it('rejects an unknown mode', () => {
+        expect(() => loadConfig({ ...BASE, IMGLY_WORKSPACE_MODE: 'bogus' })).toThrow(/IMGLY_WORKSPACE_MODE/);
+    });
+    it('leaves the gateway disabled when no key is set', () => {
+        expect(loadConfig(BASE).gateway.apiKey).toBeUndefined();
+    });
+    it('metricsEnabled defaults to false when unset', () => {
+        expect(loadConfig(BASE).metricsEnabled).toBe(false);
+    });
+    it('metricsEnabled is true for "true" or "1"', () => {
+        expect(loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'true' }).metricsEnabled).toBe(true);
+        expect(loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: '1' }).metricsEnabled).toBe(true);
+    });
+    it('metricsEnabled is false for any other explicit value', () => {
+        expect(loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'false' }).metricsEnabled).toBe(false);
+        expect(loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'yes' }).metricsEnabled).toBe(false);
+    });
+});
+describe('IMGLY_PUBLIC_BASE_URL', () => {
+    it('is absent by default', () => {
+        expect(loadConfig(BASE).publicBaseUrl).toBeUndefined();
+    });
+    it('is loaded with trailing slashes stripped', () => {
+        const cfg = loadConfig({
+            ...BASE,
+            IMGLY_PUBLIC_BASE_URL: 'https://codesign.example.com/'
+        });
+        expect(cfg.publicBaseUrl).toBe('https://codesign.example.com');
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/test/test/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../../test/config.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdtempSync, writeFileSync } from 'node:fs';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { describe, expect, it } from 'vitest';\nimport { loadConfig, resolveSecret } from '../src/config.js';\n\nconst BASE = { IMGLY_CESDK_LICENSE: 'lic-123' };\n\ndescribe('resolveSecret', () => {\n  it('returns the plain env var when no _FILE is set', () => {\n    expect(resolveSecret('X', { X: 'v' })).toBe('v');\n  });\n\n  it('prefers the _FILE contents (trimmed) over the env var', () => {\n    const dir = mkdtempSync(join(tmpdir(), 'cfg-'));\n    const f = join(dir, 'secret');\n    writeFileSync(f, 'file-value\\n');\n    expect(resolveSecret('X', { X: 'env-value', X_FILE: f })).toBe(\n      'file-value'\n    );\n  });\n\n  it('returns undefined when neither is set', () => {\n    expect(resolveSecret('X', {})).toBeUndefined();\n  });\n});\n\ndescribe('loadConfig', () => {\n  it('applies defaults (header mode, local backend, port 8080)', () => {\n    const cfg = loadConfig(BASE);\n    expect(cfg.cesdkLicense).toBe('lic-123');\n    expect(cfg.auth.mode).toBe('header');\n    expect(cfg.auth.header).toBe('X-Workspace-Id');\n    expect(cfg.workspace.backend).toBe('local');\n    expect(cfg.workspace.dir).toBe('/data');\n    expect(cfg.port).toBe(8080);\n    expect(cfg.maxEngines).toBe(8);\n    expect(cfg.buildId).toBe('dev');\n  });\n\n  it('reads buildId from IMGLY_BUILD_ID (the deploy-injected git SHA)', () => {\n    expect(loadConfig({ ...BASE, IMGLY_BUILD_ID: 'abc1234' }).buildId).toBe(\n      'abc1234'\n    );\n  });\n\n  it('throws when the license is missing', () => {\n    expect(() => loadConfig({})).toThrow(/IMGLY_CESDK_LICENSE/);\n  });\n\n  it('single mode requires IMGLY_WORKSPACE_ID', () => {\n    expect(() =>\n      loadConfig({ ...BASE, IMGLY_WORKSPACE_MODE: 'single' })\n    ).toThrow(/IMGLY_WORKSPACE_ID/);\n    const cfg = loadConfig({\n      ...BASE,\n      IMGLY_WORKSPACE_MODE: 'single',\n      IMGLY_WORKSPACE_ID: 'acme'\n    });\n    expect(cfg.auth.fixedWorkspaceId).toBe('acme');\n  });\n\n  it('s3 backend requires a bucket and reads region/endpoint', () => {\n    expect(() =>\n      loadConfig({ ...BASE, IMGLY_WORKSPACE_BACKEND: 's3' })\n    ).toThrow(/IMGLY_WORKSPACE_S3_BUCKET/);\n    const cfg = loadConfig({\n      ...BASE,\n      IMGLY_WORKSPACE_BACKEND: 's3',\n      IMGLY_WORKSPACE_S3_BUCKET: 'designs',\n      IMGLY_WORKSPACE_S3_ENDPOINT: 'https://acct.r2.cloudflarestorage.com'\n    });\n    expect(cfg.workspace.backend).toBe('s3');\n    expect(cfg.workspace.s3?.bucket).toBe('designs');\n    expect(cfg.workspace.s3?.region).toBe('auto');\n    expect(cfg.workspace.s3?.endpoint).toBe(\n      'https://acct.r2.cloudflarestorage.com'\n    );\n  });\n\n  it('rejects an unknown mode', () => {\n    expect(() =>\n      loadConfig({ ...BASE, IMGLY_WORKSPACE_MODE: 'bogus' })\n    ).toThrow(/IMGLY_WORKSPACE_MODE/);\n  });\n\n  it('leaves the gateway disabled when no key is set', () => {\n    expect(loadConfig(BASE).gateway.apiKey).toBeUndefined();\n  });\n\n  it('metricsEnabled defaults to false when unset', () => {\n    expect(loadConfig(BASE).metricsEnabled).toBe(false);\n  });\n\n  it('metricsEnabled is true for \"true\" or \"1\"', () => {\n    expect(\n      loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'true' }).metricsEnabled\n    ).toBe(true);\n    expect(\n      loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: '1' }).metricsEnabled\n    ).toBe(true);\n  });\n\n  it('metricsEnabled is false for any other explicit value', () => {\n    expect(\n      loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'false' }).metricsEnabled\n    ).toBe(false);\n    expect(\n      loadConfig({ ...BASE, IMGLY_METRICS_ENABLED: 'yes' }).metricsEnabled\n    ).toBe(false);\n  });\n});\n\ndescribe('IMGLY_PUBLIC_BASE_URL', () => {\n  it('is absent by default', () => {\n    expect(loadConfig(BASE).publicBaseUrl).toBeUndefined();\n  });\n\n  it('is loaded with trailing slashes stripped', () => {\n    const cfg = loadConfig({\n      ...BASE,\n      IMGLY_PUBLIC_BASE_URL: 'https://codesign.example.com/'\n    });\n    expect(cfg.publicBaseUrl).toBe('https://codesign.example.com');\n  });\n});\n"]}

package/dist/test/test/engine/asset-sources.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=asset-sources.test.d.ts.map

package/dist/test/test/engine/asset-sources.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-sources.test.d.ts","sourceRoot":"","sources":["../../../../test/engine/asset-sources.test.ts"],"names":[],"mappings":""}

package/dist/test/test/engine/asset-sources.test.js

@@ -0,0 +1,100 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { ensureEngineAssetSources, resetEngineAssetSourcesForTest } from '../../src/engine/asset-sources.js';
+function makeEngine(existingSources) {
+    return {
+        asset: { findAllSources: vi.fn(() => existingSources) },
+        addDefaultAssetSources: vi.fn(async () => { }),
+        addDemoAssetSources: vi.fn(async () => { })
+    };
+}
+describe('ensureEngineAssetSources', () => {
+    beforeEach(() => {
+        resetEngineAssetSourcesForTest();
+    });
+    it('registers default + demo sources on a fresh engine', async () => {
+        const engine = makeEngine([]);
+        await ensureEngineAssetSources(engine);
+        expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();
+        expect(engine.addDefaultAssetSources).toHaveBeenCalledWith({
+            baseURL: 'https://cdn.img.ly/assets/v3',
+            excludeAssetSourceIds: ['ly.img.text']
+        });
+        expect(engine.addDemoAssetSources).toHaveBeenCalledOnce();
+        expect(engine.addDemoAssetSources).toHaveBeenCalledWith({
+            baseURL: 'https://cdn.img.ly/assets/demo/v3'
+        });
+    });
+    it('honours self-hosted manifest roots from the environment', async () => {
+        vi.stubEnv('IMGLY_DEFAULT_ASSETS_BASE_URL', 'https://assets.example.com/v3');
+        vi.stubEnv('IMGLY_DEMO_ASSETS_BASE_URL', 'https://assets.example.com/demo/v3');
+        try {
+            const engine = makeEngine([]);
+            await ensureEngineAssetSources(engine);
+            expect(engine.addDefaultAssetSources).toHaveBeenCalledWith({
+                baseURL: 'https://assets.example.com/v3',
+                excludeAssetSourceIds: ['ly.img.text']
+            });
+            expect(engine.addDemoAssetSources).toHaveBeenCalledWith({
+                baseURL: 'https://assets.example.com/demo/v3'
+            });
+        }
+        finally {
+            vi.unstubAllEnvs();
+        }
+    });
+    it('skips registration when the demo image source is already present', async () => {
+        const engine = makeEngine(['ly.img.image']);
+        await ensureEngineAssetSources(engine);
+        expect(engine.addDefaultAssetSources).not.toHaveBeenCalled();
+        expect(engine.addDemoAssetSources).not.toHaveBeenCalled();
+    });
+    it('swallows CDN failures (best-effort) without throwing', async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, 'write')
+            .mockImplementation(() => true);
+        const engine = makeEngine([]);
+        engine.addDefaultAssetSources.mockRejectedValueOnce(new Error('offline'));
+        await expect(ensureEngineAssetSources(engine)).resolves.toBeUndefined();
+        expect(stderrSpy.mock.calls[0][0]).toContain('asset_search will see fewer sources');
+        stderrSpy.mockRestore();
+    });
+    it('concurrent calls share one in-flight registration', async () => {
+        const engine = makeEngine([]);
+        const p1 = ensureEngineAssetSources(engine);
+        const p2 = ensureEngineAssetSources(engine);
+        await Promise.all([p1, p2]);
+        expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();
+    });
+    it('total failure (sentinel absent) clears the guard so the next call retries', async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, 'write')
+            .mockImplementation(() => true);
+        const engine = makeEngine([]);
+        engine.addDefaultAssetSources.mockRejectedValueOnce(new Error('offline'));
+        await ensureEngineAssetSources(engine);
+        await ensureEngineAssetSources(engine);
+        expect(engine.addDefaultAssetSources).toHaveBeenCalledTimes(2);
+        stderrSpy.mockRestore();
+    });
+    it('keeps the guard when demo sources land despite default-source failure', async () => {
+        const stderrSpy = vi
+            .spyOn(process.stderr, 'write')
+            .mockImplementation(() => true);
+        const sources = [];
+        const engine = {
+            asset: { findAllSources: vi.fn(() => [...sources]) },
+            addDefaultAssetSources: vi.fn(async () => {
+                throw new Error('ENOENT');
+            }),
+            addDemoAssetSources: vi.fn(async () => {
+                sources.push('ly.img.image');
+            })
+        };
+        await ensureEngineAssetSources(engine);
+        await ensureEngineAssetSources(engine);
+        expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();
+        expect(engine.addDemoAssetSources).toHaveBeenCalledOnce();
+        stderrSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=asset-sources.test.js.map

package/dist/test/test/engine/asset-sources.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-sources.test.js","sourceRoot":"","sources":["../../../../test/engine/asset-sources.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { beforeEach, describe, expect, it, vi } from 'vitest';\nimport {\n  ensureEngineAssetSources,\n  resetEngineAssetSourcesForTest\n} from '../../src/engine/asset-sources.js';\n\nfunction makeEngine(existingSources: string[]) {\n  return {\n    asset: { findAllSources: vi.fn(() => existingSources) },\n    addDefaultAssetSources: vi.fn(async () => {}),\n    addDemoAssetSources: vi.fn(async () => {})\n  };\n}\n\ndescribe('ensureEngineAssetSources', () => {\n  beforeEach(() => {\n    resetEngineAssetSourcesForTest();\n  });\n\n  it('registers default + demo sources on a fresh engine', async () => {\n    const engine = makeEngine([]);\n    await ensureEngineAssetSources(engine);\n    expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();\n    expect(engine.addDefaultAssetSources).toHaveBeenCalledWith({\n      baseURL: 'https://cdn.img.ly/assets/v3',\n      excludeAssetSourceIds: ['ly.img.text']\n    });\n    expect(engine.addDemoAssetSources).toHaveBeenCalledOnce();\n    expect(engine.addDemoAssetSources).toHaveBeenCalledWith({\n      baseURL: 'https://cdn.img.ly/assets/demo/v3'\n    });\n  });\n\n  it('honours self-hosted manifest roots from the environment', async () => {\n    vi.stubEnv(\n      'IMGLY_DEFAULT_ASSETS_BASE_URL',\n      'https://assets.example.com/v3'\n    );\n    vi.stubEnv(\n      'IMGLY_DEMO_ASSETS_BASE_URL',\n      'https://assets.example.com/demo/v3'\n    );\n    try {\n      const engine = makeEngine([]);\n      await ensureEngineAssetSources(engine);\n      expect(engine.addDefaultAssetSources).toHaveBeenCalledWith({\n        baseURL: 'https://assets.example.com/v3',\n        excludeAssetSourceIds: ['ly.img.text']\n      });\n      expect(engine.addDemoAssetSources).toHaveBeenCalledWith({\n        baseURL: 'https://assets.example.com/demo/v3'\n      });\n    } finally {\n      vi.unstubAllEnvs();\n    }\n  });\n\n  it('skips registration when the demo image source is already present', async () => {\n    const engine = makeEngine(['ly.img.image']);\n    await ensureEngineAssetSources(engine);\n    expect(engine.addDefaultAssetSources).not.toHaveBeenCalled();\n    expect(engine.addDemoAssetSources).not.toHaveBeenCalled();\n  });\n\n  it('swallows CDN failures (best-effort) without throwing', async () => {\n    const stderrSpy = vi\n      .spyOn(process.stderr, 'write')\n      .mockImplementation(() => true);\n    const engine = makeEngine([]);\n    engine.addDefaultAssetSources.mockRejectedValueOnce(new Error('offline'));\n    await expect(ensureEngineAssetSources(engine)).resolves.toBeUndefined();\n    expect(stderrSpy.mock.calls[0][0]).toContain(\n      'asset_search will see fewer sources'\n    );\n    stderrSpy.mockRestore();\n  });\n\n  it('concurrent calls share one in-flight registration', async () => {\n    const engine = makeEngine([]);\n    const p1 = ensureEngineAssetSources(engine);\n    const p2 = ensureEngineAssetSources(engine);\n    await Promise.all([p1, p2]);\n    expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();\n  });\n\n  it('total failure (sentinel absent) clears the guard so the next call retries', async () => {\n    const stderrSpy = vi\n      .spyOn(process.stderr, 'write')\n      .mockImplementation(() => true);\n    const engine = makeEngine([]);\n    engine.addDefaultAssetSources.mockRejectedValueOnce(new Error('offline'));\n    await ensureEngineAssetSources(engine);\n    await ensureEngineAssetSources(engine);\n    expect(engine.addDefaultAssetSources).toHaveBeenCalledTimes(2);\n    stderrSpy.mockRestore();\n  });\n\n  it('keeps the guard when demo sources land despite default-source failure', async () => {\n    const stderrSpy = vi\n      .spyOn(process.stderr, 'write')\n      .mockImplementation(() => true);\n    const sources: string[] = [];\n    const engine = {\n      asset: { findAllSources: vi.fn(() => [...sources]) },\n      addDefaultAssetSources: vi.fn(async () => {\n        throw new Error('ENOENT');\n      }),\n      addDemoAssetSources: vi.fn(async () => {\n        sources.push('ly.img.image');\n      })\n    };\n    await ensureEngineAssetSources(engine);\n    await ensureEngineAssetSources(engine);\n    expect(engine.addDefaultAssetSources).toHaveBeenCalledOnce();\n    expect(engine.addDemoAssetSources).toHaveBeenCalledOnce();\n    stderrSpy.mockRestore();\n  });\n});\n"]}

package/dist/test/test/engine/mutex.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mutex.test.d.ts.map

package/dist/test/test/engine/mutex.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.test.d.ts","sourceRoot":"","sources":["../../../../test/engine/mutex.test.ts"],"names":[],"mappings":""}

package/dist/test/test/engine/mutex.test.js

@@ -0,0 +1,63 @@
+import { describe, expect, it } from 'vitest';
+import { Mutex } from '../../src/engine/mutex.js';
+const tick = (ms = 0) => new Promise((resolve) => setTimeout(resolve, ms));
+describe('Mutex', () => {
+    it('runs sections one at a time — never two in their critical region at once', async () => {
+        const mutex = new Mutex();
+        let active = 0;
+        let maxActive = 0;
+        const section = async () => {
+            active++;
+            maxActive = Math.max(maxActive, active);
+            await tick(5); // hold the section open across an await
+            active--;
+        };
+        await Promise.all([
+            mutex.runExclusive(section),
+            mutex.runExclusive(section),
+            mutex.runExclusive(section),
+            mutex.runExclusive(section)
+        ]);
+        expect(maxActive).toBe(1);
+        expect(active).toBe(0);
+    });
+    it('preserves FIFO order', async () => {
+        const mutex = new Mutex();
+        const order = [];
+        await Promise.all([0, 1, 2, 3].map((i) => mutex.runExclusive(async () => {
+            await tick(1);
+            order.push(i);
+        })));
+        expect(order).toEqual([0, 1, 2, 3]);
+    });
+    it('returns the section result to its caller', async () => {
+        const mutex = new Mutex();
+        await expect(mutex.runExclusive(async () => 42)).resolves.toBe(42);
+    });
+    it('a throwing section rejects its caller but does not wedge the queue', async () => {
+        const mutex = new Mutex();
+        const boom = mutex.runExclusive(async () => {
+            throw new Error('boom');
+        });
+        await expect(boom).rejects.toThrow('boom');
+        // The next section must still run after a rejection.
+        await expect(mutex.runExclusive(async () => 'ok')).resolves.toBe('ok');
+    });
+    it('stays mutually exclusive under heavy interleaving (multiple yields per section)', async () => {
+        const mutex = new Mutex();
+        let active = 0;
+        let maxActive = 0;
+        const section = async () => {
+            active++;
+            maxActive = Math.max(maxActive, active);
+            await tick(0);
+            await Promise.resolve();
+            await tick(0);
+            active--;
+        };
+        await Promise.all(Array.from({ length: 12 }, () => mutex.runExclusive(section)));
+        expect(maxActive).toBe(1);
+        expect(active).toBe(0);
+    });
+});
+//# sourceMappingURL=mutex.test.js.map

package/dist/test/test/engine/mutex.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.test.js","sourceRoot":"","sources":["../../../../test/engine/mutex.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { Mutex } from '../../src/engine/mutex.js';\n\nconst tick = (ms = 0): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, ms));\n\ndescribe('Mutex', () => {\n  it('runs sections one at a time — never two in their critical region at once', async () => {\n    const mutex = new Mutex();\n    let active = 0;\n    let maxActive = 0;\n    const section = async () => {\n      active++;\n      maxActive = Math.max(maxActive, active);\n      await tick(5); // hold the section open across an await\n      active--;\n    };\n    await Promise.all([\n      mutex.runExclusive(section),\n      mutex.runExclusive(section),\n      mutex.runExclusive(section),\n      mutex.runExclusive(section)\n    ]);\n    expect(maxActive).toBe(1);\n    expect(active).toBe(0);\n  });\n\n  it('preserves FIFO order', async () => {\n    const mutex = new Mutex();\n    const order: number[] = [];\n    await Promise.all(\n      [0, 1, 2, 3].map((i) =>\n        mutex.runExclusive(async () => {\n          await tick(1);\n          order.push(i);\n        })\n      )\n    );\n    expect(order).toEqual([0, 1, 2, 3]);\n  });\n\n  it('returns the section result to its caller', async () => {\n    const mutex = new Mutex();\n    await expect(mutex.runExclusive(async () => 42)).resolves.toBe(42);\n  });\n\n  it('a throwing section rejects its caller but does not wedge the queue', async () => {\n    const mutex = new Mutex();\n    const boom = mutex.runExclusive(async () => {\n      throw new Error('boom');\n    });\n    await expect(boom).rejects.toThrow('boom');\n    // The next section must still run after a rejection.\n    await expect(mutex.runExclusive(async () => 'ok')).resolves.toBe('ok');\n  });\n\n  it('stays mutually exclusive under heavy interleaving (multiple yields per section)', async () => {\n    const mutex = new Mutex();\n    let active = 0;\n    let maxActive = 0;\n    const section = async () => {\n      active++;\n      maxActive = Math.max(maxActive, active);\n      await tick(0);\n      await Promise.resolve();\n      await tick(0);\n      active--;\n    };\n    await Promise.all(\n      Array.from({ length: 12 }, () => mutex.runExclusive(section))\n    );\n    expect(maxActive).toBe(1);\n    expect(active).toBe(0);\n  });\n});\n"]}

package/dist/test/test/engine/session.test.js

@@ -61,6 +61,21 @@ describe('EngineSession (single slot)', () => {
         expect(slot2.currentRevision).toBe('rev_abc');
     });
 });
+describe('EngineSession cold-instance reconstruction (spec §8.6)', () => {
+    it('reconstructs a cold engine by loading a staged revision scene', async () => {
+        // Regression guard: a cold session (no warm slot) must load the staged
+        // scene via loadFromString before returning the slot. This documents the
+        // edit-tool contract: populate(parent, scene) → acquire(parent) always
+        // calls loadFromString, never assumes a warm engine.
+        const { adapter } = makeFakeEngine();
+        const session = new EngineSession({ size: 1, adapter });
+        // Cold: no slots exist yet, so no warm engine.
+        await session.populate('rev-1', '<scene-for-rev-1/>');
+        const slot = await session.acquire('rev-1');
+        expect(adapter.loadFromString).toHaveBeenCalledWith(slot.engine, '<scene-for-rev-1/>');
+        expect(slot.currentRevision).toBe('rev-1');
+    });
+});
 describe('EngineSession (multi-slot sticky routing)', () => {
     function makeAdapterWithCounter() {
         let id = 0;