@volter/game-editor 0.5.67 → 0.5.69

package/dist-node/cli.js

@@ -72,7 +72,7 @@ var init_client = __esm({
        * the receipt window closing unanswered, a beating-but-dead tab, and no tab
        * present at all. The last four can fail in milliseconds.
        *
-       * A caller that converges by retrying (`vgai restart`) needs the distinction
+       * A caller that converges by retrying (the editor's `restart` command) needs the distinction
        * because a refusal the editor ANSWERED may go differently next time, while
        * a command the relay abandoned tells you nothing new on a second identical
        * attempt — and when the abandonment was a 120s budget, re-running it three
@@ -231,22 +231,22 @@ var init_client = __esm({
         return data;
       }
       // --- Play control ---
-      /** `opts.seed` (D15/T-D15.6, objection-4 fix) — `vgai play --seed <n>`'s
+      /** `opts.seed` (D15/T-D15.6, objection-4 fix) — the editor's `play --seed <n>` command's
        *  explicit config leg, relayed as `cmd['seed']`; `handleCommand`'s
        *  `'play'` case threads it into `enterPlayMode`'s highest-precedence seed
-       *  argument (beats manifest.determinism.defaultSeed/?vgai-seed=). Omitted,
+       *  argument (beats manifest.determinism.defaultSeed/?volter-seed=). Omitted,
        *  boot seeding falls back to that precedence unchanged.
        *
-       *  `opts.name` (`vgai play --name <text>`) — an OPTIONAL label for this run,
+       *  `opts.name` (the editor's `play --name <text>` command) — an OPTIONAL label for this run,
        *  relayed as `cmd['name']` and slugified server-side into the run's
        *  `logs/play-*.jsonl` filename and its session-journal line. Findability
        *  only: no registry, no uniqueness, no lookup verb — grep and `ls` are the
        *  query engine. Omitted, the filename keeps its exact unnamed shape. */
-      /*  `opts.record` (`vgai play --record <name>`) — NAMES this run's recording
+      /*  `opts.record` (the editor's `play --record <name>` command) — NAMES this run's recording
        *  file. It does not ENABLE recording: every relayed play records, with no
-       *  flag (see `@vgai/game`'s `src/play/play-recording.ts`). Omitted, the clip is named for
+       *  flag (see `@volter/game`'s `src/play/play-recording.ts`). Omitted, the clip is named for
        *  the durable Gameplay Session; named, it becomes an explicit keepsake in
-       *  `.vgai/recordings/<name>.webm`. */
+       *  `.volter/recordings/<name>.webm`. */
       async play(opts) {
         return this.command({
           type: "play",
@@ -347,9 +347,9 @@ var init_client = __esm({
         return { base64: data.base64, mimeType: data.mimeType };
       }
       /**
-       * Unit 4 (live-front-door wave) — capture the RUNNING GAME (`vgai
-       * screenshot`'s wire leg). Sends the SAME `bridge-screenshot` relay op
-       * `@vgai/live`'s `RelayTransport.screenshot` (and therefore
+       * Unit 4 (live-front-door wave) — capture the RUNNING GAME (the editor's
+       * `screenshot`'s wire leg). Sends the SAME `bridge-screenshot` relay op
+       * `@volter/live`'s `RelayTransport.screenshot` (and therefore
        * `game.screenshot()` on the relay path) already sends, so all three
        * surfaces composite the identical full game stack — canvas(es) plus the
        * HUD/react DOM layers — rather than any of them inventing a second,
@@ -367,8 +367,8 @@ var init_client = __esm({
        * refuses it with `BRIDGE_SCREENSHOT_STALE` rather than pass it off as
        * current. Setting this asks the relay to render exactly ONE deterministic
        * tick (`runTicks(1, {render:'last'})`) first — the same escape
-       * `@vgai/live`'s `RelayTransport.screenshot` has always used, which is why
-       * `vgai eval` could recover these frames while `vgai screenshot` could not.
+       * `@volter/live`'s `RelayTransport.screenshot` has always used, which is why
+       * the editor's `eval` command could recover these frames while the editor's `screenshot` command could not.
        * Off by default: a caller who does not ask must never be handed a frame
        * that only exists because the capture drove the game.
        */
@@ -453,8 +453,8 @@ var init_client = __esm({
             ...source,
             ...options
           },
-          // Photographing changes nothing, and this is the relay `vgai screenshot
-          // <module>` / `project.bake.preview` rides — the lane where a momentary
+          // Photographing changes nothing, and this is the relay the editor's `screenshot
+          // <module>` command and `project.bake.preview` ride — the lane where a momentary
           // transport failure cost a cold agent three probe modules.
           { retryTransport: true }
         );
@@ -468,7 +468,7 @@ var init_client = __esm({
         };
       }
       /**
-       * A project-defined labeled shot set (`vgai screenshot <target> --shots <set>`):
+       * A project-defined labeled shot set (the editor's `screenshot <target> --shots <set>` command):
        * the DEFINITION travels with the command (project data — see
        * `AssetPreviewShotSetDefinition`; the CLI resolves it from the registered
        * `project.<set>.previewShots` tool), and the editor's generic
@@ -497,8 +497,8 @@ var init_client = __esm({
         };
       }
       /**
-       * B8.4 — score the asset against a reference GLB (`vgai screenshot
-       * <model.glb> --compare <ref.glb>`): matched orthographic front + side silhouettes
+       * B8.4 — score the asset against a reference GLB (the editor's `screenshot
+       * <model.glb> --compare <ref.glb>` command): matched orthographic front + side silhouettes
        * (equal-height bounding-box framing, both yaw-normalized to face the
        * camera), per-view IoU numbers, and overlay evidence images. The
        * reference GLB's raw bytes travel base64 in the command; the editor
@@ -515,7 +515,7 @@ var init_client = __esm({
         return { width: data.width, height: data.height, views: data.views };
       }
       /**
-       * The STORY lane (`vgai screenshot <file>.stories.tsx`): every CSF export of
+       * The STORY lane (the editor's `screenshot <file>.stories.tsx` command): every CSF export of
        * one project story file rendered in the live session's DOM and captured
        * through the same composite leg {@link captureGame} uses, returned as
        * per-export images plus one variant sheet. `options.story` narrows to a
@@ -647,9 +647,9 @@ var init_client = __esm({
        * Run ONE command by id — the door to everything the command palette lists.
        *
        * Under the Code-OSS frame this is the workbench's own `ICommandService`, so
-       * any command id works: a view's `vgai.<view>.<verb>`, an editor action's
-       * `vgai.action.<id>`, or one of VS Code's own. Standalone `vgai edit` has no
-       * command service and answers the `vgai.<view>.<verb>` shape directly off
+       * any command id works: a view's `volter.<view>.<verb>`, an editor action's
+       * `volter.action.<id>`, or one of VS Code's own. Standalone the editor's `edit` command has no
+       * command service and answers the `volter.<view>.<verb>` shape directly off
        * the views registry, refusing anything else BY NAME.
        *
        * The result is whatever the command answered — a view verb's state, or
@@ -845,7 +845,7 @@ var init_client = __esm({
        * `blender-object-info`, `blender-screenshot-view`, `blender-read-file`,
        * `blender-write-file`, `blender-list-files`, `blender-start`,
        * `blender-status`): Blender runs in the editor tab's worker, and
-       * `vgai blender-mcp` is transport onto these. `blender-status` is the only
+       * `volter blender-mcp` is transport onto these. `blender-status` is the only
        * one that creates nothing — it answers whether this tab already has a
        * session, which is how a caller survives an editor restart.
        */
@@ -919,7 +919,7 @@ var init_client = __esm({
         return data.projects;
       }
       // --- Registered project tools ---
-      /** List tools explicitly registered in `package.json#vgai.tools`.
+      /** List tools explicitly registered in `package.json#volter.tools`.
        * The editor server loads callable metadata in Node; modules never enter the
        * editor browser merely because they were listed. */
       async listProjectTools() {
@@ -2034,7 +2034,7 @@ ${tool.description}` } : tool
   const defaults = blender_mcp_defaults_default;
   const mirror = new Mirror(project, [
     project,
-    ...(process.env["VGAI_BLENDER_MIRROR_ROOTS"] ?? "").split(":").filter((root) => root.startsWith("/"))
+    ...(process.env["VOLTER_BLENDER_MIRROR_ROOTS"] ?? "").split(":").filter((root) => root.startsWith("/"))
   ], `${command} blender-mcp`);
   const tab = new TabSession(project, ensureEditor);
   const server = new Server(
@@ -2246,7 +2246,7 @@ var init_blender_mcp = __esm({
       #origin = null;
       #port = null;
       /** A replay starts with a fresh model once; ordinary agent sessions persist. */
-      #freshSessionPending = Boolean(process.env["VGAI_BLENDER_FRESH_SESSION"]);
+      #freshSessionPending = Boolean(process.env["VOLTER_BLENDER_FRESH_SESSION"]);
       async client() {
         if (this.#client) return this.#client;
         if (!this.#connecting) {
@@ -2310,7 +2310,7 @@ import { fileURLToPath as fileURLToPath2 } from "node:url";
 var package_default = {
   name: "@volter/game-editor",
   author: "Volter AI, Inc.",
-  version: "0.5.67",
+  version: "0.5.69",
   publishConfig: {
     access: "public"
   },
@@ -2337,6 +2337,7 @@ var package_default = {
     "workbench",
     "template",
     "template-dotfiles",
+    "additions",
     "catalog",
     "starter",
     "BUNDLED_NOTICES"
@@ -2346,34 +2347,34 @@ var package_default = {
     "build:node": "node scripts/build-node.mjs",
     typecheck: "tsc -p tsconfig.node.json"
   },
-  vgai: {
+  volter: {
     product: {
       entry: "./src/index.ts",
       displayName: "Volter Game Editor",
       colorTheme: "dark",
       workbench: {
-        release: "game-editor-53c70370c14c-d9c0c8f0d344-darwin-arm64",
-        tarballSha256: "db26cbe669909e5dab61536a01f08d95b7de4b037f6607f40b52bea100194093"
+        release: "game-editor-f16dc165c0df-7829035e8e51-darwin-arm64",
+        tarballSha256: "5737029b2bfe64a22466ccf000e80056cf9cebfdc3650022a27fa990e037a421"
       }
     }
   },
   dependencies: {
-    "@volter/editor-core": "0.5.67",
-    "@volter/editor-game": "0.5.67",
-    "@volter/editor-react": "0.5.67",
-    "@volter/editor-threejs": "0.5.67",
-    "@volter/editor-xstate": "0.5.67",
-    "@volter/editor-blender": "0.1.10",
-    "@volter/dawproject": "0.5.67",
-    "@volter/editor-dawproject": "0.5.67",
-    "@volter/blender-engine": "0.1.9",
-    "@volter/editor-project": "0.5.67",
-    "@volter/editor-sdk": "0.5.67",
-    "@volter/editor-live": "0.5.67",
-    "@volter/game-live": "0.5.67",
+    "@volter/editor-core": "0.5.69",
+    "@volter/editor-game": "0.5.69",
+    "@volter/editor-react": "0.5.69",
+    "@volter/editor-threejs": "0.5.69",
+    "@volter/editor-xstate": "0.5.69",
+    "@volter/editor-blender": "0.1.12",
+    "@volter/dawproject": "0.5.69",
+    "@volter/editor-dawproject": "0.5.69",
+    "@volter/blender-engine": "0.1.10",
+    "@volter/editor-project": "0.5.69",
+    "@volter/editor-sdk": "0.5.69",
+    "@volter/editor-live": "0.5.69",
+    "@volter/game-live": "0.5.69",
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@volter/game-runtime": "0.5.67",
-    "@volter/threejs-runtime": "0.5.67",
+    "@volter/game-runtime": "0.5.69",
+    "@volter/threejs-runtime": "0.5.69",
     undici: "7.29.1",
     typescript: "5.9.3",
     "@colyseus/schema": "^4.0.14",
@@ -2397,7 +2398,9 @@ var package_default = {
     vite: "^6.4.3",
     ztrack: "^1.5.5",
     "three-bvh-csg": "^0.0.18",
-    "three-mesh-bvh": "^0.9.12"
+    "three-mesh-bvh": "^0.9.12",
+    "@pixi/react": "8.0.5",
+    "pixi.js": "^8.6.0"
   },
   bin: {
     "volter-game-editor": "./dist-node/cli.js"
@@ -2410,7 +2413,7 @@ import { dirname as dirname4, join as join6, resolve as resolve4 } from "node:pa
 import { fileURLToPath } from "node:url";
 
 // node/scaffold/additions.ts
-var SCAFFOLD_ADDITIONS = ["three", "ui", "server", "blender", "studio"];
+var SCAFFOLD_ADDITIONS = ["three", "canvas", "ui", "server", "blender", "studio"];
 var ADDITION_REQUIRES = {
   studio: ["three"]
 };
@@ -2583,7 +2586,7 @@ const meta = {
   // states below render its presentational body with authored props.
   component: GameUI,
   render: (args) => <ReactGamePage {...args} />,
-  parameters: { vgai: { defaultStory: 'Ready' } },
+  parameters: { volter: { defaultStory: 'Ready' } },
   args: { lastInput: 'Ready', title: 'My Game' },
 } satisfies Meta<typeof ReactGamePage>;
 
@@ -2598,15 +2601,15 @@ export const LongTitle: Story = {
 `;
 var REACT_ONLY_MAIN_SOURCE = `/**
  * Standalone entry point: this game's own boot, in its own libraries. Every
- * \`dom\` root \`vgai.project.json\` declares renders its entry's default export
+ * \`dom\` root \`volter.project.json\` declares renders its entry's default export
  * with react-dom, in one layer of \`#game-canvas\` per root, stacked by
  * \`zOrder\`. The editor mounts the same entries itself.
  */
 
 import { type ComponentType, createElement } from 'react';
 import { createRoot } from 'react-dom/client';
-import { manifestEntryModules } from 'virtual:vgai-manifest-entries';
-import manifest from '../vgai.project.json';
+import { manifestEntryModules } from 'virtual:volter-manifest-entries';
+import manifest from '../volter.project.json';
 
 interface DeclaredRoot {
   readonly id: string;
@@ -2644,7 +2647,7 @@ var REACT_ONLY_FILES = {
 };
 function withEditorDeclaration(source, declaration2) {
   if (!source.includes("defineAdapter({"))
-    throw new Error("Starter vgai.adapter.ts must call defineAdapter({ ... }).");
+    throw new Error("Starter volter.adapter.ts must call defineAdapter({ ... }).");
   const look = [
     declaration2.style ? `, style: ${declaration2.style.name}` : "",
     declaration2.keymap ? `, keymap: ${declaration2.keymap.name}` : ""
@@ -2662,9 +2665,9 @@ function withEditorDeclaration(source, declaration2) {
   return `${imports}${source.replace("defineAdapter({", `defineAdapter({
 ${editor}`)}`;
 }
-var MODELS_AGENTS_CONTRACT = `# AGENTS.md \u2014 VGAI Models Project
+var MODELS_AGENTS_CONTRACT = `# AGENTS.md \u2014 VOLTER Models Project
 
-A standalone modeling project built with VGAI \u2014 Blender itself, compiled to
+A standalone modeling project built with VOLTER \u2014 Blender itself, compiled to
 WebAssembly and running headless in the editor tab's worker, over this
 project's own \`.blend\` files. Work here, not in the engine repo. The editor
 is the authoring and verification surface; nothing here plays.
@@ -2675,7 +2678,7 @@ is the authoring and verification surface; nothing here plays.
 | --- | --- |
 | Model, revise or add a model | \`src/models/<name>.blend\` \u2014 read \`src/models/cube.py\`'s docstring first |
 | Open the editor, look, or verify | \`.agents/skills/editor/SKILL.md\` |
-| Blender-style modeling craft | \`.agents/skills/vgai-3d-models/SKILL.md\` |
+| Blender-style modeling craft | \`.agents/skills/volter-3d-models/SKILL.md\` |
 
 \`.agents/\` is canonical; \`.claude/skills/\` and \`.github/skills/\` are
 generated projections (never edit); \`CLAUDE.md\` and
@@ -2691,7 +2694,7 @@ opens. The document does not run the script \u2014 you do, through the session's
 Blender:
 
 \`\`\`bash
-npm run --silent vgai -- blender-mcp    # the MCP transport onto the tab's Blender
+npm run --silent volter -- blender-mcp    # the MCP transport onto the tab's Blender
 \`\`\`
 
 Every call is ordinary bpy against the open document, and the session saves it
@@ -2702,33 +2705,33 @@ finder lists every \`.blend\` as a document. Coordinates are metres and Z is up
 ## The editor
 
 Workspaces: \`model\`, \`sculpt\`, \`texture\`, \`animate\`, \`design\`, \`look\`
-(\`npm run --silent vgai -- eval 'editor.workspace("sculpt")'\`; a wrong id
+(\`npm run --silent volter -- eval 'editor.workspace("sculpt")'\`; a wrong id
 refuses and names the list). The look and keymap are Blender's
 (\`@volter/editor-blender\` contributes them). There is no Game workspace and
-\`vgai play\` refuses: this project declares no roots.
+\`volter-game-editor play\` refuses: this project declares no roots.
 
 ## Verification contract \u2014 after every change
 
 1. \`npm run typecheck\` \u2014 the gate.
 2. Open the model's document and read the change through a door:
-   \`npm run --silent vgai -- eval 'editor.currentView()'\` names the open
-   document; \`npm run --silent vgai -- screenshot editor\` shows it; and
+   \`npm run --silent volter -- eval 'editor.currentView()'\` names the open
+   document; \`npm run --silent volter -- screenshot editor\` shows it; and
    \`get_scene_info\` over \`blender-mcp\` is what the engine itself says is in
    the file.
-3. \`npm run --silent vgai -- console\` silent \u2014 an unresolved entry is
+3. \`npm run --silent volter -- console\` silent \u2014 an unresolved entry is
    remaining work, never noise.
 
 ## Commands
 
 \\\`\\\`\\\`bash
 npm run dev                            # open/reuse this project's editor
-npm run --silent vgai -- status        # require connected: true
-npm run --silent vgai -- screenshot    # visible evidence
-npm run --silent vgai -- eval '<js>'   # THE door onto the editor
+npm run --silent volter -- status        # require connected: true
+npm run --silent volter -- screenshot    # visible evidence
+npm run --silent volter -- eval '<js>'   # THE door onto the editor
 npm run typecheck                      # THE gate
 \\\`\\\`\\\`
 
-Always \`npm run --silent vgai -- <verb>\`, never a bare \`vgai\` (a global one may
+Always \`npm run --silent volter -- <verb>\`, never a bare \`volter\` (a global one may
 belong to another checkout).
 `;
 function withAgentsContract(source, additions) {
@@ -2799,7 +2802,7 @@ function assertScaffoldComposition(value, source, product) {
   if (!packages.includes(product))
     fail(
       source,
-      `compose() returned editorPackages ${JSON.stringify(packages)}, which omits ${product}. A scaffolded project declares the product it opens in \u2014 that declaration is how \`vgai edit\` finds the editor to run (ARCHITECTURE-CORE \xA7The target shape, rule 4).`
+      `compose() returned editorPackages ${JSON.stringify(packages)}, which omits ${product}. A scaffolded project declares the product it opens in \u2014 that declaration is how \`volter edit\` finds the editor to run (ARCHITECTURE-CORE \xA7The target shape, rule 4).`
     );
   const editor = composition?.editor;
   if (typeof editor?.inspector !== "string" || editor.inspector.length === 0)
@@ -2834,7 +2837,7 @@ import {
 } from "node:fs";
 import { basename, dirname as dirname2, join as join4, relative as relative3, resolve as resolve2 } from "node:path";
 
-// ../../../editor-game/node_modules/jsonc-parser/lib/esm/impl/scanner.js
+// ../../node_modules/jsonc-parser/lib/esm/impl/scanner.js
 function createScanner(text2, ignoreTrivia = false) {
   const len = text2.length;
   let pos = 0, value = "", tokenOffset = 0, token = 16, lineNumber = 0, lineStartOffset = 0, tokenLineStartOffset = 0, prevTokenLineStartOffset = 0, scanError = 0;
@@ -3255,7 +3258,7 @@ var CharacterCodes;
   CharacterCodes2[CharacterCodes2["tab"] = 9] = "tab";
 })(CharacterCodes || (CharacterCodes = {}));
 
-// ../../../editor-game/node_modules/jsonc-parser/lib/esm/impl/string-intern.js
+// ../../node_modules/jsonc-parser/lib/esm/impl/string-intern.js
 var cachedSpaces = new Array(20).fill(0).map((_, index) => {
   return " ".repeat(index);
 });
@@ -3285,7 +3288,7 @@ var cachedBreakLinesWithSpaces = {
   }
 };
 
-// ../../../editor-game/node_modules/jsonc-parser/lib/esm/impl/parser.js
+// ../../node_modules/jsonc-parser/lib/esm/impl/parser.js
 var ParseOptions;
 (function(ParseOptions2) {
   ParseOptions2.DEFAULT = {
@@ -3641,7 +3644,7 @@ function visit(text2, visitor, options = ParseOptions.DEFAULT) {
   return true;
 }
 
-// ../../../editor-game/node_modules/jsonc-parser/lib/esm/main.js
+// ../../node_modules/jsonc-parser/lib/esm/main.js
 var ScanError;
 (function(ScanError2) {
   ScanError2[ScanError2["None"] = 0] = "None";
@@ -3735,8 +3738,8 @@ import { existsSync } from "node:fs";
 import { join } from "node:path";
 
 // ../editor-project/src/manifest/filename.ts
-var MANIFEST_FILENAME = "vgai.project.json";
-var REMOVED_MANIFEST_FILENAME = "vgai.game.json";
+var MANIFEST_FILENAME = "volter.project.json";
+var REMOVED_MANIFEST_FILENAME = "volter.game.json";
 function removedManifestFilenameMessage(where) {
   return `${where}: found \`${REMOVED_MANIFEST_FILENAME}\` and no \`${MANIFEST_FILENAME}\`. \`${REMOVED_MANIFEST_FILENAME}\` was REMOVED (the legacy-removal doctrine, docs/ARCHITECTURE-CORE.md \xA7Vocabulary) \u2014 nothing reads it any more, and it is deliberately NOT read as a fallback, because a second accepted name is the defect.
 Fix: rename it \u2014 \`git mv ${REMOVED_MANIFEST_FILENAME} ${MANIFEST_FILENAME}\`. The contents are unchanged; only the filename moved.`;
@@ -3762,7 +3765,7 @@ import { execFileSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import { mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join as join2, relative, sep } from "node:path";
-var SCAFFOLD_BASELINE_RELATIVE_PATH = ".vgai/scaffold-baseline.json";
+var SCAFFOLD_BASELINE_RELATIVE_PATH = ".volter/scaffold-baseline.json";
 function readEngineSourceState(engineDir) {
   try {
     const sha = execFileSync("git", ["-C", engineDir, "rev-parse", "HEAD"], {
@@ -3804,7 +3807,7 @@ function buildScaffoldBaseline(targetDir, engineVersion, engineDir) {
 }
 function writeScaffoldBaseline(targetDir, engineVersion, engineDir) {
   const baseline = buildScaffoldBaseline(targetDir, engineVersion, engineDir);
-  mkdirSync(join2(targetDir, ".vgai"), { recursive: true });
+  mkdirSync(join2(targetDir, ".volter"), { recursive: true });
   writeFileSync(
     join2(targetDir, SCAFFOLD_BASELINE_RELATIVE_PATH),
     `${JSON.stringify(baseline, null, 2)}
@@ -3906,7 +3909,7 @@ ${indent}},`;
 }
 function mergeAdapterRegionIncludes(source, additions) {
   if (additions.length === 0) return { kind: "unchanged" };
-  const parsed = typescript().createSourceFile("vgai.adapter.ts", source, typescript().ScriptTarget.Latest, true);
+  const parsed = typescript().createSourceFile("volter.adapter.ts", source, typescript().ScriptTarget.Latest, true);
   const definition = definitionObject(parsed);
   if ("reason" in definition) return { kind: "unreadable", reason: definition.reason };
   const listed = propertyOf(definition.object, "regions");
@@ -3997,7 +4000,7 @@ function finderText(addition, quote) {
 }
 function mergeAdapterFinders(source, additions) {
   if (additions.length === 0) return { kind: "unchanged" };
-  const parsed = typescript().createSourceFile("vgai.adapter.ts", source, typescript().ScriptTarget.Latest, true);
+  const parsed = typescript().createSourceFile("volter.adapter.ts", source, typescript().ScriptTarget.Latest, true);
   const definition = definitionObject(parsed);
   if ("reason" in definition) return { kind: "unreadable", reason: definition.reason };
   const quote = quoteLike(source, void 0);
@@ -4058,7 +4061,7 @@ ${indentAt(source, array.getStart())}${source.slice(closing)}`;
 }
 
 // node/scaffold/catalog.ts
-var PROJECT_CATALOG_DIR = join3(".vgai", "catalog");
+var PROJECT_CATALOG_DIR = join3(".volter", "catalog");
 var CATALOG_SURFACES = ["three", "canvas", "dom"];
 var CAPABILITY_STAMP_FILENAME = "capability.json";
 function capabilityStampPath(entry) {
@@ -4077,7 +4080,7 @@ function stringArray(value, field, manifestPath) {
 var RENAMED_CAPABILITY_IDS = /* @__PURE__ */ new Map([["mesh", "blender"]]);
 function renamedCapabilityIdMessage(where, oldId, newId) {
   return `${where}: capability id \`${oldId}\` was RENAMED to \`${newId}\` (2026-09-19). Nothing reads \`${oldId}\` any more, and it is deliberately NOT mapped onto \`${newId}\`, because a second accepted name is the defect.
-Fix: in this project, rename the file \u2014 \`git mv .vgai/catalog/${oldId}.json .vgai/catalog/${newId}.json\` \u2014 and change its \`"id"\` to \`"${newId}"\`. If a stamp file names the old id, rename that too (\`src/tools/${oldId}.*\` -> \`src/tools/${newId}.*\`). Then \`vgai outdated\` will report against the current entry. Nothing else about the capability changed.`;
+Fix: in this project, rename the file \u2014 \`git mv .volter/catalog/${oldId}.json .volter/catalog/${newId}.json\` \u2014 and change its \`"id"\` to \`"${newId}"\`. If a stamp file names the old id, rename that too (\`src/tools/${oldId}.*\` -> \`src/tools/${newId}.*\`). Then \`volter-game-editor outdated\` will report against the current entry. Nothing else about the capability changed.`;
 }
 function readCatalogEntry(path) {
   const parsed = JSON.parse(readFileSync2(path, "utf8"));
@@ -4115,15 +4118,15 @@ function readCatalogEntry(path) {
       path
     );
     const scripts = readStringRecord(packageJson["scripts"], "scripts", path);
-    const vgaiTools = packageJson["vgaiTools"];
-    if (vgaiTools !== void 0 && (!Array.isArray(vgaiTools) || vgaiTools.some((entry) => typeof entry !== "string" && !isRecord(entry)))) {
-      throw new Error(`${path}: packageJson.vgaiTools must be an array of module paths`);
+    const volterTools = packageJson["volterTools"];
+    if (volterTools !== void 0 && (!Array.isArray(volterTools) || volterTools.some((entry) => typeof entry !== "string" && !isRecord(entry)))) {
+      throw new Error(`${path}: packageJson.volterTools must be an array of module paths`);
     }
     manifest.packageJson = {
       ...dependencies ? { dependencies } : {},
       ...devDependencies ? { devDependencies } : {},
       ...scripts ? { scripts } : {},
-      ...vgaiTools ? { vgaiTools } : {}
+      ...volterTools ? { volterTools } : {}
     };
   }
   const assetPacks = readAssetPacks(parsed["assetPacks"], path);
@@ -4438,29 +4441,29 @@ function planCapabilityPackageJson(originalBytes, manifests, label = "package.js
       resolveSpec
     );
     mergeStringDependencies(parsed, "scripts", patch.scripts, manifest.id, origins);
-    if (patch.vgaiTools) {
-      const vgai = parsed["vgai"] === void 0 ? {} : parsed["vgai"];
-      if (!isRecord(vgai)) throw new Error(`${label}: vgai must be an object`);
-      const currentTools = vgai["tools"] === void 0 ? [] : vgai["tools"];
+    if (patch.volterTools) {
+      const volter = parsed["volter"] === void 0 ? {} : parsed["volter"];
+      if (!isRecord(volter)) throw new Error(`${label}: volter must be an object`);
+      const currentTools = volter["tools"] === void 0 ? [] : volter["tools"];
       if (!Array.isArray(currentTools) || currentTools.some((tool) => typeof tool !== "string" && !isRecord(tool))) {
-        throw new Error(`${label}: vgai.tools must be an array of strings or objects`);
+        throw new Error(`${label}: volter.tools must be an array of strings or objects`);
       }
       const tools = currentTools.map(
         (tool) => typeof tool === "string" ? tool : { ...tool }
       );
-      for (const tool of patch.vgaiTools) {
+      for (const tool of patch.volterTools) {
         const id = toolIdentity(tool);
         const existing = tools.find((candidate) => toolIdentity(candidate) === id);
         if (existing && JSON.stringify(existing) !== JSON.stringify(tool)) {
           throw new Error(
-            `Capability ${manifest.id} conflicts with existing vgai.tools entry ${id}`
+            `Capability ${manifest.id} conflicts with existing volter.tools entry ${id}`
           );
         }
         if (!existing) tools.push(tool);
       }
       tools.sort((a, b) => toolIdentity(a).localeCompare(toolIdentity(b)));
-      vgai["tools"] = tools;
-      parsed["vgai"] = vgai;
+      volter["tools"] = tools;
+      parsed["volter"] = volter;
     }
   }
   return Buffer.from(`${JSON.stringify(parsed, null, 2)}
@@ -4516,7 +4519,7 @@ function mergedAssetManifest(projectDir, manifests) {
   );
   return { bytes, changed: !original.equals(bytes), declared: merged };
 }
-var ADAPTER_MODULE_FILE = "vgai.adapter.ts";
+var ADAPTER_MODULE_FILE = "volter.adapter.ts";
 function rootSurfaces(projectDir) {
   const surfaces = /* @__PURE__ */ new Map();
   let manifest;
@@ -4832,19 +4835,19 @@ function removeCapabilities(options) {
   if (existsSync2(packagePath)) {
     const original = readFileSync2(packagePath);
     const parsed = JSON.parse(original.toString("utf8"));
-    const vgai = parsed["vgai"];
-    if (isRecord(vgai) && Array.isArray(vgai["tools"])) {
+    const volter = parsed["volter"];
+    if (isRecord(volter) && Array.isArray(volter["tools"])) {
       const doomed = new Set(
         removing.flatMap(
-          (id) => (byId.get(id)?.packageJson?.vgaiTools ?? []).map((tool) => toolIdentity(tool))
+          (id) => (byId.get(id)?.packageJson?.volterTools ?? []).map((tool) => toolIdentity(tool))
         )
       );
-      const tools = vgai["tools"].filter(
+      const tools = volter["tools"].filter(
         (tool) => !doomed.has(toolIdentity(tool))
       );
       report.removedToolEntries = [...doomed].sort();
-      if (tools.length !== vgai["tools"].length) {
-        vgai["tools"] = tools;
+      if (tools.length !== volter["tools"].length) {
+        volter["tools"] = tools;
         if (!dryRun) {
           writeFileSync2(packagePath, Buffer.from(`${JSON.stringify(parsed, null, 2)}
 `));
@@ -5193,7 +5196,7 @@ Fix: create the project without --example, which scaffolds from the starter temp
         );
       }
       throw new Error(
-        `Unknown example id "${exampleId}": no vgai.project.json found at ${examplesSrcDir}`
+        `Unknown example id "${exampleId}": no volter.project.json found at ${examplesSrcDir}`
       );
     }
     mkdirSync3(targetDir, { recursive: true });
@@ -5241,7 +5244,7 @@ function assertDevelopmentLog(targetDir) {
   const path = join4(targetDir, PROJECT_DEVELOPMENT_LOG_RELATIVE_PATH);
   if (!existsSync3(path)) {
     throw new Error(
-      `Scaffolded project is missing ${PROJECT_DEVELOPMENT_LOG_RELATIVE_PATH}; restore it from the VGAI starter template`
+      `Scaffolded project is missing ${PROJECT_DEVELOPMENT_LOG_RELATIVE_PATH}; restore it from the VOLTER starter template`
     );
   }
 }
@@ -5266,7 +5269,7 @@ function trackedExampleFiles(exampleDir) {
   });
   if (result.status !== 0 || !result.stdout) return null;
   const paths = result.stdout.toString("utf8").split("\0").filter(Boolean);
-  return paths.includes("vgai.project.json") ? paths : null;
+  return paths.includes("volter.project.json") ? paths : null;
 }
 function copyTrackedExampleFiles(exampleDir, targetDir) {
   const paths = trackedExampleFiles(exampleDir);
@@ -5298,11 +5301,11 @@ function writeExampleReadme(targetDir, projectName, exampleId) {
     path,
     `# ${projectName}
 
-An editable standalone VGAI project scaffolded from the \`${exampleId ?? "example"}\` reference. Its gameplay source and assets were copied unchanged; this folder is now your project.
+An editable standalone VOLTER project scaffolded from the \`${exampleId ?? "example"}\` reference. Its gameplay source and assets were copied unchanged; this folder is now your project.
 
 \`\`\`bash
 npm run dev                 # open/reuse the visual editor
-npm run vgai -- play        # verify Play mode
+npm run volter -- play        # verify Play mode
 npm run typecheck
 npm run validate-manifest
 \`\`\`
@@ -5316,12 +5319,12 @@ function shouldCopyExamplePath(exampleDir, sourcePath) {
   const relativePath = relative3(exampleDir, sourcePath).replaceAll("\\", "/");
   const topLevel = relativePath.split("/")[0] ?? "";
   const segments = relativePath.split("/");
-  return !["node_modules", "dist", "logs", ".vgai", ".git", "package-lock.json"].includes(topLevel) && !segments.some((segment) => segment === ".env" || segment.startsWith(".env."));
+  return !["node_modules", "dist", "logs", ".volter", ".git", "package-lock.json"].includes(topLevel) && !segments.some((segment) => segment === ".env" || segment.startsWith(".env."));
 }
 function shouldCopyStarterPath(templateDir, sourcePath) {
   const relativePath = relative3(templateDir, sourcePath).replaceAll("\\", "/");
   const topLevel = relativePath.split("/")[0] ?? "";
-  return !["node_modules", "dist", "logs", ".vgai"].includes(topLevel);
+  return !["node_modules", "dist", "logs", ".volter"].includes(topLevel);
 }
 function rewritePackageJson(targetDir, slug, engineDir, monoRoot) {
   const pkgPath = join4(targetDir, "package.json");
@@ -5351,8 +5354,8 @@ function rewritePackageJson(targetDir, slug, engineDir, monoRoot) {
   }
   pkg.scripts ??= {};
   for (const [name, script] of Object.entries(pkg.scripts)) {
-    if (name !== "vgai" && script.startsWith("vgai ")) {
-      pkg.scripts[name] = `npm run vgai -- ${script.slice("vgai ".length)}`;
+    if (name !== "volter" && script.startsWith("volter ")) {
+      pkg.scripts[name] = `npm run volter -- ${script.slice("volter ".length)}`;
     }
   }
   pkg.devDependencies = pkg.devDependencies ?? {};
@@ -5388,7 +5391,7 @@ function engineDependencySpec(monoRoot, packageName, checkoutRelPath = "") {
   return `^${version}`;
 }
 function rewriteGameManifest(targetDir, name, slug, additions, monoRoot) {
-  const manifestPath = join4(targetDir, "vgai.project.json");
+  const manifestPath = join4(targetDir, "volter.project.json");
   const engineVersion = readInstalledVersion(monoRoot, "@volter/editor-project");
   let manifest;
   if (existsSync3(manifestPath)) {
@@ -5407,12 +5410,14 @@ function rewriteGameManifest(targetDir, name, slug, additions, monoRoot) {
   }
   manifest["name"] = name;
   manifest["manifestVersion"] = 2;
-  manifest["$schema"] = "./node_modules/@volter/editor-project/schemas/vgai-project.schema.json";
+  manifest["$schema"] = "./node_modules/@volter/editor-project/schemas/volter-project.schema.json";
   manifest["appId"] = `com.example.${slug.replace(/[^a-zA-Z0-9]/g, "")}`;
   if (additions) {
     const roots = [];
     if (additions.has("three"))
       roots.push({ id: "world", adapter: "three", entry: "src/world.tsx" });
+    if (additions.has("canvas"))
+      roots.push({ id: "scene2d", adapter: "canvas", entry: "src/scene2d.tsx" });
     if (additions.has("ui"))
       roots.push({ id: "ui", adapter: "dom", entry: "src/ui/game.tsx", zOrder: 0 });
     manifest["roots"] = roots;
@@ -5451,7 +5456,7 @@ function repinEngineAfterInstall(targetDir) {
   try {
     const baseline = JSON.parse(readFileSync3(baselinePath, "utf-8"));
     baseline.engineVersion = installed;
-    baseline.files["vgai.project.json"] = hashFile(manifestPath);
+    baseline.files["volter.project.json"] = hashFile(manifestPath);
     writeFileSync3(baselinePath, `${JSON.stringify(baseline, null, 2)}
 `, "utf-8");
   } catch {
@@ -5460,7 +5465,7 @@ function repinEngineAfterInstall(targetDir) {
 }
 var runNpmLink = (projectDir, packageDirs) => {
   const checkout = packageDirs[0] ? resolve2(packageDirs[0], "..", "..") : projectDir;
-  const prefix = join4(checkout, ".vgai", "npm-link-prefix");
+  const prefix = join4(checkout, ".volter", "npm-link-prefix");
   mkdirSync3(join4(prefix, "lib", "node_modules"), { recursive: true });
   mkdirSync3(join4(prefix, "bin"), { recursive: true });
   const result = spawnSync("npm", ["link", "--no-save", ...packageDirs], {
@@ -5474,7 +5479,7 @@ var runNpmLink = (projectDir, packageDirs) => {
     throw new Error(`npm link exited with code ${result.status ?? "unknown"}`);
   }
 };
-function checkoutVgaiPackageDirs(monoRoot) {
+function checkoutVolterPackageDirs(monoRoot) {
   const found = /* @__PURE__ */ new Map();
   const packagesDir = join4(monoRoot, "packages");
   let entries;
@@ -5500,7 +5505,7 @@ function checkoutVgaiPackageDirs(monoRoot) {
   }
   return found;
 }
-function declaredVgaiDependencies(projectDir) {
+function declaredVolterDependencies(projectDir) {
   let pkg;
   try {
     pkg = JSON.parse(readFileSync3(join4(projectDir, "package.json"), "utf-8"));
@@ -5512,9 +5517,9 @@ function declaredVgaiDependencies(projectDir) {
   ].filter((name) => name.startsWith("@volter/")).sort();
 }
 function planCheckoutLink(projectDir, monoRoot) {
-  const owned = checkoutVgaiPackageDirs(monoRoot);
+  const owned = checkoutVolterPackageDirs(monoRoot);
   if (owned.size === 0) return { packages: [], directories: [] };
-  const packages = declaredVgaiDependencies(projectDir).filter((name) => owned.has(name));
+  const packages = declaredVolterDependencies(projectDir).filter((name) => owned.has(name));
   return { packages, directories: packages.map((name) => owned.get(name)) };
 }
 function pointUnpublishedPackagesAtCheckout(projectDir, monoRoot) {
@@ -5540,7 +5545,7 @@ function pointUnpublishedPackagesAtCheckout(projectDir, monoRoot) {
   return rewritten;
 }
 function checkoutPackageSpec(name, monoRoot) {
-  const dir = checkoutVgaiPackageDirs(monoRoot).get(name);
+  const dir = checkoutVolterPackageDirs(monoRoot).get(name);
   return dir === void 0 ? null : `file:${dir}`;
 }
 var runPackageBuild = (packageDir) => {
@@ -5615,6 +5620,27 @@ function writeEditorPackages(targetDir, wanted) {
   );
   writeJson(pkgPath, pkg);
 }
+function writeNetworkedInput(targetDir) {
+  const inputPath = join4(targetDir, "src", "input.ts");
+  let input = readFileSync3(inputPath, "utf-8");
+  for (const [line, replacement] of NETWORKED_INPUT_LINES) {
+    if (!input.includes(line)) {
+      throw new Error(`The template input store no longer declares its actions as expected: ${line}`);
+    }
+    input = input.replace(line, replacement);
+  }
+  writeFileSync3(inputPath, input, "utf-8");
+}
+function applyCanvasAddition(targetDir, productDir) {
+  const additionDir = join4(productDir, "additions", "canvas");
+  cpSync(join4(additionDir, "src"), join4(targetDir, "src"), { recursive: true });
+  const own = JSON.parse(readFileSync3(join4(additionDir, "package.json"), "utf-8"));
+  const pkgPath = join4(targetDir, "package.json");
+  const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
+  pkg.dependencies = { ...pkg.dependencies };
+  for (const [name, spec] of Object.entries(own.dependencies ?? {})) pkg.dependencies[name] ??= spec;
+  writeJson(pkgPath, pkg);
+}
 function rewriteTemplateVariantFiles(targetDir, composition, additions, starterDir) {
   if (!additions.has("three") || !additions.has("studio")) {
     for (const relative7 of STUDIO_OWNED_PATHS) {
@@ -5623,15 +5649,7 @@ function rewriteTemplateVariantFiles(targetDir, composition, additions, starterD
   }
   writeEditorPackages(targetDir, composition.editorPackages);
   if (additions.has("server") && additions.has("three")) {
-    const inputPath = join4(targetDir, "src", "input.ts");
-    let input = readFileSync3(inputPath, "utf-8");
-    for (const [line, replacement] of NETWORKED_INPUT_LINES) {
-      if (!input.includes(line)) {
-        throw new Error(`The template input store no longer declares its actions as expected: ${line}`);
-      }
-      input = input.replace(line, replacement);
-    }
-    writeFileSync3(inputPath, input, "utf-8");
+    writeNetworkedInput(targetDir);
   } else {
     for (const relative7 of SERVER_CLIENT_PATHS) {
       rmSync2(join4(targetDir, relative7), { recursive: true, force: true });
@@ -5652,9 +5670,9 @@ function rewriteTemplateVariantFiles(targetDir, composition, additions, starterD
     for (const relative7 of THREE_OWNED_PATHS) {
       rmSync2(join4(targetDir, relative7), { recursive: true, force: true });
     }
-    writeFileSync3(join4(targetDir, "vgai.adapter.ts"), adapterSourceFor(additions), "utf-8");
+    writeFileSync3(join4(targetDir, "volter.adapter.ts"), adapterSourceFor(additions), "utf-8");
   } else {
-    const adapterPath = join4(targetDir, "vgai.adapter.ts");
+    const adapterPath = join4(targetDir, "volter.adapter.ts");
     const source = joinAdditionFinders(readFileSync3(adapterPath, "utf-8"), additions);
     writeFileSync3(adapterPath, source, "utf-8");
   }
@@ -5711,7 +5729,7 @@ function rewriteTsconfig(targetDir, engineRelPath, editorRelPath) {
       ])
     ),
     // `@volter/editor-blender`'s two VALUE exports — the look and the layout a models
-    // project's `vgai.adapter.ts` imports. Spelled entry by entry rather than
+    // project's `volter.adapter.ts` imports. Spelled entry by entry rather than
     // as a wildcard because the package's `exports` names them individually;
     // both entries are inert for a project that never declares the package.
     "@volter/editor-blender/looks": ["node_modules/@volter/editor-blender/src/looks.ts"],
@@ -5809,7 +5827,8 @@ function scaffoldProject(opts) {
       additions,
       resolveScaffoldStarterDir(productDir)
     );
-    const adapterPath = join4(targetDir, "vgai.adapter.ts");
+    if (additions.has("canvas")) applyCanvasAddition(targetDir, productDir);
+    const adapterPath = join4(targetDir, "volter.adapter.ts");
     writeFileSync3(
       adapterPath,
       withEditorDeclaration(readFileSync3(adapterPath, "utf-8"), composition.editor),
@@ -5821,6 +5840,8 @@ function scaffoldProject(opts) {
       withAgentsContract(readFileSync3(agentsPath, "utf-8"), additions),
       "utf-8"
     );
+  } else if (exampleId === void 0 && existsSync3(join4(targetDir, "src", "net"))) {
+    writeNetworkedInput(targetDir);
   }
   rewriteTsconfig(targetDir, engineRelPath, editorRelPath);
   rewriteViteConfig(targetDir);
@@ -5956,7 +5977,7 @@ function initGitRepo(targetDir, projectName) {
       notice: "Skipped git init \u2014 the project is already inside a git work tree."
     };
   }
-  const authorFallback = hasCommitterIdentity(targetDir) ? [] : ["-c", "user.name=vgai", "-c", "user.email=scaffold@vgai"];
+  const authorFallback = hasCommitterIdentity(targetDir) ? [] : ["-c", "user.name=volter", "-c", "user.email=scaffold@volter"];
   const steps = [
     { label: "git init", args: ["init", "--quiet"] },
     { label: "git add", args: ["add", "-A"] },
@@ -5995,13 +6016,15 @@ var presets = {
     // silent console the agent contract requires; they are an author's TODO
     // from the moment the author ASKS for those panels (`--with studio`, or
     // `--template full`).
-    game: { additions: ["three", "server", "blender"] },
+    // A game's UI is React DOM: its HUD is the `ui` root over the world. A `canvas` (Pixi) root
+    // is 2D game rendering, never the UI layer.
+    game: { additions: ["three", "ui", "server", "blender"] },
     /** A 3D world and its models: the smallest thing that plays. */
     prototype: { additions: ["three", "blender"] },
     // EVERY addition in one project — the composition acceptance made
     // permanent. Check it against `SCAFFOLD_ADDITIONS` (./scaffold/additions.ts)
     // when the scaffolder grows one.
-    full: { additions: ["three", "ui", "server", "blender", "studio"] },
+    full: { additions: ["three", "canvas", "ui", "server", "blender", "studio"] },
     /** The design skew: a React root and no 3D world. */
     website: { additions: ["ui"] },
     /** Nothing but the project — the shape an author adds to. */
@@ -6012,15 +6035,16 @@ var presets = {
   examples: true,
   compose(additions) {
     const three = additions.has("three");
+    const world = three || additions.has("canvas");
     const studio = additions.has("studio");
     const layouts = "@volter/editor-sdk/layouts";
-    const design = additions.has("ui") && !three;
+    const design = additions.has("ui") && !world;
     return {
-      // THE PRODUCT THIS PROJECT OPENS IN, and the 3D lane beside it:
-      // `@volter/editor-game` is the 3D world's lane, and a project with no 3D
-      // root has nothing for Play, the Game workspace or the instruments over
-      // a running game to run.
-      editorPackages: [PRODUCT2, ...three ? ["@volter/editor-game"] : []],
+      // THE PRODUCT THIS PROJECT OPENS IN, and the game lane beside it:
+      // `@volter/editor-game` is the lane of a game world (3D, or a 2D scene), and
+      // a project with no world has nothing for Play, the Game workspace or the
+      // instruments over a running game to run.
+      editorPackages: [PRODUCT2, ...world ? ["@volter/editor-game"] : []],
       editor: {
         layout: { name: design ? "DesignLayout" : studio ? "StudioLayout" : "GameLayout", from: layouts },
         inspector: studio ? "column" : "card"
@@ -6158,7 +6182,7 @@ function resolveWorktreeIdentity(projectRoot) {
   };
 }
 
-// ../editor-core/dist/server/chunk-SAN4B5DO.js
+// ../editor-core/dist/server/chunk-C7HWTZ6G.js
 import {
   mkdirSync as mkdirSync5,
   readdirSync as readdirSync4,
@@ -6170,7 +6194,7 @@ import {
 import { homedir as homedir2 } from "node:os";
 import { join as join7, resolve as resolve6 } from "node:path";
 import { setTimeout as delay } from "node:timers/promises";
-var EDITOR_SESSIONS_REGISTRY_FILE = join7(homedir2(), ".vgai", "editor-sessions.json");
+var EDITOR_SESSIONS_REGISTRY_FILE = join7(homedir2(), ".volter", "editor-sessions.json");
 function isEditorSessionEntry(v) {
   if (typeof v !== "object" || v === null) return false;
   const s = v;
@@ -6208,7 +6232,7 @@ function readLiveRegisteredSessions() {
   }
 }
 function announceEditorLaunch(project) {
-  const directory = join7(project, ".vgai", "editor-launches");
+  const directory = join7(project, ".volter", "editor-launches");
   mkdirSync5(directory, { recursive: true });
   const file = join7(directory, `${process.pid}.json`);
   writeFileSync5(file, JSON.stringify({ pid: process.pid }));
@@ -6223,7 +6247,7 @@ function announceEditorLaunch(project) {
   return clear;
 }
 function hasPendingEditorLaunch(project) {
-  const directory = join7(project, ".vgai", "editor-launches");
+  const directory = join7(project, ".volter", "editor-launches");
   try {
     return readdirSync4(directory).some((name) => {
       if (!/^\d+\.json$/.test(name)) return false;
@@ -6270,7 +6294,7 @@ function canonicalizeProjectPath(p) {
   }
 }
 
-// ../editor-core/dist/server/chunk-2QQ7TUPG.js
+// ../editor-core/dist/server/chunk-4EX3ZYKI.js
 import { createServer } from "node:net";
 import { execFileSync as execFileSync3 } from "node:child_process";
 async function loopbackPortFree(port) {
@@ -6621,7 +6645,7 @@ import { createHash as createHash22 } from "node:crypto";
 import { mkdirSync as mkdirSync22, readFileSync as readFileSync32, renameSync as renameSync2, rmdirSync, statSync as statSync3, writeFileSync as writeFileSync22 } from "node:fs";
 import { homedir as homedir22 } from "node:os";
 import { dirname as dirname22, join as join32 } from "node:path";
-var PRODUCT_DECLARATION_KEY = "vgai.product";
+var PRODUCT_DECLARATION_KEY = "volter.product";
 var PRODUCT_INSTALL_LINES = [
   "  npm install --save-dev @volter/model-editor",
   "  npm install --save-dev @volter/game-editor"
@@ -6636,7 +6660,7 @@ function readProductManifest(packageDir) {
   } catch {
     return null;
   }
-  const declared = manifest.vgai?.product;
+  const declared = manifest.volter?.product;
   if (declared === void 0) return null;
   const entry = declared.entry;
   if (typeof entry !== "string" || !entry.startsWith("./"))
@@ -6681,7 +6705,7 @@ function readProductManifest(packageDir) {
 }
 var SHA256_HEX = /^[0-9a-f]{64}$/;
 function readProductWorkbench(manifestPath, declared) {
-  const example = '  "vgai": { "product": { "workbench": { "release": "<product>-<fork sha 12>-<platform>", "tarballSha256": "<64 hex>" } } }\n`node scripts/workbench/build-release.mjs --publish --out <release dir>` cuts the release and prints exactly that block.';
+  const example = '  "volter": { "product": { "workbench": { "release": "<product>-<fork sha 12>-<platform>", "tarballSha256": "<64 hex>" } } }\n`node scripts/workbench/build-release.mjs --publish --out <release dir>` cuts the release and prints exactly that block.';
   if (typeof declared !== "object" || declared === null || Array.isArray(declared))
     throw new Error(
       `${manifestPath} declares ${PRODUCT_DECLARATION_KEY} but its "workbench" is ${JSON.stringify(declared)}. A product IS the Code-OSS workbench it was compiled into, so it names the published release those bytes are:
@@ -6711,7 +6735,7 @@ ${example}`
 function workbenchProductId(packageName) {
   return packageName.split("/").pop() ?? packageName;
 }
-function declaredVgaiPackages(projectRoot) {
+function declaredVolterPackages(projectRoot) {
   let manifest;
   try {
     manifest = JSON.parse(
@@ -6747,7 +6771,7 @@ function locatePackage(projectRoot, name) {
 }
 function declaredProducts(projectRoot) {
   const found = [];
-  for (const name of declaredVgaiPackages(projectRoot)) {
+  for (const name of declaredVolterPackages(projectRoot)) {
     const dir = locatePackage(projectRoot, name);
     if (dir === null) continue;
     const product = readProductManifest(dir);
@@ -6775,10 +6799,10 @@ are not building with:
 ` + products.map((product) => `  npm uninstall ${product.name}`).join("\n")
   );
 }
-var WORKBENCH_LOCATOR_PATH = ".vgai/workbench.json";
+var WORKBENCH_LOCATOR_PATH = ".volter/workbench.json";
 var RELEASE_RECORD = "BUILD.json";
 var SOURCES_LAUNCHER = join22("scripts", "code-server.sh");
-var OVERLAY_RECORD = ".vgai-overlay.json";
+var OVERLAY_RECORD = ".volter-overlay.json";
 function workbenchDeclarationExample(projectRoot) {
   return `${join22(projectRoot, WORKBENCH_LOCATOR_PATH)}:
   { "workbench": "<path to an extracted Code-OSS release, or to a fork checkout>" }`;
@@ -6819,7 +6843,7 @@ ${workbenchDeclarationExample(projectRoot)}`
   return isAbsolute3(declared) ? resolve7(declared) : resolve7(projectRoot, declared);
 }
 function writeWorkbenchDeclaration(projectRoot, workbenchDir) {
-  mkdirSync6(join22(projectRoot, ".vgai"), { recursive: true });
+  mkdirSync6(join22(projectRoot, ".volter"), { recursive: true });
   writeFileSync6(
     join22(projectRoot, WORKBENCH_LOCATOR_PATH),
     `${JSON.stringify({ workbench: resolve7(workbenchDir) }, null, 2)}
@@ -6844,7 +6868,7 @@ function resolveWorkbench(dir, expectedProduct) {
   if (expectedProduct !== void 0 && resolved.product !== expectedProduct) {
     throw new Error(
       `${root} is a ${resolved.product} workbench and this project opens in ${expectedProduct}. A workbench is built for ONE product \u2014 the editor kit and that product's workbench half are overlaid on the fork together \u2014 so its title, its look and its commands are the other product's, whatever this session serves into it. ${resolved.kind === "sources" ? `Re-overlay the checkout:
-  node scripts/workbench/dev.mjs --checkout ${root} --product ${expectedProduct}` : `Name a ${expectedProduct} release in .vgai/workbench.json, or cut one:
+  node scripts/workbench/dev.mjs --checkout ${root} --product ${expectedProduct}` : `Name a ${expectedProduct} release in .volter/workbench.json, or cut one:
   node scripts/workbench/build-release.mjs --product ${expectedProduct} --platform ${machinePlatform()} --checkout <fork dir>`}`
     );
   }
@@ -6902,7 +6926,7 @@ function resolveSources(dir) {
   const marker = join22(dir, OVERLAY_RECORD);
   if (!existsSync22(marker)) {
     throw new Error(
-      `${dir} is a Code-OSS checkout with no vgai overlay: ${OVERLAY_RECORD} is not there, so nothing of the editor is compiled into it and the workbench would come up as plain Code-OSS. Overlay and compile it:
+      `${dir} is a Code-OSS checkout with no volter overlay: ${OVERLAY_RECORD} is not there, so nothing of the editor is compiled into it and the workbench would come up as plain Code-OSS. Overlay and compile it:
   node scripts/workbench/dev.mjs --checkout ${dir} --product <model-editor|game-editor>`
     );
   }
@@ -6927,7 +6951,7 @@ function resolveSources(dir) {
   };
 }
 var RELEASE_REPO = "volter-ai/code-oss";
-var WORKBENCH_CACHE_ROOT = join22(homedir3(), ".vgai", "workbenches");
+var WORKBENCH_CACHE_ROOT = join22(homedir3(), ".volter", "workbenches");
 async function resolveWorkbenchForProject(options) {
   const { projectRoot, product, override, io } = options;
   const productId = workbenchProductId(product.name);
@@ -6977,7 +7001,7 @@ function apiHeaders(token) {
   return {
     Accept: "application/vnd.github+json",
     "X-GitHub-Api-Version": "2022-11-28",
-    "User-Agent": "vgai-workbench-locator",
+    "User-Agent": "volter-workbench-locator",
     ...token === null ? {} : { Authorization: `Bearer ${token}` }
   };
 }
@@ -7111,7 +7135,7 @@ var MIN_PORT = 1024;
 var MAX_PORT = 65535;
 var WORKTREE_EDITOR_PORT_MIN = 20200;
 var WORKTREE_EDITOR_PORT_MAX = 29999;
-var DEFAULT_PORT_REGISTRY = join32(homedir22(), ".vgai", "worktree-ports.json");
+var DEFAULT_PORT_REGISTRY = join32(homedir22(), ".volter", "worktree-ports.json");
 var LOCK_STALE_MS = 1e4;
 var lockWait = new Int32Array(new SharedArrayBuffer(4));
 function assertPort(value, source) {
@@ -7224,7 +7248,7 @@ function allocateWorktreeEditorPort(projectRoot, registryFile = DEFAULT_PORT_REG
 }
 function readEditorPortEnv(value) {
   if (value === void 0 || value.trim() === "") return void 0;
-  return assertPort(Number(value), "VGAI_EDITOR_PORT");
+  return assertPort(Number(value), "VOLTER_EDITOR_PORT");
 }
 function resolveEditorPortRequest(projectRoot, portOverride, envValue, registryFile) {
   if (portOverride !== void 0) {
@@ -7313,7 +7337,7 @@ async function launch(folder, launching, options = {}) {
   const project = realpathSync3(resolve22(folder));
   const product = resolveProductForProject(project);
   if (product.name !== launching.packageName) throw new Error(`${project} declares ${product.name}, not ${launching.displayName}.`);
-  const port = resolveEditorPortPreference(project, options.port, process.env["VGAI_EDITOR_PORT"]);
+  const port = resolveEditorPortPreference(project, options.port, process.env["VOLTER_EDITOR_PORT"]);
   await waitForPendingEditorLaunch(project);
   const sessions = await verifiedSessions(port);
   const verdict = classifyProjectSession(sessions, project);
@@ -7350,14 +7374,14 @@ async function launch(folder, launching, options = {}) {
       stdio: ["ignore", log, log],
       env: {
         ...process.env,
-        VGAI_CLI_ENTRY: resolve22(process.argv[1]),
-        VGAI_PROJECT: project,
-        VGAI_PRODUCT_DIR: product.dir,
-        VGAI_EDITOR_PORT: String(port),
-        VGAI_WORKBENCH_DIR: workbench.dir,
-        VGAI_FRAME_PORT: String(framePort),
-        VGAI_FRAME_PROXY_PORT: String(proxyPort),
-        ...options.noOpen ? { VGAI_NO_OPEN: "1" } : {}
+        VOLTER_CLI_ENTRY: resolve22(process.argv[1]),
+        VOLTER_PROJECT: project,
+        VOLTER_PRODUCT_DIR: product.dir,
+        VOLTER_EDITOR_PORT: String(port),
+        VOLTER_WORKBENCH_DIR: workbench.dir,
+        VOLTER_FRAME_PORT: String(framePort),
+        VOLTER_FRAME_PROXY_PORT: String(proxyPort),
+        ...options.noOpen ? { VOLTER_NO_OPEN: "1" } : {}
       }
     });
   } catch (error) {
@@ -7400,7 +7424,7 @@ async function prepareSession(folder, launching) {
     const child = spawn2(process.execPath, [entry], {
       cwd: project,
       stdio: ["ignore", "inherit", "inherit"],
-      env: { ...process.env, VGAI_PROJECT: project, VGAI_PRODUCT_DIR: product.dir, VGAI_NO_OPEN: "1", VGAI_PREPARE: "1" }
+      env: { ...process.env, VOLTER_PROJECT: project, VOLTER_PRODUCT_DIR: product.dir, VOLTER_NO_OPEN: "1", VOLTER_PREPARE: "1" }
     });
     child.once("error", fail2);
     child.once("exit", done);
@@ -7417,10 +7441,29 @@ async function ensureTab(serverUrl, noOpen) {
     openAttemptAt,
     onProgress: (ms) => console.log(`Waiting for the editor page (${Math.round(ms / 1e3)}s)\u2026`)
   });
-  if (outcome.status !== "connected") throw new Error(`Editor page ${outcome.status === "never-arrived" ? "did not arrive" : "arrived but did not become ready"}; open the printed workbench URL and inspect the session log.`);
+  if (outcome.status !== "connected") {
+    const said = outcome.status === "never-arrived" ? [] : await currentPageErrors(serverUrl);
+    throw new Error(
+      `Editor page ${outcome.status === "never-arrived" ? "did not arrive" : "arrived but did not become ready"}` + (said.length > 0 ? `:
+${said.map((message) => `  ${message}`).join("\n")}` : "; open the printed workbench URL and inspect the session log.")
+    );
+  }
+}
+async function currentPageErrors(serverUrl) {
+  try {
+    const response = await fetch(new URL("/__editor/console?all=1", serverUrl), { signal: AbortSignal.timeout(3e3) });
+    if (!response.ok) return [];
+    const body = await response.json();
+    if (!body.currentLoadId) return [];
+    return (body.entries ?? []).filter(
+      (entry) => entry.severity === "error" && typeof entry.message === "string" && entry.lastLoadId === body.currentLoadId
+    ).map((entry) => entry.message.split("\n")[0]);
+  } catch {
+    return [];
+  }
 }
 
-// ../editor-core/dist/server/chunk-BH4IOORU.js
+// ../editor-core/dist/server/chunk-RWQATMGM.js
 import { Agent, fetch as nodeFetch } from "undici";
 function createDispatcher(timeoutMs) {
   return new Agent({ headersTimeout: timeoutMs, bodyTimeout: timeoutMs });
@@ -7447,7 +7490,7 @@ var EditorCommandError = class extends Error {
    * the receipt window closing unanswered, a beating-but-dead tab, and no tab
    * present at all. The last four can fail in milliseconds.
    *
-   * A caller that converges by retrying (`vgai restart`) needs the distinction
+   * A caller that converges by retrying (the editor's `restart` command) needs the distinction
    * because a refusal the editor ANSWERED may go differently next time, while
    * a command the relay abandoned tells you nothing new on a second identical
    * attempt — and when the abandonment was a 120s budget, re-running it three
@@ -7625,22 +7668,22 @@ var EditorClient = class {
     return data;
   }
   // --- Play control ---
-  /** `opts.seed` (D15/T-D15.6, objection-4 fix) — `vgai play --seed <n>`'s
+  /** `opts.seed` (D15/T-D15.6, objection-4 fix) — the editor's `play --seed <n>` command's
    *  explicit config leg, relayed as `cmd['seed']`; `handleCommand`'s
    *  `'play'` case threads it into `enterPlayMode`'s highest-precedence seed
-   *  argument (beats manifest.determinism.defaultSeed/?vgai-seed=). Omitted,
+   *  argument (beats manifest.determinism.defaultSeed/?volter-seed=). Omitted,
    *  boot seeding falls back to that precedence unchanged.
    *
-   *  `opts.name` (`vgai play --name <text>`) — an OPTIONAL label for this run,
+   *  `opts.name` (the editor's `play --name <text>` command) — an OPTIONAL label for this run,
    *  relayed as `cmd['name']` and slugified server-side into the run's
    *  `logs/play-*.jsonl` filename and its session-journal line. Findability
    *  only: no registry, no uniqueness, no lookup verb — grep and `ls` are the
    *  query engine. Omitted, the filename keeps its exact unnamed shape. */
-  /*  `opts.record` (`vgai play --record <name>`) — NAMES this run's recording
+  /*  `opts.record` (the editor's `play --record <name>` command) — NAMES this run's recording
    *  file. It does not ENABLE recording: every relayed play records, with no
-   *  flag (see `@vgai/game`'s `src/play/play-recording.ts`). Omitted, the clip is named for
+   *  flag (see `@volter/game`'s `src/play/play-recording.ts`). Omitted, the clip is named for
    *  the durable Gameplay Session; named, it becomes an explicit keepsake in
-   *  `.vgai/recordings/<name>.webm`. */
+   *  `.volter/recordings/<name>.webm`. */
   async play(opts) {
     return this.command({
       type: "play",
@@ -7741,9 +7784,9 @@ var EditorClient = class {
     return { base64: data.base64, mimeType: data.mimeType };
   }
   /**
-   * Unit 4 (live-front-door wave) — capture the RUNNING GAME (`vgai
-   * screenshot`'s wire leg). Sends the SAME `bridge-screenshot` relay op
-   * `@vgai/live`'s `RelayTransport.screenshot` (and therefore
+   * Unit 4 (live-front-door wave) — capture the RUNNING GAME (the editor's
+   * `screenshot`'s wire leg). Sends the SAME `bridge-screenshot` relay op
+   * `@volter/live`'s `RelayTransport.screenshot` (and therefore
    * `game.screenshot()` on the relay path) already sends, so all three
    * surfaces composite the identical full game stack — canvas(es) plus the
    * HUD/react DOM layers — rather than any of them inventing a second,
@@ -7761,8 +7804,8 @@ var EditorClient = class {
    * refuses it with `BRIDGE_SCREENSHOT_STALE` rather than pass it off as
    * current. Setting this asks the relay to render exactly ONE deterministic
    * tick (`runTicks(1, {render:'last'})`) first — the same escape
-   * `@vgai/live`'s `RelayTransport.screenshot` has always used, which is why
-   * `vgai eval` could recover these frames while `vgai screenshot` could not.
+   * `@volter/live`'s `RelayTransport.screenshot` has always used, which is why
+   * the editor's `eval` command could recover these frames while the editor's `screenshot` command could not.
    * Off by default: a caller who does not ask must never be handed a frame
    * that only exists because the capture drove the game.
    */
@@ -7847,8 +7890,8 @@ var EditorClient = class {
         ...source,
         ...options
       },
-      // Photographing changes nothing, and this is the relay `vgai screenshot
-      // <module>` / `project.bake.preview` rides — the lane where a momentary
+      // Photographing changes nothing, and this is the relay the editor's `screenshot
+      // <module>` command and `project.bake.preview` ride — the lane where a momentary
       // transport failure cost a cold agent three probe modules.
       { retryTransport: true }
     );
@@ -7862,7 +7905,7 @@ var EditorClient = class {
     };
   }
   /**
-   * A project-defined labeled shot set (`vgai screenshot <target> --shots <set>`):
+   * A project-defined labeled shot set (the editor's `screenshot <target> --shots <set>` command):
    * the DEFINITION travels with the command (project data — see
    * `AssetPreviewShotSetDefinition`; the CLI resolves it from the registered
    * `project.<set>.previewShots` tool), and the editor's generic
@@ -7891,8 +7934,8 @@ var EditorClient = class {
     };
   }
   /**
-   * B8.4 — score the asset against a reference GLB (`vgai screenshot
-   * <model.glb> --compare <ref.glb>`): matched orthographic front + side silhouettes
+   * B8.4 — score the asset against a reference GLB (the editor's `screenshot
+   * <model.glb> --compare <ref.glb>` command): matched orthographic front + side silhouettes
    * (equal-height bounding-box framing, both yaw-normalized to face the
    * camera), per-view IoU numbers, and overlay evidence images. The
    * reference GLB's raw bytes travel base64 in the command; the editor
@@ -7909,7 +7952,7 @@ var EditorClient = class {
     return { width: data.width, height: data.height, views: data.views };
   }
   /**
-   * The STORY lane (`vgai screenshot <file>.stories.tsx`): every CSF export of
+   * The STORY lane (the editor's `screenshot <file>.stories.tsx` command): every CSF export of
    * one project story file rendered in the live session's DOM and captured
    * through the same composite leg {@link captureGame} uses, returned as
    * per-export images plus one variant sheet. `options.story` narrows to a
@@ -8041,9 +8084,9 @@ var EditorClient = class {
    * Run ONE command by id — the door to everything the command palette lists.
    *
    * Under the Code-OSS frame this is the workbench's own `ICommandService`, so
-   * any command id works: a view's `vgai.<view>.<verb>`, an editor action's
-   * `vgai.action.<id>`, or one of VS Code's own. Standalone `vgai edit` has no
-   * command service and answers the `vgai.<view>.<verb>` shape directly off
+   * any command id works: a view's `volter.<view>.<verb>`, an editor action's
+   * `volter.action.<id>`, or one of VS Code's own. Standalone the editor's `edit` command has no
+   * command service and answers the `volter.<view>.<verb>` shape directly off
    * the views registry, refusing anything else BY NAME.
    *
    * The result is whatever the command answered — a view verb's state, or
@@ -8239,7 +8282,7 @@ var EditorClient = class {
    * `blender-object-info`, `blender-screenshot-view`, `blender-read-file`,
    * `blender-write-file`, `blender-list-files`, `blender-start`,
    * `blender-status`): Blender runs in the editor tab's worker, and
-   * `vgai blender-mcp` is transport onto these. `blender-status` is the only
+   * `volter blender-mcp` is transport onto these. `blender-status` is the only
    * one that creates nothing — it answers whether this tab already has a
    * session, which is how a caller survives an editor restart.
    */
@@ -8313,7 +8356,7 @@ var EditorClient = class {
     return data.projects;
   }
   // --- Registered project tools ---
-  /** List tools explicitly registered in `package.json#vgai.tools`.
+  /** List tools explicitly registered in `package.json#volter.tools`.
    * The editor server loads callable metadata in Node; modules never enter the
    * editor browser merely because they were listed. */
   async listProjectTools() {
@@ -8586,11 +8629,11 @@ var RELAY_COMMANDS = {
   "close-asset-tab": alwaysRefresh(),
   "toggle-command-palette": noDerivedRefresh(),
   "toggle-console": noDerivedRefresh(),
-  // RELOAD THE EDITOR PAGE — `@vgai/live`'s `page.reload()`, the one page verb
+  // RELOAD THE EDITOR PAGE — `@volter/live`'s `page.reload()`, the one page verb
   // no step can express. It is the HOST's, not a package's: reloading the tab
-  // is what the tab is, and until walk 5 it was a `@vgai/game` command
+  // is what the tab is, and until walk 5 it was a `@volter/game` command
   // contribution, so a project without that package — every model project —
-  // answered `unknown command type "page-reload"` for a door `@vgai/live`
+  // answered `unknown command type "page-reload"` for a door `@volter/live`
   // documents as general (measured on a `model-editor create` scaffold,
   // 2026-09-21). The handler schedules the navigation for the next task so
   // this ack can travel before the channel is torn down; the client waits for
@@ -8624,7 +8667,7 @@ var RELAY_COMMANDS = {
   "set-inspection-field": alwaysRefresh(3e4),
   "remove-inspection-field": alwaysRefresh(3e4),
   // `extract-component` and `fork-component` left this table with their menus
-  // (`@vgai/game/contributions/component-verbs.command.ts`), which carries
+  // (`@volter/game/contributions/component-verbs.command.ts`), which carries
   // both budgets forward row for row.
   // The hierarchy context menu's structure verbs, over the control door. Every
   // one of them rewrites the game's own source, so they refresh like a write.
@@ -8640,7 +8683,7 @@ var RELAY_COMMANDS = {
   // `open` WAITS FOR THE PROJECT ADAPTER, for the same reason `play` waits on
   // the project's async `setup()`: on a cold session the adapter's scene table
   // is not there yet, and the door's whole job is to put a document on screen
-  // once it is. MEASURED on three cold `vgai edit` sessions over a
+  // once it is. MEASURED on three cold the editor's `edit` command sessions over a
   // `--template models` probe — 6025 / 6831 / 6474 ms from tab-connected to
   // the entry being listed, every one of them first refusing with
   // `SCENE_TABLE_UNAVAILABLE`. At the 5 s default the relay's timer won that
@@ -8663,7 +8706,7 @@ var RELAY_COMMANDS = {
   // Object3D document's orbit/turntable/frame, the viewport photograph and the
   // display and transform toggles — are its own command contribution
   // (`viewport-commands.ts`), each budget on its contributed row.
-  // The BLENDER lane's ten verbs are `@vgai/blender`'s
+  // The BLENDER lane's ten verbs are `@volter/blender`'s
   // `contributions/blender.command.ts` (WORK.md §The workbench, item D) —
   // each row's budget travelled with it, onto the contributed spec the page
   // reports to the server. `capture-story-variants` made the same move, to the
@@ -9080,7 +9123,7 @@ async function openProject(path) {
 }
 async function restart(command, options = {}) {
   const { client, url, projectRoot } = await sessionClient();
-  const noOpen = Boolean(process.env["VGAI_NO_OPEN"]);
+  const noOpen = Boolean(process.env["VOLTER_NO_OPEN"]);
   const before = await client.getState().catch(() => null);
   const divergence = staleAssetCacheWarning(before);
   const attached = before?.connected === true || (before?.editorsConnected ?? 0) > 0;
@@ -9207,7 +9250,7 @@ function parseLookFlags(options) {
 function screenshotPath(projectRoot, slug) {
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
   const safe = (slug ?? "").toLowerCase().replace(/[^a-z0-9-_]+/g, "-").replace(/^-+|-+$/g, "");
-  return join23(projectRoot, ".vgai", "screenshots", slug === void 0 ? `${stamp}.png` : `${safe === "" ? "look" : safe}-${stamp}`);
+  return join23(projectRoot, ".volter", "screenshots", slug === void 0 ? `${stamp}.png` : `${safe === "" ? "look" : safe}-${stamp}`);
 }
 async function screenshot(target, options) {
   const flags = parseLookFlags(options);
@@ -9341,7 +9384,7 @@ async function assetLabLook(client, source, flags, outputDirectory, defaultStage
 }
 async function moduleLook(client, projectRoot, modulePath, flags) {
   if (flags.shots !== void 0 || flags.compare !== void 0) {
-    throw new Error("--shots/--compare do not apply to a module target \u2014 the module lane builds bytes that stand nowhere and writes its fixed views under .vgai/screenshots/.");
+    throw new Error("--shots/--compare do not apply to a module target \u2014 the module lane builds bytes that stand nowhere and writes its fixed views under .volter/screenshots/.");
   }
   if (flags.width !== void 0 && flags.height !== void 0 && flags.width !== flags.height) {
     throw new Error("a module look renders square views \u2014 use --size, not --width/--height");
@@ -9354,7 +9397,7 @@ async function moduleLook(client, projectRoot, modulePath, flags) {
     ...size === void 0 ? {} : { size }
   });
   if (!outcome.ok) {
-    const missing = outcome.error?.code === "PROJECT_TOOL_NOT_FOUND" ? ` This project registers no ${toolName} tool (package.json#vgai.tools).` : "";
+    const missing = outcome.error?.code === "PROJECT_TOOL_NOT_FOUND" ? ` This project registers no ${toolName} tool (package.json#volter.tools).` : "";
     throw new Error(`${toolName} refused '${modulePath}' \u2014 ${outcome.error?.message ?? "unknown error"}.${missing}`);
   }
   const result = outcome.data;
@@ -9421,7 +9464,7 @@ function runCapabilityCommand(verb, ids, options) {
     }
     return;
   }
-  if (!projectDir) throw new Error("No vgai.project.json found. Run this command inside a game or pass --project.");
+  if (!projectDir) throw new Error("No volter.project.json found. Run this command inside a game or pass --project.");
   if (verb === "outdated") {
     if (ids.length > 0) throw new Error("Usage: volter-game-editor outdated [--project <path>] [--json]");
     const rows = capabilityVersions(projectDir, catalogDir);
@@ -9501,7 +9544,7 @@ ${report.writtenFiles.map((path) => `  ${path}`).join("\n")}`);
   }
   for (const unplaced of report.unplacedFinders) {
     const include = unplaced.finder.include ? `, include: [${unplaced.finder.include.map((glob) => `'${glob}'`).join(", ")}]` : "";
-    console.error(`Warning: ${unplaced.capability}'s documents are found by \`${unplaced.finder.finder}\`, but ${unplaced.reason}. Until vgai.adapter.ts selects it in \`documents.find\` (\`{ finder: '${unplaced.finder.finder}'${include} }\`), none of them opens.`);
+    console.error(`Warning: ${unplaced.capability}'s documents are found by \`${unplaced.finder.finder}\`, but ${unplaced.reason}. Until volter.adapter.ts selects it in \`documents.find\` (\`{ finder: '${unplaced.finder.finder}'${include} }\`), none of them opens.`);
   }
   for (const unplaced of report.unplacedRegions) {
     console.error(`Warning: ${unplaced.capability} renders on the \`${unplaced.surface}\` surface (${unplaced.globs.join(", ")}), but ${unplaced.reason}. The editor will report \`OID001\` for those files until this project declares them.`);
@@ -9524,12 +9567,12 @@ import {
 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
 import { isAbsolute as isAbsolute5, join as join11, resolve as resolve10 } from "node:path";
-var WORKBENCH_LOCATOR_PATH2 = ".vgai/workbench.json";
+var WORKBENCH_LOCATOR_PATH2 = ".volter/workbench.json";
 var RELEASE_RECORD2 = "BUILD.json";
 var SOURCES_LAUNCHER2 = join11("scripts", "code-server.sh");
-var OVERLAY_RECORD2 = ".vgai-overlay.json";
+var OVERLAY_RECORD2 = ".volter-overlay.json";
 function writeWorkbenchDeclaration2(projectRoot, workbenchDir) {
-  mkdirSync8(join11(projectRoot, ".vgai"), { recursive: true });
+  mkdirSync8(join11(projectRoot, ".volter"), { recursive: true });
   writeFileSync8(
     join11(projectRoot, WORKBENCH_LOCATOR_PATH2),
     `${JSON.stringify({ workbench: resolve10(workbenchDir) }, null, 2)}
@@ -9550,7 +9593,7 @@ function resolveWorkbench2(dir, expectedProduct) {
   if (expectedProduct !== void 0 && resolved.product !== expectedProduct) {
     throw new Error(
       `${root} is a ${resolved.product} workbench and this project opens in ${expectedProduct}. A workbench is built for ONE product \u2014 the editor kit and that product's workbench half are overlaid on the fork together \u2014 so its title, its look and its commands are the other product's, whatever this session serves into it. ${resolved.kind === "sources" ? `Re-overlay the checkout:
-  node scripts/workbench/dev.mjs --checkout ${root} --product ${expectedProduct}` : `Name a ${expectedProduct} release in .vgai/workbench.json, or cut one:
+  node scripts/workbench/dev.mjs --checkout ${root} --product ${expectedProduct}` : `Name a ${expectedProduct} release in .volter/workbench.json, or cut one:
   node scripts/workbench/build-release.mjs --product ${expectedProduct} --platform ${machinePlatform2()} --checkout <fork dir>`}`
     );
   }
@@ -9608,7 +9651,7 @@ function resolveSources2(dir) {
   const marker = join11(dir, OVERLAY_RECORD2);
   if (!existsSync9(marker)) {
     throw new Error(
-      `${dir} is a Code-OSS checkout with no vgai overlay: ${OVERLAY_RECORD2} is not there, so nothing of the editor is compiled into it and the workbench would come up as plain Code-OSS. Overlay and compile it:
+      `${dir} is a Code-OSS checkout with no volter overlay: ${OVERLAY_RECORD2} is not there, so nothing of the editor is compiled into it and the workbench would come up as plain Code-OSS. Overlay and compile it:
   node scripts/workbench/dev.mjs --checkout ${dir} --product <model-editor|game-editor>`
     );
   }
@@ -9632,10 +9675,10 @@ function resolveSources2(dir) {
     cwd: dir
   };
 }
-var WORKBENCH_CACHE_ROOT2 = join11(homedir4(), ".vgai", "workbenches");
+var WORKBENCH_CACHE_ROOT2 = join11(homedir4(), ".volter", "workbenches");
 
 // node/cli.ts
-var PRODUCT3 = { packageName: package_default.name, id: "game-editor", displayName: package_default.vgai.product.displayName, command: Object.keys(package_default.bin)[0] };
+var PRODUCT3 = { packageName: package_default.name, id: "game-editor", displayName: package_default.volter.product.displayName, command: Object.keys(package_default.bin)[0] };
 async function playVerb(verb) {
   const { connect: connect2 } = await import("@volter/editor-live");
   const { EditorClient: EditorClient3 } = await Promise.resolve().then(() => (init_client(), client_exports));