Skip to content

3D engine that AI agents drive

Fold the last 0.21.0 notes into the changelog

Nguyen Xuan Aned75ab79ba2d
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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.0
diff --git a/bench/guide-fields/released.json b/bench/guide-fields/released.json
index 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.json
index 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.json
index 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.json
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
deleted file mode 100644
index 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.md
index 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 |