@volter/cyclotron 0.5.212 → 0.5.213

package/dist-node/cli.js

@@ -815,7 +815,7 @@ __export(blender_mcp_exports, {
 });
 import { randomUUID } from "node:crypto";
 import { mkdirSync as mkdirSync6, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "node:fs";
-import { delimiter, dirname as dirname7, isAbsolute as isAbsolute3, relative as relative7, sep as sep4 } from "node:path";
+import { delimiter, dirname as dirname7, isAbsolute as isAbsolute3, relative as relative7, sep as sep5 } from "node:path";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -825,8 +825,9 @@ import {
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 import { EditorClient as EditorClient4 } from "@volter/live/client";
+import { sessionFetch as sessionFetch4 } from "@volter/live/registry-format";
 function projectRelative(project, absolute) {
-  const rel = relative7(project, absolute).split(sep4).join("/");
+  const rel = relative7(project, absolute).split(sep5).join("/");
   if (rel === "" || rel.startsWith("../")) return null;
   return rel;
 }
@@ -1026,7 +1027,7 @@ var init_blender_mcp = __esm({
             const shipped = projectPath !== null && projectOutputRootOf(projectPath) === "public" ? projectPath : null;
             const transferId = randomUUID();
             await tab.commandHeld("blender-read-file", { path: entry.path, transferId });
-            const spooled = await fetch(`${await tab.origin()}/__editor/blender-file?id=${transferId}`);
+            const spooled = await sessionFetch4(`${await tab.origin()}/__editor/blender-file?id=${transferId}`);
             if (!spooled.ok) throw new Error(`Transfer of ${entry.path} failed: ${spooled.status}`);
             const bytes = Buffer.from(await spooled.arrayBuffer());
             if (shipped === null) {
@@ -1050,7 +1051,7 @@ var init_blender_mcp = __esm({
               });
               if (typeof listing.document === "string" && listing.document !== "")
                 query.append("inputs", listing.document);
-              const recorded = await fetch(`${await tab.origin()}/__editor/blender-output?${query}`, {
+              const recorded = await sessionFetch4(`${await tab.origin()}/__editor/blender-output?${query}`, {
                 method: "POST",
                 body: new Uint8Array(bytes)
               });
@@ -1132,12 +1133,12 @@ __export(render_movie_exports, {
 });
 import { randomUUID as randomUUID2 } from "node:crypto";
 import { copyFileSync, mkdirSync as mkdirSync7, unlinkSync } from "node:fs";
-import { dirname as dirname8, isAbsolute as isAbsolute4, join as join11, relative as relative8, sep as sep5 } from "node:path";
+import { dirname as dirname8, isAbsolute as isAbsolute4, join as join11, relative as relative8, sep as sep6 } from "node:path";
 import { connect as connect6 } from "@volter/live";
 async function renderProjectMovie(projectRoot, options) {
   const within = relative8(projectRoot, options.out);
   const inProject = within !== "" && !within.startsWith("..") && !isAbsolute4(within);
-  const written = inProject ? within.split(sep5).join("/") : `.volter/renders/${randomUUID2()}.webm`;
+  const written = inProject ? within.split(sep6).join("/") : `.volter/renders/${randomUUID2()}.webm`;
   const from = frameOrMarker(options.from);
   const to = frameOrMarker(options.to);
   if (options.composition !== void 0 && (typeof from === "string" || typeof to === "string"))
@@ -1216,7 +1217,7 @@ var package_default = {
   name: "@volter/cyclotron",
   publisher: "volter",
   author: "Volter AI, Inc.",
-  version: "0.5.212",
+  version: "0.5.213",
   publishConfig: {
     access: "public"
   },
@@ -1284,31 +1285,31 @@ var package_default = {
         adapterRequired: true,
         workbench: {
           "darwin-arm64": {
-            release: "cyclotron-4a7cd45e4186-78f596095cf0-darwin-arm64",
-            tarballSha256: "f32ac81bcc072d7b84591affdead5dbb62621eb7480b8b89acece5d274e63624"
+            release: "cyclotron-624490512f0c-0ba7394f05b2-darwin-arm64",
+            tarballSha256: "4b752c3abd5595e2e4f7ae4d750b78d2f3c1a0da98140a8ee04c89893689a836"
           },
           "linux-x64": {
-            release: "cyclotron-4782d9a281ef-5b6840f8c154-linux-x64",
-            tarballSha256: "5fe9b6965453ad47a140f6ca939fbbc56a5b7ab9b2aec4b125d7d31f5adea5f9"
+            release: "cyclotron-624490512f0c-0ba7394f05b2-linux-x64",
+            tarballSha256: "6028c6d71df09bbb67ee90b936fc80fdc429d5ef0b1c78db07a6c39d9a4b2e1c"
           },
           "win32-x64": {
-            release: "cyclotron-4782d9a281ef-5b6840f8c154-win32-x64",
-            tarballSha256: "c623156000dff25c6dbb4d88992b4a3d4d5a7aeb42a1882f1b9e20c8f496df04"
+            release: "cyclotron-624490512f0c-0ba7394f05b2-win32-x64",
+            tarballSha256: "57e8fa6dbc439de5fba7da35fa17c710644d465842bd967c8ba7f1e73fcbee2f"
           }
         }
       }
     }
   },
   dependencies: {
-    "@volter/editor-core": "0.5.212",
-    "@volter/editor-blender": "0.1.151",
-    "@volter/editor-threejs": "0.5.212",
-    "@volter/chat": "0.5.212",
-    "@volter/blender-engine": "0.1.149",
-    "@volter/project": "0.5.212",
-    "@volter/sdk": "0.5.212",
-    "@volter/live": "0.5.212",
-    "@volter/play": "0.5.212",
+    "@volter/editor-core": "0.5.213",
+    "@volter/editor-blender": "0.1.152",
+    "@volter/editor-threejs": "0.5.213",
+    "@volter/chat": "0.5.213",
+    "@volter/blender-engine": "0.1.150",
+    "@volter/project": "0.5.213",
+    "@volter/sdk": "0.5.213",
+    "@volter/live": "0.5.213",
+    "@volter/play": "0.5.213",
     three: "^0.186.1",
     "@modelcontextprotocol/sdk": "1.32.1",
     typescript: "5.9.3",
@@ -15290,6 +15291,9 @@ function run(program, args, cwd, what) {
 function stdNew(std, folder, name) {
   return run(process.execPath, [std, "new", folder, "--name", name], dirname(folder), "std new");
 }
+function stdUpgrade(std, folder) {
+  return run(process.execPath, [std, "upgrade", folder], folder, "std upgrade");
+}
 function gameStd(project, args) {
   const std = join2(project, "node_modules", "@volter-ai", "std-dev", "bin", "std.js");
   if (!existsSync2(std)) throw new Error(`${project} has no @volter-ai/std-dev installed (node_modules/@volter-ai/std-dev): run \`pnpm install\` there.`);
@@ -15339,8 +15343,8 @@ var EXAMPLES = {
     dependencies: { i18next: "~26.7.2" },
     /** The goal the game's `play` scripts name in place of the starter's. */
     goal: "win",
-    /** std's starter files the example has no use for: its ground level, its walking characters and its chat. */
-    removes: ["levels/GroundLevel.tsx", "client/characters.tsx", "client/chat.tsx"]
+    /** std's starter files the example has no use for: its main level, its walking characters and its chat. */
+    removes: ["levels/MainLevel.tsx", "client/characters.tsx", "client/chat.tsx"]
   }
 };
 var isExample = (id) => Object.hasOwn(EXAMPLES, id);
@@ -15606,7 +15610,7 @@ async function startupProject(create, { cwd = process.cwd(), home = homedir() }
 
 // node/chat.ts
 import { connect } from "@volter/live";
-import { readLiveRegisteredSessions } from "@volter/live/registry-format";
+import { sessionFetch } from "@volter/live/registry-format";
 var CHAT_USAGE = "chat status | chat send <prompt> | chat stop";
 var SEND_CONFIRM_MS = 8e3;
 async function chat(args) {
@@ -15630,15 +15634,10 @@ async function chat(args) {
     throw new Error("Chat is waiting on an approval in the editor. Answer it there (or use chat stop), then send.");
   }
   if (action === "send" && state.busy) {
-    const entry = readLiveRegisteredSessions().find((s) => s.port === session.port);
     const origin = `http://127.0.0.1:${session.port}`;
-    const response = await fetch(`${origin}/__editor/harness-chat/steer`, {
+    const response = await sessionFetch(`${origin}/__editor/harness-chat/steer`, {
       method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Origin: origin,
-        ...entry?.controlSecret ? { "x-volter-editor-control": entry.controlSecret } : {}
-      },
+      headers: { "Content-Type": "application/json", Origin: origin },
       body: JSON.stringify({ text: prompt })
     });
     const said2 = await response.json().catch(() => null);
@@ -15693,14 +15692,13 @@ async function chat(args) {
 
 // node/play-log.ts
 import { connect as connect2 } from "@volter/live";
-var PLAY_LOG_USAGE = "play-log [--since <simTime>] [--kind <kind>] [--document <id>] [--json]";
+var PLAY_LOG_USAGE = "play-log [--since <simTime>] [--kind <kind>] [--json]";
 async function playLog(options) {
   const since = options.since === void 0 ? void 0 : Number(options.since);
   if (since !== void 0 && !Number.isFinite(since))
     throw new Error(`--since takes simulation seconds, a number; it was given ${options.since}.`);
   const live = await connect2();
-  const { ok: _ok, ...reading } = await live.editor.contributedVerb("model-play-log", {
-    ...options.document === void 0 ? {} : { documentId: options.document },
+  const { ok: _ok, ...reading } = await live.editor.contributedVerb("play-log", {
     ...since === void 0 ? {} : { since },
     ...options.kind === void 0 ? {} : { kind: options.kind }
   });
@@ -15709,11 +15707,10 @@ async function playLog(options) {
     return;
   }
   if (reading.script === null) {
-    console.log(options.document === void 0 ? "Nothing has played since the editor page loaded." : `${options.document} has not played since the editor page loaded${reading.documents.length ? `; logs: ${reading.documents.join(", ")}` : ""}.`);
+    console.log("Nothing has played since the editor page loaded.");
     return;
   }
   const kept = reading.total - reading.dropped;
-  if (reading.documents.length > 1) console.log(`Logs: ${reading.documents.join(", ")}; this is ${reading.documentId}'s (--document picks another).`);
   console.log(`Play log of ${reading.script}: ${reading.playing ? "playing" : "stopped"} at ${reading.simT.toFixed(3)}s, tick ${reading.tick}; ${kept} of ${reading.total} entries kept${reading.dropped ? ` (the oldest ${reading.dropped} dropped)` : ""}, ${reading.entries.length} shown.`);
   for (const entry of reading.entries)
     console.log(`${entry.simT.toFixed(3).padStart(10)}s  #${String(entry.tick).padEnd(6)} ${entry.kind}${entry.facts ? `  ${JSON.stringify(entry.facts)}` : ""}`);
@@ -15726,6 +15723,7 @@ import { join as join5, relative as relative3, resolve as resolve4 } from "node:
 var ADD_PLAY_USAGE = "add-play [folder]    # make this project a volter-ai/std game: std new into it, its models moved to levels/";
 var MERGED = ["package.json", ".gitignore", "tsconfig.json"];
 var ASIDE = join5(".volter", "add-play");
+var LEVEL_FINDER = "{ finder: 'stdLevelDocuments', include: ['levels/**/*.tsx', 'levels/**/*.blend'] }";
 function projectOf(folder) {
   let dir = resolve4(folder);
   while (!existsSync5(join5(dir, MANIFEST_FILENAME))) {
@@ -15799,11 +15797,11 @@ ${missing.join("\n")}
   const adapterPath = join5(project, "editor", "volter.adapter.ts");
   if (existsSync5(adapterPath)) {
     const adapter = await readFile3(adapterPath, "utf8");
-    const next = adapter.replace(/include: \['src\/models\/\*\*\/\*\.blend'\]/, "include: ['levels/**/*.blend', 'prefabs/**/*.blend']").replace(/default: 'model:src\/models\/([^'/]+\.blend)'/, "default: 'model:levels/$1'");
-    if (next.includes("include: ['levels/**/*.blend', 'prefabs/**/*.blend']")) {
+    const next = adapter.replace(/include: \['src\/models\/\*\*\/\*\.blend'\] \}/, `include: ['levels/**/*.blend', 'prefabs/**/*.blend'] }, ${LEVEL_FINDER}`).replace(/default: 'model:src\/models\/[^'/]+\.blend', /, "");
+    if (next.includes(LEVEL_FINDER)) {
       await writeFile2(adapterPath, next);
-      said2.push("editor/volter.adapter.ts: its documents are levels/**/*.blend and prefabs/**/*.blend");
-    } else said2.push("editor/volter.adapter.ts has a shape this command does not edit: make its modelsFromBlendFiles finder include ['levels/**/*.blend', 'prefabs/**/*.blend']");
+      said2.push("editor/volter.adapter.ts: its documents are levels/**/*.blend, prefabs/**/*.blend and each level, and it opens on the main level");
+    } else said2.push(`editor/volter.adapter.ts has a shape this command does not edit: make its modelsFromBlendFiles finder include ['levels/**/*.blend', 'prefabs/**/*.blend'], add ${LEVEL_FINDER}, and drop its default`);
   }
   const nodeModules = join5(project, "node_modules");
   if (existsSync5(nodeModules) && lstatSync(nodeModules).isSymbolicLink()) await unlink(nodeModules);
@@ -15874,9 +15872,9 @@ function joinNegativeValues(args, options) {
 
 // node/play.ts
 import { connect as connect4 } from "@volter/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|animation] | play autoplay on [<goal>] | play autoplay 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 players [1-8] | play mode [game|animation] | play autoplay on [<goal>] | play autoplay off";
 var BARE = /* @__PURE__ */ new Set(["state", "play", "stop", "pause", "resume", "restart"]);
-async function play(args, document) {
+async function play(args) {
   const [verb = "state", value, ...rest] = args;
   const usage = () => {
     throw new Error(`Usage: ${COMMAND} ${PLAY_USAGE}`);
@@ -15891,78 +15889,68 @@ async function play(args, document) {
   } else if (verb === "speed") {
     if (value === void 0) usage();
     commandArgs = { speed: value };
+  } else if (verb === "players") {
+    if (value !== void 0) commandArgs = { players: value };
   } else if (verb === "autoplay") {
     if (value !== "on" && value !== "off") usage();
     commandArgs = { on: value === "on", ...goal !== void 0 ? { goal } : {} };
   } else if (verb === "mode") {
     if (value !== void 0) commandArgs = { mode: value };
   } else usage();
-  if (document !== void 0) commandArgs = { ...commandArgs, document };
   const { editor } = await connect4();
-  if (document !== void 0 && (verb === "play" || verb === "restart")) {
-    const opened = await editor.open(document.replace(/^document:/, "")).catch((error50) => {
-      throw new Error(`Play cannot bring ${document} forward to play it: ${error50 instanceof Error ? error50.message : String(error50)}`);
-    });
-    if (opened.documentId !== document) throw new Error(`Play cannot bring ${document} forward to play it: opening it brought ${opened.documentId} forward.`);
-  }
-  const state = (args2) => editor.command("volter.model-play.state", args2);
-  const answer = await onceOnScreen(() => editor.command(`volter.model-play.${verb}`, commandArgs)).catch((error50) => afterLostAnswer(error50, verb, commandArgs, state));
+  const state = () => editor.command("volter.play.state");
+  const answer = await editor.command(`volter.play.${verb}`, commandArgs).catch((error50) => afterLostAnswer(error50, verb, state));
   if (verb === "stop") return stopped(answer, state);
+  if (verb === "autoplay" && value === "on") return goalEnded(answer, state);
   if (verb !== "play" && verb !== "restart") return answer;
   return startedOrRefused(answer, state);
 }
 function stopped(first, state) {
   return untilState(first, state, (current) => current.playing !== true, "Stop asked; waiting for Play to end");
 }
+function goalEnded(first, state) {
+  return untilState(
+    first,
+    state,
+    (current) => !/: playing$/.test(current.autoplay?.state ?? ""),
+    "Autoplay is on; waiting for std to say how the goal ended",
+    `each bot's end is in \`${COMMAND} play-log --kind outcome\` as it comes`
+  );
+}
 var IDEMPOTENT = /* @__PURE__ */ new Set(["state", "play", "stop"]);
-async function afterLostAnswer(error50, verb, args, state) {
+async function afterLostAnswer(error50, verb, state) {
   const said2 = error50 instanceof Error ? error50.message : String(error50);
   if (!/never reached the editor/.test(said2) || !IDEMPOTENT.has(verb)) throw error50;
-  const read = await state(args?.["document"] !== void 0 ? { document: args["document"] } : {});
+  const read = await state();
   if (verb === "play" && read.playing === true || verb === "stop" && read.playing === false || verb === "state") return read;
   throw error50;
 }
-var OPENING_LIMIT_MS = 6e5;
-async function onceOnScreen(ask) {
-  const began = Date.now();
-  for (; ; ) {
-    try {
-      return await ask();
-    } catch (error50) {
-      const said2 = error50 instanceof Error ? error50.message : String(error50);
-      const opening = / is still opening: /.exec(said2);
-      if (opening === null || Date.now() - began > OPENING_LIMIT_MS) throw error50;
-      console.error(`${said2.slice(0, opening.index).replace(/^.*\s(?=\S+$)/, "")} is still opening; waiting for it to be on screen (${Math.round((Date.now() - began) / 1e3)}s).`);
-    }
-  }
-}
 var PROGRESS_EVERY_MS = 1e4;
 function startedOrRefused(first, state) {
-  const documentId = first.document;
   return untilState(first, state, (current) => {
     const failure = current.clock?.failure;
     if (typeof failure === "string" && failure !== "")
       throw new Error(
         `Play did not start: ${failure}
-The play log has the entry: ${COMMAND} play-log --kind script-error${documentId ? ` --document ${documentId}` : ""}`
+The play log has the entry: ${COMMAND} play-log --kind script-error`
       );
     if (current.playing === false) throw new Error(`Play switched itself off before a game started; \`${COMMAND} console\` says why.`);
     return current.clock?.running === true;
   }, "Play is on; waiting for a player's page to join");
 }
-async function untilState(first, state, done, waiting) {
+var FRAMES_HINT = "The tab draws frames only while it is visible \u2014 is it hidden or minimised?";
+async function untilState(first, state, done, waiting, hint = FRAMES_HINT) {
   let current = first;
-  const args = current.document === void 0 ? {} : { document: current.document };
   const began = Date.now();
   let saidAt = began;
   while (!done(current)) {
     const now = Date.now();
     if (now - saidAt >= PROGRESS_EVERY_MS) {
       saidAt = now;
-      console.error(`${waiting} (${Math.round((now - began) / 1e3)}s). The tab draws frames only while it is visible \u2014 is it hidden or minimised?`);
+      console.error(`${waiting} (${Math.round((now - began) / 1e3)}s). ${hint}`);
     }
     await new Promise((resolve10) => setTimeout(resolve10, 250));
-    current = await state(args);
+    current = await state();
   }
   return current;
 }
@@ -16204,7 +16192,7 @@ var __export2 = (target, all) => {
     __defProp2(target, name, { get: all[name], enumerable: true });
 };
 
-// ../editor-core/dist/server/chunk-7GCNCWQ6.js
+// ../editor-core/dist/server/chunk-APPU5D4H.js
 import { existsSync as existsSync8, readFileSync as readFileSync3, realpathSync, statSync as statSync2 } from "node:fs";
 import { join as join8, sep as sep3 } from "node:path";
 import {
@@ -16219,7 +16207,7 @@ import {
 } from "@volter/live/product-locator";
 import { existsSync as existsSync22 } from "node:fs";
 import { join as join22 } from "node:path";
-import { installedPackageDir as installedPackageDir2 } from "@volter/live/installed-package";
+import { sessionFetch as sessionFetch2 } from "@volter/live/registry-format";
 var DEFAULT_RELAY_COMMAND_TIMEOUT_MS = 5e3;
 var noDerivedRefresh = (timeoutMs = DEFAULT_RELAY_COMMAND_TIMEOUT_MS) => ({
   timeoutMs,
@@ -30014,7 +30002,8 @@ var DocumentEntrySchema = external_exports2.object({
   authorable: external_exports2.boolean(),
   reach: SceneReachSchema,
   source: SceneSourceSchema.optional(),
-  finder: external_exports2.string().min(1).optional()
+  finder: external_exports2.string().min(1).optional(),
+  opensUnwritten: external_exports2.boolean().optional()
 }).strict();
 var AdapterDocumentTableSchema = external_exports2.object({
   entries: external_exports2.array(DocumentEntrySchema).optional(),
@@ -30153,7 +30142,7 @@ async function waitForOwnEditorServer(opts) {
     intervalMs = 300,
     progressIntervalMs = 2e4,
     onProgress,
-    fetchImpl = fetch
+    fetchImpl = sessionFetch2
   } = opts;
   const startedAt = Date.now();
   const deadline = startedAt + timeoutMs;
@@ -30197,7 +30186,6 @@ function describeEditorBootFailure(outcome, ctx) {
   }
   return `The editor for ${ctx.project} has not answered ${ctx.serverUrl}/ within ${Math.round(ctx.timeoutMs / 1e3)}s, and its process is still running.${occupied} 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}`;
 }
-var CONTROLLER_DISCONNECTED_MESSAGE = "The editor tab controlling this command disconnected before reporting a result.";
 
 // ../editor-core/dist/server/chunk-DWXQPOKZ.js
 var HOSTED_ATTACHMENT_PATH = "/__editor-hosted";
@@ -30329,8 +30317,8 @@ import { createRequire as createRequire2 } from "node:module";
 import { closeSync, existsSync as existsSync9, mkdirSync as mkdirSync3, openSync, readFileSync as readFileSync32, realpathSync as realpathSync2, rmSync as rmSync2 } from "node:fs";
 import { join as join32, resolve as resolve22 } from "node:path";
 import { resolveProductForProject as resolveProductForProject3 } from "@volter/live/product-locator";
-import { resolveWorkbenchForProject, workbenchUrl } from "@volter/live/workbench-locator";
-import { announceEditorLaunch, waitForPendingEditorLaunch } from "@volter/live/registry-format";
+import { resolveWorkbenchForProject } from "@volter/live/workbench-locator";
+import { announceEditorLaunch, registeredConnectionToken, sessionFetch as sessionFetch22, waitForPendingEditorLaunch } from "@volter/live/registry-format";
 import { createHash as createHash2 } from "node:crypto";
 import { mkdirSync, readFileSync as readFileSync4, renameSync, rmdirSync, statSync as statSync3, writeFileSync } from "node:fs";
 import { homedir as homedir2 } from "node:os";
@@ -30341,16 +30329,20 @@ import { realpathSync as realpathSync3 } from "node:fs";
 import { isAbsolute, relative as relative6, resolve as resolve7 } from "node:path";
 import {
   pidAlive,
-  readLiveRegisteredSessions as readLiveRegisteredSessions2,
-  servedProjectAnswer
+  readLiveRegisteredSessions,
+  servedProjectAnswer,
+  sessionFetch as sessionFetch3
 } from "@volter/live/registry-format";
 import { execFileSync as execFileSync22 } from "node:child_process";
 import { createServer } from "node:net";
 import { execFileSync as execFileSync3 } from "node:child_process";
 import { mkdirSync as mkdirSync2, readFileSync as readFileSync22, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { join as join23 } from "node:path";
+import { CONNECTION_TOKEN_COOKIE } from "@volter/live/registry-format";
+import { projectKey } from "@volter/live/workbench-locator";
 import { connect as connect5, NO_SESSION_FOR_PROJECT, SESSION_MANIFEST_UNREADABLE, unconnectedBindings, withEditorMemberHints } from "@volter/live";
 import { EditorClient as EditorClient2 } from "@volter/live/client";
+import { installedPackageDir as installedPackageDir2 } from "@volter/live/installed-package";
 import { createHash as createHash32 } from "node:crypto";
 import { mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync3, rmSync as rmSync3, existsSync as existsSync32 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
@@ -30366,6 +30358,7 @@ import { basename, dirname as dirname32, join as join62, resolve as resolve52 }
 import { setTimeout as delay } from "node:timers/promises";
 import { resolveSession } from "@volter/live";
 import { EditorClient as EditorClient3 } from "@volter/live/client";
+import { sessionFetch as sessionFetch32 } from "@volter/live/registry-format";
 import { isAbsolute as isAbsolute2, join as join52, relative as relative22, resolve as resolve42 } from "node:path";
 function hash3(value) {
   return createHash3("sha256").update(value).digest("hex").slice(0, 24);
@@ -30588,11 +30581,11 @@ function resolveFramePorts(projectRoot, session, registryFile) {
   };
 }
 function liveSessions() {
-  return readLiveRegisteredSessions2();
+  return readLiveRegisteredSessions();
 }
 async function fetchEditorSession(port) {
   try {
-    const res = await fetch(`http://127.0.0.1:${port}/__editor/project`, {
+    const res = await sessionFetch3(`http://127.0.0.1:${port}/__editor/project`, {
       signal: AbortSignal.timeout(5e3)
     });
     if (!res.ok) return void 0;
@@ -30622,7 +30615,7 @@ async function fetchEditorSession(port) {
 }
 async function fetchSessionWorkbench(serverUrl) {
   try {
-    const res = await fetch(`${serverUrl}/__editor/state`, {
+    const res = await sessionFetch3(`${serverUrl}/__editor/state`, {
       signal: AbortSignal.timeout(3e3)
     });
     if (!res.ok) return null;
@@ -30657,7 +30650,7 @@ async function waitForSessionWorkbench(serverUrl) {
 }
 async function fetchEditorState(serverUrl) {
   try {
-    const res = await fetch(`${serverUrl}/__editor/state`, {
+    const res = await sessionFetch3(`${serverUrl}/__editor/state`, {
       signal: AbortSignal.timeout(3e3)
     });
     if (!res.ok) return EMPTY_EDITOR_STATE;
@@ -30671,7 +30664,8 @@ async function fetchEditorState(serverUrl) {
           commandListener: typeof tab["commandListener"] === "string" ? tab["commandListener"] : null,
           unresponsive: tab["unresponsive"] === true,
           route: typeof tab["route"] === "string" ? tab["route"] : null,
-          state: typeof tab["state"] === "string" ? tab["state"] : null
+          state: typeof tab["state"] === "string" ? tab["state"] : null,
+          recovery: parseRecovery(tab["recovery"])
         };
       })
     };
@@ -30679,20 +30673,30 @@ async function fetchEditorState(serverUrl) {
     return EMPTY_EDITOR_STATE;
   }
 }
+function parseRecovery(raw) {
+  if (raw === null || typeof raw !== "object") return null;
+  const record3 = raw;
+  return typeof record3["state"] === "string" && typeof record3["because"] === "string" ? { state: record3["state"], because: record3["because"] } : null;
+}
 var EMPTY_EDITOR_STATE = {
   editorsConnected: 0,
   lastIndexRequestAt: null,
   tabs: []
 };
 function commandReadyTabs(snapshot) {
-  return snapshot.tabs.filter((tab) => tab.commandListener === "ready").length;
+  return snapshot.tabs.filter((tab) => tab.commandListener === "ready" && tab.recovery?.state !== "reloading").length;
 }
 function unresponsiveTab(snapshot) {
-  return snapshot.tabs.find((tab) => tab.unresponsive) ?? null;
+  return snapshot.tabs.find(
+    (tab) => tab.unresponsive && tab.recovery?.state !== "reloading" || tab.recovery?.state === "unanswered" && tab.commandListener !== "ready"
+  ) ?? null;
+}
+function unansweredRecovery(snapshot) {
+  return snapshot.tabs.find((tab) => tab.recovery?.state === "unanswered" && tab.commandListener !== "ready")?.recovery?.because ?? null;
 }
 async function requestEditorTabEnsure(serverUrl, open) {
   try {
-    const res = await fetch(`${serverUrl}/__editor/tab/ensure`, {
+    const res = await sessionFetch3(`${serverUrl}/__editor/tab/ensure`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ open }),
@@ -30728,6 +30732,7 @@ async function waitForVerifiedEditorOpen(serverUrl, opts) {
   let browserArrived = false;
   let toldSlow = false;
   let lastProgressAt = openAttemptAt;
+  let recoveryCounted = false;
   for (; ; ) {
     const snapshot = await fetchEditorState(serverUrl);
     const ready = commandReadyTabs(snapshot);
@@ -30739,6 +30744,10 @@ async function waitForVerifiedEditorOpen(serverUrl, opts) {
       browserArrived = true;
     }
     const now = Date.now();
+    if (!recoveryCounted && snapshot.tabs.some((tab) => tab.recovery !== null && tab.recovery.state !== "unanswered")) {
+      recoveryCounted = true;
+      totalDeadline = Math.max(totalDeadline, now + totalTimeoutMs - initialTimeoutMs);
+    }
     if (unresponsiveTab(snapshot) !== null) return { status: "stuck" };
     if (!browserArrived && now >= initialDeadline && !toldSlow && now < arrivalDeadline) {
       toldSlow = true;
@@ -30988,6 +30997,12 @@ async function reapRecordedWorkbenchServer(projectRoot, port) {
   rmSync(recordPath(projectRoot), { force: true });
   return true;
 }
+var CONNECTION_TOKEN_QUERY = "tkn";
+function withConnectionToken(pageUrl, token) {
+  const url3 = new URL(pageUrl);
+  url3.searchParams.set(CONNECTION_TOKEN_QUERY, token);
+  return url3.toString();
+}
 var VIEW_BUILD_USAGE = "view build [folder] --out <dir> --workbench <vscode-web dir>";
 async function viewBuild(...args) {
   const specifier = new URL("./view-build.js", import.meta.resolve("@volter/editor-core/launcher")).href;
@@ -31015,11 +31030,7 @@ async function launch(folder, launching, options = {}) {
     const serverUrl2 = `http://127.0.0.1:${verdict.session.port}`;
     const running = await waitForSessionWorkbench(serverUrl2);
     if (running.product !== launching.id) throw new Error(`This project is open in ${running.product}; close that session before opening ${launching.displayName}.`);
-    const state = await fetch(`${serverUrl2}/__editor/state`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json());
-    const pageUrl = state.workbenchUrl;
-    if (typeof pageUrl !== "string" || !pageUrl) {
-      throw new Error("The running editor did not report its workbench URL. Its server log names the page to open.");
-    }
+    const pageUrl = await sessionPageUrl(serverUrl2, launching.command);
     console.log(pageUrl);
     await refuseIncompatibleProject(serverUrl2, launching.command, !!options.noOpen);
     await ensureTab(serverUrl2, !!options.noOpen, pageUrl, launching.displayName);
@@ -31067,7 +31078,7 @@ async function launch(folder, launching, options = {}) {
     });
     if (outcome.status !== "ready") throw new Error(describeEditorBootFailure(outcome, { serverUrl, project, port, timeoutMs: DEFAULT_EDITOR_BOOT_TIMEOUT_MS, logPath, command: launching.command }));
     await waitForSessionWorkbench(serverUrl);
-    const pageUrl = workbenchUrl(proxyPort, project);
+    const pageUrl = await sessionPageUrl(serverUrl, launching.command);
     console.log(`${launching.displayName}: ${pageUrl}`);
     console.log(`Logs: ${logPath}`);
     await refuseIncompatibleProject(serverUrl, launching.command, !!options.noOpen);
@@ -31076,6 +31087,20 @@ async function launch(folder, launching, options = {}) {
     clearLaunch();
   }
 }
+async function sessionPageUrl(serverUrl, command) {
+  const token = registeredConnectionToken(Number(new URL(serverUrl).port));
+  if (token === null) {
+    throw new Error(
+      `The session at ${serverUrl} has no connection token in the session registry, so nothing can reach it. Run \`${command} close\` and \`${command} edit\` again.`
+    );
+  }
+  const state = await sessionFetch22(`${serverUrl}/__editor/state`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json());
+  const pageUrl = state.workbenchUrl;
+  if (typeof pageUrl !== "string" || !pageUrl) {
+    throw new Error("The running editor did not report its workbench URL. Its server log names the page to open.");
+  }
+  return withConnectionToken(pageUrl, token);
+}
 async function startSession(entry, project, logPath, env) {
   if (process.platform !== "win32") {
     const log = openSync(logPath, "a", 384);
@@ -31153,7 +31178,7 @@ async function prepareSession(folder, launching) {
 async function refuseIncompatibleProject(serverUrl, command, noOpen) {
   const read = async () => {
     try {
-      const response = await fetch(`${serverUrl}/__editor/state`, { signal: AbortSignal.timeout(5e3) });
+      const response = await sessionFetch22(`${serverUrl}/__editor/state`, { signal: AbortSignal.timeout(5e3) });
       if (!response.ok) return null;
       const refusal2 = (await response.json()).projectCompatibility;
       return refusal2 && typeof refusal2.error === "string" ? refusal2 : null;
@@ -31226,6 +31251,8 @@ ${refused.map((message) => `  ${message}`).join("\n")}`);
     throw new Error(`Editor page did not start:
 ${outcome.refused.map((message) => `  ${message}`).join("\n")}`);
   if (outcome.status !== "connected") {
+    const unanswered = outcome.status === "stuck" ? unansweredRecovery(await fetchEditorState(serverUrl)) : null;
+    if (unanswered !== null) throw new Error(`Editor page arrived but did not become ready: ${unanswered}.`);
     const said2 = outcome.status === "never-arrived" ? [] : await currentPageErrors(serverUrl);
     const safariAtEnd = outcome.status === "never-arrived" ? safari : "";
     throw new Error(
@@ -31239,7 +31266,7 @@ async function startupRefusals(serverUrl, since = 0) {
   if (state.tabs.length === 0 || state.tabs.some((tab) => tab.commandListener === "ready")) return [];
   if (!state.tabs.every((tab) => tab.route === "no-project")) return [];
   try {
-    const response = await fetch(new URL("/__editor/console?all=1", serverUrl), { signal: AbortSignal.timeout(3e3) });
+    const response = await sessionFetch22(new URL("/__editor/console?all=1", serverUrl), { signal: AbortSignal.timeout(3e3) });
     if (!response.ok) return [];
     const body = await response.json();
     const newest = body.entries.filter((entry) => entry.severity === "error" && entry.message.startsWith("Startup failed") && entry.lastAt >= since).sort((a, b) => b.lastAt - a.lastAt)[0];
@@ -31250,7 +31277,7 @@ async function startupRefusals(serverUrl, since = 0) {
 }
 async function currentPageErrors(serverUrl) {
   try {
-    const response = await fetch(new URL("/__editor/console?all=1", serverUrl), { signal: AbortSignal.timeout(3e3) });
+    const response = await sessionFetch22(new URL("/__editor/console?all=1", serverUrl), { signal: AbortSignal.timeout(3e3) });
     if (!response.ok) return [];
     const body = await response.json();
     if (!body.currentLoadId) return [];
@@ -31322,6 +31349,8 @@ var COMMON_TASKS = [
   ["Capture to a file", "const shot = await editor.captureEditorChrome({ region: 'play' }); (await import('node:fs')).writeFileSync('shot.png', Buffer.from(shot.base64, 'base64'))"],
   ["", "region 'document': the document as the person sees it, overlays included; 'play': the live Play frame and its UI"],
   ["Open a document", "return await editor.open('<document id>')"],
+  ["Find an asset to start from", "return await editor.assetLibrary.search({ source: 'local', type: 'model', q: '<words>' })"],
+  ["", "then editor.assetLibrary.files({ source, id }) and editor.assetLibrary.download({ source, id, name, url, format })"],
   ["Hold a key in Play", "return await editor.document.key('w', { code: 'KeyW', holdMs: 1500 })"],
   ["Read the running document's state", "return await editor.document.query('[aria-label]', { limit: 20 })"],
   ["", "the running document's DOM, its HUD included: show the state you need to read there (text or data-* attributes)"]
@@ -31343,14 +31372,16 @@ function formatSurface(command, bindings) {
   for (const [task, code] of COMMON_TASKS) lines.push(`  ${task.padEnd(width)}${task === "" ? "  " : ""}${code}`);
   return lines.join("\n");
 }
+var CONTROLLER_DISCONNECTED_MESSAGE = "The editor tab controlling this command disconnected before reporting a result.";
 var OPENER_STDERR_CAP_BYTES = 2048;
 var OPENER_EXIT_WATCH_TIMEOUT_MS = 2e4;
+var redact = (text2) => text2.replace(/(https?:\/\/[^\s?#'"]*)[?#][^\s'"]*/g, "$1");
 function spawnOpener(cmd, cmdArgs, fallback) {
   let child;
   try {
     child = spawn22(cmd, cmdArgs, { windowsHide: true, stdio: ["ignore", "ignore", "pipe"], detached: true });
   } catch (err) {
-    console.error(`volter: auto-open via ${cmd} failed: ${err.message}`);
+    console.error(redact(`volter: auto-open via ${cmd} failed: ${err.message}`));
     fallback?.();
     return;
   }
@@ -31364,13 +31395,13 @@ function spawnOpener(cmd, cmdArgs, fallback) {
     stderrBytes += slice.length;
   });
   child.on("error", (err) => {
-    console.error(`volter: auto-open via ${cmd} failed to launch: ${err.message}`);
+    console.error(redact(`volter: auto-open via ${cmd} failed to launch: ${err.message}`));
     fallback?.();
   });
   child.on("exit", (code) => {
     if (code !== null && code !== 0) {
       const stderr = Buffer.concat(stderrChunks).toString("utf8").trim();
-      console.error(`volter: auto-open via ${cmd} exited ${code}: ${stderr}`);
+      console.error(redact(`volter: auto-open via ${cmd} exited ${code}: ${stderr}`));
       fallback?.();
     }
   });
@@ -31413,6 +31444,11 @@ function macHttpsHandler(home) {
     return void 0;
   }
 }
+var POWERSHELL_SINGLE_QUOTES = /['\u2018-\u201b]/g;
+function powershellStart(url3) {
+  const command = `Start-Process '${url3.replace(POWERSHELL_SINGLE_QUOTES, (quote) => quote + quote)}'`;
+  return ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-EncodedCommand", Buffer.from(command, "utf16le").toString("base64")];
+}
 function openBrowserUrl(browserUrl, options) {
   if (process.platform === "darwin") {
     const background = options?.background === true ? ["-g"] : [];
@@ -31420,20 +31456,17 @@ function openBrowserUrl(browserUrl, options) {
     if (app) spawnOpener("open", [...background, "-a", app, browserUrl], () => spawnOpener("open", [...background, browserUrl]));
     else spawnOpener("open", [...background, browserUrl]);
   } else if (process.platform === "win32") {
-    spawnOpener("cmd", ["/c", "start", "", browserUrl]);
+    spawnOpener("powershell.exe", powershellStart(browserUrl));
   } else if (isWSL()) {
     const interop = process.env["WSL_INTEROP"];
     if (interop && !existsSync23(interop)) {
+      const page = new URL(browserUrl);
       console.error(
-        `[volter-editor] cannot open a browser from this shell \u2014 the WSL interop socket (${interop}) is gone, so Windows executables cannot launch. Open ${browserUrl} from any regular terminal or browser instead.`
+        `[volter-editor] cannot open a browser from this shell \u2014 the WSL interop socket (${interop}) is gone, so Windows executables cannot launch. Open ${page.origin}${page.pathname} (the full address its command printed) from any regular terminal or browser instead.`
       );
       return;
     }
-    spawnOpener(
-      "explorer.exe",
-      [browserUrl],
-      () => spawnOpener("powershell.exe", ["-NoProfile", "-Command", `Start-Process '${browserUrl}'`])
-    );
+    spawnOpener("explorer.exe", [browserUrl], () => spawnOpener("powershell.exe", powershellStart(browserUrl)));
   } else {
     spawnOpener("xdg-open", [browserUrl]);
   }
@@ -31737,7 +31770,7 @@ ${said2.map((message) => `  ${message}`).join("\n")}` : `; \`${command} console\
 var NO_PAGE_DEAD_END_MS = 1e4;
 async function currentLoadId(url3) {
   try {
-    const response = await fetch(new URL("/__editor/console?all=1", url3), { signal: AbortSignal.timeout(3e3) });
+    const response = await sessionFetch32(new URL("/__editor/console?all=1", url3), { signal: AbortSignal.timeout(3e3) });
     if (!response.ok) return null;
     const body = await response.json();
     return body.currentLoadId;
@@ -31885,9 +31918,9 @@ function jsonLayout(raw) {
 // node/project-upgrade.ts
 import { existsSync as existsSync10, lstatSync as lstatSync2, statSync as statSync4 } from "node:fs";
 import { readFile as readFile4, rename as rename2, rm as rm3, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname6, join as join10, resolve as resolve8 } from "node:path";
+import { dirname as dirname6, join as join10, resolve as resolve8, sep as sep4 } from "node:path";
 import { EDITOR_SESSION_DISCOVERY_TIMEOUT_MS, HttpSessionDiscovery } from "@volter/live/discovery";
-import { readLiveRegisteredSessions as readLiveRegisteredSessions3 } from "@volter/live/registry-format";
+import { readLiveRegisteredSessions as readLiveRegisteredSessions2 } from "@volter/live/registry-format";
 
 // ../project/src/semver.ts
 var EXACT_SEMVER = /^(\d+)\.(\d+)\.(\d+)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
@@ -31905,7 +31938,7 @@ function compareSemver(a, b) {
 }
 
 // node/project-upgrade.ts
-var UPGRADE_USAGE = "upgrade [version]    # move this project's @volter packages and its engine pin to one release (default: latest)";
+var UPGRADE_USAGE = "upgrade [version]    # move this project's @volter packages and its engine pin to one release (default: latest), and a std game's std to the pinned one";
 function declaredVersion(spec) {
   const bare = spec?.replace(/^[\^~=v]+/, "");
   return bare !== void 0 && EXACT_VERSION.test(bare) ? bare : null;
@@ -31987,9 +32020,9 @@ function npmView(spec) {
     });
   });
 }
-async function readRelease(product, requested) {
+async function readRelease(product, requested, own) {
   const running = JSON.parse(await readFile4(join10(product.dir, "package.json"), "utf8"));
-  if (requested === running.version) return { version: running.version, dependencies: running.dependencies ?? {} };
+  if (own || requested === running.version) return { version: running.version, dependencies: running.dependencies ?? {} };
   const spec = `${product.packageName}@${requested ?? "latest"}`;
   try {
     return await npmView(spec);
@@ -32010,7 +32043,7 @@ async function editorOpenOn(project) {
         return false;
       }
     };
-    const registered = readLiveRegisteredSessions3();
+    const registered = readLiveRegisteredSessions2();
     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);
@@ -32033,7 +32066,15 @@ async function upgradeProject(product, requested) {
   }
   const packagePath = join10(project, "package.json");
   if (!existsSync10(packagePath)) throw new Error(`${project} has no package.json to upgrade.`);
-  const release = await readRelease(product, requested);
+  const packageRaw = await readFile4(packagePath, "utf8");
+  const pkg = JSON.parse(packageRaw);
+  const declaredProduct = pkg.dependencies?.[product.packageName] ?? pkg.devDependencies?.[product.packageName];
+  const onCheckout = declaredProduct?.startsWith("link:") === true;
+  const running = checkoutRoot();
+  const linkedTo = onCheckout ? resolve8(project, declaredProduct.slice("link:".length)) : null;
+  if (linkedTo !== null && (requested !== void 0 || running === null || !linkedTo.startsWith(`${running}${sep4}`)))
+    throw new Error(`${project} is on the packages of a ${product.packageName} checkout (${declaredProduct}), which move with that checkout: run ${projectLine(product.command, "upgrade")} there, with no version, so the checkout's own ${product.command} runs it.`);
+  const release = await readRelease(product, requested, onCheckout);
   const engine = release.dependencies["@volter/editor-core"];
   const kit = release.dependencies["@volter/project"];
   if (!engine || !kit)
@@ -32041,8 +32082,6 @@ async function upgradeProject(product, requested) {
   const changed = [];
   const kept = [];
   const warnings = [];
-  const packageRaw = await readFile4(packagePath, "utf8");
-  const pkg = JSON.parse(packageRaw);
   const previousKit = pkg.devDependencies?.["@volter/project"] ?? pkg.dependencies?.["@volter/project"];
   const currentProduct = declaredVersion(pkg.dependencies?.[product.packageName] ?? pkg.devDependencies?.[product.packageName]);
   for (const section of ["peerDependencies", "optionalDependencies"]) {
@@ -32054,12 +32093,13 @@ async function upgradeProject(product, requested) {
     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 ${projectLine(product.command, "upgrade")} in each member that is a project`);
   }
+  if (onCheckout) kept.push(`package.json keeps its link: rows: they are the checkout's own packages, at ${product.packageName}@${release.version}`);
   let packagesChanged = false;
   for (const section of ["dependencies", "devDependencies"]) {
     const declared = pkg[section];
     if (!declared) continue;
     for (const [name, current] of Object.entries(declared)) {
-      if (!name.startsWith("@volter/")) continue;
+      if (!name.startsWith("@volter/") || current.startsWith("link:")) continue;
       const target = name === product.packageName ? release.version : release.dependencies[name] ?? (current === previousKit || kitVersion(current) !== null && kitVersion(current) === kitVersion(previousKit) ? kit : void 0);
       if (target === void 0) {
         kept.push(`package.json keeps ${name}@${current}: ${product.packageName}@${release.version} does not name it`);
@@ -32077,7 +32117,9 @@ async function upgradeProject(product, requested) {
   const pinned = manifest.engine?.["version"];
   const pinChanged = pinned !== engine;
   const backwards = currentProduct !== null ? compareSemver(release.version, currentProduct) === -1 ? `${product.packageName}@${currentProduct}` : null : typeof pinned === "string" && compareSemver(engine, pinned) === -1 ? `engine ${pinned}` : null;
-  if (backwards !== null) {
+  if (backwards !== null && onCheckout)
+    warnings.push(`This moves the engine pin BACKWARDS, from ${backwards} to the checkout's own engine ${engine}, the one its links run.`);
+  else 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: ${projectLine(product.command, `upgrade ${release.version}`)}.`
@@ -32097,23 +32139,38 @@ async function upgradeProject(product, requested) {
   })();
   const locks = packagesChanged && !linked ? (await Promise.all([join10(project, "package-lock.json"), join10(project, "node_modules", ".package-lock.json")].map(lockWithoutVolter))).filter((lock) => lock !== null) : [];
   if (locks.length > 0) changed.push("package-lock.json: its @volter rows dropped, so npm install resolves the new ones");
+  const stdGame = existsSync10(join10(project, "std.json"));
+  const packed = stdGame && existsSync10(join10(project, "std-packages"));
+  const std = packed && checkoutRoot() !== null ? pinnedStd("upgrade") : null;
+  if (packed && std === null)
+    kept.push("std-packages/ keeps its packs: this Cyclotron is installed from npm and carries no std to pack them from");
   await writeAll([
     ...packagesChanged ? [{ path: packagePath, content: jsonLayout(packageRaw)(pkg), original: packageRaw }] : [],
     ...pinChanged ? [{ path: manifestPath, content: jsonLayout(manifestRaw)(manifest), original: manifestRaw }] : [],
     ...locks
   ]);
+  if (std !== null) {
+    try {
+      await stdUpgrade(std, project);
+    } catch (error50) {
+      const written = changed.length > 0 ? ` These were written before it: ${changed.join("; ")}.` : "";
+      throw new Error(`std's own upgrade failed, and the game keeps its std packs: ${error50 instanceof Error ? error50.message : String(error50)}.${written}`);
+    }
+    changed.push(`std-packages/: std's packages packed again from the std this ${product.command} pins (std upgrade)`);
+  }
   for (const line of warnings) console.warn(`! ${line}`);
   console.log(changed.length > 0 ? `Upgraded ${project} to ${product.packageName}@${release.version} (engine ${engine}):` : `${project} is already on ${product.packageName}@${release.version} (engine ${engine}).`);
   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"];
+  const [npm, npx] = process.platform === "win32" ? [stdGame ? "pnpm.cmd" : "npm.cmd", "npx.cmd"] : [stdGame ? "pnpm" : "npm", "npx"];
+  const installs = packagesChanged || std !== null;
   if (changed.length === 0) {
     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;
   }
   console.log(`Next, in ${project}, one line at a time:`);
-  if (packagesChanged) {
+  if (installs) {
     if (await editorOpenOn(project))
       console.log(`  ${npx} --no-install ${product.command} close`);
     if (!linked) console.log(`  ${npm} install`);
@@ -32142,7 +32199,6 @@ try {
     "existing-session": { type: "boolean" },
     since: { type: "string" },
     kind: { type: "string" },
-    document: { type: "string" },
     json: { type: "boolean" },
     from: { type: "string" },
     to: { type: "string" },
@@ -32163,7 +32219,6 @@ try {
   for (const key of ["since", "kind"])
     if (values[key] !== void 0 && verb !== "play-log") throw new Error(`--${key} belongs to play-log.`);
   if (values.json !== void 0 && verb !== "play-log" && verb !== "sessions") throw new Error("--json belongs to play-log and sessions.");
-  if (values.document !== void 0 && verb !== "play-log" && verb !== "play") throw new Error("--document belongs to play-log and play.");
   for (const [owner, options2] of [["capture", CAPTURE_OPTIONS], ["camera", CAMERA_OPTIONS]])
     for (const key of Object.keys(options2))
       if (values[key] !== void 0 && verb !== owner && !(key === "out" && (verb === "view" || verb === "render-movie")) && !(key === "force" && verb === "export" && (positionals[1] === "component" || positionals[1] === "level"))) throw new Error(`--${key} belongs to ${owner}.`);
@@ -32199,7 +32254,7 @@ try {
   ${PRODUCT.command} open <path>
   ${PRODUCT.command} 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)), null, 2));
   } else if (verb === "chat") {
     console.log(JSON.stringify(await chat(positionals.slice(1)), null, 2));
   } else if (verb === "view") {