@imgly/codesign-mcp 0.1.5 → 0.1.6

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

@@ -0,0 +1,30 @@
+// Shared edit-tool test harness — a plain module (no test registrations) so importing it never re-runs edit.test.ts.
+import { Mutex } from '../../src/engine/mutex.js';
+import { EngineSession } from '../../src/engine/session.js';
+/**
+ * Minimal fake harness shared with edit.telemetry.test.ts.
+ * Uses a fake RevisionStore (write returns id='newrev') and a real EngineSession
+ * with a no-op adapter so the adapter cast inside edit.ts resolves correctly.
+ */
+export function makeEditHarness() {
+    const fakeEngine = {};
+    const adapter = {
+        create: () => fakeEngine,
+        reset: async () => { },
+        loadFromString: async () => { },
+        saveToString: async () => 'SCENE'
+    };
+    const session = new EngineSession({ size: 1, adapter });
+    const store = {
+        read: async () => ({ scene: 'S', meta: { parent: null } }),
+        write: async () => ({
+            id: 'newrev',
+            meta: { parent: null },
+            scene: 'SCENE'
+        }),
+        historyOf: async () => [{ id: 'root' }],
+        readCode: async () => undefined
+    };
+    return { store, session, engineLock: new Mutex() };
+}
+//# sourceMappingURL=edit-harness.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit-harness.js","sourceRoot":"","sources":["../../../../test/tools/edit-harness.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAsB,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGhF;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,UAAU,GAAG,EAAE,CAAC;IACtB,MAAM,OAAO,GAAkB;QAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU;QACxB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACrB,cAAc,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC9B,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO;KAClC,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QAC1D,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAClB,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;YACtB,KAAK,EAAE,OAAO;SACf,CAAC;QACF,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QACvC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS;KACJ,CAAC;IAC9B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,KAAK,EAAE,EAAE,CAAC;AACrD,CAAC","sourcesContent":["// Shared edit-tool test harness — a plain module (no test registrations) so importing it never re-runs edit.test.ts.\nimport { Mutex } from '../../src/engine/mutex.js';\nimport { type EngineAdapter, EngineSession } from '../../src/engine/session.js';\nimport { RevisionStore } from '../../src/revisions/store.js';\n\n/**\n * Minimal fake harness shared with edit.telemetry.test.ts.\n * Uses a fake RevisionStore (write returns id='newrev') and a real EngineSession\n * with a no-op adapter so the adapter cast inside edit.ts resolves correctly.\n */\nexport function makeEditHarness() {\n  const fakeEngine = {};\n  const adapter: EngineAdapter = {\n    create: () => fakeEngine,\n    reset: async () => {},\n    loadFromString: async () => {},\n    saveToString: async () => 'SCENE'\n  };\n  const session = new EngineSession({ size: 1, adapter });\n  const store = {\n    read: async () => ({ scene: 'S', meta: { parent: null } }),\n    write: async () => ({\n      id: 'newrev',\n      meta: { parent: null },\n      scene: 'SCENE'\n    }),\n    historyOf: async () => [{ id: 'root' }],\n    readCode: async () => undefined\n  } as unknown as RevisionStore;\n  return { store, session, engineLock: new Mutex() };\n}\n"]}

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

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

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

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

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

