@genex-ai/cli-demo 1.36.15-dev.1036 → 1.36.16-dev.1039

package/dist/index.js

@@ -1129,12 +1129,12 @@ Important note: put soul into your creations, with many details and love. Aim to
 16. Never add debug-only code that fakes gameplay \u2014 no hidden test modes, special URL parameters, forced-visible flags or auth mocks. The visual-validation skill permits a development-only final-mix analyser for a deliberately triggered audible event; remove it from published builds. The \`genex-cover\` skill's development-only cover shot (\`?cover=<name>\` on the dev server) is a camera, not a bypass: it never reaches a published build, never touches sign-in, saves or progress, and is never evidence that the game works. \`?genex_local_test=1\` is the platform's own supported mode and is fine; your own bypass is not. (The multiplayer skill's small build identifier, token-free status line, and connected-quorum watchdog are production supportability, not a bypass \u2014 keep those.)
 17. Input directions match their labels: A/\u2190 moves or turns the player screen-LEFT, D/\u2192 screen-RIGHT, mouse-up looks up, and drag-pan axes share ONE convention. The cursor is either the gameplay tool (RTS, card, builder) or locked away during play \u2014 keyboard-only games included. Check it in every milestone's smoke pass.
 18. NEVER delete, empty, move, rename, or overwrite anything you did not create yourself. This folder may hold the player's own reference images, notes, sketches, or an earlier attempt \u2014 files that exist nowhere else and have no undo, no trash, no backup. A non-empty folder is normal and is NEVER something to clean up, and "start clean" is never a reason. That rules out \`rm\`/\`rm -rf\`, \`git clean\`, \`git checkout -- .\`, \`git reset --hard\` over their work, deleting to resolve a conflict or a stuck interactive prompt, and every setup tool's offer to empty a directory (\`--force\`, \`--overwrite\`, "Remove existing files") \u2014 scaffold into a fresh subfolder and copy in instead. You may add files and edit the ones you wrote. If a step genuinely cannot continue without removing something of theirs, STOP and ask, naming the exact files, and wait for a yes \u2014 "it looks like junk" is never that yes. This binds hardest during setup, where it runs fast and automatically before the player has asked for anything at all.
-19. If the game sells anything, it sells it for coin at a fixed, visible price, and NEVER sells chance. Run this test on any purchasable thing before building it: does the player pay (with coin, or with anything coin bought, directly or indirectly), is the outcome uncertain when they pay, and is there a prize they wanted \u2014 all three yes means it is paid randomness, and you build the deterministic version instead. That rules out loot boxes, gacha, mystery boxes, crates, card packs, prize wheels and raffles; wagering, staking, betting, coinflips and casino or slot mechanics denominated in coin; and donation prompts, tip jars or any player-to-player coin transfer, because coin buys goods and never just moves. Randomness the player EARNS by playing is gameplay, not commerce \u2014 an enemy dropping a random item, a chest found in the level, a procedural layout, a crit roll \u2014 and is completely fine. Every coin price renders its real-money equivalent beside it (the server sends one with every item), item prices sit on the platform's price grid so no player is left holding change they cannot spend, and nothing in a shop carries a countdown, "limited time", or a stock counter. When a request crosses one of these lines, name the mechanic, give the one-sentence reason, propose a specific compliant alternative, and build that \u2014 never the banned version "as an option", never a partial one, and never after asking the player to confirm they want it. Load \`$genex-monetization\` before building a shop.
+19. If the game sells anything for real money, it sells it for Nex \u2014 Genex's own currency, which players buy with real money and spend in the Genex store \u2014 at a fixed, visible price, and NEVER sells chance. A price in Nex, or a request to sell something for real money that names no currency ("paid characters", "sell skins"), means a Genex store item: build it into the game, then list it with \`npx genex shop add \u2026 --json\` without asking (\`$genex-items\`); a price in coins, gold, gems or any other name is a currency of the game's own, earned by playing. Run this test on any purchasable thing before building it: does the player pay (with Nex, or with anything Nex bought, directly or indirectly), is the outcome uncertain when they pay, and is there a prize they wanted \u2014 all three yes means it is paid randomness, and you build the deterministic version instead. That rules out loot boxes, gacha, mystery boxes, crates, card packs, prize wheels and raffles; wagering, staking, betting, coinflips and casino or slot mechanics denominated in Nex; and donation prompts, tip jars or any player-to-player Nex transfer, because Nex buys goods and never just moves. Randomness the player EARNS by playing is gameplay, not commerce \u2014 an enemy dropping a random item, a chest found in the level, a procedural layout, a crit roll \u2014 and is completely fine. Every Nex price renders its real-money equivalent beside it (the server sends one with every item), item prices sit on the platform's price grid so no player is left holding change they cannot spend, and nothing in a shop carries a countdown, "limited time", or a stock counter. When a request crosses one of these lines, name the mechanic, give the one-sentence reason, propose a specific compliant alternative, and build that \u2014 never the banned version "as an option", never a partial one, and never after asking the player to confirm they want it. Load \`$genex-monetization\` before building a shop.
 20. When the player names a specific thing to integrate \u2014 a library, a controller, an asset, a part of an existing game, or a tagged reference the platform placed in \`.genex/refs/<slug>/\` \u2014 integrate the real thing: read its source first and build from it, never a lighter look-alike written from scratch because it was faster. A tagged reference owns the subsystem it was tagged for, outranking the default lane and the vendored controllers for that subsystem. If you genuinely can't use it, say so in one plain line and ask how to proceed.
 21. A turn ends in exactly one of two ways: on a question the player must answer before the next step can be chosen, or on a handoff \u2014 the draft link, what changed, what to try, and what is still open. Never close a turn on a promise. "I'll keep building", "while I keep working", "adding that now" are things you say and then DO before you stop; if you are stopping, say that you have stopped and what remains. While the Build plan's \`Now:\` line has open work and no answer is needed from the player, the turn is not over: preview, hand off, and start the next milestone in the same turn, until the requested outcome is reached or the platform's own budget ends the session. If a stop was forced on you anyway, the first line of your next turn is the promise you left and where it stands.
 22. **What the player sees must read as the thing it is**, in this game's own style: a building as that building, a person as a person, a prop as that prop, a surface as its material \u2014 and a coloured box, a capsule, or a flat grey block standing in for one of them is never its finished version. Generation is the default route to that bar wherever code will not honestly reach it: the player's character, whatever the request names, whatever the player walks up to, enters, or interacts with, and the music and sound underneath \u2014 reach for the belt on your own judgment, without stopping to ask; a status line saying what you queued is enough, and \`--no-wait\` keeps you building while it lands. Procedural code is a first-class engine for what is structural, repeated, distant, or parametric \u2014 terrain, sky, fences, paving, modular kits, filler \u2014 and for anything else only when the result meets the same bar and you have looked at it in a capture before its row says \`landed\`. 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 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.
+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 Nex, 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)
@@ -8350,7 +8350,7 @@ function checkFields(raw, label) {
   if (description !== void 0 && (typeof description !== "string" || description.trim() === "" || description !== description.trim())) {
     return bad("its description is not a trimmed, non-empty text");
   }
-  if (typeof priceCoins !== "number" || !Number.isSafeInteger(priceCoins) || priceCoins < 0) return bad("its price is not a whole coin, 0 or more");
+  if (typeof priceCoins !== "number" || !Number.isSafeInteger(priceCoins) || priceCoins < 0) return bad("its price is not a whole number of Nex, 0 or more");
   if (type !== ItemType.Consumable && type !== ItemType.Durable) return bad("its type is neither consumable nor durable");
   if (!Array.isArray(tags2) || !tags2.every((tag) => typeof tag === "string")) return bad("its tags are not a list of words");
   if (typeof shareable !== "boolean") return bad("its sharing is not true or false");
@@ -8738,12 +8738,12 @@ function formatCoins(coins) {
 }
 function coinPrice(coins, displayUsdCents) {
   if (coins === 0) return "Free";
-  if (displayUsdCents === void 0) return `${formatCoins(coins)} coin`;
+  if (displayUsdCents === void 0) return `${formatCoins(coins)} Nex`;
   const usd = (displayUsdCents / 100).toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
-  return `${formatCoins(coins)} coin ($${usd})`;
+  return `${formatCoins(coins)} Nex ($${usd})`;
 }
 function priceGridLine(grid, freeAllowed) {
-  return `${[...freeAllowed ? ["Free"] : [], ...grid.map(formatCoins)].join(" \xB7 ")} coin`;
+  return `${[...freeAllowed ? ["Free"] : [], ...grid.map(formatCoins)].join(" \xB7 ")} Nex`;
 }
 
 // src/lib/item-sync.ts
@@ -8752,7 +8752,7 @@ var ITEM_SYNC_VERSION = 1;
 var ItemState = { Draft: "draft", OnSale: "on_sale", OffSale: "off_sale" };
 var PRICE_CODES = /* @__PURE__ */ new Set(["price_off_grid", "bad_price"]);
 var FIX_FLAG = {
-  price: "--price <coin>",
+  price: "--price <Nex>",
   picture: "--image <picture.png>",
   model: "--model <file.glb>",
   package: "--package <dir>",
@@ -10065,7 +10065,7 @@ function printLine(draft) {
 async function addLocal(opts, attachments, log, refuse) {
   const name = opts.hostname?.trim();
   if (!name) return refuse(usageRefusal(`\`genex shop add\` needs a name, e.g. ${c.cyan('genex shop add "Iron Key" --price 100')}.`));
