@netmind/arena-cli 0.32.1 → 0.33.0

package/dist/index.js

@@ -326,6 +326,12 @@ function charCount(value) {
     return String(value).length;
   }
 }
+function parseRetryAfter(header, bodyValue) {
+  const fromHeader = header !== null ? Number(header) : NaN;
+  if (Number.isFinite(fromHeader) && fromHeader >= 0) return Math.ceil(fromHeader);
+  if (typeof bodyValue === "number" && Number.isFinite(bodyValue) && bodyValue >= 0) return Math.ceil(bodyValue);
+  return void 0;
+}
 async function api(path3, opts = {}) {
   const { method = "GET", body, auth = false } = opts;
   const url = `${getApiUrl()}${path3}`;
@@ -382,9 +388,12 @@ async function api(path3, opts = {}) {
       throw new ChallengeRequiredError(data.challenge ?? {});
     }
     const msg = data.message || data.error || res.statusText;
-    const err = new Error(`API error ${res.status}: ${msg}`);
+    const retryAfter = res.status === 429 ? parseRetryAfter(res.headers?.get?.("retry-after") ?? null, data?.retryAfter) : void 0;
+    const suffix = retryAfter !== void 0 ? ` (retry after ${retryAfter}s)` : "";
+    const err = new Error(`API error ${res.status}: ${msg}${suffix}`);
     if (typeof data?.code === "string") err.code = data.code;
     err.status = res.status;
+    if (retryAfter !== void 0) err.retryAfter = retryAfter;
     throw err;
   }
   return json;
@@ -425,8 +434,21 @@ function printKv(data) {
     }
   }
 }
-function printError(msg) {
-  console.error(`error: ${msg}`);
+function isJsonMode(argv = process.argv) {
+  return argv.includes("--json");
+}
+function printError(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  if (!isJsonMode()) {
+    console.error(`error: ${message}`);
+    return;
+  }
+  const detail = error ?? {};
+  const out = { error: message };
+  if (typeof detail.status === "number") out.status = detail.status;
+  if (typeof detail.code === "string") out.code = detail.code;
+  if (typeof detail.retryAfter === "number") out.retryAfter = detail.retryAfter;
+  console.log(JSON.stringify(out));
 }
 function printSuccess(msg) {
   console.log(`ok: ${msg}`);
@@ -472,7 +494,7 @@ Credentials auto-saved to ~/.config/arena/credentials.json (or $ARENA_CONFIG_DIR
       "Tip: Verify Twitter for +800 credits \u2192 arena verify --tweet-url <url>"
     );
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -496,7 +518,7 @@ var loginCmd = new Command2("login").description("Log in with an existing API ke
     });
     printSuccess(`Logged in as ${profile.name} (${profile.id})`);
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -544,7 +566,7 @@ var rewardsCmd = new Command3("rewards").description("Show USDC prizes you have
 (page ${page}, ${total} total \u2014 use --page ${page + 1} for more)`);
     }
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -577,7 +599,7 @@ var profileCmd = new Command4("profile").description("Show your agent profile an
       created: profile.created_at
     });
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -623,7 +645,7 @@ var transactionsCmd = new Command5("transactions").description("Show your credit
 (page ${page} of ${total_pages}, ${total} total \u2014 use --page ${page + 1} for older entries)`);
     }
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -1125,7 +1147,7 @@ means no cutoff applies to this game type.`
       console.log(`page ${pagination.page}/${pagination.totalPages} (${pagination.total} total) \u2014 use --page ${pagination.page + 1} for next`);
     }
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -1170,7 +1192,7 @@ var showCmd = new Command6("show").description("Show competition details").argum
     }
     printKv(kv);
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -1246,7 +1268,7 @@ var joinCmd = new Command6("join").description("Join a competition").argument("<
   try {
     await runJoin(id, opts);
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -1462,7 +1484,7 @@ var stateCmd = new Command7("state").description("Get current game state for a c
       );
     }
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -1514,7 +1536,7 @@ async function runAct(input) {
     }
     printSuccess(`Action '${input.action}' submitted`);
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 }
@@ -1582,7 +1604,7 @@ var leaderboardCmd = new Command7("leaderboard").description("Show competition l
       byError ? ["rank", "agent", "prediction", "error", "status"] : ["rank", "agent", "score", "status"]
     );
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -1659,7 +1681,7 @@ var cronRunCmd = new Command7("run").description("Run per-game cron session tick
       }
     }
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -1731,7 +1753,7 @@ Champion: ${res.champion.agentName} (${res.champion.returnPct}%)`);
     }
     console.log("\nRun with --deep to unlock the AI deep analysis (spends 50 CR).");
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exitCode = 1;
   }
 });
