@imgly/codesign-mcp 0.1.0

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

@@ -0,0 +1,144 @@
+import { describe, expect, it, vi } from 'vitest';
+import { EngineSession } from '../../src/engine/session.js';
+function makeFakeEngine(scene = 'INITIAL') {
+    const engine = { _scene: scene };
+    const adapter = {
+        create: () => engine,
+        reset: vi.fn(async () => {
+            engine._scene = 'RESET';
+        }),
+        loadFromString: vi.fn(async (eng, s) => {
+            eng._scene = s;
+        }),
+        saveToString: vi.fn(async (eng) => eng._scene)
+    };
+    return { engine, adapter };
+}
+describe('EngineSession (single slot)', () => {
+    it('acquire(parent=null) resets the engine and sets currentRevision=null', async () => {
+        const { adapter } = makeFakeEngine();
+        const session = new EngineSession({ size: 1, adapter });
+        const slot = await session.acquire(null);
+        expect(adapter.reset).toHaveBeenCalledOnce();
+        expect(slot.currentRevision).toBeNull();
+    });
+    it('acquire(parent=X) loads scene X when slot currentRevision is different', async () => {
+        const { adapter } = makeFakeEngine();
+        const session = new EngineSession({ size: 1, adapter });
+        await session.populate('rev_abc', 'SCENE_ABC'); // pre-stage the loadable scene
+        const slot = await session.acquire('rev_abc');
+        expect(adapter.loadFromString).toHaveBeenCalledWith(slot.engine, 'SCENE_ABC');
+        expect(slot.currentRevision).toBe('rev_abc');
+    });
+    it('acquire(parent=X) is a no-op when slot.currentRevision === X (linear edit)', async () => {
+        const { adapter } = makeFakeEngine();
+        const session = new EngineSession({ size: 1, adapter });
+        await session.populate('rev_abc', 'SCENE_ABC');
+        await session.acquire('rev_abc');
+        adapter.loadFromString.mockClear();
+        const slot2 = await session.acquire('rev_abc');
+        expect(adapter.loadFromString).not.toHaveBeenCalled();
+        expect(slot2.currentRevision).toBe('rev_abc');
+    });
+    it('commit(slot, newRev) updates currentRevision (linear edit succeeded)', async () => {
+        const { adapter } = makeFakeEngine();
+        const session = new EngineSession({ size: 1, adapter });
+        const slot = await session.acquire(null);
+        session.commit(slot, 'rev_new');
+        expect(slot.currentRevision).toBe('rev_new');
+    });
+    it('markDirty(slot) sets currentRevision=null (failed edit forces reload next time)', async () => {
+        const { adapter } = makeFakeEngine();
+        const session = new EngineSession({ size: 1, adapter });
+        await session.populate('rev_abc', 'SCENE_ABC');
+        const slot = await session.acquire('rev_abc');
+        session.markDirty(slot);
+        expect(slot.currentRevision).toBeNull();
+        // next acquire even of the SAME parent must reload
+        await session.populate('rev_abc', 'SCENE_ABC');
+        const slot2 = await session.acquire('rev_abc');
+        expect(adapter.loadFromString).toHaveBeenCalledTimes(2);
+        expect(slot2.currentRevision).toBe('rev_abc');
+    });
+});
+describe('EngineSession (multi-slot sticky routing)', () => {
+    function makeAdapterWithCounter() {
+        let id = 0;
+        const counters = { creates: 0 };
+        const adapter = {
+            create: () => {
+                counters.creates++;
+                return { _id: id++, _scene: 'INITIAL' };
+            },
+            reset: async (eng) => {
+                eng._scene = 'RESET';
+            },
+            loadFromString: async (eng, s) => {
+                eng._scene = s;
+            },
+            saveToString: async (eng) => eng._scene
+        };
+        return { adapter, createCount: () => counters.creates };
+    }
+    it('returns warm slot whose currentRevision matches the requested parent', async () => {
+        const { adapter, createCount } = makeAdapterWithCounter();
+        const session = new EngineSession({ size: 2, adapter });
+        await session.populate('rev_A', 'SCENE_A');
+        const slotA = await session.acquire('rev_A');
+        session.commit(slotA, 'rev_A2');
+        await session.populate('rev_B', 'SCENE_B');
+        const slotB = await session.acquire('rev_B');
+        session.commit(slotB, 'rev_B2');
+        expect(createCount()).toBe(2);
+        // Sticky: re-acquire rev_A2 → reuse slotA, no new create, no reload.
+        const reuse = await session.acquire('rev_A2');
+        expect(reuse.engine).toBe(slotA.engine);
+        expect(createCount()).toBe(2);
+    });
+    it('evicts a dirty slot before a warm slot when over cap', async () => {
+        const { adapter } = makeAdapterWithCounter();
+        const session = new EngineSession({ size: 1, adapter });
+        const slot1 = await session.acquire(null);
+        session.commit(slot1, 'rev_X');
+        session.markDirty(slot1);
+        await session.populate('rev_Y', 'SCENE_Y');
+        const slot2 = await session.acquire('rev_Y');
+        expect(slot2).toBe(slot1); // reused
+        expect(slot2.currentRevision).toBe('rev_Y');
+    });
+});
+describe('EngineSession.currentSlot', () => {
+    it('returns undefined when no slot is warm', () => {
+        const { adapter } = (function makeFakeEngine() {
+            const engine = { _scene: 'INITIAL' };
+            const adapter = {
+                create: () => engine,
+                reset: vi.fn(async () => {
+                    engine._scene = 'RESET';
+                }),
+                loadFromString: vi.fn(async () => { }),
+                saveToString: vi.fn(async () => engine._scene)
+            };
+            return { adapter };
+        })();
+        const session = new EngineSession({ size: 1, adapter });
+        expect(session.currentSlot()).toBeUndefined();
+    });
+    it('returns the slot once it has been committed to a revision', async () => {
+        const engine = { _scene: 'INITIAL' };
+        const adapter = {
+            create: () => engine,
+            reset: vi.fn(async () => {
+                engine._scene = 'RESET';
+            }),
+            loadFromString: vi.fn(async () => { }),
+            saveToString: vi.fn(async () => engine._scene)
+        };
+        const session = new EngineSession({ size: 1, adapter });
+        const slot = await session.acquire(null);
+        expect(session.currentSlot()).toBeUndefined(); // currentRevision is null after acquire(null)
+        session.commit(slot, 'rev_X');
+        expect(session.currentSlot()).toBe(slot);
+    });
+});
+//# sourceMappingURL=session.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.test.js","sourceRoot":"","sources":["../../../../test/engine/session.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from 'vitest';\nimport { type EngineAdapter, EngineSession } from '../../src/engine/session.js';\n\nfunction makeFakeEngine(scene = 'INITIAL'): {\n  engine: { _scene: string };\n  adapter: EngineAdapter;\n} {\n  const engine = { _scene: scene };\n  const adapter: EngineAdapter = {\n    create: () => engine,\n    reset: vi.fn(async () => {\n      engine._scene = 'RESET';\n    }),\n    loadFromString: vi.fn(async (eng, s) => {\n      (eng as typeof engine)._scene = s;\n    }),\n    saveToString: vi.fn(async (eng) => (eng as typeof engine)._scene)\n  };\n  return { engine, adapter };\n}\n\ndescribe('EngineSession (single slot)', () => {\n  it('acquire(parent=null) resets the engine and sets currentRevision=null', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    const slot = await session.acquire(null);\n    expect(adapter.reset).toHaveBeenCalledOnce();\n    expect(slot.currentRevision).toBeNull();\n  });\n\n  it('acquire(parent=X) loads scene X when slot currentRevision is different', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    await session.populate('rev_abc', 'SCENE_ABC'); // pre-stage the loadable scene\n    const slot = await session.acquire('rev_abc');\n    expect(adapter.loadFromString).toHaveBeenCalledWith(\n      slot.engine,\n      'SCENE_ABC'\n    );\n    expect(slot.currentRevision).toBe('rev_abc');\n  });\n\n  it('acquire(parent=X) is a no-op when slot.currentRevision === X (linear edit)', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    await session.populate('rev_abc', 'SCENE_ABC');\n    await session.acquire('rev_abc');\n    (adapter.loadFromString as ReturnType<typeof vi.fn>).mockClear();\n    const slot2 = await session.acquire('rev_abc');\n    expect(adapter.loadFromString).not.toHaveBeenCalled();\n    expect(slot2.currentRevision).toBe('rev_abc');\n  });\n\n  it('commit(slot, newRev) updates currentRevision (linear edit succeeded)', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    const slot = await session.acquire(null);\n    session.commit(slot, 'rev_new');\n    expect(slot.currentRevision).toBe('rev_new');\n  });\n\n  it('markDirty(slot) sets currentRevision=null (failed edit forces reload next time)', async () => {\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    await session.populate('rev_abc', 'SCENE_ABC');\n    const slot = await session.acquire('rev_abc');\n    session.markDirty(slot);\n    expect(slot.currentRevision).toBeNull();\n    // next acquire even of the SAME parent must reload\n    await session.populate('rev_abc', 'SCENE_ABC');\n    const slot2 = await session.acquire('rev_abc');\n    expect(adapter.loadFromString).toHaveBeenCalledTimes(2);\n    expect(slot2.currentRevision).toBe('rev_abc');\n  });\n});\n\ndescribe('EngineSession (multi-slot sticky routing)', () => {\n  function makeAdapterWithCounter(): {\n    adapter: EngineAdapter;\n    createCount: () => number;\n  } {\n    let id = 0;\n    const counters = { creates: 0 };\n    const adapter: EngineAdapter = {\n      create: () => {\n        counters.creates++;\n        return { _id: id++, _scene: 'INITIAL' };\n      },\n      reset: async (eng) => {\n        (eng as { _scene: string })._scene = 'RESET';\n      },\n      loadFromString: async (eng, s) => {\n        (eng as { _scene: string })._scene = s;\n      },\n      saveToString: async (eng) => (eng as { _scene: string })._scene\n    };\n    return { adapter, createCount: () => counters.creates };\n  }\n\n  it('returns warm slot whose currentRevision matches the requested parent', async () => {\n    const { adapter, createCount } = makeAdapterWithCounter();\n    const session = new EngineSession({ size: 2, adapter });\n    await session.populate('rev_A', 'SCENE_A');\n    const slotA = await session.acquire('rev_A');\n    session.commit(slotA, 'rev_A2');\n    await session.populate('rev_B', 'SCENE_B');\n    const slotB = await session.acquire('rev_B');\n    session.commit(slotB, 'rev_B2');\n\n    expect(createCount()).toBe(2);\n    // Sticky: re-acquire rev_A2 → reuse slotA, no new create, no reload.\n    const reuse = await session.acquire('rev_A2');\n    expect(reuse.engine).toBe(slotA.engine);\n    expect(createCount()).toBe(2);\n  });\n\n  it('evicts a dirty slot before a warm slot when over cap', async () => {\n    const { adapter } = makeAdapterWithCounter();\n    const session = new EngineSession({ size: 1, adapter });\n    const slot1 = await session.acquire(null);\n    session.commit(slot1, 'rev_X');\n    session.markDirty(slot1);\n    await session.populate('rev_Y', 'SCENE_Y');\n    const slot2 = await session.acquire('rev_Y');\n    expect(slot2).toBe(slot1); // reused\n    expect(slot2.currentRevision).toBe('rev_Y');\n  });\n});\n\ndescribe('EngineSession.currentSlot', () => {\n  it('returns undefined when no slot is warm', () => {\n    const { adapter } = (function makeFakeEngine() {\n      const engine = { _scene: 'INITIAL' };\n      const adapter: EngineAdapter = {\n        create: () => engine,\n        reset: vi.fn(async () => {\n          engine._scene = 'RESET';\n        }),\n        loadFromString: vi.fn(async () => {}),\n        saveToString: vi.fn(async () => engine._scene)\n      };\n      return { adapter };\n    })();\n    const session = new EngineSession({ size: 1, adapter });\n    expect(session.currentSlot()).toBeUndefined();\n  });\n\n  it('returns the slot once it has been committed to a revision', async () => {\n    const engine = { _scene: 'INITIAL' };\n    const adapter: EngineAdapter = {\n      create: () => engine,\n      reset: vi.fn(async () => {\n        engine._scene = 'RESET';\n      }),\n      loadFromString: vi.fn(async () => {}),\n      saveToString: vi.fn(async () => engine._scene)\n    };\n    const session = new EngineSession({ size: 1, adapter });\n    const slot = await session.acquire(null);\n    expect(session.currentSlot()).toBeUndefined(); // currentRevision is null after acquire(null)\n    session.commit(slot, 'rev_X');\n    expect(session.currentSlot()).toBe(slot);\n  });\n});\n"]}

