cozyclay 3.0.3 → 3.1.1

package/dist/cozyclay-package.json

@@ -1 +1 @@
-{"payload":"{\"distribution\":\"npm\",\"package\":\"cozyclay\",\"version\":\"3.0.3\",\"repository\":\"NomaDamas/CozyClay\",\"content_sha256\":\"b8a07fdd5d546c0314c6099680d3569a89a01e59bd3a442fb2360f1acec56330\"}","signature":"uZinWHO8tjMSZNdv8SjUSnLeHER+UvdGPW6ay++FCJiXOt8eIKjw0bYpN4HJpoNQG6/i9RBBeKMdrPBepn76Ag=="}
+{"payload":"{\"distribution\":\"npm\",\"package\":\"cozyclay\",\"version\":\"3.1.1\",\"repository\":\"NomaDamas/CozyClay\",\"content_sha256\":\"65554e5162b89f817b066016390471333bfcabcee80e0ae0ee46939bdc759599\"}","signature":"M4R6haq7YzLWxDPcdy5h4zI/w7nVEBubTszIj4UzgWEKB4XZgZYtrjsQJmjt2rF3IooyCKnvMlzNiYB/arAGDg=="}

package/dist/greybox-to-video/index.html

@@ -185,9 +185,8 @@
         <h2>Do it in the browser</h2>
         <p>
           CozyClay is open source previs that runs in a Chromium tab. It exists for exactly this loop: block,
-          camera, export, generate. The <a href="/#try">playground on the home page</a> walks through the camera
-          part in seven moves on the same city block you see in the reels, and <code>npx cozyclay --scene city-block</code>
-          opens that set on your machine.
+          camera, export, generate. The <a href="/#try">playground on the home page</a> runs the studio in the page, and
+          <code>npx cozyclay</code> runs it on your machine.
         </p>
         <div class="cta">
           <a class="btn primary" href="/#try">Try it in your browser</a>

package/dist/index.html

@@ -159,23 +159,9 @@
       a.card { color: var(--ink); text-decoration: none; font-size: 19px; font-weight: 600; min-height: 96px; transition: transform .2s; }
       a.card:hover { transform: translateY(-2px); }
 
-      /* Playground. The ids and data-state values belong to the tutorial script below. */
-      /* The steps sit in the window's title bar so the studio gets the full
-         content width and height; started, the demo scrolls up to fill the screen. */
+      /* Playground. The ids and data-state values belong to the script below. */
       .demo { scroll-margin-top: 76px; }
       .demo .window { min-width: 0; box-shadow: 0 2px 6px rgba(0, 0, 0, .06), 0 24px 48px rgba(0, 0, 0, .14); }
