@volter/cyclotron 0.5.208 → 0.5.210

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.208",
+  version: "0.5.210",
   publishConfig: {
     access: "public"
   },
@@ -2455,13 +2455,13 @@ var package_default = {
     }
   },
   dependencies: {
-    "@volter/editor-core": "0.5.208",
-    "@volter/editor-blender": "0.1.147",
-    "@volter/editor-threejs": "0.5.208",
-    "@volter/blender-engine": "0.1.145",
-    "@volter/project": "0.5.208",
-    "@volter/sdk": "0.5.208",
-    "@volter/live": "0.5.208",
+    "@volter/editor-core": "0.5.210",
+    "@volter/editor-blender": "0.1.149",
+    "@volter/editor-threejs": "0.5.210",
+    "@volter/blender-engine": "0.1.147",
+    "@volter/project": "0.5.210",
+    "@volter/sdk": "0.5.210",
+    "@volter/live": "0.5.210",
     "@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,26 +17000,50 @@ 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 {
     return await npmView(spec);
   } catch (error50) {
     const reason = error50 instanceof Error ? error50.message : String(error50);
-    throw new Error(`Could not read ${spec} from the registry (${reason}). Name a published version: ${product.command} upgrade <version>.`);
+    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"];
@@ -16938,7 +17064,7 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
   }
   if (pkg.workspaces !== void 0) {
     const members = Array.isArray(pkg.workspaces) ? pkg.workspaces : Array.isArray(pkg.workspaces.packages) ? pkg.workspaces.packages : [];
-    kept.push(`workspace members${members.length > 0 ? ` (${members.map(String).join(", ")})` : ""} are not upgraded: run ${product.command} upgrade in each member that is a project`);
+    kept.push(`workspace members${members.length > 0 ? ` (${members.map(String).join(", ")})` : ""} are not upgraded: run ${projectLine(product.command, "upgrade")} in each member that is a project`);
   }
   let packagesChanged = false;
   const retired = declaredRetiredProduct(product, project);
@@ -16971,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);
@@ -17000,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) {
@@ -17031,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)`);
     }
   }
@@ -17052,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;
@@ -17076,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"];
@@ -17085,7 +17211,7 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
   if (backwards !== null) {
     if (requested === void 0)
       throw new Error(
-        `${product.packageName}@latest is ${release.version} (engine ${engine}), older than the ${backwards} this project is on, so upgrading to it would move the project backwards. Nothing was changed. To go back on purpose, name the version: ${product.command} upgrade ${release.version}.`
+        `${product.packageName}@latest is ${release.version} (engine ${engine}), older than the ${backwards} this project is on, so upgrading to it would move the project backwards. Nothing was changed. To go back on purpose, name the version: ${projectLine(product.command, `upgrade ${release.version}`)}.`
       );
     warnings.push(`This moves the project BACKWARDS, from ${backwards} to ${product.packageName}@${release.version} (engine ${engine}), because that version was named.`);
   }
@@ -17095,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) {
@@ -17140,27 +17266,34 @@ async function upgradeProject(product, requested, cwd = process.cwd()) {
   for (const line of changed) console.log(`  + ${line}`);
   if (kept.length > 0) console.log("Left as it was:");
   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 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}.`);
     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:");
-  if (packagesChanged && !linked) console.log(`  npm install    # in ${project}; installs the versions above`);
-  console.log(packagesChanged ? `  ${product.command} close && ${product.command} edit .    # restart the session on the new install` : `  Press Retry on the editor page that refused the project, or run ${product.command} edit .`);
+    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) {
+    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 {
+    console.log(`  Press Retry on the editor page that refused the project, or run: ${npx} --no-install ${product.command} edit .`);
+  }
 }
 
 // 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" });
