Skip to content

3D engine that AI agents drive

Keep the icons job schema under the tool cost ceiling (#2031)

Nguyen Xuan An145e500cabcd
diff --git a/changes/2031.size.md b/changes/2031.size.md
index 2dd82370..bc8e1c32 100644
--- a/changes/2031.size.md
+++ b/changes/2031.size.md
@@ -1,2 +1,2 @@
-- tool:scene_render_submit: the `icons` job kind adds `items`, `size`, `style`, `viewpoint`, `scale`, `padding`, `angles`, `breakdown`, `seed` and `sketch` so an agent can ask for a whole icon set, a turnaround or a breakdown in one call; the detail stays in `scene_capabilities` topic `jobs` under `icons`, and the new code sits in the MCP server bundle only.
-- tool-total: grows by the four sketch fields (`angles`, `breakdown`, `seed`, `sketch`) of `scene_render_submit`; no new tool.
+- tool:scene_render_submit: the `icons` job kind adds `items`, `size`, `style`, `viewpoint`, `scale`, `padding`, `angles`, `breakdown`, `seed` and `sketch` so an agent can ask for a whole icon set, a turnaround or a breakdown in one call; each field is bare and named, the detail (ranges, defaults, errors) stays in `scene_capabilities` topic `jobs` under `icons`, and the new code sits in the MCP server bundle only.
+- tool-total: 1167 bytes over the base for `scene_render_submit` (5901 against its 6000 ceiling), 42 of them from this slice's `angles`, `breakdown`, `seed` and `sketch`; no new tool.
diff --git a/scripts/mcp-server.mjs b/scripts/mcp-server.mjs
index aa006e42..93262821 100644
--- a/scripts/mcp-server.mjs
+++ b/scripts/mcp-server.mjs
@@ -869,16 +869,16 @@ const renderSettings = z.strictObject({
kind: z.enum(['image', 'stills', 'video', 'icons']),
width: z.number().int().min(64).max(MAXIMUM_JOB_SIDE).optional().describe('Not for icons, which use size.'),
height: z.number().int().min(64).max(MAXIMUM_JOB_SIDE).optional(),
- items: z.array(z.string().max(260)).min(1).max(256).optional().describe('icons: 1 to 256 catalog GLB names or asset ids; one transparent PNG each, plus atlas.png and icons.json. scene_capabilities jobs.icons.'),
- size: z.union([z.literal(64), z.literal(128), z.literal(256), z.literal(512)]).optional().describe('icons: pixels per icon side (default 256).'),
- style: z.enum(['clean', 'toon', 'sketch']).optional().describe('icons: clean (default), toon or sketch (ink outline and pencil hatching).'),
- viewpoint: z.union([z.literal('three-quarter'), z.strictObject({ azimuth: z.number().optional(), elevation: z.number().optional() })]).optional().describe('icons: three-quarter (default) or azimuth and elevation in degrees.'),
- scale: z.enum(['fit', 'relative']).optional().describe('icons: fit fills every icon; relative keeps one scale for the set.'),
- padding: z.number().optional().describe('icons: border as a fraction of the icon, 0.02 to 0.4 (default 0.08).'),
- angles: z.union([z.literal(1), z.literal(4), z.literal(8)]).optional().describe('icons: views around each item; 4 or 8 give a turnaround row per item.'),
- breakdown: z.boolean().optional().describe('icons, sketch: also write breakdown-<item>.png, the steps side by side.'),
- seed: z.number().int().min(0).max(65535).optional().describe('icons, sketch: seed of the pencil wobble (default 0).'),
- sketch: z.strictObject({ inkColor: z.string().max(7).optional(), paperColor: z.string().max(7).optional(), hatchDensity: z.number().optional(), jitter: z.number().optional() }).optional().describe('icons, sketch: #rrggbb colours, hatchDensity 0.5 to 2, jitter 0 to 1.'),
+ items: z.array(z.string().max(260)).min(1).max(256).optional().describe('icons: catalog GLB names or asset ids, one PNG each plus atlas and icons.json. Every icons field: scene_capabilities jobs.icons.'),
+ size: z.number().int().min(64).max(512).optional().describe('icons: 64, 128, 256 or 512 px.'),
+ style: z.enum(['clean', 'toon', 'sketch']).optional(),
+ viewpoint: z.union([z.literal('three-quarter'), z.record(z.string(), z.number())]).optional().describe('icons: three-quarter or { azimuth, elevation }.'),
+ scale: z.enum(['fit', 'relative']).optional(),
+ padding: z.number().optional(),
+ angles: z.number().int().min(1).max(8).optional().describe('icons: 1, 4 or 8 views per item.'),
+ breakdown: z.boolean().optional().describe('icons, sketch: steps strip per item.'),
+ seed: z.number().int().min(0).max(65535).optional(),
+ sketch: z.record(z.string(), z.union([z.string(), z.number()])).optional().describe('icons, sketch: inkColor, paperColor, hatchDensity, jitter.'),
fps: z.number().int().min(1).max(MAXIMUM_JOB_FPS).optional(),
duration: z.number().min(0.1).max(60).optional(),
animation: z.strictObject({ clip: z.number().int().min(0), start: z.number().min(0).max(3600).optional() }).optional(),