@genex-ai/cli-demo 1.36.5 → 1.36.6-dev.862

package/dist/index.js

@@ -57,7 +57,7 @@ import {
   writeSecretFile,
   writeUserToken,
   writeWorkspace
-} from "./chunk-4BBTPRJW.js";
+} from "./chunk-EABIVAGT.js";
 import {
   CLI_CHANNEL,
   DEFAULT_API_URL,
@@ -78,7 +78,7 @@ import {
   normalizeApiOrigin,
   originKey,
   resolveAgentTargets
-} from "./chunk-QI7FIYBY.js";
+} from "./chunk-K4EHXOZK.js";
 
 // src/instrument.ts
 import * as Sentry from "@sentry/node";
@@ -981,7 +981,7 @@ Important note: put soul into your creations, with many details and love. Aim to
 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\`. 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). One file in \`.genex/scratch/\` IS read, by the platform: \`.genex/scratch/cover.png\` is the game's cover \u2014 the frame you would put on its poster: real gameplay at its signature moment, well lit, no menus, popups or busy HUD, landscape 16:9, and never any text (the page sets the title beside it). The next \`genex preview\` makes it the cover; save a better moment over it whenever one comes along, and if your browser tool can set the cover itself, use that instead. Before the first publish, and whenever the game's look changes, load \`$genex-cover\`: it chooses, stages, lights and judges that frame.
-24. **Benchmark before declaring an in-game LLM price.** If the game calls a language model while the player plays \u2014 an NPC answering in its own words, a quest written for this save, a judge reading what the player typed \u2014 the PLAYER pays for it, and \`estimateCoins\` is the FIXED price of a started attempt: charged whether it succeeds, fails, is canceled, or stops at its own budget. Never pick that number by judgement or from a vendor's rate card. Run the real prompt on your own coins \u2014 \`npx genex llm bench "<the prompt>" --schema <file> --samples 3 --max-coins <n> --user-approved\` \u2014 and declare the figure it recommends, recorded in \`DESIGN.md\` with its model and date; re-benchmark whenever the prompt, the schema or the model changes, because a prompt edit is a price change. Check the lane first with \`npx genex llm models\`: where it is off the routes 404, so build the feature behind a graceful unavailable state and say so in the handoff. A repeated call is a standing budget the player approves once (\`requestSpendGrant()\`, then \`generate({ grantId })\`), never a popup per turn, and its disclosed call rate is computed from the game's own loop. Model output is data the game validates against its own expectation \u2014 never executed, and never authority over coin, items, entitlements or rewards. Load \`$genex-llm-in-games\` before writing any of it.
+24. **Benchmark before declaring an in-game LLM ceiling.** If the game calls a language model while the player plays \u2014 an NPC answering in its own words, a quest written for this save, a judge reading what the player typed \u2014 the PLAYER pays for it from their Genex credits, billed as used, and the game declares no price, only a per-call CEILING: \`maxCredits\` on \`generate()\`, \`perCallMaxCredits\` on a standing budget. That ceiling bounds what one call may cost AND funds how long its answer may be, so never pick it by judgement or from a vendor's rate card. Run the real prompt on your own credits \u2014 \`npx genex llm bench "<the prompt>" --schema <file> --samples 3 --max-credits <n> --user-approved\` \u2014 and declare the figures it prints, recorded in \`DESIGN.md\` with its model and date; re-benchmark whenever the prompt, the schema or the model changes, because a prompt edit changes the ceiling. Check the lane first with \`npx genex llm models\`: where it is off the routes 404, so build the feature behind a graceful unavailable state and say so in the handoff. A repeated call is a standing budget the player approves once (\`requestSpendGrant()\`, then \`generate({ grantId })\`), never a popup per turn, and its disclosed call rate and credits per period are computed from the game's own loop and the bench's measured average. The coin spellings (\`estimateCoins\`, \`perCallMaxCoins\`) are deprecated \u2014 write the credit names. Model output is data the game validates against its own expectation \u2014 never executed, and never authority over coin, credits, items, entitlements or rewards. Load \`$genex-llm-in-games\` before writing any of it.
 ${CONTRACT_END}
 `;
 var TOOLS_CONTRACT_HEAD = `# Genex Tools (always in effect in this folder)
@@ -995,7 +995,7 @@ var TOOLS_CONTRACT_OFFER = `5. **When the game is built and playable \u2014 neve
 var TOOLS_CONTRACT_HOSTED_LAWS = `5. **This game is hosted on Genex now, and publishing is glue \u2014 never a rebuild.** The game ships exactly as the user built it: \`initEmbed()\` first in the boot code (the \`genex-threejs-embed-auth\` card has the call; the renderer draws before any \`await waitForPlayer()\`), a static build into \`dist/\` with relative asset paths, then \`npx genex preview\`. Never restructure, reformat or "improve" the game to ship it, never scaffold a new app around it, and never start a design document or a build plan for it \u2014 the user's own process is theirs. Load the \`genex-tool-publish\` card before the first preview; it owns the vocabulary, the links and the limits.
 6. **Ship first, then report.** \`preview\` prints a preflight \u2014 phone memory, a missing volume slider, an asset nobody wired, a viewport line. It never blocks a deploy, so push the build as it is, hand over the link, THEN relay each preflight line to the user in one plain sentence with an offer to fix it, and fix one only on their yes. The preflight is a report for the user, not a to-do list for you.
 7. **The link is the game's page, and there are two versions.** After every preview give the user \`<dashboard>/draft/<slug>\` \u2014 \`dashboardOrigins[0]\` and \`slug\` from \`.genex/project.json\` \u2014 never localhost, a file path or the bare play origin. \`preview\` updates the draft and never touches what players are on; the first release is \`npx genex publish\` (it lists the game); after that "publish it", "update it" and "yes" all mean \`npx genex promote\` \u2014 the exact draft build, no rebuild. Ask once per round of work, in one line, and keep working while you wait.`;
