3D engine that AI agents drive
JavaScript 3d3d-engineagentic-aiai-agentsblenderclaude-codegame-enginegaussian-splattinggltfjavascriptmcpmcp-servermodel-context-protocolpath-tracerpath-tracingpbrrenderingthreejs-alternativewebgl2webgpu
Fold the last 0.21.0 notes into the changelog
Nguyen Xuan Aned75ab79ba2d
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex e92a6e46..9a869de7 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -307,6 +307,15 @@- `hingedDoorSwing` in `crucible/addons/vehicle` swings a damaged door open on its hinge: a torque-driven, damped swing that stops at `maxAngle` with a small bounce and rests (#983)- `detachedPartFlight` in `crucible/addons/vehicle` gives a loose part torn off by a crash a seeded flight: launch from the impulse above its threshold, tumble, bounce and rest on the ground (#983)- `crucible/addons/vehicle` dents vehicle parts on impact, finds the moment a drive meets a wall and lists the parts that tear off, and recipes get a `dented` geometry (#983)+- `scene_capabilities` answers `meshEdit` and `meshStack` with each op's arguments (`name:type`, `?` for optional) and the face, edge and vertex rules once, so one call is enough before editing a mesh (#1929)+- The agent bench can answer `scene_ask_user` from a test-only fixture file (`CRUCIBLE_ASK_USER_FIXTURE`, set only by whoever starts the server), with a new `ask-user-pin` task, so tool schema changes to that tool can be benched (#1956)+- `scene_ask_user`: a pin on a part whose material other parts also use returns `materialSharedWith` (and `materialSharedWithMore`) like a lasso part, so an agent gives the part its own material before recolouring it; the bench has a new task, `ask-user-pin-shared` (#1972).+- Auto-framed camera and the preview ground of a skinned asset now use the drawn (skinned) bounds instead of the bind-pose bounds (#1976).+- The render-crucible-media skill matches 0.21.0 again: quality tiers, estimate and budget, transparent `stillCount` sequences, grid volumes in Cook, streamed texture sequences, caches, new limits and error rows (#1979)+- Audit the scene skill for 0.21.0: fix stale claims (motion duration range, emissiveColor tracks, ask-user wording), add explosion, retro, vehicle damage, pins and lasso, review page, splat palette and turntable how-tos in a new effects-and-feedback reference, and steer agents to the asset catalog, `scene_capabilities` and `scene_look` before guessing, boxing real objects or rendering (#1979).+- The showcase page has a Made with Crucible section for picked community work, and Show and tell asks for the credit, the licence and permission to feature it (#1980)+- `scene_ask_user`: the annotate page has a lasso tool; a lasso mark comes back with `kind` `"lasso"`, its `points` and the `parts` under the outline (most covered first, with `coverage`, `edge` below 0.15 and `materialSharedWith` for a material also used outside the mark), and the test-only answer fixture accepts `lasso` marks (#922).+- `scene_ask_user` takes an optional `motionTime`: the person marks the scene at that moment of its authored motion, and the answer's `view.motionTime` names it (#922).## 0.20.0diff --git a/bench/guide-fields/released.json b/bench/guide-fields/released.jsonindex 66c1b3f9..c4e468b5 100644--- a/bench/guide-fields/released.json+++ b/bench/guide-fields/released.json@@ -164,6 +164,7 @@"scene_apply operations[].visible","scene_apply sessionId","scene_ask_user maxMarks",+ "scene_ask_user motionTime","scene_ask_user prompt","scene_ask_user reviewFile","scene_ask_user sessionId",diff --git a/bench/size/baseline.json b/bench/size/baseline.jsonindex 391dfc69..a7fe8c6c 100644--- a/bench/size/baseline.json+++ b/bench/size/baseline.json@@ -15,13 +15,13 @@"bundles": {"entry:core": {"min": 315798,- "gzip": 95783,- "brotli": 82259+ "gzip": 95784,+ "brotli": 82292},"entry:core+lazy": {"min": 318746,- "gzip": 97142,- "brotli": 83449+ "gzip": 97143,+ "brotli": 83482},"entry:model": {"min": 40135,@@ -45,13 +45,13 @@},"entry:gltf": {"min": 177468,- "gzip": 58203,- "brotli": 50677+ "gzip": 58207,+ "brotli": 50547},"entry:gltf+lazy": {"min": 242075,- "gzip": 79286,- "brotli": 69559+ "gzip": 79290,+ "brotli": 69429},"entry:modeling": {"min": 46667,@@ -90,8 +90,8 @@},"entry:surface-attachment": {"min": 42282,- "gzip": 13428,- "brotli": 11153+ "gzip": 13427,+ "brotli": 11134},"entry:physics": {"min": 62229,@@ -120,18 +120,18 @@},"entry:retarget": {"min": 56722,- "gzip": 19473,- "brotli": 16623+ "gzip": 19472,+ "brotli": 16645},"entry:crowd-skinning": {"min": 71894,"gzip": 21988,- "brotli": 18819+ "brotli": 18881},"entry:skeleton-pose": {"min": 76258,- "gzip": 25379,- "brotli": 21929+ "gzip": 25380,+ "brotli": 21914},"entry:vehicle": {"min": 60314,@@ -234,24 +234,24 @@"brotli": 762},"entry:agent-scene": {- "min": 266385,- "gzip": 95084,- "brotli": 83874+ "min": 266852,+ "gzip": 95258,+ "brotli": 84035},"entry:agent-scene+lazy": {- "min": 1588963,- "gzip": 579604,- "brotli": 515309+ "min": 1589430,+ "gzip": 579776,+ "brotli": 515412},"entry:agent-asset": {- "min": 425316,- "gzip": 149805,- "brotli": 132056+ "min": 426509,+ "gzip": 150318,+ "brotli": 132454},"entry:agent-asset+lazy": {- "min": 1625229,- "gzip": 591668,- "brotli": 525001+ "min": 1626422,+ "gzip": 592182,+ "brotli": 525465},"entry:hdri": {"min": 22615,@@ -405,13 +405,13 @@},"entry:streaming": {"min": 11507,- "gzip": 4399,- "brotli": 3959+ "gzip": 4401,+ "brotli": 3963},"entry:streaming+lazy": {"min": 253476,- "gzip": 83547,- "brotli": 73446+ "gzip": 83554,+ "brotli": 73465},"entry:netcode": {"min": 25052,@@ -459,14 +459,14 @@"brotli": 4189},"entry:game": {- "min": 630675,- "gzip": 216558,- "brotli": 190600+ "min": 631434,+ "gzip": 216872,+ "brotli": 190885},"entry:game+lazy": {- "min": 1928017,- "gzip": 693916,- "brotli": 615988+ "min": 1928776,+ "gzip": 694224,+ "brotli": 616173},"entry:update-part-vertices": {"min": 1309,@@ -485,13 +485,13 @@},"entry:morph": {"min": 28623,- "gzip": 9633,- "brotli": 7887+ "gzip": 9632,+ "brotli": 7863},"entry:skinning": {- "min": 23742,- "gzip": 8356,- "brotli": 6705+ "min": 24249,+ "gzip": 8586,+ "brotli": 6928},"scene:lit-box": {"min": 214146,@@ -505,23 +505,23 @@},"scene:gltf-box": {"min": 313911,- "gzip": 96806,- "brotli": 83647+ "gzip": 96810,+ "brotli": 83605},"scene:gltf-box+lazy": {"min": 378523,- "gzip": 117892,- "brotli": 102532+ "gzip": 117896,+ "brotli": 102490},"scene:agent-scene": {- "min": 430990,- "gzip": 143161,- "brotli": 125891+ "min": 431457,+ "gzip": 143335,+ "brotli": 126064},"scene:agent-scene+lazy": {- "min": 1706408,- "gzip": 614882,- "brotli": 545946+ "min": 1706875,+ "gzip": 615070,+ "brotli": 546110}}}diff --git a/bench/size/budgets.json b/bench/size/budgets.jsonindex 96a5b968..ed2fdc9e 100644--- a/bench/size/budgets.json+++ b/bench/size/budgets.json@@ -1,5 +1,5 @@{- "archiveBytes": 1951497,+ "archiveBytes": 1963384,"goals": {"lit-box": 50000,"gltf-box": 80000,@@ -50,10 +50,10 @@"entry:path-tracer-realtime": 54600,"entry:path-tracer-realtime+lazy": 97100,"entry:texture-set": 900,- "entry:agent-scene": 97000,- "entry:agent-scene+lazy": 591200,- "entry:agent-asset": 152900,- "entry:agent-asset+lazy": 603600,+ "entry:agent-scene": 97200,+ "entry:agent-scene+lazy": 591400,+ "entry:agent-asset": 153400,+ "entry:agent-asset+lazy": 604100,"entry:hdri": 7900,"entry:camera-effects": 9400,"entry:water-reflection": 15000,@@ -95,18 +95,18 @@"entry:animation-graph": 14000,"entry:player": 7400,"entry:game-rules": 4800,- "entry:game": 220900,- "entry:game+lazy": 707800,+ "entry:game": 221300,+ "entry:game+lazy": 708200,"entry:update-part-vertices": 800,"entry:reflection-probes": 21400,"entry:fracture": 3000,"entry:morph": 9900,- "entry:skinning": 8600,+ "entry:skinning": 8800,"scene:lit-box": 63400,"scene:lit-box+lazy": 64800,"scene:gltf-box": 98800,"scene:gltf-box+lazy": 120300,- "scene:agent-scene": 146100,- "scene:agent-scene+lazy": 627200+ "scene:agent-scene": 146300,+ "scene:agent-scene+lazy": 627400}}diff --git a/bench/tool-cost-budgets.json b/bench/tool-cost-budgets.jsonindex 9a43f8ba..87f7b730 100644--- a/bench/tool-cost-budgets.json+++ b/bench/tool-cost-budgets.json@@ -1,5 +1,5 @@{- "schemaTotalBytes": 76470,+ "schemaTotalBytes": 76570,"schemaToolBytes": {"scene_apply": 23900,"scene_create": 13540,diff --git a/changes/1929-op-arguments.md b/changes/1929-op-arguments.mddeleted file mode 100644index 06be3183..00000000--- a/changes/1929-op-arguments.md+++ /dev/null@@ -1 +0,0 @@-- `scene_capabilities` answers `meshEdit` and `meshStack` with each op's arguments (`name:type`, `?` for optional) and the face, edge and vertex rules once, so one call is enough before editing a mesh (#1929)diff --git a/changes/1956.md b/changes/1956.mddeleted file mode 100644index 5d5a8f09..00000000--- a/changes/1956.md+++ /dev/null@@ -1 +0,0 @@-- The agent bench can answer `scene_ask_user` from a test-only fixture file (`CRUCIBLE_ASK_USER_FIXTURE`, set only by whoever starts the server), with a new `ask-user-pin` task, so tool schema changes to that tool can be benched (#1956)diff --git a/changes/1972.md b/changes/1972.mddeleted file mode 100644index d6cc8ed5..00000000--- a/changes/1972.md+++ /dev/null@@ -1 +0,0 @@-- `scene_ask_user`: a pin on a part whose material other parts also use returns `materialSharedWith` (and `materialSharedWithMore`) like a lasso part, so an agent gives the part its own material before recolouring it; the bench has a new task, `ask-user-pin-shared` (#1972).diff --git a/changes/1976.md b/changes/1976.mddeleted file mode 100644index 13a4ff58..00000000--- a/changes/1976.md+++ /dev/null@@ -1 +0,0 @@-- Auto-framed camera and the preview ground of a skinned asset now use the drawn (skinned) bounds instead of the bind-pose bounds (#1976).diff --git a/changes/1976.size.md b/changes/1976.size.mddeleted file mode 100644index 956871d5..00000000--- a/changes/1976.size.md+++ /dev/null@@ -1 +0,0 @@-- entry:skinning: the skinned bounds helper fixes a camera that framed empty floor and a ground slab that cut skinned models at the waist (#1976); 230 bytes gzip is a visible, functional fix. Approved by lead.diff --git a/changes/1979-render.md b/changes/1979-render.mddeleted file mode 100644index 6f40e051..00000000--- a/changes/1979-render.md+++ /dev/null@@ -1 +0,0 @@-- The render-crucible-media skill matches 0.21.0 again: quality tiers, estimate and budget, transparent `stillCount` sequences, grid volumes in Cook, streamed texture sequences, caches, new limits and error rows (#1979)diff --git a/changes/1979.md b/changes/1979.mddeleted file mode 100644index 87ef7de7..00000000--- a/changes/1979.md+++ /dev/null@@ -1 +0,0 @@-- Audit the scene skill for 0.21.0: fix stale claims (motion duration range, emissiveColor tracks, ask-user wording), add explosion, retro, vehicle damage, pins and lasso, review page, splat palette and turntable how-tos in a new effects-and-feedback reference, and steer agents to the asset catalog, `scene_capabilities` and `scene_look` before guessing, boxing real objects or rendering (#1979).diff --git a/changes/1980.md b/changes/1980.mddeleted file mode 100644index cd5189c2..00000000--- a/changes/1980.md+++ /dev/null@@ -1 +0,0 @@-- The showcase page has a Made with Crucible section for picked community work, and Show and tell asks for the credit, the licence and permission to feature it (#1980)diff --git a/changes/922-lasso.md b/changes/922-lasso.mddeleted file mode 100644index 6ee0d662..00000000--- a/changes/922-lasso.md+++ /dev/null@@ -1 +0,0 @@-- `scene_ask_user`: the annotate page has a lasso tool; a lasso mark comes back with `kind` `"lasso"`, its `points` and the `parts` under the outline (most covered first, with `coverage`, `edge` below 0.15 and `materialSharedWith` for a material also used outside the mark), and the test-only answer fixture accepts `lasso` marks (#922).diff --git a/changes/922-lasso.size.md b/changes/922-lasso.size.mddeleted file mode 100644index 8189a82b..00000000--- a/changes/922-lasso.size.md+++ /dev/null@@ -1,5 +0,0 @@-- scene:agent-scene: the lasso mark lets a person mean "these parts" in one gesture instead of pinning each part; the point-in-polygon, outline check and part resolution add about 116 bytes gzip, an agent-facing capability of issue 922.-- scene:agent-scene+lazy: the same code, about 107 bytes gzip.-- goal:agent-scene: the lasso is an agent-facing capability with no smaller home, since pick resolution and the mark validator already live in src/agent-annotate.js.-- scene:agent-scene: lasso parts list the unmarked parts that share their material (materialSharedWith) and mark grazed parts edge, which the Haiku bench of #1969 needed to stop a shared stone material turning the floor blue; a few hundred bytes of source and one tool description sentence, agent-facing.-- tool:scene_ask_user: one short phrase (materialSharedWith: own material first) stops an agent recolouring a material that parts outside the mark also use, which turned the floor blue in all 3 Haiku bench runs of ask-user-lasso; the mark description grew with the lasso (#1969) too. Approved by lead: +117 B; the Haiku bench went from 0/3 to 3/3 on ask-user-lasso with ask-user-pin unchanged at 3/3.diff --git a/changes/922.md b/changes/922.mddeleted file mode 100644index 0fdbb070..00000000--- a/changes/922.md+++ /dev/null@@ -1 +0,0 @@-- `scene_ask_user` takes an optional `motionTime`: the person marks the scene at that moment of its authored motion, and the answer's `view.motionTime` names it (#922).diff --git a/changes/922.size.md b/changes/922.size.mddeleted file mode 100644index cfa3bcca..00000000--- a/changes/922.size.md+++ /dev/null@@ -1 +0,0 @@-- goal:agent-scene: 32 bytes gzip so the preview seeks to the film time a person marks at and puts the scene back there to resolve the pins; without it a scene_look between the picture and Send would move the parts under the pins.diff --git a/docs/mcp.md b/docs/mcp.mdindex 75710a1b..c53fef64 100644--- a/docs/mcp.md+++ b/docs/mcp.md@@ -156,7 +156,7 @@ Inspect or export the recipe before retrying. Context loss still permits recipe| `mesh_edit` | `sessionId`, `expectedRevision`, `geometry`, `edits`, optional `replace` | Updated revision, render status and the mesh report with per-edit results || `mesh_stack` | `sessionId`, `expectedRevision`, `geometry`, optional `stack`, `apply` | Updated revision, render status and the mesh report with per-node results || `scene_look` | `sessionId`, optional `width`, `height`, `motionTime`, `labels` | PNG image and metadata |-| `scene_ask_user` | `sessionId`, optional `prompt`, `maxMarks`, `timeoutSeconds`, `motionTime` {since 0.22.0}, `reviewFile` | Opens the view in the browser, waits for Send, returns numbered marks with `partId`, `point`, `normal`, `note`, the camera and the marked PNG. With `reviewFile` it reads the marks a [review page](#review-link) saved instead (no browser, no image) |+| `scene_ask_user` | `sessionId`, optional `prompt`, `maxMarks`, `timeoutSeconds`, `motionTime`, `reviewFile` | Opens the view in the browser, waits for Send, returns numbered marks with `partId`, `point`, `normal`, `note`, the camera and the marked PNG. With `reviewFile` it reads the marks a [review page](#review-link) saved instead (no browser, no image) || `scene_review` | `sessionId`, `expectedRevision`, `shots` (each with an optional `branch`), optional `width`, `height`, `labels`, `response_format` | Labeled PNG grid and metadata from an isolated snapshot || `scene_checkpoint` | `sessionId` | Checkpoint ID, session ID, and revision || `scene_restore` | `sessionId`, `expectedRevision`, and a `checkpointId`, a `revision` or a `branch` | Updated revision and render status |