@imgly/codesign-mcp 0.1.0

package/dist/test/test/tools/asset-generate.test.d.ts.map

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

package/dist/test/test/tools/asset-generate.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it } from 'vitest';
+import { LocalGatewayClient } from '../../src/gateway/local.js';
+import { createAssetGenerateTool } from '../../src/tools/asset-generate.js';
+import { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+const urlBuilder = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:9000' });
+describe('asset_generate tool', () => {
+    it('generates an image and persists it in the workspace under assets/', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const fakeFetch = async () => new Response(new Uint8Array([1, 2, 3, 4, 5]), {
+            headers: { 'content-type': 'image/png' }
+        });
+        const client = new LocalGatewayClient({
+            apiKey: 'k',
+            endpoint: 'https://x',
+            fetch: fakeFetch
+        });
+        const tool = createAssetGenerateTool({ gateway: client, fs, urlBuilder });
+        const result = await tool.call({
+            kind: 'image',
+            prompt: 'a sunny meadow',
+            width: 512,
+            height: 512
+        });
+        expect(result.isError).toBeFalsy();
+        const body = JSON.parse(result.content[0].text);
+        expect(body.uri).toMatch(/^workspace:\/\/assets\/[0-9a-f]{12}\.png$/);
+        expect(body.mimeType).toBe('image/png');
+        // Bytes are persisted
+        const relPath = body.uri.replace('workspace://', '');
+        expect((await fs.readFile(relPath)).length).toBe(5);
+    });
+    it('returns isError when the gateway is disabled', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const client = new LocalGatewayClient({ apiKey: undefined });
+        const tool = createAssetGenerateTool({ gateway: client, fs, urlBuilder });
+        const result = await tool.call({ kind: 'image', prompt: 'x' });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/disabled/i);
+    });
+    it('returns isError for non-image kinds (Phase 4 video/audio)', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const client = new LocalGatewayClient({ apiKey: 'k' });
+        const tool = createAssetGenerateTool({ gateway: client, fs, urlBuilder });
+        const result = await tool.call({ kind: 'video', prompt: 'x' });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/phase 4/i);
+    });
+    it('returns an httpUrl pointing at the /r/ route', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const fakeFetch = async () => new Response(new Uint8Array([1, 2, 3, 4, 5]), {
+            headers: { 'content-type': 'image/png' }
+        });
+        const client = new LocalGatewayClient({
+            apiKey: 'k',
+            endpoint: 'https://x',
+            fetch: fakeFetch
+        });
+        const tool = createAssetGenerateTool({ gateway: client, fs, urlBuilder });
+        const result = await tool.call({ kind: 'image', prompt: 'a sunny meadow' });
+        const body = JSON.parse(result.content[0].text);
+        const relPath = body.uri.replace('workspace://', '');
+        expect(body.httpUrl).toBe(`http://127.0.0.1:9000/r/${relPath}`);
+    });
+});
+//# sourceMappingURL=asset-generate.test.js.map