-var TOOLS_CONTRACT_LLM_OFFER = `A model running while people play is built into the Genex platform \u2014 the player pays, with Genex coins or their own Claude/ChatGPT subscription, and approves it on a Genex sheet; your game just calls \`generate()\`. Want it that way?`;
+var TOOLS_CONTRACT_LLM_OFFER = `A model running while people play is built into the Genex platform \u2014 the player pays, with their Genex credits or their own Claude/ChatGPT subscription, and approves it on a Genex sheet; your game just calls \`generate()\`. Want it that way?`;
 function toolsContractLlmLaw(n, hosted) {
   const onYes = hosted ? "On a yes, load `$genex-tool-llm` and then `$genex-llm-in-games`, which owns the build." : "On a yes, load `$genex-tool-llm`, which owns the rest: it checks the lane with `npx genex llm models` first, then runs `npx genex init --convert` (a hosted game is a static browser build \u2014 a local server holding a key can never ship).";
   return `${n}. **A model running while people PLAY is a platform feature \u2014 never something you wire onto the user's own meter.** When a request implies one (NPCs that talk or decide in their own words, content written from what the player types, a prompt box in the game, "let the player pick a model"), recognise it, say in ONE line: "${TOOLS_CONTRACT_LLM_OFFER}" \u2014 then ASK and wait. ${onYes} On a no, build the authored version instead. Either way, never ship a game that calls a model on a key or an account of the user's own: every visitor would spend their money with nobody approving it, and the credential is readable in the bundle. Player-funded generation is text and JSON only \u2014 3D, images, video and audio stay the asset lanes above, on the user's meter.`;
@@ -2149,6 +2149,401 @@ async function countOutcomes(kind, cwd = process.cwd()) {
 import fs13 from "fs/promises";
 import path14 from "path";
 
+// ../../packages/mobile-scan/src/image-dims.ts
+function u32be(b, o) {
+  return (b[o] << 24 | b[o + 1] << 16 | b[o + 2] << 8 | b[o + 3]) >>> 0;
+}
+function u32le(b, o) {
+  return (b[o] | b[o + 1] << 8 | b[o + 2] << 16 | b[o + 3] << 24) >>> 0;
+}
+function u16be(b, o) {
+  return b[o] << 8 | b[o + 1];
+}
+function u16le(b, o) {
+  return b[o] | b[o + 1] << 8;
+}
+function isPng(b) {
+  return b.length > 24 && b[0] === 137 && b[1] === 80 && b[2] === 78 && b[3] === 71 && b[4] === 13 && b[5] === 10 && b[6] === 26 && b[7] === 10;
+}
+var KTX2_MAGIC = [171, 75, 84, 88, 32, 50, 48, 187, 13, 10, 26, 10];
+function parseImageDims(bytes) {
+  if (bytes.length < 30) return null;
+  if (isPng(bytes)) {
+    return { width: u32be(bytes, 16), height: u32be(bytes, 20) };
+  }
+  if (bytes[0] === 255 && bytes[1] === 216) {
+    let i = 2;
+    while (i + 9 < bytes.length) {
+      if (bytes[i] !== 255) {
+        i++;
+        continue;
+      }
+      const marker = bytes[i + 1];
+      if (marker === 255) {
+        i++;
+        continue;
+      }
+      if (marker === 216 || marker >= 208 && marker <= 217) {
+        i += 2;
+        continue;
+      }
+      const isSof = marker >= 192 && marker <= 195 || marker >= 197 && marker <= 199 || marker >= 201 && marker <= 203 || marker >= 205 && marker <= 207;
+      if (isSof) {
+        return { width: u16be(bytes, i + 7), height: u16be(bytes, i + 5) };
+      }
+      i += 2 + u16be(bytes, i + 2);
+    }
+    return null;
+  }
+  if (bytes[0] === 82 && // RIFF….WEBP
+  bytes[1] === 73 && bytes[2] === 70 && bytes[3] === 70 && bytes[8] === 87 && bytes[9] === 69 && bytes[10] === 66 && bytes[11] === 80) {
+    const fourcc = String.fromCharCode(bytes[12], bytes[13], bytes[14], bytes[15]);
+    if (fourcc === "VP8X" && bytes.length >= 30) {
+      const w = 1 + (bytes[24] | bytes[25] << 8 | bytes[26] << 16);
+      const h = 1 + (bytes[27] | bytes[28] << 8 | bytes[29] << 16);
+      return { width: w, height: h };
+    }
+    if (fourcc === "VP8 " && bytes.length >= 30) {
+      return { width: u16le(bytes, 26) & 16383, height: u16le(bytes, 28) & 16383 };
+    }
+    if (fourcc === "VP8L" && bytes.length >= 25 && bytes[20] === 47) {
+      const b0 = bytes[21];
+      const b1 = bytes[22];
+      const b2 = bytes[23];
+      const b3 = bytes[24];
+      const width = 1 + ((b1 & 63) << 8 | b0);
+      const height = 1 + ((b3 & 15) << 10 | b2 << 2 | (b1 & 192) >> 6);
+      return { width, height };
+    }
+    return null;
+  }
+  if (KTX2_MAGIC.every((v, idx) => bytes[idx] === v)) {
+    return { width: u32le(bytes, 20), height: u32le(bytes, 24), ktx2: true };
+  }
+  return null;
+}
+
+// ../../packages/mobile-scan/src/glb.ts
+function u32le2(b, o) {
+  return (b[o] | b[o + 1] << 8 | b[o + 2] << 16 | b[o + 3] << 24) >>> 0;
+}
+function scanGlb(bytes) {
+  if (bytes.length < 20 || u32le2(bytes, 0) !== 1179937895) return null;
+  try {
+    const jsonLen = u32le2(bytes, 12);
+    if (u32le2(bytes, 16) !== 1313821514) return null;
+    const json = JSON.parse(new TextDecoder().decode(bytes.subarray(20, 20 + jsonLen)));
+    let bin = null;
+    const binHeader = 20 + jsonLen;
+    if (binHeader + 8 <= bytes.length && u32le2(bytes, binHeader + 4) === 5130562) {
+      bin = bytes.subarray(binHeader + 8, binHeader + 8 + u32le2(bytes, binHeader));
+    }
+    const images = [];
+    for (const img of json.images ?? []) {
+      if (img.bufferView == null || !bin) continue;
+      const view = json.bufferViews?.[img.bufferView];
+      if (!view?.byteLength) continue;
+      const slice = bin.subarray(view.byteOffset ?? 0, (view.byteOffset ?? 0) + view.byteLength);
+      const dims = parseImageDims(slice);
+      if (dims) images.push({ ...dims, mimeType: img.mimeType, bytes: view.byteLength });
+    }
+    let triangles = 0;
+    for (const mesh of json.meshes ?? []) {
+      for (const prim of mesh.primitives ?? []) {
+        const accessor = prim.indices != null ? json.accessors?.[prim.indices] : json.accessors?.[prim.attributes?.POSITION ?? -1];
+        if (accessor?.count) triangles += Math.floor(accessor.count / 3);
+      }
+    }
+    return {
+      triangles,
+      binBytes: bin?.byteLength ?? 0,
+      images,
+      extensions: json.extensionsUsed ?? []
+    };
+  } catch {
+    return null;
+  }
+}
+
+// ../../packages/mobile-scan/src/scan.ts
+var GENEX_GENERATION_URL_RE = /https:\/\/[A-Za-z0-9.-]+\/generations\/([A-Za-z0-9._-]+)\/([A-Za-z0-9._@-]+)/g;
+var SKYBOX_ROLE = "skybox-equirect";
+var MOBILE_RUNG_SUFFIX_RE = /@(\d+)$/;
+var MOBILE_BUDGET_MB = { broad: 300, modern: 700 };
+var KNOWN_CAPABILITIES = ["microphone", "camera", "geolocation"];
+var CAPABILITY_LITERALS = {
+  microphone: ["__GENEX_VOICE__", "__GENEX_CAP_MICROPHONE__"],
+  camera: ["__GENEX_CAP_CAMERA__"],
+  geolocation: ["__GENEX_CAP_GEOLOCATION__"]
+};
+var CONSTRAINTS_MAX_CHARS = 4e3;
+var MEDIA_CALL = "getUserMedia";
+var KEY_START = /[A-Za-z_$]/;
+var KEY_PART = /[\w$]/;
+var SPACE = /\s/;
+function mediaRequestsInText(text) {
+  const out = [];
+  let from = 0;
+  for (let at = text.indexOf(MEDIA_CALL); at !== -1; at = text.indexOf(MEDIA_CALL, from)) {
+    from = at + MEDIA_CALL.length;
+    if (at > 0 && KEY_PART.test(text[at - 1])) continue;
+    const paren = skipSpace(text, from, text.length);
+    if (text[paren] !== "(") continue;
+    const open = skipSpace(text, paren + 1, text.length);
+    if (text[open] !== "{") {
+      out.push({ index: at, audio: false, video: false, read: false });
+      continue;
+    }
+    const { stop: stop2, ...constraints } = readConstraints(text, open);
+    out.push({ index: at, ...constraints });
+    from = Math.max(from, stop2);
+  }
+  return out;
+}
+function skipSpace(text, from, end) {
+  let at = from;
+  while (at < end && SPACE.test(text[at])) at++;
+  return at;
+}
+function indexWithin(text, needle, from, end) {
+  for (let at = from; at + needle.length <= end; at++) {
+    if (text.startsWith(needle, at)) return at;
+  }
+  return -1;
+}
+function readConstraints(text, open) {
+  const end = Math.min(text.length, open + 1 + CONSTRAINTS_MAX_CHARS);
+  const seen = { audio: false, video: false, read: true };
+  const afterKey = (key, at) => {
+    const colon = skipSpace(text, at, end);
+    if (text[colon] !== ":") {
+      seen.read = false;
+      return;
+    }
+    if (key !== "audio" && key !== "video") return;
+    const value = skipSpace(text, colon + 1, end);
+    if (text[value] === "{" || text.startsWith("!0", value) || /^true\b/.test(text.slice(value, value + 5))) {
+      seen[key] = true;
+    } else if (!text.startsWith("!1", value) && !/^false\b/.test(text.slice(value, value + 6))) {
+      seen.read = false;
+    }
+  };
+  let depth = 1;
+  let keyNext = true;
+  for (let i = open + 1; i < end; i++) {
+    const ch = text[i];
+    if (ch === '"' || ch === "'" || ch === "`") {
+      let close = i + 1;
+      while (close < end && text[close] !== ch) close += text[close] === "\\" ? 2 : 1;
+      if (close >= end) break;
+      if (depth === 1 && keyNext) {
+        keyNext = false;
+        afterKey(text.slice(i + 1, close), close + 1);
+      }
+      i = close;
+    } else if (ch === "/" && (text[i + 1] === "/" || text[i + 1] === "*")) {
+      const line = text[i + 1] === "/";
+      const close = indexWithin(text, line ? "\n" : "*/", i + 2, end);
+      if (close === -1) break;
+      i = line ? close : close + 1;
+    } else if (ch === "{" || ch === "[" || ch === "(") {
+      depth++;
+    } else if (ch === "}" || ch === "]" || ch === ")") {
+      if (--depth === 0) return { ...seen, stop: i + 1 };
+    } else if (depth === 1 && ch === ",") {
+      keyNext = true;
+    } else if (depth === 1 && keyNext && !SPACE.test(ch)) {
+      keyNext = false;
+      if (!KEY_START.test(ch)) {
+        seen.read = false;
+        continue;
+      }
+      let stop2 = i + 1;
+      while (stop2 < end && KEY_PART.test(text[stop2])) stop2++;
+      afterKey(text.slice(i, stop2), stop2);
+      i = stop2 - 1;
+    }
+  }
+  return { ...seen, read: false, stop: end };
+}
+var CAPABILITY_PATTERNS = {
+  camera: [/\bfacingMode\b/],
+  geolocation: [
+    /\bnavigator\??\.geolocation\b/,
+    /\.geolocation\??\.(?:getCurrentPosition|watchPosition)\b/
+  ]
+};
+function capabilitiesInText(text) {
+  const opensCamera = mediaRequestsInText(text).some((request) => request.video);
+  return KNOWN_CAPABILITIES.filter(
+    (capability) => CAPABILITY_LITERALS[capability].some((literal) => text.includes(literal)) || (CAPABILITY_PATTERNS[capability] ?? []).some((pattern) => pattern.test(text)) || capability === "camera" && opensCamera
+  );
+}
+function knownCapabilities(input) {
+  if (!Array.isArray(input)) return [];
+  return KNOWN_CAPABILITIES.filter((capability) => input.includes(capability));
+}
+var TEXT_EXT = /\.(js|mjs|cjs|html|css|json|txt)$/i;
+var CAPABILITY_FILE_RE = /\.(js|mjs|cjs|html)$/i;
+var TEXT_HEAD_BYTES = 8 * 1024 * 1024;
+var CAPABILITY_WINDOW_BYTES = TEXT_HEAD_BYTES;
+var CAPABILITY_OVERLAP_BYTES = 64 * 1024;
+var IMAGE_EXT = /\.(png|jpe?g|webp|ktx2)$/i;
+var VIDEO_EXT = /\.(mp4|webm|mov)$/i;
+var AUDIO_EXT = /\.(mp3|ogg|wav|m4a)$/i;
+var GLB_EXT = /\.(glb|gltf)$/i;
+function scanBundle(files) {
+  const images = [];
+  const glbs = [];
+  const videos = [];
+  const audio = [];
+  const urls = /* @__PURE__ */ new Set();
+  const declared = /* @__PURE__ */ new Set();
+  let capabilitiesIncomplete = false;
+  const decoder = new TextDecoder();
+  let text = "";
+  let totalBytes = 0;
+  for (const f of files) {
+    totalBytes += f.bytes.byteLength;
+    if (IMAGE_EXT.test(f.relPath)) {
+      const dims = parseImageDims(f.bytes);
+      if (dims) images.push({ path: f.relPath, bytes: f.bytes.byteLength, ...dims });
+      continue;
+    }
+    if (GLB_EXT.test(f.relPath)) {
+      glbs.push({ path: f.relPath, bytes: f.bytes.byteLength, scan: scanGlb(f.bytes) });
+      continue;
+    }
+    if (VIDEO_EXT.test(f.relPath)) {
+      videos.push({ path: f.relPath, bytes: f.bytes.byteLength });
+      continue;
+    }
+    if (AUDIO_EXT.test(f.relPath)) {
+      audio.push({ path: f.relPath, bytes: f.bytes.byteLength });
+      continue;
+    }
+    if (TEXT_EXT.test(f.relPath)) {
+      const head = decoder.decode(f.bytes.subarray(0, TEXT_HEAD_BYTES));
+      text += head;
+      text += "\n";
+      if (!CAPABILITY_FILE_RE.test(f.relPath)) continue;
+      try {
+        for (const capability of capabilitiesInText(head)) declared.add(capability);
+        for (let start = CAPABILITY_WINDOW_BYTES - CAPABILITY_OVERLAP_BYTES; start < f.bytes.byteLength - CAPABILITY_OVERLAP_BYTES && declared.size < KNOWN_CAPABILITIES.length; start += CAPABILITY_WINDOW_BYTES) {
+          const window = f.bytes.subarray(start, start + CAPABILITY_WINDOW_BYTES + CAPABILITY_OVERLAP_BYTES);
+          for (const capability of capabilitiesInText(decoder.decode(window))) declared.add(capability);
+        }
+      } catch {
+        capabilitiesIncomplete = true;
+      }
+    }
+  }
+  for (const m of text.matchAll(GENEX_GENERATION_URL_RE)) urls.add(m[0]);
+  const capabilities = KNOWN_CAPABILITIES.filter((capability) => declared.has(capability));
+  const dprMatch = text.match(/setPixelRatio\(\s*Math\.min\([^,)]+,\s*([\d.]+)\s*\)/);
+  const markers = {
+    rendererBackend: text.includes("WebGPURenderer") || text.includes("getContext('webgpu')") || text.includes('"webgpu"') ? "webgpu" : "webgl",
+    postStack: /EffectComposer|postprocessing|PostProcessing|RenderPipeline/.test(text),
+    dprCapLiteral: dprMatch?.[1] ? Number(dprMatch[1]) : null,
+    contextLossHandler: text.includes("webglcontextlost") || text.includes("device.lost"),
+    ktx2Loader: text.includes("KTX2Loader") || text.includes(".ktx2"),
+    touchHints: /joystick/i.test(text) || text.includes("touchstart") && text.includes("touch-action"),
+    adaptiveQuality: text.includes("__GENEX_QUALITY__"),
+    modelRungs: text.includes("__GENEX_MODEL_RUNGS__"),
+    voice: capabilities.includes("microphone")
+  };
+  return {
+    images,
+    glbs,
+    videos,
+    audio,
+    genexAssetUrls: [...urls],
+    markers,
+    capabilities,
+    capabilitiesIncomplete,
+    totalBytes,
+    fileCount: files.length
+  };
+}
+
+// ../../packages/mobile-scan/src/estimate.ts
+var MB = 1024 * 1024;
+var CSS_W = 430;
+var CSS_H = 932;
+var WORST_SKYBOX_BYTES = 8192 * 4096 * 4 * 1.33;
+var WORST_IMAGE_BYTES = 2048 * 2048 * 4 * 1.33;
+var KTX2_DISCOUNT = 6;
+function textureBytes(w, h, ktx2) {
+  const raw = w * h * 4 * 1.33;
+  return ktx2 ? raw / KTX2_DISCOUNT : raw;
+}
+function estimateVram(scan, externalDims) {
+  let bundled = 0;
+  let maxDim = 0;
+  for (const img of scan.images) {
+    bundled += textureBytes(img.width, img.height, img.ktx2);
+    maxDim = Math.max(maxDim, img.width, img.height);
+  }
+  let glbTex = 0;
+  let geometry = 0;
+  for (const glb of scan.glbs) {
+    if (!glb.scan) {
+      geometry += glb.bytes;
+      continue;
+    }
+    const ktx2 = glb.scan.extensions.some((e) => e.includes("KHR_texture_basisu"));
+    for (const img of glb.scan.images) {
+      glbTex += textureBytes(img.width, img.height, img.ktx2 || ktx2);
+      maxDim = Math.max(maxDim, img.width, img.height);
+    }
+    geometry += Math.max(0, glb.scan.binBytes - glb.scan.images.reduce((s, i) => s + i.bytes, 0));
+  }
+  let external = 0;
+  const unresolved = [];
+  for (const url of scan.genexAssetUrls) {
+    const role = url.split("/").pop() ?? "";
+    if (MOBILE_RUNG_SUFFIX_RE.test(role)) continue;
+    const dims = externalDims.get(url);
+    if (dims) {
+      const ktx2 = dims.ktx2 || dims.ktx2Available === true && scan.markers.ktx2Loader;
+      if (dims.glb) {
+        external += textureBytes(dims.width, dims.height, ktx2) + (dims.bytes ?? 0);
+        maxDim = Math.max(maxDim, dims.width);
+      } else {
+        external += textureBytes(dims.width, dims.height, ktx2);
+        maxDim = Math.max(maxDim, dims.width, dims.height);
+      }
+    } else {
+      unresolved.push(url);
+      external += role === SKYBOX_ROLE ? WORST_SKYBOX_BYTES : WORST_IMAGE_BYTES;
+      maxDim = Math.max(maxDim, role === SKYBOX_ROLE ? 8192 : 2048);
+    }
+  }
+  const dpr = Math.min(scan.markers.dprCapLiteral ?? 2, 3);
+  const surface = CSS_W * CSS_H * dpr * dpr * 4;
+  const framebuffers = surface * (3 + (scan.markers.postStack ? 4 : 0));
+  const shadow = 2048 * 2048 * 4;
+  const total = bundled + glbTex + external + framebuffers + shadow + geometry;
+  return {
+    estVramMb: Math.round(total / MB),
+    breakdown: {
+      bundledTexturesMb: Math.round(bundled / MB),
+      glbTexturesMb: Math.round(glbTex / MB),
+      externalTexturesMb: Math.round(external / MB),
+      framebuffersMb: Math.round(framebuffers / MB),
+      shadowDefaultMb: Math.round(shadow / MB),
+      geometryMb: Math.round(geometry / MB)
+    },
+    unresolvedExternals: unresolved,
+    textureMaxDim: maxDim
+  };
+}
+function tierFor(estVramMb) {
+  if (estVramMb < MOBILE_BUDGET_MB.broad) return "mobile-broad";
+  if (estVramMb < MOBILE_BUDGET_MB.modern) return "mobile-modern";
+  return "over-budget";
+}
+
 // src/lib/download-assets.ts
 import fs12 from "fs/promises";
 import path13 from "path";
@@ -2345,7 +2740,54 @@ function splitArgs(text) {
 }
 var lineOf = (content, index) => content.slice(0, index).split("\n").length;
 function blankComments(raw) {
-  return raw.replace(/\/\*[\s\S]*?\*\//g, (m) => m.replace(/[^\n]/g, " ")).replace(/(^|[^:])\/\/[^\n]*/gm, (m, p1) => p1 + " ".repeat(m.length - p1.length));
+  const out = [];
+  let kept = 0;
+  const blank = (from, to) => {
+    out.push(raw.slice(kept, from), raw.slice(from, to).replace(/[^\n]/g, " "));
+    kept = to;
+  };
+  const templates = [];
+  let depth = 0;
+  let i = 0;
+  while (i < raw.length) {
+    const ch = raw[i];
+    if (ch === '"' || ch === "'") {
+      i++;
+      while (i < raw.length && raw[i] !== ch && raw[i] !== "\n") i += raw[i] === "\\" ? 2 : 1;
+      i++;
+    } else if (ch === "`" || ch === "}" && templates.at(-1) === depth) {
+      if (ch === "}") templates.pop();
+      i++;
+      while (i < raw.length && raw[i] !== "`" && !(raw[i] === "$" && raw[i + 1] === "{")) {
+        i += raw[i] === "\\" ? 2 : 1;
+      }
+      if (raw[i] === "$") {
+        templates.push(depth);
+        i += 2;
+      } else {
+        i++;
+      }
+    } else if (ch === "{") {
+      depth++;
+      i++;
+    } else if (ch === "}") {
+      depth--;
+      i++;
+    } else if (ch === "/" && raw[i + 1] === "*" && raw.indexOf("*/", i + 2) !== -1) {
+      const end = raw.indexOf("*/", i + 2) + 2;
+      blank(i, end);
+      i = end;
+    } else if (ch === "/" && raw[i + 1] === "/" && raw[i - 1] !== ":") {
+      const eol = raw.indexOf("\n", i);
+      const end = eol === -1 ? raw.length : eol;
+      blank(i, end);
+      i = end;
+    } else {
+      i++;
+    }
+  }
+  out.push(raw.slice(kept));
+  return out.join("");
 }
 var IDENTITY_AWAIT = /\bawait\s+(waitForPlayer|waitForAuth)\s*\(/;
 var RENDERER_CTOR = /\bnew\s+(?:THREE\.)?(?:WebGLRenderer|WebGPURenderer)\s*\(/;
@@ -2406,8 +2848,10 @@ async function detectEmbedBoot(cwd = process.cwd()) {
 }
 var CONTROL_HEADS = /* @__PURE__ */ new Set(["if", "for", "while", "switch", "catch", "with", "await"]);
 function isFunctionBrace(tail) {
-  const t = tail.trimEnd();
+  let t = tail.trimEnd();
   if (t.endsWith("=>")) return true;
+  const typed = /^([\s\S]*\))[ \t]*:[ \t]*[^\s;=?()][^;=?()\n]*$/.exec(t);
+  if (typed) t = typed[1];
   if (!t.endsWith(")")) return false;
   let depth = 0;
   let i = t.length - 1;
@@ -2618,6 +3062,199 @@ async function detectGenerationAudit(cwd = process.cwd()) {
     musicNoSlider: audited.some((e) => e.kind === "music" && e.status === "completed") && !/type\s*=\s*["'`]range["'`]/.test(haystack)
   };
 }
+async function readOwnSource(cwd) {
+  const out = [];
+  const page = await fs13.readFile(path14.join(cwd, "index.html"), "utf8").catch(() => "");
+  if (page) {
+    out.push({
+      rel: "index.html",
+      content: page.replace(/<!--[\s\S]*?-->/g, (m) => m.replace(/[^\n]/g, " "))
+    });
+  }
+  const srcDir = path14.join(cwd, "src");
+  let entries;
+  try {
+    entries = await fs13.readdir(srcDir, { recursive: true });
+  } catch {
+    return out;
+  }
+  for (const nativeRel of entries.sort()) {
+    if (nativeRel.includes("node_modules")) continue;
+    if (nativeRel.split(path14.sep)[0] === "controllers") continue;
+    if (!/\.(ts|js|mts|mjs|tsx|jsx)$/.test(nativeRel)) continue;
+    const raw = await fs13.readFile(path14.join(srcDir, nativeRel), "utf8").catch(() => "");
+    if (!raw) continue;
+    out.push({ rel: nativeRel.split(path14.sep).join("/"), content: blankComments(raw) });
+  }
+  return out;
+}
+async function readManifestCapabilities(cwd) {
+  try {
+    const pkg = JSON.parse(await fs13.readFile(path14.join(cwd, "package.json"), "utf8"));
+    const raw = pkg.genex?.capabilities;
+    if (raw === void 0 || raw === null) return { entries: [], notAList: false };
+    return Array.isArray(raw) ? { entries: raw, notAList: false } : { entries: [], notAList: true };
+  } catch {
+    return { entries: [], notAList: false };
+  }
+}
+var SOURCE_MICROPHONE = [
+  /\.voice\s*\??\.\s*join\s*\(\s*(?:\)|\{)/,
+  /\b(?:webkit)?SpeechRecognition\b/
+];
+function opensMicrophone(content) {
+  return SOURCE_MICROPHONE.some((evidence) => evidence.test(content)) || mediaRequestsInText(content).some((request) => request.audio);
+}
+async function detectCapabilities(cwd = process.cwd()) {
+  const found = [...(await readManifestCapabilities(cwd)).entries];
+  for (const { content } of await readOwnSource(cwd)) {
+    found.push(...capabilitiesInText(content));
+    if (opensMicrophone(content)) found.push("microphone");
+  }
+  return knownCapabilities(found);
+}
+var SHARE_CALL = /\bnavigator\s*\??\.\s*share\s*\(/g;
+var CLIPBOARD_USE = /\bnavigator\s*\??\.\s*clipboard\b/g;
+var WAKE_LOCK_USE = /\bnavigator\s*\??\.\s*wakeLock\b/g;
+var NEW_WINDOW = /\bwindow\s*\??\.\s*open\s*\(|["'`]_blank["'`]/g;
+var DOWNLOAD_ASSIGN = /\.download\s*=(?!=)/g;
+var DOWNLOAD_ATTR = /<a\b[^>]*\sdownload\b|\bsetAttribute\(\s*["'`]download["'`]/g;
+var MAKES_A_LINK = /\bcreateElement\(\s*["'`]a["'`]\s*\)|\bcreateObjectURL\b|\btoDataURL\b|\btoBlob\b|<a\b/;
+var SERVICE_WORKER = /\bserviceWorker\s*\??\.\s*register\s*\(/g;
+var MOTION_USE = /\b(?:DeviceOrientationEvent|DeviceMotionEvent)\b|["'`]device(?:orientation(?:absolute)?|motion)["'`]|\bondevice(?:orientation(?:absolute)?|motion)\b/g;
+var HASH_READ = /(?<![\w$.])(?:(?:window|document|globalThis|self)\s*\.\s*)?location\s*\.\s*hash\b(?!\s*(?:=(?!=)|\+=))/g;
+var DIALOG_CALL = /(?<![\w$.])((?:window|globalThis|self)\s*\.\s*)?(alert|confirm|prompt)\(/g;
+var MEMBER_HEAD = /^(?:(?:export|declare|abstract|async|public|private|protected|static|readonly|override|get|set)\s+|\*\s*)*$/;
+function afterCloseParen(content, from) {
+  let depth = 1;
+  let i = from;
+  while (i < content.length && depth > 0) {
+    const ch = content[i];
+    if (ch === "(") depth++;
+    else if (ch === ")") depth--;
+    i++;
+  }
+  return i;
+}
+function dialogCalls(content) {
+  const out = [];
+  for (const m of content.matchAll(DIALOG_CALL)) {
+    const index = m.index;
+    const name = m[2];
+    if (!m[1]) {
+      const own = new RegExp(
+        [
+          `\\b(?:function\\*?|const|let|var|class)\\s+${name}\\b`,
+          `\\bimport\\s+${name}\\s+from\\b`,
+          // `{ prompt, toast }`, `(text, confirm)`, `(confirm: () => void)`,
+          // `{ prompt: text }`: a named import, a destructuring, a parameter.
+          `[{,(]\\s*${name}\\s*(?:[,}):]|=(?!=))`
+        ].join("|")
+      );
+      if (own.test(content)) continue;
+      const head = content.slice(content.lastIndexOf("\n", index) + 1, index).trimStart();
+      const next = content.slice(afterCloseParen(content, index + m[0].length)).trimStart()[0];
+      if (MEMBER_HEAD.test(head) && (next === "{" || next === ":")) continue;
+    }
+    out.push({ index, name });
+  }
+  return out;
+}
+function inBracelessArrow(content, index) {
+  let start = index;
+  while (start > 0 && !";{}".includes(content[start - 1])) start--;
+  const span = content.slice(start, index);
+  const arrow = span.lastIndexOf("=>");
+  if (arrow === -1) return false;
+  let depth = 0;
+  let begun = false;
+  for (const ch of span.slice(arrow + 2)) {
+    if (ch === "(" || ch === "[") depth++;
+    else if (ch === ")" || ch === "]") depth--;
+    if (ch === "\n") {
+      if (begun && depth <= 0) return false;
+    } else if (ch.trim()) {
+      begun = true;
+    }
+  }
+  return true;
+}
+function hashReadsBeforeInit(content) {
+  const reads = [...content.matchAll(HASH_READ)].map((m) => m.index);
+  if (reads.length === 0) return [];
+  const inits = [...content.matchAll(new RegExp(INIT_EMBED_CALL.source, "g"))].map((m) => ({
+    index: m.index,
+    flowEnd: enclosingFlowEnd(content, m.index)
+  }));
+  let depth = 0;
+  let scanned = 0;
+  return reads.filter((at) => {
+    for (; scanned < at; scanned++) {
+      const ch = content[scanned];
+      if (ch === "{") depth++;
+      else if (ch === "}") depth--;
+    }
+    if (depth <= 0) {
+      return !inBracelessArrow(content, at) && !inits.some((init2) => init2.index < at);
+    }
+    const flowEnd = enclosingFlowEnd(content, at);
+    return flowEnd !== content.length && inits.some((init2) => init2.flowEnd === flowEnd && init2.index > at);
+  });
+}
+async function detectShellApis(cwd = process.cwd()) {
+  const manifest = await readManifestCapabilities(cwd);
+  const found = {
+    share: [],
+    clipboard: [],
+    wakeLock: [],
+    newWindow: [],
+    download: [],
+    dialogs: [],
+    serviceWorker: [],
+    motionNoPermission: [],
+    hashBeforeInit: [],
+    capture: [],
+    manifestCapabilities: knownCapabilities(manifest.entries),
+    unknownCapabilities: manifest.entries.filter((entry) => !KNOWN_CAPABILITIES.includes(entry)).map((entry) => {
+      const quoted = JSON.stringify(entry).replace(
+        /[^\x20-\x7e]/g,
+        (ch) => `\\u${ch.charCodeAt(0).toString(16).padStart(4, "0")}`
+      );
+      return quoted.length > 40 ? `${quoted.slice(0, 40)}\u2026` : quoted;
+    }),
+    capabilitiesNotAList: manifest.notAList
+  };
+  let asksMotionPermission = false;
+  for (const file of await readOwnSource(cwd)) {
+    const { rel, content } = file;
+    const add = (into, index, detail) => {
+      const where = `${rel}:${lineOf(content, index)}`;
+      if (!into.some((d) => d.where === where)) into.push({ where, detail });
+    };
+    for (const m of content.matchAll(SHARE_CALL)) add(found.share, m.index, "navigator.share");
+    for (const m of content.matchAll(CLIPBOARD_USE)) add(found.clipboard, m.index, "navigator.clipboard");
+    for (const m of content.matchAll(WAKE_LOCK_USE)) add(found.wakeLock, m.index, "navigator.wakeLock");
+    for (const m of content.matchAll(NEW_WINDOW)) {
+      add(found.newWindow, m.index, m[0].includes("open") ? "window.open" : 'target "_blank"');
+    }
+    if (MAKES_A_LINK.test(content)) {
+      for (const m of content.matchAll(DOWNLOAD_ASSIGN)) add(found.download, m.index, "a.download");
+    }
+    for (const m of content.matchAll(DOWNLOAD_ATTR)) add(found.download, m.index, "a download link");
+    for (const call of dialogCalls(content)) add(found.dialogs, call.index, `${call.name}()`);
+    for (const m of content.matchAll(SERVICE_WORKER)) {
+      add(found.serviceWorker, m.index, "serviceWorker.register");
+    }
+    for (const m of content.matchAll(MOTION_USE)) add(found.motionNoPermission, m.index, "device motion");
+    if (/\brequestPermission\b/.test(content)) asksMotionPermission = true;
+    for (const at of hashReadsBeforeInit(content)) add(found.hashBeforeInit, at, "location.hash");
+    for (const request of mediaRequestsInText(content)) {
+      if (!request.read) add(found.capture, request.index, "getUserMedia");
+    }
+  }
+  if (asksMotionPermission) found.motionNoPermission = [];
+  return found;
+}
 async function detectFeatures(log, cwd = process.cwd()) {
   return {
     embedSdkVersion: await detectEmbedSdkVersion(cwd),
@@ -2627,28 +3264,114 @@ async function detectFeatures(log, cwd = process.cwd()) {
     mobileControls: await detectMobileControls(cwd),
     surfaces: await detectSurfaceScan(cwd),
     generations: await detectGenerationAudit(cwd),
-    embedBoot: await detectEmbedBoot(cwd)
+    embedBoot: await detectEmbedBoot(cwd),
+    capabilities: await detectCapabilities(cwd),
+    shellApis: await detectShellApis(cwd)
   };
 }
 function advisoryNudges(log, d) {
   if (!d.embedSdkVersion) {
     log.warn(
-      "This game has no player identity or saves \u2014 players lose everything on refresh. The genex-threejs-embed-auth skill wires it with one call (initEmbed) \u2014 load it before publishing."
+      "This game has no player identity or saves \u2014 players lose everything on refresh. The genex-threejs-embed-auth skill wires it with one call (initEmbed) \u2014 load it before publishing."
+    );
+  }
+  if (d.multiplayer && !d.embedSdkVersion) {
+    log.warn(
+      "Multiplayer will NOT work: @genex-ai/multiplayer needs the embed-sdk token (getColyseusAuth) \u2014 the relay rejects tokenless joins. Wire genex-threejs-embed-auth first."
+    );
+  }
+  if (d.matchmaking && !d.multiplayer) {
+    log.warn(
+      "package.json declares genex.matchmaking but @genex-ai/multiplayer is not installed \u2014 matchmaking cannot work. Install the SDK and use matchmake() (see genex-threejs-multiplayer)."
+    );
+  }
+  embedBootNudges(log, d);
+  shellNudges(log, d);
+  surfaceNudges(log, d.surfaces);
+  generationNudges(log, d.generations);
+}
+function places(found, withDetail = false) {
+  const shown = found.slice(0, 4).map((d) => withDetail ? `${d.where} (${d.detail})` : d.where);
+  const rest = found.length - shown.length;
+  return shown.join(", ") + (rest > 0 ? ` (+${rest} more)` : "");
+}
+function shellNudges(log, d) {
+  const s = d.shellApis;
+  const helper = "from @genex-ai/embed-sdk";
+  let namedHelper = false;
+  if (s.capabilitiesNotAList) {
+    log.warn(
+      `package.json \`genex.capabilities\` is not a list, so it declares nothing. Write the names in a list: "genex": { "capabilities": ["camera"] } \u2014 the names are ${KNOWN_CAPABILITIES.join(", ")}.`
+    );
+  }
+  if (s.unknownCapabilities.length) {
+    log.warn(
+      `package.json \`genex.capabilities\` lists ${s.unknownCapabilities.slice(0, 6).join(", ")}, which Genex does not know, so it gives the game nothing. The names are ${KNOWN_CAPABILITIES.join(", ")}, spelled exactly so.`
+    );
+  }
+  const mediaDeclared = ["microphone", "camera"].filter((name) => d.capabilities.includes(name));
+  if (s.capture.length && mediaDeclared.length < 2 && !s.manifestCapabilities.some((name) => name === "microphone" || name === "camera")) {
+    const declared = mediaDeclared.length ? `only the ${mediaDeclared[0]} is declared for this build` : "nothing in this game declares the microphone or the camera";
+    log.warn(
+      `${places(s.capture)} calls getUserMedia, and ${declared}: the constraints are not written out at the call, so the scan cannot tell which it opens. On the game's Genex page an undeclared microphone or camera is refused without the player being asked, while the same build works on its own link. Say which the game uses in package.json: "genex": { "capabilities": ["microphone"] } (or "camera", or both).`
+    );
+  }
+  if (s.share.length) {
+    namedHelper = true;
+    log.warn(
+      `${places(s.share)} calls navigator.share. It shares whatever the game hands it, and on the game's Genex page \`location.href\` is the bare game address, never the page players should be sent to; some shells have no share sheet at all. share({ text, params }) ${helper} builds the link to the game's page itself, opens the sheet where there is one and copies the link where there is not. Call it inside the click or tap.`
+    );
+  }
+  if (s.clipboard.length) {
+    namedHelper = true;
+    log.warn(
+      `${places(s.clipboard)} uses navigator.clipboard. The game's Genex page gives a framed game clipboard writing and never reading, and a write is still refused without a tap behind it, or in a frame on a page that does not pass it on. copyText(text) ${helper} tries it and falls back to the older copy a frame is allowed after a tap; call it inside the click. To read text, let the player paste into an <input>.`
+    );
+  }
+  if (s.wakeLock.length) {
+    namedHelper = true;
+    log.warn(
+      `${places(s.wakeLock)} uses navigator.wakeLock. The game's Genex page gives it to every framed game, but the browser drops the lock every time the tab is hidden and some browsers have none to give. keepAwake(true) ${helper} takes the lock again when the player comes back, says so where there is none, and answers ok in the Genex app, where the screen already stays on.`
+    );
+  }
+  if (s.newWindow.length) {
+    namedHelper = true;
+    log.warn(
+      `${places(s.newWindow, true)} opens a new window. The game's Genex page gives a game no new windows and the Genex app blocks links out of a game, so there the click does nothing. openExternal(url) ${helper}, called inside the click, is the one call for every shell: on the game's page Genex asks the player and opens the link, on the game's own link it is a new tab, and where links out are not available it answers \`unsupported\` \u2014 show the address instead.`
+    );
+  }
+  if (s.download.length) {
+    namedHelper = true;
+    log.warn(
+      `${places(s.download)} saves a file through a download link. The game's Genex page drops a download started inside a game, with no error. saveFile(blob, name) ${helper}, called inside the click, saves an image, a video, JSON or plain text wherever a shell can: on the game's page Genex asks the player first, and where saving is not available it answers \`unsupported\`.`
+    );
+  }
+  if (s.hashBeforeInit.length && d.embedSdkVersion) {
+    namedHelper = true;
+    log.warn(
+      `${places(s.hashBeforeInit)} reads location.hash where it can run before initEmbed(). On the game's own link the address bar still holds Genex's sign-in fragment at that point, and initEmbed() puts the game's own fragment back without a hashchange event, so that first read is wrong and nothing corrects it. Read the link with getEntry() ${helper}: getEntry().hash and getEntry().params answer the same in every shell, whenever they are asked.`
     );
   }
-  if (d.multiplayer && !d.embedSdkVersion) {
+  if (namedHelper) {
+    log.dim(
+      "  share, copyText, keepAwake, openExternal, saveFile and getEntry ship in the current @genex-ai/embed-sdk. If an import is missing: npm i @genex-ai/embed-sdk@latest"
+    );
+  }
+  if (s.dialogs.length) {
     log.warn(
-      "Multiplayer will NOT work: @genex-ai/multiplayer needs the embed-sdk token (getColyseusAuth) \u2014 the relay rejects tokenless joins. Wire genex-threejs-embed-auth first."
+      `${places(s.dialogs, true)} calls a browser dialog. The game's Genex page shows none for a game: alert() does nothing, confirm() answers false and prompt() answers null, with no error, while the same build works on its own link. Draw the dialog in the game's own interface (genex-threejs-game-ui).`
     );
   }
-  if (d.matchmaking && !d.multiplayer) {
+  if (s.motionNoPermission.length) {
     log.warn(
-      "package.json declares genex.matchmaking but @genex-ai/multiplayer is not installed \u2014 matchmaking cannot work. Install the SDK and use matchmake() (see genex-threejs-multiplayer)."
+      `${places(s.motionNoPermission)} uses device tilt or motion, and nothing in the game calls requestPermission(). An iPhone sends no motion events until the player allows them, and it asks only when DeviceOrientationEvent.requestPermission() is called from a tap inside the game. Ask in the Start tap, treat a refusal or no events at all as "no sensor", and keep the on-screen controls as the fallback (genex-threejs-touch-controls).`
+    );
+  }
+  if (s.serviceWorker.length) {
+    log.warn(
+      `${places(s.serviceWorker)} registers a service worker. A returning player's browser then serves the copy it kept: an older build after an update, or a game that has since been taken down, and no deploy reaches it. A Genex game does not register one.`
     );
   }
-  embedBootNudges(log, d);
-  surfaceNudges(log, d.surfaces);
-  generationNudges(log, d.generations);
 }
 function embedBootNudges(log, d) {
   const boot = d.embedBoot;
@@ -2912,359 +3635,98 @@ function auditGenerationPlan(input) {
   const owed = /* @__PURE__ */ new Map();
   for (const row of rows) {
     if (row.procedural || row.lane === null || reconciled.has(row)) continue;
-    if (row.status !== "planned" && row.status !== "generating") continue;
-    if (lanesRun.has(row.lane)) {
-      if (rows.filter((other) => other.lane === row.lane).length > 1) warnings.push(`DESIGN.md asset ${row.name} has no matched generation id. Other ${row.lane} work completed, but that does not establish this asset's delivery. Record its id or the substitution reason.`);
-      continue;
-    }
-    if (lanesPending.has(row.lane)) {
-      warnings.push(`DESIGN.md plans ${row.name}; its ${row.lane} lane has pending work. Check the existing request and record its id; do not enqueue a duplicate.`);
-      continue;
-    }
-    if (row.lane === "skybox") continue;
-    const held = owed.get(row.lane) ?? [];
-    held.push(row.status === "generating" ? `${row.name} (says generating, not in this project's ledger)` : row.name);
-    owed.set(row.lane, held);
-  }
-  for (const lane of declaredLanes) {
-    if (lanesRun.has(lane) || lanesPending.has(lane) || owed.has(lane) || lane === "skybox") continue;
-    if (!rows.some((r) => r.lane === lane)) owed.set(lane, ["declared as this subsystem's lane"]);
-  }
-  for (const [lane, names2] of owed) {
-    const shown = names2.slice(0, 3).join(", ") + (names2.length > 3 ? `, +${names2.length - 3} more` : "");
-    warnings.push(
-      `DESIGN.md plans generated ${lane} work (${shown}) and this project has no ${lane} generation that landed \u2014 the plan says so and the generation ledger has nothing completed. Generate it (${LANE_COMMAND[lane] ?? `npx genex ${lane}`} "<prompt>" --no-wait), or change the row to say what happens instead and why.`
-    );
-  }
-  const paidRows = rows.filter((r) => !r.procedural);
-  const codeRows = rows.filter((r) => r.procedural);
-  if (paidRows.length === 0 && codeRows.length >= 1 && ledger.length === 0 && !explained) {
-    warnings.push(
-      "DESIGN.md's asset plan is all code-built rows and this project has never run a generation. What the player sees must read as the thing it is (build contract, law 22): a coloured box or a capsule is not a finished building, person, or prop. Generate what the request names and what the player looks at up close (npx genex model / texture / music \u2026 --no-wait), or write a `Generation: none \u2014` line beside the table ending in your own sentence about why code alone reaches the bar in THIS game. " + (noneMarker ? "The line is there but its reason is still the unfilled template \u2014 replace it with the actual reason." : "")
-    );
-  }
-  return warnings;
-}
-
-// src/lib/deploy.ts
-import crypto2 from "crypto";
-import fs17 from "fs/promises";
-import os5 from "os";
-import path17 from "path";
-
-// src/lib/source-size.ts
-import fs14 from "fs/promises";
-import path15 from "path";
-var FALLBACK_SOURCE_LIMITS = {
-  maxTotalBytes: 2 * 1024 * 1024 * 1024,
-  maxFiles: 5e3
-};
-function isOversized(p, limits) {
-  return p.bytes >= limits.maxTotalBytes || p.files >= limits.maxFiles;
-}
-function formatBytes2(n) {
-  if (n >= 1024 ** 3) return `${(n / 1024 ** 3).toFixed(1)} GB`;
-  if (n >= 1024 ** 2) return `${Math.round(n / 1024 ** 2)} MB`;
-  if (n >= 1024) return `${Math.round(n / 1024)} KB`;
-  return `${n} B`;
-}
-function groupByDir(entries, limit = 5) {
-  const acc = /* @__PURE__ */ new Map();
-  for (const [file, bytes] of entries) {
-    const dirParts = file.split("/").slice(0, -1).slice(0, 2);
-    const dir = dirParts.length > 0 ? dirParts.join("/") : "(root)";
-    const row = acc.get(dir) ?? { dir, files: 0, bytes: 0 };
-    row.files += 1;
-    row.bytes += bytes;
-    acc.set(dir, row);
-  }
-  return [...acc.values()].sort((a, b) => b.bytes - a.bytes).slice(0, limit);
-}
-function oversizedLines(p, limits) {
-  return [
-    `This is ${formatBytes2(p.bytes)} across ${p.files} files, past the ${formatBytes2(limits.maxTotalBytes)} / ${limits.maxFiles} file limit on this account.`,
-    "Heaviest directories:",
-    ...p.top.map((d) => `  ${formatBytes2(d.bytes).padStart(8)}  ${String(d.files).padStart(6)} files  ${d.dir}`),
-    "Screenshots, traces and reports made while building are not part of the game \u2014",
-    "put them in .genex/scratch/ (already ignored), or add the folders above to .gitignore.",
-    "If this really is the game, ask an admin to raise the source limit on your account."
-  ];
-}
-async function measurePayload(cwd, staged) {
-  const entries = [];
-  let bytes = 0;
-  for (const file of staged) {
-    let size = 0;
-    try {
-      size = (await fs14.stat(path15.join(cwd, file))).size;
-    } catch {
-      size = 0;
-    }
-    bytes += size;
-    entries.push([file, size]);
-  }
-  return { files: staged.length, bytes, top: groupByDir(entries) };
-}
-
-// ../../packages/mobile-scan/src/image-dims.ts
-function u32be(b, o) {
-  return (b[o] << 24 | b[o + 1] << 16 | b[o + 2] << 8 | b[o + 3]) >>> 0;
-}
-function u32le(b, o) {
-  return (b[o] | b[o + 1] << 8 | b[o + 2] << 16 | b[o + 3] << 24) >>> 0;
-}
-function u16be(b, o) {
-  return b[o] << 8 | b[o + 1];
-}
-function u16le(b, o) {
-  return b[o] | b[o + 1] << 8;
-}
-function isPng(b) {
-  return b.length > 24 && b[0] === 137 && b[1] === 80 && b[2] === 78 && b[3] === 71 && b[4] === 13 && b[5] === 10 && b[6] === 26 && b[7] === 10;
-}
-var KTX2_MAGIC = [171, 75, 84, 88, 32, 50, 48, 187, 13, 10, 26, 10];
-function parseImageDims(bytes) {
-  if (bytes.length < 30) return null;
-  if (isPng(bytes)) {
-    return { width: u32be(bytes, 16), height: u32be(bytes, 20) };
-  }
-  if (bytes[0] === 255 && bytes[1] === 216) {
-    let i = 2;
-    while (i + 9 < bytes.length) {
-      if (bytes[i] !== 255) {
-        i++;
-        continue;
-      }
-      const marker = bytes[i + 1];
-      if (marker === 255) {
-        i++;
-        continue;
-      }
-      if (marker === 216 || marker >= 208 && marker <= 217) {
-        i += 2;
-        continue;
-      }
-      const isSof = marker >= 192 && marker <= 195 || marker >= 197 && marker <= 199 || marker >= 201 && marker <= 203 || marker >= 205 && marker <= 207;
-      if (isSof) {
-        return { width: u16be(bytes, i + 7), height: u16be(bytes, i + 5) };
-      }
-      i += 2 + u16be(bytes, i + 2);
-    }
-    return null;
-  }
-  if (bytes[0] === 82 && // RIFF….WEBP
-  bytes[1] === 73 && bytes[2] === 70 && bytes[3] === 70 && bytes[8] === 87 && bytes[9] === 69 && bytes[10] === 66 && bytes[11] === 80) {
-    const fourcc = String.fromCharCode(bytes[12], bytes[13], bytes[14], bytes[15]);
-    if (fourcc === "VP8X" && bytes.length >= 30) {
-      const w = 1 + (bytes[24] | bytes[25] << 8 | bytes[26] << 16);
-      const h = 1 + (bytes[27] | bytes[28] << 8 | bytes[29] << 16);
-      return { width: w, height: h };
-    }
-    if (fourcc === "VP8 " && bytes.length >= 30) {
-      return { width: u16le(bytes, 26) & 16383, height: u16le(bytes, 28) & 16383 };
-    }
-    if (fourcc === "VP8L" && bytes.length >= 25 && bytes[20] === 47) {
-      const b0 = bytes[21];
-      const b1 = bytes[22];
-      const b2 = bytes[23];
-      const b3 = bytes[24];
-      const width = 1 + ((b1 & 63) << 8 | b0);
-      const height = 1 + ((b3 & 15) << 10 | b2 << 2 | (b1 & 192) >> 6);
-      return { width, height };
-    }
-    return null;
-  }
-  if (KTX2_MAGIC.every((v, idx) => bytes[idx] === v)) {
-    return { width: u32le(bytes, 20), height: u32le(bytes, 24), ktx2: true };
-  }
-  return null;
-}
-
-// ../../packages/mobile-scan/src/glb.ts
-function u32le2(b, o) {
-  return (b[o] | b[o + 1] << 8 | b[o + 2] << 16 | b[o + 3] << 24) >>> 0;
-}
-function scanGlb(bytes) {
-  if (bytes.length < 20 || u32le2(bytes, 0) !== 1179937895) return null;
-  try {
-    const jsonLen = u32le2(bytes, 12);
-    if (u32le2(bytes, 16) !== 1313821514) return null;
-    const json = JSON.parse(new TextDecoder().decode(bytes.subarray(20, 20 + jsonLen)));
-    let bin = null;
-    const binHeader = 20 + jsonLen;
-    if (binHeader + 8 <= bytes.length && u32le2(bytes, binHeader + 4) === 5130562) {
-      bin = bytes.subarray(binHeader + 8, binHeader + 8 + u32le2(bytes, binHeader));
-    }
-    const images = [];
-    for (const img of json.images ?? []) {
-      if (img.bufferView == null || !bin) continue;
-      const view = json.bufferViews?.[img.bufferView];
-      if (!view?.byteLength) continue;
-      const slice = bin.subarray(view.byteOffset ?? 0, (view.byteOffset ?? 0) + view.byteLength);
-      const dims = parseImageDims(slice);
-      if (dims) images.push({ ...dims, mimeType: img.mimeType, bytes: view.byteLength });
-    }
-    let triangles = 0;
-    for (const mesh of json.meshes ?? []) {
-      for (const prim of mesh.primitives ?? []) {
-        const accessor = prim.indices != null ? json.accessors?.[prim.indices] : json.accessors?.[prim.attributes?.POSITION ?? -1];
-        if (accessor?.count) triangles += Math.floor(accessor.count / 3);
-      }
-    }
-    return {
-      triangles,
-      binBytes: bin?.byteLength ?? 0,
-      images,
-      extensions: json.extensionsUsed ?? []
-    };
-  } catch {
-    return null;
-  }
-}
-
-// ../../packages/mobile-scan/src/scan.ts
-var GENEX_GENERATION_URL_RE = /https:\/\/[A-Za-z0-9.-]+\/generations\/([A-Za-z0-9._-]+)\/([A-Za-z0-9._@-]+)/g;
-var SKYBOX_ROLE = "skybox-equirect";
-var MOBILE_RUNG_SUFFIX_RE = /@(\d+)$/;
-var MOBILE_BUDGET_MB = { broad: 300, modern: 700 };
-var TEXT_EXT = /\.(js|mjs|cjs|html|css|json|txt)$/i;
-var IMAGE_EXT = /\.(png|jpe?g|webp|ktx2)$/i;
-var VIDEO_EXT = /\.(mp4|webm|mov)$/i;
-var AUDIO_EXT = /\.(mp3|ogg|wav|m4a)$/i;
-var GLB_EXT = /\.(glb|gltf)$/i;
-function scanBundle(files) {
-  const images = [];
-  const glbs = [];
-  const videos = [];
-  const audio = [];
-  const urls = /* @__PURE__ */ new Set();
-  let text = "";
-  let totalBytes = 0;
-  for (const f of files) {
-    totalBytes += f.bytes.byteLength;
-    if (IMAGE_EXT.test(f.relPath)) {
-      const dims = parseImageDims(f.bytes);
-      if (dims) images.push({ path: f.relPath, bytes: f.bytes.byteLength, ...dims });
-      continue;
-    }
-    if (GLB_EXT.test(f.relPath)) {
-      glbs.push({ path: f.relPath, bytes: f.bytes.byteLength, scan: scanGlb(f.bytes) });
-      continue;
-    }
-    if (VIDEO_EXT.test(f.relPath)) {
-      videos.push({ path: f.relPath, bytes: f.bytes.byteLength });
+    if (row.status !== "planned" && row.status !== "generating") continue;
+    if (lanesRun.has(row.lane)) {
+      if (rows.filter((other) => other.lane === row.lane).length > 1) warnings.push(`DESIGN.md asset ${row.name} has no matched generation id. Other ${row.lane} work completed, but that does not establish this asset's delivery. Record its id or the substitution reason.`);
       continue;
     }
-    if (AUDIO_EXT.test(f.relPath)) {
-      audio.push({ path: f.relPath, bytes: f.bytes.byteLength });
+    if (lanesPending.has(row.lane)) {
+      warnings.push(`DESIGN.md plans ${row.name}; its ${row.lane} lane has pending work. Check the existing request and record its id; do not enqueue a duplicate.`);
       continue;
     }
-    if (TEXT_EXT.test(f.relPath)) {
-      text += new TextDecoder().decode(f.bytes.subarray(0, 8 * 1024 * 1024));
-      text += "\n";
-    }
+    if (row.lane === "skybox") continue;
+    const held = owed.get(row.lane) ?? [];
+    held.push(row.status === "generating" ? `${row.name} (says generating, not in this project's ledger)` : row.name);
+    owed.set(row.lane, held);
   }
-  for (const m of text.matchAll(GENEX_GENERATION_URL_RE)) urls.add(m[0]);
-  const dprMatch = text.match(/setPixelRatio\(\s*Math\.min\([^,)]+,\s*([\d.]+)\s*\)/);
-  const markers = {
-    rendererBackend: text.includes("WebGPURenderer") || text.includes("getContext('webgpu')") || text.includes('"webgpu"') ? "webgpu" : "webgl",
-    postStack: /EffectComposer|postprocessing|PostProcessing|RenderPipeline/.test(text),
-    dprCapLiteral: dprMatch?.[1] ? Number(dprMatch[1]) : null,
-    contextLossHandler: text.includes("webglcontextlost") || text.includes("device.lost"),
-    ktx2Loader: text.includes("KTX2Loader") || text.includes(".ktx2"),
-    touchHints: /joystick/i.test(text) || text.includes("touchstart") && text.includes("touch-action"),
-    adaptiveQuality: text.includes("__GENEX_QUALITY__"),
-    modelRungs: text.includes("__GENEX_MODEL_RUNGS__"),
-    voice: text.includes("__GENEX_VOICE__")
-  };
-  return {
-    images,
-    glbs,
-    videos,
-    audio,
-    genexAssetUrls: [...urls],
-    markers,
-    totalBytes,
-    fileCount: files.length
-  };
+  for (const lane of declaredLanes) {
+    if (lanesRun.has(lane) || lanesPending.has(lane) || owed.has(lane) || lane === "skybox") continue;
+    if (!rows.some((r) => r.lane === lane)) owed.set(lane, ["declared as this subsystem's lane"]);
+  }
+  for (const [lane, names2] of owed) {
+    const shown = names2.slice(0, 3).join(", ") + (names2.length > 3 ? `, +${names2.length - 3} more` : "");
+    warnings.push(
+      `DESIGN.md plans generated ${lane} work (${shown}) and this project has no ${lane} generation that landed \u2014 the plan says so and the generation ledger has nothing completed. Generate it (${LANE_COMMAND[lane] ?? `npx genex ${lane}`} "<prompt>" --no-wait), or change the row to say what happens instead and why.`
+    );
+  }
+  const paidRows = rows.filter((r) => !r.procedural);
+  const codeRows = rows.filter((r) => r.procedural);
+  if (paidRows.length === 0 && codeRows.length >= 1 && ledger.length === 0 && !explained) {
+    warnings.push(
+      "DESIGN.md's asset plan is all code-built rows and this project has never run a generation. What the player sees must read as the thing it is (build contract, law 22): a coloured box or a capsule is not a finished building, person, or prop. Generate what the request names and what the player looks at up close (npx genex model / texture / music \u2026 --no-wait), or write a `Generation: none \u2014` line beside the table ending in your own sentence about why code alone reaches the bar in THIS game. " + (noneMarker ? "The line is there but its reason is still the unfilled template \u2014 replace it with the actual reason." : "")
+    );
+  }
+  return warnings;
 }
 
-// ../../packages/mobile-scan/src/estimate.ts
-var MB = 1024 * 1024;
-var CSS_W = 430;
-var CSS_H = 932;
-var WORST_SKYBOX_BYTES = 8192 * 4096 * 4 * 1.33;
-var WORST_IMAGE_BYTES = 2048 * 2048 * 4 * 1.33;
-var KTX2_DISCOUNT = 6;
-function textureBytes(w, h, ktx2) {
-  const raw = w * h * 4 * 1.33;
-  return ktx2 ? raw / KTX2_DISCOUNT : raw;
+// src/lib/deploy.ts
+import crypto2 from "crypto";
+import fs17 from "fs/promises";
+import os5 from "os";
+import path17 from "path";
+
+// src/lib/source-size.ts
+import fs14 from "fs/promises";
+import path15 from "path";
+var FALLBACK_SOURCE_LIMITS = {
+  maxTotalBytes: 2 * 1024 * 1024 * 1024,
+  maxFiles: 5e3
+};
+function isOversized(p, limits) {
+  return p.bytes >= limits.maxTotalBytes || p.files >= limits.maxFiles;
 }
-function estimateVram(scan, externalDims) {
-  let bundled = 0;
-  let maxDim = 0;
-  for (const img of scan.images) {
-    bundled += textureBytes(img.width, img.height, img.ktx2);
-    maxDim = Math.max(maxDim, img.width, img.height);
-  }
-  let glbTex = 0;
-  let geometry = 0;
-  for (const glb of scan.glbs) {
-    if (!glb.scan) {
-      geometry += glb.bytes;
-      continue;
-    }
-    const ktx2 = glb.scan.extensions.some((e) => e.includes("KHR_texture_basisu"));
-    for (const img of glb.scan.images) {
-      glbTex += textureBytes(img.width, img.height, img.ktx2 || ktx2);
-      maxDim = Math.max(maxDim, img.width, img.height);
-    }
-    geometry += Math.max(0, glb.scan.binBytes - glb.scan.images.reduce((s, i) => s + i.bytes, 0));
+function formatBytes2(n) {
+  if (n >= 1024 ** 3) return `${(n / 1024 ** 3).toFixed(1)} GB`;
+  if (n >= 1024 ** 2) return `${Math.round(n / 1024 ** 2)} MB`;
+  if (n >= 1024) return `${Math.round(n / 1024)} KB`;
+  return `${n} B`;
+}
+function groupByDir(entries, limit = 5) {
+  const acc = /* @__PURE__ */ new Map();
+  for (const [file, bytes] of entries) {
+    const dirParts = file.split("/").slice(0, -1).slice(0, 2);
+    const dir = dirParts.length > 0 ? dirParts.join("/") : "(root)";
+    const row = acc.get(dir) ?? { dir, files: 0, bytes: 0 };
+    row.files += 1;
+    row.bytes += bytes;
+    acc.set(dir, row);
   }
-  let external = 0;
-  const unresolved = [];
-  for (const url of scan.genexAssetUrls) {
-    const role = url.split("/").pop() ?? "";
-    if (MOBILE_RUNG_SUFFIX_RE.test(role)) continue;
-    const dims = externalDims.get(url);
-    if (dims) {
-      const ktx2 = dims.ktx2 || dims.ktx2Available === true && scan.markers.ktx2Loader;
-      if (dims.glb) {
-        external += textureBytes(dims.width, dims.height, ktx2) + (dims.bytes ?? 0);
-        maxDim = Math.max(maxDim, dims.width);
-      } else {
-        external += textureBytes(dims.width, dims.height, ktx2);
-        maxDim = Math.max(maxDim, dims.width, dims.height);
-      }
-    } else {
-      unresolved.push(url);
-      external += role === SKYBOX_ROLE ? WORST_SKYBOX_BYTES : WORST_IMAGE_BYTES;
-      maxDim = Math.max(maxDim, role === SKYBOX_ROLE ? 8192 : 2048);
+  return [...acc.values()].sort((a, b) => b.bytes - a.bytes).slice(0, limit);
+}
+function oversizedLines(p, limits) {
+  return [
+    `This is ${formatBytes2(p.bytes)} across ${p.files} files, past the ${formatBytes2(limits.maxTotalBytes)} / ${limits.maxFiles} file limit on this account.`,
+    "Heaviest directories:",
+    ...p.top.map((d) => `  ${formatBytes2(d.bytes).padStart(8)}  ${String(d.files).padStart(6)} files  ${d.dir}`),
+    "Screenshots, traces and reports made while building are not part of the game \u2014",
+    "put them in .genex/scratch/ (already ignored), or add the folders above to .gitignore.",
+    "If this really is the game, ask an admin to raise the source limit on your account."
+  ];
+}
+async function measurePayload(cwd, staged) {
+  const entries = [];
+  let bytes = 0;
+  for (const file of staged) {
+    let size = 0;
+    try {
+      size = (await fs14.stat(path15.join(cwd, file))).size;
+    } catch {
+      size = 0;
     }
+    bytes += size;
+    entries.push([file, size]);
   }
-  const dpr = Math.min(scan.markers.dprCapLiteral ?? 2, 3);
-  const surface = CSS_W * CSS_H * dpr * dpr * 4;
-  const framebuffers = surface * (3 + (scan.markers.postStack ? 4 : 0));
-  const shadow = 2048 * 2048 * 4;
-  const total = bundled + glbTex + external + framebuffers + shadow + geometry;
-  return {
-    estVramMb: Math.round(total / MB),
-    breakdown: {
-      bundledTexturesMb: Math.round(bundled / MB),
-      glbTexturesMb: Math.round(glbTex / MB),
-      externalTexturesMb: Math.round(external / MB),
-      framebuffersMb: Math.round(framebuffers / MB),
-      shadowDefaultMb: Math.round(shadow / MB),
-      geometryMb: Math.round(geometry / MB)
-    },
-    unresolvedExternals: unresolved,
-    textureMaxDim: maxDim
-  };
-}
-function tierFor(estVramMb) {
-  if (estVramMb < MOBILE_BUDGET_MB.broad) return "mobile-broad";
-  if (estVramMb < MOBILE_BUDGET_MB.modern) return "mobile-modern";
-  return "over-budget";
+  return { files: staged.length, bytes, top: groupByDir(entries) };
 }
 
 // src/commands/ui.ts
@@ -5093,9 +5555,25 @@ async function uiAudit(opts, log) {
 }
 
 // src/lib/deploy.ts
+function goLiveCapabilities(declared, scanned) {
+  const own = knownCapabilities(declared ?? []);
+  if (scanned === void 0) return own.length > 0 ? own : void 0;
+  return knownCapabilities([...own, ...scanned]);
+}
+function printCapabilityPreflight(capabilities, log) {
+  if (capabilities === void 0) return;
+  if (capabilities.length > 0) {
+    log.info(`On its Genex page this build is given: ${capabilities.join(", ")}.`);
+  } else {
+    log.dim(
+      `  On its Genex page this build is given nothing that needs a permission (${KNOWN_CAPABILITIES.join(", ")}).`
+    );
+  }
+}
 function printMobilePreflight(files, log) {
+  let scan = null;
   try {
-    const scan = scanBundle(files.map((f) => ({ relPath: f.relPath, bytes: f.bytes })));
+    scan = scanBundle(files.map((f) => ({ relPath: f.relPath, bytes: f.bytes })));
     const externalDims = /* @__PURE__ */ new Map();
     for (const url of scan.genexAssetUrls) {
       const role = url.split("/").pop() ?? "";
@@ -5112,7 +5590,7 @@ function printMobilePreflight(files, log) {
     const line = `Mobile preflight: ~${est.estVramMb} MB est. GPU memory on phones (budget: <${MOBILE_BUDGET_MB.broad} MB broad, <${MOBILE_BUDGET_MB.modern} MB modern) \u2014 ${tier}.`;
     if (tier === "mobile-broad") {
       log.dim(`  ${line}`);
-      return;
+      return scan;
     }
     log.warn(line);
     for (const url of est.unresolvedExternals) {
@@ -5140,6 +5618,7 @@ function printMobilePreflight(files, log) {
     }
   } catch {
   }
+  return scan;
 }
 async function printUiAuditPreflight(log) {
   try {
@@ -5246,7 +5725,9 @@ async function deployGame(ctx, opts, log) {
     if (lfsPointers.length > 8) log.dim(`  \u2026and ${lfsPointers.length - 8} more`);
     return false;
   }
-  printMobilePreflight(files, log);
+  const scan = printMobilePreflight(files, log);
+  const capabilities = scan?.capabilitiesIncomplete ? goLiveCapabilities([...opts.capabilities ?? [], ...scan.capabilities], void 0) : goLiveCapabilities(opts.capabilities, scan?.capabilities);
+  printCapabilityPreflight(capabilities, log);
   await printUiAuditPreflight(log);
   if (await workspaceMode(cwd) === "game") await printPipelineStatePreflight(log);
   const commit = contentCommit(files);
@@ -5293,7 +5774,7 @@ async function deployGame(ctx, opts, log) {
   );
   if (pushed !== true) return false;
   log.step("Publishing\u2026");
-  const published = await callPublish(ctx, commit, opts, log, sourceCommitSha);
+  const published = await callPublish(ctx, commit, opts, log, sourceCommitSha, capabilities);
   if (!published) return false;
   if (opts.channel === "staging") {
     const tree = await sourceTreeHash(cwd);
@@ -5515,7 +5996,7 @@ async function uploadPartWithRetry(base, encoded, auth, uploadId, partNumber, by
     await new Promise((resolve) => setTimeout(resolve, attempt === 0 ? 500 : 2e3));
   }
 }
-async function callPublish(ctx, commit, opts, log, sourceCommitSha) {
+async function callPublish(ctx, commit, opts, log, sourceCommitSha, capabilities) {
   let res;
   try {
     res = await apiFetch(`${ctx.apiUrl}/api/games/${ctx.projectId}/publish`, {
@@ -5531,6 +6012,11 @@ async function callPublish(ctx, commit, opts, log, sourceCommitSha) {
         ...opts.embedSdkVersion ? { embedSdkVersion: opts.embedSdkVersion } : {},
         ...opts.multiplayer !== void 0 ? { multiplayer: opts.multiplayer } : {},
         ...opts.mobileControls !== void 0 ? { mobileControls: opts.mobileControls } : {},
+        // The build's declared capabilities, on both channels: a preview's list
+        // is what the owner's own preview frame is given, and a promotion
+        // carries it to production with the build. An API from before the
+        // field strips it, so the two can deploy in either order.
+        ...capabilities !== void 0 ? { capabilities } : {},
         // Recorded into the release history and acted on by nothing. Absent when
         // the source push produced no commit (a user's own repo, or a failure
         // that already stopped the deploy), which the server accepts as null.
@@ -6147,6 +6633,9 @@ async function runPreview(opts) {
     // declared preset doesn't silently run the default (null clears a removed
     // config), embedSdkVersion/multiplayer so the dashboard's Publish button can
     // list the draft without wrongly treating it as a pre-embed-auth bundle.
+    // Capabilities ride the preview for a different reason: the staging build's
+    // own list is what the owner's preview frame is given, so a microphone or
+    // camera can be tried before anything is published.
     {
       // Preview goes to the STAGING channel — the whole point of the release
       // cycle. Before channels this same call replaced the build every player
@@ -6157,7 +6646,8 @@ async function runPreview(opts) {
       matchmaking: detections.matchmaking,
       embedSdkVersion: detections.embedSdkVersion,
       multiplayer: detections.multiplayer,
-      mobileControls: detections.mobileControls
+      mobileControls: detections.mobileControls,
+      capabilities: detections.capabilities
     },
     log
   );
@@ -7968,7 +8458,10 @@ async function runPublish(opts) {
         matchmaking: detections.matchmaking,
         embedSdkVersion: detections.embedSdkVersion,
         multiplayer: detections.multiplayer,
-        mobileControls: detections.mobileControls
+        mobileControls: detections.mobileControls,
+        // Declared on the staging go-live; the promotion below copies that
+        // build's own list to production with it.
+        capabilities: detections.capabilities
       },
       log
     );
@@ -22948,7 +23441,7 @@ async function runBlender(opts) {
     return 1;
   }
   if (sub === "serve") {
-    const { serveLocalBlender } = await import("./blender-serve-66OHC4ML.js");
+    const { serveLocalBlender } = await import("./blender-serve-EH2MOW3U.js");
     const port = Number(process.env.GENEX_BLENDER_PORT ?? 8088);
     log.step(`Starting a local Blender service on port ${port}`);
     log.plain(
@@ -22957,7 +23450,7 @@ async function runBlender(opts) {
     return serveLocalBlender({ port, log });
   }
   if (sub === "mcp") {
-    const { runBlenderMcp } = await import("./blender-mcp-QVEGHE5L.js");
+    const { runBlenderMcp } = await import("./blender-mcp-WSURPZET.js");
     return runBlenderMcp();
   }
   if (sub === "seat") {
@@ -23465,7 +23958,12 @@ import fs35 from "fs/promises";
 import path36 from "path";
 import { randomUUID as randomUUID2 } from "crypto";
 var SUBS3 = ["models", "bench", "price", "status", "cancel"];
-var LLM_BENCH_APPROVAL_REQUIRED = "STOP: `genex llm bench` runs the real model and spends YOUR OWN coin \u2014 your wallet, not a player's, and one this build's asset allowance cannot see. Re-run with --max-coins <n> --user-approved only after the person at the keyboard agreed to the number.";
+var LLM_BENCH_APPROVAL_REQUIRED = "STOP: `genex llm bench` runs the real model and spends YOUR OWN credits \u2014 your balance, not a player's, and a spend this build's asset allowance does not count. Re-run with --max-credits <n> --user-approved only after the person at the keyboard agreed to the number.";
+var LLM_MAX_COINS_DEPRECATED = "--max-coins is deprecated: it is read as --max-credits, the same number \u2014 a bench spends credits now.";
+function benchBalanceShortLine(spendable, maxCredits) {
+  return `Your spendable credits (${spendable}) cannot cover one attempt at --max-credits ${maxCredits} \u2014 nothing was sent, nothing was spent. Add credits, or re-run with a lower --max-credits once the person at the keyboard agrees to it.`;
+}
+var LLM_BENCH_UNVERIFIED_LINE = "Credits pay only for a verified email, and this account's is not verified yet (credits_unverified) \u2014 nothing was sent, nothing was spent. Verify it, then re-run.";
 var LLM_LANE_OFF_LINE = "The runtime LLM lane is off on this stand \u2014 in-game generate() answers 404 here, and nothing can be benchmarked.";
 var LLM_TOOLS_CONVERT_HINT = [
   "In-game model calls need a hosted game. This folder is a Genex Tools workspace, so nothing here",
@@ -23478,7 +23976,7 @@ function serverSlotCounts(body) {
   return { held: body.slotsHeld, limit: body.slotLimit };
 }
 var PENDING_SLOT_RELEASE_MINUTES = 10;
-var LLM_STATUS_LEGEND = `"awaiting bill" = the call has stopped but the provider's bill is not final, so its coin stays held until the bill resolves; such a row stops holding a slot ${PENDING_SLOT_RELEASE_MINUTES} minutes after dispatch.`;
+var LLM_STATUS_LEGEND = `"awaiting bill" = the call has stopped but the provider's bill is not final, so what it reserved stays held until the bill resolves; such a row stops holding a slot ${PENDING_SLOT_RELEASE_MINUTES} minutes after dispatch.`;
 var LLM_STATUS_NO_COUNT_LINE = "This stand does not report how many slots are held across your projects, so no count is shown.";
 var LLM_CANCEL_AWAITING_BILL = "this call already stopped; its bill is awaiting the provider";
 var LLM_CANCEL_ALREADY_FINAL = "this call is already final";
@@ -23492,11 +23990,33 @@ var DEFAULT_SAMPLE_TIMEOUT_SEC = 180;
 function parseProviderKey(value) {
   return value === "ok" || value === "rejected" || value === "unknown" ? value : null;
 }
+function bpsOrNull(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : null;
+}
+function standingCreditGrantOrNull(value) {
+  if (!value || typeof value !== "object") return null;
+  const v = value;
+  const whole = (x) => typeof x === "number" && Number.isSafeInteger(x) && x >= 0;
+  if (!whole(v.minCredits) || !whole(v.maxCredits) || !whole(v.stepCredits) || !whole(v.defaultCredits)) return null;
+  return {
+    minCredits: v.minCredits,
+    maxCredits: v.maxCredits,
+    stepCredits: v.stepCredits,
+    defaultCredits: v.defaultCredits,
+    ...whole(v.minUsdCents) ? { minUsdCents: v.minUsdCents } : {},
+    ...whole(v.maxUsdCents) ? { maxUsdCents: v.maxUsdCents } : {},
+    ...whole(v.stepUsdCents) ? { stepUsdCents: v.stepUsdCents } : {}
+  };
+}
 async function readRuntimeLane(apiUrl, token) {
   const empty = (state) => ({
     state,
     models: null,
     recommendedDeclaredHeadroomBps: null,
+    currency: null,
+    feeBps: null,
+    usdCentsPerCredit: null,
+    standingCreditGrant: null,
     externalProviders: null,
     total: null,
     featuredCount: null,
@@ -23515,7 +24035,11 @@ async function readRuntimeLane(apiUrl, token) {
     return {
       state: "live",
       models: body.models,
-      recommendedDeclaredHeadroomBps: typeof body.recommendedDeclaredHeadroomBps === "number" && Number.isFinite(body.recommendedDeclaredHeadroomBps) ? body.recommendedDeclaredHeadroomBps : null,
+      recommendedDeclaredHeadroomBps: bpsOrNull(body.recommendedDeclaredHeadroomBps),
+      currency: body.currency === "credits" || body.currency === "coins" ? body.currency : null,
+      feeBps: bpsOrNull(body.feeBps),
+      usdCentsPerCredit: typeof body.usdCentsPerCredit === "number" && Number.isSafeInteger(body.usdCentsPerCredit) && body.usdCentsPerCredit >= 1 ? body.usdCentsPerCredit : null,
+      standingCreditGrant: standingCreditGrantOrNull(body.standingCreditGrant),
       externalProviders: Array.isArray(body.externalProviders) ? body.externalProviders : null,
       total: typeof body.total === "number" && Number.isFinite(body.total) ? body.total : null,
       featuredCount: typeof body.featuredCount === "number" && Number.isFinite(body.featuredCount) ? body.featuredCount : null,
@@ -23531,18 +24055,45 @@ function percentile2(values, p) {
   const rank2 = Math.ceil(p / 100 * sorted.length);
   return sorted[Math.min(sorted.length - 1, Math.max(0, rank2 - 1))];
 }
-function recommendEstimateCoins(p95, headroomBps) {
-  return Math.max(1, Math.ceil(p95 * (1e4 + headroomBps) / 1e4));
+function percentilePicos(values, p) {
+  if (values.length === 0) return null;
+  const sorted = [...values].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+  const rank2 = Math.ceil(p / 100 * sorted.length);
+  return sorted[Math.min(sorted.length - 1, Math.max(0, rank2 - 1))];
 }
-function recommendPerCallMaxCoins(p95, max, headroomBps) {
-  return Math.max(recommendEstimateCoins(p95, headroomBps), recommendEstimateCoins(max, headroomBps));
+var PICOS_PER_CENT = 10000000000n;
+function ceilingCreditsFor(costPicos, terms) {
+  if (costPicos <= 0n) return 1;
+  const num = costPicos * BigInt(1e4 + terms.feeBps) * BigInt(1e4 + terms.headroomBps);
+  const den = 100000000n * BigInt(terms.usdCentsPerCredit) * PICOS_PER_CENT;
+  return Math.max(1, Number((num + den - 1n) / den));
+}
+function averageCreditsPerCall(costsPicos, terms) {
+  if (costsPicos.length === 0) return null;
+  const sum = costsPicos.reduce((a, b) => a + b, 0n);
+  return Number(sum * BigInt(1e4 + terms.feeBps)) / Number(BigInt(costsPicos.length) * 10000n * BigInt(terms.usdCentsPerCredit) * PICOS_PER_CENT);
+}
+function perCallEstimateCreditsFor(costsPicos, terms) {
+  if (costsPicos.length === 0) return null;
+  const sum = costsPicos.reduce((a, b) => a + b, 0n);
+  const num = sum * BigInt(1e4 + terms.feeBps);
+  const den = BigInt(costsPicos.length) * 10000n * BigInt(terms.usdCentsPerCredit) * PICOS_PER_CENT;
+  return Math.max(1, Number((num + den - 1n) / den));
+}
+function formatCredits(value) {
+  if (!Number.isFinite(value)) return "\u2014";
+  if (value >= 100) return String(Math.round(value));
+  return String(Number(value.toPrecision(value < 1 ? 2 : 3)));
+}
+function usdFromPicos(picos) {
+  if (picos === null || picos === void 0) return "unknown";
+  const value = typeof picos === "bigint" ? picos : /^\d+$/.test(picos) ? BigInt(picos) : null;
+  if (value === null) return "unknown";
+  return `$${(Number(value) / 1e12).toFixed(6)}`;
 }
 function usdPerMillion(value) {
   return `$${value.toFixed(value < 1 ? 4 : 2)}`;
 }
-function usd(value) {
-  return value === null ? "unknown" : `$${value.toFixed(6)}`;
-}
 async function runLlm(opts = {}) {
   const log = createLogger({ quiet: opts.quiet || opts.json });
   const cwd = opts.cwd ?? process.cwd();
@@ -23568,16 +24119,23 @@ async function runLlm(opts = {}) {
     return;
   }
   if (sub === "bench") {
-    if (opts.maxCoins === void 0 || opts.userApproved !== true) {
+    if (opts.maxCoins !== void 0) process.stderr.write(`${c.yellow("!")} ${LLM_MAX_COINS_DEPRECATED}
+`);
+    if (opts.maxCoins !== void 0 && opts.maxCredits !== void 0 && opts.maxCoins !== opts.maxCredits) {
+      fail5("llm bench", `Pass --max-credits alone \u2014 --max-coins is its deprecated name, and the two disagree (${opts.maxCredits} vs ${opts.maxCoins}).`);
+      return;
+    }
+    const approvedCredits = opts.maxCredits ?? opts.maxCoins;
+    if (approvedCredits === void 0 || opts.userApproved !== true) {
       fail5("llm bench", LLM_BENCH_APPROVAL_REQUIRED);
       return;
     }
-    if (!Number.isInteger(opts.maxCoins) || opts.maxCoins < 1) {
-      fail5("llm bench", `--max-coins takes a whole number of coin, 1 or more (got ${String(opts.maxCoins)}).`);
+    if (!Number.isInteger(approvedCredits) || approvedCredits < 1) {
+      fail5("llm bench", `--max-credits takes a whole number of credits, 1 or more (got ${String(approvedCredits)}).`);
       return;
     }
     if (!opts.benchPrompt?.trim()) {
-      fail5("llm bench", '`genex llm bench` needs the prompt your game would send, e.g. genex llm bench "<prompt>" --max-coins <n> --user-approved.');
+      fail5("llm bench", '`genex llm bench` needs the prompt your game would send, e.g. genex llm bench "<prompt>" --max-credits <n> --user-approved.');
       return;
     }
     if (opts.jsonOutput && opts.textOutput) {
@@ -23669,6 +24227,10 @@ async function reportModels(apiUrl, token, opts, log, toolsOnly = false) {
         models: null,
         externalProviders: null,
         recommendedDeclaredHeadroomBps: null,
+        currency: null,
+        feeBps: null,
+        usdCentsPerCredit: null,
+        standingCreditGrant: null,
         total: null,
         featuredCount: null,
         // The stand was never asked, so the verdict is unknown — but the key is
@@ -23694,6 +24256,12 @@ async function reportModels(apiUrl, token, opts, log, toolsOnly = false) {
       models: lane.models,
       externalProviders: lane.externalProviders,
       recommendedDeclaredHeadroomBps: lane.recommendedDeclaredHeadroomBps,
+      // The credit terms a call is billed on, the server's — null on a stand
+      // that predates credit billing, never a number the CLI filled in.
+      currency: lane.currency,
+      feeBps: lane.feeBps,
+      usdCentsPerCredit: lane.usdCentsPerCredit,
+      standingCreditGrant: lane.standingCreditGrant,
       total: lane.total ?? lane.models?.length ?? null,
       featuredCount: lane.featuredCount ?? (lane.models ? lane.models.filter((m) => m.featured).length : null),
       // `null` when the lane is not live or the server predates the probe.
@@ -23740,8 +24308,9 @@ async function reportModels(apiUrl, token, opts, log, toolsOnly = false) {
   );
   for (const m of shown) {
     const plan = m.personalPlan ? `  \xB7  personal plan: ${m.personalPlan}` : "";
+    const kind = m.kind === "typesafe" ? "  \xB7  judge (classifier): judge() under a budget, not generate() or bench" : "";
     log.plain(
-      `    ${c.cyan(m.id)}  ${m.label} \u2014 ${usdPerMillion(m.inputUsdPerMillion)} in / ${usdPerMillion(m.outputUsdPerMillion)} out per million tokens${plan}`
+      `    ${c.cyan(m.id)}  ${m.label} \u2014 ${usdPerMillion(m.inputUsdPerMillion)} in / ${usdPerMillion(m.outputUsdPerMillion)} out per million tokens${plan}${kind}`
     );
   }
   if (hiddenCount > 0) {
@@ -23757,74 +24326,104 @@ async function reportModels(apiUrl, token, opts, log, toolsOnly = false) {
   }
   log.plain("");
   if (lane.recommendedDeclaredHeadroomBps === null) {
-    log.dim("  This stand serves no recommended headroom, so no price can be recommended from a bench.");
+    log.dim("  This stand serves no recommended headroom, so no ceiling can be recommended from a bench.");
+  } else {
+    log.dim(`  Recommended headroom over a benchmarked call's cost on this stand: ${lane.recommendedDeclaredHeadroomBps} bps.`);
+  }
+  if (lane.feeBps === null) {
+    log.dim("  This stand serves no platform fee \u2014 it predates credit billing, so no ceiling can be recommended from a bench.");
   } else {
-    log.dim(`  Recommended headroom over benchmarked coins on this stand: ${lane.recommendedDeclaredHeadroomBps} bps.`);
+    log.dim(`  In-game calls are billed in the player's credits, as used: the provider's cost plus this stand's platform fee (${lane.feeBps} bps).`);
   }
   if (toolsOnly) {
     printConvertHint();
     return;
   }
-  log.dim("  Those per-million rates are the PROVIDER's; what your game is charged is the platform");
-  log.dim(`  tariff on top, which only a real call reveals: ${c.cyan('genex llm bench "<prompt>" --max-coins <n> --user-approved')}`);
+  log.dim("  Those per-million rates are the PROVIDER's list; what one call of YOUR prompt really costs,");
+  log.dim(`  and the per-call ceiling to declare, only a real call measures: ${c.cyan('genex llm bench "<prompt>" --max-credits <n> --user-approved')}`);
 }
 function wholeOrNull(value) {
   return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : null;
 }
+function costPicosOf(usage) {
+  if (typeof usage?.costUsdPicos === "string" && /^\d+$/.test(usage.costUsdPicos)) return usage.costUsdPicos;
+  if (typeof usage?.costUsd === "number" && Number.isFinite(usage.costUsd) && usage.costUsd >= 0) {
+    return String(BigInt(Math.round(usage.costUsd * 1e12)));
+  }
+  return null;
+}
 function sampleFrom(id, settled) {
   const usage = settled?.usage;
+  const picos = costPicosOf(usage);
   return {
     id,
     status: settled?.status ?? null,
     billingStatus: settled?.billingStatus ?? null,
-    chargedCoins: typeof settled?.chargedCoins === "number" ? settled.chargedCoins : null,
-    costUsd: typeof usage?.costUsd === "number" ? usage.costUsd : null,
+    chargedCredits: wholeOrNull(settled?.chargedCredits),
+    costUsd: typeof usage?.costUsd === "number" ? usage.costUsd : picos !== null ? Number(picos) / 1e12 : null,
+    costUsdPicos: picos,
     error: settled?.error ?? (settled ? null : "timed_out"),
     providerMessage: typeof settled?.providerMessage === "string" && settled.providerMessage.trim() ? settled.providerMessage.trim() : null,
     inputTokens: wholeOrNull(usage?.inputTokens),
     outputTokens: wholeOrNull(usage?.outputTokens),
     maxOutputTokens: wholeOrNull(usage?.maxOutputTokens),
-    fitCoins: typeof usage?.fitCoins === "number" && Number.isSafeInteger(usage.fitCoins) && usage.fitCoins >= 1 ? usage.fitCoins : null,
+    fitCredits: typeof usage?.fitCredits === "number" && Number.isSafeInteger(usage.fitCredits) && usage.fitCredits >= 1 ? usage.fitCredits : null,
     fitExceedsCap: typeof usage?.fitExceedsCap === "boolean" ? usage.fitExceedsCap : null,
     truncated: typeof usage?.truncated === "boolean" ? usage.truncated : settled?.error === "provider_token_limit" ? true : null
   };
 }
 var PROVIDER_TOKEN_LIMIT = "provider_token_limit";
-function benchRecommendation(results, headroomBps) {
-  const settled = results.filter((r) => r.status === "succeeded" && r.billingStatus === "final" && typeof r.chargedCoins === "number");
-  const charged = settled.map((r) => r.chargedCoins);
-  const fits = settled.map((r) => r.fitCoins).filter((v) => typeof v === "number");
-  const p95 = percentile2(charged, 95);
-  const max = charged.length ? Math.max(...charged) : null;
+function benchRecommendation(results, terms) {
+  const settled = results.filter(
+    (r) => r.status === "succeeded" && r.billingStatus === "final" && r.chargedCredits !== null && r.costUsdPicos !== null
+  );
+  const costs = settled.map((r) => BigInt(r.costUsdPicos));
+  const charged = settled.map((r) => r.chargedCredits);
+  const fits = settled.map((r) => r.fitCredits).filter((v) => typeof v === "number");
+  const costP95 = percentilePicos(costs, 95);
+  const costMax = costs.length ? costs.reduce((a, b) => b > a ? b : a) : null;
   const fitP95 = percentile2(fits, 95);
   const fitMax = fits.length ? Math.max(...fits) : null;
   const exceedsStandCap = results.some((r) => r.fitExceedsCap === true);
   const cutOffSamples = results.filter((r) => r.error === PROVIDER_TOKEN_LIMIT && r.fitExceedsCap !== true).length;
   const noRecommendationReason = exceedsStandCap ? "answer_exceeds_stand_cap" : cutOffSamples > 0 ? "answer_cut_off" : null;
-  const chargedBased = p95 !== null && headroomBps !== null ? recommendEstimateCoins(p95, headroomBps) : null;
-  const recommended = chargedBased === null || noRecommendationReason !== null ? null : Math.max(chargedBased, fitP95 ?? 0);
-  const ceiling = recommended === null || p95 === null || max === null || headroomBps === null ? null : Math.max(recommendPerCallMaxCoins(p95, max, headroomBps), recommended, fitMax ?? 0);
+  const { headroomBps, feeBps, usdCentsPerCredit } = terms;
+  const missingTerms = headroomBps === null ? "headroom" : feeBps === null || usdCentsPerCredit === null ? "credit_terms" : null;
+  const full = headroomBps !== null && feeBps !== null && usdCentsPerCredit !== null ? { headroomBps, feeBps, usdCentsPerCredit } : null;
+  const billing = feeBps !== null && usdCentsPerCredit !== null ? { feeBps, usdCentsPerCredit } : null;
+  const costBased = full !== null && costP95 !== null ? ceilingCreditsFor(costP95, full) : null;
+  const recommended = costBased === null || noRecommendationReason !== null ? null : Math.max(costBased, fitP95 ?? 0);
+  const ceiling = recommended === null || costMax === null || full === null ? null : Math.max(ceilingCreditsFor(costMax, full), recommended, fitMax ?? 0);
+  const average = billing !== null ? averageCreditsPerCall(costs, billing) : null;
+  const estimate = ceiling === null || billing === null ? null : Math.min(ceiling, perCallEstimateCreditsFor(costs, billing) ?? 1);
   return {
+    costs,
     charged,
-    p50: percentile2(charged, 50),
-    p95,
-    max,
+    costP50: percentilePicos(costs, 50),
+    costP95,
+    costMax,
+    chargedP50: percentile2(charged, 50),
+    chargedP95: percentile2(charged, 95),
+    chargedMax: charged.length ? Math.max(...charged) : null,
     fits,
     fitP95,
     fitMax,
-    chargedBasedEstimateCoins: chargedBased,
-    recommendedEstimateCoins: recommended,
-    recommendedPerCallMaxCoins: ceiling,
-    lengthRaisedPrice: recommended !== null && chargedBased !== null && recommended > chargedBased,
+    costBasedMaxCredits: costBased,
+    recommendedMaxCredits: recommended,
+    recommendedPerCallMaxCredits: ceiling,
+    averageCreditsPerCall: average,
+    recommendedPerCallEstimateCredits: estimate,
+    lengthRaisedCeiling: recommended !== null && costBased !== null && recommended > costBased,
     cutOffSamples,
     exceedsStandCap,
-    noRecommendationReason
+    noRecommendationReason,
+    missingTerms
   };
 }
-var LLM_LENGTH_RAISED_LINE = "The declared price also pays for how long the answer may be: at the charged-based price the answer would be cut off, so declare this one.";
-var LLM_EXCEEDS_STAND_CAP_LINE = "No price recommended: this answer is longer than one call on this stand may produce. Ask for a shorter answer \u2014 fewer fields, shorter strings, a length the prompt states \u2014 and benchmark again.";
-function benchCutOffLine(cutOff, maxCoins) {
-  return `No price recommended: ${cutOff} sample${cutOff === 1 ? " was" : "s were"} cut off at this ceiling (--max-coins ${maxCoins}) before the answer was finished, so its real length is unknown. Re-run with a higher --max-coins.`;
+var LLM_LENGTH_RAISED_LINE = "The ceiling also decides how long the answer may be: at the cost-based ceiling the answer would be cut off, so declare this one.";
+var LLM_EXCEEDS_STAND_CAP_LINE = "No ceiling recommended: this answer is longer than one call on this stand may produce. Ask for a shorter answer \u2014 fewer fields, shorter strings, a length the prompt states \u2014 and benchmark again.";
+function benchCutOffLine(cutOff, maxCredits) {
+  return `No ceiling recommended: ${cutOff} sample${cutOff === 1 ? " was" : "s were"} cut off at this ceiling (--max-credits ${maxCredits}) before the answer was finished, so its real length is unknown. Re-run with a higher --max-credits.`;
 }
 var ACTIVE_STATUSES = /* @__PURE__ */ new Set(["requires_confirmation", "queued", "dispatching", "awaiting_external"]);
 function rowState(row) {
@@ -23835,7 +24434,22 @@ function rowState(row) {
 function rowHoldsSlot(row) {
   if (typeof row.slotHeld === "boolean") return row.slotHeld;
   const state = rowState(row);
-  return state === "active" || state === "awaiting bill" && (row.reservedCoins ?? 0) > 0;
+  return state === "active" || state === "awaiting bill" && ((row.reservedCoins ?? 0) > 0 || (row.reservedCredits ?? 0) > 0);
+}
+function rowMoney(row) {
+  const credits = row.currency === "credits" || row.currency === void 0 && typeof row.reservedCredits === "number" && typeof row.reservedCoins !== "number";
+  if (credits) {
+    return {
+      unit: "credits",
+      reserved: typeof row.reservedCredits === "number" ? row.reservedCredits : null,
+      charged: typeof row.chargedCredits === "number" ? row.chargedCredits : null
+    };
+  }
+  return {
+    unit: "coin",
+    reserved: typeof row.reservedCoins === "number" ? row.reservedCoins : null,
+    charged: typeof row.chargedCoins === "number" ? row.chargedCoins : null
+  };
 }
 function providerRefusalStatus(error) {
   const m = /^provider_http_(\d{3})$/.exec(error ?? "");
@@ -23854,7 +24468,7 @@ function formatAge(iso, now = Date.now()) {
 }
 async function runBench(args) {
   const { apiUrl, token, projectId, cwd, opts, log } = args;
-  const maxCoins = opts.maxCoins;
+  const maxCredits = opts.maxCredits ?? opts.maxCoins;
   const samples = opts.samples ?? DEFAULT_BENCH_SAMPLES;
   const prompt = opts.benchPrompt.trim();
   const auth = { Authorization: `Bearer ${token}`, "Content-Type": "application/json" };
@@ -23876,7 +24490,7 @@ async function runBench(args) {
   const lane = await readRuntimeLane(apiUrl, token);
   if (lane.state !== "live" || !lane.models || lane.models.length === 0) {
     if (lane.state === "off") {
-      if (opts.json) writeJsonLine({ ...emptyBenchJson(apiUrl, projectId, prompt, outputFormat, samples, maxCoins, opts), status: "off", error: null });
+      if (opts.json) writeJsonLine({ ...emptyBenchJson(apiUrl, projectId, prompt, outputFormat, samples, maxCredits, opts), status: "off", error: null });
       else {
         log.plain(LLM_LANE_OFF_LINE);
         log.dim("  Nothing was spent.");
@@ -23903,17 +24517,27 @@ async function runBench(args) {
     );
     return;
   }
-  const balanceBefore = await readCoinBalance(apiUrl, token);
+  const walletBefore = await fetchCreditsSnapshot(apiUrl, token);
+  if (walletBefore?.emailVerified === false) {
+    benchFailed(opts, log, LLM_BENCH_UNVERIFIED_LINE);
+    return;
+  }
+  if (walletBefore !== null && walletBefore.spendable < maxCredits) {
+    benchFailed(opts, log, benchBalanceShortLine(walletBefore.spendable, maxCredits));
+    return;
+  }
+  const balanceBefore = walletBefore?.spendable ?? null;
   if (!opts.json) {
     log.plain(c.bold("genex llm bench"));
     log.dim(`  ${apiUrl}`);
     log.plain("");
     log.plain(`  Model        ${c.cyan(modelId)}`);
     log.plain(`  Samples      ${samples} real attempt${samples === 1 ? "" : "s"}, ${outputFormat} output`);
-    log.plain(`  Approved     ${maxCoins} coin per attempt \u2014 at worst ${maxCoins * samples} coin for this run`);
+    log.plain(`  Approved     ${maxCredits} credit${maxCredits === 1 ? "" : "s"} per attempt \u2014 at worst ${maxCredits * samples} credits for this run, from your own balance`);
     log.plain(
-      `  Balance      ${balanceBefore === null ? "couldn't be read" : `${balanceBefore} coin spendable`}`
+      `  Balance      ${balanceBefore === null ? "couldn't be read" : `${balanceBefore} credits spendable`}`
     );
+    log.dim("  Billed as used: each attempt is charged its real cost plus the platform fee, rounded up to a whole credit.");
     log.plain("");
   }
   const base = `${apiUrl}/api/runtime/development/projects/${encodeURIComponent(projectId)}/generations`;
@@ -23939,7 +24563,7 @@ async function runBench(args) {
       const res = await call(base, {
         method: "POST",
         body: JSON.stringify({
-          maxCoins,
+          maxCredits,
           request: {
             idempotencyKey: `bench-${randomUUID2()}`,
             modelId,
@@ -23969,13 +24593,14 @@ async function runBench(args) {
       if (refusedAt !== null) providerRefused++;
       if (!opts.json) {
         const length = row.outputTokens !== null ? ` \xB7 ${row.outputTokens}${row.maxOutputTokens !== null ? ` of ${row.maxOutputTokens}` : ""} tokens out` : "";
+        const charged = row.chargedCredits === null ? "\u2014" : String(row.chargedCredits);
         log.plain(
-          `  ${row.status === "succeeded" ? c.green("\u2713") : c.yellow("!")} sample ${i + 1}  ${String(row.chargedCoins ?? "\u2014").padStart(4)} coin charged \xB7 provider ${usd(row.costUsd)}${length}${row.error ? ` \xB7 ${row.error}` : ""}`
+          `  ${row.status === "succeeded" ? c.green("\u2713") : c.yellow("!")} sample ${i + 1}  ${charged.padStart(4)} credit${row.chargedCredits === 1 ? "" : "s"} charged \xB7 cost ${usdFromPicos(row.costUsdPicos)}${length}${row.error ? ` \xB7 ${row.error}` : ""}`
         );
         if (refusedAt !== null) printProviderRefusal(log, refusedAt, row.providerMessage, row.status === "unknown");
         if (row.error === PROVIDER_TOKEN_LIMIT) {
           log.dim(
-            row.fitExceedsCap === true ? "      The answer was cut off at this stand's own output limit \u2014 no price makes room for it; it is not a sample." : `      The answer was cut off at this ceiling (--max-coins ${maxCoins}) before it was finished \u2014 it was charged, and it is not a sample.`
+            row.fitExceedsCap === true ? "      The answer was cut off at this stand's own output limit \u2014 no ceiling makes room for it; it is not a sample." : `      The answer was cut off at this ceiling (--max-credits ${maxCredits}) before it was finished \u2014 it was charged, and it is not a sample.`
           );
         }
       }
@@ -23983,16 +24608,19 @@ async function runBench(args) {
   } finally {
     process.removeListener("SIGINT", onSigint);
   }
-  const headroomBps = lane.recommendedDeclaredHeadroomBps;
-  const rec = benchRecommendation(results, headroomBps);
-  const { charged, p50, p95, max } = rec;
-  const settledCount = charged.length;
-  const recommended = rec.recommendedEstimateCoins;
-  const ceiling = rec.recommendedPerCallMaxCoins;
+  const terms = {
+    headroomBps: lane.recommendedDeclaredHeadroomBps,
+    feeBps: lane.feeBps,
+    usdCentsPerCredit: lane.usdCentsPerCredit
+  };
+  const rec = benchRecommendation(results, terms);
+  const settledCount = rec.charged.length;
   const lengthBlocked = rec.noRecommendationReason !== null;
-  const balanceAfter = await readCoinBalance(apiUrl, token);
+  const balanceAfter = (await fetchCreditsSnapshot(apiUrl, token))?.spendable ?? null;
+  const picosOrNull = (v) => v === null ? null : String(v);
   const record = {
-    v: 1,
+    v: 2,
+    currency: "credits",
     ranAt: (/* @__PURE__ */ new Date()).toISOString(),
     apiUrl,
     projectId,
@@ -24001,28 +24629,34 @@ async function runBench(args) {
     outputFormat,
     samples,
     completed: settledCount,
-    chargedCoins: charged,
-    p50,
-    p95,
-    max,
-    recommendedDeclaredHeadroomBps: headroomBps,
-    recommendedEstimateCoins: recommended,
-    recommendedPerCallMaxCoins: ceiling,
-    maxCoinsPerSample: maxCoins,
-    fitCoins: rec.fits,
+    maxCreditsPerSample: maxCredits,
+    costUsdPicos: rec.costs.map(String),
+    chargedCredits: rec.charged,
+    cost: { p50: picosOrNull(rec.costP50), p95: picosOrNull(rec.costP95), max: picosOrNull(rec.costMax) },
+    charged: { p50: rec.chargedP50, p95: rec.chargedP95, max: rec.chargedMax },
+    fitCredits: rec.fits,
     fitP95: rec.fitP95,
-    chargedBasedEstimateCoins: rec.chargedBasedEstimateCoins,
-    lengthRaisedPrice: rec.lengthRaisedPrice,
+    fitMax: rec.fitMax,
+    recommendedDeclaredHeadroomBps: terms.headroomBps,
+    feeBps: terms.feeBps,
+    usdCentsPerCredit: terms.usdCentsPerCredit,
+    costBasedMaxCredits: rec.costBasedMaxCredits,
+    recommendedMaxCredits: rec.recommendedMaxCredits,
+    recommendedPerCallMaxCredits: rec.recommendedPerCallMaxCredits,
+    averageCreditsPerCall: rec.averageCreditsPerCall,
+    recommendedPerCallEstimateCredits: rec.recommendedPerCallEstimateCredits,
+    lengthRaisedCeiling: rec.lengthRaisedCeiling,
     cutOffSamples: rec.cutOffSamples,
     noRecommendationReason: rec.noRecommendationReason
   };
   const savedTo = await saveBench(cwd, record);
   if (opts.json) {
-    const ok = charged.length > 0 && !lengthBlocked;
+    const ok = settledCount > 0 && !lengthBlocked;
     writeJsonLine({
       command: "llm bench",
       status: ok ? "ok" : "failed",
       error: ok ? null : rec.noRecommendationReason ?? "no_sample_settled",
+      currency: "credits",
       apiUrl,
       projectId,
       modelId,
@@ -24031,35 +24665,54 @@ async function runBench(args) {
       schemaPath: opts.schemaPath ?? null,
       samples,
       completed: settledCount,
-      maxCoinsPerSample: maxCoins,
+      maxCreditsPerSample: maxCredits,
+      // Spendable credits before and after the run; null when unreadable.
       balanceBefore,
       balanceAfter,
       results,
       // The create-time refusal that ended the run, or null. Beside the
       // samples, never among them: no attempt existed and nothing was spent.
       refusal: refusal2,
-      chargedCoins: { p50, p95, max },
-      // The answer's LENGTH, priced by the server per sample (`fitCoins`,
+      // Over the settled samples: the real provider cost (pico-dollar strings
+      // and USD) and the whole credits charged.
+      costUsdPicos: record.cost,
+      costUsd: {
+        p50: rec.costP50 === null ? null : Number(rec.costP50) / 1e12,
+        p95: rec.costP95 === null ? null : Number(rec.costP95) / 1e12,
+        max: rec.costMax === null ? null : Number(rec.costMax) / 1e12
+      },
+      chargedCredits: record.charged,
+      // The answer's LENGTH, priced by the server per sample (`fitCredits`,
       // headroom already on the tokens), over the settled samples.
-      fitCoins: { p95: rec.fitP95, max: rec.fitMax },
-      chargedBasedEstimateCoins: rec.chargedBasedEstimateCoins,
-      lengthRaisedPrice: rec.lengthRaisedPrice,
+      fitCredits: { p95: rec.fitP95, max: rec.fitMax },
+      recommendedDeclaredHeadroomBps: terms.headroomBps,
+      feeBps: terms.feeBps,
+      usdCentsPerCredit: terms.usdCentsPerCredit,
+      missingTerms: rec.missingTerms,
+      costBasedMaxCredits: rec.costBasedMaxCredits,
+      lengthRaisedCeiling: rec.lengthRaisedCeiling,
       cutOffSamples: rec.cutOffSamples,
       exceedsStandCap: rec.exceedsStandCap,
       noRecommendationReason: rec.noRecommendationReason,
-      recommendedDeclaredHeadroomBps: headroomBps,
-      recommendedEstimateCoins: recommended,
-      recommendedPerCallMaxCoins: ceiling,
+      recommendedMaxCredits: rec.recommendedMaxCredits,
+      recommendedPerCallMaxCredits: rec.recommendedPerCallMaxCredits,
+      averageCreditsPerCall: rec.averageCreditsPerCall,
+      recommendedPerCallEstimateCredits: rec.recommendedPerCallEstimateCredits,
       savedTo
     });
     if (!ok) process.exitCode = 1;
     return;
   }
   log.plain("");
+  const printMeasured = () => {
+    log.plain(c.bold("  Real cost per call"));
+    log.plain(`    p50 ${usdFromPicos(rec.costP50)}   p95 ${usdFromPicos(rec.costP95)}   max ${usdFromPicos(rec.costMax)}   (${settledCount} of ${samples} settled)`);
+    log.plain(c.bold("  Charged credits"));
+    log.plain(`    p50 ${rec.chargedP50}   p95 ${rec.chargedP95}   max ${rec.chargedMax}   (whole credits, rounded up per call)`);
+  };
   if (lengthBlocked) {
-    if (charged.length > 0) {
-      log.plain(c.bold("  Charged coins"));
-      log.plain(`    p50 ${p50}   p95 ${p95}   max ${max}   (${charged.length} of ${samples} settled)`);
+    if (settledCount > 0) {
+      printMeasured();
       log.plain("");
     }
     printRecommendation(log, record);
@@ -24067,17 +24720,16 @@ async function runBench(args) {
     process.exitCode = 1;
     return;
   }
-  if (charged.length === 0) {
+  if (settledCount === 0) {
     log.error(
-      providerRefused > 0 && providerRefused === results.length ? "  No sample ran \u2014 the provider refused every attempt at its door \u2014 so there is nothing to price from." : "  No sample settled, so there is nothing to price from."
+      providerRefused > 0 && providerRefused === results.length ? "  No sample ran \u2014 the provider refused every attempt at its door \u2014 so there is nothing to measure from." : "  No sample settled, so there is nothing to measure from."
     );
     process.exitCode = 1;
     return;
   }
-  log.plain(c.bold("  Charged coins"));
-  log.plain(`    p50 ${p50}   p95 ${p95}   max ${max}   (${charged.length} of ${samples} settled)`);
+  printMeasured();
   if (balanceBefore !== null && balanceAfter !== null) {
-    log.plain(`    Balance ${balanceBefore} \u2192 ${balanceAfter} coin spendable`);
+    log.plain(`    Balance ${balanceBefore} \u2192 ${balanceAfter} credits spendable`);
   }
   log.plain("");
   printRecommendation(log, record);
@@ -24089,43 +24741,58 @@ function printRecommendation(log, record) {
     return;
   }
   if (record.noRecommendationReason === "answer_cut_off") {
-    log.warn(`  ${benchCutOffLine(record.cutOffSamples ?? 1, record.maxCoinsPerSample ?? 0)}`);
+    log.warn(`  ${benchCutOffLine(record.cutOffSamples || 1, record.maxCreditsPerSample)}`);
     return;
   }
-  if (record.recommendedEstimateCoins === null || record.p95 === null) {
-    log.warn("  No price recommended.");
+  const attempts = `${record.completed} settled attempt${record.completed === 1 ? "" : "s"} on ${record.modelId}`;
+  if (record.recommendedMaxCredits === null || record.cost.p95 === null) {
+    log.warn("  No ceiling recommended.");
     log.dim(
-      record.recommendedDeclaredHeadroomBps === null ? "  This stand served no recommended headroom, and the multiplier is the server's to set \u2014" : "  No sample settled, so there is no p95 to build a price on \u2014"
+      record.cost.p95 === null ? "  No sample settled, so there is no p95 to build a ceiling on \u2014" : record.recommendedDeclaredHeadroomBps === null ? "  This stand served no recommended headroom, and the multiplier is the server's to set \u2014" : "  This stand served no platform fee or credit value, and those are the server's to set \u2014"
     );
     log.dim("  declaring a number from this run would be a guess dressed as a measurement.");
+    printAverage(log, record, attempts);
     return;
   }
-  log.plain(c.bold(`  Declare estimateCoins: ${record.recommendedEstimateCoins}`));
-  if (record.lengthRaisedPrice) {
+  log.plain(c.bold(`  Declare maxCredits: ${record.recommendedMaxCredits}`));
+  if (record.lengthRaisedCeiling) {
     log.plain(`  ${LLM_LENGTH_RAISED_LINE}`);
     log.dim(
-      `  = the smallest price whose answer allowance holds the answer plus this stand's headroom (p95 ${record.fitP95 ?? "\u2014"}), above the`
+      `  = the smallest ceiling whose answer allowance holds the answer plus this stand's headroom (p95 ${record.fitP95 ?? "\u2014"}), above the`
     );
     log.dim(
-      `  charged-based ${record.chargedBasedEstimateCoins ?? "\u2014"} (p95 of charged coins ${record.p95} plus ${record.recommendedDeclaredHeadroomBps} bps), over ${record.completed} settled attempt${record.completed === 1 ? "" : "s"} on ${record.modelId}.`
+      `  cost-based ${record.costBasedMaxCredits ?? "\u2014"} (p95 real cost ${usdFromPicos(record.cost.p95)} with the platform fee, ${record.feeBps} bps, and ${record.recommendedDeclaredHeadroomBps} bps of headroom), over ${attempts}.`
     );
   } else {
     log.dim(
-      `  = p95 of charged coins (${record.p95}) plus this stand's recommended headroom (${record.recommendedDeclaredHeadroomBps} bps),`
+      `  = p95 real cost (${usdFromPicos(record.cost.p95)}) with this stand's platform fee (${record.feeBps} bps) and recommended headroom (${record.recommendedDeclaredHeadroomBps} bps), in whole credits,`
     );
-    log.dim(`  measured over ${record.completed} settled attempt${record.completed === 1 ? "" : "s"} on ${record.modelId}.`);
+    log.dim(`  measured over ${attempts}.`);
   }
-  log.dim("  That number is a PRICE: a started attempt is charged in full, including one that fails.");
-  if (record.recommendedPerCallMaxCoins != null) {
-    log.plain(c.bold(`  Grant perCallMaxCoins: ${record.recommendedPerCallMaxCoins}`));
+  log.dim("  That number is a CEILING, not a price: a call is billed its real cost as used, never more than it \u2014");
+  log.dim("  and it also sizes how long the answer may be.");
+  if (record.recommendedPerCallMaxCredits !== null) {
+    log.plain(c.bold(`  Grant perCallMaxCredits: ${record.recommendedPerCallMaxCredits}`));
     log.dim(
-      record.lengthRaisedPrice ? `  = the same headroom over the worst sample (${record.max}) or the longest answer's price, whichever is larger, and never below the price above it.` : `  = the same headroom over the worst sample (${record.max}), and never below the price above it.`
+      record.lengthRaisedCeiling ? `  = the same over the worst sample (${usdFromPicos(record.cost.max)}) or the longest answer's ceiling, whichever is larger, and never below the ceiling above it.` : `  = the same over the worst sample (${usdFromPicos(record.cost.max)}), and never below the ceiling above it.`
     );
-    log.dim("  The ceiling is the price's room to be wrong; declaring one under the price is refused.");
+  }
+  printAverage(log, record, attempts);
+}
+function printAverage(log, record, attempts) {
+  if (record.averageCreditsPerCall === null) return;
+  log.plain(`  Per-call estimate: about ${formatCredits(record.averageCreditsPerCall)} credits per call`);
+  log.dim(`  = the average real cost with the platform fee, no headroom, over ${attempts}.`);
+  if (record.recommendedPerCallEstimateCredits !== null) {
+    log.plain(c.bold(`  Grant perCallEstimateCredits: ${record.recommendedPerCallEstimateCredits}`));
+    log.dim(`  = that average rounded up to a whole credit. disclosure.estimatedCreditsPerPeriod = your calls per period \xD7 ${formatCredits(record.averageCreditsPerCall)}, rounded up.`);
   }
 }
 async function explainBenchRefusal(res, call, base, log, opts, index, settledSoFar) {
-  if (printedStructuredError(res)) return { stop: true, refusal: { status: res.status, error: null, slotsHeld: null, slotLimit: null } };
+  if (printedStructuredError(res)) {
+    const printed = await res.json().catch(() => ({}));
+    return { stop: true, refusal: { status: res.status, error: typeof printed.error === "string" ? printed.error : null, slotsHeld: null, slotLimit: null } };
+  }
   const body = await res.json().catch(() => ({}));
   const refusal2 = { status: res.status, error: body.error ?? null, slotsHeld: null, slotLimit: null };
   if (res.status === 429 && body.error === "generation_limit") {
@@ -24135,6 +24802,10 @@ async function explainBenchRefusal(res, call, base, log, opts, index, settledSoF
     if (!opts.json) log.error(`  Sample ${index + 1} ${benchSlotsHeldSentence(counts)}`);
     return { stop: true, refusal: refusal2 };
   }
+  if (res.status === 403 && body.error === "credits_unverified") {
+    if (!opts.json) log.error(`  ${LLM_BENCH_UNVERIFIED_LINE}`);
+    return { stop: true, refusal: refusal2 };
+  }
   if (opts.json) return { stop: res.status !== 429, refusal: refusal2 };
   if (res.status === 404 && body.error === "not_found") {
     log.error(`  ${LLM_LANE_OFF_LINE}`);
@@ -24150,7 +24821,7 @@ async function explainBenchRefusal(res, call, base, log, opts, index, settledSoF
     return { stop: true, refusal: refusal2 };
   }
   if (res.status === 402) {
-    log.error("  Not enough coin to start the attempt.");
+    log.error("  Not enough credits to start the attempt \u2014 a bench is paid from your own balance.");
     return { stop: true, refusal: refusal2 };
   }
   log.error(
@@ -24159,7 +24830,7 @@ async function explainBenchRefusal(res, call, base, log, opts, index, settledSoF
   return { stop: res.status >= 500 || res.status === 401 || res.status === 403, refusal: refusal2 };
 }
 function printProviderRefusal(log, status2, message, awaitingBill = false) {
-  if (awaitingBill) log.dim(`      The provider answered ${status2} after routing \u2014 its bill is not final, so this call's coin stays held until it resolves (see \`genex llm status\`); it is not a sample.`);
+  if (awaitingBill) log.dim(`      The provider answered ${status2} after routing \u2014 its bill is not final, so what this call reserved stays held until it resolves (see \`genex llm status\`); it is not a sample.`);
   else log.dim("      The provider refused this call at its door \u2014 no inference ran, it cost nothing, and it is not a sample.");
   if (message) log.dim(`      Provider said: ${message}`);
   if (status2 === 401 || status2 === 403) {
@@ -24185,19 +24856,6 @@ async function pollSettled(call, url, timeoutSec) {
   }
   return last;
 }
-async function readCoinBalance(apiUrl, token) {
-  try {
-    const res = await apiFetch(`${apiUrl}/api/coin/balance`, {
-      headers: { Authorization: `Bearer ${token}` },
-      signal: AbortSignal.timeout(6e3)
-    });
-    if (!res.ok) return null;
-    const body = await res.json().catch(() => null);
-    return typeof body?.spendable === "number" ? body.spendable : null;
-  } catch {
-    return null;
-  }
-}
 async function saveBench(cwd, record) {
   try {
     const file = path36.join(cwd, LLM_BENCH_FILE);
@@ -24213,9 +24871,10 @@ function benchFailed(opts, log, message) {
   else log.error(message);
   process.exitCode = 1;
 }
-function emptyBenchJson(apiUrl, projectId, prompt, outputFormat, samples, maxCoins, opts) {
+function emptyBenchJson(apiUrl, projectId, prompt, outputFormat, samples, maxCredits, opts) {
   return {
     command: "llm bench",
+    currency: "credits",
     apiUrl,
     projectId,
     modelId: opts.modelId ?? null,
@@ -24224,21 +24883,28 @@ function emptyBenchJson(apiUrl, projectId, prompt, outputFormat, samples, maxCoi
     schemaPath: opts.schemaPath ?? null,
     samples,
     completed: 0,
-    maxCoinsPerSample: maxCoins,
+    maxCreditsPerSample: maxCredits,
     balanceBefore: null,
     balanceAfter: null,
     results: [],
     refusal: null,
-    chargedCoins: { p50: null, p95: null, max: null },
-    fitCoins: { p95: null, max: null },
-    chargedBasedEstimateCoins: null,
-    lengthRaisedPrice: false,
+    costUsdPicos: { p50: null, p95: null, max: null },
+    costUsd: { p50: null, p95: null, max: null },
+    chargedCredits: { p50: null, p95: null, max: null },
+    fitCredits: { p95: null, max: null },
+    recommendedDeclaredHeadroomBps: null,
+    feeBps: null,
+    usdCentsPerCredit: null,
+    missingTerms: null,
+    costBasedMaxCredits: null,
+    lengthRaisedCeiling: false,
     cutOffSamples: 0,
     exceedsStandCap: false,
     noRecommendationReason: null,
-    recommendedDeclaredHeadroomBps: null,
-    recommendedEstimateCoins: null,
-    recommendedPerCallMaxCoins: null,
+    recommendedMaxCredits: null,
+    recommendedPerCallMaxCredits: null,
+    averageCreditsPerCall: null,
+    recommendedPerCallEstimateCredits: null,
     savedTo: null
   };
 }
@@ -24301,7 +24967,8 @@ async function reportStatus(args) {
     for (const row of rows) {
       const state = rowState(row);
       const mark = state === "active" ? c.cyan("\u25CF") : state === "awaiting bill" ? c.yellow("\u25D0") : c.green("\u25CB");
-      const reserved = typeof row.reservedCoins === "number" ? `${row.reservedCoins} coin reserved` : "reserved \u2014";
+      const money2 = rowMoney(row);
+      const reserved = money2.reserved === null ? "reserved \u2014" : `${money2.reserved} ${money2.unit} reserved`;
       log.plain(
         `  ${mark} ${row.id ?? "?"}  ${row.modelId ?? "?"}  ${state.padEnd(13)}  ${formatAge(row.createdAt, now).padStart(4)} old  ${reserved}${row.error ? `  ${row.error}` : ""}${rowHoldsSlot(row) ? "" : c.dim("  (no slot)")}`
       );
@@ -24373,10 +25040,11 @@ async function cancelCall(args) {
     if (!opts.json) {
       log.warn(`  ${row.id} (${row.status ?? "?"}) \u2014 ${sentence}.`);
       if (state === "awaiting bill") {
-        log.dim(`  Nothing to cancel: its coin releases when the bill resolves, and it stops holding a slot ${PENDING_SLOT_RELEASE_MINUTES} minutes after dispatch.`);
+        log.dim(`  Nothing to cancel: what it reserved releases when the bill resolves, and it stops holding a slot ${PENDING_SLOT_RELEASE_MINUTES} minutes after dispatch.`);
         if (row.providerMessage?.trim()) log.dim(`  Provider said: ${row.providerMessage.trim()}`);
       } else {
-        log.dim(`  ${typeof row.chargedCoins === "number" ? `${row.chargedCoins} coin charged` : "charge unknown"}${row.error ? ` \xB7 ${row.error}` : ""}.`);
+        const money2 = rowMoney(row);
+        log.dim(`  ${money2.charged === null ? "charge unknown" : `${money2.charged} ${money2.unit} charged`}${row.error ? ` \xB7 ${row.error}` : ""}.`);
       }
     }
     return done("ok", null, state === "awaiting bill" ? "awaiting_bill" : "already_final", row);
@@ -24398,78 +25066,126 @@ async function cancelCall(args) {
   const after = await res.json().catch(() => null) ?? row;
   if (!opts.json) {
     log.success(`  Cancelled ${row.id} (was ${row.status ?? "active"}).`);
-    log.dim(`  Its coin releases once the bill settles; ${c.cyan("genex llm status")} shows it until then.`);
+    log.dim(`  What it reserved releases once the bill settles; ${c.cyan("genex llm status")} shows it until then.`);
   }
   return done("ok", null, "cancelled", after);
 }
-async function reportSavedPrice(cwd, opts, log) {
-  let record = null;
+async function readSavedBench(cwd) {
+  let parsed;
   try {
-    record = JSON.parse(await fs35.readFile(path36.join(cwd, LLM_BENCH_FILE), "utf8"));
+    parsed = JSON.parse(await fs35.readFile(path36.join(cwd, LLM_BENCH_FILE), "utf8"));
   } catch {
-    record = null;
+    return null;
   }
-  if (!record) {
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
+  const v = parsed;
+  if (v.v === 2 && v.currency === "credits" && v.cost && v.charged) return { kind: "credits", record: parsed };
+  return { kind: "coins", record: parsed };
+}
+var LLM_PRICE_COIN_TERMS_LINE = "This bench was measured under the old COIN terms, when a game declared a fixed price per call. In-game calls are now billed in the player's credits, as used, and a game declares a per-call CEILING (maxCredits) instead \u2014 a coin price is not that number. Re-run the bench for the figures to declare.";
+async function reportSavedPrice(cwd, opts, log) {
+  const saved = await readSavedBench(cwd);
+  const rerun = 'genex llm bench "<prompt>" --max-credits <n> --user-approved';
+  const creditKeys = (record2) => ({
+    costUsdPicos: record2?.cost ?? { p50: null, p95: null, max: null },
+    chargedCredits: record2?.charged ?? { p50: null, p95: null, max: null },
+    fitP95: record2?.fitP95 ?? null,
+    fitMax: record2?.fitMax ?? null,
+    recommendedDeclaredHeadroomBps: record2?.recommendedDeclaredHeadroomBps ?? null,
+    feeBps: record2?.feeBps ?? null,
+    usdCentsPerCredit: record2?.usdCentsPerCredit ?? null,
+    costBasedMaxCredits: record2?.costBasedMaxCredits ?? null,
+    lengthRaisedCeiling: record2?.lengthRaisedCeiling ?? false,
+    cutOffSamples: record2?.cutOffSamples ?? 0,
+    noRecommendationReason: record2?.noRecommendationReason ?? null,
+    recommendedMaxCredits: record2?.recommendedMaxCredits ?? null,
+    recommendedPerCallMaxCredits: record2?.recommendedPerCallMaxCredits ?? null,
+    averageCreditsPerCall: record2?.averageCreditsPerCall ?? null,
+    recommendedPerCallEstimateCredits: record2?.recommendedPerCallEstimateCredits ?? null
+  });
+  if (!saved) {
     if (opts.json) {
       writeJsonLine({
         command: "llm price",
         status: "failed",
         error: "no_bench",
+        currency: null,
         ranAt: null,
         modelId: null,
         samples: null,
         completed: null,
-        p50: null,
-        p95: null,
-        max: null,
-        fitP95: null,
-        chargedBasedEstimateCoins: null,
-        lengthRaisedPrice: false,
-        cutOffSamples: 0,
-        noRecommendationReason: null,
-        recommendedDeclaredHeadroomBps: null,
-        recommendedEstimateCoins: null,
-        recommendedPerCallMaxCoins: null,
+        ...creditKeys(null),
+        legacyCoinTerms: null,
         savedTo: null
       });
     } else {
       log.error("Nothing has been benchmarked in this folder yet.");
-      log.dim(`  Run ${c.cyan('genex llm bench "<prompt>" --max-coins <n> --user-approved')} first.`);
+      log.dim(`  Run ${c.cyan(rerun)} first.`);
+    }
+    process.exitCode = 1;
+    return;
+  }
+  if (saved.kind === "coins") {
+    const old = saved.record;
+    const legacy = {
+      p50: old.p50 ?? null,
+      p95: old.p95 ?? null,
+      max: old.max ?? null,
+      recommendedEstimateCoins: old.recommendedEstimateCoins ?? null,
+      recommendedPerCallMaxCoins: old.recommendedPerCallMaxCoins ?? null,
+      maxCoinsPerSample: old.maxCoinsPerSample ?? null,
+      noRecommendationReason: old.noRecommendationReason ?? null
+    };
+    if (opts.json) {
+      writeJsonLine({
+        command: "llm price",
+        status: "failed",
+        error: "coin_terms",
+        currency: "coins",
+        ranAt: old.ranAt ?? null,
+        modelId: old.modelId ?? null,
+        samples: old.samples ?? null,
+        completed: old.completed ?? null,
+        ...creditKeys(null),
+        legacyCoinTerms: legacy,
+        savedTo: LLM_BENCH_FILE
+      });
+    } else {
+      log.plain(c.bold("genex llm price"));
+      log.dim(`  from ${LLM_BENCH_FILE}, benchmarked ${old.ranAt ?? "at an unknown time"}${old.modelId ? ` on ${old.modelId}` : ""}`);
+      log.plain("");
+      log.warn(`  ${LLM_PRICE_COIN_TERMS_LINE}`);
+      const measured = legacy.p95 === null ? "no settled sample" : `charged coins p50 ${legacy.p50} \xB7 p95 ${legacy.p95} \xB7 max ${legacy.max}`;
+      const recommended = legacy.recommendedEstimateCoins === null ? "no price recommended" : `it recommended estimateCoins ${legacy.recommendedEstimateCoins}${legacy.recommendedPerCallMaxCoins != null ? ` and perCallMaxCoins ${legacy.recommendedPerCallMaxCoins}` : ""}`;
+      log.dim(`  What it measured then: ${measured}; ${recommended}.`);
+      log.dim(`  Re-run: ${c.cyan(rerun)}`);
     }
     process.exitCode = 1;
     return;
   }
+  const record = saved.record;
   if (opts.json) {
     writeJsonLine({
       command: "llm price",
-      status: record.recommendedEstimateCoins === null ? "failed" : "ok",
-      error: record.recommendedEstimateCoins === null ? record.noRecommendationReason ?? "no_recommendation" : null,
+      status: record.recommendedMaxCredits === null ? "failed" : "ok",
+      error: record.recommendedMaxCredits === null ? record.noRecommendationReason ?? "no_recommendation" : null,
+      currency: "credits",
       ranAt: record.ranAt ?? null,
       modelId: record.modelId ?? null,
       samples: record.samples ?? null,
       completed: record.completed ?? null,
-      p50: record.p50 ?? null,
-      p95: record.p95 ?? null,
-      max: record.max ?? null,
-      // Absent from a file an older CLI wrote; null / false / 0 then, never missing.
-      fitP95: record.fitP95 ?? null,
-      chargedBasedEstimateCoins: record.chargedBasedEstimateCoins ?? null,
-      lengthRaisedPrice: record.lengthRaisedPrice ?? false,
-      cutOffSamples: record.cutOffSamples ?? 0,
-      noRecommendationReason: record.noRecommendationReason ?? null,
-      recommendedDeclaredHeadroomBps: record.recommendedDeclaredHeadroomBps ?? null,
-      recommendedEstimateCoins: record.recommendedEstimateCoins ?? null,
-      recommendedPerCallMaxCoins: record.recommendedPerCallMaxCoins ?? null,
+      ...creditKeys(record),
+      legacyCoinTerms: null,
       savedTo: LLM_BENCH_FILE
     });
-    if (record.recommendedEstimateCoins === null) process.exitCode = 1;
+    if (record.recommendedMaxCredits === null) process.exitCode = 1;
     return;
   }
   log.plain(c.bold("genex llm price"));
   log.dim(`  from ${LLM_BENCH_FILE}, benchmarked ${record.ranAt}`);
   log.plain("");
   printRecommendation(log, record);
-  if (record.recommendedEstimateCoins === null) process.exitCode = 1;
+  if (record.recommendedMaxCredits === null) process.exitCode = 1;
 }
 function writeJsonLine(value) {
   process.stdout.write(`${JSON.stringify(value)}
@@ -24729,7 +25445,7 @@ function runtimeRow(state, lane, toolsOnly = false) {
       return {
         label: "Runtime",
         value: `in-game LLM lane live \xB7 ${n} model${n === 1 ? "" : "s"}${keyRefused ? ` \xB7 ${c.yellow("provider key refused")}` : ""}`,
-        fix: keyRefused ? LLM_PROVIDER_KEY_REJECTED_LINE : toolsOnly ? convertFix : 'Price a call before a game declares one: `npx genex llm bench "<prompt>" --max-coins <n> --user-approved`.'
+        fix: keyRefused ? LLM_PROVIDER_KEY_REJECTED_LINE : toolsOnly ? convertFix : 'Measure a call before a game declares its per-call ceiling: `npx genex llm bench "<prompt>" --max-credits <n> --user-approved`.'
       };
     }
     case "off":
@@ -26685,16 +27401,16 @@ ${c.bold("Usage")}
                                      status | cancel. "models" says whether this
                                      stand serves the runtime LLM lane at all, and
                                      at what provider rates. "bench" runs the real
-                                     model on YOUR OWN coin and reports what each
-                                     attempt was charged; it needs --max-coins <n>
+                                     model on YOUR OWN credits and reports what each
+                                     attempt really cost; it needs --max-credits <n>
                                      --user-approved, like any spend the player has
                                      to agree to. "price" reprints the last run's
-                                     recommended estimateCoins. "status" lists this
+                                     recommended maxCredits. "status" lists this
                                      project's open calls and the slots they hold;
                                      "cancel <id>" stops an active one. Declare a
-                                     game's price from a bench, never from a guess:
-                                     a started attempt is charged in full, including
-                                     one that fails.
+                                     game's per-call ceiling from a bench, never
+                                     from a guess: the player is billed as used, and
+                                     the ceiling also sizes how long an answer may be.
   genex player <sub> [options]       Answer the in-game model requests you approve, on your
                                      OWN Claude or ChatGPT subscription: install | run |
                                      status | stop | uninstall. "install" signs this machine
@@ -27149,7 +27865,7 @@ ${c.bold("Examples")}
   genex shop remove sku_123
   genex llm models
   genex llm models --all
-  genex llm bench "Reply with one short taunt." --samples 5 --max-coins 20 --user-approved
+  genex llm bench "Reply with one short taunt." --samples 5 --max-credits 20 --user-approved
   genex llm price
   genex llm status
   genex llm cancel <id>
@@ -27386,22 +28102,24 @@ ${c.bold("How the allowance works")}
 
   Every number printed is live from your account; prices can change without a deploy.
 `,
-  llm: `${c.bold("genex llm")} \u2014 in-game model calls: is the lane live, what does one call cost, what should the game declare?
+  llm: `${c.bold("genex llm")} \u2014 in-game model calls: is the lane live, what does one call cost, what ceiling should the game declare?
 
 ${c.bold("Usage")}
   genex llm models [--all] [--json]  Which models this stand serves, their provider rates per
-                                     million tokens, and the headroom it recommends over a
-                                     benchmark. The catalog is synced from OpenRouter, so the
-                                     FEATURED short list is printed by default and --all
-                                     prints every row (--json always carries every row). Off
-                                     on this stand: it says so and exits 0 \u2014 build the feature
-                                     without a model rather than promising a 404.
-  genex llm bench "<prompt>" --max-coins <n> --user-approved [options]
-                                     Run the real model <n> times through the development
-                                     lane and report what each attempt was CHARGED. Refused
-                                     without both flags, before any network call: this spends
-                                     YOUR OWN COIN, a wallet the build's asset allowance
-                                     cannot see. Needs a folder linked to a game you own.
+                                     million tokens, the platform fee a call is billed at, and
+                                     the headroom it recommends over a benchmark. The catalog
+                                     is synced from OpenRouter, so the FEATURED short list is
+                                     printed by default and --all prints every row (--json
+                                     always carries every row). Off on this stand: it says so
+                                     and exits 0 \u2014 build the feature without a model rather
+                                     than promising a 404.
+  genex llm bench "<prompt>" --max-credits <n> --user-approved [options]
+                                     Run the real model through the development lane and
+                                     report what each attempt really COST and was charged.
+                                     Refused without both flags, before any network call:
+                                     this spends YOUR OWN CREDITS, a spend the build's asset
+                                     allowance does not count. Needs a folder linked to a
+                                     game you own, and a balance that covers one attempt.
   genex llm price [--json]           The recommendation from the last bench in this folder.
                                      Reads a file; spends nothing.
   genex llm status [--json]          This project's open development calls: active, or
@@ -27418,29 +28136,32 @@ ${c.bold("Bench options")}
   --samples <n>        How many real attempts (default ${DEFAULT_BENCH_SAMPLES}). More samples, better p95.
   --schema <file>      A JSON file holding the output schema; implies JSON output.
   --json-output        Ask for JSON without a schema.   --text  Ask for text (the default).
-  --max-coins <n>      The per-attempt ceiling YOU approved \u2014 a bench runs on your own coin,
+  --max-credits <n>    The per-attempt ceiling YOU approved \u2014 a bench runs on your own credits,
                        never a player's. The run's worst case is that number times --samples,
-                       and it is printed before anything starts.
+                       and it is printed before anything starts. (--max-coins is its deprecated
+                       name, read as the same number.)
   --timeout <seconds>  Bounds the wait for each attempt.
   --json               One machine-readable object; every key is always present, null when
                        the CLI could not learn it.
 
 ${c.bold("Why a benchmark and not an estimate")}
-  \`estimateCoins\` is a PRICE, not a guess: declaring it charges it, in full, even when the
-  attempt fails, is cancelled, or stops at its budget. And three layers sit between the
-  provider's rate card and that number \u2014 the provider's cost, the platform's tariff (already
-  inside every charged coin), and your headroom. The bench itself is billed to YOU, on the
-  development lane; the player-funded lane is what the published game uses. Adding a margin
-  to the provider's rate silently drops the tariff and under-prices every call, so the
-  recommendation is built from CHARGED COINS and the headroom comes from the server. A stand
-  that serves no headroom gets no recommendation, because the multiplier is not the CLI's to
-  invent.
+  An in-game call is paid from the PLAYER's credits and billed as used: its real provider cost
+  plus the platform fee, never more than the per-call CEILING the game declares (\`maxCredits\`,
+  or \`perCallMaxCredits\` on a standing budget). The ceiling is not a price, but it is still a
+  number with two jobs: it bounds what one call may cost, and it funds how LONG the answer may
+  be. Three layers sit between the provider's rate card and it \u2014 the provider's cost for YOUR
+  prompt, the platform fee, and your headroom \u2014 and only a real call measures the first. The
+  bench is billed to YOU, on the development lane; the player-funded lane is what the
+  published game uses. The recommendation is the p95 real cost with the server's fee and
+  headroom applied, in whole credits; a stand that serves no headroom or no fee gets no
+  recommendation, because those multipliers are not the CLI's to invent.
 
-  The declared price also decides how LONG the answer may be: it sizes each call's output
-  allowance. So the recommendation is never below the smallest price that leaves room for
-  the benchmarked answer, as the server computes it. A sample cut off at your --max-coins
-  (provider_token_limit) is not a sample \u2014 re-run with a higher --max-coins; an answer longer
-  than one call on this stand may produce gets no price at all \u2014 ask for a shorter one.
+  Because the ceiling sizes each call's output allowance, the recommendation is never below
+  the smallest ceiling that leaves room for the benchmarked answer, as the server computes it.
+  A sample cut off at your --max-credits (provider_token_limit) is not a sample \u2014 re-run with a
+  higher --max-credits; an answer longer than one call on this stand may produce gets no
+  ceiling at all \u2014 ask for a shorter one. The run also prints the measured average per call,
+  fee included, which is the honest estimate a budget's disclosure is built on.
 
   Results land in ${LLM_BENCH_FILE} \u2014 gitignored, machine-local, re-read by \`genex llm price\`.
 `,
@@ -27655,11 +28376,13 @@ function parseArgs(argv) {
     "--limit",
     // `genex budget --assets <credits>` — the allowance the player approved.
     "--assets",
-    // `genex llm bench` value flags. `--max-coins` is the COIN half of the
-    // same approval shape as `--assets` (a different economy, its own gate).
+    // `genex llm bench` value flags. `--max-credits` is the same approval
+    // shape as `--assets`, but its own gate: the asset allowance does not
+    // count a bench. `--max-coins` is its deprecated name (same number).
     "--model",
     "--samples",
     "--schema",
+    "--max-credits",
     "--max-coins",
     // `genex player install --label <name>` — what this machine is called in
     // the dashboard. Its own key rather than the generic 2nd positional,
@@ -28174,12 +28897,14 @@ function applyValueFlag(options, flag, value) {
       options.samples = n;
       break;
     }
+    case "--max-credits":
     case "--max-coins": {
       const n = Number(value);
       if (!Number.isInteger(n) || n < 1) {
-        throw new Error(`Invalid --max-coins value: ${value} (whole coin, 1 or more)`);
+        throw new Error(`Invalid ${flag} value: ${value} (whole credits, 1 or more)`);
       }
-      options.maxCoins = n;
+      if (flag === "--max-credits") options.maxCredits = n;
+      else options.maxCoins = n;
       break;
     }
     case "--timeout": {
@@ -28471,9 +29196,9 @@ async function main() {
         await runBudget(parsed.options);
         break;
       // The in-game model lane: is it live here, what does one call really
-      // cost, what should the game declare. `bench` is the only CLI command
-      // that spends COIN, so it carries its own --max-coins/--user-approved
-      // gate — the credits allowance cannot see that wallet.
+      // cost, what ceiling should the game declare. `bench` spends the
+      // builder's own credits OUTSIDE the asset allowance, so it carries its
+      // own --max-credits/--user-approved gate.
       case "llm":
         await runLlm(parsed.options);
         break;