@genex-ai/cli-demo 0.32.0 → 0.33.0

package/dist/index.js

@@ -567,6 +567,34 @@ function formatUpdateRequired(body) {
   const message = body.message ?? `Genex CLI ${body.clientVersion ?? getCliVersion()} is below the minimum supported version${body.minVersion ? ` ${body.minVersion}` : ""}.`;
   return [`${c.red("\u2717")} ${message}`, `  Update now \u2014 run: ${action}  (then re-run this command)`];
 }
+function shortDate(iso) {
+  const d = new Date(iso);
+  if (Number.isNaN(d.getTime())) return iso;
+  return d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
+}
+function formatInsufficientCredits(body) {
+  const message = body.message ?? `this generation costs ${body.price ?? "?"} credits; your balance is ${body.balance ?? 0}.`;
+  const lines = [`${c.red("\u2717")} Out of credits \u2014 ${lowerFirst(message)}`];
+  if (body.refillAt && body.refillTo) {
+    lines.push(`  Credits refill to ${body.refillTo} on ${shortDate(body.refillAt)}.`);
+  }
+  if (body.url) lines.push(`  Get more or check your balance: ${body.url}`);
+  return lines;
+}
+function formatVerificationRequired(body) {
+  const lines = [
+    `${c.red("\u2717")} Email not verified \u2014 verify your email to unlock your free generation credits.`
+  ];
+  if (body.url) lines.push(`  Verify here: ${body.url}  (then re-run this command)`);
+  return lines;
+}
+function lowerFirst(s) {
+  return s ? s[0].toLowerCase() + s.slice(1) : s;
+}
+var structuredPrinted = /* @__PURE__ */ new WeakSet();
+function printedStructuredError(res) {
+  return structuredPrinted.has(res);
+}
 async function apiFetch(url, init = {}) {
   const headers = new Headers(init.headers);
   if (!headers.has(CLI_VERSION_HEADER)) headers.set(CLI_VERSION_HEADER, getCliVersion());
@@ -580,6 +608,39 @@ async function apiFetch(url, init = {}) {
     } catch {
     }
   }
+  if (res.status === 402) {
+    try {
+      const body = await res.clone().json();
+      if (body?.error === "insufficient_credits") {
+        for (const line of formatInsufficientCredits(body)) process.stderr.write(line + "\n");
+        structuredPrinted.add(res);
+      }
+    } catch {
+    }
+  }
+  if (res.status === 403) {
+    try {
+      const body = await res.clone().json();
+      if (body?.error === "email_verification_required") {
+        for (const line of formatVerificationRequired(body)) process.stderr.write(line + "\n");
+        structuredPrinted.add(res);
+      }
+    } catch {
+    }
+  }
+  if (res.status === 503) {
+    try {
+      const body = await res.clone().json();
+      if (body?.error === "generation_paused") {
+        process.stderr.write(
+          `${c.red("\u2717")} ${body.message ?? "Generation is temporarily paused platform-wide. Try again later."}
+`
+        );
+        structuredPrinted.add(res);
+      }
+    } catch {
+    }
+  }
   return res;
 }
 
@@ -1664,6 +1725,10 @@ async function runGenerate(kind, opts) {
       process.exitCode = 1;
       return;
     }
