@volter/cyclotron 0.5.209 → 0.5.211

package/dist-node/cli.js

@@ -2384,7 +2384,7 @@ function hasManifest(dir) {
 var package_default = {
   name: "@volter/cyclotron",
   author: "Volter AI, Inc.",
-  version: "0.5.209",
+  version: "0.5.211",
   publishConfig: {
     access: "public"
   },
@@ -2455,13 +2455,13 @@ var package_default = {
     }
   },
   dependencies: {
-    "@volter/editor-core": "0.5.209",
-    "@volter/editor-blender": "0.1.148",
-    "@volter/editor-threejs": "0.5.209",
-    "@volter/blender-engine": "0.1.146",
-    "@volter/project": "0.5.209",
-    "@volter/sdk": "0.5.209",
-    "@volter/live": "0.5.209",
+    "@volter/editor-core": "0.5.211",
+    "@volter/editor-blender": "0.1.150",
+    "@volter/editor-threejs": "0.5.211",
+    "@volter/blender-engine": "0.1.148",
+    "@volter/project": "0.5.211",
+    "@volter/sdk": "0.5.211",
+    "@volter/live": "0.5.211",
     "@modelcontextprotocol/sdk": "1.32.1",
     typescript: "5.9.3",
     undici: "7.29.1"
@@ -16666,14 +16666,116 @@ async function refreshStarterGuidance(projectDir, log = console.log) {
 // node/startup.ts
 import { existsSync as existsSync4 } from "node:fs";
 import { readFile as readFile3 } from "node:fs/promises";
-import { homedir } from "node:os";
-import { dirname as dirname3, join as join4, resolve as resolve3 } from "node:path";
+import { homedir as homedir2 } from "node:os";
+import { dirname as dirname3, join as join5, resolve as resolve4 } from "node:path";
 
 // ../sdk/src/session/project-upgrade.ts
 import { spawn as spawn2 } from "node:child_process";
-import { existsSync as existsSync3, lstatSync, readFileSync } from "node:fs";
+import { existsSync as existsSync3, lstatSync, readFileSync as readFileSync2, statSync } from "node:fs";
 import { mkdir as mkdir2, readdir as readdir2, readFile as readFile2, rename, rm, rmdir, writeFile as writeFile2 } from "node:fs/promises";
-import { dirname as dirname2, join as join3, relative as relative2, resolve as resolve2, sep } from "node:path";
+import { dirname as dirname2, join as join4, relative as relative2, resolve as resolve3, sep } from "node:path";
+
+// ../sdk/src/session/registry-format.ts
+import {
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  realpathSync,
+  unlinkSync,
+  writeFileSync
+} from "node:fs";
+import { homedir } from "node:os";
+import { join as join3, resolve as resolve2 } from "node:path";
+var EDITOR_SESSIONS_REGISTRY_FILE = join3(homedir(), ".volter", "editor-sessions.json");
+function isEditorSessionEntry(v) {
+  if (typeof v !== "object" || v === null) return false;
+  const s = v;
+  const optionalIdentity = (value) => value === void 0 || value === null || typeof value === "string";
+  return (typeof s["project"] === "string" || s["project"] === null) && typeof s["port"] === "number" && typeof s["pid"] === "number" && typeof s["startedAt"] === "string" && optionalIdentity(s["sessionId"]) && optionalIdentity(s["controlSecret"]) && optionalIdentity(s["repositoryId"]) && optionalIdentity(s["worktreeId"]) && optionalIdentity(s["worktreeRoot"]) && optionalIdentity(s["projectRelativePath"]) && optionalIdentity(s["branch"]) && optionalIdentity(s["headCommit"]) && optionalIdentity(s["baseCommit"]);
+}
+function normalizeEditorSessionEntry(session) {
+  return {
+    ...session,
+    sessionId: session.sessionId ?? null,
+    controlSecret: session.controlSecret ?? null,
+    repositoryId: session.repositoryId ?? null,
+    worktreeId: session.worktreeId ?? null,
+    worktreeRoot: session.worktreeRoot ?? null,
+    projectRelativePath: session.projectRelativePath ?? null,
+    branch: session.branch ?? null,
+    headCommit: session.headCommit ?? null,
+    baseCommit: session.baseCommit ?? null
+  };
+}
+function pidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error50) {
+    return error50.code === "EPERM";
+  }
+}
+function readLiveRegisteredSessions() {
+  try {
+    const raw = JSON.parse(readFileSync(EDITOR_SESSIONS_REGISTRY_FILE, "utf8"));
+    return Array.isArray(raw) ? raw.filter(isEditorSessionEntry).map(normalizeEditorSessionEntry).filter((s) => pidAlive(s.pid)) : [];
+  } catch {
+    return [];
+  }
+}
+function servedProjectAnswer(body) {
+  const b = body;
+  return {
+    path: b.project?.path ?? b.serving?.path ?? null,
+    manifestError: b.project ? null : b.serving?.error ?? null
+  };
+}
+
+// ../sdk/src/session/discovery.ts
+var EDITOR_SESSION_DISCOVERY_TIMEOUT_MS = 2e3;
+var EDITOR_PROBE_TIMEOUT_MS = 1500;
+async function fetchJson(url3, timeoutMs) {
+  const res = await fetch(url3, { signal: AbortSignal.timeout(timeoutMs) });
+  if (!res.ok) throw new Error(`GET /__editor/project returned HTTP ${res.status}`);
+  return await res.json();
+}
+function baseUrl(session) {
+  return session.url ?? `http://127.0.0.1:${session.port}`;
+}
+var HttpSessionDiscovery = class {
+  async listSessions(timeoutMs) {
+    const registered = readLiveRegisteredSessions();
+    const perProbeTimeout = Math.min(EDITOR_PROBE_TIMEOUT_MS, Math.max(200, timeoutMs));
+    const failures = [];
+    const probes = await Promise.all(
+      registered.map(async (s) => {
+        try {
+          const body = await fetchJson(
+            `${baseUrl({ port: s.port, project: null, pid: s.pid })}/__editor/project`,
+            perProbeTimeout
+          );
+          const served = servedProjectAnswer(body);
+          const info = {
+            port: s.port,
+            project: served.path,
+            pid: s.pid,
+            manifestError: served.manifestError
+          };
+          return info;
+        } catch (error50) {
+          const detail = error50 instanceof Error ? `${error50.name}: ${error50.message}` : String(error50);
+          failures.push(`port ${s.port}: ${detail}`);
+          return void 0;
+        }
+      })
+    );
+    const sessions = probes.filter((p) => p !== void 0);
+    if (registered.length > 0 && sessions.length === 0) {
+      throw new Error(`Registered editor sessions could not be inspected: ${failures.join("; ")}`);
+    }
+    return sessions;
+  }
+};
 
 // ../sdk/src/session/editor-compatibility.ts
 var EXACT_SEMVER = /^(\d+)\.(\d+)\.(\d+)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
@@ -16698,7 +16800,7 @@ function upgradeLine(product) {
 function declaredRetiredProduct(product, project) {
   let pkg;
   try {
-    pkg = JSON.parse(readFileSync(join3(project, "package.json"), "utf8"));
+    pkg = JSON.parse(readFileSync2(join4(project, "package.json"), "utf8"));
   } catch {
     return null;
   }
@@ -16731,7 +16833,7 @@ async function allFiles(path) {
   }
   const files = [];
   for (const entry of entries) {
-    const child = join3(path, entry.name);
+    const child = join4(path, entry.name);
     if (entry.isDirectory()) files.push(...await allFiles(child));
     else files.push(child);
   }
@@ -16747,7 +16849,7 @@ async function scriptFiles(dir) {
   }
   for (const entry of entries) {
     if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
-    const path = join3(dir, entry.name);
+    const path = join4(dir, entry.name);
     if (entry.isDirectory()) files.push(...await scriptFiles(path));
     else if (/\.(?:[cm]?[jt]sx?)$/.test(entry.name)) files.push(path);
   }
@@ -16757,11 +16859,11 @@ async function projectSourceFiles(project) {
   const files = [];
   try {
     for (const entry of await readdir2(project, { withFileTypes: true })) {
-      if (entry.isFile() && /\.(?:[cm]?[jt]sx?)$/.test(entry.name)) files.push(join3(project, entry.name));
+      if (entry.isFile() && /\.(?:[cm]?[jt]sx?)$/.test(entry.name)) files.push(join4(project, entry.name));
     }
   } catch {
   }
-  for (const folder of ["editor", "src", "scripts"]) files.push(...await scriptFiles(join3(project, folder)));
+  for (const folder of ["editor", "src", "scripts"]) files.push(...await scriptFiles(join4(project, folder)));
   return files;
 }
 function rewriteMovedPaths(text2) {
@@ -16771,16 +16873,16 @@ async function projectTextFiles(project) {
   const files = [];
   try {
     for (const entry of await readdir2(project, { withFileTypes: true })) {
-      if (entry.isFile() && /(?:\.md|^tsconfig(?:\.[\w-]+)?\.json)$/i.test(entry.name)) files.push(join3(project, entry.name));
+      if (entry.isFile() && /(?:\.md|^tsconfig(?:\.[\w-]+)?\.json)$/i.test(entry.name)) files.push(join4(project, entry.name));
     }
   } catch {
   }
   const under = async (dir, pattern) => {
     for (const path of await allFiles(dir)) if (!path.includes(`${sep}node_modules${sep}`) && pattern.test(path)) files.push(path);
   };
-  for (const folder of [".claude", ".agents", ".github"]) await under(join3(project, folder), /\.md$/i);
-  await under(join3(project, ".volter", "catalog"), /\.json$/i);
-  if (existsSync3(join3(project, ".volter", "scaffold-baseline.json"))) files.push(join3(project, ".volter", "scaffold-baseline.json"));
+  for (const folder of [".claude", ".agents", ".github"]) await under(join4(project, folder), /\.md$/i);
+  await under(join4(project, ".volter", "catalog"), /\.json$/i);
+  if (existsSync3(join4(project, ".volter", "scaffold-baseline.json"))) files.push(join4(project, ".volter", "scaffold-baseline.json"));
   return files;
 }
 function renameKitSpecifiers(text2) {
@@ -16794,7 +16896,7 @@ function rebaseRelativeSpecifiers(text2, fromDir, toDir, moved) {
   return text2.replace(
     /(\bfrom\s*|\bimport\s*\(\s*|\bimport\s+|\brequire\s*\(\s*|\bnew\s+URL\s*\(\s*|\bimport\.meta\.glob\s*\(\s*)(['"`])(\.{1,2}(?:\/[^'"`]*)?)\2/g,
     (whole, lead, quote, spec) => {
-      const target = resolve2(fromDir, spec);
+      const target = resolve3(fromDir, spec);
       if (fromDir === toDir && moved(target) === target) return whole;
       let next = relative2(toDir, moved(target)).split("\\").join("/");
       if (next === "") next = ".";
@@ -16898,7 +17000,7 @@ function npmView(spec) {
   });
 }
 async function readRelease(product, requested) {
-  const running = JSON.parse(await readFile2(join3(product.dir, "package.json"), "utf8"));
+  const running = JSON.parse(await readFile2(join4(product.dir, "package.json"), "utf8"));
   if (requested === running.version) return { version: running.version, dependencies: running.dependencies ?? {} };
   const spec = `${product.packageName}@${requested ?? "latest"}`;
   try {
@@ -16908,19 +17010,40 @@ async function readRelease(product, requested) {
     throw new Error(`Could not read ${spec} from the registry (${reason}). Name a published version: ${projectLine(product.command, "upgrade <version>")}.`);
   }
 }
+async function editorOpenOn(project) {
+  try {
+    const here = statSync(project, { bigint: true });
+    const isHere = (path) => {
+      if (path === null) return false;
+      try {
+        const there = statSync(path, { bigint: true });
+        return there.dev === here.dev && there.ino === here.ino;
+      } catch {
+        return false;
+      }
+    };
+    const registered = readLiveRegisteredSessions();
+    if (registered.length === 0) return false;
+    if (registered.some((session) => isHere(session.project))) return true;
+    const answered = await new HttpSessionDiscovery().listSessions(EDITOR_SESSION_DISCOVERY_TIMEOUT_MS);
+    return answered.length < registered.length || answered.some((session) => isHere(session.project));
+  } catch {
+    return true;
+  }
+}
 function projectLine(command, verb) {
   return `${process.platform === "win32" ? "npx.cmd" : "npx"} --no-install ${command} ${verb}`;
 }
 async function upgradeProject(product, requested, cwd = process.cwd()) {
   if (requested !== void 0 && !EXACT_VERSION.test(requested))
     throw new Error(`${product.command} upgrade takes an exact version (e.g. 0.5.189), not "${requested}".`);
-  let project = resolve2(cwd);
+  let project = resolve3(cwd);
   while (!hasManifest(project)) {
     const parent = dirname2(project);
     if (parent === project) throw new Error(`Run ${product.command} upgrade inside a project: there is no ${MANIFEST_FILENAME} here or above.`);
     project = parent;
   }
-  const packagePath = join3(project, "package.json");
+  const packagePath = join4(project, "package.json");
   if (!existsSync3(packagePath)) throw new Error(`${project} has no package.json to upgrade.`);
   const release = await readRelease(product, requested);
   const engine = release.dependencies["@volter/editor-core"];
@@ -16974,7 +17097,7 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
       pkg["scripts"] = rewritten;
     }
     for (const file3 of RENAMED_PRODUCT_FILES) {
-      const path = join3(project, file3);
+      const path = join4(project, file3);
       if (!existsSync3(path)) continue;
       const original = await readFile2(path, "utf8");
       let content = original.replace(wholeWord(retired.packageName), product.packageName).replace(wholeWord(retired.command), product.command);
@@ -17003,8 +17126,8 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
   const projectPath = (path) => relative2(project, path).split("\\").join("/");
   const moves = [];
   for (const [from, to] of MOVED_TO_EDITOR) {
-    const source = join3(project, from);
-    if (existsSync3(source)) moves.push({ from: source, to: join3(project, to) });
+    const source = join4(project, from);
+    if (existsSync3(source)) moves.push({ from: source, to: join4(project, to) });
   }
   const movedPath = (path) => {
     for (const move of moves) {
@@ -17034,7 +17157,7 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
     } else if (content !== original) {
       textFiles.push({ path, content, original });
       changed.push(`${projectPath(path)}: names the kit's current packages and the moved files where they now are`);
-      if (path.startsWith(join3(project, "src") + sep) && !stranded.includes(path) && /(['"`])(?:\.{1,2}\/)+[^'"`]*\beditor\//.test(content) && !/(['"`])(?:\.{1,2}\/)+[^'"`]*\beditor\//.test(original))
+      if (path.startsWith(join4(project, "src") + sep) && !stranded.includes(path) && /(['"`])(?:\.{1,2}\/)+[^'"`]*\beditor\//.test(content) && !/(['"`])(?:\.{1,2}\/)+[^'"`]*\beditor\//.test(original))
         kept.push(`${projectPath(path)} now imports from editor/, which a game build refuses from 0.5.203: move what it uses out of editor/ (src/ is the game)`);
     }
   }
@@ -17055,7 +17178,7 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
     const rewritten = tools.map((registration) => {
       const entry = typeof registration === "string" ? registration : registration?.entry;
       if (typeof entry !== "string" || !entry.startsWith("./")) return registration;
-      const next = `./${projectPath(movedPath(join3(project, entry.slice(2))))}`;
+      const next = `./${projectPath(movedPath(join4(project, entry.slice(2))))}`;
       if (next === entry) return registration;
       changed.push(`package.json volter.tools: ${entry} -> ${next}`);
       packagesChanged = true;
@@ -17079,7 +17202,7 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
       changed.push(current.startsWith("file:") ? `package.json ${section}: ${name} was the local tarball ${current}; it is now ${target} from the registry` : `package.json ${section}: ${name} ${current} -> ${target}`);
     }
   }
-  const manifestPath = join3(project, MANIFEST_FILENAME);
+  const manifestPath = join4(project, MANIFEST_FILENAME);
   const manifestRaw = await readFile2(manifestPath, "utf8");
   const manifest = JSON.parse(manifestRaw);
   const pinned = manifest.engine?.["version"];
@@ -17098,12 +17221,12 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
   }
   const linked = product.linksNodeModules === true || (() => {
     try {
-      return lstatSync(join3(project, "node_modules")).isSymbolicLink();
+      return lstatSync(join4(project, "node_modules")).isSymbolicLink();
     } catch {
       return false;
     }
   })();
-  const locks = packagesChanged && !linked ? (await Promise.all([join3(project, "package-lock.json"), join3(project, "node_modules", ".package-lock.json")].map(lockWithoutVolter))).filter((lock) => lock !== null) : [];
+  const locks = packagesChanged && !linked ? (await Promise.all([join4(project, "package-lock.json"), join4(project, "node_modules", ".package-lock.json")].map(lockWithoutVolter))).filter((lock) => lock !== null) : [];
   if (locks.length > 0) changed.push("package-lock.json: the old @volter rows dropped, so npm install resolves the new ones");
   const madeDirs = [];
   for (const file3 of textFiles) {
@@ -17145,14 +17268,15 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
   for (const line of kept) console.log(`  = ${line}`);
   const [npm, npx] = process.platform === "win32" ? ["npm.cmd", "npx.cmd"] : ["npm", "npx"];
   if (changed.length === 0) {
-    console.log(`If an editor still refuses this project, it is running from another installation: open it with this project's own, \`${npx} --no-install ${product.command} edit .\` in ${project}.`);
+    console.log(`If you ran this because an editor refused the project, that editor is another installation: open the project with its own, \`${npx} --no-install ${product.command} edit .\` in ${project}.`);
     return;
   }
   if (retired !== null)
     console.log(`This project now opens in ${product.packageName}. Its command is ${product.command}: from the project folder, \`${npx} --no-install ${product.command} <command>\`.`);
   console.log(`Next, in ${project}, one line at a time:`);
   if (packagesChanged) {
-    console.log(`  ${npx} --no-install ${linked ? product.command : retired?.command ?? product.command} close`);
+    if (await editorOpenOn(project))
+      console.log(`  ${npx} --no-install ${linked ? product.command : retired?.command ?? product.command} close`);
     if (!linked) console.log(`  ${npm} install`);
     console.log(`  ${npx} --no-install ${product.command} edit .`);
   } else {
@@ -17161,15 +17285,15 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
 }
 
 // node/startup.ts
-async function startupProject(create, { cwd = process.cwd(), home = homedir() } = {}) {
-  for (let folder = resolve3(cwd); ; folder = dirname3(folder)) {
+async function startupProject(create, { cwd = process.cwd(), home = homedir2() } = {}) {
+  for (let folder = resolve4(cwd); ; folder = dirname3(folder)) {
     if (hasManifest(folder)) return folder;
     if (dirname3(folder) === folder) break;
   }
-  const parent = join4(home, "Documents", "Volter Models");
+  const parent = join5(home, "Documents", "Volter Models");
   for (let number5 = 1; ; number5++) {
     const name = `Untitled Model${number5 === 1 ? "" : ` ${number5}`}`;
-    const targetDir = join4(parent, name);
+    const targetDir = join5(parent, name);
     if (!existsSync4(targetDir)) {
       console.log(`Creating your starter model at ${targetDir}\u2026`);
       await create({ name, targetDir, template: "models" });
@@ -17178,64 +17302,13 @@ async function startupProject(create, { cwd = process.cwd(), home = homedir() }
     if (!hasManifest(targetDir)) continue;
     const retired = declaredRetiredProduct(UPGRADING, targetDir);
     if (retired !== null) throw retiredProjectError(UPGRADING, retired, targetDir);
-    const pkg = JSON.parse(await readFile3(join4(targetDir, "package.json"), "utf8"));
+    const pkg = JSON.parse(await readFile3(join5(targetDir, "package.json"), "utf8"));
     if (pkg.dependencies?.["@volter/cyclotron"] || pkg.devDependencies?.["@volter/cyclotron"]) return targetDir;
   }
 }
 
 // node/chat.ts
 import { connect } from "@volter/live";
-
-// ../sdk/src/session/registry-format.ts
-import {
-  mkdirSync,
-  readdirSync,
-  readFileSync as readFileSync2,
-  realpathSync,
-  unlinkSync,
-  writeFileSync
-} from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { join as join5, resolve as resolve4 } from "node:path";
-var EDITOR_SESSIONS_REGISTRY_FILE = join5(homedir2(), ".volter", "editor-sessions.json");
-function isEditorSessionEntry(v) {
-  if (typeof v !== "object" || v === null) return false;
-  const s = v;
-  const optionalIdentity = (value) => value === void 0 || value === null || typeof value === "string";
-  return (typeof s["project"] === "string" || s["project"] === null) && typeof s["port"] === "number" && typeof s["pid"] === "number" && typeof s["startedAt"] === "string" && optionalIdentity(s["sessionId"]) && optionalIdentity(s["controlSecret"]) && optionalIdentity(s["repositoryId"]) && optionalIdentity(s["worktreeId"]) && optionalIdentity(s["worktreeRoot"]) && optionalIdentity(s["projectRelativePath"]) && optionalIdentity(s["branch"]) && optionalIdentity(s["headCommit"]) && optionalIdentity(s["baseCommit"]);
-}
-function normalizeEditorSessionEntry(session) {
-  return {
-    ...session,
-    sessionId: session.sessionId ?? null,
-    controlSecret: session.controlSecret ?? null,
-    repositoryId: session.repositoryId ?? null,
-    worktreeId: session.worktreeId ?? null,
-    worktreeRoot: session.worktreeRoot ?? null,
-    projectRelativePath: session.projectRelativePath ?? null,
-    branch: session.branch ?? null,
-    headCommit: session.headCommit ?? null,
-    baseCommit: session.baseCommit ?? null
-  };
-}
-function pidAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (error50) {
-    return error50.code === "EPERM";
-  }
-}
-function readLiveRegisteredSessions() {
-  try {
-    const raw = JSON.parse(readFileSync2(EDITOR_SESSIONS_REGISTRY_FILE, "utf8"));
-    return Array.isArray(raw) ? raw.filter(isEditorSessionEntry).map(normalizeEditorSessionEntry).filter((s) => pidAlive(s.pid)) : [];
-  } catch {
-    return [];
-  }
-}
-
-// node/chat.ts
 var CHAT_USAGE = "chat status | chat send <prompt> | chat stop";
 async function chat(args) {
   const [action, prompt] = args;
@@ -17329,7 +17402,7 @@ async function playLog(options) {
 }
 
 // node/add-play.ts
-import { existsSync as existsSync5, lstatSync as lstatSync2, realpathSync as realpathSync2, statSync } from "node:fs";
+import { existsSync as existsSync5, lstatSync as lstatSync2, realpathSync as realpathSync2, statSync as statSync2 } from "node:fs";
 import { mkdir as mkdir3, readFile as readFile4, readdir as readdir3, rm as rm2, rmdir as rmdir2, writeFile as writeFile3 } from "node:fs/promises";
 import { dirname as dirname4, isAbsolute, join as join6, posix, relative as relative3, resolve as resolve5 } from "node:path";
 var ADD_PLAY_USAGE = "add-play [folder]    # make a models project playable: Play deps, UI root, a first Play script for its model";
@@ -17358,7 +17431,7 @@ function blocked(project, realProject, path) {
     if (!occupied(dir)) continue;
     if (deepest === project) deepest = dir;
     try {
-      if (!statSync(dir).isDirectory()) return `${relative3(project, dir)} is not a folder`;
+      if (!statSync2(dir).isDirectory()) return `${relative3(project, dir)} is not a folder`;
     } catch {
       return `${relative3(project, dir)} is a dangling link`;
     }
@@ -32383,7 +32456,7 @@ async function waitForPendingEditorLaunch(project) {
     await delay(100);
   }
 }
-function servedProjectAnswer(body) {
+function servedProjectAnswer2(body) {
   const b = body;
   return {
     path: b.project?.path ?? b.serving?.path ?? null,
@@ -32425,8 +32498,8 @@ async function fetchEditorSession(port, timeoutMs = 5e3) {
       port,
       // The serving-vs-project distinction is the shared parser's whole job —
       // see `servedProjectAnswer`'s doc in session-registry-format.
-      project: servedProjectAnswer(body).path,
-      manifestError: servedProjectAnswer(body).manifestError,
+      project: servedProjectAnswer2(body).path,
+      manifestError: servedProjectAnswer2(body).manifestError,
       pid: typeof session?.["pid"] === "number" ? session["pid"] : null,
       sessionId: typeof session?.["sessionId"] === "string" ? session["sessionId"] : null,
       repositoryId: typeof session?.["repositoryId"] === "string" ? session["repositoryId"] : null,
@@ -32769,7 +32842,7 @@ import { createRequire as createRequire2 } from "node:module";
 import { mkdirSync as mkdirSync22, openSync, closeSync, realpathSync as realpathSync5 } from "node:fs";
 import { join as join22, resolve as resolve9 } from "node:path";
 import { createHash as createHash3 } from "node:crypto";
-import { mkdirSync as mkdirSync4, readFileSync as readFileSync6, renameSync as renameSync2, rmdirSync, statSync as statSync2, writeFileSync as writeFileSync4 } from "node:fs";
+import { mkdirSync as mkdirSync4, readFileSync as readFileSync6, renameSync as renameSync2, rmdirSync, statSync as statSync3, writeFileSync as writeFileSync4 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
 import { dirname as dirname6, join as join11 } from "node:path";
 var MIN_PORT = 1024;
@@ -32839,7 +32912,7 @@ function withRegistryLock(registryFile, action) {
     } catch (error50) {
       if (error50.code !== "EEXIST") throw error50;
       try {
-        if (Date.now() - statSync2(lock).mtimeMs > LOCK_STALE_MS) {
+        if (Date.now() - statSync3(lock).mtimeMs > LOCK_STALE_MS) {
           rmdirSync(lock);
           continue;
         }
@@ -34535,13 +34608,13 @@ function openBrowserUrl(browserUrl, options) {
   }
 }
 
-// ../editor-core/dist/server/chunk-O6JB5RRS.js
+// ../editor-core/dist/server/chunk-NH7XYUCJ.js
 import { createHash as createHash4 } from "node:crypto";
 import { mkdirSync as mkdirSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync5, rmSync as rmSync2, existsSync as existsSync10 } from "node:fs";
 import { homedir as homedir7 } from "node:os";
 import { dirname as dirname7, join as join12, resolve as resolve10 } from "node:path";
 import { LiveEditor, LiveTools } from "@volter/live";
-import { connect as connect5, unconnectedBindings, withEditorMemberHints } from "@volter/live";
+import { connect as connect5, NO_SESSION_FOR_PROJECT, unconnectedBindings, withEditorMemberHints } from "@volter/live";
 var NOISE = /* @__PURE__ */ new Set(["constructor", "then", "catch", "finally"]);
 var FUNCTION_NOISE = /* @__PURE__ */ new Set(["length", "name", "prototype", "arguments", "caller"]);
 function describe4(target, key) {
@@ -34630,7 +34703,16 @@ async function control(command, verb, argument, reason, scope, attachment) {
     console.log(formatSurface(command, { ...unconnected, ...scope?.(unconnected) }));
     return;
   }
-  const live = attachment?.live ?? await connect5();
+  let live;
+  try {
+    live = attachment?.live ?? await connect5();
+  } catch (error50) {
+    if (verb === "close" && error50 instanceof Error && error50.code === NO_SESSION_FOR_PROJECT) {
+      console.log("No editor is open for this project, so there is nothing to close.");
+      return;
+    }
+    throw error50;
+  }
   const client = attachment?.client ?? new EditorClient({ url: `http://127.0.0.1:${live.session.port}` });
   if (verb === "close") {
     const session = (await verifiedSessions(live.session.port)).find((s) => s.port === live.session.port && s.project === live.session.projectRoot && s.registered);
@@ -34888,7 +34970,7 @@ var RELAY_COMMANDS = {
 var RELAY_COMMAND_TYPES = Object.keys(RELAY_COMMANDS);
 
 // ../editor-core/dist/server/launcher/session-verbs.js
-import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync9, statSync as statSync3, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync11, mkdirSync as mkdirSync6, readFileSync as readFileSync9, statSync as statSync4, writeFileSync as writeFileSync6 } from "node:fs";
 import { basename as basename3, dirname as dirname8, join as join23, resolve as resolve22 } from "node:path";
 import { setTimeout as delay2 } from "node:timers/promises";
 import { resolveSession } from "@volter/live";
@@ -35096,7 +35178,7 @@ async function screenshot(target, options) {
       const resolved = resolveModelTarget(classified.path, {
         cwd: process.cwd(),
         projectRoot: session.projectRoot,
-        exists: (path) => existsSync11(path) && statSync3(path).isFile()
+        exists: (path) => existsSync11(path) && statSync4(path).isFile()
       });
       if ("error" in resolved) throw new Error(resolved.error);
       await assertUnambiguousTarget(session.client, classified.path, resolved.file);
@@ -35106,7 +35188,7 @@ async function screenshot(target, options) {
       return moduleLook(session.client, session.projectRoot, classified.path, flags);
     case "entity": {
       const asFile = resolve22(process.cwd(), classified.entityId);
-      if (existsSync11(asFile) && statSync3(asFile).isFile()) await assertUnambiguousTarget(session.client, classified.entityId, asFile);
+      if (existsSync11(asFile) && statSync4(asFile).isFile()) await assertUnambiguousTarget(session.client, classified.entityId, asFile);
       const resolved = resolveEntityTarget(classified.entityId, await liveEntityRows(session.client));
       if ("error" in resolved) throw new Error(resolved.error);
       return assetLabLook(session.client, { entityId: resolved.entityId }, flags, screenshotPath(session.projectRoot, resolved.entityId), "scene");

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.209",
+  version: "0.5.211",
   publishConfig: {
     access: "public"
   },
@@ -14095,13 +14095,13 @@ var package_default = {
     }
   },
   dependencies: {
-    "@volter/editor-core": "0.5.209",
-    "@volter/editor-blender": "0.1.148",
-    "@volter/editor-threejs": "0.5.209",
-    "@volter/blender-engine": "0.1.146",
-    "@volter/project": "0.5.209",
-    "@volter/sdk": "0.5.209",
-    "@volter/live": "0.5.209",
+    "@volter/editor-core": "0.5.211",
+    "@volter/editor-blender": "0.1.150",
+    "@volter/editor-threejs": "0.5.211",
+    "@volter/blender-engine": "0.1.148",
+    "@volter/project": "0.5.211",
+    "@volter/sdk": "0.5.211",
+    "@volter/live": "0.5.211",
     "@modelcontextprotocol/sdk": "1.32.1",
     typescript: "5.9.3",
     undici: "7.29.1"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/cyclotron",
   "author": "Volter AI, Inc.",
-  "version": "0.5.209",
+  "version": "0.5.211",
   "publishConfig": {
     "access": "public"
   },
@@ -72,13 +72,13 @@
     }
   },
   "dependencies": {
-    "@volter/editor-core": "0.5.209",
-    "@volter/editor-blender": "0.1.148",
-    "@volter/editor-threejs": "0.5.209",
-    "@volter/blender-engine": "0.1.146",
-    "@volter/project": "0.5.209",
-    "@volter/sdk": "0.5.209",
-    "@volter/live": "0.5.209",
+    "@volter/editor-core": "0.5.211",
+    "@volter/editor-blender": "0.1.150",
+    "@volter/editor-threejs": "0.5.211",
+    "@volter/blender-engine": "0.1.148",
+    "@volter/project": "0.5.211",
+    "@volter/sdk": "0.5.211",
+    "@volter/live": "0.5.211",
     "@modelcontextprotocol/sdk": "1.32.1",
     "typescript": "5.9.3",
     "undici": "7.29.1"

package/starter/AGENTS.md

@@ -397,10 +397,14 @@ running the game.
 
 Commands, all through `npx --no-install cyclotron`:
 
-- `status`, `console [--all]`, `chat status`: the editor, its console and its
-  AI session. `chat send "<prompt>"` sends to the visible conversation and
-  `chat stop` stops its turn. Inspect the transcript and pending requests for
-  the outcome; a dispatch receipt does not mean an edit is done.
+- `status`, `console [--all]`: the editor and its console.
+- `chat status`, `chat send "<prompt>"`, `chat stop`: drive the editor's Chat
+  from outside it (a terminal, or an agent beside the editor). `chat send`
+  enters the visible conversation as the person's own message. If you are the
+  agent in that Chat, your replies already reach the person: never `chat send`
+  (it comes back to you as their message) or `chat stop` (it ends your turn).
+  From outside, check the transcript and pending requests for the outcome; a
+  dispatch receipt does not mean an edit is done.
 - `eval '<JavaScript>'`: `return` what you need; `eval --list` lists what is
   available.
 - `camera --position x,y,z --target x,y,z [--fov n]`: the open document's view,

package/dist/assets/EntityModelDocument-CX8hHHXg.js

@@ -1 +0,0 @@
-import{al as f,n as l,j as c,t as d}from"./volter-sdk-NalesDkd.js";import{y as v}from"./three-integration.service-BL7B_m40.js";import{a as S}from"./live-mixers-B-bwLZ7c.js";import{m as h,J as x,o as b}from"./asset-preview-CTFNNoaI.js";import{O as j}from"./StageHost-B-XTtFAL.js";import"./output-pass-j4dAGrPY.js";import"./three.module-CtVjCPcj.js";import"./object3d-document-session-registry-CPi5Redv.js";import"./linear-resolve-Cuka7Ypb.js";import"./model-inspection-CTIJ-Dej.js";import"./standard-viewport-dressing-CZ29KDo5.js";import"./OrbitControls-DrHRrSFA.js";function w(s){const t=new Set;return s.traverse(r=>{const o=S(r);if(o)for(const e of o.clips.values())t.add(e);for(const e of r.animations)t.add(e)}),[...t]}function y({documentId:s,source:t,sourcePath:r,displayName:o,active:e,chromeless:n=!1,revision:i=0,modelSource:p}){const u=l.useCallback(()=>{const a=h(x(t)),m=w(t);return a.animations=[...m],{root:a,animations:m,dispose(){b(a)}}},[t,i]);return c.jsx(j,{documentId:s,sourcePath:r??o,displayName:o,build:u,active:e,chromeless:n,rendererLane:n?"inspector-preview":"own",assetType:"entity",...p?{modelSource:p}:{}})}function L({documentId:s,entityId:t,displayName:r,active:o}){const e=v(f()),n=l.useSyncExternalStore(e.shell.subscribe,e.shell.getSnapshot),i=e.objectMap.get(t);return i?c.jsx(y,{documentId:s,source:i,sourcePath:`Entity ${t}`,displayName:r,active:o,revision:n,modelSource:{kind:"entity",entityId:t}}):c.jsxs("div",{role:"alert",style:{padding:20,color:d.semantic.danger},children:["Scene entity ",t," is no longer available."]})}export{L as EntityModelDocument,y as Object3DSnapshotDocument};