@imgly/codesign-mcp 0.1.5 → 0.1.6

package/dist/test/test/tools/load.integration.test.js

@@ -0,0 +1,165 @@
+// test/tools/load.integration.test.ts
+//
+// Real-engine integration test for the CODE-3 archive flow. Skipped unless
+// CESDK_LICENSE is set (CI secret / packages/codesign-mcp/.env — export it
+// into the shell before running; vitest does not read .env).
+//
+// Builds its own fixture archive with the real engine (no network): a scene
+// with one image block backed by a local PNG, saved via saveToArchive. This
+// is exactly the shape of the premium-template zips from the original bug.
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { afterAll, describe, expect, it } from 'vitest';
+import { cesdkAdapter } from '../../src/engine/cesdk-adapter.js';
+import { Mutex } from '../../src/engine/mutex.js';
+import { SCENE_ALLOWED_RESOURCE_SCHEMES } from '../../src/engine/scene-resource-schemes.js';
+import { EngineSession } from '../../src/engine/session.js';
+import { RevisionStore } from '../../src/revisions/store.js';
+import { ensureHeadlessEngine } from '../../src/tools/engine.js';
+import { createLoadTool } from '../../src/tools/load.js';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+const LICENSE = process.env.CESDK_LICENSE;
+// 1x1 red PNG.
+const TINY_PNG = new Uint8Array(Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==', 'base64'));
+const tmpDirs = [];
+afterAll(async () => {
+    for (const d of tmpDirs)
+        await rm(d, { recursive: true, force: true });
+});
+describe.skipIf(!LICENSE)('load tool — real engine integration', () => {
+    it('archive load → explode → save round-trips with no buffer: schemes; re-load dedupes', { timeout: 180_000 }, async () => {
+        const engine = await ensureHeadlessEngine(LICENSE);
+        // --- Build the fixture archive.
+        const dir = await mkdtemp(join(tmpdir(), 'load-integration-'));
+        tmpDirs.push(dir);
+        const pngPath = join(dir, 'red.png');
+        await writeFile(pngPath, TINY_PNG);
+        engine.scene.create();
+        const scene = engine.scene.get();
+        if (scene === null)
+            throw new Error('scene.create produced no scene');
+        const page = engine.block.create('page');
+        engine.block.appendChild(scene, page);
+        const graphic = engine.block.create('graphic');
+        engine.block.setShape(graphic, engine.block.createShape('rect'));
+        const fill = engine.block.createFill('image');
+        engine.block.setString(fill, 'fill/image/imageFileURI', pathToFileURL(pngPath).href);
+        engine.block.setFill(graphic, fill);
+        engine.block.appendChild(page, graphic);
+        await engine.block.forceLoadResources([page]);
+        const blob = await engine.scene.saveToArchive();
+        const zipPath = join(dir, 'fixture.zip');
+        await writeFile(zipPath, new Uint8Array(await blob.arrayBuffer()));
+        // --- Load it through the real tool.
+        const fs = new InMemoryWorkspaceFS();
+        const store = new RevisionStore(fs);
+        const session = new EngineSession({
+            size: 1,
+            adapter: cesdkAdapter(engine)
+        });
+        const tool = createLoadTool({
+            fs,
+            store,
+            session,
+            engineLock: new Mutex(),
+            allowPath: true
+        });
+        const result = await tool.call({
+            source: { path: zipPath },
+            title: 'Fixture'
+        });
+        expect(result.isError, result.content[0].text).toBeUndefined();
+        const body = JSON.parse(result.content[0].text);
+        expect(body.title).toBe('Fixture');
+        // The archive's bundled bytes landed content-addressed in assets/.
+        const assets = await fs.readdir('assets');
+        expect(assets.length).toBeGreaterThanOrEqual(1);
+        expect(assets.some((f) => f.endsWith('.png'))).toBe(true);
+        // Durability: the persisted scene reloads with ZERO transients —
+        // nothing would be lost on a future save. (This is the bug's inverse.)
+        const rev = await store.read(body.revision);
+        await engine.scene.loadFromString(rev.scene);
+        expect(engine.editor.findAllTransientResources()).toEqual([]);
+        // Regression (CODE-3 acceptance): the EDIT save path — the adapter's
+        // saveToString — must serialize a workspace://-referencing scene too.
+        const adapter = cesdkAdapter(engine);
+        const reSaved = await adapter.saveToString(engine);
+        expect(reSaved.length).toBeGreaterThan(0);
+        // Idempotence: re-loading the same zip dedupes to the same shas.
+        const again = await tool.call({ source: { path: zipPath } });
+        expect(again.isError).toBeUndefined();
+        expect((await fs.readdir('assets')).sort()).toEqual(assets.sort());
+    });
+    it('bare .scene load returns a scheme-classified report from real engine state (no workspace-dangling)', { timeout: 180_000 }, async () => {
+        const engine = await ensureHeadlessEngine(LICENSE);
+        // Build a bare scene referencing a local file:// image — no network, and
+        // file:// is a durable engine scheme, so it survives saveToString.
+        const dir = await mkdtemp(join(tmpdir(), 'load-bare-integration-'));
+        tmpDirs.push(dir);
+        const pngPath = join(dir, 'red.png');
+        await writeFile(pngPath, TINY_PNG);
+        engine.scene.create();
+        const scene = engine.scene.get();
+        if (scene === null)
+            throw new Error('scene.create produced no scene');
+        const page = engine.block.create('page');
+        engine.block.appendChild(scene, page);
+        const graphic = engine.block.create('graphic');
+        engine.block.setShape(graphic, engine.block.createShape('rect'));
+        const fill = engine.block.createFill('image');
+        engine.block.setString(fill, 'fill/image/imageFileURI', pathToFileURL(pngPath).href);
+        engine.block.setFill(graphic, fill);
+        engine.block.appendChild(page, graphic);
+        await engine.block.forceLoadResources([page]);
+        const bareScene = await engine.scene.saveToString({
+            allowedResourceSchemes: SCENE_ALLOWED_RESOURCE_SCHEMES
+        });
+        const scenePath = join(dir, 'poster.scene');
+        await writeFile(scenePath, bareScene);
+        // Load it through the real tool.
+        const fs = new InMemoryWorkspaceFS();
+        const store = new RevisionStore(fs);
+        const session = new EngineSession({
+            size: 1,
+            adapter: cesdkAdapter(engine)
+        });
+        const tool = createLoadTool({
+            fs,
+            store,
+            session,
+            engineLock: new Mutex(),
+            allowPath: true
+        });
+        const result = await tool.call({
+            source: { path: scenePath },
+            title: 'Bare'
+        });
+        expect(result.isError, result.content[0].text).toBeUndefined();
+        const body = JSON.parse(result.content[0].text);
+        // Bare scenes are persisted verbatim (not re-serialized).
+        expect((await store.read(body.revision)).scene).toBe(bareScene);
+        // The report is a real array; the dropped `workspace-dangling` never
+        // appears, and every class is one of the five scheme buckets.
+        expect(Array.isArray(body.assets)).toBe(true);
+        const CLASSES = ['workspace', 'external', 'bundle', 'transient', 'other'];
+        for (const a of body.assets)
+            expect(CLASSES).toContain(a.class);
+        // Regression (the mock-vs-real gap that this whole change fixes): the
+        // file:// image the engine actually loaded is a DURABLE reference — it is
+        // classified by scheme (`other`), never as a phantom `transient`. And no
+        // durable-scheme URI anywhere is labeled `transient`.
+        const fileEntries = body.assets.filter((a) => a.uri.startsWith('file://'));
+        expect(fileEntries.length).toBeGreaterThanOrEqual(1);
+        for (const a of fileEntries)
+            expect(a.class).toBe('other');
+        const isDurable = (u) => u.startsWith('workspace://') ||
+            u.startsWith('http://') ||
+            u.startsWith('https://') ||
+            u.startsWith('bundle://') ||
+            u.startsWith('file://');
+        expect(body.assets.filter((a) => isDurable(a.uri) && a.class === 'transient')).toEqual([]);
+    });
+});
+//# sourceMappingURL=load.integration.test.js.map

package/dist/test/test/tools/load.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.integration.test.js","sourceRoot":"","sources":["../../../../test/tools/load.integration.test.ts"],"names":[],"mappings":"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","sourcesContent":["// test/tools/load.integration.test.ts\n//\n// Real-engine integration test for the CODE-3 archive flow. Skipped unless\n// CESDK_LICENSE is set (CI secret / packages/codesign-mcp/.env — export it\n// into the shell before running; vitest does not read .env).\n//\n// Builds its own fixture archive with the real engine (no network): a scene\n// with one image block backed by a local PNG, saved via saveToArchive. This\n// is exactly the shape of the premium-template zips from the original bug.\nimport { mkdtemp, rm, writeFile } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { afterAll, describe, expect, it } from 'vitest';\nimport { cesdkAdapter } from '../../src/engine/cesdk-adapter.js';\nimport { Mutex } from '../../src/engine/mutex.js';\nimport { SCENE_ALLOWED_RESOURCE_SCHEMES } from '../../src/engine/scene-resource-schemes.js';\nimport { EngineSession } from '../../src/engine/session.js';\nimport { RevisionStore } from '../../src/revisions/store.js';\nimport { ensureHeadlessEngine } from '../../src/tools/engine.js';\nimport { createLoadTool } from '../../src/tools/load.js';\nimport { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\nconst LICENSE = process.env.CESDK_LICENSE;\n\n// 1x1 red PNG.\nconst TINY_PNG = new Uint8Array(\n  Buffer.from(\n    'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==',\n    'base64'\n  )\n);\n\nconst tmpDirs: string[] = [];\nafterAll(async () => {\n  for (const d of tmpDirs) await rm(d, { recursive: true, force: true });\n});\n\ndescribe.skipIf(!LICENSE)('load tool — real engine integration', () => {\n  it(\n    'archive load → explode → save round-trips with no buffer: schemes; re-load dedupes',\n    { timeout: 180_000 },\n    async () => {\n      const engine = await ensureHeadlessEngine(LICENSE as string);\n\n      // --- Build the fixture archive.\n      const dir = await mkdtemp(join(tmpdir(), 'load-integration-'));\n      tmpDirs.push(dir);\n      const pngPath = join(dir, 'red.png');\n      await writeFile(pngPath, TINY_PNG);\n      engine.scene.create();\n      const scene = engine.scene.get();\n      if (scene === null) throw new Error('scene.create produced no scene');\n      const page = engine.block.create('page');\n      engine.block.appendChild(scene, page);\n      const graphic = engine.block.create('graphic');\n      engine.block.setShape(graphic, engine.block.createShape('rect'));\n      const fill = engine.block.createFill('image');\n      engine.block.setString(\n        fill,\n        'fill/image/imageFileURI',\n        pathToFileURL(pngPath).href\n      );\n      engine.block.setFill(graphic, fill);\n      engine.block.appendChild(page, graphic);\n      await engine.block.forceLoadResources([page]);\n      const blob = await engine.scene.saveToArchive();\n      const zipPath = join(dir, 'fixture.zip');\n      await writeFile(zipPath, new Uint8Array(await blob.arrayBuffer()));\n\n      // --- Load it through the real tool.\n      const fs = new InMemoryWorkspaceFS();\n      const store = new RevisionStore(fs);\n      const session = new EngineSession({\n        size: 1,\n        adapter: cesdkAdapter(engine)\n      });\n      const tool = createLoadTool({\n        fs,\n        store,\n        session,\n        engineLock: new Mutex(),\n        allowPath: true\n      });\n      const result = await tool.call({\n        source: { path: zipPath },\n        title: 'Fixture'\n      });\n      expect(\n        result.isError,\n        (result.content[0] as { text: string }).text\n      ).toBeUndefined();\n      const body = JSON.parse((result.content[0] as { text: string }).text) as {\n        revision: string;\n        title: string;\n      };\n      expect(body.title).toBe('Fixture');\n\n      // The archive's bundled bytes landed content-addressed in assets/.\n      const assets = await fs.readdir('assets');\n      expect(assets.length).toBeGreaterThanOrEqual(1);\n      expect(assets.some((f) => f.endsWith('.png'))).toBe(true);\n\n      // Durability: the persisted scene reloads with ZERO transients —\n      // nothing would be lost on a future save. (This is the bug's inverse.)\n      const rev = await store.read(body.revision);\n      await engine.scene.loadFromString(rev.scene);\n      expect(engine.editor.findAllTransientResources()).toEqual([]);\n\n      // Regression (CODE-3 acceptance): the EDIT save path — the adapter's\n      // saveToString — must serialize a workspace://-referencing scene too.\n      const adapter = cesdkAdapter(engine);\n      const reSaved = await adapter.saveToString(engine);\n      expect(reSaved.length).toBeGreaterThan(0);\n\n      // Idempotence: re-loading the same zip dedupes to the same shas.\n      const again = await tool.call({ source: { path: zipPath } });\n      expect(again.isError).toBeUndefined();\n      expect((await fs.readdir('assets')).sort()).toEqual(assets.sort());\n    }\n  );\n\n  it(\n    'bare .scene load returns a scheme-classified report from real engine state (no workspace-dangling)',\n    { timeout: 180_000 },\n    async () => {\n      const engine = await ensureHeadlessEngine(LICENSE as string);\n\n      // Build a bare scene referencing a local file:// image — no network, and\n      // file:// is a durable engine scheme, so it survives saveToString.\n      const dir = await mkdtemp(join(tmpdir(), 'load-bare-integration-'));\n      tmpDirs.push(dir);\n      const pngPath = join(dir, 'red.png');\n      await writeFile(pngPath, TINY_PNG);\n      engine.scene.create();\n      const scene = engine.scene.get();\n      if (scene === null) throw new Error('scene.create produced no scene');\n      const page = engine.block.create('page');\n      engine.block.appendChild(scene, page);\n      const graphic = engine.block.create('graphic');\n      engine.block.setShape(graphic, engine.block.createShape('rect'));\n      const fill = engine.block.createFill('image');\n      engine.block.setString(\n        fill,\n        'fill/image/imageFileURI',\n        pathToFileURL(pngPath).href\n      );\n      engine.block.setFill(graphic, fill);\n      engine.block.appendChild(page, graphic);\n      await engine.block.forceLoadResources([page]);\n      const bareScene = await engine.scene.saveToString({\n        allowedResourceSchemes: SCENE_ALLOWED_RESOURCE_SCHEMES\n      });\n      const scenePath = join(dir, 'poster.scene');\n      await writeFile(scenePath, bareScene);\n\n      // Load it through the real tool.\n      const fs = new InMemoryWorkspaceFS();\n      const store = new RevisionStore(fs);\n      const session = new EngineSession({\n        size: 1,\n        adapter: cesdkAdapter(engine)\n      });\n      const tool = createLoadTool({\n        fs,\n        store,\n        session,\n        engineLock: new Mutex(),\n        allowPath: true\n      });\n      const result = await tool.call({\n        source: { path: scenePath },\n        title: 'Bare'\n      });\n      expect(\n        result.isError,\n        (result.content[0] as { text: string }).text\n      ).toBeUndefined();\n      const body = JSON.parse((result.content[0] as { text: string }).text) as {\n        revision: string;\n        title: string;\n        assets: Array<{ uri: string; class: string }>;\n      };\n\n      // Bare scenes are persisted verbatim (not re-serialized).\n      expect((await store.read(body.revision)).scene).toBe(bareScene);\n      // The report is a real array; the dropped `workspace-dangling` never\n      // appears, and every class is one of the five scheme buckets.\n      expect(Array.isArray(body.assets)).toBe(true);\n      const CLASSES = ['workspace', 'external', 'bundle', 'transient', 'other'];\n      for (const a of body.assets) expect(CLASSES).toContain(a.class);\n      // Regression (the mock-vs-real gap that this whole change fixes): the\n      // file:// image the engine actually loaded is a DURABLE reference — it is\n      // classified by scheme (`other`), never as a phantom `transient`. And no\n      // durable-scheme URI anywhere is labeled `transient`.\n      const fileEntries = body.assets.filter((a) =>\n        a.uri.startsWith('file://')\n      );\n      expect(fileEntries.length).toBeGreaterThanOrEqual(1);\n      for (const a of fileEntries) expect(a.class).toBe('other');\n      const isDurable = (u: string) =>\n        u.startsWith('workspace://') ||\n        u.startsWith('http://') ||\n        u.startsWith('https://') ||\n        u.startsWith('bundle://') ||\n        u.startsWith('file://');\n      expect(\n        body.assets.filter((a) => isDurable(a.uri) && a.class === 'transient')\n      ).toEqual([]);\n    }\n  );\n});\n"]}

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

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

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

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

package/dist/test/test/tools/load.test.js

@@ -0,0 +1,387 @@
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, 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 { createLoadTool } from '../../src/tools/load.js';
+import { shortHash } from '../../src/workspace/content-hash.js';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+// Minimal fake engine implementing exactly the slice load.ts touches.
+function makeFakeEngine() {
+    const fake = {
+        _scene: '',
+        _transients: [],
+        _resourceBytes: new Map(),
+        scene: {
+            // Full optional signatures so tests can assert on later positional args
+            // (mock.calls tuples are typed from these).
+            loadFromArchiveURL: vi.fn(async (_url, _override, _wait) => 1),
+            loadFromString: vi.fn(async (content, _override, _wait) => {
+                fake._scene = content;
+                return 1;
+            }),
+            saveToString: vi.fn(async (_opts) => 'SCENE_AFTER_RELOCATE')
+        },
+        editor: {
+            findAllTransientResources: vi.fn(() => fake._transients),
+            findAllMediaURIs: vi.fn(() => []),
+            getResourceData: vi.fn((uri, _chunkSize, onData) => {
+                const bytes = fake._resourceBytes.get(uri);
+                if (bytes)
+                    onData(bytes);
+            }),
+            relocateResource: vi.fn(),
+            getMimeType: vi.fn(async () => 'image/png')
+        }
+    };
+    return fake;
+}
+function makeDeps() {
+    const fs = new InMemoryWorkspaceFS();
+    const store = new RevisionStore(fs);
+    const fakeEngine = makeFakeEngine();
+    const adapter = {
+        create: () => fakeEngine,
+        reset: async (e) => {
+            e._scene = '';
+        },
+        loadFromString: async (e, s) => {
+            e._scene = s;
+        },
+        saveToString: async (e) => e._scene
+    };
+    const session = new EngineSession({ size: 1, adapter });
+    return { fs, store, session, fakeEngine, engineLock: new Mutex() };
+}
+function textOf(result) {
+    return result.content[0].text;
+}
+afterEach(() => {
+    vi.unstubAllGlobals();
+});
+describe('load tool — schema & validation', () => {
+    it('omits the `path` source arm from the schema unless allowPath', () => {
+        const { fs, store, session, engineLock } = makeDeps();
+        const base = { fs, store, session, engineLock };
+        const hosted = createLoadTool({ ...base, allowPath: false });
+        const local = createLoadTool({ ...base, allowPath: true });
+        // `source` is a flat object (no `oneOf`) — the `path` arm is a sibling
+        // property present only on Local. See schema-best-practices.test.ts.
+        const sourceProps = (s) => JSON.stringify(s.properties.source.properties);
+        expect(sourceProps(hosted.inputSchema)).not.toContain('path');
+        expect(sourceProps(local.inputSchema)).toContain('path');
+    });
+    it('errors when source is missing', async () => {
+        const { fs, store, session, engineLock } = makeDeps();
+        const tool = createLoadTool({ fs, store, session, engineLock });
+        const result = await tool.call({});
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/source/i);
+    });
+    it('rejects `path` when not allowed (hosted)', async () => {
+        const { fs, store, session, engineLock } = makeDeps();
+        const tool = createLoadTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            allowPath: false
+        });
+        const result = await tool.call({ source: { path: '/tmp/a.zip' } });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/path.*not.*supported/i);
+    });
+    it('rejects non-http(s) URLs', async () => {
+        const { fs, store, session, engineLock } = makeDeps();
+        const tool = createLoadTool({ fs, store, session, engineLock });
+        const result = await tool.call({
+            source: { url: 'file:///etc/passwd' }
+        });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/http/i);
+    });
+    it('surfaces a fetch failure as a tool error', async () => {
+        vi.stubGlobal('fetch', vi.fn(async () => new Response('nope', { status: 404 })));
+        const { fs, store, session, engineLock } = makeDeps();
+        const tool = createLoadTool({ fs, store, session, engineLock });
+        const result = await tool.call({
+            source: { url: 'https://example.com/missing.zip' }
+        });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/404/);
+    });
+    it('surfaces a network-level fetch rejection as a tool error', async () => {
+        vi.stubGlobal('fetch', vi.fn(async () => {
+            throw new TypeError('fetch failed');
+        }));
+        const { fs, store, session, engineLock } = makeDeps();
+        const tool = createLoadTool({ fs, store, session, engineLock });
+        const result = await tool.call({
+            source: { url: 'https://unreachable.invalid/a.zip' }
+        });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/fetch failed/);
+    });
+    it('surfaces a response-body read failure as a tool error', async () => {
+        vi.stubGlobal('fetch', vi.fn(async () => ({
+            ok: true,
+            arrayBuffer: async () => {
+                throw new Error('read failed');
+            }
+        })));
+        const { fs, store, session, engineLock } = makeDeps();
+        const tool = createLoadTool({ fs, store, session, engineLock });
+        const result = await tool.call({
+            source: { url: 'https://example.com/tpl/a.zip' }
+        });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/read failed/);
+    });
+});
+// A file whose first 4 bytes are the zip magic — content is irrelevant to the
+// fake engine, only the sniffing dispatch reads it.
+const FAKE_ZIP = new Uint8Array([0x50, 0x4b, 0x03, 0x04, 0xff]);
+describe('load tool — archive flow', () => {
+    it('explodes transients into assets/<sha>.<ext>, relocates, writes a root revision', async () => {
+        const { fs, store, session, fakeEngine, engineLock } = makeDeps();
+        fakeEngine._transients = [{ URL: 'buffer://tmp/1', size: 3 }];
+        fakeEngine._resourceBytes.set('buffer://tmp/1', new Uint8Array([1, 2, 3]));
+        const dir = await mkdtemp(join(tmpdir(), 'load-test-'));
+        const zipPath = join(dir, 'event_story.zip');
+        await writeFile(zipPath, FAKE_ZIP);
+        const leafEvents = [];
+        const tool = createLoadTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            allowPath: true,
+            onLeafWritten: (e) => {
+                leafEvents.push(e);
+            }
+        });
+        const result = await tool.call({ source: { path: zipPath } });
+        expect(result.isError).toBeUndefined();
+        const body = JSON.parse(textOf(result));
+        // Title derived from the filename.
+        expect(body.title).toBe('event_story');
+        // Engine was driven correctly: file:// staging URL, waitForResources.
+        const loadCall = fakeEngine.scene.loadFromArchiveURL.mock.calls[0];
+        expect(loadCall[0]).toMatch(/^file:\/\//);
+        expect(loadCall[2]).toBe(true);
+        // Asset extracted content-addressed…
+        const sha = await shortHash(new Uint8Array([1, 2, 3]));
+        expect(await fs.exists(`assets/${sha}.png`)).toBe(true);
+        // …and relocated to its workspace URI.
+        expect(fakeEngine.editor.relocateResource).toHaveBeenCalledWith('buffer://tmp/1', `workspace://assets/${sha}.png`);
+        // saveToString allows `workspace` but NOT `buffer`.
+        const saveOpts = fakeEngine.scene.saveToString.mock.calls[0][0];
+        expect(saveOpts.allowedResourceSchemes).toContain('workspace');
+        expect(saveOpts.allowedResourceSchemes).not.toContain('buffer');
+        // Root revision persisted with the post-relocation scene.
+        const rev = await store.read(body.revision);
+        expect(rev.scene).toBe('SCENE_AFTER_RELOCATE');
+        expect(rev.meta.parent).toBeNull();
+        // Viewer hook fired; a new root is its own rootRevision.
+        expect(leafEvents).toEqual([
+            { revision: body.revision, rootRevision: body.revision }
+        ]);
+        // Session is warm at the new revision (next edit pays no reload).
+        expect(session.currentSlot()?.currentRevision).toBe(body.revision);
+        await rm(dir, { recursive: true, force: true });
+    });
+    it('drains a duplicate-content transient the engine still holds via onDisallowedResourceScheme', async () => {
+        // Two transients carry IDENTICAL bytes (a duplicated font in a premium
+        // template). Both relocate to the same content-addressed target, so the
+        // engine's relocateResource no-ops on the second and still serializes its
+        // buffer:// URL. The plain save then throws SCENE.DISALLOWED_SCHEMES; the
+        // tool must retry with a drain callback that rewrites the straggler in the
+        // OUTPUT to its already-persisted workspace:// form.
+        const { fs, store, session, fakeEngine, engineLock } = makeDeps();
+        const fontBytes = new Uint8Array([9, 8, 7]);
+        fakeEngine._transients = [
+            { URL: 'buffer://1', size: 3 },
+            { URL: 'buffer://2', size: 3 }
+        ];
+        fakeEngine._resourceBytes.set('buffer://1', fontBytes);
+        fakeEngine._resourceBytes.set('buffer://2', fontBytes);
+        fakeEngine.editor.getMimeType.mockResolvedValue('font/ttf');
+        // Model the real engine: a plain save (no callback) throws because the
+        // duplicate straggler still serializes as buffer://2; a save WITH the
+        // drain callback invokes it for the straggler and embeds the rewrite.
+        fakeEngine.scene.saveToString.mockImplementation(async (opts) => {
+            if (!opts?.onDisallowedResourceScheme) {
+                const err = new Error('Scene contains disallowed schemes in resource URLs: "buffer"');
+                err.code = 'SCENE.DISALLOWED_SCHEMES';
+                throw err;
+            }
+            const rewritten = await opts.onDisallowedResourceScheme('buffer://2', 'hash');
+            return `SCENE:${rewritten}`;
+        });
+        const dir = await mkdtemp(join(tmpdir(), 'load-test-'));
+        const zipPath = join(dir, 'event_story.zip');
+        await writeFile(zipPath, FAKE_ZIP);
+        const tool = createLoadTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            allowPath: true
+        });
+        const result = await tool.call({ source: { path: zipPath } });
+        expect(result.isError).toBeUndefined();
+        const body = JSON.parse(textOf(result));
+        // Dedup: identical bytes → a single asset file, regardless of how many
+        // callers (relocate loop + drain callback) persisted them.
+        const sha = await shortHash(fontBytes);
+        expect(await fs.exists(`assets/${sha}.ttf`)).toBe(true);
+        const assetFiles = await fs.readdir('assets');
+        expect(assetFiles).toEqual([`${sha}.ttf`]);
+        // Persisted scene carries the workspace:// rewrite, not the buffer:// URL.
+        const rev = await store.read(body.revision);
+        expect(rev.scene).toBe(`SCENE:workspace://assets/${sha}.ttf`);
+        expect(rev.scene).not.toContain('buffer://2');
+        // After draining, the engine's in-memory state is realigned to the drained
+        // scene (the warm slot handed to the next edit must match the persisted
+        // revision — reloading collapses the duplicate typeface, dropping the
+        // un-relocatable buffer:// straggler).
+        expect(fakeEngine.scene.loadFromString).toHaveBeenCalledWith(`SCENE:workspace://assets/${sha}.ttf`, false, true);
+        await rm(dir, { recursive: true, force: true });
+    });
+    it('dedupes: an already-present sha is not rewritten', async () => {
+        const { fs, store, session, fakeEngine, engineLock } = makeDeps();
+        fakeEngine._transients = [{ URL: 'buffer://tmp/1', size: 3 }];
+        fakeEngine._resourceBytes.set('buffer://tmp/1', new Uint8Array([1, 2, 3]));
+        const sha = await shortHash(new Uint8Array([1, 2, 3]));
+        await fs.writeFile(`assets/${sha}.png`, new Uint8Array([1, 2, 3]));
+        const writeSpy = vi.spyOn(fs, 'writeFile');
+        const dir = await mkdtemp(join(tmpdir(), 'load-test-'));
+        const zipPath = join(dir, 'a.zip');
+        await writeFile(zipPath, FAKE_ZIP);
+        const tool = createLoadTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            allowPath: true
+        });
+        const result = await tool.call({ source: { path: zipPath } });
+        expect(result.isError).toBeUndefined();
+        const assetWrites = writeSpy.mock.calls.filter(([p]) => String(p).startsWith('assets/'));
+        expect(assetWrites).toHaveLength(0);
+        await rm(dir, { recursive: true, force: true });
+    });
+    it('marks the engine slot dirty when the engine throws', async () => {
+        const { fs, store, session, fakeEngine, engineLock } = makeDeps();
+        fakeEngine.scene.loadFromArchiveURL.mockRejectedValueOnce(new Error('corrupt archive'));
+        const dir = await mkdtemp(join(tmpdir(), 'load-test-'));
+        const zipPath = join(dir, 'a.zip');
+        await writeFile(zipPath, FAKE_ZIP);
+        const tool = createLoadTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            allowPath: true
+        });
+        const result = await tool.call({ source: { path: zipPath } });
+        expect(result.isError).toBe(true);
+        expect(textOf(result)).toMatch(/corrupt archive/);
+        expect(session.currentSlot()).toBeUndefined();
+        await rm(dir, { recursive: true, force: true });
+    });
+    it('loads an archive from a URL (fetched bytes, staged to a file:// URL)', async () => {
+        vi.stubGlobal('fetch', vi.fn(async () => new Response(FAKE_ZIP.slice())));
+        const { fs, store, session, fakeEngine, engineLock } = makeDeps();
+        const tool = createLoadTool({ fs, store, session, engineLock });
+        const result = await tool.call({
+            source: { url: 'https://example.com/tpl/event_story.zip' },
+            title: 'Event Story'
+        });
+        expect(result.isError).toBeUndefined();
+        const body = JSON.parse(textOf(result));
+        expect(body.title).toBe('Event Story');
+        expect(fakeEngine.scene.loadFromArchiveURL.mock.calls[0][0]).toMatch(/^file:\/\//);
+    });
+    it('derives a title from a malformed percent-encoded URL basename without throwing', async () => {
+        vi.stubGlobal('fetch', vi.fn(async () => new Response(FAKE_ZIP.slice())));
+        const { fs, store, session, engineLock } = makeDeps();
+        const tool = createLoadTool({ fs, store, session, engineLock });
+        const result = await tool.call({
+            source: { url: 'https://example.com/tpl/a%2.zip' }
+        });
+        expect(result.isError).toBeUndefined();
+        const body = JSON.parse(textOf(result));
+        expect(body.title).toBe('a%2');
+    });
+    it('does not percent-decode a local path — a literal `%` in the filename is preserved', async () => {
+        const { fs, store, session, engineLock } = makeDeps();
+        const dir = await mkdtemp(join(tmpdir(), 'load-test-'));
+        const zipPath = join(dir, 'my%20design.zip');
+        await writeFile(zipPath, FAKE_ZIP);
+        const tool = createLoadTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            allowPath: true
+        });
+        const result = await tool.call({ source: { path: zipPath } });
+        expect(result.isError).toBeUndefined();
+        const body = JSON.parse(textOf(result));
+        expect(body.title).toBe('my%20design');
+        await rm(dir, { recursive: true, force: true });
+    });
+});
+describe('load tool — bare .scene flow', () => {
+    it('persists the scene as-is and returns a scheme-classified, deduped asset report', async () => {
+        const { fs, store, session, fakeEngine, engineLock } = makeDeps();
+        // Real-engine shape (verified in CODE-3): durable re-fetchable refs the
+        // engine keeps as URLs (http(s)) come back from findAllMediaURIs(); anything
+        // it loaded into memory — workspace:// (via our resolver), bundle://
+        // fallbacks, buffer: orphans — comes back from findAllTransientResources()
+        // carrying its real URI. `shared.png` appears in BOTH lists → must dedupe.
+        fakeEngine.editor.findAllMediaURIs.mockReturnValue([
+            'https://cdn.example.com/hero.jpg',
+            'workspace://assets/shared.png'
+        ]);
+        fakeEngine._transients = [
+            { URL: 'workspace://assets/shared.png', size: 1 },
+            { URL: 'workspace://assets/logo.ttf', size: 2 },
+            { URL: 'bundle://ly.img.cesdk/fonts/x.otf', size: 3 },
+            { URL: 'buffer://orphan', size: 4 },
+            { URL: 'file:///tmp/local.png', size: 5 }
+        ];
+        const dir = await mkdtemp(join(tmpdir(), 'load-test-'));
+        const scenePath = join(dir, 'poster.scene');
+        await writeFile(scenePath, 'UBQ1BASE64SCENESTRING');
+        const tool = createLoadTool({
+            fs,
+            store,
+            session,
+            engineLock,
+            allowPath: true
+        });
+        const result = await tool.call({ source: { path: scenePath } });
+        expect(result.isError).toBeUndefined();
+        const body = JSON.parse(textOf(result));
+        expect(body.title).toBe('poster');
+        // Engine validated the content (loadFromString), persisted verbatim.
+        expect(fakeEngine.scene.loadFromString).toHaveBeenCalledWith('UBQ1BASE64SCENESTRING', false, true);
+        expect((await store.read(body.revision)).scene).toBe('UBQ1BASE64SCENESTRING');
+        // Classified by scheme; `shared.png` deduped to one entry; a durable-scheme
+        // URI (workspace/bundle/file) is NEVER labeled `transient` — only buffer:.
+        expect(body.assets).toEqual([
+            { uri: 'https://cdn.example.com/hero.jpg', class: 'external' },
+            { uri: 'workspace://assets/shared.png', class: 'workspace' },
+            { uri: 'workspace://assets/logo.ttf', class: 'workspace' },
+            { uri: 'bundle://ly.img.cesdk/fonts/x.otf', class: 'bundle' },
+            { uri: 'buffer://orphan', class: 'transient' },
+            { uri: 'file:///tmp/local.png', class: 'other' }
+        ]);
+        await rm(dir, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=load.test.js.map