Skip to content

armgit / kiln

Public Imported from GitHub
0

Build and revise procedural 3D assets with your coding agent. Local MCP server, CLI and TypeScript engine with rendered review, editable source and GLB export.

feat(composer): bind ordered render evidence (#33)

Matthew Kissinger77e2eb291c34
diff --git a/src/__tests__/composer-world-run.test.ts b/src/__tests__/composer-world-run.test.ts
index 05560232..22701c46 100644
--- a/src/__tests__/composer-world-run.test.ts
+++ b/src/__tests__/composer-world-run.test.ts
@@ -127,6 +127,8 @@ describe('runKilnWorldIntegration', () => {
backend: 'vulkan',
rendererId: 'dawn-vulkan:test',
outputSha256: `sha256:${'c'.repeat(64)}` as const,
+ perCameraOutputSha256: [`sha256:${'c'.repeat(64)}` as const],
+ outputSetSha256: `sha256:${'e'.repeat(64)}` as const,
};
const model = new ToolCapturingModel([
{ toolCalls: [{ name: 'scene_world_render' }] },
@@ -165,8 +167,75 @@ describe('runKilnWorldIntegration', () => {
const modelContext = JSON.stringify(model.messages);
expect(modelContext).toContain('dawn-vulkan:test');
expect(modelContext).toContain('outputSha256');
+ expect(modelContext).toContain('perCameraOutputSha256');
+ expect(modelContext).toContain('outputSetSha256');
expect(modelContext).toContain('"degraded":false');
expect(modelContext).not.toContain('fallbackReceipt');
+
+ receipt!.perCameraOutputSha256[0] = `sha256:${'f'.repeat(64)}`;
+ expect(result.renderEvidence[0]!.receipt!.perCameraOutputSha256).toEqual([
+ `sha256:${'c'.repeat(64)}`,
+ ]);
+ });
+
+ test('rejects mismatched per-camera output evidence and exact/fallback ambiguity', async () => {
+ const exact = {
+ worldHash: `sha256:${'a'.repeat(64)}` as const,
+ cameras: [
+ {
+ position: [12, 8, 15] as [number, number, number],
+ target: [0, 1, 0] as [number, number, number],
+ up: [0, 1, 0] as [number, number, number],
+ fovDeg: 50,
+ aspect: 1,
+ near: 0.1,
+ far: 500,
+ },
+ ],
+ width: 512,
+ height: 512,
+ lightingPresetId: 'neutral-studio-v1',
+ backend: 'vulkan',
+ rendererId: 'dawn-vulkan:test',
+ outputSha256: `sha256:${'b'.repeat(64)}` as const,
+ perCameraOutputSha256: [
+ `sha256:${'b'.repeat(64)}` as const,
+ `sha256:${'c'.repeat(64)}` as const,
+ ],
+ outputSetSha256: `sha256:${'d'.repeat(64)}` as const,
+ };
+ const fallback = {
+ cameraAttested: false as const,
+ backend: 'cpu',
+ rendererId: 'cpu-raster:test',
+ outputSha256: `sha256:${'e'.repeat(64)}` as const,
+ };
+ const run = async (render: SceneRenderPort) => {
+ const model = new ToolCapturingModel([{ toolCalls: [{ name: 'scene_world_render' }] }]);
+ const result = await runKilnWorldIntegration({
+ model,
+ prompt: 'inspect the world',
+ world: world(),
+ render,
+ maxSteps: 3,
+ });
+ return { result, context: JSON.stringify(model.messages) };
+ };
+
+ const mismatched = await run(async () => ({
+ ok: true,
+ pngBase64: Buffer.from('png').toString('base64'),
+ receipt: exact,
+ }));
+ expect(mismatched.context).toContain('per-camera output hashes');
+
+ const ambiguous = await run(async () => ({
+ ok: true,
+ pngBase64: Buffer.from('png').toString('base64'),
+ receipt: { ...exact, perCameraOutputSha256: exact.perCameraOutputSha256.slice(0, 1) },
+ fallbackReceipt: fallback,
+ }));
+ expect(ambiguous.context).toContain('both exact and fallback receipts');
});
test('surfaces an ok CPU fallback as degraded evidence without inventing a receipt', async () => {
diff --git a/src/composer/agent/world-run.ts b/src/composer/agent/world-run.ts
index 359fd289..540f87c8 100644
--- a/src/composer/agent/world-run.ts
+++ b/src/composer/agent/world-run.ts
@@ -166,8 +166,17 @@ function lifecycleTools(
}
function cloneReceipt(receipt: SceneRenderReceipt): SceneRenderReceipt {
+ if (
+ receipt.perCameraOutputSha256 !== undefined &&
+ receipt.perCameraOutputSha256.length !== receipt.cameras.length
+ ) {
+ throw new TypeError('render receipt per-camera output hashes must match cameras');
+ }
return {
...receipt,
+ ...(receipt.perCameraOutputSha256
+ ? { perCameraOutputSha256: [...receipt.perCameraOutputSha256] }
+ : {}),
cameras: receipt.cameras.map((camera) => ({
...camera,
position: [...camera.position],
diff --git a/src/composer/render-port.ts b/src/composer/render-port.ts
index abfd7383..83612cf5 100644
--- a/src/composer/render-port.ts
+++ b/src/composer/render-port.ts
@@ -58,6 +58,12 @@ export interface SceneRenderReceipt {
lightingPresetId: string;
backend: string;
rendererId: string;
+ /** Ordered digest for every camera output. When present, its length must
+ * exactly match `cameras`; omitted for legacy hosts that only bind the
+ * primary/composited output. */
+ perCameraOutputSha256?: `sha256:${string}`[];
+ /** Digest of the host's deterministic ordered output-set encoding. */
+ outputSetSha256?: `sha256:${string}`;
outputSha256: `sha256:${string}`;
}