@genex-ai/cli-demo 1.32.2 → 1.32.3-dev.680

package/dist/index.js

@@ -42,7 +42,7 @@ import {
   writeProject,
   writeUserToken,
   writeWorkspace
-} from "./chunk-OJAXYQ5L.js";
+} from "./chunk-2COG4P3T.js";
 import {
   CLI_CHANNEL,
   DEFAULT_API_URL,
@@ -59,7 +59,7 @@ import {
   getGenexEnvPath,
   getTemplatesDir,
   resolveAgentTargets
-} from "./chunk-5FA2WLM7.js";
+} from "./chunk-HYCSNWYX.js";
 
 // src/instrument.ts
 import * as Sentry from "@sentry/node";
@@ -1940,14 +1940,16 @@ async function readLedger(cwd = process.cwd()) {
   }
   return [...entries.values()];
 }
-async function recordQueued(id, kind, prompt, cwd = process.cwd()) {
+async function recordQueued(id, kind, prompt, cwd = process.cwd(), extra = {}) {
+  const credits = extra.credits;
   await append(cwd, {
     t: "q",
     id,
     kind,
     prompt: prompt.slice(0, 120),
     ...prompt.length > 120 ? { tail: prompt.slice(-120) } : {},
-    at: (/* @__PURE__ */ new Date()).toISOString()
+    at: (/* @__PURE__ */ new Date()).toISOString(),
+    ...typeof credits === "number" && Number.isFinite(credits) && credits >= 0 ? { credits } : {}
   });
 }
 async function recordTerminal(id, status, urls, cwd = process.cwd()) {
@@ -7879,8 +7881,8 @@ async function runRollback(opts) {
 }
 
 // src/commands/generate.ts
-import fs23 from "fs/promises";
-import path22 from "path";
+import fs24 from "fs/promises";
+import path23 from "path";
 import { PNG as PNG4 } from "pngjs";
 
 // src/lib/glass.ts
@@ -8047,6 +8049,159 @@ function ceilingVerdict(input) {
   return { allow: true };
 }
 
+// src/lib/asset-budget.ts
+import fs23 from "fs/promises";
+import path22 from "path";
+var DEFAULT_ASSET_BUDGET_SHARE = 0.5;
+var DEFAULT_ASSET_BUDGET_CAP = 500;
+function envShare(raw, fallback) {
+  if (raw === void 0 || raw.trim() === "") return fallback;
+  const n = Number(raw);
+  return Number.isFinite(n) && n >= 0 && n <= 1 ? n : fallback;
+}
+function envCredits(raw, fallback) {
+  if (raw === void 0 || raw.trim() === "") return fallback;
+  const n = Number(raw);
+  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : fallback;
+}
+function budgetConfig(env = process.env) {
+  return {
+    share: envShare(env.GENEX_ASSET_BUDGET_SHARE, DEFAULT_ASSET_BUDGET_SHARE),
+    cap: envCredits(env.GENEX_ASSET_BUDGET_CAP, DEFAULT_ASSET_BUDGET_CAP)
+  };
+}
+function budgetDisabled(config) {
+  return config.cap <= 0;
+}
+function allowanceFor(input) {
+  const { spendable, config } = input;
+  if (!Number.isFinite(spendable) || spendable <= 0) return 0;
+  return Math.max(0, Math.min(Math.floor(spendable * config.share), config.cap));
+}
+var storePath = (cwd) => path22.join(cwd, ".genex", "asset-budget.json");
+async function readBudgetStore(cwd = process.cwd()) {
+  try {
+    const raw = await fs23.readFile(storePath(cwd), "utf8");
+    const parsed = JSON.parse(raw);
+    if (!parsed || parsed.v !== 1 || typeof parsed.allowanceCredits !== "number" || !Number.isFinite(parsed.allowanceCredits) || parsed.setBy !== "default" && parsed.setBy !== "user") {
+      return null;
+    }
+    return {
+      v: 1,
+      allowanceCredits: Math.max(0, Math.floor(parsed.allowanceCredits)),
+      setBy: parsed.setBy,
+      setAt: typeof parsed.setAt === "string" ? parsed.setAt : "",
+      spendableAtStart: typeof parsed.spendableAtStart === "number" ? parsed.spendableAtStart : 0,
+      balanceAtStart: typeof parsed.balanceAtStart === "number" ? parsed.balanceAtStart : 0
+    };
+  } catch {
+    return null;
+  }
+}
+async function writeBudgetStore(cwd, store) {
+  try {
+    await fs23.access(path22.join(cwd, ".genex"));
+    await fs23.writeFile(storePath(cwd), `${JSON.stringify(store, null, 2)}
+`, "utf8");
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function ensureBudgetStore(cwd, input) {
+  const existing = await readBudgetStore(cwd);
+  if (existing) return existing;
+  const store = {
+    v: 1,
+    allowanceCredits: allowanceFor({ spendable: input.spendable, config: input.config }),
+    setBy: "default",
+    setAt: (/* @__PURE__ */ new Date()).toISOString(),
+    spendableAtStart: input.spendable,
+    balanceAtStart: input.balance
+  };
+  await writeBudgetStore(cwd, store);
+  return store;
+}
+function isFailureRow(row) {
+  return row.t === "f" || row.t === "done" && row.status === "failed";
+}
+function spentCredits(rows) {
+  const quoted = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (typeof row.id !== "string") continue;
+    if (row.t === "q") {
+      if (quoted.has(row.id)) continue;
+      const credits = typeof row.credits === "number" && Number.isFinite(row.credits) && row.credits > 0 ? row.credits : 0;
+      quoted.set(row.id, credits);
+    } else if (isFailureRow(row) && quoted.has(row.id)) {
+      quoted.set(row.id, 0);
+    }
+  }
+  let total = 0;
+  for (const credits of quoted.values()) total += credits;
+  return total;
+}
+function budgetVerdict(input) {
+  const { kind, price, spent, allowance } = input;
+  const config = input.config ?? budgetConfig();
+  if (budgetDisabled(config)) return { allow: true };
+  if (spent + price <= allowance) return { allow: true };
+  return {
+    allow: false,
+    reason: `This ${kind} is quoted at ${price} credits and this build has spent ${spent} of its ${allowance}-credit asset allowance. Refused so one build cannot drain the wallet. If the player wants more of this game generated, ask them \u2014 then re-run after \`npx genex budget --assets <credits> --user-approved\`. Otherwise build it in code and say why. (See the numbers any time with \`npx genex budget\`.)`
+  };
+}
+async function fetchCreditsSnapshot(apiUrl, token) {
+  try {
+    const res = await apiFetch(`${apiUrl}/api/credits/me`, {
+      headers: { Authorization: `Bearer ${token}` },
+      signal: AbortSignal.timeout(6e3)
+    });
+    if (!res.ok) return null;
+    const body = await res.json();
+    if (!body || typeof body.balance !== "number" || typeof body.prices !== "object" || body.prices === null) {
+      return null;
+    }
+    const balance = body.balance;
+    const reserved = typeof body.reserved === "number" ? body.reserved : 0;
+    return {
+      balance,
+      reserved,
+      spendable: typeof body.spendable === "number" ? body.spendable : Math.max(0, balance - reserved),
+      unlimited: body.unlimited === true,
+      ...typeof body.emailVerified === "boolean" ? { emailVerified: body.emailVerified } : {},
+      ...body.refillAt !== void 0 ? { refillAt: body.refillAt } : {},
+      ...typeof body.refillTo === "number" ? { refillTo: body.refillTo } : {},
+      prices: body.prices
+    };
+  } catch {
+    return null;
+  }
+}
+async function assetBudgetGate(input) {
+  const config = input.config ?? budgetConfig();
+  if (budgetDisabled(config)) return { allow: true };
+  const cwd = input.cwd ?? process.cwd();
+  const snapshot = await fetchCreditsSnapshot(input.apiUrl, input.token);
+  if (!snapshot) {
+    input.log.dim("  Asset allowance not checked (couldn't read /api/credits/me) \u2014 the API still refuses on insufficient credits.");
+    return { allow: true };
+  }
+  if (snapshot.unlimited) return { allow: true };
+  const price = typeof input.quotedCredits === "number" && Number.isFinite(input.quotedCredits) ? input.quotedCredits : snapshot.prices[input.kind];
+  if (typeof price !== "number" || !Number.isFinite(price)) {
+    input.log.dim(`  Asset allowance not checked (no live price for ${input.kind}).`);
+    return { allow: true };
+  }
+  const store = await ensureBudgetStore(cwd, {
+    balance: snapshot.balance,
+    spendable: snapshot.spendable,
+    config
+  });
+  const spent = spentCredits(await readLedgerRows(cwd));
+  return budgetVerdict({ kind: input.kind, price, spent, allowance: store.allowanceCredits, config });
+}
+
 // src/lib/lanes.ts
 var LANE_CREDITS = /* @__PURE__ */ new Set(["ok", "exhausted", "unknown"]);
 async function fetchLanes(apiUrl, token, timeoutMs = 4e3) {
@@ -8184,7 +8339,7 @@ var isRemoteRef = (value) => /^(https?:\/\/|data:)/i.test(value);
 async function inlineLocalImage(filePath, flag) {
   let bytes;
   try {
-    bytes = await fs23.readFile(filePath);
+    bytes = await fs24.readFile(filePath);
   } catch {
     return { ok: false, error: `Couldn't read the ${flag} file at ${filePath}.` };
   }
@@ -8194,7 +8349,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[path22.extname(filePath).toLowerCase()] ?? "image/png";
+  const mime = IMAGE_MIME_BY_EXT[path23.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.";
@@ -8380,7 +8535,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: ${path22.basename(ref).slice(0, 120)}`;
+    typedPrompt = `from image: ${path23.basename(ref).slice(0, 120)}`;
   }
   if (kind === "model" && opts.texture !== void 0 && !MODEL_TEXTURE_TIERS.includes(opts.texture)) {
     log.error(`--texture ${opts.texture} is a character texture size. \`genex model\` takes a texture TIER: ${MODEL_TEXTURE_TIERS.join("|")} (default detailed).`);
@@ -8429,7 +8584,7 @@ async function runGenerate(kind, opts) {
       return;
     }
     try {
-      const bytes = await fs23.readFile(opts.inpaintUrl);
+      const bytes = await fs24.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}.`);
@@ -8533,7 +8688,16 @@ async function runGenerate(kind, opts) {
       return;
     }
   }
+  {
+    const budget = await assetBudgetGate({ apiUrl, token, kind, quotedCredits: opts.quotedCredits, log });
+    if (!budget.allow) {
+      log.error(budget.reason);
+      process.exitCode = 1;
+      return;
+    }
+  }
   let id;
+  let creditsQuoted;
   try {
     const res = await apiFetch(`${apiUrl}/api/generations`, {
       method: "POST",
@@ -8562,13 +8726,17 @@ async function runGenerate(kind, opts) {
       process.exitCode = 1;
       return;
     }
-    ({ id } = await res.json());
+    const created = await res.json();
+    id = created.id;
+    if (typeof created.creditsQuoted === "number" && Number.isFinite(created.creditsQuoted)) {
+      creditsQuoted = created.creditsQuoted;
+    }
   } catch (err) {
     log.error(`Couldn't reach the API at ${apiUrl}: ${String(err)}`);
     process.exitCode = 1;
     return;
   }
-  await recordQueued(id, kind, prompt);
+  await recordQueued(id, kind, prompt, void 0, { credits: creditsQuoted ?? opts.quotedCredits });
   if (opts.noWait) {
     if (opts.json) {
       writeJson({
@@ -8623,7 +8791,7 @@ async function reportGlassTerminal(view, outDir, log, json) {
     return;
   }
   await recordTerminal(view.id, "completed", files.map((f) => f.url));
-  await fs23.mkdir(outDir, { recursive: true });
+  await fs24.mkdir(outDir, { recursive: true });
   const solved = [];
   for (let i = 0; i < files.length; i++) {
     const f = files[i];
@@ -8655,8 +8823,8 @@ async function reportGlassTerminal(view, outDir, log, json) {
       });
       continue;
     }
-    const outPath = path22.join(outDir, `glass-${i + 1}.png`);
-    await fs23.writeFile(outPath, PNG4.sync.write(r.png));
+    const outPath = path23.join(outDir, `glass-${i + 1}.png`);
+    await fs24.writeFile(outPath, PNG4.sync.write(r.png));
     solved.push({
       path: outPath,
       url: f.url,
@@ -9174,8 +9342,8 @@ function writeJson(value) {
 }
 
 // src/commands/model-sub.ts
-import fs24 from "fs/promises";
-import path23 from "path";
+import fs25 from "fs/promises";
+import path24 from "path";
 var MODEL_SUBCOMMANDS = ["segment", "rig", "animate", "import"];
 function apiErrorMessage(data, fallback) {
   if (typeof data !== "object" || data === null) return fallback;
@@ -9190,29 +9358,29 @@ async function importModelFile(args) {
   const { log } = args;
   const filePath = args.filePath.trim();
   if (!/\.glb$/i.test(filePath)) {
-    log.error(`\`import\` takes a .glb file (binary glTF 2.0). Export ${path23.basename(filePath) || "the model"} as GLB first \u2014 Blender: File \u2192 Export \u2192 glTF 2.0, format "glTF Binary".`);
+    log.error(`\`import\` takes a .glb file (binary glTF 2.0). Export ${path24.basename(filePath) || "the model"} as GLB first \u2014 Blender: File \u2192 Export \u2192 glTF 2.0, format "glTF Binary".`);
     return null;
   }
   let bytes;
   try {
-    bytes = await fs24.readFile(filePath);
+    bytes = await fs25.readFile(filePath);
   } catch {
     log.error(`Couldn't read ${filePath}.`);
     return null;
   }
   if (bytes.byteLength > MODEL_IMPORT_MAX_BYTES) {
-    log.error(`${path23.basename(filePath)} is ${(bytes.byteLength / 1e6).toFixed(1)} MB; imports are capped at ${MODEL_IMPORT_MAX_BYTES / 1024 / 1024} MB. Shrink its textures (they are usually the bulk) and try again.`);
+    log.error(`${path24.basename(filePath)} is ${(bytes.byteLength / 1e6).toFixed(1)} MB; imports are capped at ${MODEL_IMPORT_MAX_BYTES / 1024 / 1024} MB. Shrink its textures (they are usually the bulk) and try again.`);
     return null;
   }
   if (bytes.byteLength < 12 || bytes.readUInt32LE(0) !== GLB_MAGIC) {
-    log.error(`${path23.basename(filePath)} is not a GLB (no glTF magic). A .gltf + .bin pair must be exported as one binary .glb.`);
+    log.error(`${path24.basename(filePath)} is not a GLB (no glTF magic). A .gltf + .bin pair must be exported as one binary .glb.`);
     return null;
   }
   const headers = { "Content-Type": "application/json", Authorization: `Bearer ${args.token}` };
   const minted = await apiFetch(`${args.apiUrl}/api/generations/import`, {
     method: "POST",
     headers,
-    body: JSON.stringify({ filename: path23.basename(filePath), bytes: bytes.byteLength, contentType: "model/gltf-binary" })
+    body: JSON.stringify({ filename: path24.basename(filePath), bytes: bytes.byteLength, contentType: "model/gltf-binary" })
   });
   if (printedStructuredError(minted)) return null;
   if (!minted.ok) {
@@ -9221,7 +9389,7 @@ async function importModelFile(args) {
     return null;
   }
   const { id, uploadUrl, url } = await minted.json();
-  log.dim(`  uploading ${path23.basename(filePath)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
+  log.dim(`  uploading ${path24.basename(filePath)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
   const put = await fetch(uploadUrl, {
     method: "PUT",
     headers: { "Content-Type": "model/gltf-binary", "Content-Length": String(bytes.byteLength) },
@@ -9369,7 +9537,7 @@ async function runModelAnimate(opts) {
 }
 
 // src/commands/wait.ts
-import path24 from "path";
+import path25 from "path";
 var TERMINAL2 = /* @__PURE__ */ new Set(["completed", "failed"]);
 async function runWait(opts) {
   if (opts.all) return runWaitAll(opts);
@@ -9500,7 +9668,7 @@ async function runWaitAll(opts) {
       if (v?.status !== "completed" || !v.files?.length) continue;
       const local = localDeliveryFor("tools", opts, e.prompt || e.kind);
       if (!local) continue;
-      const outDir = path24.join(path24.relative(process.cwd(), cwd) || ".", local.outDir);
+      const outDir = path25.join(path25.relative(process.cwd(), cwd) || ".", local.outDir);
       const target = { kind: e.kind, prompt: local.prompt, id: e.id, outDir };
       const missing = await undeliveredFiles(v.files, target);
       if (missing.length === 0) continue;
@@ -9595,8 +9763,8 @@ async function toRow(e, v, cwd) {
 }
 
 // src/commands/controller.ts
-import fs26 from "fs/promises";
-import path26 from "path";
+import fs27 from "fs/promises";
+import path27 from "path";
 
 // ../../packages/meshy-animation-catalog/src/index.ts
 import { createHash } from "crypto";
@@ -18726,9 +18894,9 @@ function searchMeshyAnimations(query, options = {}) {
 }
 
 // src/lib/anims.ts
-import fs25 from "fs/promises";
-import path25 from "path";
-var ANIMS_DEST = path25.join("public", "assets", "anims");
+import fs26 from "fs/promises";
+import path26 from "path";
+var ANIMS_DEST = path26.join("public", "assets", "anims");
 var HIDDEN_TAG = "reference";
 async function runAnims(opts) {
   const log = createLogger({ quiet: opts.quiet });
@@ -18744,7 +18912,7 @@ async function runAnims(opts) {
     printCatalog(log, manifest, selectors);
     return;
   }
-  const controllerMarker = path25.join(root, "src", "controllers", "character");
+  const controllerMarker = path26.join(root, "src", "controllers", "character");
   if (!await exists3(controllerMarker)) {
     log.error(
       `No character controller in this game (missing ${c.cyan("src/controllers/character/")}).`
@@ -18753,11 +18921,11 @@ async function runAnims(opts) {
     process.exitCode = 1;
     return;
   }
-  const destDir = path25.join(root, ANIMS_DEST);
-  const gameManifestPath = path25.join(destDir, "manifest.json");
+  const destDir = path26.join(root, ANIMS_DEST);
+  const gameManifestPath = path26.join(destDir, "manifest.json");
   if (opts.reset) {
-    await fs25.rm(destDir, { recursive: true, force: true });
-    log.step(`Cleared ${c.cyan(ANIMS_DEST + path25.sep)} (--reset)`);
+    await fs26.rm(destDir, { recursive: true, force: true });
+    log.step(`Cleared ${c.cyan(ANIMS_DEST + path26.sep)} (--reset)`);
   }
   if (selectors.length === 0) {
     const installed = await readGameManifest(gameManifestPath);
@@ -18795,35 +18963,35 @@ async function runAnims(opts) {
     }
   }
   const wanted = [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
-  const cacheDir = path25.join(
+  const cacheDir = path26.join(
     opts.cacheDir ?? getAnimsCacheDir(),
     `${manifest.library}-v${manifest.version}`
   );
-  await fs25.mkdir(cacheDir, { recursive: true });
-  await fs25.mkdir(destDir, { recursive: true });
+  await fs26.mkdir(cacheDir, { recursive: true });
+  await fs26.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 = path25.join(destDir, entry.file);
+    const dest = path26.join(destDir, entry.file);
     if (await hasSize(dest, entry.bytes)) {
       presentCount++;
       continue;
     }
     try {
-      const cached = path25.join(cacheDir, entry.file);
+      const cached = path26.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 fs25.writeFile(cached, buf);
+        await fs26.writeFile(cached, buf);
       }
-      await fs25.copyFile(cached, dest);
+      await fs26.copyFile(cached, dest);
       installedCount++;
       addedBytes += entry.bytes;
-      log.dim(`  ${path25.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
+      log.dim(`  ${path26.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
     } catch (err) {
       failures.push(`${entry.name} (${err instanceof Error ? err.message : String(err)})`);
     }
@@ -18839,13 +19007,13 @@ async function runAnims(opts) {
     version: manifest.version,
     clips: [...union].sort((a, b) => a.localeCompare(b))
   };
-  await fs25.writeFile(gameManifestPath, JSON.stringify(gameManifest, null, 2) + "\n");
+  await fs26.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 + path25.sep)}${addedBytes > 0 ? ` (+${formatMb(addedBytes)})` : ""}`
+    `${parts.join(", ")} \u2192 ${c.cyan(ANIMS_DEST + path26.sep)}${addedBytes > 0 ? ` (+${formatMb(addedBytes)})` : ""}`
   );
   for (const [selector, entries] of resolved) {
     const names = entries.filter((e) => !coreNames.has(e.name)).map((e) => e.name);
@@ -18877,8 +19045,8 @@ async function loadManifest(baseOverride) {
     }
   } catch {
   }
-  const snapshotPath = path25.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
-  const manifest = JSON.parse(await fs25.readFile(snapshotPath, "utf8"));
+  const snapshotPath = path26.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
+  const manifest = JSON.parse(await fs26.readFile(snapshotPath, "utf8"));
   return { manifest, source: "snapshot" };
 }
 function resolveSelectors(manifest, selectors) {
@@ -18996,21 +19164,21 @@ function printCatalog(log, manifest, selectors) {
 }
 async function readGameManifest(file) {
   try {
-    return JSON.parse(await fs25.readFile(file, "utf8"));
+    return JSON.parse(await fs26.readFile(file, "utf8"));
   } catch {
     return null;
   }
 }
 async function hasSize(file, bytes) {
   try {
-    return (await fs25.stat(file)).size === bytes;
+    return (await fs26.stat(file)).size === bytes;
   } catch {
     return false;
   }
 }
 async function exists3(p) {
   try {
-    await fs25.access(p);
+    await fs26.access(p);
     return true;
   } catch {
     return false;
@@ -19211,8 +19379,8 @@ var CONTROLLER_FILE_SETS = {
     ]
   }
 };
-var CODE_DEST = path26.join("src", "controllers");
-var ASSETS_DEST = path26.join("public", "assets");
+var CODE_DEST = path27.join("src", "controllers");
+var ASSETS_DEST = path27.join("public", "assets");
 async function runController(opts) {
   const log = createLogger({ quiet: opts.quiet });
   if (opts.kind?.trim() === "anims") {
@@ -19229,31 +19397,31 @@ async function runController(opts) {
     process.exitCode = 1;
     return;
   }
-  const srcDir = path26.join(getTemplatesDir(), "controllers");
+  const srcDir = path27.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 + path26.sep)}`);
+  log.step(`Installing the ${kind} controller into ${c.cyan(CODE_DEST + path27.sep)}`);
   const plan = [
-    ...set.code.map((rel) => ({ from: rel, rel: path26.join(CODE_DEST, rel) })),
+    ...set.code.map((rel) => ({ from: rel, rel: path27.join(CODE_DEST, rel) })),
     ...set.assets.map((rel) => ({
       from: rel,
-      rel: path26.join(ASSETS_DEST, path26.basename(rel))
+      rel: path27.join(ASSETS_DEST, path27.basename(rel))
     }))
   ];
   let copied = 0;
   let skipped = 0;
   try {
     for (const file of plan) {
-      const dest = path26.join(root, file.rel);
+      const dest = path27.join(root, file.rel);
       if (!opts.force && await exists4(dest)) {
         skipped++;
         log.dim(`  skipped ${file.rel} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs26.mkdir(path26.dirname(dest), { recursive: true });
-      await fs26.copyFile(path26.join(srcDir, file.from), dest);
+      await fs27.mkdir(path27.dirname(dest), { recursive: true });
+      await fs27.copyFile(path27.join(srcDir, file.from), dest);
       copied++;
       log.dim(`  ${file.rel}`);
     }
@@ -19306,7 +19474,7 @@ async function runController(opts) {
   for (const line of set.sketch) {
     log.dim(`       ${line}`);
   }
-  if (kind === "character" && !await exists4(path26.join(root, ASSETS_DEST, "meshy-character.json"))) {
+  if (kind === "character" && !await exists4(path27.join(root, ASSETS_DEST, "meshy-character.json"))) {
     log.plain("");
     log.plain(
       `  ${stepOffset + 3}. This game has no generated character yet \u2014 ${c.cyan(
@@ -19338,9 +19506,9 @@ async function installMeshyCharacterManifest(args) {
     throw new Error("The API returned an invalid Meshy character manifest.");
   }
   assertCompleteMeshyControllerPack(manifest);
-  const destination = path26.join(args.root, ASSETS_DEST, "meshy-character.json");
-  await fs26.mkdir(path26.dirname(destination), { recursive: true });
-  await fs26.writeFile(
+  const destination = path27.join(args.root, ASSETS_DEST, "meshy-character.json");
+  await fs27.mkdir(path27.dirname(destination), { recursive: true });
+  await fs27.writeFile(
     destination,
     `${JSON.stringify(manifest, null, 2)}
 `
@@ -19485,14 +19653,14 @@ function assertCompleteMeshyControllerPack(manifest) {
 }
 async function installFallbackAvatar(args) {
   const { root, srcDir, log } = args;
-  const dest = path26.join(root, ASSETS_DEST, "avatar.vrm");
-  await fs26.mkdir(path26.dirname(dest), { recursive: true });
-  await fs26.copyFile(path26.join(srcDir, "assets", "default-avatar.vrm"), dest);
+  const dest = path27.join(root, ASSETS_DEST, "avatar.vrm");
+  await fs27.mkdir(path27.dirname(dest), { recursive: true });
+  await fs27.copyFile(path27.join(srcDir, "assets", "default-avatar.vrm"), dest);
   log.dim("  public/assets/avatar.vrm (fallback avatar \u2014 bundled CC0 default)");
 }
 async function exists4(p) {
   try {
-    await fs26.access(p);
+    await fs27.access(p);
     return true;
   } catch {
     return false;
@@ -19500,8 +19668,8 @@ async function exists4(p) {
 }
 
 // src/commands/character.ts
-import fs27 from "fs/promises";
-import path27 from "path";
+import fs28 from "fs/promises";
+import path28 from "path";
 function exactAnimation(selector) {
   const trimmed = selector.trim();
   if (/^-?\d+$/.test(trimmed)) return animationById(Number(trimmed));
@@ -19581,7 +19749,7 @@ function showAmbiguity(selector, candidates, log, json = false) {
   }
   process.exitCode = 1;
 }
-var INSTALLED_MANIFEST = path27.join("public", "assets", "meshy-character.json");
+var INSTALLED_MANIFEST = path28.join("public", "assets", "meshy-character.json");
 async function resolveAdoptTarget(selector) {
   const trimmed = selector?.trim();
   if (trimmed && !trimmed.endsWith(".json")) {
@@ -19590,7 +19758,7 @@ async function resolveAdoptTarget(selector) {
   const file = trimmed ?? INSTALLED_MANIFEST;
   let raw;
   try {
-    raw = await fs27.readFile(file, "utf8");
+    raw = await fs28.readFile(file, "utf8");
   } catch {
     return {
       ok: false,
@@ -19650,6 +19818,8 @@ async function runCharacterAdopt(opts) {
     createPath: `/api/characters/${encodeURIComponent(target.characterId)}/adopt`,
     body: { projectId: project.id },
     quote: { credits: 0 },
+    // A copy, not a generation: it costs nothing, and the allowance sees 0.
+    quotedCredits: 0,
     completed: (view) => {
       if (opts.json) {
         writeJson({
@@ -19711,10 +19881,11 @@ async function runCharacterImport(opts) {
     opts,
     ctx,
     kind: "character",
-    prompt: `Import ${path27.basename(filePath)} as a rigged character`,
+    prompt: `Import ${path28.basename(filePath)} as a rigged character`,
     createPath: "/api/characters/import",
     body,
     quote: price,
+    quotedCredits: price.credits,
     completed: (view) => {
       const confidence = typeof view.metadata?.autoRigConfidence === "number" ? view.metadata.autoRigConfidence : null;
       const next = {
@@ -19789,12 +19960,28 @@ async function runWorkflow(args) {
       return;
     }
   }
+  {
+    const budget = await assetBudgetGate({
+      apiUrl: args.ctx.apiUrl,
+      token: args.ctx.token,
+      kind: args.kind,
+      quotedCredits: args.quotedCredits,
+      log
+    });
+    if (!budget.allow) {
+      log.error(budget.reason);
+      process.exitCode = 1;
+      return;
+    }
+  }
   const created = await postWorkflow(`${args.ctx.apiUrl}${args.createPath}`, args.ctx.token, args.body);
   if (!created) {
     process.exitCode = 1;
     return;
   }
-  await recordQueued(created.id, args.kind, args.prompt);
+  await recordQueued(created.id, args.kind, args.prompt, void 0, {
+    credits: created.creditsQuoted ?? args.quotedCredits
+  });
   if (args.opts.noWait) {
     const nextCommand = `genex wait ${created.id}${args.opts.json ? " --json" : ""}`;
     if (args.opts.json) {
@@ -19894,6 +20081,7 @@ async function runCharacterConcept(opts) {
     createPath: "/api/characters/concepts",
     body: request,
     quote: price,
+    quotedCredits: price.credits,
     completed: (view) => reportCharacterConceptTerminal(view, log, {
       json: opts.json,
       open: opts.open,
@@ -19945,6 +20133,7 @@ async function runDirectTextCharacter(opts) {
     prompt,
     token: ctx.token,
     apiUrl: ctx.apiUrl,
+    quotedCredits: price.credits,
     generationOptions: {
       actionIds: resolved.actionIds,
       controllerPack,
@@ -20014,6 +20203,7 @@ async function runCharacterPreview(opts) {
     createPath: basePath,
     body,
     quote: price,
+    quotedCredits: price.credits,
     completed: (view) => reportCharacterPreviewTerminal(view, log, {
       json: opts.json,
       open: opts.open,
@@ -20087,6 +20277,7 @@ async function runCharacterFinalize(opts) {
     createPath: basePath,
     body,
     quote: price,
+    quotedCredits: price.credits,
     completed: async (view, local) => {
       if (opts.json) {
         const files = view.files ?? [];
@@ -20176,6 +20367,7 @@ async function runCharacterAnimate(opts) {
     prompt: `Attach Meshy actions ${resolved.actionIds.join(", ")} to character ${characterId}`,
     token: ctx.token,
     apiUrl: ctx.apiUrl,
+    quotedCredits: price.credits,
     generationOptions: { characterId, actionIds: resolved.actionIds }
   });
 }
@@ -20191,22 +20383,22 @@ async function context2(opts) {
   const project = await readProject();
   return { token, apiUrl: getApiUrl(opts.apiUrl ?? project?.apiUrl) };
 }
-async function readVideo(path33, log) {
+async function readVideo(path35, log) {
   let bytes;
   try {
-    bytes = await readFile(path33);
+    bytes = await readFile(path35);
   } catch {
-    log.error(`Can't read ${path33}.`);
+    log.error(`Can't read ${path35}.`);
     return null;
   }
   if (bytes.byteLength > MAX_VIDEO_BYTES) {
-    log.error(`${basename(path33)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
+    log.error(`${basename(path35)} 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, path33, bytes, log) {
-  const contentType = /\.mov$/i.test(path33) ? "video/quicktime" : "video/mp4";
+async function uploadVideo(apiUrl, token, characterId, path35, bytes, log) {
+  const contentType = /\.mov$/i.test(path35) ? "video/quicktime" : "video/mp4";
   const minted = await apiFetch(
     `${apiUrl}/api/characters/${encodeURIComponent(characterId)}/motions/video-url`,
     {
@@ -20221,7 +20413,7 @@ async function uploadVideo(apiUrl, token, characterId, path33, bytes, log) {
     return null;
   }
   const { uploadUrl, videoUrl } = await minted.json();
-  log.dim(`  uploading ${basename(path33)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
+  log.dim(`  uploading ${basename(path35)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
   const put = await fetch(uploadUrl, {
     method: "PUT",
     headers: { "Content-Type": contentType, "Content-Length": String(bytes.byteLength) },
@@ -20537,8 +20729,8 @@ function rank(items, query) {
 }
 
 // src/commands/motion.ts
-import fs28 from "fs/promises";
-import path28 from "path";
+import fs29 from "fs/promises";
+import path29 from "path";
 
 // src/lib/motion/npz.ts
 import zlib from "zlib";
@@ -21789,7 +21981,7 @@ async function motionGen(opts, log) {
   }
   if (opts.constraintsPath !== void 0) {
     try {
-      const raw = await fs28.readFile(opts.constraintsPath, "utf8");
+      const raw = await fs29.readFile(opts.constraintsPath, "utf8");
       generationOptions.constraints = JSON.parse(raw);
     } catch {
       log.error(`Couldn't read the --constraints JSON at ${opts.constraintsPath}.`);
@@ -21813,10 +22005,10 @@ async function motionGen(opts, log) {
 async function expandTakes(selectors) {
   const out = [];
   for (const sel of selectors) {
-    const st = await fs28.stat(sel).catch(() => null);
+    const st = await fs29.stat(sel).catch(() => null);
     if (st?.isDirectory()) {
-      const names = await fs28.readdir(sel);
-      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path28.join(sel, n));
+      const names = await fs29.readdir(sel);
+      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path29.join(sel, n));
     } else if (st?.isFile()) {
       out.push(sel);
     } else {
@@ -21851,7 +22043,7 @@ async function motionVerify(opts, log) {
   let gates = DEFAULT_GATES;
   if (opts.gatesPath) {
     try {
-      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs28.readFile(opts.gatesPath, "utf8")));
+      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs29.readFile(opts.gatesPath, "utf8")));
     } catch {
       log.error(`Couldn't read the --gates JSON at ${opts.gatesPath}.`);
       process.exitCode = 1;
@@ -21873,9 +22065,9 @@ async function motionVerify(opts, log) {
   }
   const reports = [];
   for (const file of files) {
-    const stem = path28.basename(file).replace(/\.npz$/, "");
+    const stem = path29.basename(file).replace(/\.npz$/, "");
     try {
-      reports.push(analyzeTake(stem, await fs28.readFile(file), gates));
+      reports.push(analyzeTake(stem, await fs29.readFile(file), gates));
     } catch (err) {
       reports.push({
         take: stem,
@@ -21913,7 +22105,7 @@ async function motionCompile(opts, log) {
   let cfg = DEFAULT_MOTION_CONFIG;
   if (opts.configPath) {
     try {
-      const patch = JSON.parse(await fs28.readFile(opts.configPath, "utf8"));
+      const patch = JSON.parse(await fs29.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}.`);
@@ -21931,16 +22123,16 @@ async function motionCompile(opts, log) {
   }
   const inputs = [];
   for (const file of files) {
-    const stem = path28.basename(file).replace(/\.npz$/, "");
+    const stem = path29.basename(file).replace(/\.npz$/, "");
     try {
-      inputs.push({ stem, take: loadTake(await fs28.readFile(file)) });
+      inputs.push({ stem, take: loadTake(await fs29.readFile(file)) });
     } catch (err) {
       log.error(`${stem}: ${err instanceof Error ? err.message : String(err)}`);
       process.exitCode = 1;
       return;
     }
   }
-  const setName = opts.set ?? path28.basename(opts.out).replace(/\.json$/, "");
+  const setName = opts.set ?? path29.basename(opts.out).replace(/\.json$/, "");
   let result;
   try {
     result = compileSet(inputs, setName, cfg);
@@ -21955,9 +22147,9 @@ async function motionCompile(opts, log) {
     process.exitCode = 1;
     return;
   }
-  await fs28.mkdir(path28.dirname(path28.resolve(opts.out)), { recursive: true });
+  await fs29.mkdir(path29.dirname(path29.resolve(opts.out)), { recursive: true });
   const json = JSON.stringify(result.data);
-  await fs28.writeFile(opts.out, json);
+  await fs29.writeFile(opts.out, json);
   if (opts.json) {
     writeJson({ out: opts.out, set: setName, tracks: Object.keys(result.data.gaits), bytes: json.length });
     return;
@@ -21975,9 +22167,9 @@ var MOTION_RUNTIME_FILES = [
 var MOTION_PRESETS = {
   rifle: ["sets/rifle.json", "sets/jumps.json"]
 };
-var MOTION_DEST = path28.join("src", "motion");
+var MOTION_DEST = path29.join("src", "motion");
 async function motionInstall(opts, log) {
-  const srcDir = path28.join(getTemplatesDir(), "motion");
+  const srcDir = path29.join(getTemplatesDir(), "motion");
   const root = opts.cwd ?? process.cwd();
   const preset = opts.set;
   if (preset !== void 0 && !MOTION_PRESETS[preset]) {
@@ -21988,21 +22180,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 + path28.sep)}`);
+  log.step(`Vendoring the motion runtime into ${c.cyan(MOTION_DEST + path29.sep)}`);
   let copied = 0, skipped = 0;
   try {
     for (const rel of files) {
-      const dest = path28.join(root, MOTION_DEST, rel);
-      const exists5 = await fs28.access(dest).then(() => true, () => false);
+      const dest = path29.join(root, MOTION_DEST, rel);
+      const exists5 = await fs29.access(dest).then(() => true, () => false);
       if (!opts.force && exists5) {
         skipped++;
-        log.dim(`  skipped ${path28.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
+        log.dim(`  skipped ${path29.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs28.mkdir(path28.dirname(dest), { recursive: true });
-      await fs28.copyFile(path28.join(srcDir, rel), dest);
+      await fs29.mkdir(path29.dirname(dest), { recursive: true });
+      await fs29.copyFile(path29.join(srcDir, rel), dest);
       copied++;
-      log.dim(`  ${path28.join(MOTION_DEST, rel)}`);
+      log.dim(`  ${path29.join(MOTION_DEST, rel)}`);
     }
   } catch (err) {
     log.error(`Copy failed: ${String(err)}`);
@@ -22043,7 +22235,7 @@ async function motionConstraints(opts, log) {
   }
   const doc = directionConstraint(dir, speed, duration);
   const out = opts.out ?? "constraints.json";
-  await fs28.writeFile(out, JSON.stringify(doc));
+  await fs29.writeFile(out, JSON.stringify(doc));
   if (opts.json) {
     writeJson({ out, dir: dirName, speed, duration, waypoints: doc[0].frame_indices.length });
     return;
@@ -22080,14 +22272,14 @@ async function runMotion(opts) {
 }
 
 // src/commands/blender.ts
-import fs29 from "fs/promises";
-import path29 from "path";
+import fs30 from "fs/promises";
+import path30 from "path";
 var SUBS2 = ["demo", "exec", "snap", "scene", "import", "export", "reset", "mcp", "serve", "seat", "release"];
 var DEFAULT_OUT_DIR = "assets/blender";
 async function writeB64(dir, name, b64) {
-  await fs29.mkdir(dir, { recursive: true });
-  const p = path29.join(dir, name);
-  await fs29.writeFile(p, Buffer.from(b64, "base64"));
+  await fs30.mkdir(dir, { recursive: true });
+  const p = path30.join(dir, name);
+  await fs30.writeFile(p, Buffer.from(b64, "base64"));
   return p;
 }
 function reportScene(log, s) {
@@ -22104,7 +22296,7 @@ async function runBlender(opts) {
     return 1;
   }
   if (sub === "serve") {
-    const { serveLocalBlender } = await import("./blender-serve-PVVCH3S6.js");
+    const { serveLocalBlender } = await import("./blender-serve-BF4FZ55Z.js");
     const port = Number(process.env.GENEX_BLENDER_PORT ?? 8088);
     log.step(`Starting a local Blender service on port ${port}`);
     log.plain(
@@ -22113,7 +22305,7 @@ async function runBlender(opts) {
     return serveLocalBlender({ port, log });
   }
   if (sub === "mcp") {
-    const { runBlenderMcp } = await import("./blender-mcp-X66ZZ4TN.js");
+    const { runBlenderMcp } = await import("./blender-mcp-Q6PSFYSE.js");
     return runBlenderMcp();
   }
   if (sub === "seat") {
@@ -22171,7 +22363,7 @@ async function runBlender(opts) {
     log.plain(rest.join("\n"));
     return 1;
   }
-  const outDir = path29.resolve(opts.outDir ?? DEFAULT_OUT_DIR);
+  const outDir = path30.resolve(opts.outDir ?? DEFAULT_OUT_DIR);
   const mode = opts.mode;
   if (mode !== void 0 && !isRenderMode(mode)) {
     log.error(`Unknown --mode ${mode}. Use one of: ${RENDER_MODES.join(", ")}.`);
@@ -22211,14 +22403,14 @@ async function runBlender(opts) {
       return 0;
     }
     case "export": {
-      const target = opts.out ?? path29.join(outDir, "scene.glb");
+      const target = opts.out ?? path30.join(outDir, "scene.glb");
       const r = await blenderCall(base, "/export", { path: "/tmp/genex-export.glb" });
       if (!r.glbBase64) {
         log.error(`/export answered with no GLB bytes${r.uploaded ? " (it was uploaded, not inlined)" : ""}`);
         return 1;
       }
-      await fs29.mkdir(path29.dirname(target), { recursive: true });
-      await fs29.writeFile(target, Buffer.from(r.glbBase64, "base64"));
+      await fs30.mkdir(path30.dirname(target), { recursive: true });
+      await fs30.writeFile(target, Buffer.from(r.glbBase64, "base64"));
       log.success(`Exported ${r.bytes ?? 0} bytes`);
       log.plain(`  ${c.cyan(target)}`);
       return 0;
@@ -22251,12 +22443,12 @@ async function runBlender(opts) {
           return 1;
         }
         try {
-          script = await fs29.readFile(opts.input, "utf8");
+          script = await fs30.readFile(opts.input, "utf8");
         } catch {
           log.error(`Can't read ${opts.input}`);
           return 1;
         }
-        label = path29.basename(opts.input);
+        label = path30.basename(opts.input);
       }
       const r = await blenderCall(base, "/exec", { script, ...mode ? { mode } : {}, sheet: { formats: SHEET_FORMATS } });
       if (r.stdout?.trim()) log.plain(r.stdout.trimEnd());
@@ -22375,9 +22567,9 @@ print(f"castle: {n} objects")
 `;
 
 // src/commands/asset-new.ts
-import fs30 from "fs";
+import fs31 from "fs";
 import fsp from "fs/promises";
-import path30 from "path";
+import path31 from "path";
 import { pathToFileURL } from "url";
 var EXTRA_FILES = [
   "genex-asset.example.json",
@@ -22471,7 +22663,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 ? path30.resolve(options.dir) : process.cwd();
+  const cwd = options.dir ? path31.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>]');
@@ -22481,14 +22673,14 @@ async function runAssetNew(options) {
     log.error(`The slug must be kebab-case (letters, digits, dashes), got: ${slug}`);
     return 1;
   }
-  const templateDir = path30.join(getTemplatesDir(), "asset-viewer");
-  if (!fs30.existsSync(templateDir)) {
+  const templateDir = path31.join(getTemplatesDir(), "asset-viewer");
+  if (!fs31.existsSync(templateDir)) {
     log.error(`Vendored asset-viewer template not found at ${templateDir} \u2014 reinstall the CLI.`);
     return 1;
   }
-  const manifestTools = await import(pathToFileURL(path30.join(templateDir, "tools", "emit-manifest.mjs")).href);
+  const manifestTools = await import(pathToFileURL(path31.join(templateDir, "tools", "emit-manifest.mjs")).href);
   const { SHARED_FILES, PARITY_FILENAME, hashSharedFiles, pascalCase } = manifestTools;
-  const lockPath = path30.join(templateDir, "shared-files.sha256.json");
+  const lockPath = path31.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]);
@@ -22501,8 +22693,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 = path30.resolve(cwd, options.out ?? slug);
-  if (fs30.existsSync(outDir) && fs30.readdirSync(outDir).length > 0 && !options.force) {
+  const outDir = path31.resolve(cwd, options.out ?? slug);
+  if (fs31.existsSync(outDir) && fs31.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;
   }
@@ -22530,24 +22722,24 @@ async function runAssetNew(options) {
   };
   await fsp.mkdir(outDir, { recursive: true });
   for (const rel of [...SHARED_FILES, ...EXTRA_FILES]) {
-    const to = path30.join(outDir, rel);
-    await fsp.mkdir(path30.dirname(to), { recursive: true });
-    await fsp.copyFile(path30.join(templateDir, rel), to);
+    const to = path31.join(outDir, rel);
+    await fsp.mkdir(path31.dirname(to), { recursive: true });
+    await fsp.copyFile(path31.join(templateDir, rel), to);
   }
-  const pkg = fillTemplate(await fsp.readFile(path30.join(templateDir, "package.json"), "utf8"), {
+  const pkg = fillTemplate(await fsp.readFile(path31.join(templateDir, "package.json"), "utf8"), {
     slug,
     name,
     version
   });
-  await fsp.writeFile(path30.join(outDir, "package.json"), pkg, "utf8");
-  await fsp.writeFile(path30.join(outDir, "asset.config.json"), JSON.stringify(config, null, 2) + "\n", "utf8");
-  await fsp.writeFile(path30.join(outDir, ".gitignore"), GITIGNORE, "utf8");
+  await fsp.writeFile(path31.join(outDir, "package.json"), pkg, "utf8");
+  await fsp.writeFile(path31.join(outDir, "asset.config.json"), JSON.stringify(config, null, 2) + "\n", "utf8");
+  await fsp.writeFile(path31.join(outDir, ".gitignore"), GITIGNORE, "utf8");
   await fsp.writeFile(
-    path30.join(outDir, "DESIGN.md"),
+    path31.join(outDir, "DESIGN.md"),
     designDoc({ name, slug, sizeMeters, triBand, holder }),
     "utf8"
   );
-  const placeholder = await fsp.readFile(path30.join(templateDir, "src", "asset", "PLACEHOLDER.ts"), "utf8");
+  const placeholder = await fsp.readFile(path31.join(templateDir, "src", "asset", "PLACEHOLDER.ts"), "utf8");
   const seeded = seedAssetSource(placeholder, {
     slug,
     name,
@@ -22558,8 +22750,8 @@ async function runAssetNew(options) {
     pascalCase
   });
   const assetFilename = `${slug.replace(/-([a-z0-9])/g, (_, ch) => ch.toUpperCase())}.ts`;
-  await fsp.mkdir(path30.join(outDir, "src", "asset"), { recursive: true });
-  await fsp.writeFile(path30.join(outDir, "src", "asset", assetFilename), seeded, "utf8");
+  await fsp.mkdir(path31.join(outDir, "src", "asset"), { recursive: true });
+  await fsp.writeFile(path31.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) {
@@ -22567,7 +22759,7 @@ async function runAssetNew(options) {
     return 1;
   }
   await fsp.writeFile(
-    path30.join(outDir, PARITY_FILENAME),
+    path31.join(outDir, PARITY_FILENAME),
     JSON.stringify(
       {
         note: "Recorded by `genex asset new`. Gate G13 recomputes these; do not hand-edit the viewer.",
@@ -22611,10 +22803,10 @@ async function runAssetNew(options) {
 }
 
 // src/commands/tools.ts
-import path32 from "path";
+import path33 from "path";
 
 // src/commands/doctor.ts
-import path31 from "path";
+import path32 from "path";
 var LANE_ORDER = [
   "model",
   "image",
@@ -22895,7 +23087,7 @@ async function fetchLegalStatus(apiUrl, token) {
 }
 async function firstSkillsMarker() {
   for (const target of resolveAgentTargets()) {
-    const marker = await readSkillsMarker(path31.join(target.baseDir, "skills"));
+    const marker = await readSkillsMarker(path32.join(target.baseDir, "skills"));
     if (marker) return marker;
   }
   return null;
@@ -22946,8 +23138,8 @@ async function runTools(opts) {
   let totalNew = 0;
   let totalUpdated = 0;
   for (const t of targets) {
-    const dest = path32.join(t.baseDir, "skills");
-    const { copied, updated } = await copyTemplates(path32.join(templatesDir, "skills"), dest, {
+    const dest = path33.join(t.baseDir, "skills");
+    const { copied, updated } = await copyTemplates(path33.join(templatesDir, "skills"), dest, {
       filter: (rel) => skillFamilyFilter("tools")(`skills/${rel}`)
     });
     await pruneRemovedSkills(dest, log);
@@ -23005,6 +23197,164 @@ async function runTools(opts) {
   log.dim("  Assets land in ./assets/ as files you own \u2014 wire the local path into your game.");
 }
 
+// src/commands/budget.ts
+import fs32 from "fs/promises";
+import path34 from "path";
+var BUDGET_SOURCE_LINE = "Live from your account; prices can change without a deploy.";
+var BUDGET_APPROVAL_REQUIRED = "STOP: raising the asset allowance requires the player's explicit approval. Re-run with --user-approved only after they agreed to the number.";
+function internalKind(kind) {
+  return kind === "agent_session" || kind === "blender_seat" || kind === "avatar_look" || kind.startsWith("outfit") || kind.startsWith("cover_");
+}
+async function isGenexProject(cwd) {
+  try {
+    await fs32.access(path34.join(cwd, ".genex"));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function runnableKinds(prices) {
+  return Object.entries(prices).filter(([kind, credits]) => !internalKind(kind) && typeof credits === "number" && Number.isFinite(credits)).sort((a, b) => a[1] - b[1] || a[0].localeCompare(b[0]));
+}
+function describeDefault(config) {
+  const share = config.share === 0.5 ? "half" : `${Math.round(config.share * 100)}%`;
+  return `default: ${share} of what was spendable at the first paid command, capped at ${config.cap}`;
+}
+function isoDay(iso) {
+  const d = new Date(iso);
+  return Number.isNaN(d.getTime()) ? iso : d.toISOString().slice(0, 10);
+}
+async function runBudget(opts = {}) {
+  const log = createLogger({ quiet: opts.quiet || opts.json });
+  const cwd = opts.cwd ?? process.cwd();
+  const config = budgetConfig();
+  const fail3 = (message) => {
+    if (opts.json) writeJson({ command: "budget", status: "failed", error: message });
+    else log.error(message);
+    process.exitCode = 1;
+  };
+  const setting = opts.assets !== void 0;
+  if (setting && opts.userApproved !== true) {
+    fail3(BUDGET_APPROVAL_REQUIRED);
+    return;
+  }
+  if (setting && (!Number.isInteger(opts.assets) || opts.assets < 0)) {
+    fail3(`--assets takes a whole number of credits, 0 or more (got ${String(opts.assets)}).`);
+    return;
+  }
+  const token = opts.token ?? await readUserToken(opts.envPath);
+  if (!token) {
+    fail3("Not authorized. Run `genex init` first to sign in.");
+    return;
+  }
+  const meta = await readProject(cwd);
+  const apiUrl = getApiUrl(opts.apiUrl ?? meta?.apiUrl);
+  const snapshot = await fetchCreditsSnapshot(apiUrl, token);
+  let store;
+  let persisted = true;
+  if (setting) {
+    const previous = await readBudgetStore(cwd);
+    store = {
+      v: 1,
+      allowanceCredits: opts.assets,
+      setBy: "user",
+      setAt: (/* @__PURE__ */ new Date()).toISOString(),
+      spendableAtStart: previous?.spendableAtStart ?? snapshot?.spendable ?? 0,
+      balanceAtStart: previous?.balanceAtStart ?? snapshot?.balance ?? 0
+    };
+    persisted = await writeBudgetStore(cwd, store);
+    if (!persisted) {
+      fail3("This folder is not a Genex project (no .genex/), so the allowance has nowhere to live. Run this inside the game folder.");
+      return;
+    }
+  } else if (snapshot && !snapshot.unlimited && !budgetDisabled(config)) {
+    store = await ensureBudgetStore(cwd, {
+      balance: snapshot.balance,
+      spendable: snapshot.spendable,
+      config
+    });
+    persisted = await readBudgetStore(cwd) !== null;
+  } else {
+    store = await readBudgetStore(cwd);
+    persisted = await isGenexProject(cwd);
+  }
+  const spent = spentCredits(await readLedgerRows(cwd));
+  const disabled = budgetDisabled(config);
+  const enforced = !disabled && !(snapshot?.unlimited ?? false);
+  const allowance = store?.allowanceCredits ?? null;
+  const remaining = allowance === null ? null : Math.max(0, allowance - spent);
+  if (opts.json) {
+    writeJson({
+      command: "budget",
+      ...snapshot ? {
+        balance: snapshot.balance,
+        reserved: snapshot.reserved,
+        spendable: snapshot.spendable,
+        unlimited: snapshot.unlimited
+      } : { balance: null, reserved: null, spendable: null, unlimited: null },
+      allowance: {
+        credits: allowance,
+        setBy: store?.setBy ?? null,
+        setAt: store?.setAt ?? null,
+        spendableAtStart: store?.spendableAtStart ?? null,
+        balanceAtStart: store?.balanceAtStart ?? null,
+        enforced,
+        disabled,
+        persisted
+      },
+      spent,
+      remaining,
+      prices: snapshot ? Object.fromEntries(runnableKinds(snapshot.prices)) : null,
+      source: BUDGET_SOURCE_LINE,
+      ...snapshot ? {} : { warning: `Balance and prices couldn't be read from ${apiUrl}.` }
+    });
+    if (!snapshot && !setting) process.exitCode = 1;
+    return;
+  }
+  log.plain(c.bold("genex budget"));
+  if (setting && store) {
+    log.success(`Asset allowance set to ${store.allowanceCredits} credits (approved by the player).`);
+  }
+  if (snapshot) {
+    log.plain(`  Balance      ${snapshot.balance} credits \xB7 ${snapshot.reserved} reserved \xB7 ${snapshot.spendable} spendable`);
+  } else {
+    log.warn(`  Balance      couldn't be read from ${apiUrl} \u2014 run ${c.cyan("npx genex doctor")}.`);
+  }
+  if (disabled) {
+    log.plain(`  Allowance    off (GENEX_ASSET_BUDGET_CAP=0)`);
+  } else if (snapshot?.unlimited) {
+    log.plain(`  Allowance    not enforced (unlimited operator account)`);
+  } else if (store) {
+    const origin = store.setBy === "user" ? `set by you on ${isoDay(store.setAt)}` : describeDefault(config);
+    log.plain(`  Allowance    ${store.allowanceCredits} credits (${origin})`);
+  } else {
+    log.plain(`  Allowance    not derived yet \u2014 it is sized from the wallet at the first paid command`);
+  }
+  log.plain(`  Spent        ${spent} credits this build (quoted; failed generations are refunded and excluded)`);
+  if (remaining !== null && enforced) {
+    log.plain(`  Remaining    ${remaining} credits`);
+  }
+  if (!persisted) {
+    log.dim("  (not a Genex project folder \u2014 the allowance is not saved here)");
+  }
+  if (snapshot) {
+    const kinds = runnableKinds(snapshot.prices);
+    if (kinds.length > 0) {
+      log.plain("");
+      log.plain(c.bold("  Prices (credits)"));
+      for (const [kind, credits] of kinds) {
+        log.plain(`    ${kind.padEnd(20)} ${String(credits).padStart(5)}`);
+      }
+    }
+  }
+  log.plain("");
+  log.dim(`  ${BUDGET_SOURCE_LINE}`);
+  if (enforced && !setting) {
+    log.dim(`  More for this game? Ask the player, then: ${c.cyan("npx genex budget --assets <credits> --user-approved")}`);
+  }
+  if (!snapshot && !setting) process.exitCode = 1;
+}
+
 // src/lib/costs.ts
 var TYPICAL_CREDITS = {
   model: 35,
@@ -23059,6 +23409,11 @@ ${c.bold("Usage")}
                                      generation lanes are live. Exit 0 all clear,
                                      1 if something needs fixing \u2014 run it first when
                                      a command fails.
+  genex budget [--json]              This build's asset allowance: balance, allowance,
+                                     spent so far, what's left, and live prices \u2014 plan
+                                     the asset table against it. --assets <credits>
+                                     --user-approved raises it, only once the player
+                                     has agreed to the number.
   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
@@ -23551,6 +23906,9 @@ ${c.bold("Characters")}
 ${c.bold("Workflow")}
   genex doctor [--json]              Sign-in, credits, Node/CLI version, and which
                                      lanes are live. Run it when anything fails.
+  genex budget [--json]              Balance, this build's asset allowance, spent,
+                                     remaining, live prices. --assets <credits>
+                                     --user-approved raises it (player's say-so first).
   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.
@@ -23585,6 +23943,32 @@ Hosting, publishing, multiplayer, remixing and custom domains are the Genex
 platform \u2014 build a game there from one prompt: ${c.cyan("https://genex.games")}
 `;
 var COMMAND_HELP = {
+  budget: `${c.bold("genex budget")} \u2014 this build's asset allowance, and the live numbers to plan against.
+
+${c.bold("Usage")}
+  genex budget                       Balance \xB7 reserved \xB7 spendable; the allowance (default,
+                                     or set by the player); spent this build; remaining;
+                                     and the live price per kind, cheapest first.
+  genex budget --json                The same, as one object.
+  genex budget --assets <credits> --user-approved
+                                     Set the allowance to <credits> \u2014 a whole number, 0 or
+                                     more. Refused without --user-approved: raising it needs
+                                     the player's explicit approval of the number. 0 means
+                                     no more paid generation in this build.
+
+${c.bold("How the allowance works")}
+  A per-build spend limit, checked before every paid generation in both workspace
+  modes \u2014 the spend limit the shipping ratchet (preview between batches) is not.
+  The default is derived ONCE, at the first paid command: ${DEFAULT_ASSET_BUDGET_SHARE === 0.5 ? "half" : `${Math.round(DEFAULT_ASSET_BUDGET_SHARE * 100)}%`} of the
+  spendable balance, capped at ${DEFAULT_ASSET_BUDGET_CAP} credits. The wallet moving later does not move
+  it \u2014 only --assets does. A refused generation names the numbers and the fix: ask
+  the player, then re-run this with the number they agreed to; or build the thing in
+  code and say why. Failed generations are refunded and never count.
+  Stored in .genex/asset-budget.json. Operator knobs: GENEX_ASSET_BUDGET_SHARE (0-1)
+  and GENEX_ASSET_BUDGET_CAP (credits; 0 turns the budget off).
+
+  Every number printed is live from your account; prices can change without a deploy.
+`,
   remix: `genex remix <slug-or-Genex-page-URL> [directory] [--preview | --source-only] [--json]
 
 Prepare source and assets at one pinned snapshot. The default destination is a fresh
@@ -23726,6 +24110,8 @@ function parseArgs(argv) {
     "--approve-remesh",
     "--category",
     "--limit",
+    // `genex budget --assets <credits>` — the allowance the player approved.
+    "--assets",
     // `genex motion` value flags.
     "--takes",
     "--seeds",
@@ -24158,6 +24544,14 @@ function applyValueFlag(options, flag, value) {
       options.limit = n;
       break;
     }
+    case "--assets": {
+      const n = Number(value);
+      if (!Number.isInteger(n) || n < 0) {
+        throw new Error(`Invalid --assets value: ${value} (whole credits, 0 or more)`);
+      }
+      options.assets = n;
+      break;
+    }
     case "--timeout": {
       const n = Number(value);
       if (!Number.isFinite(n) || n <= 0) {
@@ -24436,6 +24830,12 @@ async function main() {
       case "doctor":
         await runDoctor(parsed.options);
         break;
+      // The asset allowance in the open (`lib/asset-budget.ts`): the numbers
+      // an agent plans the asset table against, and the one door — with the
+      // player's approval — through which the allowance moves.
+      case "budget":
+        await runBudget(parsed.options);
+        break;
       case "auth":
         await runAuth(parsed.options);
         break;