@@ -0,0 +1,46 @@
+// packages/codesign-mcp/test/tools/edit.telemetry.test.ts
+import { describe, it, expect } from 'vitest';
+import { createEditTool } from '../../src/tools/edit.js';
+import { makeEditHarness } from './edit-harness.js';
+describe('edit telemetry', () => {
+    it('records a successful tool_call report with ordered phase spans', async () => {
+        const reports = [];
+        const telemetry = { record: (r) => reports.push(r) };
+        const tool = createEditTool({ ...makeEditHarness(), telemetry });
+        const res = await tool.call({ parent: null, code: 'return undefined' });
+        expect(res.isError).toBeUndefined();
+        expect(reports).toHaveLength(1);
+        const r = reports[0];
+        expect(r.tool).toBe('edit');
+        expect(r.succeeded).toBe(true);
+        expect(r.revision).toBe('newrev');
+        expect(r.spans.map((s) => s.phase)).toEqual(expect.arrayContaining([
+            'engine_scene_load',
+            'engine_execute',
+            'engine_scene_save',
+            'workspace_write'
+        ]));
+        const sum = r.spans.reduce((n, s) => n + s.ms, 0);
+        expect(sum).toBeLessThanOrEqual(r.totalMs + 1); // Σspans ≤ totalMs (+float slack)
+    });
+    it('records succeeded=false with error when code throws', async () => {
+        const reports = [];
+        const tool = createEditTool({
+            ...makeEditHarness(),
+            telemetry: { record: (r) => reports.push(r) }
+        });
+        const res = await tool.call({
+            parent: null,
+            code: 'throw new Error("boom")'
+        });
+        expect(res.isError).toBe(true);
+        expect(reports[0].succeeded).toBe(false);
+        expect(reports[0].error?.message).toContain('boom');
+    });
+    it('does nothing observable when no telemetry is injected', async () => {
+        const tool = createEditTool(makeEditHarness());
+        const res = await tool.call({ parent: null, code: 'return undefined' });
+        expect(res.isError).toBeUndefined();
+    });
+});
+//# sourceMappingURL=edit.telemetry.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit.telemetry.test.js","sourceRoot":"","sources":["../../../../test/tools/edit.telemetry.test.ts"],"names":[],"mappings":"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","sourcesContent":["// packages/codesign-mcp/test/tools/edit.telemetry.test.ts\nimport { describe, it, expect } from 'vitest';\nimport { createEditTool } from '../../src/tools/edit.js';\nimport type { ToolCallReport } from '../../src/tools/spans.js';\nimport { makeEditHarness } from './edit-harness.js';\n\ndescribe('edit telemetry', () => {\n  it('records a successful tool_call report with ordered phase spans', async () => {\n    const reports: ToolCallReport[] = [];\n    const telemetry = { record: (r: ToolCallReport) => reports.push(r) };\n    const tool = createEditTool({ ...makeEditHarness(), telemetry });\n\n    const res = await tool.call({ parent: null, code: 'return undefined' });\n    expect(res.isError).toBeUndefined();\n    expect(reports).toHaveLength(1);\n    const r = reports[0];\n    expect(r.tool).toBe('edit');\n    expect(r.succeeded).toBe(true);\n    expect(r.revision).toBe('newrev');\n    expect(r.spans.map((s) => s.phase)).toEqual(\n      expect.arrayContaining([\n        'engine_scene_load',\n        'engine_execute',\n        'engine_scene_save',\n        'workspace_write'\n      ])\n    );\n    const sum = r.spans.reduce((n, s) => n + s.ms, 0);\n    expect(sum).toBeLessThanOrEqual(r.totalMs + 1); // Σspans ≤ totalMs (+float slack)\n  });\n\n  it('records succeeded=false with error when code throws', async () => {\n    const reports: ToolCallReport[] = [];\n    const tool = createEditTool({\n      ...makeEditHarness(),\n      telemetry: { record: (r) => reports.push(r) }\n    });\n    const res = await tool.call({\n      parent: null,\n      code: 'throw new Error(\"boom\")'\n    });\n    expect(res.isError).toBe(true);\n    expect(reports[0].succeeded).toBe(false);\n    expect(reports[0].error?.message).toContain('boom');\n  });\n\n  it('does nothing observable when no telemetry is injected', async () => {\n    const tool = createEditTool(makeEditHarness());\n    const res = await tool.call({ parent: null, code: 'return undefined' });\n    expect(res.isError).toBeUndefined();\n  });\n});\n"]}

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