@@ -17169,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;
@@ -17320,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";
@@ -17349,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`;
     }
@@ -17630,7 +17712,7 @@ var __export2 = (target, all) => {
     __defProp2(target, name, { get: all[name], enumerable: true });
 };
 
-// ../editor-core/dist/server/chunk-D2E2T73W.js
+// ../editor-core/dist/server/chunk-5VE4ZOJY.js
 import { existsSync as existsSync6 } from "node:fs";
 import { join as join7 } from "node:path";
 var MANIFEST_FILENAME2 = "volter.project.json";
@@ -18135,7 +18217,7 @@ __export2(core_exports22, {
   parse: () => parse3,
   parseAsync: () => parseAsync3,
   prettifyError: () => prettifyError2,
-  process: () => process3,
+  process: () => process22,
   regexes: () => regexes_exports2,
   registry: () => registry2,
   safeDecode: () => safeDecode3,
@@ -28412,7 +28494,7 @@ function initializeContext2(params) {
     external: params?.external ?? void 0
   };
 }
-function process3(schema, ctx, _params = { path: [], schemaPath: [] }) {
+function process22(schema, ctx, _params = { path: [], schemaPath: [] }) {
   var _a22;
   const def = schema._zod.def;
   const seen = ctx.seen.get(schema);
@@ -28449,7 +28531,7 @@ function process3(schema, ctx, _params = { path: [], schemaPath: [] }) {
     if (parent) {
       if (!result.ref)
         result.ref = parent;
-      process3(parent, ctx, params);
+      process22(parent, ctx, params);
       ctx.seen.get(parent).isParent = true;
     }
   }
@@ -28730,14 +28812,14 @@ function isTransforming2(_schema, _ctx) {
 }
 var createToJSONSchemaMethod2 = (schema, processors = {}) => (params) => {
   const ctx = initializeContext2({ ...params, processors });
-  process3(schema, ctx);
+  process22(schema, ctx);
   extractDefs2(ctx, schema);
   return finalize2(ctx, schema);
 };
 var createStandardJSONSchemaMethod2 = (schema, io, processors = {}) => (params) => {
   const { libraryOptions, target } = params ?? {};
   const ctx = initializeContext2({ ...libraryOptions ?? {}, target, io, processors });
-  process3(schema, ctx);
+  process22(schema, ctx);
   extractDefs2(ctx, schema);
   return finalize2(ctx, schema);
 };
@@ -28992,7 +29074,7 @@ var arrayProcessor2 = (schema, ctx, _json, params) => {
   if (typeof maximum === "number")
     json22.maxItems = maximum;
   json22.type = "array";
-  json22.items = process3(def.element, ctx, { ...params, path: [...params.path, "items"] });
+  json22.items = process22(def.element, ctx, { ...params, path: [...params.path, "items"] });
 };
 var objectProcessor2 = (schema, ctx, _json, params) => {
   const json22 = _json;
@@ -29001,7 +29083,7 @@ var objectProcessor2 = (schema, ctx, _json, params) => {
   json22.properties = {};
   const shape = def.shape;
   for (const key in shape) {
-    json22.properties[key] = process3(shape[key], ctx, {
+    json22.properties[key] = process22(shape[key], ctx, {
       ...params,
       path: [...params.path, "properties", key]
     });
@@ -29024,7 +29106,7 @@ var objectProcessor2 = (schema, ctx, _json, params) => {
     if (ctx.io === "output")
       json22.additionalProperties = false;
   } else if (def.catchall) {
-    json22.additionalProperties = process3(def.catchall, ctx, {
+    json22.additionalProperties = process22(def.catchall, ctx, {
       ...params,
       path: [...params.path, "additionalProperties"]
     });
@@ -29033,7 +29115,7 @@ var objectProcessor2 = (schema, ctx, _json, params) => {
 var unionProcessor2 = (schema, ctx, json22, params) => {
   const def = schema._zod.def;
   const isExclusive = def.inclusive === false;
-  const options = def.options.map((x, i) => process3(x, ctx, {
+  const options = def.options.map((x, i) => process22(x, ctx, {
     ...params,
     path: [...params.path, isExclusive ? "oneOf" : "anyOf", i]
   }));
@@ -29045,11 +29127,11 @@ var unionProcessor2 = (schema, ctx, json22, params) => {
 };
 var intersectionProcessor2 = (schema, ctx, json22, params) => {
   const def = schema._zod.def;
-  const a = process3(def.left, ctx, {
+  const a = process22(def.left, ctx, {
     ...params,
     path: [...params.path, "allOf", 0]
   });
-  const b = process3(def.right, ctx, {
+  const b = process22(def.right, ctx, {
     ...params,
     path: [...params.path, "allOf", 1]
   });
@@ -29066,11 +29148,11 @@ var tupleProcessor2 = (schema, ctx, _json, params) => {
   json22.type = "array";
   const prefixPath = ctx.target === "draft-2020-12" ? "prefixItems" : "items";
   const restPath = ctx.target === "draft-2020-12" ? "items" : ctx.target === "openapi-3.0" ? "items" : "additionalItems";
-  const prefixItems = def.items.map((x, i) => process3(x, ctx, {
+  const prefixItems = def.items.map((x, i) => process22(x, ctx, {
     ...params,
     path: [...params.path, prefixPath, i]
   }));
-  const rest = def.rest ? process3(def.rest, ctx, {
+  const rest = def.rest ? process22(def.rest, ctx, {
     ...params,
     path: [...params.path, restPath, ...ctx.target === "openapi-3.0" ? [def.items.length] : []]
   }) : null;
@@ -29110,7 +29192,7 @@ var recordProcessor2 = (schema, ctx, _json, params) => {
   const keyBag = keyType._zod.bag;
   const patterns = keyBag?.patterns;
   if (def.mode === "loose" && patterns && patterns.size > 0) {
-    const valueSchema = process3(def.valueType, ctx, {
+    const valueSchema = process22(def.valueType, ctx, {
       ...params,
       path: [...params.path, "patternProperties", "*"]
     });
@@ -29120,12 +29202,12 @@ var recordProcessor2 = (schema, ctx, _json, params) => {
     }
   } else {
     if (ctx.target === "draft-07" || ctx.target === "draft-2020-12") {
-      json22.propertyNames = process3(def.keyType, ctx, {
+      json22.propertyNames = process22(def.keyType, ctx, {
         ...params,
         path: [...params.path, "propertyNames"]
       });
     }
-    json22.additionalProperties = process3(def.valueType, ctx, {
+    json22.additionalProperties = process22(def.valueType, ctx, {
       ...params,
       path: [...params.path, "additionalProperties"]
     });
@@ -29140,7 +29222,7 @@ var recordProcessor2 = (schema, ctx, _json, params) => {
 };
 var nullableProcessor2 = (schema, ctx, json22, params) => {
   const def = schema._zod.def;
-  const inner = process3(def.innerType, ctx, params);
+  const inner = process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema);
   if (ctx.target === "openapi-3.0") {
     seen.ref = def.innerType;
@@ -29151,20 +29233,20 @@ var nullableProcessor2 = (schema, ctx, json22, params) => {
 };
 var nonoptionalProcessor2 = (schema, ctx, _json, params) => {
   const def = schema._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema);
   seen.ref = def.innerType;
 };
 var defaultProcessor2 = (schema, ctx, json22, params) => {
   const def = schema._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema);
   seen.ref = def.innerType;
   json22.default = JSON.parse(JSON.stringify(def.defaultValue));
 };
 var prefaultProcessor2 = (schema, ctx, json22, params) => {
   const def = schema._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema);
   seen.ref = def.innerType;
   if (ctx.io === "input")
@@ -29172,7 +29254,7 @@ var prefaultProcessor2 = (schema, ctx, json22, params) => {
 };
 var catchProcessor2 = (schema, ctx, json22, params) => {
   const def = schema._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema);
   seen.ref = def.innerType;
   let catchValue;
@@ -29186,32 +29268,32 @@ var catchProcessor2 = (schema, ctx, json22, params) => {
 var pipeProcessor2 = (schema, ctx, _json, params) => {
   const def = schema._zod.def;
   const innerType = ctx.io === "input" ? def.in._zod.def.type === "transform" ? def.out : def.in : def.out;
-  process3(innerType, ctx, params);
+  process22(innerType, ctx, params);
   const seen = ctx.seen.get(schema);
   seen.ref = innerType;
 };
 var readonlyProcessor2 = (schema, ctx, json22, params) => {
   const def = schema._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema);
   seen.ref = def.innerType;
   json22.readOnly = true;
 };
 var promiseProcessor2 = (schema, ctx, _json, params) => {
   const def = schema._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema);
   seen.ref = def.innerType;
 };
 var optionalProcessor2 = (schema, ctx, _json, params) => {
   const def = schema._zod.def;
-  process3(def.innerType, ctx, params);
+  process22(def.innerType, ctx, params);
   const seen = ctx.seen.get(schema);
   seen.ref = def.innerType;
 };
 var lazyProcessor2 = (schema, ctx, _json, params) => {
   const innerType = schema._zod.innerType;
-  process3(innerType, ctx, params);
+  process22(innerType, ctx, params);
   const seen = ctx.seen.get(schema);
   seen.ref = innerType;
 };
@@ -29263,7 +29345,7 @@ function toJSONSchema2(input, params) {
     const defs = {};
     for (const entry of registry22._idmap.entries()) {
       const [_, schema] = entry;
-      process3(schema, ctx2);
+      process22(schema, ctx2);
     }
     const schemas = {};
     const external = {
@@ -29286,7 +29368,7 @@ function toJSONSchema2(input, params) {
     return { schemas };
   }
   const ctx = initializeContext2({ ...params, processors: allProcessors2 });
-  process3(input, ctx);
+  process22(input, ctx);
   extractDefs2(ctx, input);
   return finalize2(ctx, input);
 }
@@ -29342,7 +29424,7 @@ var JSONSchemaGenerator2 = class {
    * This must be called before emit().
    */
   process(schema, _params = { path: [], schemaPath: [] }) {
-    return process3(schema, this.ctx, _params);
+    return process22(schema, this.ctx, _params);
   }
   /**
    * Emit the final JSON Schema after processing.
@@ -31583,12 +31665,13 @@ async function waitForOwnEditorServer(opts) {
 }
 function describeEditorBootFailure(outcome, ctx) {
   const logs = ctx.logPath ? ` Editor logs: ${ctx.logPath}.` : "";
-  const occupied2 = outcome.occupant === null ? "" : ` Port ${ctx.port} is being served by an editor for ${outcome.occupant} \u2014 close it (run \`${ctx.command} close\` from that project's directory), or launch on another port.`;
+  const npx = `${process.platform === "win32" ? "npx.cmd" : "npx"} --no-install ${ctx.command}`;
+  const occupied2 = outcome.occupant === null ? "" : ` Port ${ctx.port} is being served by an editor for ${outcome.occupant} \u2014 close it (run \`${npx} close\` from that project's directory), or launch on another port.`;
   if (outcome.status === "exited") {
     const how = outcome.signal !== null ? `was killed by ${String(outcome.signal)}` : `exited with code ${outcome.code}`;
     return `The editor process for ${ctx.project} ${how} before it started serving ${ctx.serverUrl}/.${occupied2}${logs}`;
   }
-  return `The editor for ${ctx.project} has not answered ${ctx.serverUrl}/ within ${Math.round(ctx.timeoutMs / 1e3)}s, and its process is still running.${occupied2} A project's FIRST editor boot is the slow one \u2014 it pays Vite's cold dependency optimization into ${ctx.project}/node_modules/.vite-editor, and later boots reuse it. Re-run \`${ctx.command} edit ${ctx.project}\`: the retry starts from whatever that first boot already cached.${logs}`;
+  return `The editor for ${ctx.project} has not answered ${ctx.serverUrl}/ within ${Math.round(ctx.timeoutMs / 1e3)}s, and its process is still running.${occupied2} A project's FIRST editor boot is the slow one \u2014 it pays Vite's cold dependency optimization into ${ctx.project}/node_modules/.vite-editor, and later boots reuse it. From ${ctx.project}, re-run \`${npx} edit .\`: the retry starts from whatever that first boot already cached.${logs}`;
 }
 
 // ../editor-core/dist/server/chunk-OAA5YIUR.js
@@ -32373,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,
@@ -32415,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,
@@ -32753,13 +32836,13 @@ async function terminateEditorSession(session, graceMs = 5500) {
   return "forced";
 }
 
-// ../editor-core/dist/server/chunk-5BPW42AV.js
+// ../editor-core/dist/server/chunk-JBFVVCSF.js
 import { spawn as spawn3 } from "node:child_process";
 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;
@@ -32829,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;
         }
@@ -34525,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) {
@@ -34620,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);
@@ -34878,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";
@@ -35086,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);
@@ -35096,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");