@genex-ai/cli-demo 1.9.3-dev.519 → 1.10.0-dev.521

package/dist/index.js

@@ -219,6 +219,11 @@ var c = {
 
 // src/lib/api.ts
 var CLI_VERSION_HEADER = "x-genex-cli-version";
+var WORKSPACE_HEADER = "x-genex-workspace";
+var workspaceLabel = null;
+function setWorkspaceHeader(label) {
+  workspaceLabel = label;
+}
 function formatUpdateRequired(body) {
   const action = body.action ?? `npm i -D @genex-ai/cli-demo@${CLI_CHANNEL}`;
   const message = body.message ?? `Genex CLI ${body.clientVersion ?? getCliVersion()} is below the minimum supported version${body.minVersion ? ` ${body.minVersion}` : ""}.`;
@@ -255,6 +260,9 @@ function printedStructuredError(res) {
 async function apiFetch(url, init2 = {}) {
   const headers = new Headers(init2.headers);
   if (!headers.has(CLI_VERSION_HEADER)) headers.set(CLI_VERSION_HEADER, getCliVersion());
+  if (workspaceLabel && !headers.has(WORKSPACE_HEADER)) {
+    headers.set(WORKSPACE_HEADER, workspaceLabel);
+  }
   const res = await fetch(url, { ...init2, headers });
   if (res.status === 426) {
     try {
@@ -816,6 +824,25 @@ import path4 from "path";
 function getProjectMetadataPath(cwd = process.cwd()) {
   return path4.join(cwd, ".genex", "project.json");
 }
+function getWorkspacePath(cwd = process.cwd()) {
+  return path4.join(cwd, ".genex", "workspace.json");
+}
+async function readWorkspace(cwd = process.cwd()) {
+  try {
+    const raw = await fs4.readFile(getWorkspacePath(cwd), "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+async function writeWorkspace(meta, cwd = process.cwd()) {
+  const file = getWorkspacePath(cwd);
+  await fs4.mkdir(path4.dirname(file), { recursive: true });
+  await fs4.writeFile(file, JSON.stringify(meta, null, 2) + "\n", { mode: 384 });
+  await fs4.chmod(file, 384).catch(() => {
+  });
+  return { path: file };
+}
 async function writeUserToken(token, envPath) {
   const { path: written } = await writeEnvVar(getGenexEnvPath(envPath), ENV_TOKEN_KEY, token);
   return { path: written };
@@ -954,6 +981,7 @@ async function walk(rootSrc, src, dest, opts, result) {
     const destPath = path5.join(dest, entry.name);
     const rel = path5.relative(rootSrc, srcPath);
     if (opts.exclude?.includes(rel)) continue;
+    if (opts.filter && !opts.filter(rel)) continue;
     if (entry.isDirectory()) {
       await fs5.mkdir(destPath, { recursive: true });
       await walk(rootSrc, srcPath, destPath, opts, result);
@@ -1017,10 +1045,20 @@ Important note: put soul into your creations, with many details and love. Aim to
 19. If the game sells anything, it sells it for coin at a fixed, visible price, and NEVER sells chance. Run this test on any purchasable thing before building it: does the player pay (with coin, or with anything coin bought, directly or indirectly), is the outcome uncertain when they pay, and is there a prize they wanted \u2014 all three yes means it is paid randomness, and you build the deterministic version instead. That rules out loot boxes, gacha, mystery boxes, crates, card packs, prize wheels and raffles; wagering, staking, betting, coinflips and casino or slot mechanics denominated in coin; and donation prompts, tip jars or any player-to-player coin transfer, because coin buys goods and never just moves. Randomness the player EARNS by playing is gameplay, not commerce \u2014 an enemy dropping a random item, a chest found in the level, a procedural layout, a crit roll \u2014 and is completely fine. Every coin price renders its real-money equivalent beside it (the server sends one with every item), item prices sit on the platform's price grid so no player is left holding change they cannot spend, and nothing in a shop carries a countdown, "limited time", or a stock counter. When a request crosses one of these lines, name the mechanic, give the one-sentence reason, propose a specific compliant alternative, and build that \u2014 never the banned version "as an option", never a partial one, and never after asking the player to confirm they want it. Load \`$genex-monetization\` before building a shop.
 ${CONTRACT_END}
 `;
+var GENEX_TOOLS_CONTRACT_BLOCK = `${CONTRACT_BEGIN}
+# Genex Tools (always in effect in this folder)
+
+This folder uses **Genex Tools**: AI asset generation for games, from your terminal. All via \`npx genex \u2026\` \u2014 \`model "<prompt>"\` (plus \`model --image <file>\` from a reference photo, \`model segment <id>\` into named parts, \`model rig <id>\` across 7 body plans, \`model animate <rig-id> --preset walk\`) \xB7 \`image\` (\`--transparent\` \xB7 \`--edit\` \xB7 \`--inpaint\` \xB7 \`--remove-bg\` \xB7 \`--upscale\`) \xB7 \`video\` \xB7 \`texture\` \xB7 \`sfx\` \xB7 \`music\` \xB7 \`voice\` \xB7 rigged \`character\` / \`creature\` and \`character animate <id> "<verb>"\` \xB7 \`animations search\` \xB7 \`wait <id>\` / \`wait --all\` \xB7 \`doctor\`. Full options with costs: \`npx genex --help\`. Each tool has a skill card (\`genex-tool-\u2026\`) \u2014 load the one for the lane you are using. Whatever this project builds and wherever it ships is the user's own; Genex generates the assets and nothing more.
+
+1. **NEVER delete, empty, move, rename, or overwrite anything you did not create yourself.** This is someone's real project: it holds their code, their reference images, their notes, an earlier attempt \u2014 files that may exist nowhere else and have no undo, no trash, no backup. A non-empty folder is NORMAL and is never something to clean up, and "start clean" is never a reason. That rules out \`rm\`/\`rm -rf\`, \`git clean\`, \`git checkout -- .\`, \`git reset --hard\` over their work, deleting to resolve a conflict or a stuck prompt, and every tool's offer to empty a directory (\`--force\`, \`--overwrite\`, "Remove existing files"). You may add files and edit the ones you wrote. If a step genuinely cannot continue without removing something of theirs, STOP and ask, naming the exact files, and wait for a yes \u2014 "it looks like junk" is never that yes.
+2. **Generated assets are local files the user owns.** Every generation downloads into \`./assets/\` and the command prints the local path \u2014 wire THAT path into the code, exactly like an asset they drew themselves. The URL printed beside it is provenance, not hosting: never fetch it at runtime, never ship a build that depends on it. Assets are theirs to move, rename, commit, or process further.
+3. **Run \`npx genex doctor\` when a command fails, and before promising what you can generate.** It reports sign-in, credit balance, and which generation lanes are actually live on this account \u2014 the only live source for all three. Treat every genex warning line as work, not noise, and never re-run a generation command to "retry" one that is still running: that bills a second asset. Attach to the first with \`npx genex wait <id>\`.
+${CONTRACT_END}
+`;
 var CLAUDE_IMPORT_LINE = "@AGENTS.md";
 var CONTRACT_REGION = /<!-- genex:contract:begin[^\n]*-->[\s\S]*?<!-- genex:contract:end -->/;
-function mergeContractBlock(existing) {
-  const block = GENEX_CONTRACT_BLOCK.trimEnd();
+function mergeContractBlock(existing, contractBlock = GENEX_CONTRACT_BLOCK) {
+  const block = contractBlock.trimEnd();
   if (existing === null || existing.trim() === "") return `${block}
 `;
   if (CONTRACT_REGION.test(existing)) {
@@ -1035,7 +1073,7 @@ function mergeContractBlock(existing) {
 ${block}
 `;
 }
-async function writeAgentsContract(projectDir) {
+async function writeAgentsContract(projectDir, contractBlock = GENEX_CONTRACT_BLOCK) {
   let changed = false;
   try {
     const agentsPath = path6.join(projectDir, "AGENTS.md");
@@ -1045,7 +1083,7 @@ async function writeAgentsContract(projectDir) {
     } catch {
       existing = null;
     }
-    const next = mergeContractBlock(existing);
+    const next = mergeContractBlock(existing, contractBlock);
     if (next !== existing) {
       await fs6.writeFile(agentsPath, next, "utf8");
       changed = true;
@@ -1072,19 +1110,25 @@ ${CLAUDE_IMPORT_LINE}
   }
   return changed;
 }
+async function writeToolsContract(projectDir) {
+  return writeAgentsContract(projectDir, GENEX_TOOLS_CONTRACT_BLOCK);
+}
 async function healAncestorContracts(projectDir, stopDir = os4.homedir()) {
   const findings = [];
   const stop = path6.resolve(stopDir);
   let dir = path6.dirname(path6.resolve(projectDir));
   for (let depth = 0; depth < 20; depth++) {
     try {
-      let isProject = false;
-      try {
-        await fs6.access(path6.join(dir, ".genex", "project.json"));
-        isProject = true;
-      } catch {
+      let isWorkspace = false;
+      for (const marker of ["project.json", "workspace.json"]) {
+        try {
+          await fs6.access(path6.join(dir, ".genex", marker));
+          isWorkspace = true;
+          break;
+        } catch {
+        }
       }
-      if (!isProject) {
+      if (!isWorkspace) {
         const agentsPath = path6.join(dir, "AGENTS.md");
         let content = null;
         try {
@@ -1142,6 +1186,45 @@ async function healAncestorContractsAndReport(log, projectDir) {
 import fs7 from "fs/promises";
 import os5 from "os";
 import path7 from "path";
+
+// src/lib/workspace.ts
+async function workspaceMode(cwd = process.cwd()) {
+  if (await readProject(cwd)) return "game";
+  const ws = await readWorkspace(cwd);
+  return ws?.mode === "tools" ? "tools" : null;
+}
+var REFUSED_IN_TOOLS = /* @__PURE__ */ new Set([
+  "link",
+  "pull",
+  "list",
+  "preview",
+  "promote",
+  "publish",
+  "rollback",
+  "rename",
+  "make-remixable",
+  "shop",
+  "domain",
+  "asset",
+  "controller"
+]);
+function refusedInTools(command) {
+  return command !== void 0 && REFUSED_IN_TOOLS.has(command);
+}
+function reportPlatformRefused(log, command) {
+  log.error(`\`genex ${command}\` is not part of Genex Tools.`);
+  log.plain(
+    [
+      "  This workspace is the asset toolkit: generation only. Hosting, publishing, multiplayer,",
+      "  remixing and custom domains are the Genex platform \u2014 a game built there gets all of it",
+      `  from one prompt: ${c.cyan("https://genex.games")}`,
+      `  ${c.cyan("\u2192")} Everything here still works: ${c.cyan("npx genex model|image|video|texture|sfx|music|voice|character")}.`,
+      `  ${c.cyan("\u2192")} ${c.cyan("npx genex doctor")} lists what this account can generate right now.`
+    ].join("\n")
+  );
+}
+
+// src/lib/updates.ts
 function parseSemver(v) {
   const m = /^(\d+)\.(\d+)\.(\d+)$/.exec(v.trim());
   if (!m) return null;
@@ -1181,6 +1264,22 @@ async function hasGenexSkills(skillsDir) {
     return false;
   }
 }
+var TOOL_SKILL_PREFIX = "genex-tool-";
+function skillFamilyOf(name) {
+  return name.startsWith(TOOL_SKILL_PREFIX) ? "tools" : "game";
+}
+function skillFamilyFilter(mode) {
+  return (rel) => {
+    const segments = rel.split(/[\\/]/);
+    const top = segments[0] ?? "";
+    if (top !== "skills") {
+      return mode === "game";
+    }
+    const skill = segments[1];
+    if (skill === void 0) return true;
+    return skillFamilyOf(skill) === mode;
+  };
+}
 var REMOVED_SKILLS = [
   "genex-explore",
   "genex-threejs-procedural-materials",
@@ -1232,13 +1331,18 @@ async function pruneRemovedSkills(skillsDir, log) {
   }
   return removed.length > 0;
 }
-async function syncSkillsForTarget(target, templatesDir = getTemplatesDir(), version = getCliVersion(), log) {
+async function syncSkillsForTarget(target, templatesDir = getTemplatesDir(), version = getCliVersion(), log, family = "game") {
   const skillsDir = path7.join(target.baseDir, "skills");
   if (!await hasGenexSkills(skillsDir)) return false;
   if (await readSkillsMarker(skillsDir) === version) return false;
   const src = target.full ? templatesDir : path7.join(templatesDir, "skills");
   const dest = target.full ? target.baseDir : skillsDir;
-  await copyTemplates(src, dest, { exclude: ["controllers", "motion", "asset-viewer"] });
+  const familyFilter = skillFamilyFilter(family);
+  const filter = target.full ? familyFilter : (rel) => familyFilter(`skills/${rel}`);
+  await copyTemplates(src, dest, {
+    exclude: ["controllers", "motion", "asset-viewer"],
+    filter
+  });
   await pruneRemovedSkills(skillsDir, log);
   await writeSkillsMarker(skillsDir, version);
   return true;
@@ -1287,23 +1391,32 @@ async function cleanupLegacyGlobalSkills(log) {
     return false;
   }
 }
-async function syncSkills(log) {
+async function syncSkills(log, mode) {
   try {
     await cleanupLegacyGlobalSkills(log);
     const version = getCliVersion();
     const templatesDir = getTemplatesDir();
+    const resolved = mode !== void 0 ? mode : await workspaceMode();
+    const family = resolved === "tools" ? "tools" : "game";
     let refreshed = false;
     for (const target of resolveAgentTargets()) {
       try {
-        refreshed = await syncSkillsForTarget(target, templatesDir, version, log) || refreshed;
+        refreshed = await syncSkillsForTarget(target, templatesDir, version, log, family) || refreshed;
       } catch {
       }
     }
     if (refreshed) log.plain(`\u{1F504} Genex skills updated to ${version}`);
     try {
-      await fs7.access(path7.join(process.cwd(), ".genex", "project.json"));
-      if (await writeAgentsContract(process.cwd())) {
-        log.plain("\u{1F504} Genex build contract refreshed (AGENTS.md managed block)");
+      if (resolved === "game") {
+        if (await writeAgentsContract(process.cwd())) {
+          log.plain("\u{1F504} Genex build contract refreshed (AGENTS.md managed block)");
+        }
+      } else if (resolved === "tools") {
+        if (await writeToolsContract(process.cwd())) {
+          log.plain("\u{1F504} Genex Tools workspace rules refreshed (AGENTS.md managed block)");
+        }
+      } else {
+        return;
       }
       await healAncestorContractsAndReport(log, process.cwd());
     } catch {
@@ -1706,6 +1819,19 @@ function warnPreexisting(log, entries) {
 }
 async function runInit(opts) {
   const log = createLogger({ quiet: opts.quiet });
+  if ((await readWorkspace())?.mode === "tools") {
+    log.error("This folder is a Genex Tools workspace.");
+    log.plain(
+      [
+        "  It has the generation toolkit installed for a game you host yourself \u2014 creating a",
+        "  hosted genex game here would install a second, conflicting set of agent instructions.",
+        `  ${c.cyan("\u2192")} Building a genex-hosted game? Run ${c.cyan("npx genex init")} in its own folder.`,
+        `  ${c.cyan("\u2192")} Just want the tools working? ${c.cyan("npx genex doctor")} says what needs fixing.`
+      ].join("\n")
+    );
+    process.exitCode = 1;
+    return;
+  }
   log.plain(c.bold("genex init"));
   log.plain("");
   const preexisting = await listPreexistingEntries(process.cwd());
@@ -1722,7 +1848,8 @@ async function runInit(opts) {
     const dest = t.full ? t.baseDir : path10.join(t.baseDir, "skills");
     const { copied, updated } = await copyTemplates(src, dest, {
       force: opts.force,
-      exclude: ["controllers", "motion", "asset-viewer"]
+      exclude: ["controllers", "motion", "asset-viewer"],
+      filter: t.full ? skillFamilyFilter("game") : (rel) => skillFamilyFilter("game")(`skills/${rel}`)
     });
     await pruneRemovedSkills(path10.join(t.baseDir, "skills"), log);
     await writeSkillsMarker(path10.join(t.baseDir, "skills"));
@@ -6685,8 +6812,8 @@ async function runRollback(opts) {
 }
 
 // src/commands/generate.ts
-import fs20 from "fs/promises";
-import path19 from "path";
+import fs21 from "fs/promises";
+import path20 from "path";
 import { PNG as PNG4 } from "pngjs";
 
 // src/lib/glass.ts
@@ -6766,6 +6893,96 @@ function solveMagentaGlass(source) {
   return { ...base, png: out, ok: true };
 }
 
+// src/lib/download-assets.ts
+import fs20 from "fs/promises";
+import path19 from "path";
+var RUNG_ROLE = /@\d+$/;
+function isPrimaryRole(role) {
+  return !RUNG_ROLE.test(role);
+}
+function primaryFiles(files) {
+  return files.filter((f) => isPrimaryRole(f.role));
+}
+function localAssetName(kind, prompt, id, file, multi) {
+  const slug = prompt.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40).replace(/-+$/, "");
+  const base = `${slug || kind}-${id.slice(0, 8)}`;
+  const role = multi ? `-${file.role.replace(/^(texture|image|character|model|model_anim|model-anim)-/, "")}` : "";
+  const ext = file.ext.replace(/^\./, "") || "bin";
+  return `${base}${role}.${ext}`;
+}
+async function downloadAssets(files, opts) {
+  const wanted = primaryFiles(files);
+  const result = { saved: [], failures: [] };
+  if (wanted.length === 0) return result;
+  try {
+    await fs20.mkdir(opts.outDir, { recursive: true });
+  } catch (err) {
+    result.failures.push(
+      `couldn't create ${opts.outDir} (${err instanceof Error ? err.message : String(err)})`
+    );
+    return result;
+  }
+  const multi = wanted.length > 1;
+  for (const file of wanted) {
+    const dest = path19.join(opts.outDir, localAssetName(opts.kind, opts.prompt, opts.id, file, multi));
+    try {
+      const res = await fetch(file.url);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      const buf = Buffer.from(await res.arrayBuffer());
+      await fs20.writeFile(dest, buf);
+      result.saved.push({ role: file.role, path: dest, url: file.url, bytes: buf.byteLength });
+    } catch (err) {
+      result.failures.push(
+        `${file.role}: ${err instanceof Error ? err.message : String(err)} \u2014 the asset is still live at ${file.url}`
+      );
+    }
+  }
+  return result;
+}
+function formatBytes(bytes) {
+  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+  if (bytes >= 1024) return `${Math.round(bytes / 1024)} KB`;
+  return `${bytes} B`;
+}
+var DEFAULT_ASSET_DIR = "./assets";
+function localDeliveryFor(mode, opts, prompt) {
+  if (mode !== "tools" || opts.noDownload) return void 0;
+  return { outDir: opts.outDir ?? DEFAULT_ASSET_DIR, prompt };
+}
+
+// src/lib/lanes.ts
+async function fetchLanes(apiUrl, token, timeoutMs = 4e3) {
+  try {
+    const res = await apiFetch(`${apiUrl}/api/generations/lanes`, {
+      headers: { Authorization: `Bearer ${token}` },
+      signal: AbortSignal.timeout(timeoutMs)
+    });
+    if (!res.ok) return null;
+    const body = await res.json();
+    if (!Array.isArray(body.lanes)) return null;
+    return {
+      lanes: body.lanes.filter(
+        (l) => !!l && typeof l.kind === "string" && typeof l.provider === "string"
+      ),
+      paused: body.paused === true
+    };
+  } catch {
+    return null;
+  }
+}
+function laneFor(report, kind) {
+  return report?.lanes.find((l) => l.kind === kind);
+}
+function mockLaneRefusal(kind, provider) {
+  return [
+    `The \`${kind}\` lane on this server has no provider key \u2014 it is running in SAMPLE mode (${provider}).`,
+    "  A generation would succeed, spend credits, and return a placeholder asset that looks real.",
+    "  Refusing before anything is charged.",
+    "  \u2192 On genex.games every lane is live; this is a self-hosted or partially configured stand.",
+    "  \u2192 `npx genex doctor` lists every lane's status."
+  ];
+}
+
 // src/lib/open.ts
 import { spawn as spawn5 } from "child_process";
 function tokenize(cmd) {
@@ -6856,7 +7073,7 @@ var isRemoteRef = (value) => /^(https?:\/\/|data:)/i.test(value);
 async function inlineLocalImage(filePath, flag) {
   let bytes;
   try {
-    bytes = await fs20.readFile(filePath);
+    bytes = await fs21.readFile(filePath);
   } catch {
     return { ok: false, error: `Couldn't read the ${flag} file at ${filePath}.` };
   }
@@ -6866,7 +7083,7 @@ async function inlineLocalImage(filePath, flag) {
       error: `${flag} file is ${(bytes.length / 1048576).toFixed(1)} MB \u2014 over the ~4 MB inline limit. Downscale/compress it first, or pass an asset URL instead.`
     };
   }
-  const mime = IMAGE_MIME_BY_EXT[path19.extname(filePath).toLowerCase()] ?? "image/png";
+  const mime = IMAGE_MIME_BY_EXT[path20.extname(filePath).toLowerCase()] ?? "image/png";
   return { ok: true, dataUri: `data:${mime};base64,${bytes.toString("base64")}` };
 }
 var SKYBOX_ENVIRONMENT_SUFFIX = ". The image contains ONLY sky: cloud, atmosphere, light, weather and distant haze at the horizon. Every structure, object, plant and ground surface is outside the frame.";
@@ -7023,7 +7240,7 @@ async function runGenerate(kind, opts) {
   let typedPrompt = opts.prompt?.trim();
   if (!typedPrompt && kind === "model" && opts.imageUrl) {
     const ref = opts.imageUrl.startsWith("data:") ? "local image" : opts.imageUrl;
-    typedPrompt = `from image: ${path19.basename(ref).slice(0, 120)}`;
+    typedPrompt = `from image: ${path20.basename(ref).slice(0, 120)}`;
   }
   if (!typedPrompt) {
     log.error(`Missing prompt. Usage: ${c.cyan(`genex ${kind} "<prompt>"`)}`);
@@ -7067,7 +7284,7 @@ async function runGenerate(kind, opts) {
       return;
     }
     try {
-      const bytes = await fs20.readFile(opts.inpaintUrl);
+      const bytes = await fs21.readFile(opts.inpaintUrl);
       opts = { ...opts, inpaintUrl: `data:image/png;base64,${bytes.toString("base64")}` };
     } catch {
       log.error(`Couldn't read the --inpaint mask at ${opts.inpaintUrl}.`);
@@ -7115,6 +7332,17 @@ async function runGenerate(kind, opts) {
   }
   const meta = await readProject();
   const apiUrl = getApiUrl(opts.apiUrl ?? meta?.apiUrl);
+  const mode = await workspaceMode();
+  if (mode === "tools") {
+    const lane = laneFor(await fetchLanes(apiUrl, token), kind);
+    if (lane?.mock) {
+      const [headline, ...rest] = mockLaneRefusal(kind, lane.provider);
+      log.error(headline);
+      log.plain(rest.join("\n"));
+      process.exitCode = 1;
+      return;
+    }
+  }
   const options = buildGenOptions(kind, opts);
   log.plain(c.bold(`genex ${kind}`));
   log.dim(`  ${prompt}`);
@@ -7187,10 +7415,20 @@ async function runGenerate(kind, opts) {
       process.exitCode = 1;
       return id;
     }
-    await reportGlassTerminal(view, opts.outDir ?? ".", log, opts.json ?? false);
+    const glassDir = opts.outDir ?? (mode === "tools" ? DEFAULT_ASSET_DIR : ".");
+    await reportGlassTerminal(view, glassDir, log, opts.json ?? false);
     return id;
   }
-  await awaitAndReport(apiUrl, token, id, kind, log, opts.open, opts.json);
+  await awaitAndReport(
+    apiUrl,
+    token,
+    id,
+    kind,
+    log,
+    opts.open,
+    opts.json,
+    localDeliveryFor(mode, opts, prompt)
+  );
   return id;
 }
 async function reportGlassTerminal(view, outDir, log, json) {
@@ -7200,7 +7438,7 @@ async function reportGlassTerminal(view, outDir, log, json) {
     return;
   }
   await recordTerminal(view.id, "completed", files.map((f) => f.url));
-  await fs20.mkdir(outDir, { recursive: true });
+  await fs21.mkdir(outDir, { recursive: true });
   const solved = [];
   for (let i = 0; i < files.length; i++) {
     const f = files[i];
@@ -7232,8 +7470,8 @@ async function reportGlassTerminal(view, outDir, log, json) {
       });
       continue;
     }
-    const outPath = path19.join(outDir, `glass-${i + 1}.png`);
-    await fs20.writeFile(outPath, PNG4.sync.write(r.png));
+    const outPath = path20.join(outDir, `glass-${i + 1}.png`);
+    await fs21.writeFile(outPath, PNG4.sync.write(r.png));
     solved.push({
       path: outPath,
       url: f.url,
@@ -7269,7 +7507,7 @@ async function reportGlassTerminal(view, outDir, log, json) {
     process.exitCode = 1;
   }
 }
-async function awaitAndReport(apiUrl, token, id, kind, log, open = false, json = false) {
+async function awaitAndReport(apiUrl, token, id, kind, log, open = false, json = false, local) {
   if (!json) log.step("Generating\u2026 (this can take up to a minute)");
   const view = await waitForTerminalView(
     apiUrl,
@@ -7285,7 +7523,7 @@ async function awaitAndReport(apiUrl, token, id, kind, log, open = false, json =
     process.exitCode = 1;
     return;
   }
-  await reportTerminal(kind, view, log, open, json);
+  await reportTerminal(kind, view, log, open, json, local);
 }
 async function waitForTerminalView(apiUrl, token, id, kind, onProgress = () => {
 }) {
@@ -7294,7 +7532,7 @@ async function waitForTerminalView(apiUrl, token, id, kind, onProgress = () => {
   const streamed = await waitViaSSE(apiUrl, token, id, onProgress, deadline);
   return streamed === "unsupported" ? poll(apiUrl, token, id, onProgress, timeoutMs) : streamed;
 }
-async function reportTerminal(kind, view, log, open = false, json = false) {
+async function reportTerminal(kind, view, log, open = false, json = false, local) {
   if (view.status !== "completed") {
     if (json) writeJson({ kind, id: view.id, status: view.status, error: view.error ?? null });
     else log.error(`Generation ${view.status}${view.error ? `: ${view.error}` : ""}.`);
@@ -7319,12 +7557,20 @@ async function reportTerminal(kind, view, log, open = false, json = false) {
     return;
   }
   await recordTerminal(view.id, "completed", files.map((f) => f.url));
+  const delivered = local ? await downloadAssets(files, {
+    kind,
+    prompt: local.prompt,
+    id: view.id,
+    outDir: local.outDir
+  }) : null;
   if (kind === "character_concept") {
     reportCharacterConceptTerminal(view, log, { json, open });
+    if (delivered) reportLocalFiles(delivered, log, json);
     return;
   }
   if (kind === "character_preview") {
     reportCharacterPreviewTerminal(view, log, { json, open });
+    if (delivered) reportLocalFiles(delivered, log, json);
     return;
   }
   if (json) {
@@ -7333,6 +7579,7 @@ async function reportTerminal(kind, view, log, open = false, json = false) {
       id: view.id,
       status: view.status,
       files,
+      ...delivered ? { saved: delivered.saved, downloadFailures: delivered.failures } : {},
       ...kind === "character" ? {
         characterId: view.id,
         nextCommand: `genex controller character --character ${view.id}`
@@ -7341,10 +7588,14 @@ async function reportTerminal(kind, view, log, open = false, json = false) {
     return;
   }
   log.plain("");
-  log.success("Done \u2014 live on R2 (nothing downloaded or committed):");
-  for (const f of files) {
-    const label = files.length > 1 ? `${c.dim(`${f.role.replace(/^texture-/, "")}: `)}` : "";
-    log.plain(`  ${label}${f.url}`);
+  if (delivered) {
+    reportLocalFiles(delivered, log, false);
+  } else {
+    log.success("Done \u2014 live on R2 (nothing downloaded or committed):");
+    for (const f of files) {
+      const label = files.length > 1 ? `${c.dim(`${f.role.replace(/^texture-/, "")}: `)}` : "";
+      log.plain(`  ${label}${f.url}`);
+    }
   }
   log.plain("");
   if (kind === "texture" && files[0]) await reportTextureSeam(files[0].url, log);
@@ -7362,7 +7613,22 @@ async function reportTerminal(kind, view, log, open = false, json = false) {
     log.plain(`     ${files[0].url}`);
     log.plain("");
   }
-  printHint(kind, view, files, log);
+  printHint(kind, view, files, log, delivered !== null);
+}
+function reportLocalFiles(result, log, json) {
+  if (json) return;
+  if (result.saved.length > 0) {
+    log.success(
+      `Done \u2014 ${result.saved.length} file${result.saved.length === 1 ? "" : "s"} saved to your project:`
+    );
+    for (const s of result.saved) {
+      log.plain(`  ${s.path}  ${c.dim(`(${formatBytes(s.bytes)})`)}`);
+    }
+    log.dim(`  source of record (provenance, not hosting): ${result.saved[0].url}`);
+  }
+  for (const failure of result.failures) {
+    log.error(`Couldn't save one file \u2014 ${failure}`);
+  }
 }
 function laneFailureAdvice(kind, outcomes) {
   if (outcomes.failed < 2 || outcomes.completed > 0) return null;
@@ -7529,9 +7795,11 @@ function assetHint(kind, view, url) {
   const base = hint[kind];
   return url && HINT_URL_KINDS.has(kind) ? `${base} url = "${url}"` : base;
 }
-function printHint(kind, view, files, log) {
-  log.dim(`  ${assetHint(kind, view, files[0]?.url ?? "")}`);
-  log.dim("  Reference the URL directly in your code \u2014 don't download it into the repo.");
+function printHint(kind, view, files, log, local = false) {
+  log.dim(`  ${assetHint(kind, view, local ? void 0 : files[0]?.url ?? "")}`);
+  log.dim(
+    local ? "  Wire the LOCAL path into your code \u2014 the file is yours. Never fetch the URL at runtime." : "  Reference the URL directly in your code \u2014 don't download it into the repo."
+  );
 }
 var CONCEPT_STOP = "STOP \u2014 show all three concept images to the user and wait for an explicit selection. Do not create the 3D preview until they choose candidate 1, 2, or 3.";
 function metadataOf(view) {
@@ -7833,11 +8101,13 @@ async function runWait(opts) {
     return;
   }
   const kind = view.kind ?? "image";
+  const ledgerPrompt = (await readLedger(opts.cwd ?? process.cwd())).find((e) => e.id === id)?.prompt;
+  const local = localDeliveryFor(await workspaceMode(), opts, ledgerPrompt || kind);
   log.plain(c.bold("genex wait"));
   log.dim(`  ${kind} ${id}`);
   log.plain("");
   if (TERMINAL2.has(view.status)) {
-    await reportTerminal(kind, view, log, opts.open, opts.json);
+    await reportTerminal(kind, view, log, opts.open, opts.json, local);
     return;
   }
   if (kind === "character_concept" || kind === "character_preview" || kind === "character") {
@@ -7845,7 +8115,7 @@ async function runWait(opts) {
       `  \u23F3 Character stages take several minutes server-side \u2014 you don't have to sit here. Keep building and check back with ${c.cyan("genex wait --all")}.`
     );
   }
-  await awaitAndReport(apiUrl, token, id, kind, log, opts.open, opts.json);
+  await awaitAndReport(apiUrl, token, id, kind, log, opts.open, opts.json, local);
 }
 async function runWaitAll(opts) {
   const log = createLogger({ quiet: opts.quiet || opts.json });
@@ -7967,8 +8237,8 @@ async function toRow(e, v, cwd) {
 }
 
 // src/commands/controller.ts
-import fs22 from "fs/promises";
-import path21 from "path";
+import fs23 from "fs/promises";
+import path22 from "path";
 
 // ../../packages/meshy-animation-catalog/src/index.ts
 import { createHash } from "crypto";
@@ -17098,9 +17368,9 @@ function searchMeshyAnimations(query, options = {}) {
 }
 
 // src/lib/anims.ts
-import fs21 from "fs/promises";
-import path20 from "path";
-var ANIMS_DEST = path20.join("public", "assets", "anims");
+import fs22 from "fs/promises";
+import path21 from "path";
+var ANIMS_DEST = path21.join("public", "assets", "anims");
 var HIDDEN_TAG = "reference";
 async function runAnims(opts) {
   const log = createLogger({ quiet: opts.quiet });
@@ -17116,7 +17386,7 @@ async function runAnims(opts) {
     printCatalog(log, manifest, selectors);
     return;
   }
-  const controllerMarker = path20.join(root, "src", "controllers", "character");
+  const controllerMarker = path21.join(root, "src", "controllers", "character");
   if (!await exists2(controllerMarker)) {
     log.error(
       `No character controller in this game (missing ${c.cyan("src/controllers/character/")}).`
@@ -17125,11 +17395,11 @@ async function runAnims(opts) {
     process.exitCode = 1;
     return;
   }
-  const destDir = path20.join(root, ANIMS_DEST);
-  const gameManifestPath = path20.join(destDir, "manifest.json");
+  const destDir = path21.join(root, ANIMS_DEST);
+  const gameManifestPath = path21.join(destDir, "manifest.json");
   if (opts.reset) {
-    await fs21.rm(destDir, { recursive: true, force: true });
-    log.step(`Cleared ${c.cyan(ANIMS_DEST + path20.sep)} (--reset)`);
+    await fs22.rm(destDir, { recursive: true, force: true });
+    log.step(`Cleared ${c.cyan(ANIMS_DEST + path21.sep)} (--reset)`);
   }
   if (selectors.length === 0) {
     const installed = await readGameManifest(gameManifestPath);
@@ -17167,35 +17437,35 @@ async function runAnims(opts) {
     }
   }
   const wanted = [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
-  const cacheDir = path20.join(
+  const cacheDir = path21.join(
     opts.cacheDir ?? getAnimsCacheDir(),
     `${manifest.library}-v${manifest.version}`
   );
-  await fs21.mkdir(cacheDir, { recursive: true });
-  await fs21.mkdir(destDir, { recursive: true });
+  await fs22.mkdir(cacheDir, { recursive: true });
+  await fs22.mkdir(destDir, { recursive: true });
   const base = getAnimsBase(opts.animsBase);
   let installedCount = 0;
   let presentCount = 0;
   let addedBytes = 0;
   const failures = [];
   for (const entry of wanted) {
-    const dest = path20.join(destDir, entry.file);
+    const dest = path21.join(destDir, entry.file);
     if (await hasSize(dest, entry.bytes)) {
       presentCount++;
       continue;
     }
     try {
-      const cached = path20.join(cacheDir, entry.file);
+      const cached = path21.join(cacheDir, entry.file);
       if (!await hasSize(cached, entry.bytes)) {
         const res = await fetch(base + entry.file);
         if (!res.ok) throw new Error(`HTTP ${res.status}`);
         const buf = Buffer.from(await res.arrayBuffer());
-        await fs21.writeFile(cached, buf);
+        await fs22.writeFile(cached, buf);
       }
-      await fs21.copyFile(cached, dest);
+      await fs22.copyFile(cached, dest);
       installedCount++;
       addedBytes += entry.bytes;
-      log.dim(`  ${path20.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
+      log.dim(`  ${path21.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
     } catch (err) {
       failures.push(`${entry.name} (${err instanceof Error ? err.message : String(err)})`);
     }
@@ -17211,13 +17481,13 @@ async function runAnims(opts) {
     version: manifest.version,
     clips: [...union].sort((a, b) => a.localeCompare(b))
   };
-  await fs21.writeFile(gameManifestPath, JSON.stringify(gameManifest, null, 2) + "\n");
+  await fs22.writeFile(gameManifestPath, JSON.stringify(gameManifest, null, 2) + "\n");
   log.plain("");
   const parts = [`${installedCount} clip${installedCount === 1 ? "" : "s"} installed`];
   if (presentCount > 0) parts.push(`${presentCount} already present`);
   if (bundledSkips > 0) parts.push(`${bundledSkips} already bundled in animation-library.glb`);
   log.success(
-    `${parts.join(", ")} \u2192 ${c.cyan(ANIMS_DEST + path20.sep)}${addedBytes > 0 ? ` (+${formatMb(addedBytes)})` : ""}`
+    `${parts.join(", ")} \u2192 ${c.cyan(ANIMS_DEST + path21.sep)}${addedBytes > 0 ? ` (+${formatMb(addedBytes)})` : ""}`
   );
   for (const [selector, entries] of resolved) {
     const names = entries.filter((e) => !coreNames.has(e.name)).map((e) => e.name);
@@ -17249,8 +17519,8 @@ async function loadManifest(baseOverride) {
     }
   } catch {
   }
-  const snapshotPath = path20.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
-  const manifest = JSON.parse(await fs21.readFile(snapshotPath, "utf8"));
+  const snapshotPath = path21.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
+  const manifest = JSON.parse(await fs22.readFile(snapshotPath, "utf8"));
   return { manifest, source: "snapshot" };
 }
 function resolveSelectors(manifest, selectors) {
@@ -17368,21 +17638,21 @@ function printCatalog(log, manifest, selectors) {
 }
 async function readGameManifest(file) {
   try {
-    return JSON.parse(await fs21.readFile(file, "utf8"));
+    return JSON.parse(await fs22.readFile(file, "utf8"));
   } catch {
     return null;
   }
 }
 async function hasSize(file, bytes) {
   try {
-    return (await fs21.stat(file)).size === bytes;
+    return (await fs22.stat(file)).size === bytes;
   } catch {
     return false;
   }
 }
 async function exists2(p) {
   try {
-    await fs21.access(p);
+    await fs22.access(p);
     return true;
   } catch {
     return false;
@@ -17576,8 +17846,8 @@ var CONTROLLER_FILE_SETS = {
     ]
   }
 };
-var CODE_DEST = path21.join("src", "controllers");
-var ASSETS_DEST = path21.join("public", "assets");
+var CODE_DEST = path22.join("src", "controllers");
+var ASSETS_DEST = path22.join("public", "assets");
 async function runController(opts) {
   const log = createLogger({ quiet: opts.quiet });
   if (opts.kind?.trim() === "anims") {
@@ -17594,31 +17864,31 @@ async function runController(opts) {
     process.exitCode = 1;
     return;
   }
-  const srcDir = path21.join(getTemplatesDir(), "controllers");
+  const srcDir = path22.join(getTemplatesDir(), "controllers");
   const root = opts.cwd ?? process.cwd();
   const set = CONTROLLER_FILE_SETS[kind];
   log.plain(c.bold(`genex controller ${kind}`));
   log.plain("");
-  log.step(`Installing the ${kind} controller into ${c.cyan(CODE_DEST + path21.sep)}`);
+  log.step(`Installing the ${kind} controller into ${c.cyan(CODE_DEST + path22.sep)}`);
   const plan = [
-    ...set.code.map((rel) => ({ from: rel, rel: path21.join(CODE_DEST, rel) })),
+    ...set.code.map((rel) => ({ from: rel, rel: path22.join(CODE_DEST, rel) })),
     ...set.assets.map((rel) => ({
       from: rel,
-      rel: path21.join(ASSETS_DEST, path21.basename(rel))
+      rel: path22.join(ASSETS_DEST, path22.basename(rel))
     }))
   ];
   let copied = 0;
   let skipped = 0;
   try {
     for (const file of plan) {
-      const dest = path21.join(root, file.rel);
+      const dest = path22.join(root, file.rel);
       if (!opts.force && await exists3(dest)) {
         skipped++;
         log.dim(`  skipped ${file.rel} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs22.mkdir(path21.dirname(dest), { recursive: true });
-      await fs22.copyFile(path21.join(srcDir, file.from), dest);
+      await fs23.mkdir(path22.dirname(dest), { recursive: true });
+      await fs23.copyFile(path22.join(srcDir, file.from), dest);
       copied++;
       log.dim(`  ${file.rel}`);
     }
@@ -17671,7 +17941,7 @@ async function runController(opts) {
   for (const line of set.sketch) {
     log.dim(`       ${line}`);
   }
-  if (kind === "character" && !await exists3(path21.join(root, ASSETS_DEST, "meshy-character.json"))) {
+  if (kind === "character" && !await exists3(path22.join(root, ASSETS_DEST, "meshy-character.json"))) {
     log.plain("");
     log.plain(
       `  ${stepOffset + 3}. This game has no generated character yet \u2014 ${c.cyan(
@@ -17703,9 +17973,9 @@ async function installMeshyCharacterManifest(args) {
     throw new Error("The API returned an invalid Meshy character manifest.");
   }
   assertCompleteMeshyControllerPack(manifest);
-  const destination = path21.join(args.root, ASSETS_DEST, "meshy-character.json");
-  await fs22.mkdir(path21.dirname(destination), { recursive: true });
-  await fs22.writeFile(
+  const destination = path22.join(args.root, ASSETS_DEST, "meshy-character.json");
+  await fs23.mkdir(path22.dirname(destination), { recursive: true });
+  await fs23.writeFile(
     destination,
     `${JSON.stringify(manifest, null, 2)}
 `
@@ -17843,14 +18113,14 @@ function assertCompleteMeshyControllerPack(manifest) {
 }
 async function installFallbackAvatar(args) {
   const { root, srcDir, log } = args;
-  const dest = path21.join(root, ASSETS_DEST, "avatar.vrm");
-  await fs22.mkdir(path21.dirname(dest), { recursive: true });
-  await fs22.copyFile(path21.join(srcDir, "assets", "default-avatar.vrm"), dest);
+  const dest = path22.join(root, ASSETS_DEST, "avatar.vrm");
+  await fs23.mkdir(path22.dirname(dest), { recursive: true });
+  await fs23.copyFile(path22.join(srcDir, "assets", "default-avatar.vrm"), dest);
   log.dim("  public/assets/avatar.vrm (fallback avatar \u2014 bundled CC0 default)");
 }
 async function exists3(p) {
   try {
-    await fs22.access(p);
+    await fs23.access(p);
     return true;
   } catch {
     return false;
@@ -17858,8 +18128,8 @@ async function exists3(p) {
 }
 
 // src/commands/character.ts
-import fs23 from "fs/promises";
-import path22 from "path";
+import fs24 from "fs/promises";
+import path23 from "path";
 function exactAnimation(selector) {
   const trimmed = selector.trim();
   if (/^-?\d+$/.test(trimmed)) return animationById(Number(trimmed));
@@ -17939,7 +18209,7 @@ function showAmbiguity(selector, candidates, log, json = false) {
   }
   process.exitCode = 1;
 }
-var INSTALLED_MANIFEST = path22.join("public", "assets", "meshy-character.json");
+var INSTALLED_MANIFEST = path23.join("public", "assets", "meshy-character.json");
 async function resolveAdoptTarget(selector) {
   const trimmed = selector?.trim();
   if (trimmed && !trimmed.endsWith(".json")) {
@@ -17948,7 +18218,7 @@ async function resolveAdoptTarget(selector) {
   const file = trimmed ?? INSTALLED_MANIFEST;
   let raw;
   try {
-    raw = await fs23.readFile(file, "utf8");
+    raw = await fs24.readFile(file, "utf8");
   } catch {
     return {
       ok: false,
@@ -17979,6 +18249,11 @@ async function runCharacterAdopt(opts) {
     fail2(opts, "Not authorized. Run `genex init` first to sign in.", "character");
     return;
   }
+  if (await workspaceMode() === "tools") {
+    reportPlatformRefused(log, "character adopt");
+    process.exitCode = 1;
+    return;
+  }
   const project = await readProject();
   if (!project?.id) {
     fail2(
@@ -18099,7 +18374,7 @@ async function runWorkflow(args) {
     return;
   }
   await recordTerminal(view.id, "completed", (view.files ?? []).map((file) => file.url));
-  await args.completed(view);
+  await args.completed(view, localDeliveryFor(await workspaceMode(), args.opts, args.prompt));
 }
 async function runCharacterConcept(opts) {
   const log = createLogger({ quiet: opts.quiet || opts.json });
@@ -18322,7 +18597,7 @@ async function runCharacterFinalize(opts) {
     createPath: basePath,
     body,
     quote: price,
-    completed: async (view) => {
+    completed: async (view, local) => {
       if (opts.json) {
         const files = view.files ?? [];
         if (files.length === 0) {
@@ -18348,7 +18623,7 @@ async function runCharacterFinalize(opts) {
         });
         return;
       }
-      await reportTerminal("character", view, log);
+      await reportTerminal("character", view, log, false, false, local);
     }
   });
 }
@@ -18426,22 +18701,22 @@ async function context2(opts) {
   const project = await readProject();
   return { token, apiUrl: getApiUrl(opts.apiUrl ?? project?.apiUrl) };
 }
-async function readVideo(path25, log) {
+async function readVideo(path29, log) {
   let bytes;
   try {
-    bytes = await readFile(path25);
+    bytes = await readFile(path29);
   } catch {
-    log.error(`Can't read ${path25}.`);
+    log.error(`Can't read ${path29}.`);
     return null;
   }
   if (bytes.byteLength > MAX_VIDEO_BYTES) {
-    log.error(`${basename(path25)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
+    log.error(`${basename(path29)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
     return null;
   }
   return bytes;
 }
-async function uploadVideo(apiUrl, token, characterId, path25, bytes, log) {
-  const contentType = /\.mov$/i.test(path25) ? "video/quicktime" : "video/mp4";
+async function uploadVideo(apiUrl, token, characterId, path29, bytes, log) {
+  const contentType = /\.mov$/i.test(path29) ? "video/quicktime" : "video/mp4";
   const minted = await apiFetch(
     `${apiUrl}/api/characters/${encodeURIComponent(characterId)}/motions/video-url`,
     {
@@ -18456,7 +18731,7 @@ async function uploadVideo(apiUrl, token, characterId, path25, bytes, log) {
     return null;
   }
   const { uploadUrl, videoUrl } = await minted.json();
-  log.dim(`  uploading ${basename(path25)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
+  log.dim(`  uploading ${basename(path29)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
   const put = await fetch(uploadUrl, {
     method: "PUT",
     headers: { "Content-Type": contentType, "Content-Length": String(bytes.byteLength) },
@@ -18772,8 +19047,8 @@ function rank(items, query) {
 }
 
 // src/commands/motion.ts
-import fs24 from "fs/promises";
-import path23 from "path";
+import fs25 from "fs/promises";
+import path24 from "path";
 
 // src/lib/motion/npz.ts
 import zlib from "zlib";
@@ -20024,7 +20299,7 @@ async function motionGen(opts, log) {
   }
   if (opts.constraintsPath !== void 0) {
     try {
-      const raw = await fs24.readFile(opts.constraintsPath, "utf8");
+      const raw = await fs25.readFile(opts.constraintsPath, "utf8");
       generationOptions.constraints = JSON.parse(raw);
     } catch {
       log.error(`Couldn't read the --constraints JSON at ${opts.constraintsPath}.`);
@@ -20048,10 +20323,10 @@ async function motionGen(opts, log) {
 async function expandTakes(selectors) {
   const out = [];
   for (const sel of selectors) {
-    const st = await fs24.stat(sel).catch(() => null);
+    const st = await fs25.stat(sel).catch(() => null);
     if (st?.isDirectory()) {
-      const names = await fs24.readdir(sel);
-      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path23.join(sel, n));
+      const names = await fs25.readdir(sel);
+      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path24.join(sel, n));
     } else if (st?.isFile()) {
       out.push(sel);
     } else {
@@ -20086,7 +20361,7 @@ async function motionVerify(opts, log) {
   let gates = DEFAULT_GATES;
   if (opts.gatesPath) {
     try {
-      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs24.readFile(opts.gatesPath, "utf8")));
+      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs25.readFile(opts.gatesPath, "utf8")));
     } catch {
       log.error(`Couldn't read the --gates JSON at ${opts.gatesPath}.`);
       process.exitCode = 1;
@@ -20108,9 +20383,9 @@ async function motionVerify(opts, log) {
   }
   const reports = [];
   for (const file of files) {
-    const stem = path23.basename(file).replace(/\.npz$/, "");
+    const stem = path24.basename(file).replace(/\.npz$/, "");
     try {
-      reports.push(analyzeTake(stem, await fs24.readFile(file), gates));
+      reports.push(analyzeTake(stem, await fs25.readFile(file), gates));
     } catch (err) {
       reports.push({
         take: stem,
@@ -20148,7 +20423,7 @@ async function motionCompile(opts, log) {
   let cfg = DEFAULT_MOTION_CONFIG;
   if (opts.configPath) {
     try {
-      const patch = JSON.parse(await fs24.readFile(opts.configPath, "utf8"));
+      const patch = JSON.parse(await fs25.readFile(opts.configPath, "utf8"));
       cfg = { ...DEFAULT_MOTION_CONFIG, ...patch, idleLoop: { ...DEFAULT_MOTION_CONFIG.idleLoop, ...patch.idleLoop } };
     } catch {
       log.error(`Couldn't read the --config JSON at ${opts.configPath}.`);
@@ -20166,16 +20441,16 @@ async function motionCompile(opts, log) {
   }
   const inputs = [];
   for (const file of files) {
-    const stem = path23.basename(file).replace(/\.npz$/, "");
+    const stem = path24.basename(file).replace(/\.npz$/, "");
     try {
-      inputs.push({ stem, take: loadTake(await fs24.readFile(file)) });
+      inputs.push({ stem, take: loadTake(await fs25.readFile(file)) });
     } catch (err) {
       log.error(`${stem}: ${err instanceof Error ? err.message : String(err)}`);
       process.exitCode = 1;
       return;
     }
   }
-  const setName = opts.set ?? path23.basename(opts.out).replace(/\.json$/, "");
+  const setName = opts.set ?? path24.basename(opts.out).replace(/\.json$/, "");
   let result;
   try {
     result = compileSet(inputs, setName, cfg);
@@ -20190,9 +20465,9 @@ async function motionCompile(opts, log) {
     process.exitCode = 1;
     return;
   }
-  await fs24.mkdir(path23.dirname(path23.resolve(opts.out)), { recursive: true });
+  await fs25.mkdir(path24.dirname(path24.resolve(opts.out)), { recursive: true });
   const json = JSON.stringify(result.data);
-  await fs24.writeFile(opts.out, json);
+  await fs25.writeFile(opts.out, json);
   if (opts.json) {
     writeJson({ out: opts.out, set: setName, tracks: Object.keys(result.data.gaits), bytes: json.length });
     return;
@@ -20210,9 +20485,9 @@ var MOTION_RUNTIME_FILES = [
 var MOTION_PRESETS = {
   rifle: ["sets/rifle.json", "sets/jumps.json"]
 };
-var MOTION_DEST = path23.join("src", "motion");
+var MOTION_DEST = path24.join("src", "motion");
 async function motionInstall(opts, log) {
-  const srcDir = path23.join(getTemplatesDir(), "motion");
+  const srcDir = path24.join(getTemplatesDir(), "motion");
   const root = opts.cwd ?? process.cwd();
   const preset = opts.set;
   if (preset !== void 0 && !MOTION_PRESETS[preset]) {
@@ -20223,21 +20498,21 @@ async function motionInstall(opts, log) {
   const files = [...MOTION_RUNTIME_FILES, ...preset ? MOTION_PRESETS[preset] : []];
   log.plain(c.bold(`genex motion install${preset ? ` --set ${preset}` : ""}`));
   log.plain("");
-  log.step(`Vendoring the motion runtime into ${c.cyan(MOTION_DEST + path23.sep)}`);
+  log.step(`Vendoring the motion runtime into ${c.cyan(MOTION_DEST + path24.sep)}`);
   let copied = 0, skipped = 0;
   try {
     for (const rel of files) {
-      const dest = path23.join(root, MOTION_DEST, rel);
-      const exists4 = await fs24.access(dest).then(() => true, () => false);
-      if (!opts.force && exists4) {
+      const dest = path24.join(root, MOTION_DEST, rel);
+      const exists5 = await fs25.access(dest).then(() => true, () => false);
+      if (!opts.force && exists5) {
         skipped++;
-        log.dim(`  skipped ${path23.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
+        log.dim(`  skipped ${path24.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs24.mkdir(path23.dirname(dest), { recursive: true });
-      await fs24.copyFile(path23.join(srcDir, rel), dest);
+      await fs25.mkdir(path24.dirname(dest), { recursive: true });
+      await fs25.copyFile(path24.join(srcDir, rel), dest);
       copied++;
-      log.dim(`  ${path23.join(MOTION_DEST, rel)}`);
+      log.dim(`  ${path24.join(MOTION_DEST, rel)}`);
     }
   } catch (err) {
     log.error(`Copy failed: ${String(err)}`);
@@ -20278,7 +20553,7 @@ async function motionConstraints(opts, log) {
   }
   const doc = directionConstraint(dir, speed, duration);
   const out = opts.out ?? "constraints.json";
-  await fs24.writeFile(out, JSON.stringify(doc));
+  await fs25.writeFile(out, JSON.stringify(doc));
   if (opts.json) {
     writeJson({ out, dir: dirName, speed, duration, waypoints: doc[0].frame_indices.length });
     return;
@@ -20315,9 +20590,9 @@ async function runMotion(opts) {
 }
 
 // src/commands/asset-new.ts
-import fs25 from "fs";
+import fs26 from "fs";
 import fsp from "fs/promises";
-import path24 from "path";
+import path25 from "path";
 import { pathToFileURL } from "url";
 var EXTRA_FILES = [
   "genex-asset.example.json",
@@ -20411,7 +20686,7 @@ Every milestone ends with \`npm run verify\`, then \`npx genex preview --no-buil
 }
 async function runAssetNew(options) {
   const log = createLogger();
-  const cwd = options.dir ? path24.resolve(options.dir) : process.cwd();
+  const cwd = options.dir ? path25.resolve(options.dir) : process.cwd();
   const slug = options.assetSlug;
   if (!slug) {
     log.error('Usage: genex asset new <slug> [--title "<Name>"] [--dims WxDxH] [--tri-band LOW-HIGH] [--holder "<your name>"] [--out <dir>]');
@@ -20421,14 +20696,14 @@ async function runAssetNew(options) {
     log.error(`The slug must be kebab-case (letters, digits, dashes), got: ${slug}`);
     return 1;
   }
-  const templateDir = path24.join(getTemplatesDir(), "asset-viewer");
-  if (!fs25.existsSync(templateDir)) {
+  const templateDir = path25.join(getTemplatesDir(), "asset-viewer");
+  if (!fs26.existsSync(templateDir)) {
     log.error(`Vendored asset-viewer template not found at ${templateDir} \u2014 reinstall the CLI.`);
     return 1;
   }
-  const manifestTools = await import(pathToFileURL(path24.join(templateDir, "tools", "emit-manifest.mjs")).href);
+  const manifestTools = await import(pathToFileURL(path25.join(templateDir, "tools", "emit-manifest.mjs")).href);
   const { SHARED_FILES, PARITY_FILENAME, hashSharedFiles, pascalCase } = manifestTools;
-  const lockPath = path24.join(templateDir, "shared-files.sha256.json");
+  const lockPath = path25.join(templateDir, "shared-files.sha256.json");
   const lock = JSON.parse(await fsp.readFile(lockPath, "utf8"));
   const actual = hashSharedFiles(templateDir);
   const drifted = SHARED_FILES.filter((rel) => lock.files[rel] !== actual[rel]);
@@ -20441,8 +20716,8 @@ async function runAssetNew(options) {
   const triBand = parseBand(options.triBand ?? "500-8000");
   const holder = options.holder?.trim() || HOLDER_PLACEHOLDER;
   const year = (/* @__PURE__ */ new Date()).getUTCFullYear();
-  const outDir = path24.resolve(cwd, options.out ?? slug);
-  if (fs25.existsSync(outDir) && fs25.readdirSync(outDir).length > 0 && !options.force) {
+  const outDir = path25.resolve(cwd, options.out ?? slug);
+  if (fs26.existsSync(outDir) && fs26.readdirSync(outDir).length > 0 && !options.force) {
     log.error(`${outDir} already holds files. Nothing was touched \u2014 pass --force to write into it anyway.`);
     return 1;
   }
@@ -20470,24 +20745,24 @@ async function runAssetNew(options) {
   };
   await fsp.mkdir(outDir, { recursive: true });
   for (const rel of [...SHARED_FILES, ...EXTRA_FILES]) {
-    const to = path24.join(outDir, rel);
-    await fsp.mkdir(path24.dirname(to), { recursive: true });
-    await fsp.copyFile(path24.join(templateDir, rel), to);
+    const to = path25.join(outDir, rel);
+    await fsp.mkdir(path25.dirname(to), { recursive: true });
+    await fsp.copyFile(path25.join(templateDir, rel), to);
   }
-  const pkg = fillTemplate(await fsp.readFile(path24.join(templateDir, "package.json"), "utf8"), {
+  const pkg = fillTemplate(await fsp.readFile(path25.join(templateDir, "package.json"), "utf8"), {
     slug,
     name,
     version
   });
-  await fsp.writeFile(path24.join(outDir, "package.json"), pkg, "utf8");
-  await fsp.writeFile(path24.join(outDir, "asset.config.json"), JSON.stringify(config, null, 2) + "\n", "utf8");
-  await fsp.writeFile(path24.join(outDir, ".gitignore"), GITIGNORE, "utf8");
+  await fsp.writeFile(path25.join(outDir, "package.json"), pkg, "utf8");
+  await fsp.writeFile(path25.join(outDir, "asset.config.json"), JSON.stringify(config, null, 2) + "\n", "utf8");
+  await fsp.writeFile(path25.join(outDir, ".gitignore"), GITIGNORE, "utf8");
   await fsp.writeFile(
-    path24.join(outDir, "DESIGN.md"),
+    path25.join(outDir, "DESIGN.md"),
     designDoc({ name, slug, sizeMeters, triBand, holder }),
     "utf8"
   );
-  const placeholder = await fsp.readFile(path24.join(templateDir, "src", "asset", "PLACEHOLDER.ts"), "utf8");
+  const placeholder = await fsp.readFile(path25.join(templateDir, "src", "asset", "PLACEHOLDER.ts"), "utf8");
   const seeded = seedAssetSource(placeholder, {
     slug,
     name,
@@ -20498,8 +20773,8 @@ async function runAssetNew(options) {
     pascalCase
   });
   const assetFilename = `${slug.replace(/-([a-z0-9])/g, (_, ch) => ch.toUpperCase())}.ts`;
-  await fsp.mkdir(path24.join(outDir, "src", "asset"), { recursive: true });
-  await fsp.writeFile(path24.join(outDir, "src", "asset", assetFilename), seeded, "utf8");
+  await fsp.mkdir(path25.join(outDir, "src", "asset"), { recursive: true });
+  await fsp.writeFile(path25.join(outDir, "src", "asset", assetFilename), seeded, "utf8");
   const copied = hashSharedFiles(outDir);
   const mismatched = SHARED_FILES.filter((rel) => copied[rel] !== lock.files[rel]);
   if (mismatched.length) {
@@ -20507,7 +20782,7 @@ async function runAssetNew(options) {
     return 1;
   }
   await fsp.writeFile(
-    path24.join(outDir, PARITY_FILENAME),
+    path25.join(outDir, PARITY_FILENAME),
     JSON.stringify(
       {
         note: "Recorded by `genex asset new`. Gate G13 recomputes these; do not hand-edit the viewer.",
@@ -20550,6 +20825,530 @@ async function runAssetNew(options) {
   return 0;
 }
 
+// src/commands/tools.ts
+import path28 from "path";
+
+// src/lib/telemetry.ts
+async function reportToolsInit(apiUrl, token) {
+  if (!token || telemetryDisabled()) return;
+  try {
+    await apiFetch(`${apiUrl}/api/cli/events`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+      body: JSON.stringify({ event: "tools_init" }),
+      signal: AbortSignal.timeout(2e3)
+    });
+  } catch {
+  }
+}
+
+// src/lib/local-install.ts
+import fs27 from "fs/promises";
+import path26 from "path";
+import { spawn as spawn6 } from "child_process";
+var CLI_PACKAGE = "@genex-ai/cli-demo";
+var FULL_NAME_FALLBACK = `npx ${CLI_PACKAGE}@${CLI_CHANNEL}`;
+var LOCKFILES = [
+  ["pnpm-lock.yaml", "pnpm"],
+  ["yarn.lock", "yarn"],
+  ["bun.lockb", "bun"],
+  ["bun.lock", "bun"],
+  ["package-lock.json", "npm"]
+];
+async function exists4(p) {
+  try {
+    await fs27.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function detectPackageManager(cwd) {
+  let dir = path26.resolve(cwd);
+  for (; ; ) {
+    try {
+      const raw = await fs27.readFile(path26.join(dir, "package.json"), "utf8");
+      const pm = JSON.parse(raw).packageManager;
+      if (typeof pm === "string") {
+        const name = pm.split("@")[0];
+        if (name === "pnpm" || name === "yarn" || name === "bun" || name === "npm") return name;
+      }
+    } catch {
+    }
+    for (const [file, pm] of LOCKFILES) {
+      if (await exists4(path26.join(dir, file))) return pm;
+    }
+    const parent = path26.dirname(dir);
+    if (parent === dir) return "npm";
+    dir = parent;
+  }
+}
+async function findLocalCli(cwd) {
+  let dir = path26.resolve(cwd);
+  for (; ; ) {
+    if (await exists4(path26.join(dir, "node_modules", CLI_PACKAGE, "package.json"))) return dir;
+    const parent = path26.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function installArgs(pm, spec) {
+  switch (pm) {
+    case "pnpm":
+      return { command: "pnpm", args: ["add", "-D", spec] };
+    case "yarn":
+      return { command: "yarn", args: ["add", "-D", spec] };
+    case "bun":
+      return { command: "bun", args: ["add", "-d", spec] };
+    case "npm":
+      return { command: "npm", args: ["install", "--save-dev", "--no-audit", "--no-fund", spec] };
+  }
+}
+function manifestName(cwd) {
+  const slug = path26.basename(path26.resolve(cwd)).toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 100);
+  return slug || "genex-tools-workspace";
+}
+function isSourceRun(moduleUrl = import.meta.url) {
+  return moduleUrl.endsWith(".ts");
+}
+var INSTALL_TIMEOUT_MS = 18e4;
+async function spawnInstall(command, args, cwd) {
+  return new Promise((resolve) => {
+    let output = "";
+    let settled = false;
+    const done = (ok, detail) => {
+      if (settled) return;
+      settled = true;
+      resolve({ ok, detail });
+    };
+    try {
+      const child = spawn6(command, args, {
+        cwd,
+        // npm/pnpm/yarn are .cmd shims on Windows; the args carry no user input.
+        shell: process.platform === "win32",
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+      const timer = setTimeout(() => {
+        child.kill();
+        done(false, `timed out after ${INSTALL_TIMEOUT_MS / 1e3}s`);
+      }, INSTALL_TIMEOUT_MS);
+      child.stdout?.on("data", (d) => output += d.toString());
+      child.stderr?.on("data", (d) => output += d.toString());
+      child.on("error", (err) => {
+        clearTimeout(timer);
+        done(false, err.message);
+      });
+      child.on("close", (code2) => {
+        clearTimeout(timer);
+        if (code2 === 0) done(true);
+        else done(false, output.trim().split("\n").slice(-3).join("\n"));
+      });
+    } catch (err) {
+      done(false, err instanceof Error ? err.message : String(err));
+    }
+  });
+}
+async function ensureLocalCli(log, cwd = process.cwd(), opts = {}) {
+  if (opts.skip) {
+    log.dim(`  --no-install: commands are spelled ${c.cyan(FULL_NAME_FALLBACK)} without it.`);
+    return;
+  }
+  if (!opts.runner && isSourceRun()) {
+    log.dim("  (source run \u2014 skipping the local CLI install)");
+    return;
+  }
+  const already = await findLocalCli(cwd);
+  if (already) {
+    log.dim(`  ${CLI_PACKAGE} already resolves from ${c.cyan(already)} \u2014 npx genex works here.`);
+    return;
+  }
+  const pm = await detectPackageManager(cwd);
+  const hadManifest = await exists4(path26.join(cwd, "package.json"));
+  if (!hadManifest) {
+    await fs27.writeFile(
+      path26.join(cwd, "package.json"),
+      JSON.stringify({ name: manifestName(cwd), private: true }, null, 2) + "\n"
+    );
+    await ensureIgnored(cwd, "node_modules/");
+    log.dim("  wrote a minimal package.json (none existed \u2014 the install must land HERE, not in a parent)");
+  }
+  const spec = `${CLI_PACKAGE}@${CLI_CHANNEL}`;
+  const { command, args } = installArgs(pm, spec);
+  log.step(`Adding ${c.cyan(CLI_PACKAGE)} as a devDependency (${pm}) so npx genex resolves here\u2026`);
+  const run2 = opts.runner ?? spawnInstall;
+  const result = await run2(command, args, cwd);
+  if (result.ok) {
+    log.success(`${c.cyan("npx genex")} now resolves in this folder.`);
+  } else {
+    log.warn(`Couldn't install ${CLI_PACKAGE} via ${pm}${result.detail ? ` \u2014 ${result.detail}` : ""}.`);
+    log.dim(`  Everything still works with the full name: ${c.cyan(`${FULL_NAME_FALLBACK} doctor`)}`);
+    log.dim(`  Or add it yourself: ${c.cyan(`${command} ${args.join(" ")}`)}`);
+  }
+}
+async function ensureIgnored(dir, entry) {
+  const file = path26.join(dir, ".gitignore");
+  let content = "";
+  try {
+    content = await fs27.readFile(file, "utf8");
+  } catch {
+  }
+  if (content.split("\n").some((l) => l.trim() === entry)) return;
+  let next = content;
+  if (next.length > 0 && !next.endsWith("\n")) next += "\n";
+  await fs27.writeFile(file, next + entry + "\n");
+}
+
+// src/commands/doctor.ts
+import path27 from "path";
+var LANE_ORDER = [
+  "model",
+  "image",
+  "video",
+  "texture",
+  "sfx",
+  "music",
+  "voice",
+  "character",
+  "character_motion",
+  "model_segment",
+  "model_rig",
+  "model_animation"
+];
+var NODE_FLOOR = 20;
+async function runDoctor(opts = {}) {
+  const log = createLogger({ quiet: opts.quiet && !opts.json });
+  const rows = [];
+  const [project, workspace] = await Promise.all([readProject(), readWorkspace()]);
+  const mode = project ? "game" : workspace?.mode === "tools" ? "tools" : null;
+  const synced = await firstSkillsMarker();
+  const syncNote = synced ? ` \xB7 skills ${synced}` : " \xB7 no skills installed here";
+  rows.push(
+    mode === "game" ? { label: "Workspace", value: `genex game "${project.slug}"${syncNote}` } : mode === "tools" ? { label: "Workspace", value: `Genex Tools workspace${syncNote}` } : {
+      label: "Workspace",
+      value: "not a Genex folder",
+      // Never `bad`: doctor is exactly what someone runs BEFORE setting
+      // up, and a red mark there reads as a broken install.
+      fix: "`npx genex tools` for the asset toolkit, or `npx genex init` to build a hosted game here."
+    }
+  );
+  const nodeMajor = Number(process.versions.node.split(".")[0]);
+  const nodeOk = Number.isFinite(nodeMajor) && nodeMajor >= NODE_FLOOR;
+  rows.push({
+    label: "Node",
+    value: `v${process.versions.node}${nodeOk ? "" : ` (needs \u2265 ${NODE_FLOOR})`}`,
+    bad: !nodeOk,
+    fix: nodeOk ? void 0 : "Install Node 20 or newer: nodejs.org/download (or `brew install node`)."
+  });
+  const installed = getCliVersion();
+  const latest = await latestPublished();
+  rows.push({
+    label: "CLI",
+    value: latest && isNewerVersion(latest, installed) ? `${installed} (latest on npm: ${latest})` : `${installed}${latest ? " (up to date)" : ""}`,
+    // An outdated CLI is a nudge, never a failure — it is the update machinery's
+    // job to say so, and failing here would make `doctor` red on every machine
+    // the morning after a release.
+    fix: latest && isNewerVersion(latest, installed) ? "npm i -D @genex-ai/cli-demo@latest  (apply at a safe moment, never mid-task)" : void 0
+  });
+  const apiUrl = getApiUrl(opts.apiUrl ?? workspace?.apiUrl ?? project?.apiUrl);
+  const token = await readUserToken(opts.envPath);
+  let email = null;
+  let authState = "none";
+  if (token) {
+    const probe = await probeSession(apiUrl, token);
+    authState = probe.state;
+    email = probe.email;
+  }
+  rows.push(authRow(authState, email, opts.envPath));
+  let credits = null;
+  let lanes = null;
+  if (authState === "ok" && token) {
+    [credits, lanes] = await Promise.all([fetchCredits(apiUrl, token), fetchLanes(apiUrl, token)]);
+  }
+  rows.push(creditsRow(authState, credits));
+  if (opts.json) {
+    process.stdout.write(
+      JSON.stringify(
+        {
+          workspace: mode,
+          node: process.versions.node,
+          cli: { installed, latest },
+          auth: { state: authState, email, apiUrl },
+          credits,
+          lanes: lanes ? { paused: lanes.paused, lanes: lanes.lanes } : null,
+          ok: !rows.some((r) => r.bad)
+        },
+        null,
+        2
+      ) + "\n"
+    );
+    if (rows.some((r) => r.bad)) process.exitCode = 1;
+    return;
+  }
+  log.plain(c.bold("genex doctor"));
+  log.dim(`  ${apiUrl}`);
+  log.plain("");
+  for (const row of rows) {
+    const mark = row.bad ? c.red("\u2717") : c.green("\u2713");
+    log.plain(`  ${mark} ${row.label.padEnd(11)}${row.value}`);
+    if (row.fix) log.dim(`               ${row.fix}`);
+  }
+  let laneProblem = false;
+  if (authState === "ok") {
+    log.plain("");
+    if (!lanes) {
+      log.plain(`  ${c.yellow("?")} Lanes      couldn't be read from this server`);
+      log.dim(
+        "               An older server has no lane report \u2014 generation still works, and a lane with no"
+      );
+      log.dim("               provider key would return a placeholder asset instead of failing.");
+    } else if (lanes.paused) {
+      laneProblem = true;
+      log.plain(`  ${c.red("\u2717")} Lanes      generation is PAUSED platform-wide`);
+      log.dim("               The daily spend breaker is tripped \u2014 nothing generates until it resets.");
+    } else {
+      const mocks = lanes.lanes.filter((l) => l.mock);
+      const mark = mocks.length > 0 ? c.yellow("!") : c.green("\u2713");
+      log.plain(
+        `  ${mark} Lanes      ${lanes.lanes.length - mocks.length}/${lanes.lanes.length} live${mocks.length > 0 ? ` \xB7 ${mocks.length} in SAMPLE mode` : ""}`
+      );
+      for (const kind of laneOrder(lanes)) {
+        const lane = lanes.lanes.find((l) => l.kind === kind);
+        if (!lane) continue;
+        const price = credits?.prices?.[kind];
+        const cost = typeof price === "number" ? `${price} cr` : "";
+        if (lane.mock) {
+          laneProblem = true;
+          log.plain(
+            `      ${c.yellow("!")} ${kind.padEnd(17)}${"SAMPLE (no provider key)".padEnd(26)}${cost}`
+          );
+        } else {
+          log.dim(`      \xB7 ${kind.padEnd(17)}${`live (${lane.provider})`.padEnd(26)}${cost}`);
+        }
+      }
+      if (mocks.length > 0) {
+        log.dim(
+          "               A SAMPLE lane returns a placeholder asset and still bills. In a Genex Tools"
+        );
+        log.dim("               workspace those are refused before anything is charged.");
+      }
+    }
+  }
+  const failed = rows.some((r) => r.bad) || laneProblem && mode !== "game";
+  log.plain("");
+  if (failed) {
+    log.plain(`  ${c.red("Something above needs fixing.")}`);
+    process.exitCode = 1;
+  } else {
+    log.plain(`  ${c.green("All good.")}`);
+  }
+}
+function laneOrder(report) {
+  const known = LANE_ORDER.filter((k) => report.lanes.some((l) => l.kind === k));
+  const extra = report.lanes.map((l) => l.kind).filter((k) => !LANE_ORDER.includes(k));
+  return [...known, ...extra.sort()];
+}
+function authRow(state, email, envPath) {
+  switch (state) {
+    case "ok":
+      return { label: "Auth", value: `connected as ${email ?? "this account"}` };
+    case "rejected":
+      return {
+        label: "Auth",
+        value: "your saved sign-in was rejected",
+        bad: true,
+        fix: `The credential in ${getGenexEnvPath(envPath)} is expired or revoked \u2014 run \`npx genex auth --force\`.`
+      };
+    case "offline":
+      return {
+        label: "Auth",
+        value: "couldn't reach the API to check",
+        bad: true,
+        fix: "Check the network, then re-run. Nothing is wrong with your credential yet."
+      };
+    default:
+      return {
+        label: "Auth",
+        value: "not signed in",
+        bad: true,
+        fix: "`npx genex auth` \u2014 it prints a short link and a code; approve it on any device."
+      };
+  }
+}
+function creditsRow(state, info) {
+  if (state !== "ok") return { label: "Credits", value: "\u2014 (sign in first)" };
+  if (!info) return { label: "Credits", value: "couldn't be read from this server" };
+  if (info.unlimited) return { label: "Credits", value: "unlimited (operator account)" };
+  if (!info.emailVerified) {
+    return {
+      label: "Credits",
+      value: `${info.balance} \xB7 email not verified`,
+      bad: true,
+      fix: "Verify your email to unlock your free credits \u2014 then re-run."
+    };
+  }
+  const refill = info.refillAt ? ` \xB7 refills to ${info.refillTo} on ${shortDate2(info.refillAt)}` : "";
+  return {
+    label: "Credits",
+    value: `${info.balance}${refill}`,
+    bad: info.balance <= 0,
+    fix: info.balance <= 0 ? "Out of credits \u2014 generation is refused until the refill or a top-up." : void 0
+  };
+}
+function shortDate2(iso) {
+  const d = new Date(iso);
+  return Number.isNaN(d.getTime()) ? iso : d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
+}
+async function probeSession(apiUrl, token) {
+  try {
+    const res = await apiFetch(`${apiUrl}/api/auth/get-session`, {
+      headers: { Authorization: `Bearer ${token}` },
+      signal: AbortSignal.timeout(6e3)
+    });
+    if (res.status === 401 || res.status === 403) return { state: "rejected", email: null };
+    if (!res.ok) return { state: "offline", email: null };
+    const data = await res.json().catch(() => null);
+    if (!data?.user) return { state: "rejected", email: null };
+    return { state: "ok", email: data.user.email ?? null };
+  } catch {
+    return { state: "offline", email: null };
+  }
+}
+async function fetchCredits(apiUrl, token) {
+  try {
+    const res = await apiFetch(`${apiUrl}/api/credits/me`, {
+      headers: { Authorization: `Bearer ${token}` },
+      signal: AbortSignal.timeout(6e3)
+    });
+    if (!res.ok) return null;
+    return await res.json();
+  } catch {
+    return null;
+  }
+}
+async function firstSkillsMarker() {
+  for (const target of resolveAgentTargets()) {
+    const marker = await readSkillsMarker(path27.join(target.baseDir, "skills"));
+    if (marker) return marker;
+  }
+  return null;
+}
+async function latestPublished() {
+  try {
+    const cache = await startUpdateCheck();
+    return cache?.latest["@genex-ai/cli-demo"] ?? null;
+  } catch {
+    return null;
+  }
+}
+
+// src/commands/tools.ts
+async function runTools(opts) {
+  const log = createLogger({ quiet: opts.quiet });
+  const project = await readProject();
+  if (project) {
+    log.error("This folder is already a Genex game project.");
+    log.plain(
+      [
+        `  Its skills already cover every generation tool \u2014 ${c.cyan("npx genex --help")} lists them,`,
+        "  and it can publish, host and go multiplayer on top. Nothing to set up.",
+        "  Genex Tools is for a game you host yourself; run it in that project's folder."
+      ].join("\n")
+    );
+    process.exitCode = 1;
+    return;
+  }
+  log.plain(c.bold("genex tools"));
+  log.plain("");
+  await cleanupLegacyGlobalSkills(log);
+  const templatesDir = getTemplatesDir();
+  const targets = resolveAgentTargets({ dir: opts.dir, agents: opts.agents });
+  log.step(`Installing Genex tool skills for: ${targets.map((t) => c.cyan(t.label)).join(", ")}`);
+  let totalNew = 0;
+  let totalUpdated = 0;
+  for (const t of targets) {
+    const dest = path28.join(t.baseDir, "skills");
+    const { copied, updated } = await copyTemplates(path28.join(templatesDir, "skills"), dest, {
+      filter: (rel) => skillFamilyFilter("tools")(`skills/${rel}`)
+    });
+    await pruneRemovedSkills(dest, log);
+    await writeSkillsMarker(dest);
+    const added = copied.length - updated.length;
+    totalNew += added;
+    totalUpdated += updated.length;
+    log.dim(`  ${t.label}: ${added} added, ${updated.length} refreshed \u2192 ${dest}`);
+  }
+  log.success(
+    `Tool skills ready (${totalNew} added, ${totalUpdated} refreshed across ${targets.length} agent${targets.length === 1 ? "" : "s"}).`
+  );
+  const apiUrl = getApiUrl(opts.apiUrl);
+  const { path: markerPath } = await writeWorkspace({
+    mode: "tools",
+    apiUrl,
+    createdAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  log.dim(`  saved ${c.cyan(markerPath)}`);
+  await writeGitignore(process.cwd(), log);
+  if (await writeToolsContract(process.cwd())) {
+    log.dim("  wrote the Genex Tools rules into AGENTS.md (managed block) + CLAUDE.md stub");
+  }
+  await healAncestorContractsAndReport(log, process.cwd());
+  await ensureLocalCli(log, process.cwd(), { skip: opts.noInstall });
+  log.plain("");
+  const authBaseUrl = getAuthUrl(opts.authUrl);
+  let token = await readUserToken(opts.envPath);
+  if (!token) {
+    try {
+      token = await authorize(apiUrl, authBaseUrl, {
+        log,
+        inlineWaitMs: opts.timeoutSec ? opts.timeoutSec * 1e3 : void 0
+      });
+    } catch (err) {
+      if (err instanceof AuthPendingError) {
+        printAuthHandoff(log, err);
+        log.dim(
+          "Everything else is set up \u2014 `genex auth` finishes the sign-in, then you can generate."
+        );
+        return;
+      }
+      log.error(err instanceof Error ? err.message : String(err));
+      log.dim("The workspace is set up. Re-run `genex tools` to finish authorizing.");
+      throw markPrinted(err);
+    }
+    const { path: tokenPath } = await writeUserToken(token, opts.envPath);
+    log.success(`Authorized. Saved your token to ${c.cyan(tokenPath)} (${ENV_TOKEN_KEY}).`);
+    log.plain("");
+  }
+  await reportToolsInit(apiUrl, token);
+  await runDoctor({ apiUrl: opts.apiUrl, envPath: opts.envPath, quiet: opts.quiet });
+  log.plain("");
+  log.success("Genex Tools is ready. \u{1F9F0}");
+  log.plain(`  Try it: ${c.cyan('npx genex image "weathered treasure map, hand-inked" --transparent')}`);
+  log.dim("  Assets land in ./assets/ as files you own \u2014 wire the local path into your game.");
+}
+
+// src/lib/costs.ts
+var TYPICAL_CREDITS = {
+  model: 25,
+  image: 8,
+  texture: 3,
+  sfx: 5,
+  music: 40,
+  voice: 10,
+  video: 20,
+  model_segment: 30,
+  model_rig: 20,
+  model_animation: 8,
+  // PER CLIP — `--preset walk,run` bills twice
+  character: 50,
+  character_concept: 15,
+  character_preview: 20,
+  character_finalize: 30,
+  character_animation: 5,
+  character_motion: 26,
+  // PER CLIP on the text route; other routes scale from it
+  character_rerig: 10
+};
+
 // src/index.ts
 var MODEL_SUB_SET = new Set(MODEL_SUBCOMMANDS);
 var GEN_KINDS = /* @__PURE__ */ new Set(["model", "skybox", "sfx", "music", "voice", "texture", "image", "video"]);
@@ -20557,6 +21356,17 @@ var HELP = `${c.bold("genex")} \u2014 set up your project's agent workspace, aut
 
 ${c.bold("Usage")}
   genex init [<name>] [options]      Scaffold + authorize + create the draft project.
+  genex tools [options]              Set this folder up as a Genex Tools workspace: the
+                                     asset generators alone (models, images, video,
+                                     textures, audio, characters) for a game you host
+                                     yourself. Installs the tool skill cards, signs you
+                                     in, and downloads every asset into ./assets.
+                                     Creates nothing on the platform.
+  genex doctor [--json]              Check everything a generation needs: sign-in,
+                                     credit balance, Node + CLI version, and which
+                                     generation lanes are live. Exit 0 all clear,
+                                     1 if something needs fixing \u2014 run it first when
+                                     a command fails.
   genex auth [options]               Connect this machine to your Genex account, or
                                      finish a sign-in another command started \u2014 it
                                      resumes the same code, so an interrupted
@@ -20731,6 +21541,9 @@ ${c.bold("Options for the generators (`model` `sfx` `music` `voice` `texture` `i
                        multi-beat move room to land instead of rushing it.
                        (music: 10-300, default 90 \u2014 a looping gameplay track).
   --transparent        (image) transparent background (alpha) \u2014 for decals/stickers.
+                       Takes --quality and --size; without --quality it runs a
+                       mid tier. Not with --candidates (a cutout is billed per
+                       image \u2014 pick a candidate first, then --clean it).
   --glass              (image) magenta-key glass lane: generate the panel on a
                        flat #FF00FF screen, then locally solve REAL per-pixel
                        translucency and write RGBA files (glass-1.png\u2026) into
@@ -20770,6 +21583,10 @@ ${c.bold("Options for the generators (`model` `sfx` `music` `voice` `texture` `i
   --last-frame <url>   (video) \u2026 and its end frame.
   --no-wait            Enqueue only; don't block waiting for the asset. Prints
                        the id that "genex wait <id>" picks the result up with.
+  --no-download        (Genex Tools workspaces) print the asset URL only instead
+                       of saving the file into ./assets.
+  --out-dir <dir>      (Genex Tools workspaces) where saved assets land
+                       (default ./assets). Also --glass's output directory.
   --api-url <url>      Override the API base URL.
   --env <path>         Token env file (default: ~/.genex/env).
 
@@ -20935,6 +21752,86 @@ ${c.bold("Examples")}
   genex controller chat
   genex controller voice
 `;
+var cr = (kind) => `${String(TYPICAL_CREDITS[kind] ?? "?").padStart(3)} cr`;
+var HELP_TOOLS = `${c.bold("genex")} \u2014 the gamedev AI asset toolkit. One sign-in, one meter, no provider accounts.
+
+This folder is a ${c.bold("Genex Tools")} workspace: generation only. Assets download into
+${c.cyan("./assets")} as files you own \u2014 wire the local path into your game, whatever engine
+it uses and wherever you host it.
+
+${c.bold("Generate")}                                                        typical cost
+  genex model "<prompt>"             A 3D model (GLB).                     ${cr("model")}
+      --image <path|url>             \u2026built from a reference image instead.
+  genex model segment <id>           Split a model into NAMED parts.       ${cr("model_segment")}
+  genex model rig <id>               Give any mesh a skeleton (7 body      ${cr("model_rig")}
+                                     plans: biped|quadruped|hexapod|
+                                     octopod|avian|serpentine|aquatic).
+  genex model animate <rig-id> --preset walk[,run,\u2026]
+                                     Retarget ready-made clips onto a rig. ${cr("model_animation")} each
+  genex image "<prompt>"             An image (PNG/JPEG).                  ${cr("image")}
+      --transparent                  \u2026with a real alpha channel (sprites, icons, logos).
+      --edit <path|url>              \u2026edit an existing image with the prompt.
+      --remove-bg / --bg-mode <m>    \u2026cut the background (sprite|glyph|sheet|matte).
+  genex video "<prompt>"             A video (mp4). --loop, --frame <img>. ${cr("video")}
+  genex texture "<prompt>"           A tiling PBR texture set. --terrain.  ${cr("texture")}
+  genex sfx "<prompt>"               A sound effect (mp3). --duration.     ${cr("sfx")}
+  genex music "<prompt>"             A looping instrumental track (mp3).   ${cr("music")}
+                                     --duration 10-300s (default 90).
+  genex voice "<line>"               A spoken line (mp3). --voice          ${cr("voice")}
+                                     narrator|heroine|gruff|elder|robot|imp.
+
+${c.bold("Characters")}
+  genex character "<brief>"          Three concept candidates to choose from. ${cr("character_concept")}
+  genex character preview <concept-id> --candidate <1|2|3> --user-approved
+                                     A 3D preview of the chosen one.       ${cr("character_preview")}
+  genex character finalize <preview-id> --user-approved --approve-remesh 10000
+                                     The rigged, game-ready character.     ${cr("character_finalize")}
+  genex character "<brief>" --direct-text
+                                     One shot, no approval steps.          ${cr("character")}
+  genex creature "<desc>"            A rigged enemy (biped-shaped bodies).  ${cr("character")}
+  genex character animate <id> "<verb>" \u2026
+                                     Any move, in plain words. --locomotion ${cr("character_motion")} each
+                                     for the 8-way walk+run set; --video
+                                     ./clip.mp4 to use your own footage.
+  genex character motions <id>       List the clips installed on a character.
+  genex animations search "<intent>" Search the ready-made animation library. free
+
+${c.bold("Workflow")}
+  genex doctor [--json]              Sign-in, credits, Node/CLI version, and which
+                                     lanes are live. Run it when anything fails.
+  genex wait <id>                    Pick up a generation enqueued with --no-wait.
+                                     Never bills \u2014 re-running a generate command does.
+  genex wait --all                   One status line per generation from this folder.
+  genex auth [--force]               Connect this machine (or switch accounts).
+  genex tools                        Re-run setup here (refresh skills + rules).
+
+${c.bold("Options")}
+  --no-wait            Enqueue and return; pick it up with "genex wait <id>".
+  --no-download        Print the asset URL only; save nothing.
+  --no-install         (tools setup) Don't add the CLI to devDependencies.
+  --out-dir <dir>      Where saved assets land (default ./assets).
+  --json               Machine-readable output.
+  --quiet              Reduce output.
+  --api-url <url>      Override the API base URL.
+  --env <path>         Token env file (default: ~/.genex/env).
+  -h, --help           Show this help.     -v, --version   Show the version.
+
+${c.bold("Costs")}
+  Prices above are typical. Live prices and your balance: ${c.cyan("genex doctor")}.
+  A failed generation is refunded automatically. Re-running a generate command
+  starts (and bills) a NEW asset \u2014 attach to a running one with ${c.cyan("genex wait <id>")}.
+
+${c.bold("Examples")}
+  genex image "weathered treasure map, hand-inked" --transparent
+  genex model "low-poly rusted fuel drum" --no-wait
+  genex texture "mossy cracked cobblestone" --terrain
+  genex character "stylized sci-fi courier, practical clothing" --direct-text
+  genex character animate <character-id> --locomotion --no-wait
+  genex wait --all
+
+Hosting, publishing, multiplayer, remixing and custom domains are the Genex
+platform \u2014 build a game there from one prompt: ${c.cyan("https://genex.games")}
+`;
 function parseArgs(argv) {
   const parsed = {
     command: void 0,
@@ -21048,6 +21945,12 @@ function parseArgs(argv) {
       case "--no-wait":
         parsed.options.noWait = true;
         break;
+      case "--no-download":
+        parsed.options.noDownload = true;
+        break;
+      case "--no-install":
+        parsed.options.noInstall = true;
+        break;
       case "--no-controller-pack":
         parsed.options.controllerPack = false;
         break;
@@ -21545,13 +22448,17 @@ async function main() {
     log.plain(getCliVersion());
     return;
   }
+  const mode = await workspaceMode();
+  setWorkspaceHeader(mode === "tools" ? "tools" : null);
   if (parsed.help || parsed.command === void 0) {
-    log.plain(HELP);
+    log.plain(mode === "tools" ? HELP_TOOLS : HELP);
     return;
   }
   const quietUpdates = Boolean(parsed.options.quiet || parsed.options.json);
   const updateLog = createLogger({ quiet: quietUpdates });
-  if (parsed.command !== "init") await syncSkills(updateLog);
+  if (parsed.command !== "init" && parsed.command !== "tools") {
+    await syncSkills(updateLog, mode);
+  }
   const updateCheck = startUpdateCheck();
   Sentry2.setTag("command", parsed.command);
   Sentry2.setTag("cli.version", getCliVersion());
@@ -21565,6 +22472,11 @@ async function main() {
     ci: !!process.env.CI
   });
   try {
+    if (mode === "tools" && refusedInTools(parsed.command)) {
+      reportPlatformRefused(log, parsed.command);
+      process.exitCode = 1;
+      return;
+    }
     if (parsed.command === "skybox") {
       log.error("The generated-sky lane is paused \u2014 `genex skybox` is not available.");
       log.plain(
@@ -21597,6 +22509,16 @@ async function main() {
       case "init":
         await runInit(parsed.options);
         break;
+      // AG-911 — the OTHER door into this CLI: mark the folder a Genex Tools
+      // workspace (generation only, assets downloaded locally, nothing created
+      // on the platform). Bare word on purpose: it is the first command a
+      // person runs, from a prompt they pasted.
+      case "tools":
+        await runTools(parsed.options);
+        break;
+      case "doctor":
+        await runDoctor(parsed.options);
+        break;
       case "auth":
         await runAuth(parsed.options);
         break;