@imgly/codesign-mcp 0.1.0

package/dist/server.d.ts

@@ -0,0 +1,51 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { MetricsRecorder } from './metrics/recorder.js';
+/**
+ * One tool the server exposes via tools/list + tools/call. Caller-supplied so
+ * the engine-bound implementations live near the surface that owns the engine
+ * (the demo passes its existing `createDesignTools` output adapted to this
+ * shape; an external bootstrap could pass server-side equivalents).
+ */
+export interface CodesignMcpToolRegistration {
+    name: string;
+    description?: string;
+    /** JSON Schema describing the tool's input arguments. */
+    inputSchema: unknown;
+    call: (args: unknown) => Promise<{
+        content: Array<{
+            type: 'text';
+            text: string;
+        } | {
+            type: 'image';
+            data: string;
+            mimeType: string;
+        }>;
+        isError?: boolean;
+    }>;
+}
+export interface CodesignMcpServerOptions {
+    /** CreativeEngine instance, DI'd by caller. Pass-through to design tools. */
+    engine: unknown;
+    /**
+     * Asset bundle. Keys are forward-slash paths under one of:
+     *   "docs/<doc>/SKILL.md"          — entry point for handbook / api / guide
+     *   "docs/<doc>/<file>"            — sub-files reachable via the doc tools
+     *   "prompts/<name>.md"            — slash-command prompts
+     * Values are file contents.
+     */
+    assets: Record<string, string>;
+    /** URI scheme for resources. Default: "codesign". */
+    resourceScheme?: string;
+    /** Tools to expose via tools/list + tools/call. */
+    tools?: CodesignMcpToolRegistration[];
+    /** Optional metrics sink. Absent → tool calls are not timed (no-op). */
+    metrics?: MetricsRecorder;
+    /**
+     * Build identity reported as `serverInfo.version` on `initialize`. A client
+     * (the deploy smoketest) can assert it to confirm it's talking to the
+     * just-deployed build, not a stale container. Default `'dev'`.
+     */
+    buildId?: string;
+}
+export declare function createCodesignMcpServer(opts: CodesignMcpServerOptions): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAenE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;QAC/B,OAAO,EAAE,KAAK,CACV;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAC9B;YAAE,IAAI,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CACpD,CAAC;QACF,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,wBAAwB;IACvC,6EAA6E;IAC7E,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,KAAK,CAAC,EAAE,2BAA2B,EAAE,CAAC;IACtC,wEAAwE;IACxE,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,MAAM,CA2LR"}

package/dist/server.js