-      .tutorial-steps { flex: 1; min-width: 0; display: flex; justify-content: center; gap: 4px; margin: 0 52px 0 0; padding: 0; list-style: none; overflow: hidden; }
-      .tutorial-steps[hidden] { display: none; }
-      .tutorial-steps li {
-        display: flex; align-items: center; gap: 6px; min-height: 28px; padding: 0 10px; border-radius: 999px; white-space: nowrap;
-        background: var(--panel); border: 1px solid var(--line); color: var(--ink); font-size: 14px;
-        opacity: .55; transition: opacity .2s, background .15s;
-      }
-      .playground-live .tutorial-steps li { opacity: 1; }
-      .tutorial-steps li[data-done="1"] { color: var(--ok); border-color: var(--ok); }
-      .tutorial-steps li[data-done="1"]::after { content: "✓"; font-weight: 700; }
-      .tutorial-steps li[data-current="1"] { background: var(--accent); border-color: var(--accent); color: #fff; font-weight: 600; }
-
       .playground {
         position: relative;
         /* Header 64 + margin 12 + title bar 40 + bottom bar 52 + 12. */
@@ -216,26 +202,6 @@
       .playground-bar .spacer { flex: 1; }
       button.copy[data-state="copied"] { border-color: var(--ok); color: var(--ok); }
 
-      .tutorial-card {
-        position: absolute; left: 14px; top: 14px; z-index: 2; max-width: 46%;
-        display: flex; gap: 10px; align-items: baseline;
-        padding: 10px 14px; border-radius: 10px; pointer-events: none;
-        background: rgba(255, 255, 255, .92); border: 1px solid var(--line); color: var(--ink);
-        font-size: 17px; line-height: 1.45; backdrop-filter: blur(12px); -webkit-backdrop-filter: blur(12px);
-        box-shadow: var(--shadow-card);
-      }
-      .tutorial-card[hidden] { display: none; }
-      .tutorial-card-step { color: var(--accent); font-size: 14px; font-weight: 600; white-space: nowrap; }
-      .tutorial-card b { color: var(--accent); font-weight: 600; }
-      .tutorial-card kbd, .tutorial-done kbd {
-        padding: 2px 6px; border-radius: 5px;
-        border: 1px solid var(--line-strong); background: var(--bg); color: var(--ink);
-      }
-      .tutorial-card kbd[data-done="1"] { border-color: var(--ok); color: var(--ok); background: #e6f2e7; }
-      .tutorial-done { flex-basis: 100%; margin: 0 0 4px; color: var(--ink); display: flex; gap: 10px; align-items: center; flex-wrap: wrap; }
-      .tutorial-done[hidden] { display: none; }
-      .tutorial-done p { flex-basis: 100%; margin: 0; }
-      #playground-download-status, #playground-download-error { flex-basis: 100%; margin: 0; }
       .demo-note { margin: 24px 0 0; }
 
       /* Quick start */
@@ -285,11 +251,8 @@
         .playground-cover .btn, .playground-cover small { display: none; }
         .playground-phone { display: block; font-size: 14px; padding: 0 24px; text-align: center; }
         .playground-cover { cursor: default; }
-        /* No playground here, so no steps squeezed into the title bar. */
-        .tutorial-steps { visibility: hidden; }
       }
       @media (max-width: 720px) {
-        .tutorial-card { max-width: 90%; }
         section { padding: 64px 0; }
         .hero { padding: 56px 0 40px; }
         .proof { padding-bottom: 64px; }
@@ -298,12 +261,11 @@
       }
       @media (prefers-reduced-motion: reduce) {
         html { scroll-behavior: auto; }
-        .btn, a.card, .seg button, .tutorial-steps li { transition: none; }
+        .btn, a.card, .seg button { transition: none; }
       }
     </style>
-    <script type="module" crossorigin src="/assets/landing-DYg87MDY.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/analytics-BibyE5ar.js">
-    <link rel="modulepreload" crossorigin href="/assets/first-shot-handoff-Qx7SKl38.js">
+    <script type="module" crossorigin src="/assets/landing-y3EqDgSZ.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/modulepreload-polyfill-P2Xu9kJm.js">
   </head>
   <body>
     <header class="site">
@@ -383,28 +345,16 @@
         <h2>Try it</h2>
         <div class="demo">
         <div class="window">
-        <div class="titlebar"><i aria-hidden="true"></i><i aria-hidden="true"></i><i aria-hidden="true"></i><ol class="tutorial-steps" id="tutorial-steps" aria-label="Tutorial steps"></ol></div>
+        <div class="titlebar" aria-hidden="true"><i></i><i></i><i></i><span>CozyClay</span></div>
         <div class="playground" id="playground" style="background-image: url('/media/playground-poster.jpg')">
           <button class="playground-cover" id="playground-start" type="button" aria-label="Start the playground">
-            <span class="btn primary">Play with the scene</span>
+            <span class="btn primary">Open the studio here</span>
             <small>About 2 MB</small>
             <span class="playground-phone">Needs a mouse and keyboard. Come back on a computer, or run <code>npx cozyclay --via site</code>.</span>
           </button>
           <div class="playground-loading">Loading the studio…</div>
-          <div class="tutorial-card" id="tutorial-card" aria-live="polite">
-            <span class="tutorial-card-step" id="tutorial-card-step"></span>
-            <span class="tutorial-card-text" id="tutorial-now"></span>
-          </div>
         </div>
         <div class="playground-bar">
-          <div class="tutorial-done" id="tutorial-done" hidden>
-            <p>Take your shot with you. Video export is not offered in this embedded Playground.</p>
-            <p>Download your edited project, run <code>npx cozyclay --via playground</code>, and open the downloaded <code>.cclayproject</code> in the local Studio. Use its existing Export menu for video.</p>
-            <button type="button" id="playground-download" class="copy">Download my project</button>
-            <button type="button" id="playground-handoff-dismiss">Continue editing</button>
-          </div>
-          <p id="playground-download-status" role="status" hidden></p>
-          <p id="playground-download-error" role="alert" hidden></p>
           <span class="spacer"></span>
           <button type="button" id="playground-full">Fullscreen</button>
           <a href="/app/" target="_blank" rel="noopener">Open studio ↗</a>
@@ -422,7 +372,7 @@
           <div class="cards">
             <div class="card">
               <h3>Stage a scene</h3>
-              <p>Primitives, set pieces, plan view.</p>
+              <p>Primitives, imported models, plan view.</p>
             </div>
             <div class="card">
               <h3>Move through the set</h3>

package/dist/llms.txt

@@ -4,7 +4,7 @@
 
 ## Pages
 
-- [Home](https://cozyclay.org/): what it does, demo reels, an in-browser playground with a seven-step camera tutorial, quick start.
+- [Home](https://cozyclay.org/): what it does, demo reels, an in-browser playground running the studio, quick start.
 - [Greybox to AI video](https://cozyclay.org/greybox-to-video/): why a grey blockout is the most reliable input to a video model, and the block-then-generate workflow.
 - [Previs software compared](https://cozyclay.org/previs-software/): free, open source and browser-based previs tools side by side.
 - [Seedance 2.5 camera control](https://cozyclay.org/seedance-camera-control/): getting the same camera every take with a reference clip instead of camera prompts.
@@ -28,4 +28,5 @@ For source-checkout CI, start the same Studio in owned headless Chrome with `nod
 ## Source
 
 - GitHub: https://github.com/NomaDamas/CozyClay
+- Agent install guide: https://github.com/NomaDamas/CozyClay/blob/main/INSTALL_FOR_AGENTS.md
 - npm: https://www.npmjs.com/package/cozyclay

package/dist/previs-software/index.html

@@ -124,8 +124,8 @@
         <p>
           The honest split is time, not money. Blender can do everything on this page and will take an
           afternoon to learn just the camera. CozyClay does one thing (block, camera, cut, export) and expects
-          you to be productive in the first ten minutes; there is a <a href="/#try">seven-step tutorial on the home page</a>
-          that takes about that long.
+          you to be productive in the first ten minutes; the <a href="/#try">playground on the home page</a>
+          runs it in the page.
         </p>
       </section>
 

package/dist/privacy/index.html

@@ -132,12 +132,11 @@ cclay telemetry on</code></pre>
             <thead><tr><th>Event</th><th>Purpose</th></tr></thead>
             <tbody>
               <tr><td>install:first_launch, app:session_started, app:session_ended</td><td>Counting installs and sessions; duration and action counts are bucketed. install:first_launch may carry heard_from (x, hn, reddit, github, friend, other, site or playground), from the first-launch prompt or a copied <code>npx cozyclay --via</code> command. app:session_ended also carries per-session edit gesture counts in five groups, pose_edit_bucket, camera_edit_bucket, object_edit_bucket, shot_edit_bucket and prompt_edit_bucket, each bucketed (0, 1-3, 4-10 or gte11); never what was edited</td></tr>
-              <tr><td>feature:used</td><td>One signal per feature per session: a fixed feature name such as pose_edit (a real bone or pose change), pose_save (saving a pose to the library), fal_motion_open (opening the AI video A/B card), camera_fly or export_video</td></tr>
+              <tr><td>feature:used</td><td>One signal per feature per session: a fixed feature name such as pose_edit (a real bone or pose change), pose_save (saving a pose to the library), camera_fly or export_video</td></tr>
               <tr><td>$pageview, scene:created, scene:loaded, craft:first_action, activation:completed</td><td>Funnel and drop-off analysis</td></tr>
               <tr><td>craft:first_edit</td><td>First successful Studio authoring change per editor mount; only a fixed edit-kind label and definition version 1 (not camera navigation, playback, loading, restore, or undo/redo)</td></tr>
               <tr><td>playground:first_edit</td><td>The same versioned first-edit definition for Playground, counted separately from Studio; no prompts or scene contents</td></tr>
               <tr><td>project:saved, project:opened</td><td>Whether people keep their work (object counts and ages are bucketed; never names or paths)</td></tr>
-              <tr><td>motion:backend_state</td><td>Session capability baseline: backend (none, local_kimodo or hosted) and boolean host_configured, never a host address</td></tr>
               <tr><td>motion:generate_requested</td><td>Explicit generation intent, not prompt-block editing: initiating surface (timeline, line_edit, trail, mcp, fal_card or agent), input_mode (prompt, pose, edit, a_to_b or still) and an ephemeral random request_id</td></tr>
               <tr><td>motion:preflight_blocked</td><td>Request readiness refusal: request_id, surface and normalized reason (unconfigured, unreachable, unsupported_route, locked or missing_input). locked means the AI video route is not enabled for the account yet; missing_input means the A/B captures were incomplete</td></tr>
               <tr><td>motion:preflight_passed</td><td>Request readiness accepted, before job start: request_id, surface and backend (none, local_kimodo, hosted or fal)</td></tr>
@@ -163,10 +162,6 @@ cclay telemetry on</code></pre>
               <tr><td>device:profile</td><td>Once per session, whether the studio can run smoothly: gpu_vendor (nvidia, amd, intel, apple, qualcomm, arm, software, other or unknown), gpu_class (discrete, integrated, software or unknown), webgl (webgl2, webgl1 or none), cpu_bucket (1-4, 5-8, 9-16, gte17 or unknown), memory_bucket (lt4, 4-7, gte8 or unknown) and frame_rate_bucket (lt20, 20-40, 40-55, gte55 or unknown) from one three-second sample. The GPU renderer string and exact hardware values never leave the browser.</td></tr>
               <tr><td>survey:use_case</td><td>An optional question shown at most once after a successful export, only while telemetry is on: use_case (animation, film, game, ad_mv, personal, other or skip) and team (team, solo or skip). Closed choices only; no free text.</td></tr>
               <tr><td>hosted:composer_viewed, hosted:login_started, hosted:ticket_created, hosted:result_opened, hosted:opened_in_studio</td><td>Hosted demo funnel</td></tr>
-              <tr><td>tutorial:started</td><td>Camera tutorial attempts on surface (studio or playground), with numeric tutorial_version 1 and start_source (query, settings or landing). Restarting starts a new attempt; no tutorial attempt identifier or user text is sent.</td></tr>
-              <tr><td>tutorial:step_entered, tutorial:dismissed</td><td>Entered steps and explicit dismissal of an unfinished tutorial; surface (studio or playground), numeric tutorial_version 1 and step_kind (fly, walk, dolly, orbit, shot, rail or play). Missing completion can indicate abandonment or missing telemetry; browser close does not promise a dismissal event.</td></tr>
-              <tr><td>tutorial:step_completed</td><td>One completion per step per attempt; surface (studio or playground), numeric tutorial_version 1, step_kind (fly, walk, dolly, orbit, shot, rail or play) and elapsed_bucket (lt1s, 1-3s, 3-10s, 10-30s or gte30s) since entering that step. No raw timing, prompts, scene contents, names or paths.</td></tr>
-              <tr><td>tutorial:completed</td><td>All seven steps completed; surface (studio or playground), numeric tutorial_version 1 and elapsed_bucket (lt1s, 1-3s, 3-10s, 10-30s or gte30s) since tutorial start. Sample loading and camera playback do not count as a user edit.</td></tr>
             </tbody>
           </table>
         </div>
@@ -178,7 +173,8 @@ cclay telemetry on</code></pre>
       <section>
         <h2>The hosted demo (Google sign-in)</h2>
         <p>
-          The hosted motion demo asks you to sign in with Google so that the daily generation cap can be
+          The hosted demo is not open to the public right now. This section describes what it handled while it
+          was running. The hosted motion demo asks you to sign in with Google so that the daily generation cap can be
           enforced per account. It receives your Google account's email address and basic profile only, stores
           a session cookie signed by our server, and keeps your prompt and the generated result for up to 30
           days so the ticket link keeps working. Results are stored on Cloudflare R2 and deleted after that

package/dist/seedance-camera-control/index.html

@@ -146,8 +146,8 @@
           Any 3D tool that renders flat can make the reference. Blender works with a clay material and a
           workbench render. CozyClay, open source and in the browser, exports the flat clip directly with the
           delivery ratio and a camera timeline built in; the reel at the top of this page came out of it.
-          The <a href="/#try">home-page playground</a> walks through blocking a shot and drawing a dolly rail in
-          seven moves, and <code>npx cozyclay --scene city-block</code> opens that set locally.
+          The <a href="/#try">home-page playground</a> runs the studio in the page, and
+          <code>npx cozyclay</code> runs it locally.
         </p>
         <div class="cta">
           <a class="btn primary" href="/#try">Try it in your browser</a>

package/dist/sitemap.xml

@@ -2,19 +2,19 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://cozyclay.org/</loc>
-    <lastmod>2026-10-08</lastmod>
+    <lastmod>2026-10-21</lastmod>
   </url>
   <url>
     <loc>https://cozyclay.org/greybox-to-video/</loc>
-    <lastmod>2026-09-14</lastmod>
+    <lastmod>2026-10-21</lastmod>
   </url>
   <url>
     <loc>https://cozyclay.org/previs-software/</loc>
-    <lastmod>2026-09-10</lastmod>
+    <lastmod>2026-10-21</lastmod>
   </url>
   <url>
     <loc>https://cozyclay.org/seedance-camera-control/</loc>
-    <lastmod>2026-09-10</lastmod>
+    <lastmod>2026-10-21</lastmod>
   </url>
   <url>
     <loc>https://cozyclay.org/ai-camera-control/</loc>
@@ -22,6 +22,6 @@
   </url>
   <url>
     <loc>https://cozyclay.org/privacy/</loc>
-    <lastmod>2026-10-01</lastmod>
+    <lastmod>2026-10-22</lastmod>
   </url>
 </urlset>

package/dist/sw.js

@@ -10,7 +10,9 @@ const CACHE_PREFIX = "cozyclay-pwa-";
 // v7: force-refresh the asset cache — v6 clients were holding a stale app shell
 // (the html-flex crash-screen regression) and never re-fetching it.
 // v8: CozyClay 3 drops the shipped walk clip (motion is compiled in the studio).
-const CACHE_NAME = `${CACHE_PREFIX}v8`;
+// v9: start-screen template thumbnails (public/thumbs, tools/render-start-thumbs.mjs).
+// v10: the City Block starter and its thumbnails are removed.
+const CACHE_NAME = `${CACHE_PREFIX}v10`;
 // The installable app is the studio, not the landing page.
 const APP_SHELL = "/app/";
 const CORE_ASSETS = [
@@ -26,6 +28,8 @@ const CORE_ASSETS = [
 	"./fonts/inter-latin.woff2",
 	"./models/x-bot-tpose.fbx",
 	"./models/y-bot-tpose.fbx",
+	"./thumbs/blank-stage-light.webp",
+	"./thumbs/blank-stage-dark.webp",
 ];
 
 async function cacheResponse(cache, request, response) {

package/dist/workflow/index.html

@@ -8,12 +8,13 @@
     <meta name="theme-color" content="#101116" />
     <meta name="description" content="CozyClay visual workflow builder" />
     <title>CozyClay Workflow</title>
-    <script type="module" crossorigin src="/assets/workflow-BSA22Ofr.js"></script>
+    <script type="module" crossorigin src="/assets/workflow-zQM-EKW1.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/rolldown-runtime-hePW80VL.js">
-    <link rel="modulepreload" crossorigin href="/assets/analytics-BibyE5ar.js">
+    <link rel="modulepreload" crossorigin href="/assets/modulepreload-polyfill-P2Xu9kJm.js">
+    <link rel="modulepreload" crossorigin href="/assets/task-board-ErQvfoaz.js">
     <link rel="modulepreload" crossorigin href="/assets/fflate.module-KbGj5-H6.js">
-    <link rel="modulepreload" crossorigin href="/assets/scene-asset-sync-DBYQBR0T.js">
-    <link rel="stylesheet" crossorigin href="/assets/scene-asset-sync-_S8NQl5B.css">
+    <link rel="modulepreload" crossorigin href="/assets/scene-asset-sync-Cgdtr1Yw.js">
+    <link rel="stylesheet" crossorigin href="/assets/scene-asset-sync-CBx7XRti.css">
     <link rel="stylesheet" crossorigin href="/assets/workflow-DRdwoDBT.css">
   </head>
   <body>

package/mcp/mesh-file.mjs

@@ -2,6 +2,7 @@ import { constants as fsConstants } from "node:fs";
 import { open as openFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { basename, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 
 import { ASSET_MAX_SOURCE_BYTES } from "../src/scene-assets.js";
 import { classifyMeshBytes, meshMimeForKind } from "../src/mesh-sniff.js";
@@ -12,7 +13,8 @@ export function normalizeMeshPath(raw, { home = homedir() } = {}) {
 	if (path.startsWith("file:")) {
 		try {
 			const url = new URL(path);
-			if (url.protocol === "file:") path = decodeURIComponent(url.pathname);
+			// On Windows the pathname of file:///D:/x is /D:/x; fileURLToPath drops that leading slash.
+			if (url.protocol === "file:") path = process.platform === "win32" ? fileURLToPath(url) : decodeURIComponent(url.pathname);
 		} catch {
 			path = path.replace(/^file:\/\//, "");
 		}

package/mcp/server.mjs

@@ -175,6 +175,9 @@ if (httpFlag === -1) {
 	setLiveHub(hub);
 	configureLiveHub(hub, liveToken);
 	await server.connect(new StdioServerTransport());
+	// A client ends a stdio session by closing stdin. Exit then, so the exit hooks
+	// remove the endpoint file even where SIGTERM cannot be caught (Windows).
+	process.stdin.once("end", () => process.exit(0));
 } else {
 	// Tools execute in the stdio children, not this HTTP front. Each child tries
 	// to own the one editor port; the winner is live and later sessions see the

package/mcp/tool-handlers.mjs

@@ -1155,10 +1155,10 @@ export const createToolHandlers = ({ projectRootPromise } = {}) => {
 				title: "Sculpt a clay prop from a recipe of soft parts",
 				description:
 					"Unlike place_object, import_mesh and compare_sculpt, sculpt_object builds or changes a clay prop from a recipe of parts you write, typically after reading a reference image. It needs no file and no catalogue entry. " +
-					"recipe = { version: 1, parts: [{ id, shape, size: [x, y, z], position?, rotation?, color?, parent?, mirror?, roundness?, taper?, border? }] }. " +
+					"recipe = { version: 1, parts: [{ id, shape, size: [x, y, z], position?, rotation?, color?, parent?, mirror?, ...shape fields, material?, finish?, detail?, gradient?, op? }] }. " +
 					"Units are metres and degrees. The floor is y = 0, front is +z, and the subject's own left is +x. size is the full extent; position is the part's centre, in its parent part's frame when parent is set. " +
 					"shape: blob (soft superellipsoid: roundness 0 is an ellipsoid, 1 is a rounded box; taper narrows the top when positive and the bottom when negative), box (roundness bevels the edges), " +
-					"cylinder (taper 1 is a cone), torus (size [outer, outer, tube]), frame (a rectangular ring in x/y with a border width, for glasses rims, windows and picture frames). " +
+					"cylinder (taper 1 is a cone), torus (size [outer, outer, tube]), frame (a rectangular ring in x/y with a border width, for glasses rims, windows and picture frames), " + "lathe { profile: [[r 0..1 of half-width, y 0..1 of height], ...] bottom to top, smooth? } for turned objects (pot, vase, bottle, bowl, lampshade, mushroom), " + "tube { path: [[x, y, z] each -0.5..0.5 of size], thickness (m, diameter), taper?, closed? } for ropes, vines, cables, handles, branches and bike frames, " + "extrude { outline: [[x, y] -0.5..0.5 of size], holes?, roundness? } for flat cut shapes pushed through size z (sign, leaf, gable, gear, star), " + "loft { sections: [{ y 0..1, points: [[x, z]...] } or { y, w, d, x?, z?, roundness? }] bottom to top (first y 0, last y 1), smooth? } for cross-sections that change (hull, car body, shoe, loaf; lay it down with rotation [-90,0,0]), " + "convex { points: [[x, y, z]...] or seed + facetCount?, facets? } for rocks, boulders, gems and crystals, " + "scatter { item: blade|tuft|flower|leaf|pebble|twig, count <= 4000, spread: ground|shell, seed? } for thousands of small items as ONE part (grass, flower beds, gravel; shell covers a crown or bush it is parented to; 12000 items per recipe). " + "Any part also takes material clay|wood|straw|stone|brick|concrete|metal|glass|ceramic|plastic|rubber|fabric|paper|foliage (real texture and shine; color tints it; never fake glass with opacity or thatch with stripes) and finish matte|satin|gloss; detail { amount 0..1, scale?, seed? } for a lumpy surface (clouds, bushes, rocks, hay, bread), gradient { color, axis? y|x|z, from?, to? } to blend into a second colour (sky-lit clouds, fruit, sunset walls), " + "and op: subtract|intersect, which makes the part an undrawn cutter of its parent (windows, doors, arches; hollow a lathe with a smaller lathe of the same profile; cut deeper than the wall; mirror cuts both sides). " +
 					"mirror: true adds a copy reflected across x = 0 of the parent frame, with its children; author the subject's left (+x) side once. color is #rrggbb. At most 48 parts after mirrors. " +
 					"To fix a sculpt, pass its id with edits instead of a whole recipe: [{ set: partId, ...fields }, { add: part }, { remove: partId }] (parent: null and mirror: false clear; remove takes the part's children). " +
 					"capture: true also returns the editor's frame (connected editor only), so one call is one round. " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cozyclay",
-  "version": "3.0.3",
+  "version": "3.1.1",
   "description": "Open source previs software in the browser: block a scene, pose characters, author camera moves and cuts, then take the same shots to an AI video model.",
   "scripts": {
     "dev": "node tools/dev-full.mjs --host 127.0.0.1 --port 5180",
@@ -32,7 +32,6 @@
     "test:appearance": "node test/verify-appearance.mjs",
     "test:auto-color": "node test/verify-auto-color.mjs",
     "test:shot-guides": "node test/verify-shot-guides.mjs",
-    "test:burn-in": "node test/verify-burn-in.mjs",
     "test:layout": "node test/verify-layout.mjs",
     "test:timeline-camera": "node test/verify-timeline-camera.mjs",
     "test:timeline-shots": "node test/verify-timeline-shots.mjs",
@@ -57,7 +56,7 @@
     "prepack": "npm run build && node tools/prepare-package.mjs",
     "postpack": "node tools/prepare-package.mjs --clean",
     "prepublishOnly": "npm run build && node tools/prepare-package.mjs --check-key && node tools/prepare-package.mjs && node tools/verify-package-tarball.mjs",
-    "metrics:traffic": "node tools/metrics/archive-traffic.mjs"
+    "metrics:snapshot": "node tools/metrics-snapshot.mjs"
   },
   "license": "AGPL-3.0-or-later",
   "type": "module",
@@ -83,6 +82,8 @@
     "react-icons": "^5.7.0",
     "reactflow": "^11.11.4",
     "three": "^0.185.1",
+    "three-bvh-csg": "^0.0.18",
+    "three-mesh-bvh": "^0.9.16",
     "vite": "^8.2.0"
   },
   "bin": {
@@ -106,6 +107,7 @@
     "mcp/README.md",
     "mcp/LIVE-PROTOCOL.md",
     "README.md",
+    "INSTALL_FOR_AGENTS.md",
     "CHANGELOG.md",
     "LICENSE",
     "LICENSES",