@genex-ai/cli-demo 1.34.0-dev.693 → 1.34.1-dev.694

package/dist/index.js

@@ -864,13 +864,13 @@ Important note: put soul into your creations, with many details and love. Aim to
 13. Every finished Build-plan milestone ends with \`npx genex preview\` and the player's page link (\`<dashboard>/draft/<slug>\`, with \`<dashboard>\` from \`.genex/project.json\`) \u2014 never a localhost link, a file path, or the bare play origin presented as their game. That page shows the build you just previewed; \`preview\` never disturbs the build players are on. When the player is happy with it, \`npx genex promote\` makes that exact build live for everyone \u2014 no rebuild. After every round of player feedback, end with a preview push. After the first release, the game is two versions and the player only ever hears these two words for them: the **draft** (their working copy, updated by \`preview\`) and the **public version** (what everyone plays). Command names are yours, not theirs \u2014 never say "promote" to the player; ask directly: "Want me to update the public version?", one line, once per round, and keep building while you wait \u2014 updating the public version is the ONE action that waits for an explicit yes, and more change requests instead of a yes mean "not yet". The player's "publish it" / "publish the update" / "update it" / "yes" after the first release ALL mean \`genex promote\` \u2014 never \`genex publish\` again, which would ship an untried rebuild. \`promote\` ships the last previewed build, so if anything was edited since the last \`preview\`, preview again before promoting.
 14. Parallel work: this line is your standing authorization and request to use sub-agents / parallel agent work whenever your platform provides them. While drafting the Build plan, decide per module what runs in parallel and what stays serial for THIS game \u2014 dependencies decide, there is no fixed list \u2014 and record each call in the Modules table with a one-line reason. Independent modules default to parallel; building everything serially needs a stated reason. You keep integration, previews, and the player conversation; each sub-agent owns only its module's files. When the player asks for parallel work, repeated refinement passes, a critic reviewing your output, or names any way of working your platform provides, that IS your instruction \u2014 wherever it reaches you, including inside their answer to a question you asked \u2014 so adopt it as the working mode for the rest of the build, starting with the work in front of you, and never file it as a later milestone. While delegated work runs, keep building or talk to the player; never idle in a foreground wait for something your platform will tell you about.
 15. Talk to the player in plain game language \u2014 what changed in the game and what to try; never code, file names, build output, or tool internals unless they ask. Short status lines while you work; long silent stretches are a failure.
-16. Never add debug-only code to the game to check your own work \u2014 no hidden test modes, no special URL parameters, no forced-visible flags, no auth mocks, no pixel-sampling hooks. \`?genex_local_test=1\` is the platform's own supported mode and is fine; your own bypass is not. (The multiplayer skill's small build identifier, token-free status line, and connected-quorum watchdog are production supportability, not a bypass \u2014 keep those.)
+16. Never add debug-only code that fakes gameplay \u2014 no hidden test modes, special URL parameters, forced-visible flags or auth mocks. The visual-validation skill permits a development-only final-mix analyser for a deliberately triggered audible event; remove it from published builds. \`?genex_local_test=1\` is the platform's own supported mode and is fine; your own bypass is not. (The multiplayer skill's small build identifier, token-free status line, and connected-quorum watchdog are production supportability, not a bypass \u2014 keep those.)
 17. Input directions match their labels: A/\u2190 moves or turns the player screen-LEFT, D/\u2192 screen-RIGHT, mouse-up looks up, and drag-pan axes share ONE convention. The cursor is either the gameplay tool (RTS, card, builder) or locked away during play \u2014 keyboard-only games included. Check it in every milestone's smoke pass.
 18. NEVER delete, empty, move, rename, or overwrite anything you did not create yourself. This folder may hold the player's own reference images, notes, sketches, or an earlier attempt \u2014 files that 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 interactive prompt, and every setup tool's offer to empty a directory (\`--force\`, \`--overwrite\`, "Remove existing files") \u2014 scaffold into a fresh subfolder and copy in instead. 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. This binds hardest during setup, where it runs fast and automatically before the player has asked for anything at all.
 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.
 20. When the player names a specific thing to integrate \u2014 a library, a controller, an asset, a part of an existing game, or a tagged reference the platform placed in \`.genex/refs/<slug>/\` \u2014 integrate the real thing: read its source first and build from it, never a lighter look-alike written from scratch because it was faster. A tagged reference owns the subsystem it was tagged for, outranking the default lane and the vendored controllers for that subsystem. If you genuinely can't use it, say so in one plain line and ask how to proceed.
 21. A turn ends in exactly one of two ways: on a question the player must answer before the next step can be chosen, or on a handoff \u2014 the draft link, what changed, what to try, and what is still open. Never close a turn on a promise. "I'll keep building", "while I keep working", "adding that now" are things you say and then DO before you stop; if you are stopping, say that you have stopped and what remains. While the Build plan's \`Now:\` line has open work and no answer is needed from the player, the turn is not over: preview, hand off, and start the next milestone in the same turn, until the requested outcome is reached or the platform's own budget ends the session. If a stop was forced on you anyway, the first line of your next turn is the promise you left and where it stands.
-22. **What the player sees must read as the thing it is**, in this game's own style: a building as that building, a person as a person, a prop as that prop, a surface as its material \u2014 and a coloured box, a capsule, or a flat grey block standing in for one of them is never its finished version. Generation is the default route to that bar wherever code will not honestly reach it: the player's character, whatever the request names, whatever the player walks up to, enters, or interacts with, and the music and sound underneath \u2014 reach for the belt on your own judgment, without stopping to ask; a status line saying what you queued is enough, and \`--no-wait\` keeps you building while it lands. Procedural code is a first-class engine for what is structural, repeated, distant, or parametric \u2014 terrain, sky, fences, paving, modular kits, filler \u2014 and for anything else only when the result meets the same bar and you have looked at it in a capture before its row says \`landed\`. Decide per object, not per category, and write the route on each Assets row in \`DESIGN.md\` \u2014 the paid flow for generated pieces, the procedural flow with its local path for code-built ones. An Assets table with no generation in it is a decision, not a default: record it as \`Generation: none \u2014 <why code alone reaches the bar here>\` or generate.
+22. **What the player sees must read as the thing it is**, in this game's own style: a building as that building, a person as a person, a prop as that prop, a surface as its material \u2014 and a coloured box, a capsule, or a flat grey block standing in for one of them is never its finished version. Generation is the default route to that bar wherever code will not honestly reach it: the player's character, whatever the request names, whatever the player walks up to, enters, or interacts with, and the music and sound underneath \u2014 reach for the belt on your own judgment, without stopping to ask; a status line saying what you queued is enough, and \`--no-wait\` keeps you building while it lands. Procedural code is a first-class engine for what is structural, repeated, distant, or parametric \u2014 terrain, sky, fences, paving, modular kits, filler \u2014 and for anything else only when the result meets the same bar and you have looked at it in a capture before its row says \`landed\`. Start with one reusable implementation per distinct required gameplay or visual role. Background populations default to reusable procedural bodies and motion or compatible existing rigged assets. Catalog clips need a compatible skeleton and may be paid. Reserve paid custom bodies for the player and characters examined or interacted with closely, while honoring explicit user requests. Add variants only for an unmet requirement; unspent allowance is not unfinished work. Allowance questions use timeoutPolicy no-consent: silence does not raise the allowance. Record role, reuse and completion criteria in the existing Assets table. Decide per object, not per category, and write the route on each Assets row in \`DESIGN.md\` \u2014 the paid flow for generated pieces, the procedural flow with its local path for code-built ones. An Assets table with no generation in it is a decision, not a default: record it as \`Generation: none \u2014 <why code alone reaches the bar here>\` or generate.
 23. **The screenshots you take to look at your own work go in \`.genex/scratch/\`.** Captures, render comparisons, before/after strips, traces and metrics dumps are how you SEE what you built \u2014 they are not part of what you built, and \`genex preview\` pushes the whole folder to the game's source, every time, forever. \`.genex/scratch/\` already exists for this and is already ignored, so there is nothing to set up: write the capture as \`.genex/scratch/arena-before.png\` and read it back from there. Never put them in a folder of your own at the top level: \`progress/\`, \`reports/\`, \`shots/\` and their kind are pushed like source and become permanent weight in the game and in every remix of it \u2014 one real game reached 11 GB and 10,332 committed screenshots exactly this way. If you find such a folder already there, add it to \`.gitignore\`; never delete the player's files (law 18).
 ${CONTRACT_END}
 `;