@@ -0,0 +1,13 @@
+import { Mutex } from '../../src/engine/mutex.js';
+import { EngineSession } from '../../src/engine/session.js';
+import { RevisionStore } from '../../src/revisions/store.js';
+import { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+export declare function makeExportHarness(): {
+    fs: InMemoryWorkspaceFS;
+    store: RevisionStore;
+    session: EngineSession<unknown>;
+    engineLock: Mutex;
+    urlBuilder: LocalViewerUrlBuilder;
+};
+//# sourceMappingURL=export-harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-harness.d.ts","sourceRoot":"","sources":["../../../../test/tools/export-harness.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAsB,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,wBAAgB,iBAAiB;;;;;;EAoBhC"}

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

@@ -0,0 +1,27 @@
+// Shared export-tool test harness — a plain module (no test registrations) so importing it never re-runs export.test.ts.
+import { Mutex } from '../../src/engine/mutex.js';
+import { EngineSession } from '../../src/engine/session.js';
+import { RevisionStore } from '../../src/revisions/store.js';
+import { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+export function makeExportHarness() {
+    const fs = new InMemoryWorkspaceFS();
+    const store = new RevisionStore(fs);
+    const fakeEngine = {
+        block: {
+            export: async (_id, _mime) => new Blob([new Uint8Array([0xff, 0xd8, 0xff, 0xe0])])
+        }
+    };
+    const adapter = {
+        create: () => fakeEngine,
+        reset: async () => { },
+        loadFromString: async () => { },
+        saveToString: async () => ''
+    };
+    const session = new EngineSession({ size: 1, adapter });
+    const urlBuilder = new LocalViewerUrlBuilder({
+        base: 'http://127.0.0.1:9000'
+    });
+    return { fs, store, session, engineLock: new Mutex(), urlBuilder };
+}
+//# sourceMappingURL=export-harness.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-harness.js","sourceRoot":"","sources":["../../../../test/tools/export-harness.ts"],"names":[],"mappings":"AAAA,yHAAyH;AACzH,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAsB,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,MAAM,UAAU,iBAAiB;IAC/B,MAAM,EAAE,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG;QACjB,KAAK,EAAE;YACL,MAAM,EAAE,KAAK,EAAE,GAAW,EAAE,KAAa,EAAE,EAAE,CAC3C,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;SACvD;KACF,CAAC;IACF,MAAM,OAAO,GAAkB;QAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU;QACxB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACrB,cAAc,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC9B,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;KAC7B,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,qBAAqB,CAAC;QAC3C,IAAI,EAAE,uBAAuB;KAC9B,CAAC,CAAC;IACH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC;AACrE,CAAC","sourcesContent":["// Shared export-tool test harness — a plain module (no test registrations) so importing it never re-runs export.test.ts.\nimport { Mutex } from '../../src/engine/mutex.js';\nimport { type EngineAdapter, EngineSession } from '../../src/engine/session.js';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { LocalViewerUrlBuilder } from '../../src/viewer/url-builder.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\nexport function makeExportHarness() {\n  const fs = new InMemoryWorkspaceFS();\n  const store = new RevisionStore(fs);\n  const fakeEngine = {\n    block: {\n      export: async (_id: number, _mime: string) =>\n        new Blob([new Uint8Array([0xff, 0xd8, 0xff, 0xe0])])\n    }\n  };\n  const adapter: EngineAdapter = {\n    create: () => fakeEngine,\n    reset: async () => {},\n    loadFromString: async () => {},\n    saveToString: async () => ''\n  };\n  const session = new EngineSession({ size: 1, adapter });\n  const urlBuilder = new LocalViewerUrlBuilder({\n    base: 'http://127.0.0.1:9000'\n  });\n  return { fs, store, session, engineLock: new Mutex(), urlBuilder };\n}\n"]}

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

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

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

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

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

@@ -0,0 +1,65 @@
+import { describe, expect, it } from 'vitest';
+import { createExportTool } from '../../src/tools/export.js';
+import { makeExportHarness } from './export-harness.js';
+describe('export telemetry', () => {
+    it('records workspace_read, engine_scene_load, engine_execute and workspace_write phases', async () => {
+        const reports = [];
+        const harness = makeExportHarness();
+        const root = await harness.store.write({
+            scene: 'SCENE_FOR_EXPORT',
+            parent: null,
+            title: 'T'
+        });
+        const tool = createExportTool({
+            ...harness,
+            telemetry: { record: (r) => reports.push(r) }
+        });
+        const res = await tool.call({
+            target: 'image',
+            format: 'png',
+            revision: root.id,
+            blockId: 1
+        });
+        expect(res.isError).toBeUndefined();
+        expect(reports).toHaveLength(1);
+        const r = reports[0];
+        expect(r.tool).toBe('export');
+        expect(r.succeeded).toBe(true);
+        expect(r.revision).toBe(root.id);
+        const phases = r.spans.map((s) => s.phase);
+        expect(phases).toEqual(expect.arrayContaining([
+            'workspace_read',
+            'engine_scene_load',
+            'engine_execute',
+            'workspace_write'
+        ]));
+        expect(phases).not.toContain('engine_scene_save');
+    });
+    it('records succeeded=false when required args are missing', async () => {
+        const reports = [];
+        const tool = createExportTool({
+            ...makeExportHarness(),
+            telemetry: { record: (r) => reports.push(r) }
+        });
+        const res = await tool.call({});
+        expect(res.isError).toBe(true);
+        expect(reports[0].succeeded).toBe(false);
+    });
+    it('does nothing observable when no telemetry is injected', async () => {
+        const harness = makeExportHarness();
+        const root = await harness.store.write({
+            scene: 'S',
+            parent: null,
+            title: 'T'
+        });
+        const tool = createExportTool(harness);
+        const res = await tool.call({
+            target: 'image',
+            format: 'png',
+            revision: root.id,
+            blockId: 1
+        });
+        expect(res.isError).toBeUndefined();
+    });
+});
+//# sourceMappingURL=export.telemetry.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export.telemetry.test.js","sourceRoot":"","sources":["../../../../test/tools/export.telemetry.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport { createExportTool } from '../../src/tools/export.js';\nimport type { ToolCallReport } from '../../src/tools/spans.js';\nimport { makeExportHarness } from './export-harness.js';\n\ndescribe('export telemetry', () => {\n  it('records workspace_read, engine_scene_load, engine_execute and workspace_write phases', async () => {\n    const reports: ToolCallReport[] = [];\n    const harness = makeExportHarness();\n    const root = await harness.store.write({\n      scene: 'SCENE_FOR_EXPORT',\n      parent: null,\n      title: 'T'\n    });\n    const tool = createExportTool({\n      ...harness,\n      telemetry: { record: (r) => reports.push(r) }\n    });\n    const res = await tool.call({\n      target: 'image',\n      format: 'png',\n      revision: root.id,\n      blockId: 1\n    });\n    expect(res.isError).toBeUndefined();\n    expect(reports).toHaveLength(1);\n    const r = reports[0];\n    expect(r.tool).toBe('export');\n    expect(r.succeeded).toBe(true);\n    expect(r.revision).toBe(root.id);\n    const phases = r.spans.map((s) => s.phase);\n    expect(phases).toEqual(\n      expect.arrayContaining([\n        'workspace_read',\n        'engine_scene_load',\n        'engine_execute',\n        'workspace_write'\n      ])\n    );\n    expect(phases).not.toContain('engine_scene_save');\n  });\n\n  it('records succeeded=false when required args are missing', async () => {\n    const reports: ToolCallReport[] = [];\n    const tool = createExportTool({\n      ...makeExportHarness(),\n      telemetry: { record: (r) => reports.push(r) }\n    });\n    const res = await tool.call({});\n    expect(res.isError).toBe(true);\n    expect(reports[0].succeeded).toBe(false);\n  });\n\n  it('does nothing observable when no telemetry is injected', async () => {\n    const harness = makeExportHarness();\n    const root = await harness.store.write({\n      scene: 'S',\n      parent: null,\n      title: 'T'\n    });\n    const tool = createExportTool(harness);\n    const res = await tool.call({\n      target: 'image',\n      format: 'png',\n      revision: root.id,\n      blockId: 1\n    });\n    expect(res.isError).toBeUndefined();\n  });\n});\n"]}

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

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

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

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

package/dist/test/test/tools/import.test.js

@@ -0,0 +1,122 @@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterAll, beforeAll, describe, expect, it } from 'vitest';
+import { createImportTool } from '../../src/tools/import.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' });
+let dir;
+beforeAll(async () => {
+    dir = await mkdtemp(join(tmpdir(), 'import-in-'));
+});
+afterAll(async () => {
+    await rm(dir, { recursive: true, force: true });
+});
+async function tempFile(name, bytes) {
+    const p = join(dir, name);
+    await writeFile(p, bytes);
+    return p;
+}
+const textOf = (r) => r.content[0].text;
+const parse = (r) => JSON.parse(textOf(r));
+describe('import tool', () => {
+    it('imports a local JPG and persists it under assets/<sha>.jpg', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });
+        const path = await tempFile('beach.jpg', new Uint8Array([1, 2, 3, 4, 5]));
+        const result = await tool.call({ source: { path } });
+        expect(result.isError).toBeFalsy();
+        const body = parse(result);
+        expect(body.uri).toMatch(/^workspace:\/\/assets\/[0-9a-f]{12}\.jpg$/);
+        expect(body.mimeType).toBe('image/jpeg');
+        expect(body.kind).toBe('image');
+        expect(body.bytes).toBe(5);
+        const relPath = body.uri.replace('workspace://', '');
+        expect(Array.from(await fs.readFile(relPath))).toEqual([1, 2, 3, 4, 5]);
+        expect(body.httpUrl).toBe(`http://127.0.0.1:9000/r/${relPath}`);
+    });
+    it('classifies video (.mp4) and audio (.mp3) by extension', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });
+        const vid = await tool.call({
+            source: { path: await tempFile('clip.mp4', new Uint8Array([9])) }
+        });
+        const aud = await tool.call({
+            source: { path: await tempFile('song.mp3', new Uint8Array([8])) }
+        });
+        expect(parse(vid)).toMatchObject({ kind: 'video', mimeType: 'video/mp4' });
+        expect(parse(aud)).toMatchObject({ kind: 'audio', mimeType: 'audio/mpeg' });
+    });
+    it('canonicalizes extension + is case-insensitive (Photo.JPEG → assets/<sha>.jpg)', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });
+        const path = await tempFile('Photo.JPEG', new Uint8Array([1, 2, 3]));
+        const body = parse(await tool.call({ source: { path } }));
+        expect(body.mimeType).toBe('image/jpeg');
+        expect(body.kind).toBe('image');
+        expect(body.uri).toMatch(/^workspace:\/\/assets\/[0-9a-f]{12}\.jpg$/);
+    });
+    it('returns isError when source has no path (local, source: {})', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });
+        const result = await tool.call({ source: {} });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/source\.path/);
+    });
+    it('is content-addressed — same bytes import to the same uri (idempotent)', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });
+        const path = await tempFile('again.png', new Uint8Array([7, 7, 7]));
+        const a = parse(await tool.call({ source: { path } }));
+        const b = parse(await tool.call({ source: { path } }));
+        expect(a.uri).toBe(b.uri);
+        expect(await fs.readdir('assets')).toHaveLength(1);
+    });
+    it('rejects a relative source.path (must be absolute)', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });
+        const result = await tool.call({ source: { path: 'beach.jpg' } });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/absolute/i);
+    });
+    it('returns isError when the file does not exist (ENOENT)', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });
+        const missing = join(dir, 'nope.jpg');
+        const result = await tool.call({ source: { path: missing } });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toContain(missing);
+    });
+    it('returns isError for an unsupported type', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });
+        const path = await tempFile('data.xyz', new Uint8Array([0]));
+        const result = await tool.call({ source: { path } });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/supported/i);
+    });
+    it('rejects `source.path` on a hosted backend (allowLocalPath false)', async () => {
+        const fs = new InMemoryWorkspaceFS();
+        const tool = createImportTool({ fs, urlBuilder, allowLocalPath: false });
+        const result = await tool.call({ source: { path: '/tmp/x.jpg' } });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/hosted|not supported/i);
+    });
+    it('advertises source.path only when allowLocalPath is true', () => {
+        const local = createImportTool({
+            fs: new InMemoryWorkspaceFS(),
+            urlBuilder,
+            allowLocalPath: true
+        });
+        const hosted = createImportTool({
+            fs: new InMemoryWorkspaceFS(),
+            urlBuilder,
+            allowLocalPath: false
+        });
+        const sourceProps = (t) => t.inputSchema.properties.source.properties;
+        expect(sourceProps(local)).toHaveProperty('path');
+        expect(sourceProps(hosted)).not.toHaveProperty('path');
+    });
+});
+//# sourceMappingURL=import.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"import.test.js","sourceRoot":"","sources":["../../../../test/tools/import.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdtemp, rm, writeFile } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { afterAll, beforeAll, describe, expect, it } from 'vitest';\nimport { createImportTool } from '../../src/tools/import.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\nlet dir: string;\nbeforeAll(async () => {\n  dir = await mkdtemp(join(tmpdir(), 'import-in-'));\n});\nafterAll(async () => {\n  await rm(dir, { recursive: true, force: true });\n});\n\nasync function tempFile(name: string, bytes: Uint8Array): Promise<string> {\n  const p = join(dir, name);\n  await writeFile(p, bytes);\n  return p;\n}\n\nconst textOf = (r: { content: Array<unknown> }) =>\n  (r.content[0] as { text: string }).text;\nconst parse = (r: { content: Array<unknown> }) => JSON.parse(textOf(r));\n\ndescribe('import tool', () => {\n  it('imports a local JPG and persists it under assets/<sha>.jpg', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });\n    const path = await tempFile('beach.jpg', new Uint8Array([1, 2, 3, 4, 5]));\n    const result = await tool.call({ source: { path } });\n    expect(result.isError).toBeFalsy();\n    const body = parse(result);\n    expect(body.uri).toMatch(/^workspace:\\/\\/assets\\/[0-9a-f]{12}\\.jpg$/);\n    expect(body.mimeType).toBe('image/jpeg');\n    expect(body.kind).toBe('image');\n    expect(body.bytes).toBe(5);\n    const relPath = body.uri.replace('workspace://', '');\n    expect(Array.from(await fs.readFile(relPath))).toEqual([1, 2, 3, 4, 5]);\n    expect(body.httpUrl).toBe(`http://127.0.0.1:9000/r/${relPath}`);\n  });\n\n  it('classifies video (.mp4) and audio (.mp3) by extension', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });\n    const vid = await tool.call({\n      source: { path: await tempFile('clip.mp4', new Uint8Array([9])) }\n    });\n    const aud = await tool.call({\n      source: { path: await tempFile('song.mp3', new Uint8Array([8])) }\n    });\n    expect(parse(vid)).toMatchObject({ kind: 'video', mimeType: 'video/mp4' });\n    expect(parse(aud)).toMatchObject({ kind: 'audio', mimeType: 'audio/mpeg' });\n  });\n\n  it('canonicalizes extension + is case-insensitive (Photo.JPEG → assets/<sha>.jpg)', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });\n    const path = await tempFile('Photo.JPEG', new Uint8Array([1, 2, 3]));\n    const body = parse(await tool.call({ source: { path } }));\n    expect(body.mimeType).toBe('image/jpeg');\n    expect(body.kind).toBe('image');\n    expect(body.uri).toMatch(/^workspace:\\/\\/assets\\/[0-9a-f]{12}\\.jpg$/);\n  });\n\n  it('returns isError when source has no path (local, source: {})', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });\n    const result = await tool.call({ source: {} });\n    expect(result.isError).toBe(true);\n    expect(textOf(result)).toMatch(/source\\.path/);\n  });\n\n  it('is content-addressed — same bytes import to the same uri (idempotent)', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });\n    const path = await tempFile('again.png', new Uint8Array([7, 7, 7]));\n    const a = parse(await tool.call({ source: { path } }));\n    const b = parse(await tool.call({ source: { path } }));\n    expect(a.uri).toBe(b.uri);\n    expect(await fs.readdir('assets')).toHaveLength(1);\n  });\n\n  it('rejects a relative source.path (must be absolute)', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });\n    const result = await tool.call({ source: { path: 'beach.jpg' } });\n    expect(result.isError).toBe(true);\n    expect(textOf(result)).toMatch(/absolute/i);\n  });\n\n  it('returns isError when the file does not exist (ENOENT)', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });\n    const missing = join(dir, 'nope.jpg');\n    const result = await tool.call({ source: { path: missing } });\n    expect(result.isError).toBe(true);\n    expect(textOf(result)).toContain(missing);\n  });\n\n  it('returns isError for an unsupported type', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const tool = createImportTool({ fs, urlBuilder, allowLocalPath: true });\n    const path = await tempFile('data.xyz', new Uint8Array([0]));\n    const result = await tool.call({ source: { path } });\n    expect(result.isError).toBe(true);\n    expect(textOf(result)).toMatch(/supported/i);\n  });\n\n  it('rejects `source.path` on a hosted backend (allowLocalPath false)', async () => {\n    const fs = new InMemoryWorkspaceFS();\n    const tool = createImportTool({ fs, urlBuilder, allowLocalPath: false });\n    const result = await tool.call({ source: { path: '/tmp/x.jpg' } });\n    expect(result.isError).toBe(true);\n    expect(textOf(result)).toMatch(/hosted|not supported/i);\n  });\n\n  it('advertises source.path only when allowLocalPath is true', () => {\n    const local = createImportTool({\n      fs: new InMemoryWorkspaceFS(),\n      urlBuilder,\n      allowLocalPath: true\n    });\n    const hosted = createImportTool({\n      fs: new InMemoryWorkspaceFS(),\n      urlBuilder,\n      allowLocalPath: false\n    });\n    const sourceProps = (t: { inputSchema: unknown }) =>\n      (\n        t.inputSchema as {\n          properties: { source: { properties: Record<string, unknown> } };\n        }\n      ).properties.source.properties;\n    expect(sourceProps(local)).toHaveProperty('path');\n    expect(sourceProps(hosted)).not.toHaveProperty('path');\n  });\n});\n"]}

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