@@ -0,0 +1,175 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ErrorCode, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, McpError, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { rewriteSkillLinks } from './cross-ref.js';
+import { parseFrontmatter } from './frontmatter.js';
+import { buildSkillReadTools } from './skill-tools.js';
+import { performance } from 'node:perf_hooks';
+const DOC_FILE = /^docs\/([^/]+)\/(.+)$/;
+const PROMPT_FILE = /^prompts\/([^/]+)\.md$/;
+export function createCodesignMcpServer(opts) {
+    const scheme = opts.resourceScheme ?? 'codesign';
+    const assets = opts.assets;
+    // `instructions` is intentionally short — it tells the model what the
+    // server is and STRONGLY directs it to call `codesign_read_codesign_system`
+    // before its first design_exec. Skills are now first-class tools (not MCP
+    // resources buried in an XML block), so discovery happens via tools/list
+    // on every host without needing ReadMcpResourceTool support.
+    //
+    // Why short: Claude Code wraps MCP `instructions` in a <system-reminder>
+    // and truncates long ones mid-stream. Keeping `instructions` under ~1.5 KB
+    // ensures the whole pointer survives any sane truncation.
+    //
+    // The asset-generation hint is included only when an `asset_generate` tool
+    // is actually registered (Local hides it without an API_KEY), so we never
+    // advertise a tool the model can't see in tools/list.
+    const hasAssetGenerate = (opts.tools ?? []).some((t) => t.name === 'asset_generate');
+    const instructions = [
+        '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.',
+        '',
+        '**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.',
+        '',
+        'Reference docs, on demand:',
+        '- `api({ path?, offset?, limit? })` — CE.SDK TypeScript signatures.',
+        '- `guide({ path? })` — CE.SDK Vanilla JS reference docs / topic guides.',
+        '',
+        'Design tools (after reading the handbook):',
+        '- `edit({ parent, code, title?, note? })` — mutate the canvas; `parent` is REQUIRED (revision id, or null for a new design).',
+        '- `preview({ blockId, revision? })` — render a block to an inline image.',
+        '- `export({ target, format, revision, blockId })` — render a block to pdf/image and write it into the workspace.',
+        '- `save({ revision, outPath? })` — write a self-contained `.zip` archive (scene + assets) of a revision into the workspace.',
+        '',
+        'Workspace tools (for resuming + navigating across designs):',
+        '- `list()` — every design in the workspace, newest first.',
+        '- `history({ revision })` — walk back to the root; how you re-ground after a rewind.',
+        '- `inspect({ revision })` — read one revision in full, including the code that produced it (patterns, not block ids).',
+        '- `rename({ revision, title })` — rename a design.',
+        '- `open_editor({ revision? })` — URL the human can open to view the design.',
+        '- `asset_search({ sourceId?, query? })` — browse asset sources; apply results in `edit`.'
+    ]
+        .concat(hasAssetGenerate
+        ? [
+            '',
+            'Asset generation:',
+            "- `asset_generate({ kind: 'image', prompt, width?, height? })` — opt-in (Local needs API_KEY); Hosted is cost-gated."
+        ]
+        : [])
+        .join('\n');
+    // Build the resource map up-front: URI → rewritten markdown body. Cross-refs
+    // inside doc content are rewritten to absolute MCP URIs so the model never
+    // has to resolve a relative path against a doc dir.
+    const rewrittenContent = new Map();
+    for (const [key, content] of Object.entries(assets)) {
+        const m = key.match(DOC_FILE);
+        if (!m)
+            continue;
+        const [, doc, rest] = m;
+        const uri = `${scheme}://docs/${doc}/${rest}`;
+        rewrittenContent.set(uri, rewriteSkillLinks(content, doc, scheme));
+    }
+    // Index prompts by name (frontmatter `name`, falling back to filename).
+    const prompts = new Map();
+    for (const [key, content] of Object.entries(assets)) {
+        const m = key.match(PROMPT_FILE);
+        if (!m)
+            continue;
+        const front = parseFrontmatter(content);
+        const name = front.name ?? m[1];
+        prompts.set(name, {
+            description: front.description ?? '',
+            body: front.body
+        });
+    }
+    const server = new Server({ name: 'codesign', version: opts.buildId ?? 'dev' }, {
+        capabilities: { resources: {}, prompts: {}, tools: {} },
+        instructions
+    });
+    // `resources/list` advertises only the per-skill SKILL.md (the entry
+    // point), not the 392 nested cesdk-guide files. Sub-files stay readable
+    // via `resources/read` against any cached URI, but skill content discovery
+    // happens through the codesign_read_* tools — those are the universal
+    // surface across MCP hosts.
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: Array.from(rewrittenContent.keys())
+            .filter((uri) => uri.endsWith('/SKILL.md'))
+            .map((uri) => ({
+            uri,
+            mimeType: 'text/markdown',
+            name: uri.replace(`${scheme}://`, '')
+        }))
+    }));
+    server.setRequestHandler(ReadResourceRequestSchema, async (req) => {
+        const text = rewrittenContent.get(req.params.uri);
+        if (text === undefined) {
+            throw new McpError(ErrorCode.InvalidParams, `Unknown resource: ${req.params.uri}`);
+        }
+        return {
+            contents: [{ uri: req.params.uri, mimeType: 'text/markdown', text }]
+        };
+    });
+    server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+        prompts: Array.from(prompts.entries()).map(([name, p]) => ({
+            name,
+            description: p.description
+        }))
+    }));
+    server.setRequestHandler(GetPromptRequestSchema, async (req) => {
+        const p = prompts.get(req.params.name);
+        if (!p) {
+            throw new McpError(ErrorCode.InvalidParams, `Unknown prompt: ${req.params.name}`);
+        }
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: { type: 'text', text: p.body }
+                }
+            ]
+        };
+    });
+    // Tools registered with the server: caller-supplied design tools + the
+    // auto-generated skill-read tools (one per skill in the asset bundle).
+    // The skill tools always come first so Level 1 wording in the design tool
+    // descriptions ("call codesign_read_codesign_system first") points at
+    // something the model already sees in tools/list.
+    const tools = new Map();
+    for (const t of buildSkillReadTools(assets))
+        tools.set(t.name, t);
+    for (const t of opts.tools ?? [])
+        tools.set(t.name, t);
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: Array.from(tools.values()).map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema
+        }))
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const t = tools.get(req.params.name);
+        if (!t) {
+            throw new McpError(ErrorCode.InvalidParams, `Unknown tool: ${req.params.name}`);
+        }
+        // No recorder → byte-for-byte the original behaviour (the off-switch).
+        if (!opts.metrics)
+            return await t.call(req.params.arguments ?? {});
+        const startedAt = performance.now();
+        let ok = true;
+        try {
+            const res = await t.call(req.params.arguments ?? {});
+            ok = res.isError !== true;
+            return res;
+        }
+        catch (err) {
+            ok = false;
+            throw err;
+        }
+        finally {
+            opts.metrics.record({
+                tool: req.params.name,
+                durationMs: performance.now() - startedAt,
+                ok
+            });
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +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"]}

package/dist/skill-tools.d.ts

@@ -0,0 +1,3 @@
+import type { CodesignMcpToolRegistration } from './server.js';
+export declare function buildSkillReadTools(assets: Record<string, string>): CodesignMcpToolRegistration[];
+//# sourceMappingURL=skill-tools.d.ts.map

package/dist/skill-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tools.d.ts","sourceRoot":"","sources":["../src/skill-tools.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAiH/D,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,2BAA2B,EAAE,CAU/B"}

package/dist/skill-tools.js

@@ -0,0 +1,105 @@
+// Build doc-read tools from the codesign asset bundle. One tool per doc dir
+// under `docs/`, named after the dir (handbook / api / guide). The tool's
+// description is bespoke per doc so the model sees it in tools/list with a
+// clear "when to use" hint.
+//
+// Path resolution: each tool defaults to returning the doc's SKILL.md body
+// (the entry point). Pass `path` to read a sub-file relative to the doc dir
+// (e.g. path="index.d.ts" for api, path="api/BlockAPI.md" for guide). Pass
+// `offset` (skip count) + `limit` to slice large files like api/index.d.ts
+// (~9000 lines).
+const DOC_KEY = /^docs\/([^/]+)\/SKILL\.md$/;
+const DOC_DESCRIPTIONS = {
+    handbook: 'Read this BEFORE your first `edit` call. Contains the Iris design loop ' +
+        '(read-API → edit → preview), the strict `edit` return contract, the typeface ' +
+        'object shape required by setFont, page geometry / font sizes for print-quality PDF ' +
+        'output, the common operations cheatsheet, and the runtime quirks that frequently trip ' +
+        'up first attempts. No args.',
+    api: 'Look up CE.SDK CreativeEngine TypeScript signatures. Defaults to SKILL.md (an overview). ' +
+        'Pass `path: "index.d.ts"` to read the full type definition file (~9000 lines); slice ' +
+        'with `offset` (skip count: offset=10 starts at line 11) and `limit`.',
+    guide: 'Read CE.SDK Vanilla JavaScript reference docs and topic guides. Defaults to SKILL.md ' +
+        '(which lists available sub-paths). Pass `path: "api/BlockAPI.md"`, ' +
+        '`path: "text/custom-fonts.md"`, `path: "fills/..."`, etc. for specific topics.'
+};
+function detectDocs(assets) {
+    const docs = [];
+    for (const key of Object.keys(assets)) {
+        const m = key.match(DOC_KEY);
+        if (!m)
+            continue;
+        const dir = m[1];
+        docs.push({
+            dir,
+            toolName: dir,
+            description: DOC_DESCRIPTIONS[dir] ??
+                `Read the ${dir} doc from the codesign asset bundle.`
+        });
+    }
+    docs.sort((a, b) => a.dir.localeCompare(b.dir));
+    return docs;
+}
+function readDocFile(assets, docDir, args) {
+    const subpath = args.path ?? 'SKILL.md';
+    const key = `docs/${docDir}/${subpath}`;
+    const body = assets[key];
+    if (body === undefined) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: 'text',
+                    text: `not found: ${subpath} in ${docDir}. Read SKILL.md (default path) for an overview of available files.`
+                }
+            ]
+        };
+    }
+    if (typeof args.offset === 'number' || typeof args.limit === 'number') {
+        const lines = body.split('\n');
+        // `offset` is a SKIP count (offset=10 means "drop the first 10 lines,
+        // start at line 11"). `limit` caps how many lines to return.
+        const start = Math.max(0, args.offset ?? 0);
+        const end = args.limit !== undefined ? start + Math.max(0, args.limit) : lines.length;
+        return {
+            content: [{ type: 'text', text: lines.slice(start, end).join('\n') }]
+        };
+    }
+    return { content: [{ type: 'text', text: body }] };
+}
+const READ_INPUT_SCHEMA = {
+    type: 'object',
+    properties: {
+        path: {
+            type: 'string',
+            description: 'Optional sub-path within the skill directory. Defaults to SKILL.md.'
+        },
+        offset: {
+            type: 'integer',
+            minimum: 1,
+            description: '1-based line number to start reading from. Use with `limit` to slice large files.'
+        },
+        limit: {
+            type: 'integer',
+            minimum: 1,
+            description: 'Maximum number of lines to return.'
+        }
+    },
+    additionalProperties: false
+};
+const NO_ARGS_SCHEMA = {
+    type: 'object',
+    properties: {},
+    additionalProperties: false
+};
+export function buildSkillReadTools(assets) {
+    return detectDocs(assets).map((spec) => ({
+        name: spec.toolName,
+        description: spec.description,
+        inputSchema: spec.dir === 'handbook' ? NO_ARGS_SCHEMA : READ_INPUT_SCHEMA,
+        call: async (rawArgs) => {
+            const args = (rawArgs ?? {});
+            return readDocFile(assets, spec.dir, spec.dir === 'handbook' ? {} : args);
+        }
+    }));
+}
+//# sourceMappingURL=skill-tools.js.map

