@imgly/codesign-mcp 0.1.0 → 0.1.2

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

@@ -1 +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"]}
+{"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 cold-instance reconstruction (spec §8.6)', () => {\n  it('reconstructs a cold engine by loading a staged revision scene', async () => {\n    // Regression guard: a cold session (no warm slot) must load the staged\n    // scene via loadFromString before returning the slot. This documents the\n    // edit-tool contract: populate(parent, scene) → acquire(parent) always\n    // calls loadFromString, never assumes a warm engine.\n    const { adapter } = makeFakeEngine();\n    const session = new EngineSession({ size: 1, adapter });\n    // Cold: no slots exist yet, so no warm engine.\n    await session.populate('rev-1', '<scene-for-rev-1/>');\n    const slot = await session.acquire('rev-1');\n    expect(adapter.loadFromString).toHaveBeenCalledWith(\n      slot.engine,\n      '<scene-for-rev-1/>'\n    );\n    expect(slot.currentRevision).toBe('rev-1');\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/unsplash-source.test.d.ts

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

package/dist/test/test/engine/unsplash-source.test.d.ts.map

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

package/dist/test/test/engine/unsplash-source.test.js

@@ -0,0 +1,129 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { registerUnsplashSource } from '../../src/engine/unsplash-source.js';
+// Minimal engine double: registerUnsplashSource only touches engine.asset.
+function makeEngine(existingSources = []) {
+    const added = [];
+    const engine = {
+        asset: {
+            findAllSources: vi.fn(() => [
+                ...existingSources,
+                ...added.map((s) => s.id)
+            ]),
+            addSource: vi.fn((source) => added.push(source)),
+            defaultApplyAsset: vi.fn(async () => 1)
+        }
+    };
+    // registerUnsplashSource is typed against CreativeEngine; the double only
+    // implements the slice it uses.
+    return {
+        engine: engine,
+        added
+    };
+}
+function mockFetch(payload, ok = true, status = 200) {
+    const fetchMock = vi.fn(async (_url) => ({
+        ok,
+        status,
+        json: async () => payload
+    }));
+    vi.stubGlobal('fetch', fetchMock);
+    return fetchMock;
+}
+const PHOTO = {
+    id: 'abc',
+    description: 'A cat',
+    width: 800,
+    height: 600,
+    urls: { regular: 'https://img/regular.jpg', thumb: 'https://img/thumb.jpg' },
+    user: { name: 'Jane', links: { html: 'https://unsplash.com/@jane' } },
+    tags: [{ title: 'cat' }, { title: 'pet' }]
+};
+function findAssetsOf(added) {
+    return added[0].findAssets;
+}
+afterEach(() => {
+    vi.unstubAllGlobals();
+});
+describe('registerUnsplashSource', () => {
+    it('registers the unsplash source on a fresh engine', () => {
+        const { engine, added } = makeEngine();
+        registerUnsplashSource(engine);
+        expect(added).toHaveLength(1);
+        expect(added[0].id).toBe('unsplash');
+    });
+    it('is idempotent — skips when the source is already present', () => {
+        const { engine, added } = makeEngine(['unsplash']);
+        registerUnsplashSource(engine);
+        expect(added).toHaveLength(0);
+    });
+    it('searches via /search/photos when a query is set and maps the result', async () => {
+        const fetchMock = mockFetch({
+            results: [PHOTO],
+            total: 50,
+            total_pages: 5
+        });
+        const { engine, added } = makeEngine();
+        registerUnsplashSource(engine);
+        const query = {
+            query: 'cats',
+            page: 0,
+            perPage: 10,
+            locale: 'en'
+        };
+        const res = (await findAssetsOf(added)(query));
+        const url = fetchMock.mock.calls[0][0];
+        expect(url).toContain('/search/photos');
+        expect(url).toContain('query=cats');
+        expect(url).toContain('page=1'); // 0-based query → 1-based Unsplash
+        expect(url).toContain('per_page=10');
+        expect(res.assets).toHaveLength(1);
+        expect(res.assets[0]).toMatchObject({
+            id: 'abc',
+            label: 'A cat',
+            tags: ['cat', 'pet'],
+            meta: {
+                uri: 'https://img/regular.jpg',
+                thumbUri: 'https://img/thumb.jpg'
+            },
+            credits: { name: 'Jane', url: 'https://unsplash.com/@jane' }
+        });
+        expect(res.nextPage).toBe(1); // page 0 of 5 → next is 1
+    });
+    it('browses popular photos via /photos when no query is set', async () => {
+        const fetchMock = mockFetch([PHOTO, PHOTO]);
+        const { engine, added } = makeEngine();
+        registerUnsplashSource(engine);
+        const query = {
+            page: 0,
+            perPage: 2,
+            locale: 'en'
+        };
+        const res = (await findAssetsOf(added)(query));
+        const url = fetchMock.mock.calls[0][0];
+        expect(url).toContain('/photos?order_by=popular');
+        expect(res.assets).toHaveLength(2);
+        expect(res.nextPage).toBe(1); // full page → there may be more
+    });
+    it('stops paginating when a partial page comes back', async () => {
+        mockFetch([PHOTO]); // 1 < perPage(2)
+        const { engine, added } = makeEngine();
+        registerUnsplashSource(engine);
+        const res = (await findAssetsOf(added)({
+            page: 0,
+            perPage: 2,
+            locale: 'en'
+        }));
+        expect(res.nextPage).toBeUndefined();
+    });
+    it('throws when the proxy returns a non-OK status', async () => {
+        mockFetch({}, false, 502);
+        const { engine, added } = makeEngine();
+        registerUnsplashSource(engine);
+        await expect(findAssetsOf(added)({
+            page: 0,
+            perPage: 5,
+            locale: 'en'
+        })).rejects.toThrow('unsplash proxy: HTTP 502');
+    });
+});
+//# sourceMappingURL=unsplash-source.test.js.map

package/dist/test/test/engine/unsplash-source.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsplash-source.test.js","sourceRoot":"","sources":["../../../../test/engine/unsplash-source.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { afterEach, describe, expect, it, vi } from 'vitest';\nimport type {\n  AssetQueryData,\n  AssetsQueryResult,\n  AssetSource\n} from '@cesdk/engine';\nimport { registerUnsplashSource } from '../../src/engine/unsplash-source.js';\n\n// Minimal engine double: registerUnsplashSource only touches engine.asset.\nfunction makeEngine(existingSources: string[] = []) {\n  const added: AssetSource[] = [];\n  const engine = {\n    asset: {\n      findAllSources: vi.fn(() => [\n        ...existingSources,\n        ...added.map((s) => s.id)\n      ]),\n      addSource: vi.fn((source: AssetSource) => added.push(source)),\n      defaultApplyAsset: vi.fn(async () => 1)\n    }\n  };\n  // registerUnsplashSource is typed against CreativeEngine; the double only\n  // implements the slice it uses.\n  return {\n    engine: engine as unknown as Parameters<typeof registerUnsplashSource>[0],\n    added\n  };\n}\n\nfunction mockFetch(payload: unknown, ok = true, status = 200) {\n  const fetchMock = vi.fn(async (_url: string) => ({\n    ok,\n    status,\n    json: async () => payload\n  }));\n  vi.stubGlobal('fetch', fetchMock);\n  return fetchMock;\n}\n\nconst PHOTO = {\n  id: 'abc',\n  description: 'A cat',\n  width: 800,\n  height: 600,\n  urls: { regular: 'https://img/regular.jpg', thumb: 'https://img/thumb.jpg' },\n  user: { name: 'Jane', links: { html: 'https://unsplash.com/@jane' } },\n  tags: [{ title: 'cat' }, { title: 'pet' }]\n};\n\nfunction findAssetsOf(added: AssetSource[]): AssetSource['findAssets'] {\n  return added[0].findAssets;\n}\n\nafterEach(() => {\n  vi.unstubAllGlobals();\n});\n\ndescribe('registerUnsplashSource', () => {\n  it('registers the unsplash source on a fresh engine', () => {\n    const { engine, added } = makeEngine();\n    registerUnsplashSource(engine);\n    expect(added).toHaveLength(1);\n    expect(added[0].id).toBe('unsplash');\n  });\n\n  it('is idempotent — skips when the source is already present', () => {\n    const { engine, added } = makeEngine(['unsplash']);\n    registerUnsplashSource(engine);\n    expect(added).toHaveLength(0);\n  });\n\n  it('searches via /search/photos when a query is set and maps the result', async () => {\n    const fetchMock = mockFetch({\n      results: [PHOTO],\n      total: 50,\n      total_pages: 5\n    });\n    const { engine, added } = makeEngine();\n    registerUnsplashSource(engine);\n\n    const query: AssetQueryData = {\n      query: 'cats',\n      page: 0,\n      perPage: 10,\n      locale: 'en'\n    } as AssetQueryData;\n    const res = (await findAssetsOf(added)(query)) as AssetsQueryResult;\n\n    const url = fetchMock.mock.calls[0][0];\n    expect(url).toContain('/search/photos');\n    expect(url).toContain('query=cats');\n    expect(url).toContain('page=1'); // 0-based query → 1-based Unsplash\n    expect(url).toContain('per_page=10');\n\n    expect(res.assets).toHaveLength(1);\n    expect(res.assets[0]).toMatchObject({\n      id: 'abc',\n      label: 'A cat',\n      tags: ['cat', 'pet'],\n      meta: {\n        uri: 'https://img/regular.jpg',\n        thumbUri: 'https://img/thumb.jpg'\n      },\n      credits: { name: 'Jane', url: 'https://unsplash.com/@jane' }\n    });\n    expect(res.nextPage).toBe(1); // page 0 of 5 → next is 1\n  });\n\n  it('browses popular photos via /photos when no query is set', async () => {\n    const fetchMock = mockFetch([PHOTO, PHOTO]);\n    const { engine, added } = makeEngine();\n    registerUnsplashSource(engine);\n\n    const query: AssetQueryData = {\n      page: 0,\n      perPage: 2,\n      locale: 'en'\n    } as AssetQueryData;\n    const res = (await findAssetsOf(added)(query)) as AssetsQueryResult;\n\n    const url = fetchMock.mock.calls[0][0];\n    expect(url).toContain('/photos?order_by=popular');\n    expect(res.assets).toHaveLength(2);\n    expect(res.nextPage).toBe(1); // full page → there may be more\n  });\n\n  it('stops paginating when a partial page comes back', async () => {\n    mockFetch([PHOTO]); // 1 < perPage(2)\n    const { engine, added } = makeEngine();\n    registerUnsplashSource(engine);\n    const res = (await findAssetsOf(added)({\n      page: 0,\n      perPage: 2,\n      locale: 'en'\n    } as AssetQueryData)) as AssetsQueryResult;\n    expect(res.nextPage).toBeUndefined();\n  });\n\n  it('throws when the proxy returns a non-OK status', async () => {\n    mockFetch({}, false, 502);\n    const { engine, added } = makeEngine();\n    registerUnsplashSource(engine);\n    await expect(\n      findAssetsOf(added)({\n        page: 0,\n        perPage: 5,\n        locale: 'en'\n      } as AssetQueryData)\n    ).rejects.toThrow('unsplash proxy: HTTP 502');\n  });\n});\n"]}

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

@@ -3,6 +3,9 @@ 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';
+// asset_generate is intentionally absent: it is hidden for the beta (see the
+// ASSET_GENERATE_ENABLED kill-switch in src/tools/index.ts and the commented-out
+// section in the handbook). Re-add it here when the feature ships.
 const TOOL_NAMES_IN_HANDBOOK = [
     'handbook',
     'api',
@@ -10,12 +13,13 @@ const TOOL_NAMES_IN_HANDBOOK = [
     'edit',
     'preview',
     'export',
+    'save',
     'list',
     'history',
     'inspect',
     'rename',
     'open_editor',
-    'asset_generate'
+    'asset_search'
 ];
 describe('handbook contract', () => {
     it('the handbook prose references every tool name we ship', () => {
@@ -28,7 +32,6 @@ describe('handbook contract', () => {
     });
     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
@@ -38,12 +41,13 @@ describe('handbook contract', () => {
                     'edit',
                     'preview',
                     'export',
+                    'save',
                     'list',
                     'history',
                     'inspect',
                     'rename',
                     'open_editor',
-                    'asset_generate'
+                    'asset_search'
                 ].map((name) => ({
                     name,
                     description: `${name} tool stub for handbook-contract check`,
@@ -62,7 +66,7 @@ describe('handbook contract', () => {
             expect(names, `tools/list missing "${expected}"`).toContain(expected);
         }
     });
-    it('documents the httpUrl field for export and asset_generate', () => {
+    it('documents the httpUrl field for export and save', () => {
         const assets = loadNodeAssets();
         const handbookText = assets['docs/handbook/SKILL.md'];
         expect(handbookText).toContain('httpUrl');

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

@@ -1 +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"]}
+{"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\n// asset_generate is intentionally absent: it is hidden for the beta (see the\n// ASSET_GENERATE_ENABLED kill-switch in src/tools/index.ts and the commented-out\n// section in the handbook). Re-add it here when the feature ships.\nconst TOOL_NAMES_IN_HANDBOOK = [\n  'handbook',\n  'api',\n  'guide',\n  'edit',\n  'preview',\n  'export',\n  'save',\n  'list',\n  'history',\n  'inspect',\n  'rename',\n  'open_editor',\n  'asset_search'\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      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          'save',\n          'list',\n          'history',\n          'inspect',\n          'rename',\n          'open_editor',\n          'asset_search'\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 save', () => {\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.js

@@ -1,7 +1,11 @@
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import request from 'supertest';
 import { createCodesignHttpServer } from '../../src/http/server.js';
+import { WorkspaceAuthError } from '../../src/http/workspace-auth.js';
+import { ScopedWorkspaceFS } from '../../src/workspace/scoped.js';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
 const FIXTURES = {
     'docs/alpha/SKILL.md': '---\nname: alpha\ndescription: First.\n---\n# Alpha'
 };
@@ -178,6 +182,35 @@ describe('createCodesignHttpServer', () => {
         expect(json.error.code).toBe(-32001);
         expect(json.error.message).toMatch(/unknown session/);
     });
+    it('graceful DELETE /mcp terminates the session and frees its slot', async () => {
+        const { sessionId } = await connect();
+        expect(sessionId).toBeDefined();
+        expect(app.sessions.size).toBe(1);
+        const r = await fetch(baseUrl, {
+            method: 'DELETE',
+            headers: { 'mcp-session-id': sessionId }
+        });
+        expect(r.status).toBe(200);
+        // onsessionclosed → sessionMgr.delete: the slot (and its engine) is
+        // reclaimed immediately, not left squatting until idle eviction.
+        expect(app.sessions.size).toBe(0);
+        // The id is now unknown — a follow-up request 404s.
+        const followUp = await fetch(baseUrl, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                accept: 'application/json, text/event-stream',
+                'mcp-session-id': sessionId
+            },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 1,
+                method: 'tools/list',
+                params: {}
+            })
+        });
+        expect(followUp.status).toBe(404);
+    });
     it('auth middleware rejects requests with 401 when configured to', async () => {
         await app.shutdown();
         await new Promise((resolve) => server.close(() => resolve()));
@@ -241,5 +274,101 @@ describe('createCodesignHttpServer', () => {
         await a.client.close();
         await b.client.close();
     });
+    it('passes the resolved workspaceId to createSession on initialize', async () => {
+        const seen = [];
+        const testApp = await createCodesignHttpServer({
+            assets: {},
+            maxSessions: 4,
+            idleTimeoutMs: 60_000,
+            resolveWorkspaceId: (req) => req.header('x-workspace-id') ?? 'fallback',
+            createSession: async ({ workspaceId }) => {
+                seen.push(workspaceId);
+                return { engine: {}, tools: [] };
+            }
+        });
+        await request(testApp)
+            .post('/mcp')
+            .set('x-workspace-id', 'u/acme')
+            .set('content-type', 'application/json')
+            .send({ jsonrpc: '2.0', id: 1, method: 'initialize', params: {} });
+        expect(seen).toEqual(['u/acme']);
+        await testApp.shutdown();
+    });
+    it('returns 401 when resolveWorkspaceId throws WorkspaceAuthError', async () => {
+        const testApp = await createCodesignHttpServer({
+            assets: {},
+            maxSessions: 4,
+            idleTimeoutMs: 60_000,
+            resolveWorkspaceId: () => {
+                throw new WorkspaceAuthError('missing header');
+            },
+            createSession: async () => ({ engine: {}, tools: [] })
+        });
+        const res = await request(testApp)
+            .post('/mcp')
+            .set('content-type', 'application/json')
+            .send({ jsonrpc: '2.0', id: 1, method: 'initialize', params: {} });
+        expect(res.status).toBe(401);
+        expect(res.body.error.code).toBe(-32002);
+        expect(res.body.error.message).toBe('missing header');
+        await testApp.shutdown();
+    });
+    it('returns 400 (not a hang) when the resolved workspaceId is malformed', async () => {
+        const testApp = await createCodesignHttpServer({
+            assets: {},
+            maxSessions: 4,
+            idleTimeoutMs: 60_000,
+            // header mode-style: return an illegal id that ScopedWorkspaceFS will reject
+            resolveWorkspaceId: () => '../escape',
+            createSession: async ({ workspaceId }) => {
+                // mirror cli/http.ts: constructing the scoped fs validates the id
+                new ScopedWorkspaceFS(new InMemoryWorkspaceFS(), workspaceId);
+                return { engine: {}, tools: [] };
+            }
+        });
+        const res = await request(testApp)
+            .post('/mcp')
+            .set('content-type', 'application/json')
+            .send({ jsonrpc: '2.0', id: 1, method: 'initialize', params: {} });
+        expect(res.status).toBe(400);
+        expect(res.body.error.code).toBe(-32602); // invalid params
+        await testApp.shutdown();
+    });
+    it('forwards the metrics recorder so tool calls are timed', async () => {
+        const { MetricsRecorder } = await import('../../src/metrics/recorder.js');
+        const recorder = new MetricsRecorder();
+        const a2 = await createCodesignHttpServer({
+            assets: {},
+            maxSessions: 4,
+            idleTimeoutMs: 60_000,
+            metrics: recorder,
+            createSession: async () => ({
+                engine: {},
+                tools: [
+                    {
+                        name: 'ping',
+                        description: 'ping',
+                        inputSchema: { type: 'object', properties: {} },
+                        call: async () => ({
+                            content: [{ type: 'text', text: 'pong' }]
+                        })
+                    }
+                ]
+            })
+        });
+        const srv = await new Promise((resolve) => {
+            const s = a2.listen(0, '127.0.0.1', () => resolve(s));
+        });
+        const addr = srv.address();
+        const url = `http://127.0.0.1:${addr.port}/mcp`;
+        const transport = new StreamableHTTPClientTransport(new URL(url));
+        const client = new Client({ name: 'test', version: '0' });
+        await client.connect(transport);
+        await client.callTool({ name: 'ping', arguments: {} });
+        await client.close();
+        await new Promise((resolve) => srv.close(() => resolve()));
+        await a2.shutdown();
+        expect(recorder.snapshot().tools.find((t) => t.tool === 'ping')?.count).toBe(1);
+    });
 });
 //# sourceMappingURL=server.test.js.map

package/dist/test/test/http/server.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../../../../test/http/server.test.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AddressInfo } from 'node:net';\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport { afterEach, beforeEach, describe, expect, it } from 'vitest';\nimport { createCodesignHttpServer } from '../../src/http/server.js';\n\nconst FIXTURES = {\n  'docs/alpha/SKILL.md': '---\\nname: alpha\\ndescription: First.\\n---\\n# Alpha'\n};\n\ninterface FakeEngine {\n  id: number;\n  scriptsRun: string[];\n}\n\nlet nextEngineId = 0;\n\nfunction makeServer() {\n  return createCodesignHttpServer({\n    assets: FIXTURES,\n    maxSessions: 5,\n    idleTimeoutMs: 60_000,\n    // Replace the real CE.SDK headless bootstrap with a deterministic fake so\n    // the integration test runs in milliseconds, not seconds. The fake engine\n    // owns its own scriptsRun array, asserting per-session isolation.\n    createSession: async () => {\n      const engine: FakeEngine = { id: nextEngineId++, scriptsRun: [] };\n      const tools = [\n        {\n          name: 'echo',\n          description: 'Echo arg back',\n          inputSchema: {\n            type: 'object',\n            properties: { msg: { type: 'string' } },\n            required: ['msg']\n          },\n          call: async (args: unknown) => {\n            const msg = (args as { msg: string }).msg;\n            return { content: [{ type: 'text' as const, text: msg }] };\n          }\n        },\n        {\n          // Records the input on this session's engine and reads back the\n          // list of all scripts seen so far. Used by the isolation test to\n          // prove two sessions don't share engine state.\n          name: 'engine_record',\n          description:\n            'Record a string into the session engine, return all recorded so far',\n          inputSchema: {\n            type: 'object',\n            properties: { msg: { type: 'string' } },\n            required: ['msg']\n          },\n          call: async (args: unknown) => {\n            const msg = (args as { msg: string }).msg;\n            engine.scriptsRun.push(msg);\n            return {\n              content: [\n                { type: 'text' as const, text: engine.scriptsRun.join(',') }\n              ]\n            };\n          }\n        }\n      ];\n      return { engine, tools };\n    }\n  });\n}\n\ndescribe('createCodesignHttpServer', () => {\n  let app: Awaited<ReturnType<typeof createCodesignHttpServer>>;\n  let baseUrl: string;\n  let server: ReturnType<typeof app.listen>;\n\n  beforeEach(async () => {\n    nextEngineId = 0;\n    app = await makeServer();\n    await new Promise<void>((resolve) => {\n      server = app.listen(0, '127.0.0.1', resolve);\n    });\n    const addr = server.address() as AddressInfo;\n    baseUrl = `http://127.0.0.1:${addr.port}/mcp`;\n  });\n\n  afterEach(async () => {\n    await new Promise<void>((resolve) => server.close(() => resolve()));\n    await app.shutdown();\n  });\n\n  async function connect(): Promise<{\n    client: Client;\n    sessionId: string | undefined;\n  }> {\n    const transport = new StreamableHTTPClientTransport(new URL(baseUrl));\n    const client = new Client({ name: 'test', version: '0' });\n    await client.connect(transport);\n    return { client, sessionId: transport.sessionId };\n  }\n\n  it('initialize creates a new session and returns its id', async () => {\n    const { client, sessionId } = await connect();\n    expect(sessionId).toMatch(/[0-9a-f-]{36}/i); // uuid shape\n    expect(app.sessions.size).toBe(1);\n    await client.close();\n  });\n\n  it(\"listResources returns the asset bundle's skill files for that session\", async () => {\n    const { client } = await connect();\n    const list = await client.listResources();\n    expect(list.resources.map((r) => r.uri)).toEqual([\n      'codesign://docs/alpha/SKILL.md'\n    ]);\n    await client.close();\n  });\n\n  it(\"callTool routes to the session's own engine\", async () => {\n    const { client } = await connect();\n    const result = await client.callTool({\n      name: 'echo',\n      arguments: { msg: 'hi' }\n    });\n    expect(result.content).toEqual([{ type: 'text', text: 'hi' }]);\n    await client.close();\n  });\n\n  it('two parallel clients get distinct sessions and engines', async () => {\n    const a = await connect();\n    const b = await connect();\n    expect(a.sessionId).toBeDefined();\n    expect(b.sessionId).toBeDefined();\n    expect(a.sessionId).not.toBe(b.sessionId);\n    expect(app.sessions.size).toBe(2);\n    await a.client.close();\n    await b.client.close();\n  });\n\n  it('session cap: returns 503 when maxSessions is reached', async () => {\n    await app.shutdown(); // dismiss the default 5-session app\n    app = await createCodesignHttpServer({\n      assets: FIXTURES,\n      maxSessions: 2,\n      idleTimeoutMs: 60_000,\n      createSession: async () => ({\n        engine: { id: nextEngineId++, scriptsRun: [] },\n        tools: []\n      })\n    });\n    await new Promise<void>((resolve) => server.close(() => resolve()));\n    await new Promise<void>((resolve) => {\n      server = app.listen(0, '127.0.0.1', resolve);\n    });\n    const addr = server.address() as AddressInfo;\n    baseUrl = `http://127.0.0.1:${addr.port}/mcp`;\n\n    const a = await connect();\n    const b = await connect();\n    // 3rd init request should be rejected at the HTTP layer with 503.\n    const initBody = {\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: '2025-03-26',\n        capabilities: {},\n        clientInfo: { name: 't', version: '0' }\n      }\n    };\n    const r = await fetch(baseUrl, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        accept: 'application/json, text/event-stream'\n      },\n      body: JSON.stringify(initBody)\n    });\n    expect(r.status).toBe(503);\n    expect(r.headers.get('retry-after')).toBe('30');\n    const json = (await r.json()) as {\n      error: { code: number; message: string };\n    };\n    expect(json.error.code).toBe(-32000);\n    expect(json.error.message).toMatch(/session cap/i);\n\n    await a.client.close();\n    await b.client.close();\n  });\n\n  it('unknown session id: returns 404 with -32001', async () => {\n    const r = await fetch(baseUrl, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        accept: 'application/json, text/event-stream',\n        'mcp-session-id': '00000000-0000-0000-0000-000000000000'\n      },\n      body: JSON.stringify({\n        jsonrpc: '2.0',\n        id: 1,\n        method: 'tools/list',\n        params: {}\n      })\n    });\n    expect(r.status).toBe(404);\n    const json = (await r.json()) as {\n      error: { code: number; message: string };\n    };\n    expect(json.error.code).toBe(-32001);\n    expect(json.error.message).toMatch(/unknown session/);\n  });\n\n  it('auth middleware rejects requests with 401 when configured to', async () => {\n    await app.shutdown();\n    await new Promise<void>((resolve) => server.close(() => resolve()));\n    app = await createCodesignHttpServer({\n      assets: FIXTURES,\n      maxSessions: 5,\n      idleTimeoutMs: 60_000,\n      createSession: async () => ({\n        engine: { id: nextEngineId++, scriptsRun: [] },\n        tools: []\n      }),\n      auth: (req, res, next) => {\n        if (req.header('authorization') !== 'Bearer testtoken') {\n          res.status(401).json({ error: 'unauthorized' });\n          return;\n        }\n        next();\n      }\n    });\n    await new Promise<void>((resolve) => {\n      server = app.listen(0, '127.0.0.1', resolve);\n    });\n    const addr = server.address() as AddressInfo;\n    baseUrl = `http://127.0.0.1:${addr.port}/mcp`;\n\n    const r = await fetch(baseUrl, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        accept: 'application/json, text/event-stream'\n      },\n      body: JSON.stringify({\n        jsonrpc: '2.0',\n        id: 1,\n        method: 'initialize',\n        params: {}\n      })\n    });\n    expect(r.status).toBe(401);\n  });\n\n  it('engine state is isolated per session: mutation in one is invisible to the other', async () => {\n    const a = await connect();\n    const b = await connect();\n\n    // Record on a — only a should see it.\n    const aResult = await a.client.callTool({\n      name: 'engine_record',\n      arguments: { msg: 'from-a' }\n    });\n    expect(aResult.content).toEqual([{ type: 'text', text: 'from-a' }]);\n\n    // Record on b — should NOT include from-a.\n    const bResult = await b.client.callTool({\n      name: 'engine_record',\n      arguments: { msg: 'from-b' }\n    });\n    expect(bResult.content).toEqual([{ type: 'text', text: 'from-b' }]);\n\n    // Re-record on a — should append to a's history, still no b.\n    const aResult2 = await a.client.callTool({\n      name: 'engine_record',\n      arguments: { msg: 'again' }\n    });\n    expect(aResult2.content).toEqual([{ type: 'text', text: 'from-a,again' }]);\n\n    await a.client.close();\n    await b.client.close();\n  });\n});\n"]}
+{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../../../../test/http/server.test.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AddressInfo } from 'node:net';\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js';\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';\nimport { afterEach, beforeEach, describe, expect, it } from 'vitest';\nimport request from 'supertest';\nimport { createCodesignHttpServer } from '../../src/http/server.js';\nimport { WorkspaceAuthError } from '../../src/http/workspace-auth.js';\nimport { ScopedWorkspaceFS } from '../../src/workspace/scoped.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\nconst FIXTURES = {\n  'docs/alpha/SKILL.md': '---\\nname: alpha\\ndescription: First.\\n---\\n# Alpha'\n};\n\ninterface FakeEngine {\n  id: number;\n  scriptsRun: string[];\n}\n\nlet nextEngineId = 0;\n\nfunction makeServer() {\n  return createCodesignHttpServer({\n    assets: FIXTURES,\n    maxSessions: 5,\n    idleTimeoutMs: 60_000,\n    // Replace the real CE.SDK headless bootstrap with a deterministic fake so\n    // the integration test runs in milliseconds, not seconds. The fake engine\n    // owns its own scriptsRun array, asserting per-session isolation.\n    createSession: async () => {\n      const engine: FakeEngine = { id: nextEngineId++, scriptsRun: [] };\n      const tools = [\n        {\n          name: 'echo',\n          description: 'Echo arg back',\n          inputSchema: {\n            type: 'object',\n            properties: { msg: { type: 'string' } },\n            required: ['msg']\n          },\n          call: async (args: unknown) => {\n            const msg = (args as { msg: string }).msg;\n            return { content: [{ type: 'text' as const, text: msg }] };\n          }\n        },\n        {\n          // Records the input on this session's engine and reads back the\n          // list of all scripts seen so far. Used by the isolation test to\n          // prove two sessions don't share engine state.\n          name: 'engine_record',\n          description:\n            'Record a string into the session engine, return all recorded so far',\n          inputSchema: {\n            type: 'object',\n            properties: { msg: { type: 'string' } },\n            required: ['msg']\n          },\n          call: async (args: unknown) => {\n            const msg = (args as { msg: string }).msg;\n            engine.scriptsRun.push(msg);\n            return {\n              content: [\n                { type: 'text' as const, text: engine.scriptsRun.join(',') }\n              ]\n            };\n          }\n        }\n      ];\n      return { engine, tools };\n    }\n  });\n}\n\ndescribe('createCodesignHttpServer', () => {\n  let app: Awaited<ReturnType<typeof createCodesignHttpServer>>;\n  let baseUrl: string;\n  let server: ReturnType<typeof app.listen>;\n\n  beforeEach(async () => {\n    nextEngineId = 0;\n    app = await makeServer();\n    await new Promise<void>((resolve) => {\n      server = app.listen(0, '127.0.0.1', resolve);\n    });\n    const addr = server.address() as AddressInfo;\n    baseUrl = `http://127.0.0.1:${addr.port}/mcp`;\n  });\n\n  afterEach(async () => {\n    await new Promise<void>((resolve) => server.close(() => resolve()));\n    await app.shutdown();\n  });\n\n  async function connect(): Promise<{\n    client: Client;\n    sessionId: string | undefined;\n  }> {\n    const transport = new StreamableHTTPClientTransport(new URL(baseUrl));\n    const client = new Client({ name: 'test', version: '0' });\n    await client.connect(transport);\n    return { client, sessionId: transport.sessionId };\n  }\n\n  it('initialize creates a new session and returns its id', async () => {\n    const { client, sessionId } = await connect();\n    expect(sessionId).toMatch(/[0-9a-f-]{36}/i); // uuid shape\n    expect(app.sessions.size).toBe(1);\n    await client.close();\n  });\n\n  it(\"listResources returns the asset bundle's skill files for that session\", async () => {\n    const { client } = await connect();\n    const list = await client.listResources();\n    expect(list.resources.map((r) => r.uri)).toEqual([\n      'codesign://docs/alpha/SKILL.md'\n    ]);\n    await client.close();\n  });\n\n  it(\"callTool routes to the session's own engine\", async () => {\n    const { client } = await connect();\n    const result = await client.callTool({\n      name: 'echo',\n      arguments: { msg: 'hi' }\n    });\n    expect(result.content).toEqual([{ type: 'text', text: 'hi' }]);\n    await client.close();\n  });\n\n  it('two parallel clients get distinct sessions and engines', async () => {\n    const a = await connect();\n    const b = await connect();\n    expect(a.sessionId).toBeDefined();\n    expect(b.sessionId).toBeDefined();\n    expect(a.sessionId).not.toBe(b.sessionId);\n    expect(app.sessions.size).toBe(2);\n    await a.client.close();\n    await b.client.close();\n  });\n\n  it('session cap: returns 503 when maxSessions is reached', async () => {\n    await app.shutdown(); // dismiss the default 5-session app\n    app = await createCodesignHttpServer({\n      assets: FIXTURES,\n      maxSessions: 2,\n      idleTimeoutMs: 60_000,\n      createSession: async () => ({\n        engine: { id: nextEngineId++, scriptsRun: [] },\n        tools: []\n      })\n    });\n    await new Promise<void>((resolve) => server.close(() => resolve()));\n    await new Promise<void>((resolve) => {\n      server = app.listen(0, '127.0.0.1', resolve);\n    });\n    const addr = server.address() as AddressInfo;\n    baseUrl = `http://127.0.0.1:${addr.port}/mcp`;\n\n    const a = await connect();\n    const b = await connect();\n    // 3rd init request should be rejected at the HTTP layer with 503.\n    const initBody = {\n      jsonrpc: '2.0',\n      id: 1,\n      method: 'initialize',\n      params: {\n        protocolVersion: '2025-03-26',\n        capabilities: {},\n        clientInfo: { name: 't', version: '0' }\n      }\n    };\n    const r = await fetch(baseUrl, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        accept: 'application/json, text/event-stream'\n      },\n      body: JSON.stringify(initBody)\n    });\n    expect(r.status).toBe(503);\n    expect(r.headers.get('retry-after')).toBe('30');\n    const json = (await r.json()) as {\n      error: { code: number; message: string };\n    };\n    expect(json.error.code).toBe(-32000);\n    expect(json.error.message).toMatch(/session cap/i);\n\n    await a.client.close();\n    await b.client.close();\n  });\n\n  it('unknown session id: returns 404 with -32001', async () => {\n    const r = await fetch(baseUrl, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        accept: 'application/json, text/event-stream',\n        'mcp-session-id': '00000000-0000-0000-0000-000000000000'\n      },\n      body: JSON.stringify({\n        jsonrpc: '2.0',\n        id: 1,\n        method: 'tools/list',\n        params: {}\n      })\n    });\n    expect(r.status).toBe(404);\n    const json = (await r.json()) as {\n      error: { code: number; message: string };\n    };\n    expect(json.error.code).toBe(-32001);\n    expect(json.error.message).toMatch(/unknown session/);\n  });\n\n  it('graceful DELETE /mcp terminates the session and frees its slot', async () => {\n    const { sessionId } = await connect();\n    expect(sessionId).toBeDefined();\n    expect(app.sessions.size).toBe(1);\n\n    const r = await fetch(baseUrl, {\n      method: 'DELETE',\n      headers: { 'mcp-session-id': sessionId as string }\n    });\n    expect(r.status).toBe(200);\n    // onsessionclosed → sessionMgr.delete: the slot (and its engine) is\n    // reclaimed immediately, not left squatting until idle eviction.\n    expect(app.sessions.size).toBe(0);\n\n    // The id is now unknown — a follow-up request 404s.\n    const followUp = await fetch(baseUrl, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        accept: 'application/json, text/event-stream',\n        'mcp-session-id': sessionId as string\n      },\n      body: JSON.stringify({\n        jsonrpc: '2.0',\n        id: 1,\n        method: 'tools/list',\n        params: {}\n      })\n    });\n    expect(followUp.status).toBe(404);\n  });\n\n  it('auth middleware rejects requests with 401 when configured to', async () => {\n    await app.shutdown();\n    await new Promise<void>((resolve) => server.close(() => resolve()));\n    app = await createCodesignHttpServer({\n      assets: FIXTURES,\n      maxSessions: 5,\n      idleTimeoutMs: 60_000,\n      createSession: async () => ({\n        engine: { id: nextEngineId++, scriptsRun: [] },\n        tools: []\n      }),\n      auth: (req, res, next) => {\n        if (req.header('authorization') !== 'Bearer testtoken') {\n          res.status(401).json({ error: 'unauthorized' });\n          return;\n        }\n        next();\n      }\n    });\n    await new Promise<void>((resolve) => {\n      server = app.listen(0, '127.0.0.1', resolve);\n    });\n    const addr = server.address() as AddressInfo;\n    baseUrl = `http://127.0.0.1:${addr.port}/mcp`;\n\n    const r = await fetch(baseUrl, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        accept: 'application/json, text/event-stream'\n      },\n      body: JSON.stringify({\n        jsonrpc: '2.0',\n        id: 1,\n        method: 'initialize',\n        params: {}\n      })\n    });\n    expect(r.status).toBe(401);\n  });\n\n  it('engine state is isolated per session: mutation in one is invisible to the other', async () => {\n    const a = await connect();\n    const b = await connect();\n\n    // Record on a — only a should see it.\n    const aResult = await a.client.callTool({\n      name: 'engine_record',\n      arguments: { msg: 'from-a' }\n    });\n    expect(aResult.content).toEqual([{ type: 'text', text: 'from-a' }]);\n\n    // Record on b — should NOT include from-a.\n    const bResult = await b.client.callTool({\n      name: 'engine_record',\n      arguments: { msg: 'from-b' }\n    });\n    expect(bResult.content).toEqual([{ type: 'text', text: 'from-b' }]);\n\n    // Re-record on a — should append to a's history, still no b.\n    const aResult2 = await a.client.callTool({\n      name: 'engine_record',\n      arguments: { msg: 'again' }\n    });\n    expect(aResult2.content).toEqual([{ type: 'text', text: 'from-a,again' }]);\n\n    await a.client.close();\n    await b.client.close();\n  });\n\n  it('passes the resolved workspaceId to createSession on initialize', async () => {\n    const seen: string[] = [];\n    const testApp = await createCodesignHttpServer({\n      assets: {},\n      maxSessions: 4,\n      idleTimeoutMs: 60_000,\n      resolveWorkspaceId: (req) => req.header('x-workspace-id') ?? 'fallback',\n      createSession: async ({ workspaceId }) => {\n        seen.push(workspaceId);\n        return { engine: {}, tools: [] };\n      }\n    });\n    await request(testApp)\n      .post('/mcp')\n      .set('x-workspace-id', 'u/acme')\n      .set('content-type', 'application/json')\n      .send({ jsonrpc: '2.0', id: 1, method: 'initialize', params: {} });\n    expect(seen).toEqual(['u/acme']);\n    await testApp.shutdown();\n  });\n\n  it('returns 401 when resolveWorkspaceId throws WorkspaceAuthError', async () => {\n    const testApp = await createCodesignHttpServer({\n      assets: {},\n      maxSessions: 4,\n      idleTimeoutMs: 60_000,\n      resolveWorkspaceId: () => {\n        throw new WorkspaceAuthError('missing header');\n      },\n      createSession: async () => ({ engine: {}, tools: [] })\n    });\n    const res = await request(testApp)\n      .post('/mcp')\n      .set('content-type', 'application/json')\n      .send({ jsonrpc: '2.0', id: 1, method: 'initialize', params: {} });\n    expect(res.status).toBe(401);\n    expect(res.body.error.code).toBe(-32002);\n    expect(res.body.error.message).toBe('missing header');\n    await testApp.shutdown();\n  });\n\n  it('returns 400 (not a hang) when the resolved workspaceId is malformed', async () => {\n    const testApp = await createCodesignHttpServer({\n      assets: {},\n      maxSessions: 4,\n      idleTimeoutMs: 60_000,\n      // header mode-style: return an illegal id that ScopedWorkspaceFS will reject\n      resolveWorkspaceId: () => '../escape',\n      createSession: async ({ workspaceId }) => {\n        // mirror cli/http.ts: constructing the scoped fs validates the id\n        new ScopedWorkspaceFS(new InMemoryWorkspaceFS(), workspaceId);\n        return { engine: {}, tools: [] };\n      }\n    });\n    const res = await request(testApp)\n      .post('/mcp')\n      .set('content-type', 'application/json')\n      .send({ jsonrpc: '2.0', id: 1, method: 'initialize', params: {} });\n    expect(res.status).toBe(400);\n    expect(res.body.error.code).toBe(-32602); // invalid params\n    await testApp.shutdown();\n  });\n\n  it('forwards the metrics recorder so tool calls are timed', async () => {\n    const { MetricsRecorder } = await import('../../src/metrics/recorder.js');\n    const recorder = new MetricsRecorder();\n    const a2 = await createCodesignHttpServer({\n      assets: {},\n      maxSessions: 4,\n      idleTimeoutMs: 60_000,\n      metrics: recorder,\n      createSession: async () => ({\n        engine: {},\n        tools: [\n          {\n            name: 'ping',\n            description: 'ping',\n            inputSchema: { type: 'object', properties: {} },\n            call: async () => ({\n              content: [{ type: 'text' as const, text: 'pong' }]\n            })\n          }\n        ]\n      })\n    });\n    const srv = await new Promise<ReturnType<typeof a2.listen>>((resolve) => {\n      const s = a2.listen(0, '127.0.0.1', () => resolve(s));\n    });\n    const addr = srv.address() as AddressInfo;\n    const url = `http://127.0.0.1:${addr.port}/mcp`;\n    const transport = new StreamableHTTPClientTransport(new URL(url));\n    const client = new Client({ name: 'test', version: '0' });\n    await client.connect(transport);\n    await client.callTool({ name: 'ping', arguments: {} });\n    await client.close();\n    await new Promise<void>((resolve) => srv.close(() => resolve()));\n    await a2.shutdown();\n    expect(\n      recorder.snapshot().tools.find((t) => t.tool === 'ping')?.count\n    ).toBe(1);\n  });\n});\n"]}

package/dist/test/test/http/session-id-header.test.d.ts

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

package/dist/test/test/http/session-id-header.test.d.ts.map

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