@@ -13,43 +13,105 @@ function gateway(available) {
         })
     };
 }
-function toolNames(available) {
-    return buildDesignToolRegistrations({
+function baseBuildOpts() {
+    return {
         fs: stub,
         store: stub,
         session: stub,
         engineLock: stub,
-        gateway: gateway(available),
+        gateway: gateway(false),
         urlBuilder: stub,
         allowOutPath: true
+    };
+}
+function toolNames(available, allowOutPath = true) {
+    return buildDesignToolRegistrations({
+        ...baseBuildOpts(),
+        gateway: gateway(available),
+        allowOutPath
     }).map((t) => t.name);
 }
+// Tools present on every backend. asset_generate (beta-hidden) and import
+// (Local-only) are deployment-gated and asserted separately below.
+const alwaysOn = [
+    'edit',
+    'preview',
+    'export',
+    'save',
+    'load',
+    'list',
+    'history',
+    'inspect',
+    'rename',
+    'open_editor',
+    'asset_search'
+];
 // 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);
+        expect(names).toEqual([...alwaysOn, 'import']); // Local backend
     });
     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, 'import']); // Local backend
+    });
+});
+// `import` is Local-only until hosted byte transports land (CODE-42): it is
+// registered when the backend shares the caller's disk (allowOutPath=true) and
+// hidden otherwise, so the model never sees a tool whose every hosted call fails.
+describe('buildDesignToolRegistrations — import gating (Local-only)', () => {
+    it('registers import on Local (allowOutPath=true)', () => {
+        expect(toolNames(false, true)).toContain('import');
+    });
+    it('hides import on Hosted (allowOutPath=false) until CODE-42', () => {
+        const names = toolNames(false, false);
+        expect(names).not.toContain('import');
         expect(names).toEqual(alwaysOn);
     });
 });