package/dist/skill-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tools.js","sourceRoot":"","sources":["../src/skill-tools.ts"],"names":[],"mappings":"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","sourcesContent":["// Build doc-read tools from the codesign asset bundle. One tool per doc dir\n// under `docs/`, named after the dir (handbook / api / guide). The tool's\n// description is bespoke per doc so the model sees it in tools/list with a\n// clear \"when to use\" hint.\n//\n// Path resolution: each tool defaults to returning the doc's SKILL.md body\n// (the entry point). Pass `path` to read a sub-file relative to the doc dir\n// (e.g. path=\"index.d.ts\" for api, path=\"api/BlockAPI.md\" for guide). Pass\n// `offset` (skip count) + `limit` to slice large files like api/index.d.ts\n// (~9000 lines).\n\nimport type { CodesignMcpToolRegistration } from './server.js';\n\nconst DOC_KEY = /^docs\\/([^/]+)\\/SKILL\\.md$/;\n\ninterface DocSpec {\n  dir: string;\n  toolName: string;\n  description: string;\n}\n\nconst DOC_DESCRIPTIONS: Record<string, string> = {\n  handbook:\n    'Read this BEFORE your first `edit` call. Contains the Iris design loop ' +\n    '(read-API → edit → preview), the strict `edit` return contract, the typeface ' +\n    'object shape required by setFont, page geometry / font sizes for print-quality PDF ' +\n    'output, the common operations cheatsheet, and the runtime quirks that frequently trip ' +\n    'up first attempts. No args.',\n  api:\n    'Look up CE.SDK CreativeEngine TypeScript signatures. Defaults to SKILL.md (an overview). ' +\n    'Pass `path: \"index.d.ts\"` to read the full type definition file (~9000 lines); slice ' +\n    'with `offset` (skip count: offset=10 starts at line 11) and `limit`.',\n  guide:\n    'Read CE.SDK Vanilla JavaScript reference docs and topic guides. Defaults to SKILL.md ' +\n    '(which lists available sub-paths). Pass `path: \"api/BlockAPI.md\"`, ' +\n    '`path: \"text/custom-fonts.md\"`, `path: \"fills/...\"`, etc. for specific topics.'\n};\n\nfunction detectDocs(assets: Record<string, string>): DocSpec[] {\n  const docs: DocSpec[] = [];\n  for (const key of Object.keys(assets)) {\n    const m = key.match(DOC_KEY);\n    if (!m) continue;\n    const dir = m[1];\n    docs.push({\n      dir,\n      toolName: dir,\n      description:\n        DOC_DESCRIPTIONS[dir] ??\n        `Read the ${dir} doc from the codesign asset bundle.`\n    });\n  }\n  docs.sort((a, b) => a.dir.localeCompare(b.dir));\n  return docs;\n}\n\ninterface ReadArgs {\n  path?: string;\n  offset?: number;\n  limit?: number;\n}\n\nfunction readDocFile(\n  assets: Record<string, string>,\n  docDir: string,\n  args: ReadArgs\n): { content: { type: 'text'; text: string }[]; isError?: boolean } {\n  const subpath = args.path ?? 'SKILL.md';\n  const key = `docs/${docDir}/${subpath}`;\n  const body = assets[key];\n  if (body === undefined) {\n    return {\n      isError: true,\n      content: [\n        {\n          type: 'text',\n          text: `not found: ${subpath} in ${docDir}. Read SKILL.md (default path) for an overview of available files.`\n        }\n      ]\n    };\n  }\n  if (typeof args.offset === 'number' || typeof args.limit === 'number') {\n    const lines = body.split('\\n');\n    // `offset` is a SKIP count (offset=10 means \"drop the first 10 lines,\n    // start at line 11\"). `limit` caps how many lines to return.\n    const start = Math.max(0, args.offset ?? 0);\n    const end =\n      args.limit !== undefined ? start + Math.max(0, args.limit) : lines.length;\n    return {\n      content: [{ type: 'text', text: lines.slice(start, end).join('\\n') }]\n    };\n  }\n  return { content: [{ type: 'text', text: body }] };\n}\n\nconst READ_INPUT_SCHEMA = {\n  type: 'object' as const,\n  properties: {\n    path: {\n      type: 'string' as const,\n      description:\n        'Optional sub-path within the skill directory. Defaults to SKILL.md.'\n    },\n    offset: {\n      type: 'integer' as const,\n      minimum: 1,\n      description:\n        '1-based line number to start reading from. Use with `limit` to slice large files.'\n    },\n    limit: {\n      type: 'integer' as const,\n      minimum: 1,\n      description: 'Maximum number of lines to return.'\n    }\n  },\n  additionalProperties: false\n};\n\nconst NO_ARGS_SCHEMA = {\n  type: 'object' as const,\n  properties: {},\n  additionalProperties: false\n};\n\nexport function buildSkillReadTools(\n  assets: Record<string, string>\n): CodesignMcpToolRegistration[] {\n  return detectDocs(assets).map((spec) => ({\n    name: spec.toolName,\n    description: spec.description,\n    inputSchema: spec.dir === 'handbook' ? NO_ARGS_SCHEMA : READ_INPUT_SCHEMA,\n    call: async (rawArgs) => {\n      const args = (rawArgs ?? {}) as ReadArgs;\n      return readDocFile(assets, spec.dir, spec.dir === 'handbook' ? {} : args);\n    }\n  }));\n}\n"]}

