@imgly/codesign-mcp 0.1.1 → 0.1.2

package/dist/test/test/tools/export.test.js

@@ -1,9 +1,11 @@
 import { describe, expect, it, vi } from 'vitest';
+import { Mutex } from '../../src/engine/mutex.js';
 import { EngineSession } from '../../src/engine/session.js';
 import { RevisionStore } from '../../src/revisions/store.js';
 import { createExportTool } from '../../src/tools/export.js';
 import { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';
 import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+const engineLock = new Mutex();
 const urlBuilder = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:9000' });
 function makeDeps() {
     const fs = new InMemoryWorkspaceFS();
@@ -29,32 +31,16 @@ function makeDeps() {
     return { fs, store, session, fakeEngine };
 }
 describe('export tool', () => {
-    it('export target=scene writes the bytes and returns uri + httpUrl, no path', async () => {
-        const { fs, store, session } = makeDeps();
-        const root = await store.write({
-            scene: 'SCENE_ABC',
-            parent: null,
-            title: 'T'
-        });
-        const tool = createExportTool({ fs, store, session, urlBuilder });
-        const result = await tool.call({
-            target: 'scene',
-            format: 'scene',
-            revision: root.id
-        });
-        const body = JSON.parse(result.content[0].text);
-        const shard = root.id.slice(0, 2);
-        const rest = root.id.slice(2);
-        expect(body.uri).toBe(`workspace://exports/${shard}/${rest}/scene.scene`);
-        expect(body.httpUrl).toBe(`http://127.0.0.1:9000/r/exports/${shard}/${rest}/scene.scene`);
-        expect(body.path).toBeUndefined();
-        expect(await fs.readFile(`exports/${shard}/${rest}/scene.scene`, 'utf8')).toBe('SCENE_ABC');
-        expect(body.bytes).toBe(9);
-    });
     it('export target=image renders the block and writes the file deterministically', async () => {
         const { fs, store, session } = makeDeps();
         const root = await store.write({ scene: 'S', parent: null, title: 'T' });
-        const tool = createExportTool({ fs, store, session, urlBuilder });
+        const tool = createExportTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            urlBuilder
+        });
         const result = await tool.call({
             target: 'image',
             format: 'png',
@@ -70,7 +56,13 @@ describe('export tool', () => {
     it("export target=pdf renders via block.export('application/pdf')", async () => {
         const { fs, store, session, fakeEngine } = makeDeps();
         const root = await store.write({ scene: 'S', parent: null, title: 'T' });
-        const tool = createExportTool({ fs, store, session, urlBuilder });
+        const tool = createExportTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            urlBuilder
+        });
         await tool.call({
             target: 'pdf',
             format: 'pdf',
@@ -82,7 +74,13 @@ describe('export tool', () => {
     it('returns isError when target=video (deferred to Phase 4)', async () => {
         const { fs, store, session } = makeDeps();
         const root = await store.write({ scene: 'S', parent: null, title: 'T' });
-        const tool = createExportTool({ fs, store, session, urlBuilder });
+        const tool = createExportTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            urlBuilder
+        });
         const result = await tool.call({
             target: 'video',
             format: 'mp4',
@@ -102,18 +100,20 @@ describe('export tool', () => {
         const { tmpdir } = await import('node:os');
         const { join } = await import('node:path');
         const dir = await mkdtemp(join(tmpdir(), 'export-out-'));
-        const outPath = join(dir, 'x.scene');
+        const outPath = join(dir, 'x.png');
         const tool = createExportTool({
             fs,
             store,
             session,
+            engineLock,
             urlBuilder,
             allowOutPath: true
         });
         const result = await tool.call({
-            target: 'scene',
-            format: 'scene',
+            target: 'image',
+            format: 'png',
             revision: root.id,
+            blockId: 5,
             outPath
         });
         const body = JSON.parse(result.content[0].text);
@@ -128,17 +128,47 @@ describe('export tool', () => {
             fs,
             store,
             session,
+            engineLock,
             urlBuilder,
             allowOutPath: false
         });
+        const result = await tool.call({
+            target: 'image',
+            format: 'png',
+            revision: root.id,
+            blockId: 5,
+            outPath: '/tmp/x'
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/outPath.*not.*supported/i);
+    });
+    it('omits `outPath` from the schema when not allowed (Hosted), advertises it when allowed (Local)', () => {
+        const { fs, store, session } = makeDeps();
+        const base = { fs, store, session, engineLock, urlBuilder };
+        const hosted = createExportTool({ ...base, allowOutPath: false });
+        const local = createExportTool({ ...base, allowOutPath: true });
+        const props = (s) => s.properties;
+        expect(props(hosted.inputSchema)).not.toHaveProperty('outPath');
+        expect(props(local.inputSchema)).toHaveProperty('outPath');
+    });
+    it('rejects target=scene (moved to the save tool)', async () => {
+        const { fs, store, session } = makeDeps();
+        const root = await store.write({ scene: 'S', parent: null, title: 'T' });
+        const tool = createExportTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            urlBuilder
+        });
         const result = await tool.call({
             target: 'scene',
             format: 'scene',
             revision: root.id,
-            outPath: '/tmp/x'
+            blockId: 5
         });
         expect(result.isError).toBe(true);
-        expect(result.content[0].text).toMatch(/outPath.*not.*allowed/i);
+        expect(result.content[0].text).toMatch(/invalid format/i);
     });
 });
 //# sourceMappingURL=export.test.js.map

package/dist/test/test/tools/export.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"export.test.js","sourceRoot":"","sources":["../../../../test/tools/export.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';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { createExportTool } from '../../src/tools/export.js';\nimport { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\ninterface FakeEngine {\n  _scene: string;\n  block: { export: ReturnType<typeof vi.fn> };\n  scene: { saveToString: ReturnType<typeof vi.fn> };\n}\n\nconst urlBuilder = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:9000' });\n\nfunction makeDeps() {\n  const fs = new InMemoryWorkspaceFS();\n  const store = new RevisionStore(fs);\n  const fakeEngine: FakeEngine = {\n    _scene: '',\n    block: {\n      export: vi.fn(\n        async () => new Blob([new Uint8Array([0xff, 0xd8, 0xff, 0xe0])])\n      )\n    },\n    scene: { saveToString: vi.fn(async () => '<scene-serialized/>') }\n  };\n  const adapter: EngineAdapter<FakeEngine> = {\n    create: () => fakeEngine,\n    reset: async (e) => {\n      e._scene = 'EMPTY';\n    },\n    loadFromString: async (e, s) => {\n      e._scene = s;\n    },\n    saveToString: async (e) => e._scene\n  };\n  const session = new EngineSession<FakeEngine>({ size: 1, adapter });\n  return { fs, store, session, fakeEngine };\n}\n\ndescribe('export tool', () => {\n  it('export target=scene writes the bytes and returns uri + httpUrl, no path', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({\n      scene: 'SCENE_ABC',\n      parent: null,\n      title: 'T'\n    });\n    const tool = createExportTool({ fs, store, session, urlBuilder });\n    const result = await tool.call({\n      target: 'scene',\n      format: 'scene',\n      revision: root.id\n    });\n    const body = JSON.parse((result.content[0] as { text: string }).text) as {\n      uri: string;\n      httpUrl?: string;\n      path?: string;\n      bytes: number;\n    };\n    const shard = root.id.slice(0, 2);\n    const rest = root.id.slice(2);\n    expect(body.uri).toBe(`workspace://exports/${shard}/${rest}/scene.scene`);\n    expect(body.httpUrl).toBe(\n      `http://127.0.0.1:9000/r/exports/${shard}/${rest}/scene.scene`\n    );\n    expect(body.path).toBeUndefined();\n    expect(\n      await fs.readFile(`exports/${shard}/${rest}/scene.scene`, 'utf8')\n    ).toBe('SCENE_ABC');\n    expect(body.bytes).toBe(9);\n  });\n\n  it('export target=image renders the block and writes the file deterministically', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createExportTool({ fs, store, session, urlBuilder });\n    const result = await tool.call({\n      target: 'image',\n      format: 'png',\n      revision: root.id,\n      blockId: 5\n    });\n    const body = JSON.parse((result.content[0] as { text: string }).text) as {\n      uri: string;\n    };\n    const shard = root.id.slice(0, 2);\n    const rest = root.id.slice(2);\n    expect(body.uri).toBe(`workspace://exports/${shard}/${rest}/image.png`);\n    expect(await fs.exists(`exports/${shard}/${rest}/image.png`)).toBe(true);\n  });\n\n  it(\"export target=pdf renders via block.export('application/pdf')\", async () => {\n    const { fs, store, session, fakeEngine } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createExportTool({ fs, store, session, urlBuilder });\n    await tool.call({\n      target: 'pdf',\n      format: 'pdf',\n      revision: root.id,\n      blockId: 5\n    });\n    expect(fakeEngine.block.export).toHaveBeenCalledWith(\n      5,\n      'application/pdf',\n      expect.any(Object)\n    );\n  });\n\n  it('returns isError when target=video (deferred to Phase 4)', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createExportTool({ fs, store, session, urlBuilder });\n    const result = await tool.call({\n      target: 'video',\n      format: 'mp4',\n      revision: root.id\n    });\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(/phase 4/i);\n  });\n\n  it('respects local `outPath` escape hatch — returns path, not httpUrl', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({\n      scene: 'SCENE_X',\n      parent: null,\n      title: 'T'\n    });\n    const { mkdtemp, rm } = await import('node:fs/promises');\n    const { tmpdir } = await import('node:os');\n    const { join } = await import('node:path');\n    const dir = await mkdtemp(join(tmpdir(), 'export-out-'));\n    const outPath = join(dir, 'x.scene');\n    const tool = createExportTool({\n      fs,\n      store,\n      session,\n      urlBuilder,\n      allowOutPath: true\n    });\n    const result = await tool.call({\n      target: 'scene',\n      format: 'scene',\n      revision: root.id,\n      outPath\n    });\n    const body = JSON.parse((result.content[0] as { text: string }).text) as {\n      path?: string;\n      httpUrl?: string;\n    };\n    expect(body.path).toBe(outPath);\n    expect(body.httpUrl).toBeUndefined();\n    await rm(dir, { recursive: true });\n  });\n\n  it('rejects `outPath` when not allowed (Hosted/sandbox)', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createExportTool({\n      fs,\n      store,\n      session,\n      urlBuilder,\n      allowOutPath: false\n    });\n    const result = await tool.call({\n      target: 'scene',\n      format: 'scene',\n      revision: root.id,\n      outPath: '/tmp/x'\n    });\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(\n      /outPath.*not.*allowed/i\n    );\n  });\n});\n"]}
+{"version":3,"file":"export.test.js","sourceRoot":"","sources":["../../../../test/tools/export.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from 'vitest';\nimport { Mutex } from '../../src/engine/mutex.js';\nimport { type EngineAdapter, EngineSession } from '../../src/engine/session.js';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { createExportTool } from '../../src/tools/export.js';\nimport { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\nconst engineLock = new Mutex();\n\ninterface FakeEngine {\n  _scene: string;\n  block: { export: ReturnType<typeof vi.fn> };\n  scene: { saveToString: ReturnType<typeof vi.fn> };\n}\n\nconst urlBuilder = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:9000' });\n\nfunction makeDeps() {\n  const fs = new InMemoryWorkspaceFS();\n  const store = new RevisionStore(fs);\n  const fakeEngine: FakeEngine = {\n    _scene: '',\n    block: {\n      export: vi.fn(\n        async () => new Blob([new Uint8Array([0xff, 0xd8, 0xff, 0xe0])])\n      )\n    },\n    scene: { saveToString: vi.fn(async () => '<scene-serialized/>') }\n  };\n  const adapter: EngineAdapter<FakeEngine> = {\n    create: () => fakeEngine,\n    reset: async (e) => {\n      e._scene = 'EMPTY';\n    },\n    loadFromString: async (e, s) => {\n      e._scene = s;\n    },\n    saveToString: async (e) => e._scene\n  };\n  const session = new EngineSession<FakeEngine>({ size: 1, adapter });\n  return { fs, store, session, fakeEngine };\n}\n\ndescribe('export tool', () => {\n  it('export target=image renders the block and writes the file deterministically', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createExportTool({\n      fs,\n      store,\n      session,\n      engineLock,\n      urlBuilder\n    });\n    const result = await tool.call({\n      target: 'image',\n      format: 'png',\n      revision: root.id,\n      blockId: 5\n    });\n    const body = JSON.parse((result.content[0] as { text: string }).text) as {\n      uri: string;\n    };\n    const shard = root.id.slice(0, 2);\n    const rest = root.id.slice(2);\n    expect(body.uri).toBe(`workspace://exports/${shard}/${rest}/image.png`);\n    expect(await fs.exists(`exports/${shard}/${rest}/image.png`)).toBe(true);\n  });\n\n  it(\"export target=pdf renders via block.export('application/pdf')\", async () => {\n    const { fs, store, session, fakeEngine } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createExportTool({\n      fs,\n      store,\n      session,\n      engineLock,\n      urlBuilder\n    });\n    await tool.call({\n      target: 'pdf',\n      format: 'pdf',\n      revision: root.id,\n      blockId: 5\n    });\n    expect(fakeEngine.block.export).toHaveBeenCalledWith(\n      5,\n      'application/pdf',\n      expect.any(Object)\n    );\n  });\n\n  it('returns isError when target=video (deferred to Phase 4)', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createExportTool({\n      fs,\n      store,\n      session,\n      engineLock,\n      urlBuilder\n    });\n    const result = await tool.call({\n      target: 'video',\n      format: 'mp4',\n      revision: root.id\n    });\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(/phase 4/i);\n  });\n\n  it('respects local `outPath` escape hatch — returns path, not httpUrl', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({\n      scene: 'SCENE_X',\n      parent: null,\n      title: 'T'\n    });\n    const { mkdtemp, rm } = await import('node:fs/promises');\n    const { tmpdir } = await import('node:os');\n    const { join } = await import('node:path');\n    const dir = await mkdtemp(join(tmpdir(), 'export-out-'));\n    const outPath = join(dir, 'x.png');\n    const tool = createExportTool({\n      fs,\n      store,\n      session,\n      engineLock,\n      urlBuilder,\n      allowOutPath: true\n    });\n    const result = await tool.call({\n      target: 'image',\n      format: 'png',\n      revision: root.id,\n      blockId: 5,\n      outPath\n    });\n    const body = JSON.parse((result.content[0] as { text: string }).text) as {\n      path?: string;\n      httpUrl?: string;\n    };\n    expect(body.path).toBe(outPath);\n    expect(body.httpUrl).toBeUndefined();\n    await rm(dir, { recursive: true });\n  });\n\n  it('rejects `outPath` when not allowed (Hosted/sandbox)', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createExportTool({\n      fs,\n      store,\n      session,\n      engineLock,\n      urlBuilder,\n      allowOutPath: false\n    });\n    const result = await tool.call({\n      target: 'image',\n      format: 'png',\n      revision: root.id,\n      blockId: 5,\n      outPath: '/tmp/x'\n    });\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(\n      /outPath.*not.*supported/i\n    );\n  });\n\n  it('omits `outPath` from the schema when not allowed (Hosted), advertises it when allowed (Local)', () => {\n    const { fs, store, session } = makeDeps();\n    const base = { fs, store, session, engineLock, urlBuilder };\n    const hosted = createExportTool({ ...base, allowOutPath: false });\n    const local = createExportTool({ ...base, allowOutPath: true });\n    const props = (s: unknown) =>\n      (s as { properties: Record<string, unknown> }).properties;\n    expect(props(hosted.inputSchema)).not.toHaveProperty('outPath');\n    expect(props(local.inputSchema)).toHaveProperty('outPath');\n  });\n\n  it('rejects target=scene (moved to the save tool)', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createExportTool({\n      fs,\n      store,\n      session,\n      engineLock,\n      urlBuilder\n    });\n    const result = await tool.call({\n      target: 'scene',\n      format: 'scene',\n      revision: root.id,\n      blockId: 5\n    });\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(\n      /invalid format/i\n    );\n  });\n});\n"]}

package/dist/test/test/tools/index.test.d.ts

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

package/dist/test/test/tools/index.test.d.ts.map

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

package/dist/test/test/tools/index.test.js

@@ -0,0 +1,55 @@
+import { describe, expect, it } from 'vitest';
+import { buildDesignToolRegistrations } from '../../src/tools/index.js';
+// The tool factories only close over their deps (they touch them on `call`,
+// not at construction), so stub primitives are enough to assert which tools
+// get registered.
+const stub = {};
+function gateway(available) {
+    return {
+        available,
+        generateImage: async () => ({
+            bytes: new Uint8Array(),
+            mimeType: 'image/png'
+        })
+    };
+}
+function toolNames(available) {
+    return buildDesignToolRegistrations({
+        fs: stub,
+        store: stub,
+        session: stub,
+        engineLock: stub,
+        gateway: gateway(available),
+        urlBuilder: stub,
+        allowOutPath: true
+    }).map((t) => t.name);
+}
+// asset_generate is hidden for the beta via the ASSET_GENERATE_ENABLED
+// kill-switch in src/tools/index.ts, so it is omitted regardless of gateway
+// availability. When the feature ships and the flag flips back to true, the
+// "available" case should assert it IS registered again.
+describe('buildDesignToolRegistrations — asset_generate gating (beta: hidden)', () => {
+    const alwaysOn = [
+        'edit',
+        'preview',
+        'export',
+        'save',
+        'list',
+        'history',
+        'inspect',
+        'rename',
+        'open_editor',
+        'asset_search'
+    ];
+    it('omits asset_generate when the gateway is unavailable (no API_KEY)', () => {
+        const names = toolNames(false);
+        expect(names).not.toContain('asset_generate');
+        expect(names).toEqual(alwaysOn);
+    });
+    it('stays hidden even when the gateway is available (beta kill-switch)', () => {
+        const names = toolNames(true);
+        expect(names).not.toContain('asset_generate');
+        expect(names).toEqual(alwaysOn);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/test/test/tools/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../../test/tools/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAExE,4EAA4E;AAC5E,4EAA4E;AAC5E,kBAAkB;AAClB,MAAM,IAAI,GAAG,EAAW,CAAC;AAEzB,SAAS,OAAO,CAAC,SAAkB;IACjC,OAAO;QACL,SAAS;QACT,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAC1B,KAAK,EAAE,IAAI,UAAU,EAAE;YACvB,QAAQ,EAAE,WAAW;SACtB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,SAAkB;IACnC,OAAO,4BAA4B,CAAC;QAClC,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;QAC3B,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,uEAAuE;AACvE,4EAA4E;AAC5E,4EAA4E;AAC5E,yDAAyD;AACzD,QAAQ,CAAC,qEAAqE,EAAE,GAAG,EAAE;IACnF,MAAM,QAAQ,GAAG;QACf,MAAM;QACN,SAAS;QACT,QAAQ;QACR,MAAM;QACN,MAAM;QACN,SAAS;QACT,SAAS;QACT,QAAQ;QACR,aAAa;QACb,cAAc;KACf,CAAC;IAEF,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport type { GatewayClient } from '../../src/gateway/types.js';\nimport { buildDesignToolRegistrations } from '../../src/tools/index.js';\n\n// The tool factories only close over their deps (they touch them on `call`,\n// not at construction), so stub primitives are enough to assert which tools\n// get registered.\nconst stub = {} as never;\n\nfunction gateway(available: boolean): GatewayClient {\n  return {\n    available,\n    generateImage: async () => ({\n      bytes: new Uint8Array(),\n      mimeType: 'image/png'\n    })\n  };\n}\n\nfunction toolNames(available: boolean): string[] {\n  return buildDesignToolRegistrations({\n    fs: stub,\n    store: stub,\n    session: stub,\n    engineLock: stub,\n    gateway: gateway(available),\n    urlBuilder: stub,\n    allowOutPath: true\n  }).map((t) => t.name);\n}\n\n// asset_generate is hidden for the beta via the ASSET_GENERATE_ENABLED\n// kill-switch in src/tools/index.ts, so it is omitted regardless of gateway\n// availability. When the feature ships and the flag flips back to true, the\n// \"available\" case should assert it IS registered again.\ndescribe('buildDesignToolRegistrations — asset_generate gating (beta: hidden)', () => {\n  const alwaysOn = [\n    'edit',\n    'preview',\n    'export',\n    'save',\n    'list',\n    'history',\n    'inspect',\n    'rename',\n    'open_editor',\n    'asset_search'\n  ];\n\n  it('omits asset_generate when the gateway is unavailable (no API_KEY)', () => {\n    const names = toolNames(false);\n    expect(names).not.toContain('asset_generate');\n    expect(names).toEqual(alwaysOn);\n  });\n\n  it('stays hidden even when the gateway is available (beta kill-switch)', () => {\n    const names = toolNames(true);\n    expect(names).not.toContain('asset_generate');\n    expect(names).toEqual(alwaysOn);\n  });\n});\n"]}

package/dist/test/test/tools/metrics.test.d.ts

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

package/dist/test/test/tools/metrics.test.d.ts.map

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

package/dist/test/test/tools/metrics.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from 'vitest';
+import { MetricsRecorder } from '../../src/metrics/recorder.js';
+import { createMetricsTool } from '../../src/tools/metrics.js';
+describe('metrics tool', () => {
+    it('returns the recorder snapshot plus live session facts', async () => {
+        const recorder = new MetricsRecorder();
+        recorder.record({ tool: 'edit', durationMs: 120, ok: true });
+        recorder.record({ tool: 'edit', durationMs: 80, ok: false });
+        const tool = createMetricsTool({
+            recorder,
+            activeSessions: () => 3,
+            maxSessions: 5
+        });
+        expect(tool.name).toBe('metrics');
+        const result = await tool.call({});
+        const first = result.content[0];
+        if (first.type !== 'text')
+            throw new Error('expected text content');
+        const body = JSON.parse(first.text);
+        const edit = body.tools.find((t) => t.tool === 'edit');
+        expect(edit?.count).toBe(2);
+        expect(edit?.errorCount).toBe(1);
+        expect(body.recent).toHaveLength(2);
+        expect(body.activeSessions).toBe(3);
+        expect(body.maxSessions).toBe(5);
+        expect(body.uptimeMs).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=metrics.test.js.map

package/dist/test/test/tools/metrics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.test.js","sourceRoot":"","sources":["../../../../test/tools/metrics.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,iBAAiB,CAAC;YAC7B,QAAQ;YACR,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;YACvB,WAAW,EAAE,CAAC;SACf,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAElC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAMjC,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { MetricsRecorder } from '../../src/metrics/recorder.js';\nimport { createMetricsTool } from '../../src/tools/metrics.js';\n\ndescribe('metrics tool', () => {\n  it('returns the recorder snapshot plus live session facts', async () => {\n    const recorder = new MetricsRecorder();\n    recorder.record({ tool: 'edit', durationMs: 120, ok: true });\n    recorder.record({ tool: 'edit', durationMs: 80, ok: false });\n    const tool = createMetricsTool({\n      recorder,\n      activeSessions: () => 3,\n      maxSessions: 5\n    });\n    expect(tool.name).toBe('metrics');\n\n    const result = await tool.call({});\n    const first = result.content[0];\n    if (first.type !== 'text') throw new Error('expected text content');\n    const body = JSON.parse(first.text) as {\n      tools: Array<{ tool: string; count: number; errorCount: number }>;\n      recent: unknown[];\n      activeSessions: number;\n      maxSessions: number;\n      uptimeMs: number;\n    };\n    const edit = body.tools.find((t) => t.tool === 'edit');\n    expect(edit?.count).toBe(2);\n    expect(edit?.errorCount).toBe(1);\n    expect(body.recent).toHaveLength(2);\n    expect(body.activeSessions).toBe(3);\n    expect(body.maxSessions).toBe(5);\n    expect(body.uptimeMs).toBeGreaterThan(0);\n  });\n});\n"]}

package/dist/test/test/tools/preview.test.js

@@ -1,8 +1,10 @@
 import { describe, expect, it, vi } from 'vitest';
+import { Mutex } from '../../src/engine/mutex.js';
 import { EngineSession } from '../../src/engine/session.js';
 import { RevisionStore } from '../../src/revisions/store.js';
 import { createPreviewTool } from '../../src/tools/preview.js';
 import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+const engineLock = new Mutex();
 function makeDeps() {
     const fs = new InMemoryWorkspaceFS();
     const store = new RevisionStore(fs);
@@ -31,7 +33,7 @@ describe('preview tool', () => {
         const slot = await session.acquire(null);
         session.commit(slot, 'rev_warm');
         fakeEngine._scene = 'WARM';
-        const tool = createPreviewTool({ store, session });
+        const tool = createPreviewTool({ store, session, engineLock });
         const result = await tool.call({ blockId: 42 });
         expect(result.isError).toBeFalsy();
         expect(result.content[0].type).toBe('image');
@@ -41,7 +43,7 @@ describe('preview tool', () => {
     });
     it('returns isError when no revision supplied AND no warm slot exists', async () => {
         const { store, session } = makeDeps();
-        const tool = createPreviewTool({ store, session });
+        const tool = createPreviewTool({ store, session, engineLock });
         const result = await tool.call({ blockId: 42 });
         expect(result.isError).toBe(true);
         expect(result.content[0].text).toMatch(/no.*engine.*state/i);
@@ -53,7 +55,7 @@ describe('preview tool', () => {
             parent: null,
             title: 'T'
         });
-        const tool = createPreviewTool({ store, session });
+        const tool = createPreviewTool({ store, session, engineLock });
         // adapter.loadFromString is set as a plain async fn (not a vi.fn) above, so wrap it
         const loadSpy = vi.spyOn(adapter, 'loadFromString');
         await tool.call({ blockId: 42, revision: root.id });
@@ -63,7 +65,7 @@ describe('preview tool', () => {
         const { store, session, fakeEngine } = makeDeps();
         const slot = await session.acquire(null);
         session.commit(slot, 'rev_warm');
-        const tool = createPreviewTool({ store, session });
+        const tool = createPreviewTool({ store, session, engineLock });
         await tool.call({ blockId: 42, width: 9999, height: 9999 });
         const call = fakeEngine.block.export.mock
             .calls[0];

package/dist/test/test/tools/preview.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"preview.test.js","sourceRoot":"","sources":["../../../../test/tools/preview.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';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { createPreviewTool } from '../../src/tools/preview.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\ninterface FakeEngine {\n  _scene: string;\n  block: { export: ReturnType<typeof vi.fn> };\n}\n\nfunction makeDeps() {\n  const fs = new InMemoryWorkspaceFS();\n  const store = new RevisionStore(fs);\n  const fakeEngine: FakeEngine = {\n    _scene: '',\n    block: {\n      export: vi.fn(\n        async (_id: number, _mime: string) =>\n          new Blob([new Uint8Array([1, 2, 3, 4])])\n      )\n    }\n  };\n  const adapter: EngineAdapter<FakeEngine> = {\n    create: () => fakeEngine,\n    reset: async (e) => {\n      e._scene = 'EMPTY';\n    },\n    loadFromString: async (e, s) => {\n      e._scene = s;\n    },\n    saveToString: async (e) => e._scene\n  };\n  const session = new EngineSession<FakeEngine>({ size: 1, adapter });\n  return { fs, store, session, fakeEngine, adapter };\n}\n\ndescribe('preview tool', () => {\n  it('renders the active engine state when no revision is supplied', async () => {\n    const { store, session, fakeEngine } = makeDeps();\n    const slot = await session.acquire(null);\n    session.commit(slot, 'rev_warm');\n    fakeEngine._scene = 'WARM';\n    const tool = createPreviewTool({ store, session });\n    const result = await tool.call({ blockId: 42 });\n    expect(result.isError).toBeFalsy();\n    expect((result.content[0] as { type: string }).type).toBe('image');\n    expect(fakeEngine.block.export).toHaveBeenCalledWith(\n      42,\n      'image/webp',\n      expect.any(Object)\n    );\n    // Engine state is preserved (NOT reset) when no revision is supplied.\n    expect(fakeEngine._scene).toBe('WARM');\n  });\n\n  it('returns isError when no revision supplied AND no warm slot exists', async () => {\n    const { store, session } = makeDeps();\n    const tool = createPreviewTool({ store, session });\n    const result = await tool.call({ blockId: 42 });\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(\n      /no.*engine.*state/i\n    );\n  });\n\n  it('loads a revision into the engine when `revision` is supplied', async () => {\n    const { store, session, adapter } = makeDeps();\n    const root = await store.write({\n      scene: 'SCENE_FOR_PREVIEW',\n      parent: null,\n      title: 'T'\n    });\n    const tool = createPreviewTool({ store, session });\n    // adapter.loadFromString is set as a plain async fn (not a vi.fn) above, so wrap it\n    const loadSpy = vi.spyOn(adapter, 'loadFromString');\n    await tool.call({ blockId: 42, revision: root.id });\n    expect(loadSpy).toHaveBeenCalledWith(\n      expect.anything(),\n      'SCENE_FOR_PREVIEW'\n    );\n  });\n\n  it('clamps width/height to 1800 px', async () => {\n    const { store, session, fakeEngine } = makeDeps();\n    const slot = await session.acquire(null);\n    session.commit(slot, 'rev_warm');\n    const tool = createPreviewTool({ store, session });\n    await tool.call({ blockId: 42, width: 9999, height: 9999 });\n    const call = (fakeEngine.block.export as ReturnType<typeof vi.fn>).mock\n      .calls[0];\n    expect(call[2]).toMatchObject({ targetWidth: 1800, targetHeight: 1800 });\n  });\n});\n"]}
+{"version":3,"file":"preview.test.js","sourceRoot":"","sources":["../../../../test/tools/preview.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from 'vitest';\nimport { Mutex } from '../../src/engine/mutex.js';\nimport { type EngineAdapter, EngineSession } from '../../src/engine/session.js';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { createPreviewTool } from '../../src/tools/preview.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\nconst engineLock = new Mutex();\n\ninterface FakeEngine {\n  _scene: string;\n  block: { export: ReturnType<typeof vi.fn> };\n}\n\nfunction makeDeps() {\n  const fs = new InMemoryWorkspaceFS();\n  const store = new RevisionStore(fs);\n  const fakeEngine: FakeEngine = {\n    _scene: '',\n    block: {\n      export: vi.fn(\n        async (_id: number, _mime: string) =>\n          new Blob([new Uint8Array([1, 2, 3, 4])])\n      )\n    }\n  };\n  const adapter: EngineAdapter<FakeEngine> = {\n    create: () => fakeEngine,\n    reset: async (e) => {\n      e._scene = 'EMPTY';\n    },\n    loadFromString: async (e, s) => {\n      e._scene = s;\n    },\n    saveToString: async (e) => e._scene\n  };\n  const session = new EngineSession<FakeEngine>({ size: 1, adapter });\n  return { fs, store, session, fakeEngine, adapter };\n}\n\ndescribe('preview tool', () => {\n  it('renders the active engine state when no revision is supplied', async () => {\n    const { store, session, fakeEngine } = makeDeps();\n    const slot = await session.acquire(null);\n    session.commit(slot, 'rev_warm');\n    fakeEngine._scene = 'WARM';\n    const tool = createPreviewTool({ store, session, engineLock });\n    const result = await tool.call({ blockId: 42 });\n    expect(result.isError).toBeFalsy();\n    expect((result.content[0] as { type: string }).type).toBe('image');\n    expect(fakeEngine.block.export).toHaveBeenCalledWith(\n      42,\n      'image/webp',\n      expect.any(Object)\n    );\n    // Engine state is preserved (NOT reset) when no revision is supplied.\n    expect(fakeEngine._scene).toBe('WARM');\n  });\n\n  it('returns isError when no revision supplied AND no warm slot exists', async () => {\n    const { store, session } = makeDeps();\n    const tool = createPreviewTool({ store, session, engineLock });\n    const result = await tool.call({ blockId: 42 });\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(\n      /no.*engine.*state/i\n    );\n  });\n\n  it('loads a revision into the engine when `revision` is supplied', async () => {\n    const { store, session, adapter } = makeDeps();\n    const root = await store.write({\n      scene: 'SCENE_FOR_PREVIEW',\n      parent: null,\n      title: 'T'\n    });\n    const tool = createPreviewTool({ store, session, engineLock });\n    // adapter.loadFromString is set as a plain async fn (not a vi.fn) above, so wrap it\n    const loadSpy = vi.spyOn(adapter, 'loadFromString');\n    await tool.call({ blockId: 42, revision: root.id });\n    expect(loadSpy).toHaveBeenCalledWith(\n      expect.anything(),\n      'SCENE_FOR_PREVIEW'\n    );\n  });\n\n  it('clamps width/height to 1800 px', async () => {\n    const { store, session, fakeEngine } = makeDeps();\n    const slot = await session.acquire(null);\n    session.commit(slot, 'rev_warm');\n    const tool = createPreviewTool({ store, session, engineLock });\n    await tool.call({ blockId: 42, width: 9999, height: 9999 });\n    const call = (fakeEngine.block.export as ReturnType<typeof vi.fn>).mock\n      .calls[0];\n    expect(call[2]).toMatchObject({ targetWidth: 1800, targetHeight: 1800 });\n  });\n});\n"]}

package/dist/test/test/tools/rename.test.js

@@ -10,8 +10,7 @@ describe('rename tool', () => {
         const tool = createRenameTool({ store });
         const result = await tool.call({ revision: r2.id, title: 'New' });
         expect(result.content[0].text).toContain('ok');
-        const root = await store.read(r1.id);
-        expect(root.meta.title).toBe('New');
+        expect(await store.currentTitle(r1.id)).toBe('New');
     });
 });
 //# sourceMappingURL=rename.test.js.map

package/dist/test/test/tools/rename.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"rename.test.js","sourceRoot":"","sources":["../../../../test/tools/rename.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,MAAM,CAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAsB,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { createRenameTool } from '../../src/tools/rename.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\ndescribe('rename tool', () => {\n  it('renames the root reachable from the given revision', async () => {\n    const store = new RevisionStore(new InMemoryWorkspaceFS());\n    const r1 = await store.write({ scene: 'a', parent: null, title: 'Old' });\n    const r2 = await store.write({ scene: 'b', parent: r1.id });\n    const tool = createRenameTool({ store });\n    const result = await tool.call({ revision: r2.id, title: 'New' });\n    expect((result.content[0] as { text: string }).text).toContain('ok');\n    const root = await store.read(r1.id);\n    expect(root.meta.title).toBe('New');\n  });\n});\n"]}
+{"version":3,"file":"rename.test.js","sourceRoot":"","sources":["../../../../test/tools/rename.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,MAAM,CAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAsB,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,CAAC,MAAM,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { createRenameTool } from '../../src/tools/rename.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\ndescribe('rename tool', () => {\n  it('renames the root reachable from the given revision', async () => {\n    const store = new RevisionStore(new InMemoryWorkspaceFS());\n    const r1 = await store.write({ scene: 'a', parent: null, title: 'Old' });\n    const r2 = await store.write({ scene: 'b', parent: r1.id });\n    const tool = createRenameTool({ store });\n    const result = await tool.call({ revision: r2.id, title: 'New' });\n    expect((result.content[0] as { text: string }).text).toContain('ok');\n    expect(await store.currentTitle(r1.id)).toBe('New');\n  });\n});\n"]}

package/dist/test/test/tools/save.test.d.ts

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

package/dist/test/test/tools/save.test.d.ts.map

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

package/dist/test/test/tools/save.test.js

@@ -0,0 +1,137 @@
+import { describe, expect, it, vi } from 'vitest';
+import { Mutex } from '../../src/engine/mutex.js';
+import { EngineSession } from '../../src/engine/session.js';
+import { RevisionStore } from '../../src/revisions/store.js';
+import { createSaveTool } from '../../src/tools/save.js';
+import { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+const engineLock = new Mutex();
+const urlBuilder = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:9000' });
+function makeDeps() {
+    const fs = new InMemoryWorkspaceFS();
+    const store = new RevisionStore(fs);
+    const fakeEngine = {
+        _scene: '',
+        _resourcesLoaded: false,
+        scene: {
+            getPages: vi.fn(() => [10]),
+            // The archive bundles the asset marker ONLY if resources were loaded
+            // first — mirrors saveToArchive's "assets accessible when called" contract.
+            saveToArchive: vi.fn(async () => {
+                const body = fakeEngine._resourcesLoaded ? 'ZIP+ASSET' : 'ZIP';
+                return new Blob([new TextEncoder().encode(body)]);
+            })
+        },
+        block: {
+            forceLoadResources: vi.fn(async () => {
+                fakeEngine._resourcesLoaded = true;
+            })
+        }
+    };
+    const adapter = {
+        create: () => fakeEngine,
+        reset: async (e) => {
+            e._scene = 'EMPTY';
+        },
+        loadFromString: async (e, s) => {
+            e._scene = s;
+        },
+        saveToString: async (e) => e._scene
+    };
+    const session = new EngineSession({ size: 1, adapter });
+    return { fs, store, session, fakeEngine };
+}
+describe('save tool', () => {
+    it('writes archive.zip and returns uri + httpUrl, no path', async () => {
+        const { fs, store, session } = makeDeps();
+        const root = await store.write({
+            scene: 'SCENE_ABC',
+            parent: null,
+            title: 'T'
+        });
+        const tool = createSaveTool({ fs, store, session, engineLock, urlBuilder });
+        const result = await tool.call({ revision: root.id });
+        const body = JSON.parse(result.content[0].text);
+        const shard = root.id.slice(0, 2);
+        const rest = root.id.slice(2);
+        expect(body.uri).toBe(`workspace://exports/${shard}/${rest}/archive.zip`);
+        expect(body.httpUrl).toBe(`http://127.0.0.1:9000/r/exports/${shard}/${rest}/archive.zip`);
+        expect(body.path).toBeUndefined();
+        expect(body.format).toBe('archive');
+        expect(body.revision).toBe(root.id);
+        expect(await fs.exists(`exports/${shard}/${rest}/archive.zip`)).toBe(true);
+    });
+    it('respects local `outPath` escape hatch — returns path, not httpUrl', async () => {
+        const { fs, store, session } = makeDeps();
+        const root = await store.write({ scene: 'S', parent: null, title: 'T' });
+        const { mkdtemp, rm } = await import('node:fs/promises');
+        const { tmpdir } = await import('node:os');
+        const { join } = await import('node:path');
+        const dir = await mkdtemp(join(tmpdir(), 'save-out-'));
+        const outPath = join(dir, 'design.zip');
+        const tool = createSaveTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            urlBuilder,
+            allowOutPath: true
+        });
+        const result = await tool.call({ revision: root.id, outPath });
+        const body = JSON.parse(result.content[0].text);
+        expect(body.path).toBe(outPath);
+        expect(body.httpUrl).toBeUndefined();
+        await rm(dir, { recursive: true });
+    });
+    it('rejects `outPath` when not allowed (Hosted/sandbox)', async () => {
+        const { fs, store, session } = makeDeps();
+        const root = await store.write({ scene: 'S', parent: null, title: 'T' });
+        const tool = createSaveTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            urlBuilder,
+            allowOutPath: false
+        });
+        const result = await tool.call({
+            revision: root.id,
+            outPath: '/tmp/x.zip'
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/outPath.*not.*supported/i);
+    });
+    it('omits `outPath` from the schema when not allowed (Hosted), advertises it when allowed (Local)', () => {
+        const { fs, store, session } = makeDeps();
+        const base = { fs, store, session, engineLock, urlBuilder };
+        const hosted = createSaveTool({ ...base, allowOutPath: false });
+        const local = createSaveTool({ ...base, allowOutPath: true });
+        const props = (s) => s.properties;
+        expect(props(hosted.inputSchema)).not.toHaveProperty('outPath');
+        expect(props(local.inputSchema)).toHaveProperty('outPath');
+    });
+    it('errors when revision is missing', async () => {
+        const { fs, store, session } = makeDeps();
+        const tool = createSaveTool({ fs, store, session, engineLock, urlBuilder });
+        const result = await tool.call({});
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/revision/i);
+    });
+    it('force-loads resources before archiving so assets are bundled', async () => {
+        const { fs, store, session, fakeEngine } = makeDeps();
+        const root = await store.write({ scene: 'S', parent: null, title: 'T' });
+        const tool = createSaveTool({ fs, store, session, engineLock, urlBuilder });
+        await tool.call({ revision: root.id });
+        // forceLoadResources must run with the scene's pages...
+        expect(fakeEngine.block.forceLoadResources).toHaveBeenCalledWith([10]);
+        // ...and BEFORE saveToArchive.
+        const callOrder = (m) => m.mock.invocationCallOrder[0];
+        expect(callOrder(fakeEngine.block.forceLoadResources)).toBeLessThan(callOrder(fakeEngine.scene.saveToArchive));
+        // ...so the produced archive actually contains the asset bytes.
+        const shard = root.id.slice(0, 2);
+        const rest = root.id.slice(2);
+        const zip = await fs.readFile(`exports/${shard}/${rest}/archive.zip`, 'utf8');
+        expect(zip).toContain('ASSET');
+    });
+});
+//# sourceMappingURL=save.test.js.map

package/dist/test/test/tools/save.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.test.js","sourceRoot":"","sources":["../../../../test/tools/save.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from 'vitest';\nimport { Mutex } from '../../src/engine/mutex.js';\nimport { type EngineAdapter, EngineSession } from '../../src/engine/session.js';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { createSaveTool } from '../../src/tools/save.js';\nimport { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\nconst engineLock = new Mutex();\nconst urlBuilder = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:9000' });\n\ninterface FakeEngine {\n  _scene: string;\n  _resourcesLoaded: boolean;\n  scene: {\n    getPages: ReturnType<typeof vi.fn>;\n    saveToArchive: ReturnType<typeof vi.fn>;\n  };\n  block: { forceLoadResources: ReturnType<typeof vi.fn> };\n}\n\nfunction makeDeps() {\n  const fs = new InMemoryWorkspaceFS();\n  const store = new RevisionStore(fs);\n  const fakeEngine: FakeEngine = {\n    _scene: '',\n    _resourcesLoaded: false,\n    scene: {\n      getPages: vi.fn(() => [10]),\n      // The archive bundles the asset marker ONLY if resources were loaded\n      // first — mirrors saveToArchive's \"assets accessible when called\" contract.\n      saveToArchive: vi.fn(async () => {\n        const body = fakeEngine._resourcesLoaded ? 'ZIP+ASSET' : 'ZIP';\n        return new Blob([new TextEncoder().encode(body)]);\n      })\n    },\n    block: {\n      forceLoadResources: vi.fn(async () => {\n        fakeEngine._resourcesLoaded = true;\n      })\n    }\n  };\n  const adapter: EngineAdapter<FakeEngine> = {\n    create: () => fakeEngine,\n    reset: async (e) => {\n      e._scene = 'EMPTY';\n    },\n    loadFromString: async (e, s) => {\n      e._scene = s;\n    },\n    saveToString: async (e) => e._scene\n  };\n  const session = new EngineSession<FakeEngine>({ size: 1, adapter });\n  return { fs, store, session, fakeEngine };\n}\n\ndescribe('save tool', () => {\n  it('writes archive.zip and returns uri + httpUrl, no path', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({\n      scene: 'SCENE_ABC',\n      parent: null,\n      title: 'T'\n    });\n    const tool = createSaveTool({ fs, store, session, engineLock, urlBuilder });\n    const result = await tool.call({ revision: root.id });\n    const body = JSON.parse((result.content[0] as { text: string }).text) as {\n      uri: string;\n      httpUrl?: string;\n      path?: string;\n      bytes: number;\n      format: string;\n      revision: string;\n    };\n    const shard = root.id.slice(0, 2);\n    const rest = root.id.slice(2);\n    expect(body.uri).toBe(`workspace://exports/${shard}/${rest}/archive.zip`);\n    expect(body.httpUrl).toBe(\n      `http://127.0.0.1:9000/r/exports/${shard}/${rest}/archive.zip`\n    );\n    expect(body.path).toBeUndefined();\n    expect(body.format).toBe('archive');\n    expect(body.revision).toBe(root.id);\n    expect(await fs.exists(`exports/${shard}/${rest}/archive.zip`)).toBe(true);\n  });\n\n  it('respects local `outPath` escape hatch — returns path, not httpUrl', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const { mkdtemp, rm } = await import('node:fs/promises');\n    const { tmpdir } = await import('node:os');\n    const { join } = await import('node:path');\n    const dir = await mkdtemp(join(tmpdir(), 'save-out-'));\n    const outPath = join(dir, 'design.zip');\n    const tool = createSaveTool({\n      fs,\n      store,\n      session,\n      engineLock,\n      urlBuilder,\n      allowOutPath: true\n    });\n    const result = await tool.call({ revision: root.id, outPath });\n    const body = JSON.parse((result.content[0] as { text: string }).text) as {\n      path?: string;\n      httpUrl?: string;\n    };\n    expect(body.path).toBe(outPath);\n    expect(body.httpUrl).toBeUndefined();\n    await rm(dir, { recursive: true });\n  });\n\n  it('rejects `outPath` when not allowed (Hosted/sandbox)', async () => {\n    const { fs, store, session } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createSaveTool({\n      fs,\n      store,\n      session,\n      engineLock,\n      urlBuilder,\n      allowOutPath: false\n    });\n    const result = await tool.call({\n      revision: root.id,\n      outPath: '/tmp/x.zip'\n    });\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(\n      /outPath.*not.*supported/i\n    );\n  });\n\n  it('omits `outPath` from the schema when not allowed (Hosted), advertises it when allowed (Local)', () => {\n    const { fs, store, session } = makeDeps();\n    const base = { fs, store, session, engineLock, urlBuilder };\n    const hosted = createSaveTool({ ...base, allowOutPath: false });\n    const local = createSaveTool({ ...base, allowOutPath: true });\n    const props = (s: unknown) =>\n      (s as { properties: Record<string, unknown> }).properties;\n    expect(props(hosted.inputSchema)).not.toHaveProperty('outPath');\n    expect(props(local.inputSchema)).toHaveProperty('outPath');\n  });\n\n  it('errors when revision is missing', async () => {\n    const { fs, store, session } = makeDeps();\n    const tool = createSaveTool({ fs, store, session, engineLock, urlBuilder });\n    const result = await tool.call({});\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(/revision/i);\n  });\n\n  it('force-loads resources before archiving so assets are bundled', async () => {\n    const { fs, store, session, fakeEngine } = makeDeps();\n    const root = await store.write({ scene: 'S', parent: null, title: 'T' });\n    const tool = createSaveTool({ fs, store, session, engineLock, urlBuilder });\n    await tool.call({ revision: root.id });\n\n    // forceLoadResources must run with the scene's pages...\n    expect(fakeEngine.block.forceLoadResources).toHaveBeenCalledWith([10]);\n    // ...and BEFORE saveToArchive.\n    const callOrder = (m: ReturnType<typeof vi.fn>): number =>\n      m.mock.invocationCallOrder[0];\n    expect(callOrder(fakeEngine.block.forceLoadResources)).toBeLessThan(\n      callOrder(fakeEngine.scene.saveToArchive)\n    );\n\n    // ...so the produced archive actually contains the asset bytes.\n    const shard = root.id.slice(0, 2);\n    const rest = root.id.slice(2);\n    const zip = await fs.readFile(\n      `exports/${shard}/${rest}/archive.zip`,\n      'utf8'\n    );\n    expect(zip).toContain('ASSET');\n  });\n});\n"]}