+describe('buildDesignToolRegistrations — telemetry threading', () => {
+    it('threads telemetry into the engine tools', async () => {
+        const reports = [];
+        const regs = buildDesignToolRegistrations({
+            ...baseBuildOpts(),
+            telemetry: { record: (r) => reports.push(r) }
+        });
+        const preview = regs.find((r) => r.name === 'preview');
+        await preview.call({}); // missing blockId -> isError, but still recorded
+        expect(reports.some((r) => r.tool === 'preview')).toBe(true);
+    });
+    it('wraps non-engine tools so every call is recorded (with empty spans)', async () => {
+        const reports = [];
+        const regs = buildDesignToolRegistrations({
+            ...baseBuildOpts(),
+            telemetry: { record: (r) => reports.push(r) }
+        });
+        // `list` has no internal telemetry; the wrapper must still record it. The
+        // stub store makes the call throw, but the wrapper records in its finally.
+        const list = regs.find((r) => r.name === 'list');
+        await list.call({}).catch(() => { });
+        const rec = reports.find((r) => r.tool === 'list');
+        expect(rec).toBeDefined();
+        expect(rec.spans).toEqual([]);
+        expect(rec.args).toEqual({});
+    });
+    it('captures the tool result in the report', async () => {
+        const reports = [];
+        const regs = buildDesignToolRegistrations({
+            ...baseBuildOpts(),
+            telemetry: { record: (r) => reports.push(r) }
+        });
+        const preview = regs.find((r) => r.name === 'preview');
+        await preview.call({}); // missing blockId -> isError result (not a throw)
+        const rec = reports.find((r) => r.tool === 'preview');
+        expect(rec.result).toBeDefined();
+        expect(JSON.stringify(rec.result)).toContain('blockId');
+    });
+});
 //# sourceMappingURL=index.test.js.map

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