package/dist/test/test/cli/dispatcher.test.d.ts

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

package/dist/test/test/cli/dispatcher.test.d.ts.map

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

package/dist/test/test/cli/dispatcher.test.js

@@ -0,0 +1,47 @@
+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');
+function run(args) {
+    const r = spawnSync('node', [CLI, ...args], {
+        encoding: 'utf8',
+        // Don't inherit env — the bare/--help/unknown paths must succeed
+        // regardless of CESDK_LICENSE etc., since they don't actually start a
+        // transport.
+        env: { PATH: process.env.PATH ?? '' },
+        timeout: 5000
+    });
+    return {
+        code: r.status ?? -1,
+        stdout: r.stdout ?? '',
+        stderr: r.stderr ?? ''
+    };
+}
+describe('codesign-mcp dispatcher', () => {
+    it('prints usage and exits 0 for --help', () => {
+        const r = run(['--help']);
+        expect(r.code).toBe(0);
+        expect(r.stdout).toContain('Usage: codesign-mcp');
+        expect(r.stdout).toContain('stdio');
+        expect(r.stdout).toContain('http');
+    });
+    it('prints usage and exits 0 for -h', () => {
+        const r = run(['-h']);
+        expect(r.code).toBe(0);
+        expect(r.stdout).toContain('Usage: codesign-mcp');
+    });
+    it('prints usage to stderr and exits 2 when no subcommand is given', () => {
+        const r = run([]);
+        expect(r.code).toBe(2);
+        expect(r.stderr).toContain('missing subcommand');
+        expect(r.stderr).toContain('Usage: codesign-mcp');
+    });
+    it('rejects unknown subcommand with stderr + exit 2', () => {
+        const r = run(['bogus']);
+        expect(r.code).toBe(2);
+        expect(r.stderr).toContain('unknown subcommand "bogus"');
+    });
+});
+//# sourceMappingURL=dispatcher.test.js.map