package/dist/test/test/engine/uri-resolver.test.d.ts

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

package/dist/test/test/engine/uri-resolver.test.d.ts.map

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

package/dist/test/test/engine/uri-resolver.test.js

@@ -0,0 +1,38 @@
+import { describe, expect, it } from 'vitest';
+import { registerWorkspaceUriResolver } from '../../src/engine/uri-resolver.js';
+import { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';
+function captureResolver() {
+    let resolver;
+    const engine = {
+        editor: {
+            setURIResolver: (fn) => {
+                resolver = fn;
+            }
+        }
+    };
+    return {
+        engine,
+        invoke: (uri) => {
+            if (!resolver)
+                throw new Error('resolver was not registered');
+            return resolver(uri, (u) => `DEFAULT:${u}`);
+        }
+    };
+}
+describe('registerWorkspaceUriResolver', () => {
+    const urlBuilder = new LocalViewerUrlBuilder({
+        base: 'http://127.0.0.1:8745'
+    });
+    it('rewrites a workspace:// URI to the /r/ route', () => {
+        const { engine, invoke } = captureResolver();
+        registerWorkspaceUriResolver(engine, urlBuilder);
+        expect(invoke('workspace://assets/9f2a1c.png')).toBe('http://127.0.0.1:8745/r/assets/9f2a1c.png');
+    });
+    it('delegates non-workspace URIs to the default resolver', () => {
+        const { engine, invoke } = captureResolver();
+        registerWorkspaceUriResolver(engine, urlBuilder);
+        expect(invoke('https://cdn.img.ly/fonts/Roboto.ttf')).toBe('DEFAULT:https://cdn.img.ly/fonts/Roboto.ttf');
+        expect(invoke('/relative/path.png')).toBe('DEFAULT:/relative/path.png');
+    });
+});
+//# sourceMappingURL=uri-resolver.test.js.map

package/dist/test/test/engine/uri-resolver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-resolver.test.js","sourceRoot":"","sources":["../../../../test/engine/uri-resolver.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,4BAA4B,EAE7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,SAAS,eAAe;IACtB,IAAI,QAES,CAAC;IACd,MAAM,MAAM,GAAwB;QAClC,MAAM,EAAE;YACN,cAAc,EAAE,CAAC,EAAE,EAAE,EAAE;gBACrB,QAAQ,GAAG,EAAE,CAAC;YAChB,CAAC;SACF;KACF,CAAC;IACF,OAAO;QACL,MAAM;QACN,MAAM,EAAE,CAAC,GAAW,EAAE,EAAE;YACtB,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC9D,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,MAAM,UAAU,GAAG,IAAI,qBAAqB,CAAC;QAC3C,IAAI,EAAE,uBAAuB;KAC9B,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;QAC7C,4BAA4B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC,IAAI,CAClD,2CAA2C,CAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,CAAC;QAC7C,4BAA4B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC,CAAC,IAAI,CACxD,6CAA6C,CAC9C,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport {\n  registerWorkspaceUriResolver,\n  type UriResolvableEngine\n} from '../../src/engine/uri-resolver.js';\nimport { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';\n\nfunction captureResolver() {\n  let resolver:\n    | ((uri: string, def: (u: string) => string) => string)\n    | undefined;\n  const engine: UriResolvableEngine = {\n    editor: {\n      setURIResolver: (fn) => {\n        resolver = fn;\n      }\n    }\n  };\n  return {\n    engine,\n    invoke: (uri: string) => {\n      if (!resolver) throw new Error('resolver was not registered');\n      return resolver(uri, (u) => `DEFAULT:${u}`);\n    }\n  };\n}\n\ndescribe('registerWorkspaceUriResolver', () => {\n  const urlBuilder = new LocalViewerUrlBuilder({\n    base: 'http://127.0.0.1:8745'\n  });\n\n  it('rewrites a workspace:// URI to the /r/ route', () => {\n    const { engine, invoke } = captureResolver();\n    registerWorkspaceUriResolver(engine, urlBuilder);\n    expect(invoke('workspace://assets/9f2a1c.png')).toBe(\n      'http://127.0.0.1:8745/r/assets/9f2a1c.png'\n    );\n  });\n\n  it('delegates non-workspace URIs to the default resolver', () => {\n    const { engine, invoke } = captureResolver();\n    registerWorkspaceUriResolver(engine, urlBuilder);\n    expect(invoke('https://cdn.img.ly/fonts/Roboto.ttf')).toBe(\n      'DEFAULT:https://cdn.img.ly/fonts/Roboto.ttf'\n    );\n    expect(invoke('/relative/path.png')).toBe('DEFAULT:/relative/path.png');\n  });\n});\n"]}

package/dist/test/test/frontmatter.test.d.ts

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

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

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

package/dist/test/test/frontmatter.test.js

@@ -0,0 +1,55 @@
+import { describe, expect, it } from 'vitest';
+import { parseFrontmatter } from '../src/frontmatter.js';
+describe('parseFrontmatter', () => {
+    it('extracts name and description and returns body without the fence', () => {
+        const input = [
+            '---',
+            'name: cesdk-guide',
+            'description: Authoring guide for ce.sdk.',
+            '---',
+            '# Body',
+            'Hello.',
+            ''
+        ].join('\n');
+        const result = parseFrontmatter(input);
+        expect(result.name).toBe('cesdk-guide');
+        expect(result.description).toBe('Authoring guide for ce.sdk.');
+        expect(result.body).toBe('# Body\nHello.\n');
+    });
+    it('returns body unchanged when no frontmatter is present', () => {
+        const input = 'no fence here';
+        const result = parseFrontmatter(input);
+        expect(result.name).toBeUndefined();
+        expect(result.description).toBeUndefined();
+        expect(result.body).toBe('no fence here');
+    });
+    it('tolerates colons in description values', () => {
+        const input = '---\nname: x\ndescription: do A: then B\n---\nbody';
+        expect(parseFrontmatter(input).description).toBe('do A: then B');
+    });
+    it('trims surrounding whitespace from name+description but keeps body intact', () => {
+        const input = '---\nname:   foo\t\ndescription:  bar baz\n---\nline1\nline2\n';
+        const r = parseFrontmatter(input);
+        expect(r.name).toBe('foo');
+        expect(r.description).toBe('bar baz');
+        expect(r.body).toBe('line1\nline2\n');
+    });
+    it('collects YAML pipe block scalars (description: |) into a single line', () => {
+        const input = [
+            '---',
+            'name: skill',
+            'description: |',
+            '  First paragraph line.',
+            '  Second paragraph line.',
+            '',
+            '  After a blank.',
+            '---',
+            'body'
+        ].join('\n');
+        const r = parseFrontmatter(input);
+        expect(r.name).toBe('skill');
+        expect(r.description).toBe('First paragraph line. Second paragraph line. After a blank.');
+        expect(r.body).toBe('body');
+    });
+});
+//# sourceMappingURL=frontmatter.test.js.map

package/dist/test/test/frontmatter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.test.js","sourceRoot":"","sources":["../../../test/frontmatter.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,KAAK,GAAG;YACZ,KAAK;YACL,mBAAmB;YACnB,0CAA0C;YAC1C,KAAK;YACL,QAAQ;YACR,QAAQ;YACR,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,KAAK,GAAG,eAAe,CAAC;QAC9B,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,aAAa,EAAE,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,KAAK,GAAG,oDAAoD,CAAC;QACnE,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,KAAK,GACT,gEAAgE,CAAC;QACnE,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,KAAK,GAAG;YACZ,KAAK;YACL,aAAa;YACb,gBAAgB;YAChB,yBAAyB;YACzB,0BAA0B;YAC1B,EAAE;YACF,kBAAkB;YAClB,KAAK;YACL,MAAM;SACP,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CACxB,6DAA6D,CAC9D,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { parseFrontmatter } from '../src/frontmatter.js';\n\ndescribe('parseFrontmatter', () => {\n  it('extracts name and description and returns body without the fence', () => {\n    const input = [\n      '---',\n      'name: cesdk-guide',\n      'description: Authoring guide for ce.sdk.',\n      '---',\n      '# Body',\n      'Hello.',\n      ''\n    ].join('\\n');\n    const result = parseFrontmatter(input);\n    expect(result.name).toBe('cesdk-guide');\n    expect(result.description).toBe('Authoring guide for ce.sdk.');\n    expect(result.body).toBe('# Body\\nHello.\\n');\n  });\n\n  it('returns body unchanged when no frontmatter is present', () => {\n    const input = 'no fence here';\n    const result = parseFrontmatter(input);\n    expect(result.name).toBeUndefined();\n    expect(result.description).toBeUndefined();\n    expect(result.body).toBe('no fence here');\n  });\n\n  it('tolerates colons in description values', () => {\n    const input = '---\\nname: x\\ndescription: do A: then B\\n---\\nbody';\n    expect(parseFrontmatter(input).description).toBe('do A: then B');\n  });\n\n  it('trims surrounding whitespace from name+description but keeps body intact', () => {\n    const input =\n      '---\\nname:   foo\\t\\ndescription:  bar baz\\n---\\nline1\\nline2\\n';\n    const r = parseFrontmatter(input);\n    expect(r.name).toBe('foo');\n    expect(r.description).toBe('bar baz');\n    expect(r.body).toBe('line1\\nline2\\n');\n  });\n\n  it('collects YAML pipe block scalars (description: |) into a single line', () => {\n    const input = [\n      '---',\n      'name: skill',\n      'description: |',\n      '  First paragraph line.',\n      '  Second paragraph line.',\n      '',\n      '  After a blank.',\n      '---',\n      'body'\n    ].join('\\n');\n    const r = parseFrontmatter(input);\n    expect(r.name).toBe('skill');\n    expect(r.description).toBe(\n      'First paragraph line. Second paragraph line. After a blank.'\n    );\n    expect(r.body).toBe('body');\n  });\n});\n"]}

package/dist/test/test/gateway/hosted-stub.test.d.ts

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

package/dist/test/test/gateway/hosted-stub.test.d.ts.map

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

package/dist/test/test/gateway/hosted-stub.test.js

@@ -0,0 +1,11 @@
+import { describe, expect, it } from 'vitest';
+import { HostedStubGatewayClient } from '../../src/gateway/hosted-stub.js';
+describe('HostedStubGatewayClient', () => {
+    it('throws not-implemented for Phase 1', async () => {
+        const client = new HostedStubGatewayClient();
+        await expect(client.generateImage({ prompt: 'x' })).rejects.toMatchObject({
+            message: expect.stringContaining('Phase 2')
+        });
+    });
+});
+//# sourceMappingURL=hosted-stub.test.js.map

package/dist/test/test/gateway/hosted-stub.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-stub.test.js","sourceRoot":"","sources":["../../../../test/gateway/hosted-stub.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;YACxE,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { HostedStubGatewayClient } from '../../src/gateway/hosted-stub.js';\n\ndescribe('HostedStubGatewayClient', () => {\n  it('throws not-implemented for Phase 1', async () => {\n    const client = new HostedStubGatewayClient();\n    await expect(client.generateImage({ prompt: 'x' })).rejects.toMatchObject({\n      message: expect.stringContaining('Phase 2')\n    });\n  });\n});\n"]}

package/dist/test/test/gateway/local.test.d.ts

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

package/dist/test/test/gateway/local.test.d.ts.map

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

package/dist/test/test/gateway/local.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from 'vitest';
+import { LocalGatewayClient } from '../../src/gateway/local.js';
+describe('LocalGatewayClient', () => {
+    it('throws GatewayDisabledError when no API_KEY is configured', async () => {
+        const client = new LocalGatewayClient({ apiKey: undefined });
+        await expect(client.generateImage({ prompt: 'a cat' })).rejects.toMatchObject({ name: 'GatewayDisabledError' });
+    });
+    it('calls the configured endpoint with the API key and returns bytes', async () => {
+        const fetch = async (url, init) => {
+            const headers = init?.headers;
+            expect(url).toBe('https://gateway.example/v1/images/generate');
+            expect(headers.Authorization).toBe('Bearer test-key');
+            const body = JSON.parse(init?.body);
+            expect(body).toMatchObject({ prompt: 'a cat' });
+            return new Response(new Uint8Array([1, 2, 3, 4]), {
+                headers: { 'content-type': 'image/png' }
+            });
+        };
+        const client = new LocalGatewayClient({
+            apiKey: 'test-key',
+            endpoint: 'https://gateway.example/v1/images/generate',
+            fetch: fetch
+        });
+        const out = await client.generateImage({ prompt: 'a cat' });
+        expect(out.mimeType).toBe('image/png');
+        expect(Array.from(out.bytes)).toEqual([1, 2, 3, 4]);
+    });
+});
+//# sourceMappingURL=local.test.js.map

package/dist/test/test/gateway/local.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.test.js","sourceRoot":"","sources":["../../../../test/gateway/local.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,MAAM,MAAM,CACV,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAC1C,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,KAAK,GAAG,KAAK,EAAE,GAAW,EAAE,IAAkB,EAAE,EAAE;YACtD,MAAM,OAAO,GAAG,IAAI,EAAE,OAAiC,CAAC;YACxD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAC/D,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAc,CAAC,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAChD,OAAO,IAAI,QAAQ,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;gBAChD,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE;aACzC,CAAC,CAAC;QACL,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC;YACpC,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,4CAA4C;YACtD,KAAK,EAAE,KAAgC;SACxC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { LocalGatewayClient } from '../../src/gateway/local.js';\n\ndescribe('LocalGatewayClient', () => {\n  it('throws GatewayDisabledError when no API_KEY is configured', async () => {\n    const client = new LocalGatewayClient({ apiKey: undefined });\n    await expect(\n      client.generateImage({ prompt: 'a cat' })\n    ).rejects.toMatchObject({ name: 'GatewayDisabledError' });\n  });\n\n  it('calls the configured endpoint with the API key and returns bytes', async () => {\n    const fetch = async (url: string, init?: RequestInit) => {\n      const headers = init?.headers as Record<string, string>;\n      expect(url).toBe('https://gateway.example/v1/images/generate');\n      expect(headers.Authorization).toBe('Bearer test-key');\n      const body = JSON.parse(init?.body as string);\n      expect(body).toMatchObject({ prompt: 'a cat' });\n      return new Response(new Uint8Array([1, 2, 3, 4]), {\n        headers: { 'content-type': 'image/png' }\n      });\n    };\n    const client = new LocalGatewayClient({\n      apiKey: 'test-key',\n      endpoint: 'https://gateway.example/v1/images/generate',\n      fetch: fetch as typeof globalThis.fetch\n    });\n    const out = await client.generateImage({ prompt: 'a cat' });\n    expect(out.mimeType).toBe('image/png');\n    expect(Array.from(out.bytes)).toEqual([1, 2, 3, 4]);\n  });\n});\n"]}

package/dist/test/test/handbook-contract.test.d.ts

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

package/dist/test/test/handbook-contract.test.d.ts.map

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

package/dist/test/test/handbook-contract.test.js

@@ -0,0 +1,71 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
+import { describe, expect, it } from 'vitest';
+import { loadNodeAssets } from '../src/assets/load-node.js';
+import { createCodesignMcpServer } from '../src/server.js';
+const TOOL_NAMES_IN_HANDBOOK = [
+    'handbook',
+    'api',
+    'guide',
+    'edit',
+    'preview',
+    'export',
+    'list',
+    'history',
+    'inspect',
+    'rename',
+    'open_editor',
+    'asset_generate'
+];
+describe('handbook contract', () => {
+    it('the handbook prose references every tool name we ship', () => {
+        const assets = loadNodeAssets();
+        const handbookText = assets['docs/handbook/SKILL.md'];
+        expect(handbookText).toBeTruthy();
+        for (const tool of TOOL_NAMES_IN_HANDBOOK) {
+            expect(handbookText, `handbook is missing tool name "${tool}"`).toContain(tool);
+        }
+    });
+    it('every tool the handbook names is in tools/list', async () => {
+        const server = createCodesignMcpServer({
+            engine: {},
+            assets: loadNodeAssets(),
+            tools: [
+                // Stubs with the right names so tools/list returns them. The
+                // handbook contract checks NAMES, not behaviour — full behaviour
+                // is covered in tools/*.test.ts and the evals.
+                ...[
+                    'edit',
+                    'preview',
+                    'export',
+                    'list',
+                    'history',
+                    'inspect',
+                    'rename',
+                    'open_editor',
+                    'asset_generate'
+                ].map((name) => ({
+                    name,
+                    description: `${name} tool stub for handbook-contract check`,
+                    inputSchema: { type: 'object', properties: {} },
+                    call: async () => ({ content: [{ type: 'text', text: '' }] })
+                }))
+            ]
+        });
+        const [c, s] = InMemoryTransport.createLinkedPair();
+        await server.connect(s);
+        const client = new Client({ name: 'test', version: '0' });
+        await client.connect(c);
+        const tools = await client.listTools();
+        const names = tools.tools.map((t) => t.name);
+        for (const expected of TOOL_NAMES_IN_HANDBOOK) {
+            expect(names, `tools/list missing "${expected}"`).toContain(expected);
+        }
+    });
+    it('documents the httpUrl field for export and asset_generate', () => {
+        const assets = loadNodeAssets();
+        const handbookText = assets['docs/handbook/SKILL.md'];
+        expect(handbookText).toContain('httpUrl');
+    });
+});
+//# sourceMappingURL=handbook-contract.test.js.map

package/dist/test/test/handbook-contract.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-contract.test.js","sourceRoot":"","sources":["../../../test/handbook-contract.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';\nimport { describe, expect, it } from 'vitest';\nimport { loadNodeAssets } from '../src/assets/load-node.js';\nimport { createCodesignMcpServer } from '../src/server.js';\n\nconst TOOL_NAMES_IN_HANDBOOK = [\n  'handbook',\n  'api',\n  'guide',\n  'edit',\n  'preview',\n  'export',\n  'list',\n  'history',\n  'inspect',\n  'rename',\n  'open_editor',\n  'asset_generate'\n];\n\ndescribe('handbook contract', () => {\n  it('the handbook prose references every tool name we ship', () => {\n    const assets = loadNodeAssets();\n    const handbookText = assets['docs/handbook/SKILL.md'];\n    expect(handbookText).toBeTruthy();\n    for (const tool of TOOL_NAMES_IN_HANDBOOK) {\n      expect(handbookText, `handbook is missing tool name \"${tool}\"`).toContain(\n        tool\n      );\n    }\n  });\n\n  it('every tool the handbook names is in tools/list', async () => {\n    const server = createCodesignMcpServer({\n      engine: {},\n      assets: loadNodeAssets(),\n      tools: [\n        // Stubs with the right names so tools/list returns them. The\n        // handbook contract checks NAMES, not behaviour — full behaviour\n        // is covered in tools/*.test.ts and the evals.\n        ...[\n          'edit',\n          'preview',\n          'export',\n          'list',\n          'history',\n          'inspect',\n          'rename',\n          'open_editor',\n          'asset_generate'\n        ].map((name) => ({\n          name,\n          description: `${name} tool stub for handbook-contract check`,\n          inputSchema: { type: 'object' as const, properties: {} },\n          call: async () => ({ content: [{ type: 'text' as const, text: '' }] })\n        }))\n      ]\n    });\n    const [c, s] = InMemoryTransport.createLinkedPair();\n    await server.connect(s);\n    const client = new Client({ name: 'test', version: '0' });\n    await client.connect(c);\n    const tools = await client.listTools();\n    const names = tools.tools.map((t) => t.name);\n    for (const expected of TOOL_NAMES_IN_HANDBOOK) {\n      expect(names, `tools/list missing \"${expected}\"`).toContain(expected);\n    }\n  });\n\n  it('documents the httpUrl field for export and asset_generate', () => {\n    const assets = loadNodeAssets();\n    const handbookText = assets['docs/handbook/SKILL.md'];\n    expect(handbookText).toContain('httpUrl');\n  });\n});\n"]}

package/dist/test/test/http/server.test.d.ts

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

package/dist/test/test/http/server.test.d.ts.map

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