@imgly/codesign-mcp 0.1.5 → 0.1.6

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

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

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

@@ -0,0 +1,9 @@
+import { Mutex } from '../../src/engine/mutex.js';
+import { EngineSession } from '../../src/engine/session.js';
+import { RevisionStore } from '../../src/revisions/store.js';
+export declare function makePreviewHarness(): {
+    store: RevisionStore;
+    session: EngineSession<unknown>;
+    engineLock: Mutex;
+};
+//# sourceMappingURL=preview-harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview-harness.d.ts","sourceRoot":"","sources":["../../../../test/tools/preview-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;AAG7D,wBAAgB,kBAAkB;;;;EAiBjC"}

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

@@ -0,0 +1,23 @@
+// Shared preview-tool test harness — a plain module (no test registrations) so importing it never re-runs preview.test.ts.
+import { Mutex } from '../../src/engine/mutex.js';
+import { EngineSession } from '../../src/engine/session.js';
+import { RevisionStore } from '../../src/revisions/store.js';
+import { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';
+export function makePreviewHarness() {
+    const fs = new InMemoryWorkspaceFS();
+    const store = new RevisionStore(fs);
+    const fakeEngine = {
+        block: {
+            export: async (_id, _mime) => new Blob([new Uint8Array([1, 2, 3, 4])])
+        }
+    };
+    const adapter = {
+        create: () => fakeEngine,
+        reset: async () => { },
+        loadFromString: async () => { },
+        saveToString: async () => ''
+    };
+    const session = new EngineSession({ size: 1, adapter });
+    return { store, session, engineLock: new Mutex() };
+}
+//# sourceMappingURL=preview-harness.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview-harness.js","sourceRoot":"","sources":["../../../../test/tools/preview-harness.ts"],"names":[],"mappings":"AAAA,2HAA2H;AAC3H,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,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,MAAM,UAAU,kBAAkB;IAChC,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,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3C;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,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,KAAK,EAAE,EAAE,CAAC;AACrD,CAAC","sourcesContent":["// Shared preview-tool test harness — a plain module (no test registrations) so importing it never re-runs preview.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 { InMemoryWorkspaceFS } from '../../src/workspace/in-memory.js';\n\nexport function makePreviewHarness() {\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([1, 2, 3, 4])])\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  return { store, session, engineLock: new Mutex() };\n}\n"]}

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

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

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

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

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

@@ -0,0 +1,36 @@
+import { describe, it, expect } from 'vitest';
+import { createPreviewTool } from '../../src/tools/preview.js';
+import { makePreviewHarness } from './preview-harness.js';
+describe('preview telemetry', () => {
+    it('records engine_execute and no write phases when revision is supplied', async () => {
+        const reports = [];
+        const harness = makePreviewHarness();
+        const root = await harness.store.write({
+            scene: 'SCENE_FOR_PREVIEW',
+            parent: null,
+            title: 'T'
+        });
+        const tool = createPreviewTool({
+            ...harness,
+            telemetry: { record: (r) => reports.push(r) }
+        });
+        const res = await tool.call({ blockId: 1, revision: root.id });
+        expect(res.isError).toBeUndefined();
+        expect(reports).toHaveLength(1);
+        const phases = reports[0].spans.map((s) => s.phase);
+        expect(phases).toContain('engine_execute');
+        expect(phases).not.toContain('engine_scene_save');
+        expect(reports[0].revision).toBe(root.id);
+    });
+    it('records succeeded=false when blockId is missing', async () => {
+        const reports = [];
+        const tool = createPreviewTool({
+            ...makePreviewHarness(),
+            telemetry: { record: (r) => reports.push(r) }
+        });
+        const res = await tool.call({});
+        expect(res.isError).toBe(true);
+        expect(reports[0].succeeded).toBe(false);
+    });
+});
+//# sourceMappingURL=preview.telemetry.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview.telemetry.test.js","sourceRoot":"","sources":["../../../../test/tools/preview.telemetry.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;YACrC,KAAK,EAAE,mBAAmB;YAC1B,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,iBAAiB,CAAC;YAC7B,GAAG,OAAO;YACV,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;SAC9C,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,iBAAiB,CAAC;YAC7B,GAAG,kBAAkB,EAAE;YACvB,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;SAC9C,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, it, expect } from 'vitest';\nimport { createPreviewTool } from '../../src/tools/preview.js';\nimport type { ToolCallReport } from '../../src/tools/spans.js';\nimport { makePreviewHarness } from './preview-harness.js';\n\ndescribe('preview telemetry', () => {\n  it('records engine_execute and no write phases when revision is supplied', async () => {\n    const reports: ToolCallReport[] = [];\n    const harness = makePreviewHarness();\n    const root = await harness.store.write({\n      scene: 'SCENE_FOR_PREVIEW',\n      parent: null,\n      title: 'T'\n    });\n    const tool = createPreviewTool({\n      ...harness,\n      telemetry: { record: (r) => reports.push(r) }\n    });\n    const res = await tool.call({ blockId: 1, revision: root.id });\n    expect(res.isError).toBeUndefined();\n    expect(reports).toHaveLength(1);\n    const phases = reports[0].spans.map((s) => s.phase);\n    expect(phases).toContain('engine_execute');\n    expect(phases).not.toContain('engine_scene_save');\n    expect(reports[0].revision).toBe(root.id);\n  });\n\n  it('records succeeded=false when blockId is missing', async () => {\n    const reports: ToolCallReport[] = [];\n    const tool = createPreviewTool({\n      ...makePreviewHarness(),\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"]}

package/dist/test/test/tools/schema-best-practices.d.ts

@@ -0,0 +1,13 @@
+export type Severity = 'error' | 'warn';
+export interface SchemaFinding {
+    /** Human-readable location inside the schema, e.g. `properties.source`. */
+    path: string;
+    /** Stable rule id (see RULES below). */
+    rule: string;
+    severity: Severity;
+    message: string;
+}
+/** Lint one tool's input schema. Returns all findings (errors + warnings). */
+export declare function lintToolSchema(schema: unknown): SchemaFinding[];
+export declare const errorsOnly: (findings: SchemaFinding[]) => SchemaFinding[];
+//# sourceMappingURL=schema-best-practices.d.ts.map

package/dist/test/test/tools/schema-best-practices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-best-practices.d.ts","sourceRoot":"","sources":["../../../../test/tools/schema-best-practices.ts"],"names":[],"mappings":"AA2BA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AA8JD,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,EAAE,CAI/D;AAED,eAAO,MAAM,UAAU,GAAI,UAAU,aAAa,EAAE,KAAG,aAAa,EACpB,CAAC"}

package/dist/test/test/tools/schema-best-practices.js

@@ -0,0 +1,169 @@
+// packages/codesign-mcp/test/tools/schema-best-practices.ts
+//
+// A tiny JSON-Schema linter for MCP *tool input schemas*, encoding the
+// cross-vendor best practices for reliable LLM tool calling. It exists because
+// a real eval regression traced back to a schema shape, not a model bug:
+// `load`'s `source` used a `oneOf` union, and a weaker model
+// (openrouter:xiaomi/mimo-v2.5-pro) serialized the whole object as an escaped
+// JSON string on every attempt — the exact `oneOf` failure documented against
+// Claude too (samchon/openapi#88). OpenAI sidesteps it by banning `oneOf` in
+// strict mode outright.
+//
+// Sources for the rules below:
+//   - samchon/openapi#88 — Claude fills `oneOf` unions as a JSON string.
+//   - OpenAI structured outputs: `oneOf`/`allOf`/`$ref`(recursive) unsupported
+//     in strict mode; root must be `object`; `additionalProperties:false`
+//     required; only a subset of JSON Schema is honoured.
+//   - Cohere structured outputs: `anyOf`/`allOf`/`oneOf`/`dependencies` not
+//     enforced.
+//   - Vendor + practitioner guidance (Anyscale, agenta, Cohere, LangChain):
+//     "keep tool schemas as flat as possible; deep nesting lowers generation
+//     quality"; "invest in descriptions/enums — +10-20% accuracy".
+//
+// The linter is deliberately conservative: HARD ERRORS are the constructs
+// documented to break or degrade tool calls across providers; WARNINGS are
+// quality nudges that shouldn't fail CI. `schema-best-practices.test.ts`
+// asserts zero errors over every registered tool and prints warnings.
+// Object-nesting depth at which we start nudging toward a flatter schema.
+// Root object = depth 1; one nested object (e.g. `source`) = depth 2 (fine).
+// Depth 3+ is where the "keep it flat" guidance starts to bite, so we warn.
+const MAX_OBJECT_DEPTH_BEFORE_WARN = 2;
+// Composition / reference keywords that are unsupported or unenforced by at
+// least one major provider's strict tool-calling path — each is a hard error.
+const BANNED_COMPOSITION_KEYS = [
+    'oneOf', // OpenAI: banned in strict mode; Claude/mimo: stringify the value
+    'allOf', // OpenAI/Cohere: unsupported/unenforced
+    'not', // unsupported in strict schemas
+    '$ref', // no external/recursive refs in strict mode — inline instead
+    '$defs',
+    'definitions',
+    'prefixItems', // tuple validation unsupported
+    'dependencies',
+    'dependentSchemas',
+    'dependentRequired'
+];
+const SCALAR_TYPES = new Set([
+    'string',
+    'number',
+    'integer',
+    'boolean',
+    'null'
+]);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** True when a schema node only ever produces a scalar (safe `anyOf` arm). */
+function isScalarSchema(node) {
+    if ('properties' in node || 'items' in node)
+        return false;
+    const t = node.type;
+    if (typeof t === 'string')
+        return SCALAR_TYPES.has(t);
+    if (Array.isArray(t))
+        return t.every((x) => SCALAR_TYPES.has(String(x)));
+    // No `type` at all → can't prove it's scalar; treat as complex.
+    return false;
+}
+/**
+ * Lint a single JSON-Schema node (recursively). `path` is the location label,
+ * `depth` counts object nesting, `isRoot` gates the "root must be object" rule.
+ */
+function lintNode(node, path, depth, isRoot, out) {
+    if (!isRecord(node))
+        return;
+    // Root of a tool input schema MUST be an object — every tool-call API
+    // requires it, and a non-object root cannot carry named arguments.
+    if (isRoot && node.type !== 'object') {
+        out.push({
+            path,
+            rule: 'root-must-be-object',
+            severity: 'error',
+            message: `tool input schema root must be { type: "object" }, got ${JSON.stringify(node.type)}`
+        });
+    }
+    // Banned composition/reference keywords anywhere in the tree.
+    for (const key of BANNED_COMPOSITION_KEYS) {
+        if (key in node) {
+            out.push({
+                path: `${path}.${key}`,
+                rule: `no-${key.replace('$', '')}`,
+                severity: 'error',
+                message: `\`${key}\` is unsupported/unenforced by strict tool-calling on at least one major provider — flatten it (prefer sibling optional fields + runtime validation, or \`type: [...]\` for nullability).`
+            });
+        }
+    }
+    // `anyOf` is the one union OpenAI keeps in strict mode, but only scalar arms
+    // are safe. An object/array arm reintroduces the discriminated-union shape
+    // that models stringify — so allow scalar unions (incl. the `["string",
+    // "null"]` nullable idiom) and flag complex arms.
+    if (Array.isArray(node.anyOf)) {
+        node.anyOf.forEach((arm, i) => {
+            if (isRecord(arm) && !isScalarSchema(arm)) {
+                out.push({
+                    path: `${path}.anyOf[${i}]`,
+                    rule: 'anyof-scalar-arms-only',
+                    severity: 'error',
+                    message: 'anyOf arms must be scalar types; an object/array arm is a discriminated union that weaker models serialize as a JSON string. Flatten to sibling fields.'
+                });
+            }
+            lintNode(arm, `${path}.anyOf[${i}]`, depth, false, out);
+        });
+    }
+    if (node.type === 'object') {
+        // Strict tool-calling (OpenAI et al.) requires closed objects.
+        if (node.additionalProperties !== false) {
+            out.push({
+                path,
+                rule: 'object-additional-properties-false',
+                severity: 'error',
+                message: 'object schemas must set `additionalProperties: false` for strict-mode adherence.'
+            });
+        }
+        if (depth > MAX_OBJECT_DEPTH_BEFORE_WARN) {
+            out.push({
+                path,
+                rule: 'keep-schema-flat',
+                severity: 'warn',
+                message: `object nesting depth ${depth} — deep nesting lowers generation quality; keep tool schemas as flat as the domain allows.`
+            });
+        }
+        const props = node.properties;
+        if (isRecord(props)) {
+            for (const [name, sub] of Object.entries(props)) {
+                const subPath = `${path}.properties.${name}`;
+                // Descriptions measurably improve tool-call accuracy (+10-20%).
+                if (isRecord(sub) &&
+                    (typeof sub.description !== 'string' || sub.description.trim() === '')) {
+                    out.push({
+                        path: subPath,
+                        rule: 'property-needs-description',
+                        severity: 'warn',
+                        message: `property \`${name}\` has no description — add one (+accuracy).`
+                    });
+                }
+                lintNode(sub, subPath, depth + 1, false, out);
+            }
+        }
+    }
+    if (node.type === 'array') {
+        if (!isRecord(node.items)) {
+            out.push({
+                path,
+                rule: 'array-needs-typed-items',
+                severity: 'warn',
+                message: 'array schema has no typed `items` — models generate array elements more reliably with a concrete item schema.'
+            });
+        }
+        else {
+            lintNode(node.items, `${path}.items`, depth, false, out);
+        }
+    }
+}
+/** Lint one tool's input schema. Returns all findings (errors + warnings). */
+export function lintToolSchema(schema) {
+    const findings = [];
+    lintNode(schema, '$', 1, true, findings);
+    return findings;
+}
+export const errorsOnly = (findings) => findings.filter((f) => f.severity === 'error');
+//# sourceMappingURL=schema-best-practices.js.map

package/dist/test/test/tools/schema-best-practices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-best-practices.js","sourceRoot":"","sources":["../../../../test/tools/schema-best-practices.ts"],"names":[],"mappings":"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","sourcesContent":["// packages/codesign-mcp/test/tools/schema-best-practices.ts\n//\n// A tiny JSON-Schema linter for MCP *tool input schemas*, encoding the\n// cross-vendor best practices for reliable LLM tool calling. It exists because\n// a real eval regression traced back to a schema shape, not a model bug:\n// `load`'s `source` used a `oneOf` union, and a weaker model\n// (openrouter:xiaomi/mimo-v2.5-pro) serialized the whole object as an escaped\n// JSON string on every attempt — the exact `oneOf` failure documented against\n// Claude too (samchon/openapi#88). OpenAI sidesteps it by banning `oneOf` in\n// strict mode outright.\n//\n// Sources for the rules below:\n//   - samchon/openapi#88 — Claude fills `oneOf` unions as a JSON string.\n//   - OpenAI structured outputs: `oneOf`/`allOf`/`$ref`(recursive) unsupported\n//     in strict mode; root must be `object`; `additionalProperties:false`\n//     required; only a subset of JSON Schema is honoured.\n//   - Cohere structured outputs: `anyOf`/`allOf`/`oneOf`/`dependencies` not\n//     enforced.\n//   - Vendor + practitioner guidance (Anyscale, agenta, Cohere, LangChain):\n//     \"keep tool schemas as flat as possible; deep nesting lowers generation\n//     quality\"; \"invest in descriptions/enums — +10-20% accuracy\".\n//\n// The linter is deliberately conservative: HARD ERRORS are the constructs\n// documented to break or degrade tool calls across providers; WARNINGS are\n// quality nudges that shouldn't fail CI. `schema-best-practices.test.ts`\n// asserts zero errors over every registered tool and prints warnings.\n\nexport type Severity = 'error' | 'warn';\n\nexport interface SchemaFinding {\n  /** Human-readable location inside the schema, e.g. `properties.source`. */\n  path: string;\n  /** Stable rule id (see RULES below). */\n  rule: string;\n  severity: Severity;\n  message: string;\n}\n\n// Object-nesting depth at which we start nudging toward a flatter schema.\n// Root object = depth 1; one nested object (e.g. `source`) = depth 2 (fine).\n// Depth 3+ is where the \"keep it flat\" guidance starts to bite, so we warn.\nconst MAX_OBJECT_DEPTH_BEFORE_WARN = 2;\n\n// Composition / reference keywords that are unsupported or unenforced by at\n// least one major provider's strict tool-calling path — each is a hard error.\nconst BANNED_COMPOSITION_KEYS = [\n  'oneOf', // OpenAI: banned in strict mode; Claude/mimo: stringify the value\n  'allOf', // OpenAI/Cohere: unsupported/unenforced\n  'not', // unsupported in strict schemas\n  '$ref', // no external/recursive refs in strict mode — inline instead\n  '$defs',\n  'definitions',\n  'prefixItems', // tuple validation unsupported\n  'dependencies',\n  'dependentSchemas',\n  'dependentRequired'\n] as const;\n\nconst SCALAR_TYPES = new Set([\n  'string',\n  'number',\n  'integer',\n  'boolean',\n  'null'\n]);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** True when a schema node only ever produces a scalar (safe `anyOf` arm). */\nfunction isScalarSchema(node: Record<string, unknown>): boolean {\n  if ('properties' in node || 'items' in node) return false;\n  const t = node.type;\n  if (typeof t === 'string') return SCALAR_TYPES.has(t);\n  if (Array.isArray(t)) return t.every((x) => SCALAR_TYPES.has(String(x)));\n  // No `type` at all → can't prove it's scalar; treat as complex.\n  return false;\n}\n\n/**\n * Lint a single JSON-Schema node (recursively). `path` is the location label,\n * `depth` counts object nesting, `isRoot` gates the \"root must be object\" rule.\n */\nfunction lintNode(\n  node: unknown,\n  path: string,\n  depth: number,\n  isRoot: boolean,\n  out: SchemaFinding[]\n): void {\n  if (!isRecord(node)) return;\n\n  // Root of a tool input schema MUST be an object — every tool-call API\n  // requires it, and a non-object root cannot carry named arguments.\n  if (isRoot && node.type !== 'object') {\n    out.push({\n      path,\n      rule: 'root-must-be-object',\n      severity: 'error',\n      message: `tool input schema root must be { type: \"object\" }, got ${JSON.stringify(\n        node.type\n      )}`\n    });\n  }\n\n  // Banned composition/reference keywords anywhere in the tree.\n  for (const key of BANNED_COMPOSITION_KEYS) {\n    if (key in node) {\n      out.push({\n        path: `${path}.${key}`,\n        rule: `no-${key.replace('$', '')}`,\n        severity: 'error',\n        message: `\\`${key}\\` is unsupported/unenforced by strict tool-calling on at least one major provider — flatten it (prefer sibling optional fields + runtime validation, or \\`type: [...]\\` for nullability).`\n      });\n    }\n  }\n\n  // `anyOf` is the one union OpenAI keeps in strict mode, but only scalar arms\n  // are safe. An object/array arm reintroduces the discriminated-union shape\n  // that models stringify — so allow scalar unions (incl. the `[\"string\",\n  // \"null\"]` nullable idiom) and flag complex arms.\n  if (Array.isArray(node.anyOf)) {\n    node.anyOf.forEach((arm, i) => {\n      if (isRecord(arm) && !isScalarSchema(arm)) {\n        out.push({\n          path: `${path}.anyOf[${i}]`,\n          rule: 'anyof-scalar-arms-only',\n          severity: 'error',\n          message:\n            'anyOf arms must be scalar types; an object/array arm is a discriminated union that weaker models serialize as a JSON string. Flatten to sibling fields.'\n        });\n      }\n      lintNode(arm, `${path}.anyOf[${i}]`, depth, false, out);\n    });\n  }\n\n  if (node.type === 'object') {\n    // Strict tool-calling (OpenAI et al.) requires closed objects.\n    if (node.additionalProperties !== false) {\n      out.push({\n        path,\n        rule: 'object-additional-properties-false',\n        severity: 'error',\n        message:\n          'object schemas must set `additionalProperties: false` for strict-mode adherence.'\n      });\n    }\n\n    if (depth > MAX_OBJECT_DEPTH_BEFORE_WARN) {\n      out.push({\n        path,\n        rule: 'keep-schema-flat',\n        severity: 'warn',\n        message: `object nesting depth ${depth} — deep nesting lowers generation quality; keep tool schemas as flat as the domain allows.`\n      });\n    }\n\n    const props = node.properties;\n    if (isRecord(props)) {\n      for (const [name, sub] of Object.entries(props)) {\n        const subPath = `${path}.properties.${name}`;\n        // Descriptions measurably improve tool-call accuracy (+10-20%).\n        if (\n          isRecord(sub) &&\n          (typeof sub.description !== 'string' || sub.description.trim() === '')\n        ) {\n          out.push({\n            path: subPath,\n            rule: 'property-needs-description',\n            severity: 'warn',\n            message: `property \\`${name}\\` has no description — add one (+accuracy).`\n          });\n        }\n        lintNode(sub, subPath, depth + 1, false, out);\n      }\n    }\n  }\n\n  if (node.type === 'array') {\n    if (!isRecord(node.items)) {\n      out.push({\n        path,\n        rule: 'array-needs-typed-items',\n        severity: 'warn',\n        message:\n          'array schema has no typed `items` — models generate array elements more reliably with a concrete item schema.'\n      });\n    } else {\n      lintNode(node.items, `${path}.items`, depth, false, out);\n    }\n  }\n}\n\n/** Lint one tool's input schema. Returns all findings (errors + warnings). */\nexport function lintToolSchema(schema: unknown): SchemaFinding[] {\n  const findings: SchemaFinding[] = [];\n  lintNode(schema, '$', 1, true, findings);\n  return findings;\n}\n\nexport const errorsOnly = (findings: SchemaFinding[]): SchemaFinding[] =>\n  findings.filter((f) => f.severity === 'error');\n"]}

package/dist/test/test/tools/schema-best-practices.test.d.ts

@@ -0,0 +1,3 @@
+import { type SchemaFinding } from './schema-best-practices.js';
+export declare function collectSchemaErrors(): SchemaFinding[];
+//# sourceMappingURL=schema-best-practices.test.d.ts.map

package/dist/test/test/tools/schema-best-practices.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-best-practices.test.d.ts","sourceRoot":"","sources":["../../../../test/tools/schema-best-practices.test.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,4BAA4B,CAAC;AAgNpC,wBAAgB,mBAAmB,IAAI,aAAa,EAAE,CAIrD"}

package/dist/test/test/tools/schema-best-practices.test.js

@@ -0,0 +1,194 @@
+// packages/codesign-mcp/test/tools/schema-best-practices.test.ts
+//
+// Two layers:
+//   1. Unit tests that the linter itself catches / passes the shapes it should.
+//   2. The contract: EVERY tool the server advertises must have ZERO hard-error
+//      findings. Warnings are printed (advisory) but don't fail the suite.
+//
+// This is the programmatic guard behind the "keep tool schemas simple" best
+// practices — it would have caught the `load` `oneOf` that made
+// openrouter:xiaomi/mimo-v2.5-pro stringify its arguments on every attempt.
+import { describe, expect, it } from 'vitest';
+import { buildDesignToolRegistrations } from '../../src/tools/index.js';
+import { createAssetGenerateTool } from '../../src/tools/asset-generate.js';
+import { errorsOnly, lintToolSchema } from './schema-best-practices.js';
+// ---------------------------------------------------------------------------
+// 1. Unit tests: the linter catches the constructs it claims to.
+// ---------------------------------------------------------------------------
+describe('lintToolSchema — rule coverage', () => {
+    const flatClean = {
+        type: 'object',
+        properties: {
+            source: {
+                type: 'object',
+                description: 'the source',
+                properties: {
+                    url: { type: 'string', description: 'http(s) url' },
+                    path: { type: 'string', description: 'local path' }
+                },
+                additionalProperties: false
+            },
+            title: { type: 'string', description: 'display name' }
+        },
+        required: ['source'],
+        additionalProperties: false
+    };
+    it('passes a flat, closed, described object schema', () => {
+        expect(errorsOnly(lintToolSchema(flatClean))).toEqual([]);
+    });
+    it('flags a `oneOf` union (the load/mimo failure mode)', () => {
+        const schema = {
+            type: 'object',
+            properties: {
+                source: {
+                    oneOf: [
+                        { type: 'object', properties: { url: { type: 'string' } } },
+                        { type: 'object', properties: { path: { type: 'string' } } }
+                    ]
+                }
+            },
+            additionalProperties: false
+        };
+        const rules = errorsOnly(lintToolSchema(schema)).map((f) => f.rule);
+        expect(rules).toContain('no-oneOf');
+    });
+    it('flags `allOf`, `$ref`, and `not`', () => {
+        for (const key of ['allOf', '$ref', 'not']) {
+            const schema = {
+                type: 'object',
+                properties: { x: { [key]: key === '$ref' ? '#/x' : [] } },
+                additionalProperties: false
+            };
+            const rules = errorsOnly(lintToolSchema(schema)).map((f) => f.rule);
+            expect(rules).toContain(`no-${key.replace('$', '')}`);
+        }
+    });
+    it('flags a non-object root', () => {
+        const rules = errorsOnly(lintToolSchema({ type: 'string' })).map((f) => f.rule);
+        expect(rules).toContain('root-must-be-object');
+    });
+    it('flags an object missing additionalProperties:false', () => {
+        const rules = errorsOnly(lintToolSchema({ type: 'object', properties: {} })).map((f) => f.rule);
+        expect(rules).toContain('object-additional-properties-false');
+    });
+    it('allows the `type: ["string","null"]` nullable idiom', () => {
+        const schema = {
+            type: 'object',
+            properties: {
+                parent: {
+                    type: ['string', 'null'],
+                    description: 'revision id, or null for a new root'
+                }
+            },
+            required: ['parent'],
+            additionalProperties: false
+        };
+        expect(errorsOnly(lintToolSchema(schema))).toEqual([]);
+    });
+    it('allows a scalar `anyOf` but rejects an object arm', () => {
+        const scalar = {
+            type: 'object',
+            properties: {
+                x: { anyOf: [{ type: 'string' }, { type: 'null' }], description: 'x' }
+            },
+            additionalProperties: false
+        };
+        expect(errorsOnly(lintToolSchema(scalar))).toEqual([]);
+        const objectArm = {
+            type: 'object',
+            properties: {
+                x: {
+                    anyOf: [
+                        { type: 'string' },
+                        { type: 'object', properties: {}, additionalProperties: false }
+                    ],
+                    description: 'x'
+                }
+            },
+            additionalProperties: false
+        };
+        expect(errorsOnly(lintToolSchema(objectArm)).map((f) => f.rule)).toContain('anyof-scalar-arms-only');
+    });
+    it('warns (does not error) on a missing property description', () => {
+        const findings = lintToolSchema({
+            type: 'object',
+            properties: { x: { type: 'string' } },
+            additionalProperties: false
+        });
+        expect(errorsOnly(findings)).toEqual([]);
+        expect(findings.map((f) => f.rule)).toContain('property-needs-description');
+    });
+});
+// ---------------------------------------------------------------------------
+// 2. Contract: every advertised tool schema is clean.
+// ---------------------------------------------------------------------------
+const stub = {};
+function gateway() {
+    return {
+        available: true,
+        generateImage: async () => ({
+            bytes: new Uint8Array(),
+            mimeType: 'image/png'
+        })
+    };
+}
+// Every tool the server can advertise, across both backends (Local exposes the
+// extra `import` tool and `load`/`save`/`export`'s `path`/`outPath` arms), plus
+// asset_generate (beta-hidden today, but its schema still ships in source and
+// will be exposed when the kill-switch flips). Deduped by tool name.
+function allToolSchemas() {
+    const byName = new Map();
+    for (const allowOutPath of [true, false]) {
+        for (const reg of buildDesignToolRegistrations({
+            fs: stub,
+            store: stub,
+            session: stub,
+            engineLock: stub,
+            gateway: gateway(),
+            urlBuilder: stub,
+            allowOutPath
+        })) {
+            byName.set(reg.name, reg.inputSchema);
+        }
+    }
+    const assetGen = createAssetGenerateTool({
+        gateway: gateway(),
+        fs: stub,
+        urlBuilder: stub
+    });
+    byName.set(assetGen.name, assetGen.inputSchema);
+    return [...byName].map(([name, schema]) => ({ name, schema }));
+}
+describe('tool input schemas follow LLM tool-calling best practices', () => {
+    const tools = allToolSchemas();
+    it('advertises a non-trivial set of tools (guards against an empty sweep)', () => {
+        expect(tools.length).toBeGreaterThanOrEqual(10);
+    });
+    it.each(tools)('$name — no hard-error schema findings', ({ schema }) => {
+        const errors = errorsOnly(lintToolSchema(schema));
+        // Surface a readable message when this fails.
+        expect(errors, errors.map((e) => `${e.path}: [${e.rule}] ${e.message}`).join('\n')).toEqual([]);
+    });
+    it('reports advisory warnings (non-failing) for visibility', () => {
+        const warnings = [];
+        for (const { name, schema } of tools) {
+            for (const f of lintToolSchema(schema)) {
+                if (f.severity === 'warn')
+                    warnings.push(`${name} ${f.path}: [${f.rule}] ${f.message}`);
+            }
+        }
+        if (warnings.length > 0) {
+            // eslint-disable-next-line no-console
+            console.warn(`\n[tool-schema best-practice warnings]\n${warnings.join('\n')}\n`);
+        }
+        // Advisory only — always passes. Kept as a test so the warnings render in
+        // CI output rather than being silently discarded.
+        expect(Array.isArray(warnings)).toBe(true);
+    });
+});
+// Re-exported so a future consumer (a `check` step, a CI gate) can reuse the
+// same sweep without duplicating the wiring.
+export function collectSchemaErrors() {
+    return allToolSchemas().flatMap(({ schema }) => errorsOnly(lintToolSchema(schema)));
+}
+//# sourceMappingURL=schema-best-practices.test.js.map