@volter/cyclotron 0.5.192 → 0.5.194

package/dist/volter-shared-three.json

@@ -1,3 +1,3 @@
 {
-  "file": "assets/volter-shared-three-wYzUWvH9.js"
+  "file": "assets/volter-shared-three-Bd-6jvNx.js"
 }

package/dist-node/cli.js

@@ -1236,10 +1236,10 @@ var init_BUNDLE = __esm({
   "../blender-engine/wasm/BUNDLE.json"() {
     BUNDLE_default = {
       blender: "5.2.0 LTS",
-      source: "9fdd05db03bf0e4aa1028607be3e113be7f98d01",
+      source: "434072350c0577eb155068d5a1b62bb45daf19f9",
       upstream: "fbe6228777e7d9afefcd61a413844e790ae75db7",
       sourceRepository: "https://github.com/volter-ai/blender",
-      sourceRecipe: "https://github.com/volter-ai/blender/blob/9fdd05db03bf0e4aa1028607be3e113be7f98d01/build_files/emscripten/RELEASE.md",
+      sourceRecipe: "https://github.com/volter-ai/blender/blob/434072350c0577eb155068d5a1b62bb45daf19f9/build_files/emscripten/RELEASE.md",
       factoryEngine: "BLENDER_EEVEE",
       files: {
         "blender_browser.js": "raw",
@@ -1249,39 +1249,39 @@ var init_BUNDLE = __esm({
       rawFiles: {
         "blender_browser.js": {
           bytes: 408423,
-          sha256: "0c63c29e7d4b1ba1fce4e94057778b0757767b25ea4f6f01d329e99351568f30"
+          sha256: "d818e8d746bc62ebf810206ac564d2dc75dc645b3121f4a3919d13ecef11e419"
         },
         "blender_browser.wasm": {
-          bytes: 86337036,
-          sha256: "9d8cb5bd0dbb34fa7f04858fb6bc831195d0b06e8b82bb26889f3c6d807a9588"
+          bytes: 86344416,
+          sha256: "f5b988d30a9f29708254bc84600f7b88d9c9eb41af904b84c9f398d5c41595e4"
         },
         "blender_browser.data": {
-          bytes: 52698568,
-          sha256: "bf86b5ca29b86a9d7e1185d8b3eba5bd5101eff9eeef47d36884fbe69b9a2cb7"
+          bytes: 52699590,
+          sha256: "89cfee5131d8a7c7361b1f8d249fb08a81b14102963ae161e1146eabab56e558"
         }
       },
       shippedFiles: {
         "blender_browser.js": {
           bytes: 408423,
-          sha256: "0c63c29e7d4b1ba1fce4e94057778b0757767b25ea4f6f01d329e99351568f30"
+          sha256: "d818e8d746bc62ebf810206ac564d2dc75dc645b3121f4a3919d13ecef11e419"
         },
         "blender_browser.wasm.br": {
-          bytes: 18604996,
-          sha256: "782c1f8519851e8b901d5309d239429ecd07c4ed374adaf117214f9ac22f84c9"
+          bytes: 18611942,
+          sha256: "b415a2fce0f2d2f796a2a3362b38420df063866898cc04c61d4604c5caf13e0d"
         },
         "blender_browser.data.br": {
-          bytes: 8056563,
-          sha256: "1d63c1250e2ab9538df36d7d07338396b271577c49227508ae7530f7bde2ee4a"
+          bytes: 8056485,
+          sha256: "899d53d55f730eb12602b23c9f78e034e45e244380719d310ee11098725911d8"
         },
         "DEPENDENCY-LICENSES.txt": {
           bytes: 241352,
           sha256: "4085e9336266cf66f061d4d5c962a5929cc96d5732c746b5c13ea05cd104a75b"
         }
       },
-      note: "Stoneguard c7/c14/c15 engine. Emscripten 6.0.5, Release -O3 objects and -O2 link. Portable native arm64 matrix reciprocal plus fused generic OpenSubdiv stencil and patch accumulation; bodice four-stage comparison 28/28 arrays exact. Full-scene comparison and memory scope recorded in provenance/stoneguard-memory.json. Historical battery absent; no full-battery or hosted acceptance claim.",
+      note: "Stoneguard c7/c14/c15 engine. Emscripten 6.0.5, Release -O3 objects and -O2 link. Portable native arm64 matrix reciprocal plus fused generic OpenSubdiv stencil and patch accumulation; bodice four-stage comparison 28/28 arrays exact. Full-scene comparison and memory scope recorded in provenance/stoneguard-memory.json. Historical battery absent; no full-battery or hosted acceptance claim. Rebuilt from the public instance-source commit with the same Emscripten 6.0.5, Release -O3 objects and -O2 link. All 6287 drawable Lone Monk placements resolve to 26 native source objects and 24 deferred mesh resources. Live raster rendering still differs from native Cycles; no full-scene visual parity claim. Rebuilt from the public evaluated-geometry identity commit with the same Emscripten 6.0.5 Release recipe. Distinct Array/Mirror/deformation outputs no longer borrow another object\u2019s geometry. Native linked-input sharing and every deferred probe vertex are checked independently. Live raster illumination remains unoccluded environment lighting and differs substantially from native Cycles; no visual parity claim.",
       callTrampoline: "CPython 3.13.13 is compiled with PY_CALL_TRAMPOLINE for Blender CPython slot arity casts. This applies to CPython dispatch, not arbitrary indirect calls.",
-      engineIds: "The existing session registers Python render engines under CYCLES, BLENDER_EEVEE and BLENDER_WORKBENCH; the headless build permits built-in IDs to be shadowed.",
-      exportDoor: "The source-owned bpy_web_export.cc exports Principled physical inputs, normal images, eight named UV layers and evaluated corner normals, and takes graph_materials/graph_images/graph_generated (a graph-drawn shader mix reduced to the one Principled BSDF it reaches, graph images at the door revisions with every UDIM tile, orco for deformed meshes whose graph reads Generated coordinates). A frame can defer its changed meshes and pictures (defer) for the caller to pull one at a time (export_mesh, export_image), each call freeing the previous one's columns and a picture it decoded; an undo step keeps the revisions when Blender kept the depsgraph (session_undo); Blender's CPU subdivision descriptor is released once a mesh is read; the memory door reports malloc in-use and free. Datablock revisions are keyed by session_uid. writefile.cc writes one copy of the document per save in the browser build. CPU evaluators adopt stencil tables without cloning; browser subdivision descriptors are released immediately after CPU tessellation/deformation. Native evaluated corner triangles accompany corner normals. Consumed local conversion stencils are released before later UV channels are constructed. Caller-thread file-read, evaluated-object and subdivision checkpoints provide backpressure for resumable startup. Shared geometry revisions advance once per frame. Existing synchronous export remains available.",
+      engineIds: "The session preserves the compiled native CYCLES engine. VOLTER_THREE selects the explicit raster presenter; BLENDER_EEVEE and BLENDER_WORKBENCH remain presentation engines.",
+      exportDoor: "The source-owned bpy_web_export.cc exports Principled physical inputs, normal images, eight named UV layers and evaluated corner normals, and takes graph_materials/graph_images/graph_generated (a graph-drawn shader mix reduced to the one Principled BSDF it reaches, graph images at the door revisions with every UDIM tile, orco for deformed meshes whose graph reads Generated coordinates). A frame can defer its changed meshes and pictures (defer) for the caller to pull one at a time (export_mesh, export_image), each call freeing the previous one's columns and a picture it decoded; an undo step keeps the revisions when Blender kept the depsgraph (session_undo); Blender's CPU subdivision descriptor is released once a mesh is read; the memory door reports malloc in-use and free. Datablock revisions are keyed by session_uid. writefile.cc writes one copy of the document per save in the browser build. CPU evaluators adopt stencil tables without cloning; browser subdivision descriptors are released immediately after CPU tessellation/deformation. Native evaluated corner triangles accompany corner normals. Consumed local conversion stencils are released before later UV channels are constructed. Caller-thread file-read, evaluated-object and subdivision checkpoints provide backpressure for resumable startup. Shared geometry revisions advance once per frame. Existing synchronous export remains available. Optional instance_sources exports stable evaluated collection and particle source meshes, including excluded library meshes and converted curves. Frame-local instance_geometry tokens verify Python placement metadata against the exported geometry and are consumed before presentation. Geometry resource identity preserves implicit input storage only for unmodified geometry and separates evaluated modifier/deformation outputs. Object and mesh resource keys have independent namespaces.",
       preloadedPayload: "releasePreloadedFileData releases the JS preload buffer after session ready. The measured working payload exclusions are retained."
     };
   }
@@ -2383,7 +2383,7 @@ function hasManifest(dir) {
 var package_default = {
   name: "@volter/cyclotron",
   author: "Volter AI, Inc.",
-  version: "0.5.192",
+  version: "0.5.194",
   publishConfig: {
     access: "public"
   },
@@ -2393,6 +2393,7 @@ var package_default = {
   },
   license: "AGPL-3.0-only AND GPL-3.0-or-later AND MIT",
   description: "A free, open-source game editor by VideoGame AI using Blender 5.2 compiled to WebAssembly, Code-OSS, three.js, TypeScript and React.",
+  homepage: "https://cyclotron.videogame.ai",
   keywords: [
     "blender",
     "three.js",
@@ -2437,28 +2438,28 @@ var package_default = {
       upgrade: true,
       workbench: {
         "darwin-arm64": {
-          release: "cyclotron-f16dc165c0df-336473f30026-darwin-arm64",
-          tarballSha256: "e7cbbbcd353057db1a0490888a3b300b3020d97f9fd8b4bb4aa7d6bfe9e36319"
+          release: "cyclotron-f16dc165c0df-a455d637cd33-darwin-arm64",
+          tarballSha256: "2385a7a3f3a50062d8b16ee3c220a668fe478d921f1f7e61944ded424986a98d"
         },
         "linux-x64": {
-          release: "cyclotron-f16dc165c0df-336473f30026-linux-x64",
-          tarballSha256: "54759a22c26ce8f6dfd0a155bbf0ee86013ca2d8b5f3648713d1cc1e313b6afc"
+          release: "cyclotron-f16dc165c0df-a455d637cd33-linux-x64",
+          tarballSha256: "466a23908f1c15e90ae31faef70111b0cfafcf7dd05acc0cd261853fb0aa4d81"
         },
         "win32-x64": {
-          release: "cyclotron-f16dc165c0df-336473f30026-win32-x64",
-          tarballSha256: "28e2995d1a28490be99064cce9898a98e95ff2f053279cf694e9df1f9393fa1a"
+          release: "cyclotron-f16dc165c0df-a455d637cd33-win32-x64",
+          tarballSha256: "65b407facc9c8ba6dd33ec1a2de21f243ab8a01ab4dfdf7de818264dfd7304cc"
         }
       }
     }
   },
   dependencies: {
-    "@volter/editor-core": "0.5.192",
-    "@volter/editor-blender": "0.1.131",
-    "@volter/editor-threejs": "0.5.192",
-    "@volter/blender-engine": "0.1.129",
-    "@volter/editor-project": "0.5.192",
-    "@volter/editor-sdk": "0.5.192",
-    "@volter/editor-live": "0.5.192",
+    "@volter/editor-core": "0.5.194",
+    "@volter/editor-blender": "0.1.133",
+    "@volter/editor-threejs": "0.5.194",
+    "@volter/blender-engine": "0.1.131",
+    "@volter/editor-project": "0.5.194",
+    "@volter/editor-sdk": "0.5.194",
+    "@volter/editor-live": "0.5.194",
     "@modelcontextprotocol/sdk": "1.32.1",
     undici: "7.29.1"
   },
@@ -16941,7 +16942,14 @@ async function chat(args) {
   if (!resource && connection) await editor.command("volter.chat.openSession", `supercode://${connection.id}/conversation`);
   if (action === "stop") {
     await editor.command("workbench.action.chat.cancel");
-    return { stopRequested: true, sessionId: connection?.sessionId };
+    let runtimeStopped = null;
+    if (connection && !draft && (!resource || resource.hostname === connection.id)) {
+      try {
+        runtimeStopped = await editor.command("supercode.frontend.stopTurn", connection.id);
+      } catch {
+      }
+    }
+    return { stopRequested: true, sessionId: connection?.sessionId, runtimeStopped };
   }
   await editor.command("workbench.action.chat.open", { query: prompt, isPartialQuery: false, preserveInput: true });
   return { submissionRequested: true, submissionConfirmed: false };
@@ -17197,14 +17205,16 @@ async function camera(options) {
 
 // node/play.ts
 import { connect as connect4 } from "@volter/editor-live";
-var PLAY_USAGE = "play [state] | play play|stop|pause|resume|restart | play step [count] | play speed <0.25|0.5|1|2|4> | play mode [game|movie] | play autoplay on|off  [--document <id>]";
+var PLAY_USAGE = "play [state] | play play|stop|pause|resume|restart | play step [count] | play speed <0.25|0.5|1|2|4> | play mode [game|movie] | play autoplay on [<behaviour>] [--for <seconds>] | play autoplay off  [--document <id>]";
 var BARE = /* @__PURE__ */ new Set(["state", "play", "stop", "pause", "resume", "restart"]);
-async function play(args, document) {
+async function play(args, document, limit) {
   const [verb = "state", value, ...rest] = args;
   const usage = () => {
     throw new Error(`Usage: cyclotron ${PLAY_USAGE}`);
   };
+  const behavior = verb === "autoplay" && value === "on" ? rest.shift() : void 0;
   if (rest.length > 0) usage();
+  if (limit !== void 0 && !(verb === "autoplay" && value === "on")) throw new Error("--for belongs to `play autoplay on`.");
   let commandArgs;
   if (BARE.has(verb)) {
     if (value !== void 0) usage();
@@ -17215,7 +17225,7 @@ async function play(args, document) {
     commandArgs = { speed: value };
   } else if (verb === "autoplay") {
     if (value !== "on" && value !== "off") usage();
-    commandArgs = { on: value === "on" };
+    commandArgs = { on: value === "on", ...behavior !== void 0 ? { behavior } : {}, ...limit !== void 0 ? { for: limit } : {} };
   } else if (verb === "mode") {
     if (value !== void 0) commandArgs = { mode: value };
   } else usage();
@@ -18001,7 +18011,7 @@ function resolveWorktreeIdentity(projectRoot) {
   };
 }
 
-// ../editor-core/dist/server/chunk-4QZTWRIK.js
+// ../editor-core/dist/server/chunk-KLLXITAZ.js
 import {
   mkdirSync as mkdirSync2,
   readdirSync,
@@ -18038,8 +18048,8 @@ function pidAlive(pid) {
   try {
     process.kill(pid, 0);
     return true;
-  } catch {
-    return false;
+  } catch (error48) {
+    return error48.code === "EPERM";
   }
 }
 function readLiveRegisteredSessions() {
@@ -18113,7 +18123,7 @@ function canonicalizeProjectPath(p) {
   }
 }
 
-// ../editor-core/dist/server/chunk-HRA66UII.js
+// ../editor-core/dist/server/chunk-VPZA3BSM.js
 import { createServer } from "node:net";
 import { execFileSync as execFileSync3 } from "node:child_process";
 async function loopbackPortFree(port) {
@@ -18342,10 +18352,16 @@ function isEsrch(err) {
 }
 function killProcessGroup(pid, signal = "SIGTERM") {
   if (process.platform === "win32") {
-    try {
-      execFileSync3("taskkill", ["/PID", String(pid), "/T", "/F"], { windowsHide: true, stdio: "ignore" });
-      return;
-    } catch {
+    const table = windowsProcessTable();
+    if (table) {
+      const pids = windowsTreeSparingBrowsers(pid, table);
+      try {
+        execFileSync3("taskkill", [...pids.flatMap((each) => ["/PID", String(each)]), "/F"], { windowsHide: true, stdio: "ignore" });
+        return;
+      } catch {
+      }
+    } else {
+      console.warn(`[editor close] could not read the process table; ending ${pid} alone. Its child processes may still be running.`);
     }
     try {
       process.kill(pid, signal);
@@ -18365,6 +18381,48 @@ function killProcessGroup(pid, signal = "SIGTERM") {
     }
   }
 }
+var BROWSER_IMAGES = /* @__PURE__ */ new Set(["chrome.exe", "msedge.exe", "firefox.exe", "brave.exe", "opera.exe", "vivaldi.exe", "chromium.exe", "arc.exe"]);
+function windowsProcessTable() {
+  try {
+    const out = execFileSync3(
+      "powershell.exe",
+      [
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        'Get-CimInstance Win32_Process | Select-Object ProcessId,ParentProcessId,Name,@{n="Created";e={if ($_.CreationDate) { [long]($_.CreationDate.ToFileTimeUtc() / 10000) } else { 0 }}} | ConvertTo-Json -Compress'
+      ],
+      { windowsHide: true, encoding: "utf8", timeout: 15e3, maxBuffer: 32 * 1024 * 1024, stdio: ["ignore", "pipe", "ignore"] }
+    );
+    const parsed = JSON.parse(out);
+    const rows = Array.isArray(parsed) ? parsed : [parsed];
+    return rows.map((row) => ({ pid: Number(row.ProcessId), ppid: Number(row.ParentProcessId), name: String(row.Name ?? "").toLowerCase(), created: Number(row.Created ?? 0) })).filter((row) => Number.isSafeInteger(row.pid) && row.pid > 0);
+  } catch {
+    return void 0;
+  }
+}
+function windowsTreeSparingBrowsers(pid, table) {
+  const byPid = new Map(table.map((row) => [row.pid, row]));
+  const children = /* @__PURE__ */ new Map();
+  for (const row of table) {
+    if (row.ppid === row.pid) continue;
+    const list = children.get(row.ppid);
+    if (list) list.push(row);
+    else children.set(row.ppid, [row]);
+  }
+  const kill = [pid];
+  const seen = /* @__PURE__ */ new Set([pid]);
+  for (let index = 0; index < kill.length; index++) {
+    const parent = byPid.get(kill[index]);
+    for (const child of children.get(kill[index]) ?? []) {
+      if (seen.has(child.pid) || parent && child.created < parent.created) continue;
+      seen.add(child.pid);
+      if (BROWSER_IMAGES.has(child.name)) continue;
+      kill.push(child.pid);
+    }
+  }
+  return kill;
+}
 function processGroupId(pid) {
   if (process.platform === "win32") return void 0;
   try {
@@ -18418,7 +18476,7 @@ async function terminateEditorSession(session, graceMs = 5500) {
   return "forced";
 }
 
-// ../editor-core/dist/server/chunk-M6YPM3JG.js
+// ../editor-core/dist/server/chunk-TAMVJD53.js
 import { spawn as spawn3 } from "node:child_process";
 import { createRequire as createRequire2 } from "node:module";
 import { mkdirSync as mkdirSync22, openSync, closeSync, realpathSync as realpathSync4 } from "node:fs";
@@ -20138,7 +20196,7 @@ function openBrowserUrl(browserUrl, options) {
   }
 }
 
-// ../editor-core/dist/server/chunk-KNSD7V2K.js
+// ../editor-core/dist/server/chunk-E4YE6O7U.js
 import { createHash as createHash4 } from "node:crypto";
 import { mkdirSync as mkdirSync4, readFileSync as readFileSync7, writeFileSync as writeFileSync4, rmSync as rmSync2, existsSync as existsSync9 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
@@ -21035,6 +21093,7 @@ try {
     kind: { type: "string" },
     document: { type: "string" },
     json: { type: "boolean" },
+    for: { type: "string" },
     ...SCREENSHOT_OPTIONS,
     ...CAPTURE_OPTIONS,
     ...CAMERA_OPTIONS
@@ -21049,6 +21108,7 @@ try {
   for (const key of ["since", "kind", "json"])
     if (values[key] !== void 0 && verb !== "play-log") throw new Error(`--${key} belongs to play-log.`);
   if (values.document !== void 0 && verb !== "play-log" && verb !== "play") throw new Error("--document belongs to play-log and play.");
+  if (values.for !== void 0 && verb !== "play") throw new Error("--for belongs to `play autoplay on`.");
   for (const [owner, options] of [["capture", CAPTURE_OPTIONS], ["camera", CAMERA_OPTIONS]])
     for (const key of Object.keys(options))
       if (values[key] !== void 0 && verb !== owner && !(key === "out" && verb === "view")) throw new Error(`--${key} belongs to ${owner}.`);
@@ -21082,7 +21142,7 @@ try {
   cyclotron open <path>
   cyclotron blender-mcp [--existing-session]    # stdio MCP; optionally refuse editor startup`);
   } else if (verb === "play") {
-    console.log(JSON.stringify(await play(positionals.slice(1), values.document), null, 2));
+    console.log(JSON.stringify(await play(positionals.slice(1), values.document, values.for), null, 2));
   } else if (verb === "chat") {
     console.log(JSON.stringify(await chat(positionals.slice(1)), null, 2));
   } else if (verb === "view") {

package/dist-node/create.js

@@ -14024,7 +14024,7 @@ var MANIFEST_FILENAME = "volter.project.json";
 var package_default = {
   name: "@volter/cyclotron",
   author: "Volter AI, Inc.",
-  version: "0.5.192",
+  version: "0.5.194",
   publishConfig: {
     access: "public"
   },
@@ -14034,6 +14034,7 @@ var package_default = {
   },
   license: "AGPL-3.0-only AND GPL-3.0-or-later AND MIT",
   description: "A free, open-source game editor by VideoGame AI using Blender 5.2 compiled to WebAssembly, Code-OSS, three.js, TypeScript and React.",
+  homepage: "https://cyclotron.videogame.ai",
   keywords: [
     "blender",
     "three.js",
@@ -14078,28 +14079,28 @@ var package_default = {
       upgrade: true,
       workbench: {
         "darwin-arm64": {
-          release: "cyclotron-f16dc165c0df-336473f30026-darwin-arm64",
-          tarballSha256: "e7cbbbcd353057db1a0490888a3b300b3020d97f9fd8b4bb4aa7d6bfe9e36319"
+          release: "cyclotron-f16dc165c0df-a455d637cd33-darwin-arm64",
+          tarballSha256: "2385a7a3f3a50062d8b16ee3c220a668fe478d921f1f7e61944ded424986a98d"
         },
         "linux-x64": {
-          release: "cyclotron-f16dc165c0df-336473f30026-linux-x64",
-          tarballSha256: "54759a22c26ce8f6dfd0a155bbf0ee86013ca2d8b5f3648713d1cc1e313b6afc"
+          release: "cyclotron-f16dc165c0df-a455d637cd33-linux-x64",
+          tarballSha256: "466a23908f1c15e90ae31faef70111b0cfafcf7dd05acc0cd261853fb0aa4d81"
         },
         "win32-x64": {
-          release: "cyclotron-f16dc165c0df-336473f30026-win32-x64",
-          tarballSha256: "28e2995d1a28490be99064cce9898a98e95ff2f053279cf694e9df1f9393fa1a"
+          release: "cyclotron-f16dc165c0df-a455d637cd33-win32-x64",
+          tarballSha256: "65b407facc9c8ba6dd33ec1a2de21f243ab8a01ab4dfdf7de818264dfd7304cc"
         }
       }
     }
   },
   dependencies: {
-    "@volter/editor-core": "0.5.192",
-    "@volter/editor-blender": "0.1.131",
-    "@volter/editor-threejs": "0.5.192",
-    "@volter/blender-engine": "0.1.129",
-    "@volter/editor-project": "0.5.192",
-    "@volter/editor-sdk": "0.5.192",
-    "@volter/editor-live": "0.5.192",
+    "@volter/editor-core": "0.5.194",
+    "@volter/editor-blender": "0.1.133",
+    "@volter/editor-threejs": "0.5.194",
+    "@volter/blender-engine": "0.1.131",
+    "@volter/editor-project": "0.5.194",
+    "@volter/editor-sdk": "0.5.194",
+    "@volter/editor-live": "0.5.194",
     "@modelcontextprotocol/sdk": "1.32.1",
     undici: "7.29.1"
   },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/cyclotron",
   "author": "Volter AI, Inc.",
-  "version": "0.5.192",
+  "version": "0.5.194",
   "publishConfig": {
     "access": "public"
   },
@@ -11,6 +11,7 @@
   },
   "license": "AGPL-3.0-only AND GPL-3.0-or-later AND MIT",
   "description": "A free, open-source game editor by VideoGame AI using Blender 5.2 compiled to WebAssembly, Code-OSS, three.js, TypeScript and React.",
+  "homepage": "https://cyclotron.videogame.ai",
   "keywords": [
     "blender",
     "three.js",
@@ -55,28 +56,28 @@
       "upgrade": true,
       "workbench": {
         "darwin-arm64": {
-          "release": "cyclotron-f16dc165c0df-336473f30026-darwin-arm64",
-          "tarballSha256": "e7cbbbcd353057db1a0490888a3b300b3020d97f9fd8b4bb4aa7d6bfe9e36319"
+          "release": "cyclotron-f16dc165c0df-a455d637cd33-darwin-arm64",
+          "tarballSha256": "2385a7a3f3a50062d8b16ee3c220a668fe478d921f1f7e61944ded424986a98d"
         },
         "linux-x64": {
-          "release": "cyclotron-f16dc165c0df-336473f30026-linux-x64",
-          "tarballSha256": "54759a22c26ce8f6dfd0a155bbf0ee86013ca2d8b5f3648713d1cc1e313b6afc"
+          "release": "cyclotron-f16dc165c0df-a455d637cd33-linux-x64",
+          "tarballSha256": "466a23908f1c15e90ae31faef70111b0cfafcf7dd05acc0cd261853fb0aa4d81"
         },
         "win32-x64": {
-          "release": "cyclotron-f16dc165c0df-336473f30026-win32-x64",
-          "tarballSha256": "28e2995d1a28490be99064cce9898a98e95ff2f053279cf694e9df1f9393fa1a"
+          "release": "cyclotron-f16dc165c0df-a455d637cd33-win32-x64",
+          "tarballSha256": "65b407facc9c8ba6dd33ec1a2de21f243ab8a01ab4dfdf7de818264dfd7304cc"
         }
       }
     }
   },
   "dependencies": {
-    "@volter/editor-core": "0.5.192",
-    "@volter/editor-blender": "0.1.131",
-    "@volter/editor-threejs": "0.5.192",
-    "@volter/blender-engine": "0.1.129",
-    "@volter/editor-project": "0.5.192",
-    "@volter/editor-sdk": "0.5.192",
-    "@volter/editor-live": "0.5.192",
+    "@volter/editor-core": "0.5.194",
+    "@volter/editor-blender": "0.1.133",
+    "@volter/editor-threejs": "0.5.194",
+    "@volter/blender-engine": "0.1.131",
+    "@volter/editor-project": "0.5.194",
+    "@volter/editor-sdk": "0.5.194",
+    "@volter/editor-live": "0.5.194",
     "@modelcontextprotocol/sdk": "1.32.1",
     "undici": "7.29.1"
   },

package/starter/AGENTS.md

@@ -196,6 +196,13 @@ are changing, why, and how far along it is.
 - Compare composition, silhouette, proportions, colors and materials after
   meaningful visual changes, then correct visible differences. For UI work,
   also open the reference as an editor image document alongside the UI canvas.
+- For Blender rendering comparisons, `scene.render.engine = 'CYCLES'` and
+  `bpy.ops.render.render(write_still=True)` use native Cycles. Use CPU in the
+  browser build and an appropriate sample count; retain the source's compositor
+  and required passes. `VOLTER_THREE` explicitly requests a raster photograph.
+  A native render is a reference, not evidence that live Play matches it: compare
+  the actual viewport and composed game/UI capture too. Keep gameplay behind
+  that visible comparison gate when a reference match is required.
 - Choose capture scope deliberately. A full editor-page capture shows authoring,
   chat and panels; a game comparison needs the composed 3D scene and React UI
   in `editor.captureEditorChrome({ region: 'play' })` when using Model Play.
@@ -263,15 +270,30 @@ For a behavior-only repair, preserve the established appearance.
   When extending an existing model-based project, declare `@volter/editor-model-play`
   and the React/UI dependencies with compatible project versions, and add the
   UI root as needed. Preserve its models, source and settings.
-- Register your bot with `play.autoplay(controller)`; never bind autoplay to a
-  game key or start it yourself; the person turns it on in the Game panel (or
-  you, with `play autoplay on`). The controller is a plain function called
-  before each `update` while autoplay is on, given `{ dt, simT, tick, keys }`
-  (`keys` are the person's), and returns the `KeyboardEvent.code` keys it holds
-  for that update; they are merged into `keys`, so the bot drives through the
-  same movement, collision and scoring code as manual play. Autoplay is off at
-  every Play and Restart, and any key or click in the game hands control back
-  to the person (`autoplay-off` with `by: 'takeover'` in the play log).
+- Register your bot as named behaviours, one per outcome worth checking:
+  `play.autoplay({ win: …, lose: … })`, at least one that plays to win and one
+  that loses on purpose (walks into enemies, lets the timer run out). Test an
+  ending by running the behaviour that reaches it, never by leaving the game
+  alone. Never bind autoplay to a game key or start it yourself; the person
+  turns it on in the Game panel (or you, with `play autoplay on <behaviour>`).
+  Each controller is a plain function called before each `update` while its
+  behaviour drives, given `{ behavior, dt, simT, tick, keys }` (`keys` are the
+  person's), and returns the `KeyboardEvent.code` keys it holds for that
+  update, or `{ keys, state }` where `state` says in a few words what it is
+  doing and why ("heading to nest 2", "waiting for resupply"). The Game panel
+  shows that state beside the driver and the play log records each change
+  (`bot-state`), so return it whenever the bot's intention changes. The keys
+  are merged into `keys`, so the bot drives through the same movement,
+  collision and scoring code as manual play. Autoplay is off at every Play and
+  Restart, and any key or click in the game hands control back to the person
+  (`autoplay-off` with `by: 'takeover'` in the play log).
+- Every autoplay run is limited to simulation seconds, 300 unless you pass
+  `--for <seconds>`; at the limit autoplay turns off, the game pauses and the
+  log says `autoplay-limit` with the bot's last state. A run that reaches its
+  limit is a finding: the game has no reachable ending for that behaviour, or
+  the bot is stuck. Give every game a terminal state reachable in bounded
+  time (a mission timer that fails the mission, for example), and wait on a
+  run by reading `play-log` until a deadline, never open-ended.
 - Keep a gameplay log while the game runs; without it, autoplay is a black box
   and a final position or screenshot cannot tell you what went wrong. Use the
   play script's built-in log, `play.log(kind, facts)`: it stamps each entry
@@ -291,7 +313,7 @@ For a behavior-only repair, preserve the established appearance.
   session's console feed (only warnings and errors do), so the play log is
   what you can read back. Keep logging read-only: it must not change
   timing, inputs or game state.
-- Run autoplay in Play (`play autoplay on`) and observe representative actions, objectives,
+- Run each behaviour in Play (`play autoplay on <behaviour>`) and observe representative actions, objectives,
   progression and any relevant failure/restart behavior. Exercise manual
   controls too. Inspect runtime errors and game state alongside screenshots;
   a still image alone does not verify gameplay.
@@ -382,7 +404,7 @@ view in Blender metres, Z up. In eval, `editor.present({ version: 1, viewport:
 `capture --region document|play [--out file.png [--force]]` saves what the person sees (default under
 `.volter/captures/`); `add-play` makes a models project playable; `play-log`
 reads the running game's log. The Game panel's controls, each printing its state:
-`play autoplay on|off` switches the game's bot (the Game panel's Autoplay toggle);
+`play autoplay on <behaviour> [--for <seconds>]` runs one of the game's bot behaviours for at most that many simulation seconds (300 by default), and `play autoplay off` stops it (the Game panel's Autoplay toggle);
 `play pause` holds the game (no `update` calls; its clock stops);
 `play resume` lets it run again;
 `play step [count]` runs one 1/60 s update of a paused game per count;

package/dist/assets/BVHLoader-Dxn1IBPh.js

@@ -1 +0,0 @@
-import{b5 as B,b6 as I,aM as R,V as u,ab as N,aK as x,aO as L,aN as g,aQ as k}from"./three.module-dk_BdrjN.js";class A extends B{constructor(c){super(c),this.animateBonePositions=!0,this.animateBoneRotations=!0}load(c,H,d,f){const l=this,h=new I(l.manager);h.setPath(l.path),h.setRequestHeader(l.requestHeader),h.setWithCredentials(l.withCredentials),h.load(c,function(p){try{H(l.parse(p))}catch(m){f?f(m):console.error(m),l.manager.itemError(c)}},d,f)}parse(c){function H(t){p(t)!=="HIERARCHY"&&console.error("THREE.BVHLoader: HIERARCHY expected.");const s=[],n=f(t,p(t),s);p(t)!=="MOTION"&&console.error("THREE.BVHLoader: MOTION expected.");let e=p(t).split(/[\s]+/);const o=parseInt(e[1]);isNaN(o)&&console.error("THREE.BVHLoader: Failed to read number of frames."),e=p(t).split(/[\s]+/);const i=parseFloat(e[2]);isNaN(i)&&console.error("THREE.BVHLoader: Failed to read frame time.");for(let r=0;r<o;r++)e=p(t).split(/[\s]+/),d(e,r*i,n);return s}function d(t,s,n){if(n.type==="ENDSITE")return;const e={time:s,position:new u,rotation:new N};n.frames.push(e);const o=new N,i=new u(1,0,0),r=new u(0,1,0),E=new u(0,0,1);for(let a=0;a<n.channels.length;a++)switch(n.channels[a]){case"Xposition":e.position.x=parseFloat(t.shift().trim());break;case"Yposition":e.position.y=parseFloat(t.shift().trim());break;case"Zposition":e.position.z=parseFloat(t.shift().trim());break;case"Xrotation":o.setFromAxisAngle(i,parseFloat(t.shift().trim())*Math.PI/180),e.rotation.multiply(o);break;case"Yrotation":o.setFromAxisAngle(r,parseFloat(t.shift().trim())*Math.PI/180),e.rotation.multiply(o);break;case"Zrotation":o.setFromAxisAngle(E,parseFloat(t.shift().trim())*Math.PI/180),e.rotation.multiply(o);break;default:console.warn("THREE.BVHLoader: Invalid channel type.")}for(let a=0;a<n.children.length;a++)d(t,s,n.children[a])}function f(t,s,n){const e={name:"",type:"",frames:[]};n.push(e);let o=s.split(/[\s]+/);o[0].toUpperCase()==="END"&&o[1].toUpperCase()==="SITE"?(e.type="ENDSITE",e.name="ENDSITE"):(e.name=o[1],e.type=o[0].toUpperCase()),p(t)!=="{"&&console.error("THREE.BVHLoader: Expected opening { after type & name"),o=p(t).split(/[\s]+/),o[0]!=="OFFSET"&&console.error("THREE.BVHLoader: Expected OFFSET but got: "+o[0]),o.length!==4&&console.error("THREE.BVHLoader: Invalid number of values for OFFSET.");const i=new u(parseFloat(o[1]),parseFloat(o[2]),parseFloat(o[3]));if((isNaN(i.x)||isNaN(i.y)||isNaN(i.z))&&console.error("THREE.BVHLoader: Invalid values of OFFSET."),e.offset=i,e.type!=="ENDSITE"){o=p(t).split(/[\s]+/),o[0]!=="CHANNELS"&&console.error("THREE.BVHLoader: Expected CHANNELS definition.");const r=parseInt(o[1]);e.channels=o.splice(2,r),e.children=[]}for(;;){const r=p(t);if(r==="}")return e;e.children.push(f(t,r,n))}}function l(t,s){const n=new x;if(s.push(n),n.position.add(t.offset),n.name=t.name,t.type!=="ENDSITE")for(let e=0;e<t.children.length;e++)n.add(l(t.children[e],s));return n}function h(t){const s=[];for(let n=0;n<t.length;n++){const e=t[n];if(e.type==="ENDSITE")continue;const o=[],i=[],r=[];for(let E=0;E<e.frames.length;E++){const a=e.frames[E];o.push(a.time),i.push(a.position.x+e.offset.x),i.push(a.position.y+e.offset.y),i.push(a.position.z+e.offset.z),r.push(a.rotation.x),r.push(a.rotation.y),r.push(a.rotation.z),r.push(a.rotation.w)}m.animateBonePositions&&s.push(new L(e.name+".position",o,i)),m.animateBoneRotations&&s.push(new g(e.name+".quaternion",o,r))}return new k("animation",-1,s)}function p(t){let s;for(;(s=t.shift().trim()).length===0;);return s}const m=this,y=c.split(/[\r\n]+/g),T=H(y),F=[];l(T[0],F);const w=h(T);return{skeleton:new R(F),clip:w}}}export{A as BVHLoader};