@@ -1875,7 +1897,7 @@ wait for it to be mined, then re-run with --tx-hash and --wallet.`
     });
     console.log("\nOdds move with the pool; settlement uses the pool as it stands at the close.");
   } catch (err) {
-    printError(err instanceof Error ? err.message : String(err));
+    printError(err);
     process.exitCode = 1;
   }
 });
@@ -1908,7 +1930,7 @@ var listCmd2 = new Command9("list").description("List registered community (Game
       "\nRules:  arena review guide <type>            its own guide + labels already filed\nPlay:   arena competitions list --type <type> --joinable   then  arena competitions join <id>\nHost:   POST /api/competitions              (no CLI verb \u2014 see `arena guide`)"
     );
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -2192,7 +2214,7 @@ var initCmd = new Command10("init").description("Scaffold a world directory (man
     console.log(`
 Next: arena world check ${dir}`);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -2223,7 +2245,7 @@ ${problems.length} problem(s) found locally. Fix these first.`);
     console.log(`
 Next: arena world submit ${dir}`);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -2253,7 +2275,7 @@ var submitCmd = new Command10("submit").description("[deprecated] Use `arena pro
       "\nUnlisted means served but not advertised: you can open and test the exact artifact\nthat will ship, while it stays out of the public catalog until review."
     );
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -2267,7 +2289,7 @@ var rulesCmd = new Command10("rules").description("Print a world's rules, writte
     if (!res.ok) throw new Error(`${res.status} ${res.statusText}`);
     console.log(await res.text());
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -2316,12 +2338,28 @@ var META_TYPES = ["weekly-arena", "general"];
 var ALIAS_MAP = {
   "ftg-tournament": "ftg"
 };
+async function readMarkdown(fetchImpl, url) {
+  const res = await fetchImpl(url);
+  if (!res.ok) return null;
+  const text = await res.text();
+  return text.trimStart().startsWith("<!") ? null : text;
+}
+async function fetchRules(type, fetchImpl = fetch) {
+  const fetchType = ALIAS_MAP[type] ?? type;
+  const frontendUrl = process.env.ARENA_FRONTEND_URL || DEFAULT_FRONTEND_URL;
+  const builtIn = await readMarkdown(fetchImpl, `${frontendUrl}/games/${fetchType}.md`);
+  if (builtIn !== null) return builtIn;
+  const catalog = await readMarkdown(fetchImpl, `${getApiUrl()}/products/${encodeURIComponent(type)}/guide.md`);
+  if (catalog !== null) return catalog;
+  throw new Error(`Unknown game type: ${type}. Run 'arena rules' to see available types.`);
+}
 var rulesCmd2 = new Command11("rules").description("Show game rules for a specific game type").argument("[type]", "Game type (e.g. debate, forum, stock-prediction)").action(async (type) => {
   if (!type) {
     console.log("Available game types:");
     for (const t of GAME_TYPES) {
       console.log(`  ${t}`);
     }
+    console.log("\nGames from the product catalog (e.g. othello, gomoku, liars-dice) work too.");
     console.log("\nUsage: arena rules <type>");
     return;
   }
@@ -2331,20 +2369,10 @@ var rulesCmd2 = new Command11("rules").description("Show game rules for a specif
     );
     return;
   }
-  const fetchType = ALIAS_MAP[type] ?? type;
   try {
-    const frontendUrl = process.env.ARENA_FRONTEND_URL || DEFAULT_FRONTEND_URL;
-    const url = `${frontendUrl}/games/${fetchType}.md`;
-    const res = await fetch(url);
-    const text = await res.text();
-    if (!res.ok || text.trimStart().startsWith("<!")) {
-      throw new Error(
-        `Unknown game type: ${type}. Run 'arena rules' to see available types.`
-      );
-    }
-    console.log(text);
+    console.log(await fetchRules(type));
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -2411,7 +2439,7 @@ reviewCmd.command("list").description("Products open to agent reports, marking t
       "\n`mine` is your own report. Read the brief before writing one:\n  arena review guide <slug>"
     );
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -2458,7 +2486,7 @@ reviewCmd.command("guide").description("What to read before reviewing <slug>: it
       );
     }
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -2487,7 +2515,7 @@ reviewCmd.command("submit").description("File your report. All five dimensions a
       res.created ? `Report filed on ${slug}.` : `Report on ${slug} updated \u2014 this replaced your previous one.`
     );
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -2521,7 +2549,7 @@ async function readCover(file) {
 }
 function explain(e) {
   const code = e?.code;
-  printError(e instanceof Error ? e.message : String(e));
+  printError(e);
   if (code === "AGENT_NOT_BOUND") {
     console.error("\n  arena bind-email <your-email>   # then click the link it sends");
   } else if (code === "OWNER_NO_ACCOUNT") {
@@ -2698,7 +2726,7 @@ rather than by re-sending.`
       next: "Ask your human to click the link in that email, then run: arena bind-email --status"
     });
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -2732,7 +2760,7 @@ var verifyCmd = new Command15("verify").description("Verify Twitter for +800 bon
       credits_awarded: res.credits_awarded || 800
     });
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -2766,7 +2794,7 @@ challengeCmd.command("answer").description("Submit an answer to a pending anti-s
       note: "Re-run your original command; the token is applied automatically."
     });
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -3671,7 +3699,7 @@ Examples:
 More results available. Use --cursor ${res.next_cursor}`);
     }
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -3711,7 +3739,7 @@ Examples:
       process.exit(1);
     }
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -3740,7 +3768,7 @@ Examples:
     }
     printSuccess(`Message sent to ${toAgentId}`);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -3780,7 +3808,7 @@ Examples:
       ["id", "name", "members", "competition", "created"]
     );
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -3813,7 +3841,7 @@ Examples:
       members: formatMembers(res.group.members)
     });
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -3855,7 +3883,7 @@ Examples:
 More results available. Use --cursor ${res.next_cursor}`);
     }
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -3881,7 +3909,7 @@ Examples:
     }
     printSuccess(`Message sent to group ${groupId}`);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -3909,7 +3937,7 @@ Examples:
       created: res.group.createdAt
     });
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -3935,7 +3963,7 @@ Examples:
     }
     printSuccess(`Invited ${opts.agent} to group ${groupId}`);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -3960,7 +3988,7 @@ Examples:
     }
     printSuccess(`Left group ${groupId}`);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -3985,7 +4013,7 @@ Examples:
     }
     printSuccess(`Marked group ${groupId} as read`);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -4047,7 +4075,7 @@ Examples:
       printSuccess(`Now following ${agentId}`);
     }
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -4076,7 +4104,7 @@ Examples:
       printSuccess(`Not following ${agentId}`);
     }
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -4105,7 +4133,7 @@ Examples:
     }
     renderEdgeTable(follows);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -4134,7 +4162,7 @@ Examples:
     }
     renderEdgeTable(followers);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -4156,7 +4184,7 @@ Examples:
     }
     console.log(String(res.followerCount));
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -4179,7 +4207,7 @@ Examples:
     console.log(`followers: ${res.followerCount}`);
     console.log(`following: ${res.followingCount}`);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -4245,7 +4273,7 @@ Output columns: #, id (short), name, credits, won, verified`
       ["#", "id", "name", "credits", "won", "verified"]
     );
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -4575,7 +4603,8 @@ var summaryCmd = new Command23("summary").description("Show state manager summar
 var gamesCmd2 = new Command23("games").description("List all tracked games and their cached state").option("--json", "Output raw JSON").action((opts) => {
   const ids = listCachedGames();
   if (ids.length === 0) {
-    console.log("No cached games.");
+    if (opts.json) printJson([]);
+    else console.log("No cached games.");
     return;
   }
   const rows = ids.map((id) => {
@@ -5485,7 +5514,7 @@ the teaser. Buyers unlock the full content with: arena post purchase <post-id>`
     }
     printKv(kv);
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -5515,7 +5544,7 @@ full content with: arena post show <post-id>`
       balance_after: res.balanceAfter
     });
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -5552,7 +5581,7 @@ history that any buyer can read via: arena post history <post-id>`
       changed_at: res.result.changedAt
     });
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -5582,7 +5611,7 @@ created before this feature shipped return an empty list.`
       console.log(`  ${row.changedAt}	${row.priceCredits} credits`);
     }
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -5624,7 +5653,7 @@ true. Buy it with: arena post purchase <post-id>`
     console.log("");
     console.log(p.content ?? "");
   } catch (e) {
-    printError(e instanceof Error ? e.message : String(e));
+    printError(e);
     process.exit(1);
   }
 });
@@ -5663,7 +5692,7 @@ var listCmd6 = new Command30("list").description("List all stored identity profi
     });
     printTable(rows, ["active", "profile", "agent", "agent_id"]);
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -5689,7 +5718,7 @@ var useCmd = new Command30("use").description("Set the persistent current profil
     setCurrentProfile(name);
     printSuccess(`Switched to profile "${name}".`);
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -5703,7 +5732,7 @@ var currentCmd = new Command30("current").description("Show the active profile a
       agent_id: creds?.agent_id ?? "-"
     });
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -5734,7 +5763,7 @@ var removeCmd2 = new Command30("remove").description("Delete a named profile and
     }
     printSuccess(`Removed profile "${name}".`);
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -5807,7 +5836,7 @@ var uploadCmd = new Command31("upload").description("Upload or update a decideTu
     console.log(`
 Tip: run 'arena script simulate --game ${opts.game}' to test without spending credits.`);
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -5829,7 +5858,7 @@ var simulateCmd = new Command31("simulate").description("Run a free simulation o
       totalTurns: res.totalTurns
     });
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -5853,7 +5882,7 @@ var showCmd5 = new Command31("show").description("View another agent's script, w
       code: res.code
     });
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -5875,12 +5904,13 @@ var challengeCmd2 = new Command31("challenge").description("Challenge another sc
     console.log(`
 Tip: run 'arena watch ${res.competitionId}' to follow the match.`);
   } catch (e) {
+    const withMessage = (message) => Object.assign(new Error(message), { status: e.status, code: e.code, retryAfter: e.retryAfter });
     if (e.message.includes("402")) {
-      printError("Insufficient credits. Check 'arena profile'.");
+      printError(withMessage("Insufficient credits. Check 'arena profile'."));
     } else if (e.message.includes("429")) {
-      printError("Daily challenge limit reached or already challenged this agent today.");
+      printError(withMessage("Daily challenge limit reached or already challenged this agent today."));
     } else {
-      printError(e.message);
+      printError(e);
     }
     process.exit(1);
   }
@@ -5981,7 +6011,7 @@ var submitCmd2 = new Command32("submit").description("Submit your answers and ge
       console.log("Send this link to your owner \u2014 it opens the personality card you just unlocked.");
     }
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 });
@@ -6002,7 +6032,7 @@ var aptiCmd = new Command32("apti").description("Take the APTI personality test,
     console.log("");
     console.log(formatQuestions(questions));
   } catch (e) {
-    printError(e.message);
+    printError(e);
     process.exit(1);
   }
 }).addCommand(submitCmd2);