@@ -1897,6 +1897,30 @@ import "child_process";
 import fs11 from "fs/promises";
 import path11 from "path";
 var ledgerPath = (cwd) => path11.join(cwd, ".genex", "generations.ndjson");
+async function appendAdmissionRow(cwd, event) {
+  const file = await fs11.open(ledgerPath(cwd), "a");
+  try {
+    await file.writeFile(`${JSON.stringify(event)}
+`, "utf8");
+    await file.sync();
+  } finally {
+    await file.close();
+  }
+}
+async function readAdmissionRows(cwd) {
+  let raw;
+  try {
+    raw = await fs11.readFile(ledgerPath(cwd), "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return [];
+    throw error;
+  }
+  return raw.split("\n").filter((line) => line.trim()).map((line) => {
+    const row = JSON.parse(line);
+    if (!row || typeof row !== "object" || Array.isArray(row)) throw new Error("Invalid generation ledger; reconcile it before spending.");
+    return row;
+  });
+}
 async function append(cwd, event) {
   try {
     await fs11.access(path11.join(cwd, ".genex"));
@@ -1941,19 +1965,6 @@ async function readLedger(cwd = process.cwd()) {
   }
   return [...entries.values()];
 }
-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(),
-    ...typeof credits === "number" && Number.isFinite(credits) && credits >= 0 ? { credits } : {},
-    ...typeof extra.outDir === "string" && extra.outDir.trim() ? { out: extra.outDir.trim() } : {}
-  });
-}
 async function recordTerminal(id, status, urls, cwd = process.cwd()) {
   const existing = (await readLedger(cwd)).find((e) => e.id === id);
   if (existing && existing.status === status) return;
@@ -7884,8 +7895,8 @@ async function runRollback(opts) {
 }
 
 // src/commands/generate.ts
-import fs24 from "fs/promises";
-import path23 from "path";
+import fs25 from "fs/promises";
+import path24 from "path";
 import { PNG as PNG4 } from "pngjs";
 
 // src/lib/glass.ts
@@ -8066,6 +8077,11 @@ function ceilingVerdict(input) {
   return { allow: true };
 }
 
+// src/lib/generation-admission.ts
+import fs24 from "fs/promises";
+import path23 from "path";
+import { createHash, randomUUID } from "crypto";
+
 // src/lib/asset-budget.ts
 import fs23 from "fs/promises";
 import path22 from "path";
@@ -8128,6 +8144,12 @@ async function writeBudgetStore(cwd, store) {
 async function ensureBudgetStore(cwd, input) {
   const existing = await readBudgetStore(cwd);
   if (existing) return existing;
+  try {
+    await fs23.stat(storePath(cwd));
+    throw new Error("Stored asset allowance is unreadable or invalid; reconcile it before paid generation.");
+  } catch (error) {
+    if (error.code !== "ENOENT") throw error;
+  }
   const store = {
     v: 1,
     allowanceCredits: allowanceFor({ spendable: input.spendable, config: input.config }),
@@ -8136,7 +8158,7 @@ async function ensureBudgetStore(cwd, input) {
     spendableAtStart: input.spendable,
     balanceAtStart: input.balance
   };
-  await writeBudgetStore(cwd, store);
+  if (!await writeBudgetStore(cwd, store)) throw new Error("Cannot persist this build allowance; no paid generation was sent.");
   return store;
 }
 function isFailureRow(row) {
@@ -8144,9 +8166,16 @@ function isFailureRow(row) {
 }
 function spentCredits(rows) {
   const quoted = /* @__PURE__ */ new Map();
+  const reservations = /* @__PURE__ */ new Map();
   for (const row of rows) {
     if (typeof row.id !== "string") continue;
-    if (row.t === "q") {
+    if (row.t === "reserve") {
+      if (typeof row.credits !== "number" || !Number.isFinite(row.credits) || row.credits < 0) throw new Error("Invalid allowance reservation");
+      reservations.set(row.id, row.credits);
+    } else if (row.t === "release") {
+      reservations.delete(row.id);
+    } else if (row.t === "q") {
+      if (typeof row.reservationId === "string") reservations.delete(row.reservationId);
       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);
@@ -8156,6 +8185,7 @@ function spentCredits(rows) {
   }
   let total = 0;
   for (const credits of quoted.values()) total += credits;
+  for (const credits of reservations.values()) total += credits;
   return total;
 }
 function budgetVerdict(input) {
@@ -8197,28 +8227,156 @@ async function fetchCreditsSnapshot(apiUrl, token) {
 }
 async function assetBudgetGate(input) {
   const config = input.config ?? budgetConfig();
-  if (budgetDisabled(config)) return { allow: true };
+  if (input.quotedCredits === 0 || 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 };
+    return { allow: false, reason: "Cannot read the wallet to check the asset allowance. No paid generation was sent; retry when the API is available." };
   }
   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 };
+    return { allow: false, reason: `No valid live quote for ${input.kind}; no generation was sent.` };
   }
   const store = await ensureBudgetStore(cwd, {
     balance: snapshot.balance,
     spendable: snapshot.spendable,
     config
   });
-  const spent = spentCredits(await readLedgerRows(cwd));
+  const spent = spentCredits(await readAdmissionRows(cwd));
   return budgetVerdict({ kind: input.kind, price, spent, allowance: store.allowanceCredits, config });
 }
 
+// src/lib/generation-admission.ts
+async function withAdmissionLock(cwd, work, waitMs = 3e4) {
+  const lock = path23.join(cwd, ".genex", "generation-admission.lock");
+  const deadline = Date.now() + waitMs;
+  let file;
+  while (!file) {
+    try {
+      file = await fs24.open(lock, "wx");
+    } catch (error) {
+      if (error.code !== "EEXIST") throw error;
+      if (Date.now() >= deadline) throw new Error("Another generation admission holds .genex/generation-admission.lock. If its process died, reconcile pending reservations before removing that lock.");
+      await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+  }
+  try {
+    await file.writeFile(String(process.pid));
+    return await work();
+  } finally {
+    await file.close();
+    await fs24.unlink(lock);
+  }
+}
+async function enqueueWithAllowance(input) {
+  const cwd = input.cwd ?? process.cwd();
+  try {
+    return await withAdmissionLock(cwd, async () => {
+      const createPath = input.createPath ?? "/api/generations";
+      const generic = createPath === "/api/generations";
+      const headers = { "Content-Type": "application/json", Authorization: `Bearer ${input.token}` };
+      const fingerprint = createHash("sha256").update(JSON.stringify([input.apiUrl, createPath, input.body])).digest("hex");
+      const rows = await readAdmissionRows(cwd);
+      const pending = /* @__PURE__ */ new Map();
+      for (const row of rows) {
+        if (row.t === "reserve" && typeof row.id === "string") pending.set(row.id, row);
+        if (row.t === "release" && typeof row.id === "string") pending.delete(row.id);
+        if (row.t === "q" && typeof row.reservationId === "string") pending.delete(row.reservationId);
+      }
+      for (const [requestId2, row] of pending) {
+        if (row.apiUrl === input.apiUrl && row.generic === true) {
+          const response2 = await apiFetch(`${input.apiUrl}/api/generations/requests/${encodeURIComponent(requestId2)}`, { headers });
+          if (response2.ok) {
+            const found = await response2.json();
+            if (typeof found.id === "string" && Number.isSafeInteger(found.creditsQuoted) && found.creditsQuoted >= 0) {
+              await appendAdmissionRow(cwd, {
+                t: "q",
+                id: found.id,
+                kind: row.kind,
+                prompt: row.prompt,
+                credits: found.creditsQuoted,
+                reservationId: requestId2,
+                at: (/* @__PURE__ */ new Date()).toISOString(),
+                out: row.out
+              });
+              if (row.fingerprint === fingerprint) {
+                input.log.dim(`Recovered generation ${found.id}; no replacement request was sent.`);
+                return found;
+              }
+              continue;
+            }
+          }
+        }
+        if (row.fingerprint === fingerprint) throw new Error(`The earlier request ${requestId2} has an unknown outcome and remains reserved. Reconcile it before repeating this generation; no replacement was sent.`);
+      }
+      let credits = input.quotedCredits;
+      if (generic) {
+        const quote2 = await apiFetch(`${input.apiUrl}/api/generations/quote`, { method: "POST", headers, body: JSON.stringify(input.body) });
+        if (!quote2.ok) {
+          const error = await quote2.json().catch(() => ({}));
+          throw new Error(error.message ?? `Cannot quote this generation (HTTP ${quote2.status}). No generation was sent; the API must support option-aware quotes.`);
+        }
+        credits = (await quote2.json()).creditsQuoted;
+      }
+      if (!Number.isSafeInteger(credits) || credits < 0) throw new Error("The API returned no valid generation quote; no generation was sent.");
+      const budget = await assetBudgetGate({
+        apiUrl: input.apiUrl,
+        token: input.token,
+        kind: input.kind,
+        quotedCredits: credits,
+        cwd,
+        log: input.log
+      });
+      if (!budget.allow) throw new Error(budget.reason);
+      const requestId = randomUUID();
+      await appendAdmissionRow(cwd, {
+        t: "reserve",
+        id: requestId,
+        credits,
+        kind: input.kind,
+        prompt: input.prompt.slice(0, 120),
+        at: (/* @__PURE__ */ new Date()).toISOString(),
+        apiUrl: input.apiUrl,
+        fingerprint,
+        generic,
+        out: input.outDir
+      });
+      const response = await apiFetch(`${input.apiUrl}${createPath}`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(generic ? { ...input.body, maxCredits: credits, requestId } : input.body)
+      });
+      if (!response.ok) {
+        const definiteRefusal = response.status >= 400 && response.status < 500 && response.status !== 408 && response.status !== 499;
+        if (definiteRefusal) await appendAdmissionRow(cwd, { t: "release", id: requestId });
+        const body = await response.json().catch(() => ({}));
+        throw new Error(body.message ?? `Generation request failed (HTTP ${response.status}); ${!definiteRefusal ? "its allowance remains reserved until reconciliation" : "no generation was accepted"}.`);
+      }
+      const created = await response.json();
+      if (typeof created.id !== "string" || !created.id) throw new Error(`Generation response missing its id; request ${requestId} remains reserved.`);
+      const authoritative = generic ? created.creditsQuoted : created.creditsQuoted ?? credits;
+      if (!Number.isSafeInteger(authoritative) || authoritative < 0) throw new Error(`Generation ${created.id} returned an invalid quote; request remains reserved.`);
+      await appendAdmissionRow(cwd, {
+        t: "q",
+        id: created.id,
+        kind: input.kind,
+        prompt: input.prompt.slice(0, 120),
+        ...input.prompt.length > 120 ? { tail: input.prompt.slice(-120) } : {},
+        at: (/* @__PURE__ */ new Date()).toISOString(),
+        credits: authoritative,
+        reservationId: requestId,
+        ...input.outDir ? { out: input.outDir } : {}
+      });
+      return { ...created, creditsQuoted: authoritative };
+    });
+  } catch (error) {
+    input.log.error(String(error));
+    process.exitCode = 1;
+    return null;
+  }
+}
+
 // src/lib/lanes.ts
 var LANE_CREDITS = /* @__PURE__ */ new Set(["ok", "exhausted", "unknown"]);
 async function fetchLanes(apiUrl, token, timeoutMs = 4e3) {
@@ -8356,7 +8514,7 @@ var isRemoteRef = (value) => /^(https?:\/\/|data:)/i.test(value);
 async function inlineLocalImage(filePath, flag) {
   let bytes;
   try {
-    bytes = await fs24.readFile(filePath);
+    bytes = await fs25.readFile(filePath);
   } catch {
     return { ok: false, error: `Couldn't read the ${flag} file at ${filePath}.` };
   }
@@ -8366,7 +8524,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[path23.extname(filePath).toLowerCase()] ?? "image/png";
+  const mime = IMAGE_MIME_BY_EXT[path24.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.";
@@ -8553,7 +8711,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: ${path23.basename(ref).slice(0, 120)}`;
+    typedPrompt = `from image: ${path24.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).`);
@@ -8602,7 +8760,7 @@ async function runGenerate(kind, opts) {
       return;
     }
     try {
-      const bytes = await fs24.readFile(opts.inpaintUrl);
+      const bytes = await fs25.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}.`);
@@ -8706,58 +8864,17 @@ 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",
-      headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
-      body: JSON.stringify({ kind, prompt, options })
-    });
-    if (res.status === 401) {
-      log.error("Unauthorized \u2014 your token may have expired. Re-run `genex init`.");
-      process.exitCode = 1;
-      return;
-    }
-    if (printedStructuredError(res)) {
-      process.exitCode = 1;
-      return;
-    }
-    if (!res.ok) {
-      let message;
-      if (res.status >= 400 && res.status < 500) {
-        try {
-          const body = await res.json();
-          if (typeof body.message === "string" && body.message.trim()) message = body.message;
-        } catch {
-        }
-      }
-      log.error(message ?? `Generation request failed (HTTP ${res.status}).`);
-      process.exitCode = 1;
-      return;
-    }
-    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, void 0, {
-    credits: creditsQuoted ?? opts.quotedCredits,
-    ...opts.outDir ? { outDir: opts.outDir } : {}
+  const created = await enqueueWithAllowance({
+    apiUrl,
+    token,
+    kind,
+    prompt,
+    body: { kind, prompt, options },
+    log,
+    outDir: opts.outDir
   });
+  if (!created) return;
+  const id = created.id;
   if (opts.noWait) {
     if (opts.json) {
       writeJson({
@@ -8812,7 +8929,7 @@ async function reportGlassTerminal(view, outDir, log, json) {
     return;
   }
   await recordTerminal(view.id, "completed", files.map((f) => f.url));
-  await fs24.mkdir(outDir, { recursive: true });
+  await fs25.mkdir(outDir, { recursive: true });
   const solved = [];
   for (let i = 0; i < files.length; i++) {
     const f = files[i];
@@ -8844,8 +8961,8 @@ async function reportGlassTerminal(view, outDir, log, json) {
       });
       continue;
     }
-    const outPath = path23.join(outDir, `glass-${i + 1}.png`);
-    await fs24.writeFile(outPath, PNG4.sync.write(r.png));
+    const outPath = path24.join(outDir, `glass-${i + 1}.png`);
+    await fs25.writeFile(outPath, PNG4.sync.write(r.png));
     solved.push({
       path: outPath,
       url: f.url,
@@ -9464,8 +9581,8 @@ function writeJson(value) {
 }
 
 // src/commands/model-sub.ts
-import fs25 from "fs/promises";
-import path24 from "path";
+import fs26 from "fs/promises";
+import path25 from "path";
 var MODEL_SUBCOMMANDS = ["segment", "rig", "animate", "import"];
 function apiErrorMessage(data, fallback) {
   if (typeof data !== "object" || data === null) return fallback;
@@ -9480,29 +9597,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 ${path24.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 ${path25.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 fs25.readFile(filePath);
+    bytes = await fs26.readFile(filePath);
   } catch {
     log.error(`Couldn't read ${filePath}.`);
     return null;
   }
   if (bytes.byteLength > MODEL_IMPORT_MAX_BYTES) {
-    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.`);
+    log.error(`${path25.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(`${path24.basename(filePath)} is not a GLB (no glTF magic). A .gltf + .bin pair must be exported as one binary .glb.`);
+    log.error(`${path25.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: path24.basename(filePath), bytes: bytes.byteLength, contentType: "model/gltf-binary" })
+    body: JSON.stringify({ filename: path25.basename(filePath), bytes: bytes.byteLength, contentType: "model/gltf-binary" })
   });
   if (printedStructuredError(minted)) return null;
   if (!minted.ok) {
@@ -9511,7 +9628,7 @@ async function importModelFile(args) {
     return null;
   }
   const { id, uploadUrl, url } = await minted.json();
-  log.dim(`  uploading ${path24.basename(filePath)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
+  log.dim(`  uploading ${path25.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) },
@@ -9659,7 +9776,7 @@ async function runModelAnimate(opts) {
 }
 
 // src/commands/wait.ts
-import path25 from "path";
+import path26 from "path";
 var TERMINAL2 = /* @__PURE__ */ new Set(["completed", "failed"]);
 async function runWait(opts) {
   if (opts.all) return runWaitAll(opts);
@@ -9798,7 +9915,7 @@ async function runWaitAll(opts) {
       if (v?.status !== "completed" || !v.files?.length) continue;
       const local = localDeliveryFor("tools", { ...opts, outDir: opts.outDir ?? e.outDir }, e.prompt || e.kind);
       if (!local) continue;
-      const outDir = path25.join(path25.relative(process.cwd(), cwd) || ".", local.outDir);
+      const outDir = path26.join(path26.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;
@@ -9906,11 +10023,11 @@ async function toRow(e, v, cwd) {
 }
 
 // src/commands/controller.ts
-import fs27 from "fs/promises";
-import path27 from "path";
+import fs28 from "fs/promises";
+import path28 from "path";
 
 // ../../packages/meshy-animation-catalog/src/index.ts
-import { createHash } from "crypto";
+import { createHash as createHash2 } from "crypto";
 
 // ../../packages/meshy-animation-catalog/src/generated.ts
 var MESHY_ANIMATION_CATALOG = [
@@ -18914,7 +19031,7 @@ function normalizedPackDefinition(definition) {
   return { key, version: definition.version, actionIds, bindings };
 }
 function packFingerprint(definition) {
-  return createHash("sha256").update(JSON.stringify(definition)).digest("hex");
+  return createHash2("sha256").update(JSON.stringify(definition)).digest("hex");
 }
 function createMeshyControllerPackSnapshot(definition) {
   const normalized = normalizedPackDefinition(definition);
@@ -19037,9 +19154,9 @@ function searchMeshyAnimations(query, options = {}) {
 }
 
 // src/lib/anims.ts
-import fs26 from "fs/promises";
-import path26 from "path";
-var ANIMS_DEST = path26.join("public", "assets", "anims");
+import fs27 from "fs/promises";
+import path27 from "path";
+var ANIMS_DEST = path27.join("public", "assets", "anims");
 var HIDDEN_TAG = "reference";
 async function runAnims(opts) {
   const log = createLogger({ quiet: opts.quiet });
@@ -19055,7 +19172,7 @@ async function runAnims(opts) {
     printCatalog(log, manifest, selectors);
     return;
   }
-  const controllerMarker = path26.join(root, "src", "controllers", "character");
+  const controllerMarker = path27.join(root, "src", "controllers", "character");
   if (!await exists3(controllerMarker)) {
     log.error(
       `No character controller in this game (missing ${c.cyan("src/controllers/character/")}).`
@@ -19064,11 +19181,11 @@ async function runAnims(opts) {
     process.exitCode = 1;
     return;
   }
-  const destDir = path26.join(root, ANIMS_DEST);
-  const gameManifestPath = path26.join(destDir, "manifest.json");
+  const destDir = path27.join(root, ANIMS_DEST);
+  const gameManifestPath = path27.join(destDir, "manifest.json");
   if (opts.reset) {
-    await fs26.rm(destDir, { recursive: true, force: true });
-    log.step(`Cleared ${c.cyan(ANIMS_DEST + path26.sep)} (--reset)`);
+    await fs27.rm(destDir, { recursive: true, force: true });
+    log.step(`Cleared ${c.cyan(ANIMS_DEST + path27.sep)} (--reset)`);
   }
   if (selectors.length === 0) {
     const installed = await readGameManifest(gameManifestPath);
@@ -19106,35 +19223,35 @@ async function runAnims(opts) {
     }
   }
   const wanted = [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
-  const cacheDir = path26.join(
+  const cacheDir = path27.join(
     opts.cacheDir ?? getAnimsCacheDir(),
     `${manifest.library}-v${manifest.version}`
   );
-  await fs26.mkdir(cacheDir, { recursive: true });
-  await fs26.mkdir(destDir, { recursive: true });
+  await fs27.mkdir(cacheDir, { recursive: true });
+  await fs27.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 = path26.join(destDir, entry.file);
+    const dest = path27.join(destDir, entry.file);
     if (await hasSize(dest, entry.bytes)) {
       presentCount++;
       continue;
     }
     try {
-      const cached = path26.join(cacheDir, entry.file);
+      const cached = path27.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 fs26.writeFile(cached, buf);
+        await fs27.writeFile(cached, buf);
       }
-      await fs26.copyFile(cached, dest);
+      await fs27.copyFile(cached, dest);
       installedCount++;
       addedBytes += entry.bytes;
-      log.dim(`  ${path26.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
+      log.dim(`  ${path27.join(ANIMS_DEST, entry.file)} (${formatMb(entry.bytes)})`);
     } catch (err) {
       failures.push(`${entry.name} (${err instanceof Error ? err.message : String(err)})`);
     }
@@ -19150,13 +19267,13 @@ async function runAnims(opts) {
     version: manifest.version,
     clips: [...union].sort((a, b) => a.localeCompare(b))
   };
-  await fs26.writeFile(gameManifestPath, JSON.stringify(gameManifest, null, 2) + "\n");
+  await fs27.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 + path26.sep)}${addedBytes > 0 ? ` (+${formatMb(addedBytes)})` : ""}`
+    `${parts.join(", ")} \u2192 ${c.cyan(ANIMS_DEST + path27.sep)}${addedBytes > 0 ? ` (+${formatMb(addedBytes)})` : ""}`
   );
   for (const [selector, entries] of resolved) {
     const names = entries.filter((e) => !coreNames.has(e.name)).map((e) => e.name);
@@ -19188,8 +19305,8 @@ async function loadManifest(baseOverride) {
     }
   } catch {
   }
-  const snapshotPath = path26.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
-  const manifest = JSON.parse(await fs26.readFile(snapshotPath, "utf8"));
+  const snapshotPath = path27.join(getTemplatesDir(), "controllers", "assets", "anims-manifest.json");
+  const manifest = JSON.parse(await fs27.readFile(snapshotPath, "utf8"));
   return { manifest, source: "snapshot" };
 }
 function resolveSelectors(manifest, selectors) {
@@ -19307,21 +19424,21 @@ function printCatalog(log, manifest, selectors) {
 }
 async function readGameManifest(file) {
   try {
-    return JSON.parse(await fs26.readFile(file, "utf8"));
+    return JSON.parse(await fs27.readFile(file, "utf8"));
   } catch {
     return null;
   }
 }
 async function hasSize(file, bytes) {
   try {
-    return (await fs26.stat(file)).size === bytes;
+    return (await fs27.stat(file)).size === bytes;
   } catch {
     return false;
   }
 }
 async function exists3(p) {
   try {
-    await fs26.access(p);
+    await fs27.access(p);
     return true;
   } catch {
     return false;
@@ -19522,8 +19639,8 @@ var CONTROLLER_FILE_SETS = {
     ]
   }
 };
-var CODE_DEST = path27.join("src", "controllers");
-var ASSETS_DEST = path27.join("public", "assets");
+var CODE_DEST = path28.join("src", "controllers");
+var ASSETS_DEST = path28.join("public", "assets");
 async function runController(opts) {
   const log = createLogger({ quiet: opts.quiet });
   if (opts.kind?.trim() === "anims") {
@@ -19540,31 +19657,31 @@ async function runController(opts) {
     process.exitCode = 1;
     return;
   }
-  const srcDir = path27.join(getTemplatesDir(), "controllers");
+  const srcDir = path28.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 + path27.sep)}`);
+  log.step(`Installing the ${kind} controller into ${c.cyan(CODE_DEST + path28.sep)}`);
   const plan = [
-    ...set.code.map((rel) => ({ from: rel, rel: path27.join(CODE_DEST, rel) })),
+    ...set.code.map((rel) => ({ from: rel, rel: path28.join(CODE_DEST, rel) })),
     ...set.assets.map((rel) => ({
       from: rel,
-      rel: path27.join(ASSETS_DEST, path27.basename(rel))
+      rel: path28.join(ASSETS_DEST, path28.basename(rel))
     }))
   ];
   let copied = 0;
   let skipped = 0;
   try {
     for (const file of plan) {
-      const dest = path27.join(root, file.rel);
+      const dest = path28.join(root, file.rel);
       if (!opts.force && await exists4(dest)) {
         skipped++;
         log.dim(`  skipped ${file.rel} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs27.mkdir(path27.dirname(dest), { recursive: true });
-      await fs27.copyFile(path27.join(srcDir, file.from), dest);
+      await fs28.mkdir(path28.dirname(dest), { recursive: true });
+      await fs28.copyFile(path28.join(srcDir, file.from), dest);
       copied++;
       log.dim(`  ${file.rel}`);
     }
@@ -19617,7 +19734,7 @@ async function runController(opts) {
   for (const line of set.sketch) {
     log.dim(`       ${line}`);
   }
-  if (kind === "character" && !await exists4(path27.join(root, ASSETS_DEST, "meshy-character.json"))) {
+  if (kind === "character" && !await exists4(path28.join(root, ASSETS_DEST, "meshy-character.json"))) {
     log.plain("");
     log.plain(
       `  ${stepOffset + 3}. This game has no generated character yet \u2014 ${c.cyan(
@@ -19649,9 +19766,9 @@ async function installMeshyCharacterManifest(args) {
     throw new Error("The API returned an invalid Meshy character manifest.");
   }
   assertCompleteMeshyControllerPack(manifest);
-  const destination = path27.join(args.root, ASSETS_DEST, "meshy-character.json");
-  await fs27.mkdir(path27.dirname(destination), { recursive: true });
-  await fs27.writeFile(
+  const destination = path28.join(args.root, ASSETS_DEST, "meshy-character.json");
+  await fs28.mkdir(path28.dirname(destination), { recursive: true });
+  await fs28.writeFile(
     destination,
     `${JSON.stringify(manifest, null, 2)}
 `
@@ -19796,14 +19913,14 @@ function assertCompleteMeshyControllerPack(manifest) {
 }
 async function installFallbackAvatar(args) {
   const { root, srcDir, log } = args;
-  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);
+  const dest = path28.join(root, ASSETS_DEST, "avatar.vrm");
+  await fs28.mkdir(path28.dirname(dest), { recursive: true });
+  await fs28.copyFile(path28.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 fs27.access(p);
+    await fs28.access(p);
     return true;
   } catch {
     return false;
@@ -19811,8 +19928,8 @@ async function exists4(p) {
 }
 
 // src/commands/character.ts
-import fs28 from "fs/promises";
-import path28 from "path";
+import fs29 from "fs/promises";
+import path29 from "path";
 function exactAnimation(selector) {
   const trimmed = selector.trim();
   if (/^-?\d+$/.test(trimmed)) return animationById(Number(trimmed));
@@ -19892,7 +20009,7 @@ function showAmbiguity(selector, candidates, log, json = false) {
   }
   process.exitCode = 1;
 }
-var INSTALLED_MANIFEST = path28.join("public", "assets", "meshy-character.json");
+var INSTALLED_MANIFEST = path29.join("public", "assets", "meshy-character.json");
 async function resolveAdoptTarget(selector) {
   const trimmed = selector?.trim();
   if (trimmed && !trimmed.endsWith(".json")) {
@@ -19901,7 +20018,7 @@ async function resolveAdoptTarget(selector) {
   const file = trimmed ?? INSTALLED_MANIFEST;
   let raw;
   try {
-    raw = await fs28.readFile(file, "utf8");
+    raw = await fs29.readFile(file, "utf8");
   } catch {
     return {
       ok: false,
@@ -20024,7 +20141,7 @@ async function runCharacterImport(opts) {
     opts,
     ctx,
     kind: "character",
-    prompt: `Import ${path28.basename(filePath)} as a rigged character`,
+    prompt: `Import ${path29.basename(filePath)} as a rigged character`,
     createPath: "/api/characters/import",
     body,
     quote: price,
@@ -20075,23 +20192,6 @@ function requestedBuild(opts, actionIds) {
     ...opts.height === void 0 ? {} : { heightMeters: opts.height }
   };
 }
-async function postWorkflow(url, token, body) {
-  const response = await apiFetch(url, {
-    method: "POST",
-    headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
-    body: JSON.stringify(body)
-  });
-  if (printedStructuredError(response)) return null;
-  if (!response.ok) {
-    const data2 = await response.json().catch(() => ({}));
-    throw new Error(apiErrorMessage2(data2, `Character workflow request failed (HTTP ${response.status}).`));
-  }
-  const data = await response.json();
-  if (typeof data.id !== "string" || data.id.length === 0) {
-    throw new Error("Character workflow request returned no generation id.");
-  }
-  return { id: data.id, kind: data.kind, status: data.status, creditsQuoted: data.creditsQuoted };
-}
 async function runWorkflow(args) {
   const log = createLogger({ quiet: args.opts.quiet || args.opts.json });
   if (await workspaceMode() !== "tools") {
@@ -20103,29 +20203,18 @@ 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, void 0, {
-    credits: created.creditsQuoted ?? args.quotedCredits,
-    ...args.opts.outDir ? { outDir: args.opts.outDir } : {}
+  const created = await enqueueWithAllowance({
+    apiUrl: args.ctx.apiUrl,
+    token: args.ctx.token,
+    kind: args.kind,
+    prompt: args.prompt,
+    body: args.body,
+    createPath: args.createPath,
+    quotedCredits: args.quotedCredits,
+    outDir: args.opts.outDir,
+    log
   });
+  if (!created) return;
   if (args.opts.noWait) {
     const nextCommand = `genex wait ${created.id}${args.opts.json ? " --json" : ""}`;
     if (args.opts.json) {
@@ -20527,22 +20616,22 @@ async function context2(opts) {
   const project = await readProject();
   return { token, apiUrl: getApiUrl(opts.apiUrl ?? project?.apiUrl) };
 }
-async function readVideo(path35, log) {
+async function readVideo(path36, log) {
   let bytes;
   try {
-    bytes = await readFile(path35);
+    bytes = await readFile(path36);
   } catch {
-    log.error(`Can't read ${path35}.`);
+    log.error(`Can't read ${path36}.`);
     return null;
   }
   if (bytes.byteLength > MAX_VIDEO_BYTES) {
-    log.error(`${basename(path35)} is ${(bytes.byteLength / 1e6).toFixed(0)} MB \u2014 the limit is ${MAX_VIDEO_BYTES / 1e6} MB.`);
+    log.error(`${basename(path36)} 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, path35, bytes, log) {
-  const contentType = /\.mov$/i.test(path35) ? "video/quicktime" : "video/mp4";
+async function uploadVideo(apiUrl, token, characterId, path36, bytes, log) {
+  const contentType = /\.mov$/i.test(path36) ? "video/quicktime" : "video/mp4";
   const minted = await apiFetch(
     `${apiUrl}/api/characters/${encodeURIComponent(characterId)}/motions/video-url`,
     {
@@ -20557,7 +20646,7 @@ async function uploadVideo(apiUrl, token, characterId, path35, bytes, log) {
     return null;
   }
   const { uploadUrl, videoUrl } = await minted.json();
-  log.dim(`  uploading ${basename(path35)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
+  log.dim(`  uploading ${basename(path36)} (${(bytes.byteLength / 1e6).toFixed(1)} MB)\u2026`);
   const put = await fetch(uploadUrl, {
     method: "PUT",
     headers: { "Content-Type": contentType, "Content-Length": String(bytes.byteLength) },
@@ -20889,8 +20978,8 @@ function rank(items, query) {
 }
 
 // src/commands/motion.ts
-import fs29 from "fs/promises";
-import path29 from "path";
+import fs30 from "fs/promises";
+import path30 from "path";
 
 // src/lib/motion/npz.ts
 import zlib from "zlib";
@@ -22141,7 +22230,7 @@ async function motionGen(opts, log) {
   }
   if (opts.constraintsPath !== void 0) {
     try {
-      const raw = await fs29.readFile(opts.constraintsPath, "utf8");
+      const raw = await fs30.readFile(opts.constraintsPath, "utf8");
       generationOptions.constraints = JSON.parse(raw);
     } catch {
       log.error(`Couldn't read the --constraints JSON at ${opts.constraintsPath}.`);
@@ -22165,10 +22254,10 @@ async function motionGen(opts, log) {
 async function expandTakes(selectors) {
   const out = [];
   for (const sel of selectors) {
-    const st = await fs29.stat(sel).catch(() => null);
+    const st = await fs30.stat(sel).catch(() => null);
     if (st?.isDirectory()) {
-      const names = await fs29.readdir(sel);
-      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path29.join(sel, n));
+      const names = await fs30.readdir(sel);
+      for (const n of names.sort()) if (n.endsWith(".npz")) out.push(path30.join(sel, n));
     } else if (st?.isFile()) {
       out.push(sel);
     } else {
@@ -22203,7 +22292,7 @@ async function motionVerify(opts, log) {
   let gates = DEFAULT_GATES;
   if (opts.gatesPath) {
     try {
-      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs29.readFile(opts.gatesPath, "utf8")));
+      gates = mergeGates(DEFAULT_GATES, JSON.parse(await fs30.readFile(opts.gatesPath, "utf8")));
     } catch {
       log.error(`Couldn't read the --gates JSON at ${opts.gatesPath}.`);
       process.exitCode = 1;
@@ -22225,9 +22314,9 @@ async function motionVerify(opts, log) {
   }
   const reports = [];
   for (const file of files) {
-    const stem = path29.basename(file).replace(/\.npz$/, "");
+    const stem = path30.basename(file).replace(/\.npz$/, "");
     try {
-      reports.push(analyzeTake(stem, await fs29.readFile(file), gates));
+      reports.push(analyzeTake(stem, await fs30.readFile(file), gates));
     } catch (err) {
       reports.push({
         take: stem,
@@ -22265,7 +22354,7 @@ async function motionCompile(opts, log) {
   let cfg = DEFAULT_MOTION_CONFIG;
   if (opts.configPath) {
     try {
-      const patch = JSON.parse(await fs29.readFile(opts.configPath, "utf8"));
+      const patch = JSON.parse(await fs30.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}.`);
@@ -22283,16 +22372,16 @@ async function motionCompile(opts, log) {
   }
   const inputs = [];
   for (const file of files) {
-    const stem = path29.basename(file).replace(/\.npz$/, "");
+    const stem = path30.basename(file).replace(/\.npz$/, "");
     try {
-      inputs.push({ stem, take: loadTake(await fs29.readFile(file)) });
+      inputs.push({ stem, take: loadTake(await fs30.readFile(file)) });
     } catch (err) {
       log.error(`${stem}: ${err instanceof Error ? err.message : String(err)}`);
       process.exitCode = 1;
       return;
     }
   }
-  const setName = opts.set ?? path29.basename(opts.out).replace(/\.json$/, "");
+  const setName = opts.set ?? path30.basename(opts.out).replace(/\.json$/, "");
   let result;
   try {
     result = compileSet(inputs, setName, cfg);
@@ -22307,9 +22396,9 @@ async function motionCompile(opts, log) {
     process.exitCode = 1;
     return;
   }
-  await fs29.mkdir(path29.dirname(path29.resolve(opts.out)), { recursive: true });
+  await fs30.mkdir(path30.dirname(path30.resolve(opts.out)), { recursive: true });
   const json = JSON.stringify(result.data);
-  await fs29.writeFile(opts.out, json);
+  await fs30.writeFile(opts.out, json);
   if (opts.json) {
     writeJson({ out: opts.out, set: setName, tracks: Object.keys(result.data.gaits), bytes: json.length });
     return;
@@ -22327,9 +22416,9 @@ var MOTION_RUNTIME_FILES = [
 var MOTION_PRESETS = {
   rifle: ["sets/rifle.json", "sets/jumps.json"]
 };
-var MOTION_DEST = path29.join("src", "motion");
+var MOTION_DEST = path30.join("src", "motion");
 async function motionInstall(opts, log) {
-  const srcDir = path29.join(getTemplatesDir(), "motion");
+  const srcDir = path30.join(getTemplatesDir(), "motion");
   const root = opts.cwd ?? process.cwd();
   const preset = opts.set;
   if (preset !== void 0 && !MOTION_PRESETS[preset]) {
@@ -22340,21 +22429,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 + path29.sep)}`);
+  log.step(`Vendoring the motion runtime into ${c.cyan(MOTION_DEST + path30.sep)}`);
   let copied = 0, skipped = 0;
   try {
     for (const rel of files) {
-      const dest = path29.join(root, MOTION_DEST, rel);
-      const exists5 = await fs29.access(dest).then(() => true, () => false);
+      const dest = path30.join(root, MOTION_DEST, rel);
+      const exists5 = await fs30.access(dest).then(() => true, () => false);
       if (!opts.force && exists5) {
         skipped++;
-        log.dim(`  skipped ${path29.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
+        log.dim(`  skipped ${path30.join(MOTION_DEST, rel)} (exists \u2014 use --force to overwrite)`);
         continue;
       }
-      await fs29.mkdir(path29.dirname(dest), { recursive: true });
-      await fs29.copyFile(path29.join(srcDir, rel), dest);
+      await fs30.mkdir(path30.dirname(dest), { recursive: true });
+      await fs30.copyFile(path30.join(srcDir, rel), dest);
       copied++;
-      log.dim(`  ${path29.join(MOTION_DEST, rel)}`);
+      log.dim(`  ${path30.join(MOTION_DEST, rel)}`);
     }
   } catch (err) {
     log.error(`Copy failed: ${String(err)}`);
@@ -22395,7 +22484,7 @@ async function motionConstraints(opts, log) {
   }
   const doc = directionConstraint(dir, speed, duration);
   const out = opts.out ?? "constraints.json";
-  await fs29.writeFile(out, JSON.stringify(doc));
+  await fs30.writeFile(out, JSON.stringify(doc));
   if (opts.json) {
     writeJson({ out, dir: dirName, speed, duration, waypoints: doc[0].frame_indices.length });
     return;
@@ -22432,14 +22521,14 @@ async function runMotion(opts) {
 }
 
 // src/commands/blender.ts
-import fs30 from "fs/promises";
-import path30 from "path";
+import fs31 from "fs/promises";
+import path31 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 fs30.mkdir(dir, { recursive: true });
-  const p = path30.join(dir, name);
-  await fs30.writeFile(p, Buffer.from(b64, "base64"));
+  await fs31.mkdir(dir, { recursive: true });
+  const p = path31.join(dir, name);
+  await fs31.writeFile(p, Buffer.from(b64, "base64"));
   return p;
 }
 function reportScene(log, s) {
@@ -22523,7 +22612,7 @@ async function runBlender(opts) {
     log.plain(rest.join("\n"));
     return 1;
   }
-  const outDir = path30.resolve(opts.outDir ?? DEFAULT_OUT_DIR);
+  const outDir = path31.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(", ")}.`);
@@ -22563,14 +22652,14 @@ async function runBlender(opts) {
       return 0;
     }
     case "export": {
-      const target = opts.out ?? path30.join(outDir, "scene.glb");
+      const target = opts.out ?? path31.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 fs30.mkdir(path30.dirname(target), { recursive: true });
-      await fs30.writeFile(target, Buffer.from(r.glbBase64, "base64"));
+      await fs31.mkdir(path31.dirname(target), { recursive: true });
+      await fs31.writeFile(target, Buffer.from(r.glbBase64, "base64"));
       log.success(`Exported ${r.bytes ?? 0} bytes`);
       log.plain(`  ${c.cyan(target)}`);
       return 0;
@@ -22603,12 +22692,12 @@ async function runBlender(opts) {
           return 1;
         }
         try {
-          script = await fs30.readFile(opts.input, "utf8");
+          script = await fs31.readFile(opts.input, "utf8");
         } catch {
           log.error(`Can't read ${opts.input}`);
           return 1;
         }
-        label = path30.basename(opts.input);
+        label = path31.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());
@@ -22727,9 +22816,9 @@ print(f"castle: {n} objects")
 `;
 
 // src/commands/asset-new.ts
-import fs31 from "fs";
+import fs32 from "fs";
 import fsp from "fs/promises";
-import path31 from "path";
+import path32 from "path";
 import { pathToFileURL } from "url";
 var EXTRA_FILES = [
   "genex-asset.example.json",
@@ -22823,7 +22912,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 ? path31.resolve(options.dir) : process.cwd();
+  const cwd = options.dir ? path32.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>]');
@@ -22833,14 +22922,14 @@ async function runAssetNew(options) {
     log.error(`The slug must be kebab-case (letters, digits, dashes), got: ${slug}`);
     return 1;
   }
-  const templateDir = path31.join(getTemplatesDir(), "asset-viewer");
-  if (!fs31.existsSync(templateDir)) {
+  const templateDir = path32.join(getTemplatesDir(), "asset-viewer");
+  if (!fs32.existsSync(templateDir)) {
     log.error(`Vendored asset-viewer template not found at ${templateDir} \u2014 reinstall the CLI.`);
     return 1;
   }
-  const manifestTools = await import(pathToFileURL(path31.join(templateDir, "tools", "emit-manifest.mjs")).href);
+  const manifestTools = await import(pathToFileURL(path32.join(templateDir, "tools", "emit-manifest.mjs")).href);
   const { SHARED_FILES, PARITY_FILENAME, hashSharedFiles, pascalCase } = manifestTools;
-  const lockPath = path31.join(templateDir, "shared-files.sha256.json");
+  const lockPath = path32.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]);
@@ -22853,8 +22942,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 = path31.resolve(cwd, options.out ?? slug);
-  if (fs31.existsSync(outDir) && fs31.readdirSync(outDir).length > 0 && !options.force) {
+  const outDir = path32.resolve(cwd, options.out ?? slug);
+  if (fs32.existsSync(outDir) && fs32.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;
   }
@@ -22882,24 +22971,24 @@ async function runAssetNew(options) {
   };
   await fsp.mkdir(outDir, { recursive: true });
   for (const rel of [...SHARED_FILES, ...EXTRA_FILES]) {
-    const to = path31.join(outDir, rel);
-    await fsp.mkdir(path31.dirname(to), { recursive: true });
-    await fsp.copyFile(path31.join(templateDir, rel), to);
+    const to = path32.join(outDir, rel);
+    await fsp.mkdir(path32.dirname(to), { recursive: true });
+    await fsp.copyFile(path32.join(templateDir, rel), to);
   }
-  const pkg = fillTemplate(await fsp.readFile(path31.join(templateDir, "package.json"), "utf8"), {
+  const pkg = fillTemplate(await fsp.readFile(path32.join(templateDir, "package.json"), "utf8"), {
     slug,
     name,
     version
   });
-  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(path32.join(outDir, "package.json"), pkg, "utf8");
+  await fsp.writeFile(path32.join(outDir, "asset.config.json"), JSON.stringify(config, null, 2) + "\n", "utf8");
+  await fsp.writeFile(path32.join(outDir, ".gitignore"), GITIGNORE, "utf8");
   await fsp.writeFile(
-    path31.join(outDir, "DESIGN.md"),
+    path32.join(outDir, "DESIGN.md"),
     designDoc({ name, slug, sizeMeters, triBand, holder }),
     "utf8"
   );
-  const placeholder = await fsp.readFile(path31.join(templateDir, "src", "asset", "PLACEHOLDER.ts"), "utf8");
+  const placeholder = await fsp.readFile(path32.join(templateDir, "src", "asset", "PLACEHOLDER.ts"), "utf8");
   const seeded = seedAssetSource(placeholder, {
     slug,
     name,
@@ -22910,8 +22999,8 @@ async function runAssetNew(options) {
     pascalCase
   });
   const assetFilename = `${slug.replace(/-([a-z0-9])/g, (_, ch) => ch.toUpperCase())}.ts`;
-  await fsp.mkdir(path31.join(outDir, "src", "asset"), { recursive: true });
-  await fsp.writeFile(path31.join(outDir, "src", "asset", assetFilename), seeded, "utf8");
+  await fsp.mkdir(path32.join(outDir, "src", "asset"), { recursive: true });
+  await fsp.writeFile(path32.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) {
@@ -22919,7 +23008,7 @@ async function runAssetNew(options) {
     return 1;
   }
   await fsp.writeFile(
-    path31.join(outDir, PARITY_FILENAME),
+    path32.join(outDir, PARITY_FILENAME),
     JSON.stringify(
       {
         note: "Recorded by `genex asset new`. Gate G13 recomputes these; do not hand-edit the viewer.",
@@ -22963,10 +23052,10 @@ async function runAssetNew(options) {
 }
 
 // src/commands/tools.ts
-import path33 from "path";
+import path34 from "path";
 
 // src/commands/doctor.ts
-import path32 from "path";
+import path33 from "path";
 var LANE_ORDER = [
   "model",
   "image",
@@ -23247,7 +23336,7 @@ async function fetchLegalStatus(apiUrl, token) {
 }
 async function firstSkillsMarker() {
   for (const target of resolveAgentTargets()) {
-    const marker = await readSkillsMarker(path32.join(target.baseDir, "skills"));
+    const marker = await readSkillsMarker(path33.join(target.baseDir, "skills"));
     if (marker) return marker;
   }
   return null;
@@ -23298,8 +23387,8 @@ async function runTools(opts) {
   let totalNew = 0;
   let totalUpdated = 0;
   for (const t of targets) {
-    const dest = path33.join(t.baseDir, "skills");
-    const { copied, updated } = await copyTemplates(path33.join(templatesDir, "skills"), dest, {
+    const dest = path34.join(t.baseDir, "skills");
+    const { copied, updated } = await copyTemplates(path34.join(templatesDir, "skills"), dest, {
       filter: (rel) => skillFamilyFilter("tools")(`skills/${rel}`)
     });
     await pruneRemovedSkills(dest, log);
@@ -23358,8 +23447,8 @@ async function runTools(opts) {
 }
 
 // src/commands/budget.ts
-import fs32 from "fs/promises";
-import path34 from "path";
+import fs33 from "fs/promises";
+import path35 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) {
@@ -23367,7 +23456,7 @@ function internalKind(kind) {
 }
 async function isGenexProject(cwd) {
   try {
-    await fs32.access(path34.join(cwd, ".genex"));
+    await fs33.access(path35.join(cwd, ".genex"));
     return true;
   } catch {
     return false;