+    if (printedStructuredError(res)) {
+      process.exitCode = 1;
+      return;
+    }
     if (!res.ok) {
       log.error(`Generation request failed (HTTP ${res.status}).`);
       process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "Set up your ~/.claude workspace, authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-ai-model/SKILL.md

@@ -106,5 +106,14 @@ scene is a ghost: players and objects pass straight through it.
 ## Troubleshooting
 
 - **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
+  this model generation. Tell the user the facts the CLI printed: their balance, this
+  generation's cost, and when their credits refill. Then offer to continue the build
+  with a procedurally-coded placeholder (a simple Three.js primitive-based stand-in
+  mesh) and mark the spot with `// TODO(genex): regenerate when credits refill` so
+  the real asset is one command away later. Do not stop the session over this.
+- **"Email not verified" (`email_verification_required`)** — generation credits
+  unlock after the account's email is verified. Give the user the verify link the
+  CLI printed, wait for them to confirm, then re-run the command.
 - **The mesh looks low-detail / wrong** — make the prompt more specific
   (materials, style, parts) and regenerate; each run is a fresh asset.

package/templates/skills/genex-ai-sfx/SKILL.md

@@ -73,6 +73,15 @@ Reuse one loaded `buffer` across many plays; create a fresh `Audio`/`PositionalA
 ## Troubleshooting
 
 - **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
+  this sound generation. Tell the user the facts the CLI printed: their balance, this
+  generation's cost, and when their credits refill. Then offer to continue the build
+  with a procedurally-coded placeholder (a small WebAudio-synthesized stub sound)
+  and mark the spot with `// TODO(genex): regenerate when credits refill` so the
+  real asset is one command away later. Do not stop the session over this.
+- **"Email not verified" (`email_verification_required`)** — generation credits
+  unlock after the account's email is verified. Give the user the verify link the
+  CLI printed, wait for them to confirm, then re-run the command.
 - **No sound** — the `AudioContext` is suspended until a user gesture; trigger the
   first play from a click/keydown. Confirm the camera has an `AudioListener`.
 - **Too quiet/loud** — `sound.setVolume(0..1)`; for positional, tune

package/templates/skills/genex-ai-skybox/SKILL.md

@@ -77,6 +77,16 @@ scene.background = texture; // keep the raw texture for the visible sky
 ## Troubleshooting
 
 - **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
+  this skybox generation. Tell the user the facts the CLI printed: their balance, this
+  generation's cost, and when their credits refill. Then offer to continue the build
+  with a procedurally-coded placeholder (a gradient/procedural sky or a plain
+  `scene.background` color) and mark the spot with
+  `// TODO(genex): regenerate when credits refill` so the real asset is one command
+  away later. Do not stop the session over this.
+- **"Email not verified" (`email_verification_required`)** — generation credits
+  unlock after the account's email is verified. Give the user the verify link the
+  CLI printed, wait for them to confirm, then re-run the command.
 - **Sky looks too dark/bright** — adjust `renderer.toneMappingExposure`, or scale
   `scene.environment` influence via material `envMapIntensity`.
 - **Seam/pole artifacts** — that's inherent to equirect images; keep the camera

package/templates/skills/genex-ai-texture/SKILL.md

@@ -82,6 +82,16 @@ scene.add(ground);
 ## Troubleshooting
 
 - **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
+  this texture generation. Tell the user the facts the CLI printed: their balance,
+  this generation's cost, and when their credits refill. Then offer to continue the
+  build with a procedurally-coded placeholder (a procedural Three.js material in a
+  matching color) and mark the spot with
+  `// TODO(genex): regenerate when credits refill` so the real asset is one command
+  away later. Do not stop the session over this.
+- **"Email not verified" (`email_verification_required`)** — generation credits
+  unlock after the account's email is verified. Give the user the verify link the
+  CLI printed, wait for them to confirm, then re-run the command.
 - **Visible tiling seams** — use `--terrain` (tuned for seamless edges), lower the
   `repeat`, or blend two textures. Perfect seamlessness is a known v1 limitation.
 - **Colors look washed/dark** — ensure `map.colorSpace = THREE.SRGBColorSpace`.

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

@@ -9,13 +9,15 @@ Genex ships improvements continuously. The `genex` CLI tells you when something
 is stale; you (the agent) apply the update at the right moment and tell the
 user what happened. The user never manages versions themselves.
 
-## The three signals in `genex` output
+## The signals in `genex` output
 
 | Line | Meaning | What you do |
 | -- | -- | -- |
 | `🔄 Genex skills updated to X.Y.Z` | Skills were auto-refreshed to match the installed CLI. | Nothing — informational. Skills stay in sync on their own. |
 | `⬆ Genex <package> X.Y.Z available (installed A.B.C) — run: <command>` | A newer npm package exists. | Run the printed command at a **safe moment** (below), then tell the user. |
 | `✗ … below the minimum supported version … Update now — run: <command>` | The API refuses this CLI version (HTTP 426, `cli_update_required`). | Run the printed command **now**, then re-run the refused genex command. |
+| `✗ Out of credits — … costs N credits; your balance is M.` | The account can't cover this generation (HTTP 402, `insufficient_credits`). | Relay the printed facts (balance, cost, refill date, link) to the user; offer a procedural placeholder so the build continues — see the generation skill's Troubleshooting. |
+| `✗ Email not verified — …` | Generation credits are locked until the email is verified (HTTP 403, `email_verification_required`). | Give the user the printed verify link, wait for them to confirm, then re-run the command. |
 
 ## Safe moments — when to apply a nudge