package/dist/test/test/tools/asset-generate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-generate.test.js","sourceRoot":"","sources":["../../../../test/tools/asset-generate.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { LocalGatewayClient } from '../../src/gateway/local.js';\nimport { createAssetGenerateTool } from '../../src/tools/asset-generate.js';\nimport { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\nconst urlBuilder = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:9000' });\n\ndescribe('asset_generate tool', () => {\n  it('generates an image and persists it in the workspace under assets/', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const fakeFetch = async () =>\n      new Response(new Uint8Array([1, 2, 3, 4, 5]), {\n        headers: { 'content-type': 'image/png' }\n      });\n    const client = new LocalGatewayClient({\n      apiKey: 'k',\n      endpoint: 'https://x',\n      fetch: fakeFetch as typeof globalThis.fetch\n    });\n    const tool = createAssetGenerateTool({ gateway: client, fs, urlBuilder });\n    const result = await tool.call({\n      kind: 'image',\n      prompt: 'a sunny meadow',\n      width: 512,\n      height: 512\n    });\n    expect(result.isError).toBeFalsy();\n    const body = JSON.parse((result.content[0] as { text: string }).text) as {\n      uri: string;\n      mimeType: string;\n    };\n    expect(body.uri).toMatch(/^workspace:\\/\\/assets\\/[0-9a-f]{12}\\.png$/);\n    expect(body.mimeType).toBe('image/png');\n    // Bytes are persisted\n    const relPath = body.uri.replace('workspace://', '');\n    expect((await fs.readFile(relPath)).length).toBe(5);\n  });\n\n  it('returns isError when the gateway is disabled', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const client = new LocalGatewayClient({ apiKey: undefined });\n    const tool = createAssetGenerateTool({ gateway: client, fs, urlBuilder });\n    const result = await tool.call({ kind: 'image', prompt: 'x' });\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(/disabled/i);\n  });\n\n  it('returns isError for non-image kinds (Phase 4 video/audio)', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const client = new LocalGatewayClient({ apiKey: 'k' });\n    const tool = createAssetGenerateTool({ gateway: client, fs, urlBuilder });\n    const result = await tool.call({ kind: 'video', prompt: 'x' });\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(/phase 4/i);\n  });\n\n  it('returns an httpUrl pointing at the /r/ route', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const fakeFetch = async () =>\n      new Response(new Uint8Array([1, 2, 3, 4, 5]), {\n        headers: { 'content-type': 'image/png' }\n      });\n    const client = new LocalGatewayClient({\n      apiKey: 'k',\n      endpoint: 'https://x',\n      fetch: fakeFetch as typeof globalThis.fetch\n    });\n    const tool = createAssetGenerateTool({ gateway: client, fs, urlBuilder });\n    const result = await tool.call({ kind: 'image', prompt: 'a sunny meadow' });\n    const body = JSON.parse((result.content[0] as { text: string }).text) as {\n      uri: string;\n      httpUrl: string;\n    };\n    const relPath = body.uri.replace('workspace://', '');\n    expect(body.httpUrl).toBe(`http://127.0.0.1:9000/r/${relPath}`);\n  });\n});\n"]}

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

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

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

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

package/dist/test/test/tools/edit.test.js

@@ -0,0 +1,205 @@
+// packages/codesign-mcp/test/tools/edit.test.ts
+import { describe, expect, it, vi } from 'vitest';
+import { EngineSession } from '../../src/engine/session.js';
+import { RevisionStore } from '../../src/revisions/store.js';
+import { createEditTool } from '../../src/tools/edit.js';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+function makeDeps() {
+    const fs = new InMemoryWorkspaceFS();
+    const store = new RevisionStore(fs);
+    const fakeEngine = { _scene: '' };
+    const adapter = {
+        create: () => fakeEngine,
+        reset: vi.fn(async () => {
+            fakeEngine._scene = 'EMPTY';
+        }),
+        loadFromString: vi.fn(async (e, s) => {
+            e._scene = s;
+        }),
+        saveToString: vi.fn(async (e) => e._scene)
+    };
+    const session = new EngineSession({ size: 1, adapter });
+    const onLeafWritten = vi.fn();
+    return { fs, store, session, adapter, onLeafWritten, fakeEngine };
+}
+describe('edit tool — happy path', () => {
+    it('parent=null resets engine, writes a root revision, returns {revision, parent}', async () => {
+        const { store, session, adapter, onLeafWritten } = makeDeps();
+        const tool = createEditTool({ store, session, onLeafWritten });
+        // The user `code` is what mutates the engine — it runs AFTER reset/loadFromString
+        // resets the slot. So we set _scene from inside the code string.
+        const result = await tool.call({
+            parent: null,
+            code: "engine._scene = 'ENGINE_AFTER_USER_CODE'",
+            title: 'Wedding card',
+            note: 'blank canvas'
+        });
+        expect(adapter.reset).toHaveBeenCalledOnce();
+        expect(result.isError).toBeFalsy();
+        const part = result.content[0];
+        const envelope = JSON.parse(part.text);
+        expect(envelope.parent).toBeNull();
+        expect(envelope.revision).toMatch(/^[0-9a-f]{12}$/);
+        expect(onLeafWritten).toHaveBeenCalledWith({
+            revision: envelope.revision,
+            rootRevision: envelope.revision
+        });
+        const persisted = await store.read(envelope.revision);
+        expect(persisted.meta.title).toBe('Wedding card');
+        expect(persisted.scene).toBe('ENGINE_AFTER_USER_CODE');
+        // The code that ran is persisted alongside the revision for `inspect`.
+        expect(await store.readCode(envelope.revision)).toBe("engine._scene = 'ENGINE_AFTER_USER_CODE'");
+    });
+    it('parent=existing revision is a linear edit (no reload on warm slot)', async () => {
+        const { store, session, adapter, onLeafWritten } = makeDeps();
+        const tool = createEditTool({ store, session, onLeafWritten });
+        const first = await tool.call({
+            parent: null,
+            code: "engine._scene = 'SCENE_V1'",
+            title: 'T'
+        });
+        const firstRev = JSON.parse(first.content[0].text).revision;
+        adapter.loadFromString.mockClear();
+        const second = await tool.call({
+            parent: firstRev,
+            code: "engine._scene = 'SCENE_V2'",
+            note: 'tweak'
+        });
+        expect(adapter.loadFromString).not.toHaveBeenCalled(); // engine already at firstRev
+        const secondRev = JSON.parse(second.content[0].text).revision;
+        const persisted = await store.read(secondRev);
+        expect(persisted.meta.parent).toBe(firstRev);
+        expect(persisted.scene).toBe('SCENE_V2');
+    });
+    it('parent=older revision reloads engine and creates a fork', async () => {
+        const { store, session, adapter, onLeafWritten } = makeDeps();
+        const tool = createEditTool({ store, session, onLeafWritten });
+        const r1 = await tool.call({
+            parent: null,
+            code: "engine._scene = 'SCENE_V1'",
+            title: 'T'
+        });
+        const rev1 = JSON.parse(r1.content[0].text).revision;
+        const _r2 = await tool.call({
+            parent: rev1,
+            code: "engine._scene = 'SCENE_V2'"
+        });
+        // now rewind: parent = rev1
+        adapter.loadFromString.mockClear();
+        const r3 = await tool.call({
+            parent: rev1,
+            code: "engine._scene = 'SCENE_V3_FORK'"
+        });
+        expect(adapter.loadFromString).toHaveBeenCalledOnce(); // reloaded SCENE_V1
+        const rev3 = JSON.parse(r3.content[0].text).revision;
+        const persisted = await store.read(rev3);
+        expect(persisted.meta.parent).toBe(rev1);
+        expect(persisted.scene).toBe('SCENE_V3_FORK');
+    });
+});
+describe('edit tool — safety + validation', () => {
+    it('marks slot dirty when code throws; next edit pays one reload', async () => {
+        const { store, session, adapter, onLeafWritten } = makeDeps();
+        const tool = createEditTool({ store, session, onLeafWritten });
+        const r1 = await tool.call({
+            parent: null,
+            code: "engine._scene = 'SCENE_V1'",
+            title: 'T'
+        });
+        const rev1 = JSON.parse(r1.content[0].text).revision;
+        const bad = await tool.call({
+            parent: rev1,
+            code: "throw new Error('boom')"
+        });
+        expect(bad.isError).toBe(true);
+        // Populate the session with the scene so we can re-acquire
+        const rev = await store.read(rev1);
+        await session.populate(rev1, rev.scene);
+        const slot = await session.acquire(rev1);
+        // After dirty + re-acquire, loadFromString must have been called.
+        expect(adapter.loadFromString).toHaveBeenCalled();
+        expect(slot.currentRevision).toBe(rev1);
+    });
+    it('returns isError when parent property is missing entirely', async () => {
+        const { store, session } = makeDeps();
+        const tool = createEditTool({ store, session });
+        const result = await tool.call({
+            code: '// no parent'
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/parent.*required/i);
+    });
+    it('returns isError when code is missing', async () => {
+        const { store, session } = makeDeps();
+        const tool = createEditTool({ store, session });
+        const result = await tool.call({ parent: null });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/code.*required/i);
+    });
+    it('returns a teaching error when parent arrives as the literal string "null"', async () => {
+        // LLMs sometimes serialize JSON null as the four-character string "null"
+        // when a tool description mentions `null` in backticks. Catch it
+        // explicitly so the agent learns the right shape on the first try,
+        // instead of seeing "unknown revision: null" from the store and going
+        // fs-diving to figure out what went wrong.
+        const { store, session } = makeDeps();
+        const tool = createEditTool({ store, session });
+        const result = await tool.call({
+            parent: 'null',
+            code: "engine._scene = 'X'"
+        });
+        expect(result.isError).toBe(true);
+        const text = result.content[0].text;
+        expect(text).toMatch(/string "null"/);
+        expect(text).toMatch(/JSON null/);
+    });
+});
+describe('edit tool — per-leaf thumbnail', () => {
+    it('calls renderThumbnail with the new revision id and persists the bytes', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const store = new RevisionStore(fs);
+        const fakeEngine = { _scene: '' };
+        const adapter = {
+            create: () => fakeEngine,
+            reset: vi.fn(async () => { }),
+            loadFromString: vi.fn(async () => { }),
+            saveToString: vi.fn(async () => fakeEngine._scene)
+        };
+        const session = new EngineSession({ size: 1, adapter });
+        const renderThumbnail = vi.fn(async () => new Uint8Array([0x52, 0x49, 0x46, 0x46])); // "RIFF" — webp header
+        const tool = createEditTool({ store, session, renderThumbnail, fs });
+        const r = await tool.call({
+            parent: null,
+            code: "engine._scene = 'SCENE_V1'",
+            title: 'T'
+        });
+        const rev = JSON.parse(r.content[0].text).revision;
+        expect(renderThumbnail).toHaveBeenCalledWith(expect.objectContaining({ revision: rev }));
+        const shard = rev.slice(0, 2);
+        const rest = rev.slice(2);
+        expect(await fs.exists(`exports/${shard}/${rest}/preview.webp`)).toBe(true);
+    });
+    it('does not fail the edit when renderThumbnail throws', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const store = new RevisionStore(fs);
+        const fakeEngine = { _scene: '' };
+        const adapter = {
+            create: () => fakeEngine,
+            reset: vi.fn(async () => { }),
+            loadFromString: vi.fn(async () => { }),
+            saveToString: vi.fn(async () => fakeEngine._scene)
+        };
+        const session = new EngineSession({ size: 1, adapter });
+        const renderThumbnail = vi.fn(async () => {
+            throw new Error('thumbnail render boom');
+        });
+        const tool = createEditTool({ store, session, renderThumbnail, fs });
+        const r = await tool.call({
+            parent: null,
+            code: "engine._scene = 'S'",
+            title: 'T'
+        });
+        expect(r.isError).toBeFalsy();
+    });
+});
+//# sourceMappingURL=edit.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit.test.js","sourceRoot":"","sources":["../../../../test/tools/edit.test.ts"],"names":[],"mappings":"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","sourcesContent":["// packages/codesign-mcp/test/tools/edit.test.ts\nimport { describe, expect, it, vi } from 'vitest';\nimport { type EngineAdapter, EngineSession } from '../../src/engine/session.js';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { createEditTool } from '../../src/tools/edit.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\nfunction makeDeps() {\n  const fs = new InMemoryWorkspaceFS();\n  const store = new RevisionStore(fs);\n  const fakeEngine = { _scene: '' };\n  const adapter: EngineAdapter = {\n    create: () => fakeEngine,\n    reset: vi.fn(async () => {\n      fakeEngine._scene = 'EMPTY';\n    }),\n    loadFromString: vi.fn(async (e, s) => {\n      (e as typeof fakeEngine)._scene = s;\n    }),\n    saveToString: vi.fn(async (e) => (e as typeof fakeEngine)._scene)\n  };\n  const session = new EngineSession({ size: 1, adapter });\n  const onLeafWritten = vi.fn();\n  return { fs, store, session, adapter, onLeafWritten, fakeEngine };\n}\n\ndescribe('edit tool — happy path', () => {\n  it('parent=null resets engine, writes a root revision, returns {revision, parent}', async () => {\n    const { store, session, adapter, onLeafWritten } = makeDeps();\n    const tool = createEditTool({ store, session, onLeafWritten });\n    // The user `code` is what mutates the engine — it runs AFTER reset/loadFromString\n    // resets the slot. So we set _scene from inside the code string.\n    const result = await tool.call({\n      parent: null,\n      code: \"engine._scene = 'ENGINE_AFTER_USER_CODE'\",\n      title: 'Wedding card',\n      note: 'blank canvas'\n    });\n    expect(adapter.reset).toHaveBeenCalledOnce();\n    expect(result.isError).toBeFalsy();\n    const part = result.content[0] as { type: 'text'; text: string };\n    const envelope = JSON.parse(part.text) as {\n      revision: string;\n      parent: string | null;\n    };\n    expect(envelope.parent).toBeNull();\n    expect(envelope.revision).toMatch(/^[0-9a-f]{12}$/);\n    expect(onLeafWritten).toHaveBeenCalledWith({\n      revision: envelope.revision,\n      rootRevision: envelope.revision\n    });\n\n    const persisted = await store.read(envelope.revision);\n    expect(persisted.meta.title).toBe('Wedding card');\n    expect(persisted.scene).toBe('ENGINE_AFTER_USER_CODE');\n    // The code that ran is persisted alongside the revision for `inspect`.\n    expect(await store.readCode(envelope.revision)).toBe(\n      \"engine._scene = 'ENGINE_AFTER_USER_CODE'\"\n    );\n  });\n\n  it('parent=existing revision is a linear edit (no reload on warm slot)', async () => {\n    const { store, session, adapter, onLeafWritten } = makeDeps();\n    const tool = createEditTool({ store, session, onLeafWritten });\n    const first = await tool.call({\n      parent: null,\n      code: \"engine._scene = 'SCENE_V1'\",\n      title: 'T'\n    });\n    const firstRev = JSON.parse(\n      (first.content[0] as { text: string }).text\n    ).revision;\n\n    (adapter.loadFromString as ReturnType<typeof vi.fn>).mockClear();\n    const second = await tool.call({\n      parent: firstRev,\n      code: \"engine._scene = 'SCENE_V2'\",\n      note: 'tweak'\n    });\n    expect(adapter.loadFromString).not.toHaveBeenCalled(); // engine already at firstRev\n    const secondRev = JSON.parse(\n      (second.content[0] as { text: string }).text\n    ).revision;\n    const persisted = await store.read(secondRev);\n    expect(persisted.meta.parent).toBe(firstRev);\n    expect(persisted.scene).toBe('SCENE_V2');\n  });\n\n  it('parent=older revision reloads engine and creates a fork', async () => {\n    const { store, session, adapter, onLeafWritten } = makeDeps();\n    const tool = createEditTool({ store, session, onLeafWritten });\n    const r1 = await tool.call({\n      parent: null,\n      code: \"engine._scene = 'SCENE_V1'\",\n      title: 'T'\n    });\n    const rev1 = JSON.parse((r1.content[0] as { text: string }).text).revision;\n    const _r2 = await tool.call({\n      parent: rev1,\n      code: \"engine._scene = 'SCENE_V2'\"\n    });\n    // now rewind: parent = rev1\n    (adapter.loadFromString as ReturnType<typeof vi.fn>).mockClear();\n    const r3 = await tool.call({\n      parent: rev1,\n      code: \"engine._scene = 'SCENE_V3_FORK'\"\n    });\n    expect(adapter.loadFromString).toHaveBeenCalledOnce(); // reloaded SCENE_V1\n    const rev3 = JSON.parse((r3.content[0] as { text: string }).text).revision;\n    const persisted = await store.read(rev3);\n    expect(persisted.meta.parent).toBe(rev1);\n    expect(persisted.scene).toBe('SCENE_V3_FORK');\n  });\n});\n\ndescribe('edit tool — safety + validation', () => {\n  it('marks slot dirty when code throws; next edit pays one reload', async () => {\n    const { store, session, adapter, onLeafWritten } = makeDeps();\n    const tool = createEditTool({ store, session, onLeafWritten });\n    const r1 = await tool.call({\n      parent: null,\n      code: \"engine._scene = 'SCENE_V1'\",\n      title: 'T'\n    });\n    const rev1 = JSON.parse((r1.content[0] as { text: string }).text).revision;\n\n    const bad = await tool.call({\n      parent: rev1,\n      code: \"throw new Error('boom')\"\n    });\n    expect(bad.isError).toBe(true);\n\n    // Populate the session with the scene so we can re-acquire\n    const rev = await store.read(rev1);\n    await session.populate(rev1, rev.scene);\n\n    const slot = await session.acquire(rev1);\n    // After dirty + re-acquire, loadFromString must have been called.\n    expect(adapter.loadFromString).toHaveBeenCalled();\n    expect(slot.currentRevision).toBe(rev1);\n  });\n\n  it('returns isError when parent property is missing entirely', async () => {\n    const { store, session } = makeDeps();\n    const tool = createEditTool({ store, session });\n    const result = await tool.call({\n      code: '// no parent'\n    } as unknown as Record<string, unknown>);\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(\n      /parent.*required/i\n    );\n  });\n\n  it('returns isError when code is missing', async () => {\n    const { store, session } = makeDeps();\n    const tool = createEditTool({ store, session });\n    const result = await tool.call({ parent: null } as unknown as Record<\n      string,\n      unknown\n    >);\n    expect(result.isError).toBe(true);\n    expect((result.content[0] as { text: string }).text).toMatch(\n      /code.*required/i\n    );\n  });\n\n  it('returns a teaching error when parent arrives as the literal string \"null\"', async () => {\n    // LLMs sometimes serialize JSON null as the four-character string \"null\"\n    // when a tool description mentions `null` in backticks. Catch it\n    // explicitly so the agent learns the right shape on the first try,\n    // instead of seeing \"unknown revision: null\" from the store and going\n    // fs-diving to figure out what went wrong.\n    const { store, session } = makeDeps();\n    const tool = createEditTool({ store, session });\n    const result = await tool.call({\n      parent: 'null',\n      code: \"engine._scene = 'X'\"\n    });\n    expect(result.isError).toBe(true);\n    const text = (result.content[0] as { text: string }).text;\n    expect(text).toMatch(/string \"null\"/);\n    expect(text).toMatch(/JSON null/);\n  });\n});\n\ndescribe('edit tool — per-leaf thumbnail', () => {\n  it('calls renderThumbnail with the new revision id and persists the bytes', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const store = new RevisionStore(fs);\n    const fakeEngine = { _scene: '' };\n    const adapter: EngineAdapter = {\n      create: () => fakeEngine,\n      reset: vi.fn(async () => {}),\n      loadFromString: vi.fn(async () => {}),\n      saveToString: vi.fn(async () => fakeEngine._scene)\n    };\n    const session = new EngineSession({ size: 1, adapter });\n    const renderThumbnail = vi.fn(\n      async () => new Uint8Array([0x52, 0x49, 0x46, 0x46])\n    ); // \"RIFF\" — webp header\n    const tool = createEditTool({ store, session, renderThumbnail, fs });\n    const r = await tool.call({\n      parent: null,\n      code: \"engine._scene = 'SCENE_V1'\",\n      title: 'T'\n    });\n    const rev = JSON.parse((r.content[0] as { text: string }).text).revision;\n    expect(renderThumbnail).toHaveBeenCalledWith(\n      expect.objectContaining({ revision: rev })\n    );\n    const shard = rev.slice(0, 2);\n    const rest = rev.slice(2);\n    expect(await fs.exists(`exports/${shard}/${rest}/preview.webp`)).toBe(true);\n  });\n\n  it('does not fail the edit when renderThumbnail throws', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const store = new RevisionStore(fs);\n    const fakeEngine = { _scene: '' };\n    const adapter: EngineAdapter = {\n      create: () => fakeEngine,\n      reset: vi.fn(async () => {}),\n      loadFromString: vi.fn(async () => {}),\n      saveToString: vi.fn(async () => fakeEngine._scene)\n    };\n    const session = new EngineSession({ size: 1, adapter });\n    const renderThumbnail = vi.fn(async () => {\n      throw new Error('thumbnail render boom');\n    });\n    const tool = createEditTool({ store, session, renderThumbnail, fs });\n    const r = await tool.call({\n      parent: null,\n      code: \"engine._scene = 'S'\",\n      title: 'T'\n    });\n    expect(r.isError).toBeFalsy();\n  });\n});\n"]}

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

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

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

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

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

