@vgai/cli 0.4.1-canary.20260715.0 → 0.4.1

package/README.md

@@ -42,7 +42,7 @@ vgai select <id> | --all | deselect             selection
 vgai focus [id] | view <top|front|right|perspective>
 vgai show <viewport scene|game / inspector / console / build>
 vgai open-asset <path> <kind>
-vgai grid|helpers|stats <on|off> | shading <solid|wireframe|unlit>
+vgai grid|helpers|stats <on|off> | shading <solid|unlit|wireframe|normals|overdraw>
 vgai status                     print full editor state as JSON
 
 vgai apply-diff <scene> <patch> [--report]   apply a SceneDiff patch to a scene

package/dist/index.js

@@ -261411,26 +261411,26 @@ var EditorClient = class {
     const data = await res.json();
     return data.projects;
   }
-  // --- Project operations ---
-  /** List live project-local operation definitions below `src/operations/`.
-   * The editor server loads metadata in Node; operation modules never enter the
+  // --- Registered project tools ---
+  /** List tools explicitly registered in `package.json#vgai.tools`.
+   * The editor server loads callable metadata in Node; modules never enter the
    * editor browser merely because they were listed. */
-  async listProjectOperations() {
-    const res = await fetch(`${this.baseUrl}/__editor/project-operations`);
-    if (!res.ok) throw new Error(`Failed to list project operations: ${res.status}`);
+  async listProjectTools() {
+    const res = await fetch(`${this.baseUrl}/__editor/project-tools`);
+    if (!res.ok) throw new Error(`Failed to list project tools: ${res.status}`);
     return await res.json();
   }
-  /** Execute one Node-hosted project operation through the existing validated
-   * operation registry. Write/destructive operations require `confirm:true`. */
-  async runProjectOperation(name, input = {}, options = {}) {
-    const res = await fetch(`${this.baseUrl}/__editor/project-operations/run`, {
+  /** Execute one Node-hosted project tool through the shared validated
+   * dispatcher. Write/destructive tools require `confirm:true`. */
+  async runProjectTool(name, input = {}, options = {}) {
+    const res = await fetch(`${this.baseUrl}/__editor/project-tools/run`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ name, input, confirm: options.confirm === true })
     });
     const body = await res.json();
     if (!body || typeof body !== "object" || typeof body.ok !== "boolean") {
-      throw new Error(`Project operation returned an invalid response (${res.status}).`);
+      throw new Error(`Project tool returned an invalid response (${res.status}).`);
     }
     return body;
   }
@@ -275248,7 +275248,9 @@ var CORE_ERROR_CODES = {
   /** The impl threw something that isn't a declared, structured error. */
   INTERNAL_ERROR: "INTERNAL_ERROR"
 };
+var OPERATION_ERROR_BRAND = Symbol.for("@vgai/sdk.OperationError");
 var OperationError = class extends Error {
+  [OPERATION_ERROR_BRAND] = true;
   code;
   data;
   constructor(code, message, data) {
@@ -275258,6 +275260,12 @@ var OperationError = class extends Error {
     this.data = data;
   }
 };
+function isOperationError(value) {
+  if (value instanceof OperationError) return true;
+  if (value === null || typeof value !== "object") return false;
+  const candidate = value;
+  return candidate[OPERATION_ERROR_BRAND] === true && typeof candidate["code"] === "string" && typeof candidate["message"] === "string";
+}
 function toStructuredIssues(issues) {
   return issues.map((issue2) => ({
     path: [...issue2.path],
@@ -275299,7 +275307,7 @@ function defineOperation(def) {
   return def;
 }
 function normalizeThrown(def, err2) {
-  if (err2 instanceof OperationError) {
+  if (isOperationError(err2)) {
     const declared = def.errors.find((e) => e.code === err2.code);
     if (!declared) {
       return {
@@ -283632,7 +283640,7 @@ function writeScaffoldBaseline(targetDir, engineVersion, engineDir) {
 }
 
 // ../create-vgai-project/src/engine-version.ts
-var SEMVER_RE2 = /^(\d+)\.(\d+)\.(\d+)(?:-[0-9A-Za-z-.]+)?(?:\+[0-9A-Za-z-.]+)?$/;
+var SEMVER_RE2 = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-.]+))?(?:\+([0-9A-Za-z-.]+))?$/;
 function parseSemver(version2) {
   const match = SEMVER_RE2.exec(version2);
   if (!match) return null;
@@ -283645,15 +283653,39 @@ function compareTuples(a, b) {
   }
   return 0;
 }
+function comparePrerelease(a, b) {
+  if (a === b) return 0;
+  if (a === void 0) return 1;
+  if (b === void 0) return -1;
+  const aParts = a.split(".");
+  const bParts = b.split(".");
+  for (let index = 0; index < Math.max(aParts.length, bParts.length); index++) {
+    const aPart = aParts[index];
+    const bPart = bParts[index];
+    if (aPart === void 0) return -1;
+    if (bPart === void 0) return 1;
+    if (aPart === bPart) continue;
+    const aNumeric = /^\d+$/.test(aPart);
+    const bNumeric = /^\d+$/.test(bPart);
+    if (aNumeric && bNumeric) return Number(aPart) < Number(bPart) ? -1 : 1;
+    if (aNumeric !== bNumeric) return aNumeric ? -1 : 1;
+    return aPart < bPart ? -1 : 1;
+  }
+  return 0;
+}
 function compareEnginePin(pin, current) {
+  const pinMatch = SEMVER_RE2.exec(pin);
+  const currentMatch = SEMVER_RE2.exec(current);
   const pinTuple = parseSemver(pin);
   const currentTuple = parseSemver(current);
   if (!pinTuple || !currentTuple) {
     const reason = !pinTuple && !currentTuple ? `neither pin "${pin}" nor current "${current}" is a valid exact semver string` : !pinTuple ? `pin "${pin}" is not a valid exact semver string` : `current "${current}" is not a valid exact semver string`;
     return { status: "invalid", pin, current, reason };
   }
-  const cmp = compareTuples(pinTuple, currentTuple);
-  const status = cmp === 0 ? "match" : cmp < 0 ? "pin-behind" : "pin-ahead";
+  if (pin === current) return { status: "match", pin, current };
+  const tupleCmp = compareTuples(pinTuple, currentTuple);
+  const cmp = tupleCmp !== 0 ? tupleCmp : comparePrerelease(pinMatch?.[4], currentMatch?.[4]) || -1;
+  const status = cmp < 0 ? "pin-behind" : "pin-ahead";
   return { status, pin, current };
 }
 function satisfiesRange(version2, range) {
@@ -284072,26 +284104,6 @@ test('React-only root mounts and receives honest DOM keyboard input', async ({ g
   await game.screenshot('react-root-after-keyboard-input');
 });
 `;
-var REACT_ONLY_PLAYTEST_SOURCE = `import { editor, game } from '@vgai/live';
-
-await editor.play();
-await game.waitFor(
-  (state) =>
-    (state('react-starter') as { lastInput?: string } | undefined)?.lastInput === 'Ready',
-  { simSeconds: 10 },
-);
-await game.page(async (page) => {
-  await page.keyboard.press('ArrowRight');
-});
-await game.waitFor(
-  (state) =>
-    (state('react-starter') as { lastInput?: string } | undefined)?.lastInput === 'ArrowRight',
-  { simSeconds: 10 },
-);
-const shot = await game.screenshot('react-playtest-after-keyboard-input');
-console.log('React-only DOM input reached the game.');
-console.log('screenshot: ' + shot);
-`;
 var REACT_ONLY_MAIN_SOURCE = `import { manifestEntryModules } from 'virtual:vgai-manifest-entries';
 import { registerReactAdapter } from '@engine/react/root-adapter';
 import { mountGameFromManifest, type ManifestHost } from '@engine/runtime/mount-game';
@@ -284126,7 +284138,6 @@ function rewriteTemplateVariantFiles(targetDir, template) {
   if (template !== "react") return;
   rmSync(join15(targetDir, "src", "runtime"), { recursive: true, force: true });
   rmSync(join15(targetDir, "src", "scripts"), { recursive: true, force: true });
-  rmSync(join15(targetDir, "src", "tools"), { recursive: true, force: true });
   rmSync(join15(targetDir, "tests", "logic", "example.test.ts"), { force: true });
   rmSync(join15(targetDir, "public"), { recursive: true, force: true });
   mkdirSync4(join15(targetDir, "public"), { recursive: true });
@@ -284138,7 +284149,6 @@ function rewriteTemplateVariantFiles(targetDir, template) {
     REACT_ONLY_ACCEPTANCE_SOURCE,
     "utf-8"
   );
-  writeFileSync3(join15(targetDir, "scripts", "playtest.ts"), REACT_ONLY_PLAYTEST_SOURCE, "utf-8");
 }
 function rewriteTsconfig(targetDir, engineRelPath, editorRelPath) {
   const tsconfigPath = join15(targetDir, "tsconfig.json");
@@ -296655,8 +296665,8 @@ function defaultCreateDependencyMode() {
   return existsSync21(join25(ENGINE_ROOT, "packages", "engine")) ? "link" : "registry";
 }
 function cliVersion() {
-  if ("0.4.1-canary.20260715.0") {
-    return "0.4.1-canary.20260715.0";
+  if ("0.4.1") {
+    return "0.4.1";
   }
   try {
     const pkg = JSON.parse(readFileSync20(join25(__dirname4, "..", "package.json"), "utf8"));
@@ -296675,7 +296685,7 @@ function bakedTargetVersions() {
   if (false)
     return void 0;
   try {
-    return JSON.parse('{"@vgai/engine":"0.4.1-canary.20260715.0","@vgai/editor":"0.4.1-canary.20260715.0","@vgai/p2p-colyseus":"0.4.1-canary.20260715.0","@vgai/probe":"0.4.1-canary.20260715.0","@vgai/live":"0.4.1-canary.20260715.0","@vgai/sdk":"0.4.1-canary.20260715.0","@vgai/editor-sdk":"0.4.1-canary.20260715.0","@vgai/cli":"0.4.1-canary.20260715.0"}');
+    return JSON.parse('{"@vgai/engine":"0.4.1","@vgai/editor":"0.4.1","@vgai/p2p-colyseus":"0.4.1","@vgai/probe":"0.4.1","@vgai/live":"0.4.1","@vgai/sdk":"0.4.1","@vgai/editor-sdk":"0.4.1","@vgai/cli":"0.4.1"}');
   } catch {
     return void 0;
   }
@@ -296765,7 +296775,7 @@ Project:
   run <name>                  Run a Node-hosted project capability with validated JSON input
     --describe                Print the selected capability's schemas and metadata without running
     --input <file|->           Read input JSON from a file or stdin (default: {})
-    --yes                      Confirm write/destructive operation execution
+    --yes                      Confirm write/destructive tool execution
     --json                     Print the full machine-readable catalog/outcome
   upgrade [folder]            Report + re-sync + re-pin against this engine checkout (default: cwd)
     --report                  Report only \u2014 never write to disk
@@ -296938,7 +296948,7 @@ Display:
   grid <on|off>               Set grid visibility
   helpers <on|off>            Set helpers visibility
   stats <on|off>              Set stats overlay
-  shading <mode>              Set shading: solid, wireframe, unlit
+  shading <mode>              Set active viewport shading: solid, unlit, wireframe, normals, overdraw
 
 State:
   status                      Print full editor state
@@ -298603,12 +298613,12 @@ async function run() {
           console.error(usage);
           process.exit(EXIT_CODES.VALIDATION_ERROR);
         }
-        const catalog = await getClient().listProjectOperations();
+        const catalog = await getClient().listProjectTools();
         if (runArgs.includes("--json")) {
           console.log(JSON.stringify(catalog, null, 2));
           break;
         }
-        for (const operation of catalog.operations) {
+        for (const operation of catalog.tools) {
           console.log(
             `${operation.name}	${operation.host}	${operation.permission.risk}	${operation.summary}`
           );
@@ -298616,8 +298626,8 @@ async function run() {
         for (const error48 of catalog.loadErrors) {
           console.error(`\u2717 ${error48.sourcePath}: ${error48.message}`);
         }
-        if (catalog.operations.length === 0 && catalog.loadErrors.length === 0) {
-          console.log("No project operations found.");
+        if (catalog.tools.length === 0 && catalog.loadErrors.length === 0) {
+          console.log("No project tools found.");
         }
         break;
       }
@@ -298630,8 +298640,8 @@ async function run() {
           console.error(usage);
           process.exit(EXIT_CODES.VALIDATION_ERROR);
         }
-        const catalog = await getClient().listProjectOperations();
-        const operation = catalog.operations.find((entry) => entry.name === name);
+        const catalog = await getClient().listProjectTools();
+        const operation = catalog.tools.find((entry) => entry.name === name);
         if (!operation) {
           console.error(`No project capability is named ${JSON.stringify(name)}.`);
           process.exit(EXIT_CODES.VALIDATION_ERROR);
@@ -298666,12 +298676,12 @@ ${JSON.stringify(operation.resultSchema, null, 2)}`);
           );
         } catch (error48) {
           console.error(
-            `Invalid operation input JSON: ${error48 instanceof Error ? error48.message : error48}`
+            `Invalid tool input JSON: ${error48 instanceof Error ? error48.message : error48}`
           );
           process.exit(EXIT_CODES.VALIDATION_ERROR);
         }
       }
-      const outcome = await getClient().runProjectOperation(name, input, {
+      const outcome = await getClient().runProjectTool(name, input, {
         confirm: runArgs.includes("--yes")
       });
       console.log(JSON.stringify(outcome, null, 2));
@@ -299423,11 +299433,11 @@ Choose exactly one target: project, --port, or --all.`);
       break;
     case "shading":
       if (hasHelpFlag(args)) {
-        console.log("Usage: vgai shading <solid|wireframe|unlit>");
+        console.log("Usage: vgai shading <solid|unlit|wireframe|normals|overdraw>");
         break;
       }
-      if (!args[1]) {
-        console.error("Usage: vgai shading <solid|wireframe|unlit>");
+      if (!["solid", "unlit", "wireframe", "normals", "overdraw"].includes(args[1] ?? "")) {
+        console.error("Usage: vgai shading <solid|unlit|wireframe|normals|overdraw>");
         process.exit(1);
       }
       await getClient().setShadingMode(args[1]);

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/cli",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.4.1-canary.20260715.0",
+  "version": "0.4.1",
   "type": "module",
   "repository": {
     "type": "git",
@@ -28,13 +28,13 @@
   },
   "dependencies": {
     "@oclif/core": "^4.11.14",
-    "@vgai/editor": "0.4.1-canary.20260715.0",
-    "@vgai/editor-sdk": "0.4.1-canary.20260715.0",
-    "@vgai/engine": "0.4.1-canary.20260715.0",
-    "@vgai/live": "0.4.1-canary.20260715.0",
-    "@vgai/p2p-colyseus": "0.4.1-canary.20260715.0",
-    "@vgai/probe": "0.4.1-canary.20260715.0",
-    "@vgai/sdk": "0.4.1-canary.20260715.0",
+    "@vgai/editor": "0.4.1",
+    "@vgai/editor-sdk": "0.4.1",
+    "@vgai/engine": "0.4.1",
+    "@vgai/live": "0.4.1",
+    "@vgai/p2p-colyseus": "0.4.1",
+    "@vgai/probe": "0.4.1",
+    "@vgai/sdk": "0.4.1",
     "ink": "^7.1.0",
     "playwright": "^1.58.2",
     "react": "^19.2.4",