-  if (opts.price === void 0) return refuse(usageRefusal(`\`genex shop add\` needs ${c.cyan("--price")}, in coin (0 is Free).`));
+  if (opts.price === void 0) return refuse(usageRefusal(`\`genex shop add\` needs ${c.cyan("--price")}, in Nex (0 is Free).`));
   const unsupported = localOnlyRefusal(opts);
   if (unsupported) return refuse(unsupported);
   const description = opts.description?.trim();
@@ -10357,7 +10357,7 @@ var ShopSession = class {
         const named = grid && refusal2.error === "price_off_grid" && price !== void 0;
         return {
           ...refusal2,
-          ...named ? { message: `${formatCoins(price)} coin isn't one of this game's prices.` } : {},
+          ...named ? { message: `${formatCoins(price)} Nex isn't one of this game's prices.` } : {},
           hints: [...grid ? [`Prices available: ${grid}`] : [], `See the full list any time: ${c.cyan("genex shop list")}`]
         };
       }
@@ -10424,7 +10424,7 @@ var ShopSession = class {
     const { log, opts } = this;
     const name = opts.hostname?.trim();
     if (!name) return this.refuse(usageRefusal(`\`genex shop add\` needs a name, e.g. ${c.cyan('genex shop add "Iron Key" --price 100')}.`));
-    if (opts.price === void 0) return this.refuse(usageRefusal(`\`genex shop add\` needs ${c.cyan("--price")}, in coin (0 is Free).`));
+    if (opts.price === void 0) return this.refuse(usageRefusal(`\`genex shop add\` needs ${c.cyan("--price")}, in Nex (0 is Free).`));
     const type = opts.type ?? (opts.shared ? "durable" : "consumable");
     const res = await this.post(this.projectSkus, {
       name,
@@ -10647,7 +10647,7 @@ var ItemsSession = class _ItemsSession {
     for (const item of body.items) {
       const reach = item.gamesCount === 1 ? "in 1 game" : `in ${item.gamesCount} games`;
       log.plain(`  ${c.cyan(item.id)}  ${item.name} \u2014 ${coinPrice(item.priceCoins, item.priceDisplayUsdCents)} \xB7 ${reach} \xB7 by ${item.author.name}`);
-      log.dim(`      you get ${formatCoins(item.youGetPerSale)} coin per sale${item.tags.length ? ` \xB7 ${item.tags.join(", ")}` : ""}`);
+      log.dim(`      you get ${formatCoins(item.youGetPerSale)} Nex per sale${item.tags.length ? ` \xB7 ${item.tags.join(", ")}` : ""}`);
       if (item.description) log.dim(`      ${item.description.length > 120 ? `${item.description.slice(0, 117)}\u2026` : item.description}`);
     }
     if (body.nextCursor) log.dim("  More match: narrow the search with more words or a --tag.");
@@ -27006,6 +27006,7 @@ function rowHoldsSlot(row) {
   const state = rowState(row);
   return state === "active" || state === "awaiting bill" && ((row.reservedCoins ?? 0) > 0 || (row.reservedCredits ?? 0) > 0);
 }
+var UNIT_WORD = { credits: "credits", coin: "Nex" };
 function rowMoney(row) {
   const credits = row.currency === "credits" || row.currency === void 0 && typeof row.reservedCredits === "number" && typeof row.reservedCoins !== "number";
   if (credits) {
@@ -27538,7 +27539,7 @@ async function reportStatus(args) {
       const state = rowState(row);
       const mark = state === "active" ? c.cyan("\u25CF") : state === "awaiting bill" ? c.yellow("\u25D0") : c.green("\u25CB");
       const money = rowMoney(row);
-      const reserved = money.reserved === null ? "reserved \u2014" : `${money.reserved} ${money.unit} reserved`;
+      const reserved = money.reserved === null ? "reserved \u2014" : `${money.reserved} ${UNIT_WORD[money.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)")}`
       );
@@ -27614,7 +27615,7 @@ async function cancelCall(args) {
         if (row.providerMessage?.trim()) log.dim(`  Provider said: ${row.providerMessage.trim()}`);
       } else {
         const money = rowMoney(row);
-        log.dim(`  ${money.charged === null ? "charge unknown" : `${money.charged} ${money.unit} charged`}${row.error ? ` \xB7 ${row.error}` : ""}.`);
+        log.dim(`  ${money.charged === null ? "charge unknown" : `${money.charged} ${UNIT_WORD[money.unit]} charged`}${row.error ? ` \xB7 ${row.error}` : ""}.`);
       }
     }
     return done("ok", null, state === "awaiting bill" ? "awaiting_bill" : "already_final", row);
@@ -27652,7 +27653,7 @@ async function readSavedBench(cwd) {
   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.";
+var LLM_PRICE_COIN_TERMS_LINE = "This bench was measured under the old Nex terms, when a game declared a fixed Nex 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 Nex 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';
@@ -27725,7 +27726,7 @@ async function reportSavedPrice(cwd, opts, log) {
       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 measured = legacy.p95 === null ? "no settled sample" : `charged Nex 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)}`);
@@ -29659,7 +29660,7 @@ function oneParagraph(input) {
   const runnerText = input.runners.length === 0 ? "no runner yet" : input.runners.map((r) => r === "claude" ? "Claude Code" : "Codex").join(" and ");
   return [
     `  Genex approval  stored in ${input.credentialFile} (only this machine can read it). It can`,
-    "                  answer approved requests and spend nothing \u2014 no coins, no credits, no",
+    "                  answer approved requests and spend nothing \u2014 no Nex, no credits, no",
     "                  account changes. Your Claude or ChatGPT sign-in is never read, copied or",
     "                  sent anywhere; the watcher only starts the official CLI you already use.",
     `  Runners         ${runnerText}`,
@@ -30790,8 +30791,8 @@ ${c.bold("Usage")}
                                      the item id your game passes
                                      to buy({ skuId }) \u2014 the platform owns the
                                      catalog, so this is the only way one exists.
-                                     Prices come off a fixed grid, printed on any
-                                     refusal. "test <id>" gives you a free copy of
+                                     Prices in Nex come off a fixed grid, printed on
+                                     any refusal. "test <id>" gives you a free copy of
                                      your own item: you can't buy from your own game,
                                      so this is how you check the shop works.
                                      --icon <url> is the item's square art, shown in
@@ -31543,7 +31544,7 @@ ${c.bold("What it does and does not touch")}
   prints. Genex never sees your vendor account.
 
   Its GENEX approval is a player-scoped one: it can answer requests you already approved and can
-  spend nothing \u2014 no coins, no credits, no account changes. It lives in ~/.genex/player.json,
+  spend nothing \u2014 no Nex, no credits, no account changes. It lives in ~/.genex/player.json,
   separate from your creator sign-in, and the dashboard can revoke it at any time.
 
   The log under ~/.genex/logs/ carries ids, timings and outcomes \u2014 never what a game asked for
@@ -32378,7 +32379,7 @@ function applyValueFlag(options, flag, value) {
     case "--price": {
       const n = Number(value);
       if (value.trim() === "" || !Number.isInteger(n) || n < 0) {
-        throw new Error(`Invalid --price value: ${value} (whole coin, e.g. 100; 0 is Free)`);
+        throw new Error(`Invalid --price value: ${value} (whole Nex, e.g. 100; 0 is Free)`);
       }
       options.price = n;
       break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.36.15-dev.1036",
+  "version": "1.36.16-dev.1039",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-game-director/SKILL.md

@@ -156,8 +156,8 @@ vendored code from memory of another engine.
 | in-world motion art or another requested video | `$genex-ai-video` |
 | sound effect, one looping music bed, or a short spoken line | `$genex-ai-sfx`, `$genex-ai-music`, or `$genex-ai-voice` |
 | requested UI/HUD/menu/interface work, a visible UI problem, or an interface you decided this game wants built with generated art | `$genex-threejs-game-ui` |
-| selling anything for platform coin: a shop, an item catalog, boosts, cosmetics, "make it earn"; also any request for a loot box, gacha, wager, casino mechanic or donation prompt, which that skill refuses and replaces | `$genex-monetization` |
-| an item for the Genex store — sell a sword, a skin or a pet with its picture and description, "other games can use it too" — or another creator's shared item added to this game (`npx genex items add <id>`). Build the item first; the person puts it on sale | `$genex-items` (with `$genex-monetization`) |
+| selling anything for Nex (Genex's currency, bought with real money) or for real money with no currency named: a shop, an item catalog, boosts, cosmetics, "make it earn"; a fixed Nex price is a store item. Coins, gold or gems are the game's own earned currency, not this row. Also any request for a loot box, gacha, wager, casino mechanic or donation prompt, which that skill refuses and replaces | `$genex-monetization` |
+| an item for the Genex store — sell a sword, a skin or a pet for Nex with its picture and description, "other games can use it too" — or another creator's shared item added to this game (`npx genex items add <id>`). Build the item first, list it with `npx genex shop add … --json` without asking; the person puts it on sale | `$genex-items` (with `$genex-monetization`) |
 | the game calls a language model AT RUNTIME on the player's credits, billed as used under a per-call ceiling the game benchmarks with `npx genex llm bench`: NPCs that answer in their own words, dialogue or quests written per save, a judge reading what the player typed — one-time calls, or a standing budget the player approves once. Check the lane with `npx genex llm models` before designing it in | `$genex-llm-in-games` |
 | cinematic menu/title/pause/victory/defeat/lobby/credits video treatment | `$genex-ai-menu` |
 | drawn HUD chrome the game's style wants—one element or a matched set of frames, masks, and icons | `$genex-ai-hud` |

package/templates/skills/genex-items/SKILL.md

@@ -1,18 +1,35 @@
 ---
 name: genex-items
-description: Make game items for the Genex store and add other creators' shared items to this game. Build the item into the game first, list it as a draft with `genex shop add … --json` (before the game is published it waits as a local draft), apply owned items from getEntitlements() at boot, and integrate a shared item with `genex items add`. Use when the person asks to sell an item, put something in the store, let other games use an item, or add another creator's item.
+description: Make game items for the Genex store, priced in Nex, and add other creators' shared items to this game. Build the item into the game first, list it as a draft with `genex shop add … --json` (before the game is published it waits as a local draft), apply owned items from getEntitlements() at boot, and integrate a shared item with `genex items add`. Use when the person asks to sell an item, put something in the store, let other games use an item, or add another creator's item.
 ---
 
 # Genex Items
 
 An item is something a player owns: a name, a description, a picture, a price
-in coin and free-text tags. A 3D model, sounds or code are optional. A player
+in Nex and free-text tags. A 3D model, sounds or code are optional. A player
 buys an item once and owns it in every game that has added it. Your game
 decides what the item looks like and what it does there.
 
-`$genex-monetization` owns the hard rules for anything sold for coin. They apply
+`$genex-monetization` owns the hard rules for anything sold for Nex. They apply
 to items without exception: no paid randomness, no gambling, no donation
-mechanics, no pressure, and a real-money price beside every coin price.
+mechanics, no pressure, and a real-money price beside every Nex price.
+
+## Nex, and the game's own currencies
+
+Genex's own currency is **Nex**: players buy it with real money and spend it in
+the Genex store. It is a name, written "1,200 Nex", never "Nexes".
+
+- **A price in Nex means a Genex store item.** Build the thing into the game,
+  then list it with `npx genex shop add … --json` without asking, before or
+  after the first publish (a folder with no linked game keeps a local draft,
+  below). Price it from the store's grid: `npx genex shop list` prints it, and
+  a price off the grid is refused with `price_off_grid`. The person puts it on
+  sale.
+- **A price in coins, gold, gems or any other name is a currency of the game's
+  own**, earned by playing: it lives in the game's code, not in the store. If
+  the person also says it is for real money, ask once whether they mean Nex.
+- **A request to sell something for real money that names no currency**
+  ("paid characters", "sell skins") means Nex store items.
 
 ## The rules
 
@@ -48,7 +65,7 @@ mechanics, no pressure, and a real-money price beside every coin price.
    sheet "Drag to turn".
 3. **Ask once, only if the person did not say:** "Can other games use it too?"
    Only a durable item can be shared.
-4. **List it as a draft:**
+4. **List it as a draft, without asking:**
 
 ```bash
 npx genex shop add "Frost Axe" --price 1200 --type durable \
@@ -123,19 +140,19 @@ for (const item of await getShop()) {
   card.onclick = async () => {
     const result = await buy({ skuId: item.id }); // the first await in the click
     if (result.status === 'succeeded' || result.status === 'already_owned') await applyOwnedItems();
-    if (result.status === 'insufficient_balance') showNotEnoughCoin(); // nothing was charged
+    if (result.status === 'insufficient_balance') showNotEnoughNex(); // nothing was charged
   };
 }
 ```
 
-`knowsItem`, `applyItem`, `drawCard` and `showNotEnoughCoin` are your game
+`knowsItem`, `applyItem`, `drawCard` and `showNotEnoughNex` are your game
 code. A durable is applied on every boot and never consumed. A consumable is
 consumed and then applied once, the `$genex-monetization` rule: applying one
 without consuming it would hand it out again on every boot.
 
 `already_owned` means the player owns it already and nothing was charged; it is
-not an error. `insufficient_balance` means the player was short of coin at
-Confirm; nothing was charged, so tell them they need more coin. A shared item
+not an error. `insufficient_balance` means the player was short of Nex at
+Confirm; nothing was charged, so tell them they need more Nex. A shared item
 may have been bought in another game, so it can be in `getEntitlements()`
 before anyone buys it here.
 
@@ -179,7 +196,7 @@ own it keep it.
 - [ ] It was listed with `genex shop add … --json` and left as a draft (a
       local draft before the game is published)
 - [ ] Owned items are applied from `getEntitlements()` at every boot
-- [ ] Every coin price shows `priceDisplayUsdCents` beside it
+- [ ] Every Nex price shows `priceDisplayUsdCents` beside it
 - [ ] No price, share or item type is typed into the game
 - [ ] A shared item's package was reviewed before any of it ran
 - [ ] The rules of `$genex-monetization` hold for every item

package/templates/skills/genex-llm-in-games/SKILL.md

@@ -332,7 +332,7 @@ function applyGeneration(res) {     // THE only place output becomes game state
 - Boot reads any stored id, calls `waitForGeneration(savedId)`, and passes the
   result to the **same** `applyGeneration`. One writer, two entry points, is the
   difference between "works once" and "survives a reload".
-- Output is **data, never authority**: it may not grant coin, items,
+- Output is **data, never authority**: it may not grant Nex, items,
   entitlements, scores or progression by saying so. `source: 'external'` carries
   `modelProvenance: 'unverified'` because it is user-supplied — check it exactly
   as you would check typed player input.

package/templates/skills/genex-llm-in-games/references/pricing.md

@@ -189,7 +189,7 @@ that before you reach for a cheaper model.
 server still accepts them and reads them as the same numbers in credits, but
 they are deprecated: rename them to `maxCredits`, `perCallMaxCredits`,
 `perCallEstimateCredits` and `estimatedCreditsPerPeriod` when you touch the
-code, and re-benchmark — a number measured as a coin price is not a ceiling.
+code, and re-benchmark — a number measured as a Nex price is not a ceiling.
 
 ## Worked example
 

package/templates/skills/genex-monetization/SKILL.md

@@ -1,24 +1,48 @@
 ---
 name: genex-monetization
-description: Add dynamic coin payments for game goods or actions — platform consent, recoverable receipts, and idempotent delivery without a required product catalog. Use when the player asks to sell things, add a shop, monetize, or make the game earn. Carries the hard rules: no paid randomness, no gambling in coin, no donation mechanics, and a real-money price beside every coin price.
+description: Sell things in a Genex game for Nex, the currency players buy with real money — fixed-price Genex store items (`genex shop add`) by default, dynamic payment requests only for amounts decided while playing. Use when the player asks to sell things, add a shop, monetize, or make the game earn. Carries the hard rules: no paid randomness, no gambling, no donation mechanics, and a real-money price beside every Nex price.
 ---
 
 # Genex Monetization
 
-Games on Genex can sell things for **coin**, the platform currency. The player
-buys coin with real money once; spending it inside a game is a ledger movement
-the game never touches. You design what is for sale; the platform owns the
-wallet, the confirmation, and the money.
+Genex's own currency is **Nex**: players buy it with real money and spend it in
+the Genex store. Spending it inside a game is a ledger movement the game never
+touches. You design what is for sale; the platform owns the wallet, the
+confirmation, and the money. Nex is a name: "1,200 Nex", never "Nexes".
 
 Load this when the user asks to sell something or add payments. Build the game
-loop before adding commerce; no shop screen or product catalog is required.
+loop before adding commerce.
+
+## Which currency the person means
+
+- **A price in Nex means a Genex store item.** Build the thing into the game,
+  then list it with `npx genex shop add … --json` without asking, before or
+  after the first publish (a folder with no linked game keeps a local draft).
+  Price it from the store's grid: `npx genex shop list` prints it, and a price
+  off the grid is refused with `price_off_grid`. The person puts it on sale.
+  `$genex-items` owns the steps.
+- **A price in coins, gold, gems or any other name is a currency of the game's
+  own**, earned by playing (see the per-game currency note below). If the
+  person also says it is for real money, ask once whether they mean Nex.
+- **Selling something for real money with no currency named** ("paid
+  characters", "sell skins") means Nex store items.
+
+## Store items first, payment requests for amounts decided in play
+
+Anything with a fixed Nex price is a **store item** (`$genex-items`): a sword,
+a skin, a character, a level pack, a boost. The store draws its card, its
+purchase sheet and its receipt; the game delivers it from `getEntitlements()`.
+
+A **dynamic payment request** (`requestPayment()`, below) is only for an amount
+decided while playing: a player-approved action whose price the run sets, or a
+top-up of a size the player picks. Never wrap a fixed-price item in one.
 
 ## The hard rules, and the test that generalizes them
 
 Before you build ANY purchasable thing, run this test:
 
-> **Does the player pay?** (with coin, or with anything bought with coin —
-> directly or indirectly, including a per-game token or key that coin bought.)
+> **Does the player pay?** (with Nex, or with anything bought with Nex —
+> directly or indirectly, including a per-game token or key that Nex bought.)
 > **Is the outcome uncertain when they pay?**
 > **Is there a prize** — an item, currency, or advantage they wanted?
 >
@@ -30,12 +54,12 @@ catches mechanics that do not exist yet — which a list of banned names cannot.
 Four things are never built, whatever the request:
 
 1. **No paid randomness.** No loot boxes, gacha, mystery boxes, crates, packs,
-   prize wheels, raffles, "spin for a bonus", "chance to double your coins".
+   prize wheels, raffles, "spin for a bonus", "chance to double your Nex".
    Directly or indirectly.
-2. **No gambling in coin.** No wagering, staking, betting, coinflips, casino or
-   slot mechanics denominated in coin or in anything coin buys.
+2. **No gambling in Nex.** No wagering, staking, betting, coinflips, casino or
+   slot mechanics denominated in Nex or in anything Nex buys.
 3. **No donation or begging mechanics.** No "donate to me" prompts, tip jars, or
-   player-to-player coin transfers. Coin buys goods; it never just moves.
+   player-to-player Nex transfers. Nex buys goods; it never just moves.
 4. **No pressure.** No countdown timers, "ends in", "limited time", "only N
    left", or stock counters anywhere in the shop.
 
@@ -67,10 +91,10 @@ once and build the compliant version. There is no escalation path.
 | They asked for | Build |
 | --- | --- |
 | Loot box, crate, mystery box, card pack | A direct-purchase shop: every item listed at a fixed price, contents visible. For the collecting feel, add a **visible catalog with a completion track** — any purchase advances a meter to a stated milestone reward. |
-| Gacha, banner, pull, summon | A **deterministic unlock**: the character costs a fixed price, or unlocks at a stated number of runs. Coin may buy a stated, visible number of those points. |
+| Gacha, banner, pull, summon | A **deterministic unlock**: the character costs a fixed price, or unlocks at a stated number of runs. Nex may buy a stated, visible number of those points. |
 | Prize wheel, spin-to-win, slot machine | A **free spin earned by finishing a run** (never bought), or a **"pick one of three"** screen where all three are visible and the player chooses. Keeps the moment, drops the wager. |
-| Casino game, blackjack, poker, roulette | The same game with **chips that are granted free each session, reset on restart, cannot be bought and cannot become coin**. It becomes a card game. Sell cosmetics — table felt, card backs — for coin. |
-| Coinflip, double-or-nothing, wager my coins | A **skill-based risk/reward inside the run**: a harder route with a bigger payout, staking the run's own score, which was never purchasable. |
+| Casino game, blackjack, poker, roulette | The same game with **chips that are granted free each session, reset on restart, cannot be bought and cannot become Nex**. It becomes a card game. Sell cosmetics — table felt, card backs — for Nex. |
+| Coinflip, double-or-nothing, wager my Nex | A **skill-based risk/reward inside the run**: a harder route with a bigger payout, staking the run's own score, which was never purchasable. |
 | Betting on matches, PvP wagers | **Leaderboards with a fixed cosmetic reward for placement**, paid by the game. Nobody's balance goes down. |
 | Donate button, tip jar, "pls donate" | A **gift that is a purchase**: they buy a specific item at a stated price and give it. Or a **supporter cosmetic** — a badge or aura at a normal price, where what's delivered is visible. |
 | Pay to remove a wait / energy gate | **Delete the gate** and sell a permanent upgrade or a cosmetic. Pace with difficulty, not with a timer. |
@@ -94,28 +118,71 @@ Nine checks. Each one is answerable about your actual design.
    shop, remove the annoyance instead of selling the cure.
 5. **Everything sold is reachable free.** Spending is a shortcut or a
    decoration, never the only path.
-6. **A payment has one clear price and promised result.** `amountCoins` is a
-   positive whole number from 1 to 100000, further bounded by the platform
-   surface. Dynamic payments do not use the legacy catalog price grid.
+6. **A purchase has one clear price and promised result.** A store item's
+   price is on the server's grid (`genex shop list`), or Free. A dynamic
+   payment's `amountCoins` is a positive whole number of Nex from 1 to 100000,
+   further bounded by the platform surface, and needs no grid.
 7. **Every price shows real money next to it.** The platform confirmation
    shows the server-frozen `priceDisplayUsdCents`. If rendering a receipt or
-   catalog price in the game, render that value too; never invent an exchange
+   store price in the game, render that value too; never invent an exchange
    rate. A button can simply say “Unlock” and let Genex show the price.
-8. **One currency layer between money and goods.** Coin buys items. A per-game
-   earned currency buys per-game upgrades. They never convert into each other.
+8. **One currency layer between money and goods.** Nex buys items. A per-game
+   earned currency (coins, gold, gems) buys per-game upgrades. They never
+   convert into each other.
 9. **Paid ownership survives a reinstall.** Receipts live on the server; the
    game recovers them on every boot and restores the promised state. A
    confirmation can expire; a paid receipt does not expire with it.
 
-For a per-game earned currency, the load-bearing number is **minutes of play per
-unit earned**. Set it, then price the cheapest meaningful item at one to three
-sessions of earning. Everything else follows. Spend sinks come in three kinds —
-permanent upgrades, refills, cosmetics — and cosmetics are what absorbs late-game
+For a per-game earned currency (coins, gold, gems: earned by playing, never
+bought), the load-bearing number is **minutes of play per unit earned**. Set
+it, then price the cheapest meaningful item at one to three sessions of
+earning. Everything else follows. Spend sinks come in three kinds — permanent
+upgrades, refills, cosmetics — and cosmetics are what absorbs late-game
 currency without touching balance.
 
-## Dynamic payment requests
+## Store items (the default)
+
+Every fixed-price item is a Genex store item. `$genex-items` owns making one —
+its picture, its description, the draft the person puts on sale, items other
+games can use, and adding another creator's item. Its rules add to these; they
+never replace them.
+
+```bash
+npx genex shop list   # the price grid in Nex, and this game's items
+npx genex shop add "Iron Key" --price 100 --type durable --json
+npx genex shop test <sku-id>  # owner-only free entitlement; no Nex moves
+```
 
-From `@genex-ai/embed-sdk`, after `initEmbed()` and player identity are ready:
+List the item once it works in the game, without asking. When the Genex
+store is on, `genex shop add` makes a draft: `getShop()` leaves it out of the
+live game and `buy()` cannot sell it until the person puts it on sale. `--json`
+makes the Genex app show its **Put on sale** card; never put it on sale
+yourself. Before the game is published, items can be made all the same: they
+wait as local drafts and go up as drafts with `genex publish`; still, only the
+person puts one on sale. With the store off, the item is on sale at once:
+tell the person so.
+
+`getShop()` reads store items even for guests and preview builds;
+`buy({ skuId })` requests their platform confirmation. Prices follow the grid
+printed by `genex shop list`. Render `name`, `iconUrl`, `priceCoins` (the price
+in Nex) and `priceDisplayUsdCents`; use an image of the actual item for its
+icon. `genex shop set` edits a listing and `genex shop remove` retires it
+without removing a buyer's ownership.
+
+Re-list `getEntitlements({ excludeConsumed: true })` on boot. Branch on
+`skuType` (`consumable`/`durable`), never `type` (purchase/gift/test/free).
+For a consumable, await `consumeEntitlement(id)` BEFORE applying its effect
+and skip `alreadyConsumed: true`. This prevents repeated delivery but a crash
+between consume and save can lose that effect; do not promise atomic game-state
+delivery. A durable ownership unlock is never consumed: restore it from the
+entitlement on every boot. Dynamic receipts do not use this consumption API.
+
+## Dynamic payment requests (amounts decided in play)
+
+Only for an amount the run decides — a player-approved action whose price play
+sets, a top-up of a size the player picks. A fixed price is a store item
+(above). From `@genex-ai/embed-sdk`, after `initEmbed()` and player identity
+are ready:
 
 ```ts
 import { requestPayment, getPayment, getPayments } from '@genex-ai/embed-sdk';
@@ -126,7 +193,7 @@ const order = {
   orderId: 'unlock-iron-gate-run-42',
   title: 'Open the iron gate',
   description: 'Unlock the shortcut for this run.',
-  amountCoins: 75,
+  amountCoins: 75, // Nex, set by this run: the gate's toll grows with depth
 };
 
 buyButton.addEventListener('click', async () => {
@@ -144,15 +211,16 @@ buyButton.addEventListener('click', async () => {
 });
 ```
 
-No `genex shop add`, SKU id, catalog card or item icon is needed. A payment can
-buy a described game action, unlock or item. The hard rules above still apply.
-The game never supplies a recipient: the platform uses the game's own split.
-This API is for coin commerce; in-game LLM requests use their own funding and
-consent flow (`$genex-llm-in-games`), not a payment wrapped around a model call.
+A payment request needs no `genex shop add`, SKU id or item icon: it buys a
+described game action whose amount was decided in play. The hard rules above
+still apply. The game never supplies a recipient: the platform uses the game's
+own split. This API is for Nex commerce; in-game LLM requests use their own
+funding and consent flow (`$genex-llm-in-games`), not a payment wrapped around
+a model call.
 
 The server freezes `title`, `description`, `amountCoins` and the real-money
 value before Genex asks the player. **Creating a request neither debits nor
-reserves coin.** Only the player's explicit confirmation on the platform
+reserves Nex.** Only the player's explicit confirmation on the platform
 surface can move money. The game cannot draw, skin or confirm that sheet.
 
 An `orderId` belongs to this player in this game. The same id with the same
@@ -174,7 +242,7 @@ and `pending`. A timeout or uncertain response is `pending`: it is not proof of
 failure and not permission to apply the action or charge again. `canceled` is
 ordinary player choice; do not show an error for it.
 
-**Your game cannot read the player's coin balance, and no HUD should show one.**
+**Your game cannot read the player's Nex balance, and no HUD should show one.**
 The wallet spans the platform; let Genex show the balance and handle consent.
 Only fulfil a payment whose authoritative receipt says `succeeded`.
 
@@ -186,10 +254,10 @@ The surface depends on the shell (`$genex-threejs-embed-auth`,
   pointer lock before it asks. Treat payment like a pause; re-enter fullscreen
   and pointer lock from the player's next Resume click.
 - **The Genex app has no purchase surface yet.** `requestPayment()` fails
-  without opening a sheet; the legacy `buy()` resolves
+  without opening a sheet, and `buy()` resolves
   `failed` without opening anything too. When `getShell()` from `@genex-ai/embed-sdk` is `"app"`,
   hide payment buttons or make the shop browse-only; do not show a failure toast.
-- Local test mode has no wallet. Preview builds cannot spend real coin either.
+- Local test mode has no wallet. Preview builds cannot spend real Nex either.
   Verify layout and delivery with game-owned test fixtures; a real payment needs
   a published build, a signed-in player and explicit platform consent.
 
@@ -231,53 +299,20 @@ response and a canceled order. Also check concurrent fulfillment if the game
 permits multiple tabs; two read-modify-write saves are not a transaction.
 Do not make a real-money purchase automatically to test the feature.
 
-## Existing catalog items
-
-Catalog APIs remain supported for published games and items that need platform
-entitlements or resale. They are optional, not a prerequisite for dynamic
-payments:
-
-```bash
-npx genex shop add "Iron Key" --price 100 --type durable
-npx genex shop list
-npx genex shop test <sku-id>  # owner-only free entitlement; no coin moves
-```
-
-`getShop()` reads catalog items even for guests and preview builds;
-`buy({ skuId })` requests their platform confirmation. These prices must follow
-the grid printed by `genex shop list`. Render `name`, `iconUrl`, `priceCoins`
-and `priceDisplayUsdCents`; use an image of the actual item for its icon.
-`genex shop set` edits a listing and `genex shop remove` retires it without
-removing a buyer's ownership. When the Genex store is on, `genex shop add`
-makes a draft: `getShop()` leaves it out of the live game and `buy()` cannot
-sell it until the person puts it on sale. Add `--json` so the Genex app shows
-its **Put on sale** card, and never put it on sale yourself. Before the game
-is published, items can be made all the same: they wait as local drafts and go
-up as drafts with `genex publish`; still, only the person puts one on sale.
-
-Items for the Genex store — a picture, a description, a draft the person puts
-on sale, items other games can use, and adding another creator's item — are
-`$genex-items`. Its rules add to these; they never replace them.
-
-Re-list `getEntitlements({ excludeConsumed: true })` on boot. Branch on
-`skuType` (`consumable`/`durable`), never `type` (purchase/gift/test/free).
-For a consumable, await `consumeEntitlement(id)` BEFORE applying its effect
-and skip `alreadyConsumed: true`. This prevents repeated delivery but a crash
-between consume and save can lose that effect; do not promise atomic game-state
-delivery. A durable ownership unlock is never consumed: restore it from the
-entitlement on every boot. Dynamic receipts do not use this consumption API.
-
 ## Checklist
 
 - [ ] The game has a worthwhile loop before commerce
-- [ ] The saved order binds one stable id, exact terms and promised action
-- [ ] `requestPayment()` starts directly from a click/tap
-- [ ] Genex shows the frozen coin and real-money price and receives consent
+- [ ] Every fixed Nex price is a store item: built first, listed with
+      `genex shop add … --json` at a grid price, left for the person to put on sale
+- [ ] A dynamic payment carries only an amount decided in play; its saved order
+      binds one stable id, exact terms and promised action
+- [ ] `buy()` and `requestPayment()` start directly from a click/tap
+- [ ] Genex shows the frozen Nex and real-money price and receives consent
 - [ ] No payment buttons in the Genex app
 - [ ] Cancellation is silent; uncertain outcomes remain pending
-- [ ] Recovery reads receipts before applying any paid action
+- [ ] Recovery reads entitlements and receipts before applying any paid action
 - [ ] Fulfillment is idempotent, including reload and concurrent-tab cases
-- [ ] No paid randomness, coin wagering, donation prompt or pressure timer
+- [ ] No paid randomness, Nex wagering, donation prompt or pressure timer
 - [ ] Nothing sold is unreachable without paying
 
 ## Troubleshooting
@@ -306,8 +341,9 @@ a published build for an explicitly approved real purchase.
 **`surface_cap`** — the amount exceeds the server's limit for this confirmation
 surface. Do not split it into smaller hidden charges to bypass the limit.
 
-**`price_off_grid`** — this applies to legacy catalog SKUs only. Dynamic
-payments accept whole amounts subject to their own caps.
+**`price_off_grid`** — a store item's price is not on the grid. The refusal
+prints it (so does `genex shop list`); pick a price from it, or 0 for Free.
+Dynamic payments accept whole amounts subject to their own caps.
 
-**Everything coin-related 404s** — coin commerce is disabled on this stand.
-Build the rest and report the unavailable lane.
+**Everything Nex-related 404s** — Nex commerce is off on this stand. Build
+the rest and report the unavailable lane.