@@ -0,0 +1,144 @@
+import { describe, expect, it, vi } from 'vitest';
+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 urlBuilder = new LocalViewerUrlBuilder({ base: 'http://127.0.0.1:9000' });
+function makeDeps() {
+    const fs = new InMemoryWorkspaceFS();
+    const store = new RevisionStore(fs);
+    const fakeEngine = {
+        _scene: '',
+        block: {
+            export: vi.fn(async () => new Blob([new Uint8Array([0xff, 0xd8, 0xff, 0xe0])]))
+        },
+        scene: { saveToString: vi.fn(async () => '<scene-serialized/>') }
+    };
+    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('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 result = await tool.call({
+            target: 'image',
+            format: 'png',
+            revision: root.id,
+            blockId: 5
+        });
+        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}/image.png`);
+        expect(await fs.exists(`exports/${shard}/${rest}/image.png`)).toBe(true);
+    });
+    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 });
+        await tool.call({
+            target: 'pdf',
+            format: 'pdf',
+            revision: root.id,
+            blockId: 5
+        });
+        expect(fakeEngine.block.export).toHaveBeenCalledWith(5, 'application/pdf', expect.any(Object));
+    });
+    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 result = await tool.call({
+            target: 'video',
+            format: 'mp4',
+            revision: root.id
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/phase 4/i);
+    });
+    it('respects local `outPath` escape hatch — returns path, not httpUrl', async () => {
+        const { fs, store, session } = makeDeps();
+        const root = await store.write({
+            scene: 'SCENE_X',
+            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(), 'export-out-'));
+        const outPath = join(dir, 'x.scene');
+        const tool = createExportTool({
+            fs,
+            store,
+            session,
+            urlBuilder,
+            allowOutPath: true
+        });
+        const result = await tool.call({
+            target: 'scene',
+            format: 'scene',
+            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 = createExportTool({
+            fs,
+            store,
+            session,
+            urlBuilder,
+            allowOutPath: false
+        });
+        const result = await tool.call({
+            target: 'scene',
+            format: 'scene',
+            revision: root.id,
+            outPath: '/tmp/x'
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toMatch(/outPath.*not.*allowed/i);
+    });
+});
+//# sourceMappingURL=export.test.js.map

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

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

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

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

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

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

package/dist/test/test/tools/history.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from 'vitest';
+import { RevisionStore } from '../../src/revisions/store.js';
+import { createHistoryTool } from '../../src/tools/history.js';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+describe('history tool', () => {
+    it('returns the chain from root to revision', async () => {
+        const store = new RevisionStore(new InMemoryWorkspaceFS());
+        const r1 = await store.write({
+            scene: 'a',
+            parent: null,
+            title: 'T',
+            note: 'init'
+        });
+        const r2 = await store.write({ scene: 'b', parent: r1.id, note: 'tweak' });
+        const r3 = await store.write({ scene: 'c', parent: r2.id, note: 'final' });
+        const tool = createHistoryTool({ store });
+        const result = await tool.call({ revision: r3.id });
+        const chain = JSON.parse(result.content[0].text);
+        expect(chain.map((r) => r.revision)).toEqual([r1.id, r2.id, r3.id]);
+        expect(chain.map((r) => r.note)).toEqual(['init', 'tweak', 'final']);
+    });
+    it('returns isError when revision is missing', async () => {
+        const store = new RevisionStore(new InMemoryWorkspaceFS());
+        const tool = createHistoryTool({ store });
+        const result = await tool.call({ revision: 'deadbeefdead' });
+        expect(result.isError).toBe(true);
+    });
+});
+//# sourceMappingURL=history.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.test.js","sourceRoot":"","sources":["../../../../test/tools/history.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,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC;YAC3B,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,GAAG;YACV,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3E,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CACrB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAsB,CAAC,IAAI,CAK5C,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { createHistoryTool } from '../../src/tools/history.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\ndescribe('history tool', () => {\n  it('returns the chain from root to revision', async () => {\n    const store = new RevisionStore(new InMemoryWorkspaceFS());\n    const r1 = await store.write({\n      scene: 'a',\n      parent: null,\n      title: 'T',\n      note: 'init'\n    });\n    const r2 = await store.write({ scene: 'b', parent: r1.id, note: 'tweak' });\n    const r3 = await store.write({ scene: 'c', parent: r2.id, note: 'final' });\n    const tool = createHistoryTool({ store });\n    const result = await tool.call({ revision: r3.id });\n    const chain = JSON.parse(\n      (result.content[0] as { text: string }).text\n    ) as Array<{\n      revision: string;\n      parent: string | null;\n      note?: string;\n    }>;\n    expect(chain.map((r) => r.revision)).toEqual([r1.id, r2.id, r3.id]);\n    expect(chain.map((r) => r.note)).toEqual(['init', 'tweak', 'final']);\n  });\n\n  it('returns isError when revision is missing', async () => {\n    const store = new RevisionStore(new InMemoryWorkspaceFS());\n    const tool = createHistoryTool({ store });\n    const result = await tool.call({ revision: 'deadbeefdead' });\n    expect(result.isError).toBe(true);\n  });\n});\n"]}

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

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

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

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