@@ -1 +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"]}
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../../test/tools/index.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from 'vitest';\nimport type { GatewayClient } from '../../src/gateway/types.js';\nimport {\n  buildDesignToolRegistrations,\n  type BuildDesignToolRegistrationsOptions\n} from '../../src/tools/index.js';\nimport type { ToolCallReport } from '../../src/tools/spans.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 baseBuildOpts(): BuildDesignToolRegistrationsOptions {\n  return {\n    fs: stub,\n    store: stub,\n    session: stub,\n    engineLock: stub,\n    gateway: gateway(false),\n    urlBuilder: stub,\n    allowOutPath: true\n  };\n}\n\nfunction toolNames(available: boolean, allowOutPath = true): string[] {\n  return buildDesignToolRegistrations({\n    ...baseBuildOpts(),\n    gateway: gateway(available),\n    allowOutPath\n  }).map((t) => t.name);\n}\n\n// Tools present on every backend. asset_generate (beta-hidden) and import\n// (Local-only) are deployment-gated and asserted separately below.\nconst alwaysOn = [\n  'edit',\n  'preview',\n  'export',\n  'save',\n  'load',\n  'list',\n  'history',\n  'inspect',\n  'rename',\n  'open_editor',\n  'asset_search'\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  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, 'import']); // Local backend\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, 'import']); // Local backend\n  });\n});\n\n// `import` is Local-only until hosted byte transports land (CODE-42): it is\n// registered when the backend shares the caller's disk (allowOutPath=true) and\n// hidden otherwise, so the model never sees a tool whose every hosted call fails.\ndescribe('buildDesignToolRegistrations — import gating (Local-only)', () => {\n  it('registers import on Local (allowOutPath=true)', () => {\n    expect(toolNames(false, true)).toContain('import');\n  });\n\n  it('hides import on Hosted (allowOutPath=false) until CODE-42', () => {\n    const names = toolNames(false, false);\n    expect(names).not.toContain('import');\n    expect(names).toEqual(alwaysOn);\n  });\n});\n\ndescribe('buildDesignToolRegistrations — telemetry threading', () => {\n  it('threads telemetry into the engine tools', async () => {\n    const reports: ToolCallReport[] = [];\n    const regs = buildDesignToolRegistrations({\n      ...baseBuildOpts(),\n      telemetry: { record: (r) => reports.push(r) }\n    });\n    const preview = regs.find((r) => r.name === 'preview')!;\n    await preview.call({}); // missing blockId -> isError, but still recorded\n    expect(reports.some((r) => r.tool === 'preview')).toBe(true);\n  });\n\n  it('wraps non-engine tools so every call is recorded (with empty spans)', async () => {\n    const reports: ToolCallReport[] = [];\n    const regs = buildDesignToolRegistrations({\n      ...baseBuildOpts(),\n      telemetry: { record: (r) => reports.push(r) }\n    });\n    // `list` has no internal telemetry; the wrapper must still record it. The\n    // stub store makes the call throw, but the wrapper records in its finally.\n    const list = regs.find((r) => r.name === 'list')!;\n    await list.call({}).catch(() => {});\n    const rec = reports.find((r) => r.tool === 'list');\n    expect(rec).toBeDefined();\n    expect(rec!.spans).toEqual([]);\n    expect(rec!.args).toEqual({});\n  });\n\n  it('captures the tool result in the report', async () => {\n    const reports: ToolCallReport[] = [];\n    const regs = buildDesignToolRegistrations({\n      ...baseBuildOpts(),\n      telemetry: { record: (r) => reports.push(r) }\n    });\n    const preview = regs.find((r) => r.name === 'preview')!;\n    await preview.call({}); // missing blockId -> isError result (not a throw)\n    const rec = reports.find((r) => r.tool === 'preview')!;\n    expect(rec.result).toBeDefined();\n    expect(JSON.stringify(rec.result)).toContain('blockId');\n  });\n});\n"]}

package/dist/test/test/tools/load.integration.test.d.ts

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

package/dist/test/test/tools/load.integration.test.d.ts.map

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