@volter/game-editor 0.5.113 → 0.5.114

package/dist-node/cli.js

@@ -102,6 +102,7 @@ var init_client = __esm({
     TRANSPORT_RETRY_DELAY_MS2 = 400;
     EditorClient2 = class {
       baseUrl;
+      fetchOverride;
       /**
        * The running game's debug plane — see {@link GameDebugDoor}. It rides the
        * SAME `/__editor/command` relay every other method here uses (relay cases
@@ -131,7 +132,7 @@ var init_client = __esm({
           );
         }
         const unknownOptions = Object.keys(opts ?? {}).filter(
-          (key) => key !== "url" && key !== "onEnvelope" && key !== "transport"
+          (key) => key !== "url" && key !== "onEnvelope" && key !== "transport" && key !== "fetch"
         );
         if (unknownOptions.length > 0) {
           throw new Error(
@@ -139,6 +140,7 @@ var init_client = __esm({
           );
         }
         this.baseUrl = (opts?.url ?? DEFAULT_URL2).replace(/\/$/, "");
+        this.fetchOverride = opts?.fetch;
         this.onEnvelope = opts?.onEnvelope ?? null;
         this.transport = opts?.transport ?? null;
         this.game = {
@@ -187,7 +189,7 @@ var init_client = __esm({
               signal: AbortSignal.timeout(deadlineMs)
             };
             commandDispatcher = deadlineMs > UNDICI_DEFAULT_HEADERS_TIMEOUT_MS2 ? createDispatcher2(deadlineMs + 3e4) : void 0;
-            res = await dispatchFetch2(url, init, commandDispatcher);
+            res = this.fetchOverride ? await this.fetchOverride(url, init) : await dispatchFetch2(url, init, commandDispatcher);
             break;
           } catch (error) {
             await commandDispatcher?.destroy?.();
@@ -202,7 +204,7 @@ var init_client = __esm({
             const { code, detail } = describeFetchFailure2(error);
             if (options?.retryTransport === true && !retried && RETRYABLE_TRANSPORT_CODES2.has(code)) {
               retried = true;
-              await new Promise((resolve12) => setTimeout(resolve12, TRANSPORT_RETRY_DELAY_MS2));
+              await new Promise((resolve13) => setTimeout(resolve13, TRANSPORT_RETRY_DELAY_MS2));
               continue;
             }
             throw new EditorCommandError2(
@@ -1098,7 +1100,7 @@ var init_client = __esm({
        */
       async httpFetch(url, init, dispatcher) {
         try {
-          return await dispatchFetch2(url, init, dispatcher);
+          return this.fetchOverride ? await this.fetchOverride(url, init) : await dispatchFetch2(url, init, dispatcher);
         } catch (error) {
           if (error?.name === "TimeoutError") throw error;
           const { code, detail } = describeFetchFailure2(error);
@@ -2012,8 +2014,8 @@ __export(blender_mcp_exports, {
   serveBlenderMcp: () => serveBlenderMcp
 });
 import { randomUUID } from "node:crypto";
-import { mkdirSync as mkdirSync9, readFileSync as readFileSync10, writeFileSync as writeFileSync9 } from "node:fs";
-import { dirname as dirname7, relative as relative6, sep as sep3 } from "node:path";
+import { mkdirSync as mkdirSync10, readFileSync as readFileSync12, writeFileSync as writeFileSync10 } from "node:fs";
+import { dirname as dirname8, relative as relative6, sep as sep3 } from "node:path";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -2204,15 +2206,15 @@ var init_blender_mcp = __esm({
             const bytes = Buffer.from(await spooled.arrayBuffer());
             if (shipped === null) {
               try {
-                if (readFileSync10(entry.path).equals(bytes)) {
+                if (readFileSync12(entry.path).equals(bytes)) {
                   this.#seen.set(entry.path, stamp);
                   continue;
                 }
               } catch (error) {
                 if (error.code !== "ENOENT") throw error;
               }
-              mkdirSync9(dirname7(entry.path), { recursive: true });
-              writeFileSync9(entry.path, bytes);
+              mkdirSync10(dirname8(entry.path), { recursive: true });
+              writeFileSync10(entry.path, bytes);
             } else {
               const query = new URLSearchParams({
                 path: shipped,
@@ -2307,15 +2309,15 @@ var init_blender_mcp = __esm({
 
 // node/cli.ts
 import { parseArgs } from "node:util";
-import { dirname as dirname8, resolve as resolve11 } from "node:path";
-import { spawn as spawn3 } from "node:child_process";
+import { dirname as dirname9, resolve as resolve12 } from "node:path";
+import { spawn as spawn4 } from "node:child_process";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // package.json
 var package_default = {
   name: "@volter/game-editor",
   author: "Volter AI, Inc.",
-  version: "0.5.113",
+  version: "0.5.114",
   publishConfig: {
     access: "public"
   },
@@ -2364,22 +2366,22 @@ var package_default = {
     }
   },
   dependencies: {
-    "@volter/editor-core": "0.5.113",
-    "@volter/editor-game": "0.5.113",
-    "@volter/editor-react": "0.5.113",
-    "@volter/editor-threejs": "0.5.113",
-    "@volter/editor-xstate": "0.5.113",
-    "@volter/editor-blender": "0.1.53",
-    "@volter/dawproject": "0.5.113",
-    "@volter/editor-dawproject": "0.5.113",
-    "@volter/blender-engine": "0.1.51",
-    "@volter/editor-project": "0.5.113",
-    "@volter/editor-sdk": "0.5.113",
-    "@volter/editor-live": "0.5.113",
-    "@volter/game-live": "0.5.113",
+    "@volter/editor-core": "0.5.114",
+    "@volter/editor-game": "0.5.114",
+    "@volter/editor-react": "0.5.114",
+    "@volter/editor-threejs": "0.5.114",
+    "@volter/editor-xstate": "0.5.114",
+    "@volter/editor-blender": "0.1.54",
+    "@volter/dawproject": "0.5.114",
+    "@volter/editor-dawproject": "0.5.114",
+    "@volter/blender-engine": "0.1.52",
+    "@volter/editor-project": "0.5.114",
+    "@volter/editor-sdk": "0.5.114",
+    "@volter/editor-live": "0.5.114",
+    "@volter/game-live": "0.5.114",
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@volter/game-runtime": "0.5.113",
-    "@volter/threejs-runtime": "0.5.113",
+    "@volter/game-runtime": "0.5.114",
+    "@volter/threejs-runtime": "0.5.114",
     undici: "7.29.1",
     typescript: "5.9.3",
     "@colyseus/schema": "^4.0.14",
@@ -6598,7 +6600,7 @@ function killEditorSessionProcess(pid, signal = "SIGTERM") {
 async function waitForPidExit(pid, timeoutMs) {
   const deadline = Date.now() + timeoutMs;
   while (pidAlive(pid) && Date.now() < deadline) {
-    await new Promise((resolve12) => setTimeout(resolve12, 50));
+    await new Promise((resolve13) => setTimeout(resolve13, 50));
   }
   return !pidAlive(pid);
 }
@@ -7468,7 +7470,105 @@ async function currentPageErrors(serverUrl) {
   }
 }
 
-// ../editor-core/dist/server/chunk-GINHEWZT.js
+// ../editor-core/dist/server/chunk-T7N5AXLU.js
+var HOSTED_ATTACHMENT_PATH = "/__editor-hosted";
+var HOSTED_ATTACHMENT_FRAGMENT = "volter-editor-attach";
+var HOSTED_MESSAGE_BYTES = 32 * 1024 * 1024;
+var HOSTED_REQUEST_BYTES = 1024 * 1024;
+function isHostedRequest(value) {
+  if (!value || typeof value !== "object") return false;
+  const v = value;
+  return v["type"] === "request" && typeof v["id"] === "string" && /^[a-zA-Z0-9-]{1,80}$/.test(v["id"]) && typeof v["path"] === "string" && /^\/__editor\/[a-zA-Z0-9_/?=&%.-]+$/.test(v["path"]) && !v["path"].includes("..") && (v["method"] === "GET" || v["method"] === "POST") && (v["body"] === void 0 || typeof v["body"] === "string" && new TextEncoder().encode(v["body"]).length <= HOSTED_REQUEST_BYTES);
+}
+function hostedSocketUrl(endpoint) {
+  const url = new URL(endpoint);
+  if (url.protocol !== "https:" && !(url.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname)))
+    throw new Error("Hosted attachments require HTTPS (or local loopback HTTP).");
+  url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+  return url.href;
+}
+async function connectHostedAttachment(attachment) {
+  const socket = new WebSocket(hostedSocketUrl(attachment.endpoint));
+  const pending = /* @__PURE__ */ new Map();
+  let state = {};
+  const ready = new Promise((resolve13, reject) => {
+    const timer = setTimeout(() => {
+      reject(new Error("Hosted attachment did not answer."));
+      socket.close();
+    }, 15e3);
+    socket.addEventListener("open", () => socket.send(JSON.stringify({ type: "auth", role: "client", token: attachment.token })));
+    socket.addEventListener("message", (event) => {
+      try {
+        const value = JSON.parse(String(event.data));
+        if (value.type === "ready") {
+          state = value.state ?? {};
+          clearTimeout(timer);
+          resolve13();
+        } else if (value.type === "state") state = value.state ?? {};
+        else if (value.type === "response") {
+          const call = pending.get(value.id);
+          if (!call) return;
+          pending.delete(value.id);
+          call.cleanup();
+          if (value.error) call.reject(new Error(value.error));
+          else call.resolve(new Response([204, 205, 304].includes(value.status) ? null : value.body, {
+            status: value.status,
+            headers: { "content-type": "application/json" }
+          }));
+        } else if (value.type === "error") {
+          clearTimeout(timer);
+          reject(new Error(value.error));
+          socket.close();
+        }
+      } catch (error) {
+        clearTimeout(timer);
+        reject(error);
+        socket.close();
+      }
+    });
+    socket.addEventListener("close", () => {
+      clearTimeout(timer);
+      reject(new Error("Hosted attachment disconnected."));
+      for (const call of pending.values()) {
+        call.cleanup();
+        call.reject(new Error("Hosted attachment disconnected; the request was not replayed."));
+      }
+      pending.clear();
+    });
+    socket.addEventListener("error", () => {
+      clearTimeout(timer);
+      reject(new Error("Hosted attachment connection failed."));
+    });
+  });
+  await ready;
+  const remoteFetch = async (input, init) => {
+    const request = new Request(input, init);
+    const url = new URL(request.url);
+    const message = { type: "request", id: crypto.randomUUID(), path: url.pathname + url.search, method: request.method };
+    if (request.body) message.body = await request.text();
+    if (!isHostedRequest(message)) throw new Error("Hosted attachment only carries bounded editor HTTP requests.");
+    request.signal.throwIfAborted();
+    return await new Promise((resolve13, reject) => {
+      const abort = () => {
+        pending.delete(message.id);
+        if (socket.readyState === WebSocket.OPEN) socket.send(JSON.stringify({ type: "cancel", id: message.id }));
+        reject(new Error("Hosted request cancelled; any completed mutation is not undone."));
+      };
+      if (socket.readyState !== WebSocket.OPEN) {
+        reject(new Error("Hosted attachment is disconnected."));
+        return;
+      }
+      pending.set(message.id, { resolve: resolve13, reject, cleanup: () => request.signal.removeEventListener("abort", abort) });
+      request.signal.addEventListener("abort", abort, { once: true });
+      socket.send(JSON.stringify(message));
+    });
+  };
+  return { fetch: remoteFetch, get state() {
+    return state;
+  }, close: () => socket.close() };
+}
+
+// ../editor-core/dist/server/chunk-7GX6XNCW.js
 import { Agent, fetch as nodeFetch } from "undici";
 function createDispatcher(timeoutMs) {
   return new Agent({ headersTimeout: timeoutMs, bodyTimeout: timeoutMs });
@@ -7544,6 +7644,7 @@ var RETRYABLE_TRANSPORT_CODES = /* @__PURE__ */ new Set([
 var TRANSPORT_RETRY_DELAY_MS = 400;
 var EditorClient = class {
   baseUrl;
+  fetchOverride;
   /**
    * The running game's debug plane — see {@link GameDebugDoor}. It rides the
    * SAME `/__editor/command` relay every other method here uses (relay cases
@@ -7573,7 +7674,7 @@ var EditorClient = class {
       );
     }
     const unknownOptions = Object.keys(opts ?? {}).filter(
-      (key) => key !== "url" && key !== "onEnvelope" && key !== "transport"
+      (key) => key !== "url" && key !== "onEnvelope" && key !== "transport" && key !== "fetch"
     );
     if (unknownOptions.length > 0) {
       throw new Error(
@@ -7581,6 +7682,7 @@ var EditorClient = class {
       );
     }
     this.baseUrl = (opts?.url ?? DEFAULT_URL).replace(/\/$/, "");
+    this.fetchOverride = opts?.fetch;
     this.onEnvelope = opts?.onEnvelope ?? null;
     this.transport = opts?.transport ?? null;
     this.game = {
@@ -7629,7 +7731,7 @@ var EditorClient = class {
           signal: AbortSignal.timeout(deadlineMs)
         };
         commandDispatcher = deadlineMs > UNDICI_DEFAULT_HEADERS_TIMEOUT_MS ? createDispatcher(deadlineMs + 3e4) : void 0;
-        res = await dispatchFetch(url, init, commandDispatcher);
+        res = this.fetchOverride ? await this.fetchOverride(url, init) : await dispatchFetch(url, init, commandDispatcher);
         break;
       } catch (error) {
         await commandDispatcher?.destroy?.();
@@ -7644,7 +7746,7 @@ var EditorClient = class {
         const { code, detail } = describeFetchFailure(error);
         if (options?.retryTransport === true && !retried && RETRYABLE_TRANSPORT_CODES.has(code)) {
           retried = true;
-          await new Promise((resolve12) => setTimeout(resolve12, TRANSPORT_RETRY_DELAY_MS));
+          await new Promise((resolve13) => setTimeout(resolve13, TRANSPORT_RETRY_DELAY_MS));
           continue;
         }
         throw new EditorCommandError(
@@ -8540,7 +8642,7 @@ var EditorClient = class {
    */
   async httpFetch(url, init, dispatcher) {
     try {
-      return await dispatchFetch(url, init, dispatcher);
+      return this.fetchOverride ? await this.fetchOverride(url, init) : await dispatchFetch(url, init, dispatcher);
     } catch (error) {
       if (error?.name === "TimeoutError") throw error;
       const { code, detail } = describeFetchFailure(error);
@@ -8734,7 +8836,85 @@ function relayCommandTimeoutMs(type) {
   return isRelayCommandType(type) ? RELAY_COMMANDS[type].timeoutMs : DEFAULT_RELAY_COMMAND_TIMEOUT_MS;
 }
 
-// ../editor-core/dist/server/launcher/control.js
+// ../editor-core/dist/server/chunk-TMIV3AST.js
+import { spawn as spawn3 } from "node:child_process";
+var OPENER_STDERR_CAP_BYTES = 2048;
+var OPENER_EXIT_WATCH_TIMEOUT_MS = 2e4;
+function spawnOpener(cmd, cmdArgs, fallback) {
+  let child;
+  try {
+    child = spawn3(cmd, cmdArgs, { stdio: ["ignore", "ignore", "pipe"], detached: true });
+  } catch (err) {
+    console.error(`volter: auto-open via ${cmd} failed: ${err.message}`);
+    fallback?.();
+    return;
+  }
+  const stderrChunks = [];
+  let stderrBytes = 0;
+  child.stderr?.on("data", (chunk) => {
+    if (stderrBytes >= OPENER_STDERR_CAP_BYTES) return;
+    const remaining = OPENER_STDERR_CAP_BYTES - stderrBytes;
+    const slice = chunk.length > remaining ? chunk.subarray(0, remaining) : chunk;
+    stderrChunks.push(slice);
+    stderrBytes += slice.length;
+  });
+  child.on("error", (err) => {
+    console.error(`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}`);
+      fallback?.();
+    }
+  });
+  child.unref();
+  const pipeTimeout = setTimeout(() => {
+    child.stderr?.destroy();
+  }, OPENER_EXIT_WATCH_TIMEOUT_MS);
+  pipeTimeout.unref();
+}
+
+// ../editor-core/dist/server/chunk-VIML3FNI.js
+import { existsSync as existsSync7, readFileSync as readFileSync8 } from "node:fs";
+function isWSL() {
+  if (process.platform !== "linux") return false;
+  try {
+    return readFileSync8("/proc/version", "utf8").toLowerCase().includes("microsoft");
+  } catch {
+    return false;
+  }
+}
+function openBrowserUrl(browserUrl, options) {
+  if (process.platform === "darwin") {
+    spawnOpener("open", options?.background === true ? ["-g", browserUrl] : [browserUrl]);
+  } else if (process.platform === "win32") {
+    spawnOpener("cmd", ["/c", "start", "", browserUrl]);
+  } else if (isWSL()) {
+    const interop = process.env["WSL_INTEROP"];
+    if (interop && !existsSync7(interop)) {
+      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.`
+      );
+      return;
+    }
+    spawnOpener(
+      "explorer.exe",
+      [browserUrl],
+      () => spawnOpener("powershell.exe", ["-NoProfile", "-Command", `Start-Process '${browserUrl}'`])
+    );
+  } else {
+    spawnOpener("xdg-open", [browserUrl]);
+  }
+}
+
+// ../editor-core/dist/server/chunk-2HZZ3DF7.js
+import { createHash as createHash4 } from "node:crypto";
+import { mkdirSync as mkdirSync7, readFileSync as readFileSync9, writeFileSync as writeFileSync7, rmSync as rmSync4, existsSync as existsSync8 } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { dirname as dirname6, join as join9, resolve as resolve8 } from "node:path";
+import { LiveEditor, LiveTools } from "@volter/editor-live";
 import { connect, unconnectedBindings } from "@volter/editor-live";
 var NOISE = /* @__PURE__ */ new Set(["constructor", "then", "catch", "finally"]);
 var FUNCTION_NOISE = /* @__PURE__ */ new Set(["length", "name", "prototype", "arguments", "caller"]);
@@ -8837,14 +9017,14 @@ var TOOL_CONTRIBUTION_SUFFIXES = [
   ".service"
 ];
 var CONTROLLER_DISCONNECTED_MESSAGE = "The editor tab controlling this command disconnected before reporting a result.";
-async function control(command, verb, argument, reason, scope) {
+async function control(command, verb, argument, reason, scope, attachment) {
   if (verb === "eval" && argument === "--list") {
     const unconnected = { ...unconnectedBindings(), session: { port: 0, projectRoot: process.cwd() } };
     console.log(formatSurface(command, { ...unconnected, ...scope?.(unconnected) }));
     return;
   }
-  const live = await connect();
-  const client = new EditorClient({ url: `http://127.0.0.1:${live.session.port}` });
+  const live = attachment?.live ?? await connect();
+  const client = attachment?.client ?? new EditorClient({ url: `http://127.0.0.1:${live.session.port}` });
   if (verb === "close") {
     const session = (await verifiedSessions(live.session.port)).find((s) => s.port === live.session.port && s.project === live.session.projectRoot && s.registered);
     if (!session?.pid) throw new Error("Cannot close a session without verified process ownership.");
@@ -8889,13 +9069,97 @@ async function control(command, verb, argument, reason, scope) {
     process.exitCode = 1;
   }
 }
+var HOSTED_USAGE = "hosted attach <https-url> | hosted status | hosted eval <JavaScript> | hosted screenshot <file.png> | hosted detach";
+function stateFile() {
+  const key = createHash4("sha256").update(resolve8(process.cwd())).digest("hex");
+  return join9(homedir4(), ".local", "state", "volter-editor", "hosted", `${key}.json`);
+}
+async function hostedControl(command, args) {
+  const [verb, argument] = args;
+  if (args.length > (verb === "attach" || verb === "eval" || verb === "screenshot" ? 2 : 1)) throw new Error(HOSTED_USAGE);
+  const file = stateFile();
+  if (verb === "attach") {
+    if (!argument) throw new Error(HOSTED_USAGE);
+    if (existsSync8(file)) throw new Error("This directory already has a hosted attachment. Use hosted status or hosted detach; attaching never opens a duplicate tab.");
+    const page = new URL(argument);
+    if (page.username || page.password || page.hash) throw new Error("Use the hosted page URL without credentials or a fragment.");
+    hostedSocketUrl(page.href);
+    const response = await fetch(new URL(HOSTED_ATTACHMENT_PATH, page), {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ page: page.href }),
+      signal: AbortSignal.timeout(15e3),
+      redirect: "error"
+    });
+    if (!response.ok) throw new Error(`Hosted attachment refused (${response.status}): ${(await response.text()).slice(0, 500)}`);
+    const created = await response.json();
+    if (created.page !== page.href || new URL(created.endpoint).origin !== page.origin || !/^[a-f0-9]{64}$/.test(created.clientToken) || !/^[a-f0-9]{64}$/.test(created.workerToken)) throw new Error("Invalid hosted attachment response.");
+    const common = { id: created.id, endpoint: created.endpoint, page: created.page, expiresAt: created.expiresAt };
+    mkdirSync7(dirname6(file), { recursive: true, mode: 448 });
+    writeFileSync7(file, JSON.stringify({ ...common, token: created.clientToken }), { mode: 384, flag: "wx" });
+    page.hash = new URLSearchParams({ [HOSTED_ATTACHMENT_FRAGMENT]: JSON.stringify({ ...common, token: created.workerToken }) }).toString();
+    openBrowserUrl(page.href, { background: true });
+    console.log(`Opening hosted editor: ${created.page}
+Use ${command} hosted status from this directory. Attachment expires ${new Date(created.expiresAt).toISOString()}.`);
+    return;
+  }
+  if (!["status", "eval", "screenshot", "detach"].includes(verb ?? "")) throw new Error(HOSTED_USAGE);
+  let attachment;
+  try {
+    attachment = JSON.parse(readFileSync9(file, "utf8"));
+  } catch {
+    throw new Error(`No hosted attachment in this directory. Run ${command} hosted attach <https-url>.`);
+  }
+  if (verb === "detach") {
+    const socket = new WebSocket(hostedSocketUrl(attachment.endpoint));
+    await new Promise((done) => {
+      const timer = setTimeout(() => {
+        socket.close();
+        done();
+      }, 5e3);
+      socket.addEventListener("open", () => socket.send(JSON.stringify({ type: "auth", role: "client", token: attachment.token })));
+      socket.addEventListener("message", (event) => {
+        if (JSON.parse(String(event.data)).type === "ready") socket.send(JSON.stringify({ type: "revoke" }));
+      });
+      socket.addEventListener("close", () => {
+        clearTimeout(timer);
+        done();
+      });
+      socket.addEventListener("error", () => {
+        clearTimeout(timer);
+        done();
+      });
+    });
+    rmSync4(file);
+    console.log("Hosted attachment removed. The browser document is preserved.");
+    return;
+  }
+  const remote = await connectHostedAttachment(attachment);
+  try {
+    if (verb === "status" && remote.state["phase"] !== "ready") {
+      console.log(JSON.stringify(remote.state, null, 2));
+      return;
+    }
+    const client = new EditorClient({ url: "http://127.0.0.1", fetch: remote.fetch });
+    const live = { editor: new LiveEditor(client), tools: new LiveTools(client), session: { port: 0, projectRoot: attachment.page } };
+    if (verb === "screenshot") {
+      if (!argument?.endsWith(".png")) throw new Error("hosted screenshot requires an output .png path.");
+      const shot = await live.editor.screenshot();
+      if (shot.mimeType !== "image/png") throw new Error("Editor did not return a PNG viewport.");
+      writeFileSync7(resolve8(argument), Buffer.from(shot.base64, "base64"));
+      console.log(resolve8(argument));
+    } else await control(command, verb, argument, void 0, void 0, { live, client });
+  } finally {
+    remote.close();
+  }
+}
 
 // ../editor-core/dist/server/launcher/session-verbs.js
-import { existsSync as existsSync7, mkdirSync as mkdirSync7, readFileSync as readFileSync8, statSync as statSync4, writeFileSync as writeFileSync7 } from "node:fs";
-import { basename as basename3, dirname as dirname6, join as join23, resolve as resolve23 } from "node:path";
+import { existsSync as existsSync9, mkdirSync as mkdirSync8, readFileSync as readFileSync10, statSync as statSync4, writeFileSync as writeFileSync8 } from "node:fs";
+import { basename as basename3, dirname as dirname7, join as join23, resolve as resolve23 } from "node:path";
 import { setTimeout as delay2 } from "node:timers/promises";
 import { resolveSession } from "@volter/editor-live";
-import { isAbsolute as isAbsolute4, join as join9, relative as relative5, resolve as resolve8 } from "node:path";
+import { isAbsolute as isAbsolute4, join as join10, relative as relative5, resolve as resolve9 } from "node:path";
 var DEFAULT_RESTART_TIMINGS = {
   reachableBudgetMs: 15e3,
   probeIntervalMs: 250,
@@ -9046,9 +9310,9 @@ function classifyScreenshotTarget(target) {
 }
 function resolveModelTarget(target, options) {
   const { cwd, projectRoot, exists } = options;
-  const candidates = [resolve8(cwd, target)];
+  const candidates = [resolve9(cwd, target)];
   if (target.startsWith("/") && projectRoot) {
-    candidates.push(join9(projectRoot, target), join9(projectRoot, "public", target));
+    candidates.push(join10(projectRoot, target), join10(projectRoot, "public", target));
   }
   const file = candidates.find((candidate) => exists(candidate));
   if (file === void 0) {
@@ -9278,7 +9542,7 @@ async function screenshot(target, options) {
       const resolved = resolveModelTarget(classified.path, {
         cwd: process.cwd(),
         projectRoot: session.projectRoot,
-        exists: (path) => existsSync7(path) && statSync4(path).isFile()
+        exists: (path) => existsSync9(path) && statSync4(path).isFile()
       });
       if ("error" in resolved) throw new Error(resolved.error);
       await assertUnambiguousTarget(session.client, classified.path, resolved.file);
@@ -9288,7 +9552,7 @@ async function screenshot(target, options) {
       return moduleLook(session.client, session.projectRoot, classified.path, flags);
     case "entity": {
       const asFile = resolve23(process.cwd(), classified.entityId);
-      if (existsSync7(asFile) && statSync4(asFile).isFile()) await assertUnambiguousTarget(session.client, classified.entityId, asFile);
+      if (existsSync9(asFile) && statSync4(asFile).isFile()) await assertUnambiguousTarget(session.client, classified.entityId, asFile);
       const resolved = resolveEntityTarget(classified.entityId, await liveEntityRows(session.client));
       if ("error" in resolved) throw new Error(resolved.error);
       return assetLabLook(session.client, { entityId: resolved.entityId }, flags, screenshotPath(session.projectRoot, resolved.entityId), "scene");
@@ -9308,8 +9572,8 @@ async function sessionLook(client, projectRoot) {
       capture2 = await client.captureGame({ refreshStarvedFrame: true });
       loopRecoveryFrame = true;
     }
-    mkdirSync7(dirname6(outPath), { recursive: true });
-    writeFileSync7(outPath, Buffer.from(capture2.base64, "base64"));
+    mkdirSync8(dirname7(outPath), { recursive: true });
+    writeFileSync8(outPath, Buffer.from(capture2.base64, "base64"));
     console.log(outPath);
     if (capture2.flatness?.degenerate === true && capture2.flatness.warning !== void 0) console.error(`warning \u2014 ${capture2.flatness.warning}`);
     if (loopRecoveryFrame || capture2.loopRecoveryFrame === true) {
@@ -9320,8 +9584,8 @@ async function sessionLook(client, projectRoot) {
     return;
   }
   const capture = await client.captureActiveDocument();
-  mkdirSync7(dirname6(outPath), { recursive: true });
-  writeFileSync7(outPath, Buffer.from(capture.base64, "base64"));
+  mkdirSync8(dirname7(outPath), { recursive: true });
+  writeFileSync8(outPath, Buffer.from(capture.base64, "base64"));
   console.log(outPath);
   console.error(`${capture.document.title} (${capture.document.kind}${capture.document.sourcePath ? `, ${capture.document.sourcePath}` : ""}) \u2014 ${capture.source}`);
 }
@@ -9342,10 +9606,10 @@ async function assetLabLook(client, source, flags, outputDirectory, defaultStage
     ...flags.width === void 0 ? {} : { width: flags.width },
     ...flags.height === void 0 ? {} : { height: flags.height }
   };
-  mkdirSync7(outputDirectory, { recursive: true });
+  mkdirSync8(outputDirectory, { recursive: true });
   if (flags.compare !== void 0) {
     if (flags.shots !== void 0) throw new Error("--compare cannot be combined with --shots");
-    const refBytes = readFileSync8(resolve23(flags.compare));
+    const refBytes = readFileSync10(resolve23(flags.compare));
     const maxRefBytes = 32 * 1024 * 1024;
     if (refBytes.byteLength > maxRefBytes) throw new Error(`--compare reference GLB must be ${maxRefBytes / 1024 / 1024} MiB or less.`);
     const capture2 = await client.captureAssetComparePreview(source, refBytes.toString("base64"), dimensions);
@@ -9353,7 +9617,7 @@ async function assetLabLook(client, source, flags, outputDirectory, defaultStage
     for (const view of capture2.views) {
       iou[view.view] = view.iou;
       for (const [suffix, image] of [["overlay", view.overlay], ["asset", view.asset], ["ref", view.ref]]) {
-        writeFileSync7(join23(outputDirectory, `compare-${view.view}-${suffix}.png`), Buffer.from(image.base64, "base64"));
+        writeFileSync8(join23(outputDirectory, `compare-${view.view}-${suffix}.png`), Buffer.from(image.base64, "base64"));
       }
     }
     console.log(JSON.stringify({ compare: { iou } }));
@@ -9373,18 +9637,18 @@ async function assetLabLook(client, source, flags, outputDirectory, defaultStage
     const warnings = new Map((capture2.warnings ?? []).map((warning) => [warning.label, warning]));
     for (const image of capture2.shots) {
       const file = join23(outputDirectory, `${image.label}.png`);
-      writeFileSync7(file, Buffer.from(image.base64, "base64"));
+      writeFileSync8(file, Buffer.from(image.base64, "base64"));
       const warning = warnings.get(image.label);
       if (warning) console.warn(`WARNING  ${file}: ${warning.message}`);
     }
-    writeFileSync7(join23(outputDirectory, "contact-sheet.png"), Buffer.from(capture2.contactSheet.base64, "base64"));
+    writeFileSync8(join23(outputDirectory, "contact-sheet.png"), Buffer.from(capture2.contactSheet.base64, "base64"));
     const empty = capture2.warnings?.length ?? 0;
     console.log(`Shot set '${flags.shots}' preview (${capture2.shots.length} shots${empty > 0 ? `, ${empty} EMPTY \u2014 see the warnings above` : ""}) written to ${outputDirectory}`);
     return;
   }
   const capture = await client.captureAssetPreview(source, { ...dimensions, ...defaultStage === void 0 ? {} : { stage: defaultStage } });
-  for (const image of capture.views) writeFileSync7(join23(outputDirectory, `${image.view}.png`), Buffer.from(image.base64, "base64"));
-  writeFileSync7(join23(outputDirectory, "contact-sheet.png"), Buffer.from(capture.contactSheet.base64, "base64"));
+  for (const image of capture.views) writeFileSync8(join23(outputDirectory, `${image.view}.png`), Buffer.from(image.base64, "base64"));
+  writeFileSync8(join23(outputDirectory, "contact-sheet.png"), Buffer.from(capture.contactSheet.base64, "base64"));
   console.log(`${join23(outputDirectory, "contact-sheet.png")}   \u2190 every view on one sheet`);
   console.log(`  per-view frames beside it: ${capture.views.map((image) => `${image.view}.png`).join(" ")}`);
   if (capture.orientation && capture.orientation.yawDegrees !== 0) {
@@ -9443,21 +9707,21 @@ async function moduleLook(client, projectRoot, modulePath, flags) {
 
 // node/capabilities.ts
 import { execFileSync as execFileSync5 } from "node:child_process";
-import { existsSync as existsSync8 } from "node:fs";
-import { join as join10, resolve as resolve9 } from "node:path";
+import { existsSync as existsSync10 } from "node:fs";
+import { join as join11, resolve as resolve10 } from "node:path";
 import { findProjectRootFrom } from "@volter/editor-live";
 var CAPABILITY_OPTIONS = {
   project: { type: "string" },
   "dry-run": { type: "boolean" },
   json: { type: "boolean" }
 };
-var catalogDir = join10(productRoot, "catalog");
+var catalogDir = join11(productRoot, "catalog");
 function runCapabilityCommand(verb, ids, options) {
   const dryRun = options["dry-run"] === true;
   const json = options.json === true;
   const log = console.log;
   const emit = (value) => log(JSON.stringify(value, null, 2));
-  const projectDir = findProjectRootFrom(resolve9(options.project ?? process.cwd()));
+  const projectDir = findProjectRootFrom(resolve10(options.project ?? process.cwd()));
   const catalog = readCatalog(catalogDir);
   if (verb === "add" && ids.length === 0) {
     const installed = new Set(projectDir ? readCatalogStatus(projectDir, catalogDir).installed : []);
@@ -9528,7 +9792,7 @@ Use \`git diff\` to see your changes, then port what you want from the new versi
     resolveDependencySpec: (name, spec) => checkoutPackageSpec(name, monoRoot) ?? spec,
     installDependencies: (dependencyNames) => {
       if (usesRuntimeImage(projectDir)) {
-        const missing = dependencyNames.filter((name) => !existsSync8(join10(projectDir, "node_modules", ...name.split("/"), "package.json")));
+        const missing = dependencyNames.filter((name) => !existsSync10(join11(projectDir, "node_modules", ...name.split("/"), "package.json")));
         if (missing.length > 0) throw new Error(`The runtime image lacks ${missing.join(", ")}; this capability needs a game that installs its own dependencies.`);
         return;
       }
@@ -9569,24 +9833,24 @@ ${report.writtenFiles.map((path) => `  ${path}`).join("\n")}`);
 import { execFileSync as execFileSync6 } from "node:child_process";
 import {
   createWriteStream as createWriteStream2,
-  existsSync as existsSync9,
-  mkdirSync as mkdirSync8,
-  readFileSync as readFileSync9,
+  existsSync as existsSync11,
+  mkdirSync as mkdirSync9,
+  readFileSync as readFileSync11,
   renameSync as renameSync3,
-  rmSync as rmSync4,
-  writeFileSync as writeFileSync8
+  rmSync as rmSync5,
+  writeFileSync as writeFileSync9
 } from "node:fs";
-import { homedir as homedir4 } from "node:os";
-import { isAbsolute as isAbsolute5, join as join11, resolve as resolve10 } from "node:path";
+import { homedir as homedir5 } from "node:os";
+import { isAbsolute as isAbsolute5, join as join12, resolve as resolve11 } from "node:path";
 var WORKBENCH_LOCATOR_PATH2 = ".volter/workbench.json";
 var RELEASE_RECORD2 = "BUILD.json";
-var SOURCES_LAUNCHER2 = join11("scripts", "code-server.sh");
+var SOURCES_LAUNCHER2 = join12("scripts", "code-server.sh");
 var OVERLAY_RECORD2 = ".volter-overlay.json";
 function writeWorkbenchDeclaration2(projectRoot, workbenchDir) {
-  mkdirSync8(join11(projectRoot, ".volter"), { recursive: true });
-  writeFileSync8(
-    join11(projectRoot, WORKBENCH_LOCATOR_PATH2),
-    `${JSON.stringify({ workbench: resolve10(workbenchDir) }, null, 2)}
+  mkdirSync9(join12(projectRoot, ".volter"), { recursive: true });
+  writeFileSync9(
+    join12(projectRoot, WORKBENCH_LOCATOR_PATH2),
+    `${JSON.stringify({ workbench: resolve11(workbenchDir) }, null, 2)}
 `
   );
 }
@@ -9594,8 +9858,8 @@ function machinePlatform2() {
   return `${process.platform}-${process.arch}`;
 }
 function resolveWorkbench2(dir, expectedProduct) {
-  const root = resolve10(dir);
-  const resolved = existsSync9(join11(root, RELEASE_RECORD2)) ? resolveRelease2(root) : existsSync9(join11(root, SOURCES_LAUNCHER2)) ? resolveSources2(root) : null;
+  const root = resolve11(dir);
+  const resolved = existsSync11(join12(root, RELEASE_RECORD2)) ? resolveRelease2(root) : existsSync11(join12(root, SOURCES_LAUNCHER2)) ? resolveSources2(root) : null;
   if (resolved === null) {
     throw new Error(
       `${root} is neither a Code-OSS release nor a fork checkout: it carries no ${RELEASE_RECORD2} (the record scripts/workbench/build-release.mjs writes beside its tarball) and no ${SOURCES_LAUNCHER2}. Name the directory the release was extracted into, or the fork checkout itself.`
@@ -9611,11 +9875,11 @@ function resolveWorkbench2(dir, expectedProduct) {
   return resolved;
 }
 function resolveRelease2(dir) {
-  const record = join11(dir, RELEASE_RECORD2);
+  const record = join12(dir, RELEASE_RECORD2);
   const cut = `node scripts/workbench/build-release.mjs --product <id> --platform ${machinePlatform2()} --checkout <fork dir> --out ${dir}`;
   let parsed;
   try {
-    parsed = JSON.parse(readFileSync9(record, "utf8"));
+    parsed = JSON.parse(readFileSync11(record, "utf8"));
   } catch (error) {
     throw new Error(`${record} could not be read: ${String(error)}`);
   }
@@ -9639,13 +9903,13 @@ function resolveRelease2(dir) {
   node scripts/workbench/build-release.mjs --product ${product} --platform ${machine} --checkout <fork dir>`
     );
   }
-  const packageRoot = join11(dir, target);
-  const serverBinPath = join11(packageRoot, serverBin);
-  if (!existsSync9(serverBinPath)) {
+  const packageRoot = join12(dir, target);
+  const serverBinPath = join12(packageRoot, serverBin);
+  if (!existsSync11(serverBinPath)) {
     const tarball = typeof parsed["tarball"] === "string" ? parsed["tarball"] : `${target}-<commit>.tar.gz`;
     throw new Error(
       `${dir} records ${target}, but ${serverBinPath} is not there \u2014 the tarball has not been extracted beside ${RELEASE_RECORD2}. Run:
-  tar -xzf ${join11(dir, tarball)} -C ${dir}`
+  tar -xzf ${join12(dir, tarball)} -C ${dir}`
     );
   }
   return { kind: "release", dir, commit, product, serverBin: serverBinPath, cwd: packageRoot };
@@ -9659,8 +9923,8 @@ function resolveSources2(dir) {
       `${dir} carries ${SOURCES_LAUNCHER2}, so it reads as a Code-OSS fork checkout, but \`git rev-parse HEAD\` there failed (${error instanceof Error ? error.message : String(error)}). A checkout's commit is the only record of which fork this workbench is.`
     );
   }
-  const marker = join11(dir, OVERLAY_RECORD2);
-  if (!existsSync9(marker)) {
+  const marker = join12(dir, OVERLAY_RECORD2);
+  if (!existsSync11(marker)) {
     throw new Error(
       `${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>`
@@ -9668,7 +9932,7 @@ function resolveSources2(dir) {
   }
   let product;
   try {
-    product = JSON.parse(readFileSync9(marker, "utf8"))["product"];
+    product = JSON.parse(readFileSync11(marker, "utf8"))["product"];
   } catch (error) {
     throw new Error(`${marker} could not be read: ${String(error)}`);
   }
@@ -9682,11 +9946,11 @@ function resolveSources2(dir) {
     dir,
     commit,
     product,
-    serverBin: join11(dir, SOURCES_LAUNCHER2),
+    serverBin: join12(dir, SOURCES_LAUNCHER2),
     cwd: dir
   };
 }
-var WORKBENCH_CACHE_ROOT2 = join11(homedir4(), ".volter", "workbenches");
+var WORKBENCH_CACHE_ROOT2 = join12(homedir5(), ".volter", "workbenches");
 
 // node/cli.ts
 var PRODUCT3 = { packageName: package_default.name, id: "game-editor", displayName: package_default.volter.product.displayName, command: Object.keys(package_default.bin)[0] };
@@ -9730,15 +9994,18 @@ try {
   volter-game-editor eval <JavaScript> | --list   # { editor, game, page, tools, session } in scope
   volter-game-editor play | stop | restart
   volter-game-editor ${SCREENSHOT_USAGE}
+  volter-game-editor ${HOSTED_USAGE}
   volter-game-editor sessions | project | projects
   volter-game-editor open <path>
   volter-game-editor add [id...] | remove <id...> | outdated   [--project <path>] [--dry-run] [--json]
   volter-game-editor blender-mcp    # stdio MCP transport to Blender in the editor`);
+  } else if (verb === "hosted") {
+    await hostedControl(PRODUCT3.command, positionals.slice(1));
   } else if (verb === "blender-mcp") {
     if (positionals.length !== 1) throw new Error("Usage: volter-game-editor blender-mcp");
-    let project = resolve11(process.cwd());
+    let project = resolve12(process.cwd());
     while (!hasManifest(project)) {
-      const parent = dirname8(project);
+      const parent = dirname9(project);
       if (parent === project) throw new Error("Run volter-game-editor blender-mcp inside a game project.");
       project = parent;
     }
@@ -9751,7 +10018,7 @@ try {
       } catch {
       }
       await new Promise((done, fail2) => {
-        const child = spawn3(process.execPath, [fileURLToPath2(import.meta.url), "edit", project], {
+        const child = spawn4(process.execPath, [fileURLToPath2(import.meta.url), "edit", project], {
           cwd: project,
           stdio: ["ignore", 2, 2],
           env: process.env
@@ -9802,14 +10069,14 @@ try {
         if (!isScaffoldAddition(value)) throw new Error(`--with must name additions from: ${SCAFFOLD_ADDITIONS.join(", ")} \u2014 got "${value}"`);
         additions.push(value);
       }
-      if (values.workbench) resolveWorkbench2(resolve11(values.workbench), PRODUCT3.id);
+      if (values.workbench) resolveWorkbench2(resolve12(values.workbench), PRODUCT3.id);
       await createGameProject({
         name: folder.split(/[\\/]/).at(-1),
-        targetDir: resolve11(folder),
+        targetDir: resolve12(folder),
         additions,
         ...values.template === void 0 ? {} : { template: values.template }
       });
-      if (values.workbench) writeWorkbenchDeclaration2(resolve11(folder), resolve11(values.workbench));
+      if (values.workbench) writeWorkbenchDeclaration2(resolve12(folder), resolve12(values.workbench));
     }
     await launch(folder, PRODUCT3, {
       ...values.workbench ? { workbench: values.workbench } : {},