package/dist/test/test/cli/dispatcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.test.js","sourceRoot":"","sources":["../../../../test/cli/dispatcher.test.ts"],"names":[],"mappings":"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","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\nfunction run(args: string[]): { code: number; stdout: string; stderr: string } {\n  const r = spawnSync('node', [CLI, ...args], {\n    encoding: 'utf8',\n    // Don't inherit env — the bare/--help/unknown paths must succeed\n    // regardless of CESDK_LICENSE etc., since they don't actually start a\n    // transport.\n    env: { PATH: process.env.PATH ?? '' },\n    timeout: 5000\n  });\n  return {\n    code: r.status ?? -1,\n    stdout: r.stdout ?? '',\n    stderr: r.stderr ?? ''\n  };\n}\n\ndescribe('codesign-mcp dispatcher', () => {\n  it('prints usage and exits 0 for --help', () => {\n    const r = run(['--help']);\n    expect(r.code).toBe(0);\n    expect(r.stdout).toContain('Usage: codesign-mcp');\n    expect(r.stdout).toContain('stdio');\n    expect(r.stdout).toContain('http');\n  });\n\n  it('prints usage and exits 0 for -h', () => {\n    const r = run(['-h']);\n    expect(r.code).toBe(0);\n    expect(r.stdout).toContain('Usage: codesign-mcp');\n  });\n\n  it('prints usage to stderr and exits 2 when no subcommand is given', () => {\n    const r = run([]);\n    expect(r.code).toBe(2);\n    expect(r.stderr).toContain('missing subcommand');\n    expect(r.stderr).toContain('Usage: codesign-mcp');\n  });\n\n  it('rejects unknown subcommand with stderr + exit 2', () => {\n    const r = run(['bogus']);\n    expect(r.code).toBe(2);\n    expect(r.stderr).toContain('unknown subcommand \"bogus\"');\n  });\n});\n"]}

package/dist/test/test/cross-ref.test.d.ts

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

package/dist/test/test/cross-ref.test.d.ts.map

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

package/dist/test/test/cross-ref.test.js

@@ -0,0 +1,39 @@
+import { describe, expect, it } from 'vitest';
+import { rewriteSkillLinks } from '../src/cross-ref.js';
+describe('rewriteSkillLinks', () => {
+    const skill = 'guide';
+    const scheme = 'codesign';
+    it('rewrites bare relative .md path in markdown link', () => {
+        const out = rewriteSkillLinks('[a](animation.md)', skill, scheme);
+        expect(out).toBe('[a](codesign://docs/guide/animation.md)');
+    });
+    it('rewrites ./-prefixed relative path', () => {
+        const out = rewriteSkillLinks('[a](./animation.md)', skill, scheme);
+        expect(out).toBe('[a](codesign://docs/guide/animation.md)');
+    });
+    it('rewrites subdirectory path', () => {
+        const out = rewriteSkillLinks('[a](api/types.md)', skill, scheme);
+        expect(out).toBe('[a](codesign://docs/guide/api/types.md)');
+    });
+    it('leaves absolute URLs untouched', () => {
+        const out = rewriteSkillLinks('[a](https://x.test/y)', skill, scheme);
+        expect(out).toBe('[a](https://x.test/y)');
+    });
+    it('leaves anchors untouched', () => {
+        const out = rewriteSkillLinks('[a](#section)', skill, scheme);
+        expect(out).toBe('[a](#section)');
+    });
+    it('leaves paths that escape the skill dir untouched', () => {
+        const out = rewriteSkillLinks('[a](../other-skill/x.md)', skill, scheme);
+        expect(out).toBe('[a](../other-skill/x.md)');
+    });
+    it('leaves absolute paths untouched', () => {
+        const out = rewriteSkillLinks('[a](/abs/path.md)', skill, scheme);
+        expect(out).toBe('[a](/abs/path.md)');
+    });
+    it('rewrites multiple links in one body', () => {
+        const out = rewriteSkillLinks('see [a](a.md) and [b](b.md)', skill, scheme);
+        expect(out).toBe('see [a](codesign://docs/guide/a.md) and [b](codesign://docs/guide/b.md)');
+    });
+});
+//# sourceMappingURL=cross-ref.test.js.map

package/dist/test/test/cross-ref.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-ref.test.js","sourceRoot":"","sources":["../../../test/cross-ref.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,MAAM,KAAK,GAAG,OAAO,CAAC;IACtB,MAAM,MAAM,GAAG,UAAU,CAAC;IAE1B,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,iBAAiB,CAAC,mBAAmB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAG,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACpE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,GAAG,GAAG,iBAAiB,CAAC,mBAAmB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,GAAG,GAAG,iBAAiB,CAAC,uBAAuB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACtE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,GAAG,GAAG,iBAAiB,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,GAAG,iBAAiB,CAAC,mBAAmB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,GAAG,GAAG,iBAAiB,CAAC,6BAA6B,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC5E,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CACd,yEAAyE,CAC1E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { rewriteSkillLinks } from '../src/cross-ref.js';\n\ndescribe('rewriteSkillLinks', () => {\n  const skill = 'guide';\n  const scheme = 'codesign';\n\n  it('rewrites bare relative .md path in markdown link', () => {\n    const out = rewriteSkillLinks('[a](animation.md)', skill, scheme);\n    expect(out).toBe('[a](codesign://docs/guide/animation.md)');\n  });\n\n  it('rewrites ./-prefixed relative path', () => {\n    const out = rewriteSkillLinks('[a](./animation.md)', skill, scheme);\n    expect(out).toBe('[a](codesign://docs/guide/animation.md)');\n  });\n\n  it('rewrites subdirectory path', () => {\n    const out = rewriteSkillLinks('[a](api/types.md)', skill, scheme);\n    expect(out).toBe('[a](codesign://docs/guide/api/types.md)');\n  });\n\n  it('leaves absolute URLs untouched', () => {\n    const out = rewriteSkillLinks('[a](https://x.test/y)', skill, scheme);\n    expect(out).toBe('[a](https://x.test/y)');\n  });\n\n  it('leaves anchors untouched', () => {\n    const out = rewriteSkillLinks('[a](#section)', skill, scheme);\n    expect(out).toBe('[a](#section)');\n  });\n\n  it('leaves paths that escape the skill dir untouched', () => {\n    const out = rewriteSkillLinks('[a](../other-skill/x.md)', skill, scheme);\n    expect(out).toBe('[a](../other-skill/x.md)');\n  });\n\n  it('leaves absolute paths untouched', () => {\n    const out = rewriteSkillLinks('[a](/abs/path.md)', skill, scheme);\n    expect(out).toBe('[a](/abs/path.md)');\n  });\n\n  it('rewrites multiple links in one body', () => {\n    const out = rewriteSkillLinks('see [a](a.md) and [b](b.md)', skill, scheme);\n    expect(out).toBe(\n      'see [a](codesign://docs/guide/a.md) and [b](codesign://docs/guide/b.md)'\n    );\n  });\n});\n"]}

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

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

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

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