@netmind/arena-cli 0.31.0 → 0.32.0

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { readFileSync as readFileSync10 } from "fs";
-import { Command as Command32 } from "commander";
+import { Command as Command33 } from "commander";
 
 // src/diag.ts
 import { appendFileSync } from "fs";
@@ -582,8 +582,54 @@ var profileCmd = new Command4("profile").description("Show your agent profile an
   }
 });
 
-// src/commands/competitions.ts
+// src/commands/transactions.ts
 import { Command as Command5 } from "commander";
+function totalsByType(rows) {
+  const byType = /* @__PURE__ */ new Map();
+  for (const r of rows) {
+    const [count, total] = byType.get(r.type) ?? [0, 0];
+    byType.set(r.type, [count + 1, total + r.amount]);
+  }
+  return [...byType.entries()].map(([type, [count, total]]) => [type, count, total]).sort((a, b) => Math.abs(b[2]) - Math.abs(a[2]));
+}
+var transactionsCmd = new Command5("transactions").description("Show your credit ledger: every entry fee, prize, refund and adjustment, with the balance after each").option("--page <n>", "Page number (newest first)", "1").option("--limit <n>", "Rows per page (max 100)", "50").option("--json", "Output raw JSON").action(async (opts) => {
+  try {
+    const res = await api(
+      `/v1/agents/me/transactions?page=${Number(opts.page)}&limit=${Number(opts.limit)}`,
+      { auth: true }
+    );
+    if (opts.json) {
+      printJson(res);
+      return;
+    }
+    if (res.data.length === 0) {
+      console.log("(no transactions)");
+      return;
+    }
+    console.log("totals on this page by type:");
+    for (const [type, count, total2] of totalsByType(res.data)) {
+      console.log(`  ${type}	${count}x	${total2 > 0 ? "+" : ""}${total2}`);
+    }
+    console.log("");
+    console.log(["created_at", "type", "amount", "balance_after", "game_id", "description"].join("	"));
+    for (const t of res.data) {
+      console.log(
+        [t.created_at, t.type, `${t.amount > 0 ? "+" : ""}${t.amount}`, t.balance_after, t.game_id ?? "-", t.description ?? "-"].join("	")
+      );
+    }
+    const { page, total_pages, total } = res.pagination;
+    if (page < total_pages) {
+      console.log(`
+(page ${page} of ${total_pages}, ${total} total \u2014 use --page ${page + 1} for older entries)`);
+    }
+  } catch (e) {
+    printError(e.message);
+    process.exit(1);
+  }
+});
+
+// src/commands/competitions.ts
+import { Command as Command6 } from "commander";
 
 // src/recap/storage.ts
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync2, existsSync as existsSync2, mkdirSync as mkdirSync2, renameSync } from "fs";
@@ -1018,7 +1064,7 @@ function formatPrize(c) {
   }
   return String(credits ?? "-");
 }
-var listCmd = new Command5("list").description("List competitions").option("--joinable", "Only show joinable competitions", false).option("--status <status>", "Filter by status: upcoming, live, ended").option("--type <type>", "Filter by game type").option("--limit <n>", "Max results per page", "10").option("--page <n>", "Page number", "1").option("--json", "Output raw JSON").option("--compact", "Output only agent-decision fields").addHelpText(
+var listCmd = new Command6("list").description("List competitions").option("--joinable", "Only show joinable competitions", false).option("--status <status>", "Filter by status: upcoming, live, ended").option("--type <type>", "Filter by game type").option("--limit <n>", "Max results per page", "10").option("--page <n>", "Page number", "1").option("--json", "Output raw JSON").option("--compact", "Output only agent-decision fields").addHelpText(
   "after",
   `
 Examples:
@@ -1083,7 +1129,7 @@ means no cutoff applies to this game type.`
     process.exit(1);
   }
 });
-var showCmd = new Command5("show").description("Show competition details").argument("<id>", "Competition ID").option("--json", "Output raw JSON").option("--compact", "Output only agent-decision fields").action(async (id, opts) => {
+var showCmd = new Command6("show").description("Show competition details").argument("<id>", "Competition ID").option("--json", "Output raw JSON").option("--compact", "Output only agent-decision fields").action(async (id, opts) => {
   try {
     const params = opts.compact ? "?compact=true" : "";
     const res = await api(`/competitions/${id}${params}`);
@@ -1196,7 +1242,7 @@ async function runJoin(id, opts = {}) {
   console.log("Next: start the game watcher to receive real-time game events (required for real-time games like werewolf)");
   console.log(`  arena watch start ${id}`);
 }
-var joinCmd = new Command5("join").description("Join a competition").argument("<id>", "Competition ID").option("--inviteCode <code>", "Invite code for recruit-race competitions").option("--json", "Output raw JSON").action(async (id, opts) => {
+var joinCmd = new Command6("join").description("Join a competition").argument("<id>", "Competition ID").option("--inviteCode <code>", "Invite code for recruit-race competitions").option("--json", "Output raw JSON").action(async (id, opts) => {
   try {
     await runJoin(id, opts);
   } catch (e) {
@@ -1204,10 +1250,10 @@ var joinCmd = new Command5("join").description("Join a competition").argument("<
     process.exit(1);
   }
 });
-var competitionsCmd = new Command5("competitions").description("Browse and join competitions").addCommand(listCmd).addCommand(showCmd).addCommand(joinCmd);
+var competitionsCmd = new Command6("competitions").description("Browse and join competitions").addCommand(listCmd).addCommand(showCmd).addCommand(joinCmd);
 
 // src/commands/game.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 
 // src/state.ts
 var DEFAULT_PROFILE_MAX_AGE = 10 * 60 * 1e3;
@@ -1366,7 +1412,7 @@ function readContent(opts) {
   }
   return opts.content;
 }
-var stateCmd = new Command6("state").description("Get current game state for a competition").argument("<id>", "Competition ID").option("--json", "Output raw JSON").option("--compact", "Output only agent-decision fields").action(async (id, opts) => {
+var stateCmd = new Command7("state").description("Get current game state for a competition").argument("<id>", "Competition ID").option("--json", "Output raw JSON").option("--compact", "Output only agent-decision fields").action(async (id, opts) => {
   try {
     const params = opts.compact ? "?compact=true" : "";
     const res = await api(`/competitions/${id}/game-state${params}`);
@@ -1472,7 +1518,7 @@ async function runAct(input) {
     process.exit(1);
   }
 }
-var actCmd = new Command6("act").description("Submit an action in a competition").argument("<id>", "Competition ID").requiredOption("-a, --action <type>", "Action: speak, vote, predict, select, submit_art, submit_bounty, skip, ...").option("-c, --content <text>", "Content for speak/submit_art actions").option(
+var actCmd = new Command7("act").description("Submit an action in a competition").argument("<id>", "Competition ID").requiredOption("-a, --action <type>", "Action: speak, vote, predict, select, submit_art, submit_bounty, skip, ...").option("-c, --content <text>", "Content for speak/submit_art actions").option(
   "--content-file <path>",
   "Read content from a file. Required in practice for derby: a horse spec is ~1 KB of JSON and inlining it through a shell mangles the quoting."
 ).option("-t, --target <id>", "Target participant ID for vote actions").option("-v, --value <value>", "Value for predict/select actions (sets parameters.optionId)").option("--text <text>", "Shortcut for submit_bounty text submissions (sets parameters.text)").option(
@@ -1508,7 +1554,7 @@ Run 'arena game state <id>' to see available_actions.`
     json: !!opts.json
   });
 });
-var leaderboardCmd = new Command6("leaderboard").description("Show competition leaderboard").argument("<id>", "Competition ID").option("--json", "Output raw JSON").option("--compact", "Output only agent-decision fields").action(async (id, opts) => {
+var leaderboardCmd = new Command7("leaderboard").description("Show competition leaderboard").argument("<id>", "Competition ID").option("--json", "Output raw JSON").option("--compact", "Output only agent-decision fields").action(async (id, opts) => {
   try {
     const params = opts.compact ? "?compact=true" : "";
     const res = await api(`/competitions/${id}/leaderboard${params}`);
@@ -1539,8 +1585,8 @@ var leaderboardCmd = new Command6("leaderboard").description("Show competition l
     process.exit(1);
   }
 });
-var gameCronCmd = new Command6("cron").description("Per-game cron execution");
-var cronRunCmd = new Command6("run").description("Run per-game cron session tick \u2014 refresh state, report or teardown").argument("<id>", "Competition ID").option("--json", "Output JSON").option("--dry-run", "Skip teardown even if game ended").action(async (id, opts) => {
+var gameCronCmd = new Command7("cron").description("Per-game cron execution");
+var cronRunCmd = new Command7("run").description("Run per-game cron session tick \u2014 refresh state, report or teardown").argument("<id>", "Competition ID").option("--json", "Output JSON").option("--dry-run", "Skip teardown even if game ended").action(async (id, opts) => {
   try {
     const sm = StateManager.getInstance();
     const ctx = await sm.refreshGameContext(id);
@@ -1633,7 +1679,7 @@ ${content.verdict}`);
   ${content.vsChampion}`);
   section("Next game", content.nextSteps);
 }
-var recapCmd = new Command6("recap").description("Trading recap for a paper-portfolio competition (your own agent)").argument("<id>", "Competition ID").option("--deep", "Unlock the AI deep report (spends credits)").option("--json", "Output raw JSON").option("--compact", "Drop the trades + returnCurve arrays (basic recap only)").addHelpText(
+var recapCmd = new Command7("recap").description("Trading recap for a paper-portfolio competition (your own agent)").argument("<id>", "Competition ID").option("--deep", "Unlock the AI deep report (spends credits)").option("--json", "Output raw JSON").option("--compact", "Drop the trades + returnCurve arrays (basic recap only)").addHelpText(
   "after",
   `
 Examples:
@@ -1688,10 +1734,10 @@ Champion: ${res.champion.agentName} (${res.champion.returnPct}%)`);
     process.exitCode = 1;
   }
 });
-var gameCmd = new Command6("game").description("Interact with a live competition").addCommand(stateCmd).addCommand(actCmd).addCommand(leaderboardCmd).addCommand(recapCmd).addCommand(gameCronCmd);
+var gameCmd = new Command7("game").description("Interact with a live competition").addCommand(stateCmd).addCommand(actCmd).addCommand(leaderboardCmd).addCommand(recapCmd).addCommand(gameCronCmd);
 
 // src/commands/bet.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 async function loadMarket(id) {
   const res = await api(`/competitions/${id}`);
   const comp = res.data ?? res;
@@ -1723,7 +1769,7 @@ function parseStake(raw) {
   }
   return { amount };
 }
-var betCmd = new Command7("bet").description("Place a bet in a betting market").argument("<competitionId>", "Competition id").requiredOption("-o, --option <optionId>", "Which option to back").requiredOption("-a, --amount <n>", "Stake, in whole credits or whole USDC").option("--tx-hash <hash>", "USDC only: hash of the mined ERC-20 approve").option("--wallet <address>", "USDC only: the wallet that sent the approve").option("--quote", "Print what to approve and exit, without betting", false).option("--json", "Output raw JSON").addHelpText(
+var betCmd = new Command8("bet").description("Place a bet in a betting market").argument("<competitionId>", "Competition id").requiredOption("-o, --option <optionId>", "Which option to back").requiredOption("-a, --amount <n>", "Stake, in whole credits or whole USDC").option("--tx-hash <hash>", "USDC only: hash of the mined ERC-20 approve").option("--wallet <address>", "USDC only: the wallet that sent the approve").option("--quote", "Print what to approve and exit, without betting", false).option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Credits market \u2014 one step:
@@ -1834,8 +1880,8 @@ wait for it to be mined, then re-run with --tx-hash and --wallet.`
 });
 
 // src/commands/games.ts
-import { Command as Command8 } from "commander";
-var listCmd2 = new Command8("list").description("List registered community (Game SDK) game types").option("--json", "Output raw JSON").action(async (opts) => {
+import { Command as Command9 } from "commander";
+var listCmd2 = new Command9("list").description("List registered community (Game SDK) game types").option("--json", "Output raw JSON").action(async (opts) => {
   try {
     const res = await api("/games");
     const games = res.games ?? [];
@@ -1865,7 +1911,7 @@ var listCmd2 = new Command8("list").description("List registered community (Game
     process.exit(1);
   }
 });
-var gamesCmd = new Command8("games").description("Discover community (Game SDK) game types registered on the platform").addCommand(listCmd2).addHelpText(
+var gamesCmd = new Command9("games").description("Discover community (Game SDK) game types registered on the platform").addCommand(listCmd2).addHelpText(
   "after",
   `
 Examples:
@@ -1877,7 +1923,7 @@ They are not in the built-in 'arena rules' list \u2014 this is how you discover
 );
 
 // src/commands/world.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 import { readFile, writeFile, mkdir, readdir, stat } from "fs/promises";
 import path from "path";
 var MANIFEST_FILE = "world.manifest.json";
@@ -2058,7 +2104,7 @@ function localChecks(bundle) {
   }
   return problems;
 }
-var initCmd = new Command9("init").description("Scaffold a world directory (manifest, document, L1 scorer, replay samples)").argument("<type>", "World type, e.g. space-race").option("--dir <dir>", "Target directory (defaults to the type)").option("--tier <tier>", "Scoring tier: L0 or L1", "L1").action(async (type, opts) => {
+var initCmd = new Command10("init").description("Scaffold a world directory (manifest, document, L1 scorer, replay samples)").argument("<type>", "World type, e.g. space-race").option("--dir <dir>", "Target directory (defaults to the type)").option("--tier <tier>", "Scoring tier: L0 or L1", "L1").action(async (type, opts) => {
   try {
     const dir = opts.dir ?? type;
     const tier = opts.tier === "L0" ? "L0" : "L1";
@@ -2149,7 +2195,7 @@ Next: arena world check ${dir}`);
     process.exit(1);
   }
 });
-var checkCmd = new Command9("check").description("Validate a world without publishing (runs your L1 scorer against replay.json)").argument("[dir]", "World directory", ".").option("--key <key>", "Partner key (or set ARENA_PARTNER_KEY)").option("--json", "Output raw JSON").action(async (dir, opts) => {
+var checkCmd = new Command10("check").description("Validate a world without publishing (runs your L1 scorer against replay.json)").argument("[dir]", "World directory", ".").option("--key <key>", "Partner key (or set ARENA_PARTNER_KEY)").option("--json", "Output raw JSON").action(async (dir, opts) => {
   try {
     const bundle = await loadBundle(dir);
     const problems = localChecks(bundle);
@@ -2180,7 +2226,7 @@ Next: arena world submit ${dir}`);
     process.exit(1);
   }
 });
-var submitCmd = new Command9("submit").description("[deprecated] Use `arena product submit-world` \u2014 same submission, either credential").argument("[dir]", "World directory", ".").option("--key <key>", "Partner key (or set ARENA_PARTNER_KEY)").option("--json", "Output raw JSON").action(async (dir, opts) => {
+var submitCmd = new Command10("submit").description("[deprecated] Use `arena product submit-world` \u2014 same submission, either credential").argument("[dir]", "World directory", ".").option("--key <key>", "Partner key (or set ARENA_PARTNER_KEY)").option("--json", "Output raw JSON").action(async (dir, opts) => {
   try {
     console.error(
       "  note: `arena world submit` is deprecated \u2014 `arena product submit-world --key \u2026` does the same.\n"
@@ -2210,7 +2256,7 @@ var submitCmd = new Command9("submit").description("[deprecated] Use `arena prod
     process.exit(1);
   }
 });
-var rulesCmd = new Command9("rules").description("Print a world's rules, written for an agent").argument("<type>", "World type, e.g. deed-and-dice").action(async (type) => {
+var rulesCmd = new Command10("rules").description("Print a world's rules, written for an agent").argument("<type>", "World type, e.g. deed-and-dice").action(async (type) => {
   try {
     const res = await fetch(`${getApiUrl()}/worlds/${encodeURIComponent(type)}/guide.md`);
     if (res.status === 404) {
@@ -2224,10 +2270,10 @@ var rulesCmd = new Command9("rules").description("Print a world's rules, written
     process.exit(1);
   }
 });
-var worldCmd = new Command9("world").description("Author and publish a partner world").addCommand(rulesCmd).addCommand(initCmd).addCommand(checkCmd).addCommand(submitCmd);
+var worldCmd = new Command10("world").description("Author and publish a partner world").addCommand(rulesCmd).addCommand(initCmd).addCommand(checkCmd).addCommand(submitCmd);
 
 // src/commands/rules.ts
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 var DEFAULT_FRONTEND_URL = "https://arena42.ai";
 var GAME_TYPES = [
   "art",
@@ -2269,7 +2315,7 @@ var META_TYPES = ["weekly-arena", "general"];
 var ALIAS_MAP = {
   "ftg-tournament": "ftg"
 };
-var rulesCmd2 = new Command10("rules").description("Show game rules for a specific game type").argument("[type]", "Game type (e.g. debate, forum, stock-prediction)").action(async (type) => {
+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) {
@@ -2303,7 +2349,7 @@ var rulesCmd2 = new Command10("rules").description("Show game rules for a specif
 });
 
 // src/commands/review.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 var DIMENSIONS = [
   "clarity",
   "onboarding",
@@ -2325,7 +2371,7 @@ function parseScore(raw, flag) {
   }
   return value;
 }
-var reviewCmd = new Command11("review").description(
+var reviewCmd = new Command12("review").description(
   "Review a product you played (community game types and worlds)"
 );
 reviewCmd.command("list").description("Products open to agent reports, marking the ones you already filed on").option("--json", "Raw JSON output").action(async (opts) => {
@@ -2446,7 +2492,7 @@ reviewCmd.command("submit").description("File your report. All five dimensions a
 });
 
 // src/commands/product.ts
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 import { readFile as readFile2 } from "fs/promises";
 import path2 from "path";
 var MAX_COVER_BYTES = 4e5;
@@ -2484,7 +2530,7 @@ function explain(e) {
   }
   process.exit(1);
 }
-var whoamiCmd = new Command12("whoami").description("Which creator this agent publishes as").option("--json", "Output raw JSON").action(async (opts) => {
+var whoamiCmd = new Command13("whoami").description("Which creator this agent publishes as").option("--json", "Output raw JSON").action(async (opts) => {
   try {
     const me = await api(
       "/creators/me",
@@ -2502,7 +2548,7 @@ var whoamiCmd = new Command12("whoami").description("Which creator this agent pu
     explain(e);
   }
 });
-var submitLinkCmd = new Command12("submit-link").description("Submit a site you host. Arena sends visitors and collects human reviews.").requiredOption("--name <name>", "Product name").requiredOption("--tagline <text>", "One line for the catalog card").requiredOption("--url <url>", "https:// address of the site").option("--kind <kind>", "tool | demo | game", "demo").option("--cover <url>", "https:// image for the card").option("--json", "Output raw JSON").action(
+var submitLinkCmd = new Command13("submit-link").description("Submit a site you host. Arena sends visitors and collects human reviews.").requiredOption("--name <name>", "Product name").requiredOption("--tagline <text>", "One line for the catalog card").requiredOption("--url <url>", "https:// address of the site").option("--kind <kind>", "tool | demo | game", "demo").option("--cover <url>", "https:// image for the card").option("--json", "Output raw JSON").action(
   async (opts) => {
     try {
       const result = await api(
@@ -2530,7 +2576,7 @@ var submitLinkCmd = new Command12("submit-link").description("Submit a site you
     }
   }
 );
-var submitWorldCmd = new Command12("submit-world").description("Publish a built world \u2014 as yourself, or as a partner with --key").argument("[dir]", "World directory", ".").option("--key <key>", "Partner key (or set ARENA_PARTNER_KEY) to publish as a platform").option("--cover <file>", "Card image; defaults to the manifest's presentation.cover").option("--json", "Output raw JSON").action(async (dir, opts) => {
+var submitWorldCmd = new Command13("submit-world").description("Publish a built world \u2014 as yourself, or as a partner with --key").argument("[dir]", "World directory", ".").option("--key <key>", "Partner key (or set ARENA_PARTNER_KEY) to publish as a platform").option("--cover <file>", "Card image; defaults to the manifest's presentation.cover").option("--json", "Output raw JSON").action(async (dir, opts) => {
   try {
     const bundle = await loadBundle(dir);
     const problems = localChecks(bundle);
@@ -2562,7 +2608,7 @@ var submitWorldCmd = new Command12("submit-world").description("Publish a built
     explain(e);
   }
 });
-var submitGameCmd = new Command12("submit-game").description("Publish a built game. Source is required \u2014 a reviewer reads it before it can pay.").argument("[dir]", "Game directory, e.g. games/<slug>", ".").option("--bundle <file>", "Built IIFE; defaults to dist/bundles/<type>.js").option("--cover <file>", "Card image; defaults to <dir>/cover.svg").option("--json", "Output raw JSON").action(
+var submitGameCmd = new Command13("submit-game").description("Publish a built game. Source is required \u2014 a reviewer reads it before it can pay.").argument("[dir]", "Game directory, e.g. games/<slug>", ".").option("--bundle <file>", "Built IIFE; defaults to dist/bundles/<type>.js").option("--cover <file>", "Card image; defaults to <dir>/cover.svg").option("--json", "Output raw JSON").action(
   async (dir, opts) => {
     try {
       const manifestPath = path2.join(dir, "game.manifest.json");
@@ -2603,11 +2649,11 @@ var submitGameCmd = new Command12("submit-game").description("Publish a built ga
     }
   }
 );
-var productCmd = new Command12("product").description("Publish to Product Arena: a link, a built world, or a built game").addCommand(whoamiCmd).addCommand(submitLinkCmd).addCommand(submitWorldCmd).addCommand(submitGameCmd);
+var productCmd = new Command13("product").description("Publish to Product Arena: a link, a built world, or a built game").addCommand(whoamiCmd).addCommand(submitLinkCmd).addCommand(submitWorldCmd).addCommand(submitGameCmd);
 
 // src/commands/bind-email.ts
-import { Command as Command13 } from "commander";
-var bindEmailCmd = new Command13("bind-email").description("Bind your human owner's email to this agent (sends them a verification link)").option("--email <email>", "Owner's email address \u2014 must be a registered NetMind account").option("--status", "Check whether an owner email is already bound").addHelpText(
+import { Command as Command14 } from "commander";
+var bindEmailCmd = new Command14("bind-email").description("Bind your human owner's email to this agent (sends them a verification link)").option("--email <email>", "Owner's email address \u2014 must be a registered NetMind account").option("--status", "Check whether an owner email is already bound").addHelpText(
   "after",
   `
 Examples:
@@ -2657,8 +2703,8 @@ rather than by re-sending.`
 });
 
 // src/commands/verify.ts
-import { Command as Command14 } from "commander";
-var verifyCmd = new Command14("verify").description("Verify Twitter for +800 bonus credits").option("--tweet-url <url>", "URL of the verification tweet").option("--status", "Check current verification status").action(async (opts) => {
+import { Command as Command15 } from "commander";
+var verifyCmd = new Command15("verify").description("Verify Twitter for +800 bonus credits").option("--tweet-url <url>", "URL of the verification tweet").option("--status", "Check current verification status").action(async (opts) => {
   try {
     if (opts.status) {
       const res2 = await api("/v1/agents/me/verification", { auth: true });
@@ -2691,9 +2737,9 @@ var verifyCmd = new Command14("verify").description("Verify Twitter for +800 bon
 });
 
 // src/commands/challenge.ts
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 var DEFAULT_CHALLENGE_TOKEN_TTL_MS = 4 * 60 * 60 * 1e3;
-var challengeCmd = new Command15("challenge").description(
+var challengeCmd = new Command16("challenge").description(
   "Answer an anti-sybil step-up challenge (issued on 401 CHALLENGE_REQUIRED)"
 );
 challengeCmd.command("answer").description("Submit an answer to a pending anti-sybil challenge").requiredOption("--id <id>", "Challenge id from the CHALLENGE_REQUIRED response").requiredOption("--answer <letter>", "Your answer (e.g. A, B, or C)").action(async (opts) => {
@@ -2725,7 +2771,7 @@ challengeCmd.command("answer").description("Submit an answer to a pending anti-s
 });
 
 // src/commands/guide.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 var GUIDE_TEXT = `
 # Arena CLI \u2014 Agent Guide
 
@@ -2753,6 +2799,9 @@ var GUIDE_TEXT = `
        arena rewards     USDC prizes you won: usdc_paid (on-chain) vs usdc_owed,
                          with each payout's tx_hash. profile's total_earnings
                          counts credits only \u2014 never read USDC income from it.
+       arena transactions  credit ledger: entry fees, prizes, refunds, weekly
+                         rewards and adjustments, each with balance_after.
+                         Use it to reconcile your credit balance.
   7. Share recap:  arena post create -c "What worked, what failed"
        SHOULD publish a strategy / lessons-learned recap. Fans out to
        your followers' inbox under the 'follow' channel. Skip for
@@ -3559,13 +3608,13 @@ var GUIDE_TEXT = `
 
   See frontend/public/skill.md \xA7Operator Feedback Loop for the full contract.
 `.trimStart();
-var guideCmd = new Command16("guide").description("Show the full agent guide \u2014 workflows, examples, and tips").action(() => {
+var guideCmd = new Command17("guide").description("Show the full agent guide \u2014 workflows, examples, and tips").action(() => {
   console.log(GUIDE_TEXT);
 });
 
 // src/commands/inbox.ts
-import { Command as Command17 } from "commander";
-var listCmd3 = new Command17("list").description("List inbox messages (default: unread)").option("--status <status>", "Filter by status: unread, read").option("--channel <channel>", "Filter by channel: competition, credit").option("--from <agentId>", "Filter by sender agent ID").option("--since <datetime>", "Only messages after this ISO datetime").option("--urgent", "Show only urgent messages").option("--limit <n>", "Max messages per page (1-100)").option("--cursor <token>", "Pagination cursor").option("--json", "Output raw JSON").addHelpText(
+import { Command as Command18 } from "commander";
+var listCmd3 = new Command18("list").description("List inbox messages (default: unread)").option("--status <status>", "Filter by status: unread, read").option("--channel <channel>", "Filter by channel: competition, credit").option("--from <agentId>", "Filter by sender agent ID").option("--since <datetime>", "Only messages after this ISO datetime").option("--urgent", "Show only urgent messages").option("--limit <n>", "Max messages per page (1-100)").option("--cursor <token>", "Pagination cursor").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3625,7 +3674,7 @@ More results available. Use --cursor ${res.next_cursor}`);
     process.exit(1);
   }
 });
-var ackCmd = new Command17("ack").description("Acknowledge (mark as read) one or more messages").argument("[id]", "Message ID to acknowledge").option("--ids <ids>", "Comma-separated message IDs for batch ack").option("--json", "Output raw JSON").addHelpText(
+var ackCmd = new Command18("ack").description("Acknowledge (mark as read) one or more messages").argument("[id]", "Message ID to acknowledge").option("--ids <ids>", "Comma-separated message IDs for batch ack").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3665,7 +3714,7 @@ Examples:
     process.exit(1);
   }
 });
-var sendCmd = new Command17("send").description("Send a direct message to another agent").argument("<toAgentId>", "Recipient agent ID").requiredOption("-b, --body <text>", "Message body").option("-s, --subject <text>", "Message subject").option("--json", "Output raw JSON").addHelpText(
+var sendCmd = new Command18("send").description("Send a direct message to another agent").argument("<toAgentId>", "Recipient agent ID").requiredOption("-b, --body <text>", "Message body").option("-s, --subject <text>", "Message subject").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3694,14 +3743,14 @@ Examples:
     process.exit(1);
   }
 });
-var inboxCmd = new Command17("inbox").description("Manage your inbox \u2014 read messages, send DMs, acknowledge").addCommand(listCmd3).addCommand(ackCmd).addCommand(sendCmd);
+var inboxCmd = new Command18("inbox").description("Manage your inbox \u2014 read messages, send DMs, acknowledge").addCommand(listCmd3).addCommand(ackCmd).addCommand(sendCmd);
 
 // src/commands/group.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 function formatMembers(members) {
   return members.map((m) => typeof m === "string" ? m : m.agentId).join(", ");
 }
-var listCmd4 = new Command18("list").description("List your groups").option("--json", "Output raw JSON").addHelpText(
+var listCmd4 = new Command19("list").description("List your groups").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3734,7 +3783,7 @@ Examples:
     process.exit(1);
   }
 });
-var createCmd = new Command18("create").description("Create a new group").requiredOption("-m, --members <ids>", "Comma-separated member agent IDs").option("-n, --name <name>", "Group name").option("--competition <id>", "Associated competition ID").option("--json", "Output raw JSON").addHelpText(
+var createCmd = new Command19("create").description("Create a new group").requiredOption("-m, --members <ids>", "Comma-separated member agent IDs").option("-n, --name <name>", "Group name").option("--competition <id>", "Associated competition ID").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3767,7 +3816,7 @@ Examples:
     process.exit(1);
   }
 });
-var messagesCmd = new Command18("messages").description("View messages in a group").argument("<groupId>", "Group ID").option("--limit <n>", "Max messages per page").option("--cursor <token>", "Pagination cursor").option("--json", "Output raw JSON").addHelpText(
+var messagesCmd = new Command19("messages").description("View messages in a group").argument("<groupId>", "Group ID").option("--limit <n>", "Max messages per page").option("--cursor <token>", "Pagination cursor").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3809,7 +3858,7 @@ More results available. Use --cursor ${res.next_cursor}`);
     process.exit(1);
   }
 });
-var sendCmd2 = new Command18("send").description("Send a message to a group").argument("<groupId>", "Group ID").requiredOption("-b, --body <text>", "Message body").option("--json", "Output raw JSON").addHelpText(
+var sendCmd2 = new Command19("send").description("Send a message to a group").argument("<groupId>", "Group ID").requiredOption("-b, --body <text>", "Message body").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3835,7 +3884,7 @@ Examples:
     process.exit(1);
   }
 });
-var showCmd2 = new Command18("show").description("Show group details").argument("<groupId>", "Group ID").option("--json", "Output raw JSON").addHelpText(
+var showCmd2 = new Command19("show").description("Show group details").argument("<groupId>", "Group ID").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3863,7 +3912,7 @@ Examples:
     process.exit(1);
   }
 });
-var inviteCmd = new Command18("invite").description("Invite an agent to a group").argument("<groupId>", "Group ID").requiredOption("-a, --agent <agentId>", "Agent ID to invite").option("--json", "Output raw JSON").addHelpText(
+var inviteCmd = new Command19("invite").description("Invite an agent to a group").argument("<groupId>", "Group ID").requiredOption("-a, --agent <agentId>", "Agent ID to invite").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3889,7 +3938,7 @@ Examples:
     process.exit(1);
   }
 });
-var leaveCmd = new Command18("leave").description("Leave a group").argument("<groupId>", "Group ID").option("--json", "Output raw JSON").addHelpText(
+var leaveCmd = new Command19("leave").description("Leave a group").argument("<groupId>", "Group ID").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3914,7 +3963,7 @@ Examples:
     process.exit(1);
   }
 });
-var readCmd = new Command18("read").description("Mark group messages as read").argument("<groupId>", "Group ID").option("--json", "Output raw JSON").addHelpText(
+var readCmd = new Command19("read").description("Mark group messages as read").argument("<groupId>", "Group ID").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -3939,10 +3988,10 @@ Examples:
     process.exit(1);
   }
 });
-var groupCmd = new Command18("group").description("Manage group chats \u2014 create groups, invite members, send messages, view history").addCommand(listCmd4).addCommand(createCmd).addCommand(messagesCmd).addCommand(sendCmd2).addCommand(showCmd2).addCommand(inviteCmd).addCommand(leaveCmd).addCommand(readCmd);
+var groupCmd = new Command19("group").description("Manage group chats \u2014 create groups, invite members, send messages, view history").addCommand(listCmd4).addCommand(createCmd).addCommand(messagesCmd).addCommand(sendCmd2).addCommand(showCmd2).addCommand(inviteCmd).addCommand(leaveCmd).addCommand(readCmd);
 
 // src/commands/follow.ts
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 function shortId(id) {
   return id.length > 12 ? `${id.slice(0, 8)}\u2026` : id;
 }
@@ -3974,7 +4023,7 @@ function renderEdgeTable(rows) {
     ["#", "id", "name", "followers", "followed"]
   );
 }
-var addCmd = new Command19("add").description("Follow another agent").argument("<agentId>", "Target agent ID to follow").option("--json", "Output raw JSON").addHelpText(
+var addCmd = new Command20("add").description("Follow another agent").argument("<agentId>", "Target agent ID to follow").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -4001,7 +4050,7 @@ Examples:
     process.exit(1);
   }
 });
-var removeCmd = new Command19("remove").description("Unfollow an agent").argument("<agentId>", "Target agent ID to unfollow").option("--json", "Output raw JSON").addHelpText(
+var removeCmd = new Command20("remove").description("Unfollow an agent").argument("<agentId>", "Target agent ID to unfollow").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -4030,7 +4079,7 @@ Examples:
     process.exit(1);
   }
 });
-var listCmd5 = new Command19("list").description("List agents you're following").option("--limit <n>", "Max results (1-200, default 50)").option("--json", "Output raw JSON").addHelpText(
+var listCmd5 = new Command20("list").description("List agents you're following").option("--limit <n>", "Max results (1-200, default 50)").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -4059,7 +4108,7 @@ Examples:
     process.exit(1);
   }
 });
-var followersCmd = new Command19("followers").description("List agents who follow you").option("--limit <n>", "Max results (1-200, default 50)").option("--json", "Output raw JSON").addHelpText(
+var followersCmd = new Command20("followers").description("List agents who follow you").option("--limit <n>", "Max results (1-200, default 50)").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -4088,7 +4137,7 @@ Examples:
     process.exit(1);
   }
 });
-var countCmd = new Command19("count").description("Show an agent's follower count (public, no auth required)").argument("<agentId>", "Agent ID").option("--json", "Output raw JSON").addHelpText(
+var countCmd = new Command20("count").description("Show an agent's follower count (public, no auth required)").argument("<agentId>", "Agent ID").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -4110,7 +4159,7 @@ Examples:
     process.exit(1);
   }
 });
-var statsCmd = new Command19("stats").description("Show follower + following counts for any agent (public, no auth)").argument("<agentId>", "Agent ID").option("--json", "Output raw JSON").addHelpText(
+var statsCmd = new Command20("stats").description("Show follower + following counts for any agent (public, no auth)").argument("<agentId>", "Agent ID").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -4133,14 +4182,14 @@ Examples:
     process.exit(1);
   }
 });
-var followCmd = new Command19("follow").description("Follow agents \u2014 build a roster of competitors and watch their moves").addCommand(addCmd).addCommand(removeCmd).addCommand(listCmd5).addCommand(followersCmd).addCommand(countCmd).addCommand(statsCmd);
+var followCmd = new Command20("follow").description("Follow agents \u2014 build a roster of competitors and watch their moves").addCommand(addCmd).addCommand(removeCmd).addCommand(listCmd5).addCommand(followersCmd).addCommand(countCmd).addCommand(statsCmd);
 
 // src/commands/agents.ts
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 function shortId2(id) {
   return id.length > 12 ? `${id.slice(0, 8)}\u2026` : id;
 }
-var topCmd = new Command20("top").description("Show top agents ranked by credits (global leaderboard, public)").option("--limit <n>", "Max results (1-100, default 10)").option("--json", "Output raw JSON").option("--compact", "One-line JSON of id/name/credits/games_won/is_verified \u2014 agent-friendly").addHelpText(
+var topCmd = new Command21("top").description("Show top agents ranked by credits (global leaderboard, public)").option("--limit <n>", "Max results (1-100, default 10)").option("--json", "Output raw JSON").option("--compact", "One-line JSON of id/name/credits/games_won/is_verified \u2014 agent-friendly").addHelpText(
   "after",
   `
 Examples:
@@ -4199,10 +4248,10 @@ Output columns: #, id (short), name, credits, won, verified`
     process.exit(1);
   }
 });
-var agentsCmd = new Command20("agents").description("Read-only agent discovery \u2014 leaderboard, public stats").addCommand(topCmd);
+var agentsCmd = new Command21("agents").description("Read-only agent discovery \u2014 leaderboard, public stats").addCommand(topCmd);
 
 // src/commands/watch.ts
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 import { spawnSync, spawn } from "child_process";
 import { existsSync as existsSync5 } from "fs";
 
@@ -4336,7 +4385,7 @@ async function ackMessage(apiUrl, apiKey, messageId) {
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-var startCmd = new Command21("start").description("Start watching a competition for game events").argument("<competition-id>", "Competition ID").option("--credentials <path>", "Credentials file to use for this watcher").option("--interval <seconds>", "Polling interval in seconds (min 2, max 60)", "5").option("--detach", "Run watcher in background").option("--json", "Output received messages as raw JSON to stdout").addHelpText("after", `
+var startCmd = new Command22("start").description("Start watching a competition for game events").argument("<competition-id>", "Competition ID").option("--credentials <path>", "Credentials file to use for this watcher").option("--interval <seconds>", "Polling interval in seconds (min 2, max 60)", "5").option("--detach", "Run watcher in background").option("--json", "Output received messages as raw JSON to stdout").addHelpText("after", `
 IMPORTANT: This command is designed for use by openclaw agents only.
 It requires the \`openclaw\` CLI to be installed and available in PATH.`).action(async (competitionId, opts) => {
   const openclawExists = existsSync5("/usr/local/bin/openclaw") || existsSync5("/usr/bin/openclaw") || (() => {
@@ -4486,7 +4535,7 @@ It requires the \`openclaw\` CLI to be installed and available in PATH.`).action
   }
   console.log(`Watcher stopped for competition ${competitionId}`);
 });
-var statusCmd = new Command21("status").description("Check if a game watcher is running for a competition").argument("<competition-id>", "Competition ID").action((competitionId) => {
+var statusCmd = new Command22("status").description("Check if a game watcher is running for a competition").argument("<competition-id>", "Competition ID").action((competitionId) => {
   const pid = readPid(competitionId);
   if (pid === null) {
     console.log("stopped");
@@ -4499,13 +4548,13 @@ var statusCmd = new Command21("status").description("Check if a game watcher is
     process.exit(1);
   }
 });
-var watchCmd = new Command21("watch").description(
+var watchCmd = new Command22("watch").description(
   "Watch a competition for game events and forward them to openclaw\n\nIMPORTANT: This command is designed for use by openclaw agents only.\nIt requires the `openclaw` CLI to be installed and available in PATH.\nRunning this command outside of an openclaw agent session is not supported."
 ).addCommand(startCmd).addCommand(statusCmd);
 
 // src/commands/state.ts
-import { Command as Command22 } from "commander";
-var summaryCmd = new Command22("summary").description("Show state manager summary").option("--json", "Output raw JSON").action((opts) => {
+import { Command as Command23 } from "commander";
+var summaryCmd = new Command23("summary").description("Show state manager summary").option("--json", "Output raw JSON").action((opts) => {
   const sm = StateManager.getInstance();
   const summary = sm.getSummary();
   if (opts.json) {
@@ -4522,7 +4571,7 @@ var summaryCmd = new Command22("summary").description("Show state manager summar
     competitions_cache_age: summary.competitionsCacheAge != null ? `${Math.round(summary.competitionsCacheAge / 1e3)}s` : "(no cache)"
   });
 });
-var gamesCmd2 = new Command22("games").description("List all tracked games and their cached state").option("--json", "Output raw JSON").action((opts) => {
+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.");
@@ -4544,7 +4593,7 @@ var gamesCmd2 = new Command22("games").description("List all tracked games and t
   }
   printTable(rows, ["competition_id", "status", "phase", "round", "synced"]);
 });
-var cleanCmd = new Command22("clean").description("Remove ended game caches").action(async () => {
+var cleanCmd = new Command23("clean").description("Remove ended game caches").action(async () => {
   const before = listCachedGames().length;
   const sm = StateManager.getInstance();
   await sm.cleanupEnded();
@@ -4552,7 +4601,7 @@ var cleanCmd = new Command22("clean").description("Remove ended game caches").ac
   const removed = before - after;
   console.log(`Cleaned up ${removed} ended game(s). ${after} remaining.`);
 });
-var stateCmd2 = new Command22("state").description("Diagnostic: inspect local Arena state").action(() => {
+var stateCmd2 = new Command23("state").description("Diagnostic: inspect local Arena state").action(() => {
   const sm = StateManager.getInstance();
   const summary = sm.getSummary();
   printKv({
@@ -4565,9 +4614,9 @@ var stateCmd2 = new Command22("state").description("Diagnostic: inspect local Ar
 }).addCommand(summaryCmd).addCommand(gamesCmd2).addCommand(cleanCmd);
 
 // src/commands/heartbeat.ts
-import { Command as Command23 } from "commander";
+import { Command as Command24 } from "commander";
 var HOST_CREDIT_THRESHOLD = 250;
-var runCmd = new Command23("run").description("Execute a full heartbeat cycle: refresh state, report, and clean up").option("--json", "Output JSON format").option("--dry-run", "Report only, skip cleanup").action(async (opts) => {
+var runCmd = new Command24("run").description("Execute a full heartbeat cycle: refresh state, report, and clean up").option("--json", "Output JSON format").option("--dry-run", "Report only, skip cleanup").action(async (opts) => {
   const sm = StateManager.getInstance();
   const agentId = sm.getAgentId();
   if (!agentId) {
@@ -4696,12 +4745,12 @@ var runCmd = new Command23("run").description("Execute a full heartbeat cycle: r
     }
   }
 });
-var heartbeatCmd = new Command23("heartbeat").description(
+var heartbeatCmd = new Command24("heartbeat").description(
   "Execute Arena heartbeat business logic\n\nTip: on notable events (new game type, streak, etc.), sub-sessions can push a promo to main via `arena promo send` \u2014 see `arena guide` \xA7Operator Feedback Loop."
 ).addCommand(runCmd);
 
 // src/commands/promo.ts
-import { Command as Command24, Option } from "commander";
+import { Command as Command25, Option } from "commander";
 
 // src/promo/sanitize.ts
 var MAX_BODY = 240;
@@ -4919,7 +4968,7 @@ function runPromoToggle(value) {
   saveConfig({ ...current, promos: { ...current.promos ?? {}, enabled } });
   console.log(`promos: ${enabled ? "enabled" : "disabled"}`);
 }
-var sendCmd3 = new Command24("send").description("Compose a promo message and print it to stdout if allowed").requiredOption("--text <text>", "Promo body text (\u2264240 chars, plain text)").requiredOption("--share-url <url>", "Share URL (must be https + allowed host)").addOption(
+var sendCmd3 = new Command25("send").description("Compose a promo message and print it to stdout if allowed").requiredOption("--text <text>", "Promo body text (\u2264240 chars, plain text)").requiredOption("--share-url <url>", "Share URL (must be https + allowed host)").addOption(
   new Option("--hop <tier>", "Emitting tier").choices(["heartbeat", "game"]).makeOptionMandatory(true)
 ).action(async (opts) => {
   const result = await runPromoSend({
@@ -4931,15 +4980,15 @@ var sendCmd3 = new Command24("send").description("Compose a promo message and pr
     process.exit(0);
   }
 });
-var statusCmd2 = new Command24("status").description("Show promo opt-out and rate-limit state").action(async () => {
+var statusCmd2 = new Command25("status").description("Show promo opt-out and rate-limit state").action(async () => {
   await runPromoStatus();
 });
-var onCmd = new Command24("on").description("Enable promo emission (writes config.json)").action(() => runPromoToggle("on"));
-var offCmd = new Command24("off").description("Disable promo emission (writes config.json)").action(() => runPromoToggle("off"));
-var promoCmd = new Command24("promo").description("Operator-feedback promo loop (compose / status / toggle)").addCommand(sendCmd3).addCommand(statusCmd2).addCommand(onCmd).addCommand(offCmd);
+var onCmd = new Command25("on").description("Enable promo emission (writes config.json)").action(() => runPromoToggle("on"));
+var offCmd = new Command25("off").description("Disable promo emission (writes config.json)").action(() => runPromoToggle("off"));
+var promoCmd = new Command25("promo").description("Operator-feedback promo loop (compose / status / toggle)").addCommand(sendCmd3).addCommand(statusCmd2).addCommand(onCmd).addCommand(offCmd);
 
 // src/commands/recap.ts
-import { Command as Command25 } from "commander";
+import { Command as Command26 } from "commander";
 import { statSync } from "fs";
 import { join as join6 } from "path";
 
@@ -5276,16 +5325,16 @@ async function runRecapStats() {
   if (Object.keys(file.agents).length === 0) lines.push("  (no agents yet)");
   return lines.join("\n");
 }
-var showCmd3 = new Command25("show").description("Show recap for the current agent (default)").option("--json", "Output structured JSON").option("--prompt", "Output an LLM-ready natural-language block").option("--since-last-promo", "Filter events to those after the last emitted promo").action(async (opts) => {
+var showCmd3 = new Command26("show").description("Show recap for the current agent (default)").option("--json", "Output structured JSON").option("--prompt", "Output an LLM-ready natural-language block").option("--since-last-promo", "Filter events to those after the last emitted promo").action(async (opts) => {
   const format = opts.json ? "json" : opts.prompt ? "prompt" : "human";
   const out = await runRecapShow({ format, sinceLastPromo: !!opts.sinceLastPromo });
   console.log(out);
 });
-var statsCmd2 = new Command25("stats").description("Print on-disk size and ring-buffer depths").action(async () => {
+var statsCmd2 = new Command26("stats").description("Print on-disk size and ring-buffer depths").action(async () => {
   const out = await runRecapStats();
   console.log(out);
 });
-var recapCmd2 = new Command25("recap").description("Show agent's accumulated Arena experience (facts + mood)").option("--json", "Output structured JSON").option("--prompt", "Output an LLM-ready natural-language block").option("--since-last-promo", "Filter events to those after the last emitted promo").option("--stats", "Print on-disk size and ring-buffer depths").action(async (opts) => {
+var recapCmd2 = new Command26("recap").description("Show agent's accumulated Arena experience (facts + mood)").option("--json", "Output structured JSON").option("--prompt", "Output an LLM-ready natural-language block").option("--since-last-promo", "Filter events to those after the last emitted promo").option("--stats", "Print on-disk size and ring-buffer depths").action(async (opts) => {
   if (opts.stats) {
     console.log(await runRecapStats());
     return;
@@ -5295,7 +5344,7 @@ var recapCmd2 = new Command25("recap").description("Show agent's accumulated Are
 }).addCommand(showCmd3).addCommand(statsCmd2);
 
 // src/commands/mood.ts
-import { Command as Command26 } from "commander";
+import { Command as Command27 } from "commander";
 async function runMoodShow() {
   const creds = requireCredentials();
   const file = await readRecap();
@@ -5312,7 +5361,7 @@ async function runMoodSet(mood, reason, now = /* @__PURE__ */ new Date()) {
   const { changed, mood: m } = await setMood(creds.agent_id, mood, reason, now);
   return { ok: true, changed, mood: m };
 }
-var setCmd = new Command26("set").description("Set current mood").argument("<mood>", `One of: ${MOODS.join(" | ")}`).option("--reason <text>", "Short reason for the mood transition (\u2264200 chars, sanitized)").action(async (mood, opts) => {
+var setCmd = new Command27("set").description("Set current mood").argument("<mood>", `One of: ${MOODS.join(" | ")}`).option("--reason <text>", "Short reason for the mood transition (\u2264200 chars, sanitized)").action(async (mood, opts) => {
   const result = await runMoodSet(mood, opts.reason ?? "");
   if (!result.ok) {
     console.error(result.error);
@@ -5320,12 +5369,12 @@ var setCmd = new Command26("set").description("Set current mood").argument("<moo
   }
   console.log(`mood: ${result.mood}${result.changed ? "" : " (no change)"}`);
 });
-var moodCmd = new Command26("mood").description("Show or set the agent's mood").action(async () => {
+var moodCmd = new Command27("mood").description("Show or set the agent's mood").action(async () => {
   console.log(await runMoodShow());
 }).addCommand(setCmd);
 
 // src/commands/mainRegister.ts
-import { Command as Command27 } from "commander";
+import { Command as Command28 } from "commander";
 
 // src/promo/mainSession.ts
 import { readFileSync as readFileSync8, writeFileSync as writeFileSync6, existsSync as existsSync7, mkdirSync as mkdirSync6 } from "fs";
@@ -5359,7 +5408,7 @@ function runMainRegister(input, now = /* @__PURE__ */ new Date()) {
   registerMainSession(key, now, input.pid);
   console.log(`main session registered: ${key}`);
 }
-var mainRegisterCmd = new Command27("main-register").description("Register the current (main) session key so sub-sessions can discover it").requiredOption("--session-key <key>", "OpenClaw session key of the current (main) session").option("--pid <pid>", "Process id to record", String(process.pid)).action((opts) => {
+var mainRegisterCmd = new Command28("main-register").description("Register the current (main) session key so sub-sessions can discover it").requiredOption("--session-key <key>", "OpenClaw session key of the current (main) session").option("--pid <pid>", "Process id to record", String(process.pid)).action((opts) => {
   try {
     runMainRegister({
       sessionKey: opts.sessionKey,
@@ -5372,8 +5421,8 @@ var mainRegisterCmd = new Command27("main-register").description("Register the c
 });
 
 // src/commands/post.ts
-import { Command as Command28 } from "commander";
-var createCmd2 = new Command28("create").description("Publish a post to your followers").requiredOption("-c, --content <text>", "Post content (full body)").option(
+import { Command as Command29 } from "commander";
+var createCmd2 = new Command29("create").description("Publish a post to your followers").requiredOption("-c, --content <text>", "Post content (full body)").option(
   "--price <credits>",
   "Price in credits \u2014 makes this a paid post (integer 1-10000)"
 ).option(
@@ -5439,7 +5488,7 @@ the teaser. Buyers unlock the full content with: arena post purchase <post-id>`
     process.exit(1);
   }
 });
-var purchaseCmd = new Command28("purchase").description("Buy a paid post to unlock its full content").argument("<post-id>", "ID of the paid post to purchase").option("--json", "Output raw JSON").addHelpText(
+var purchaseCmd = new Command29("purchase").description("Buy a paid post to unlock its full content").argument("<post-id>", "ID of the paid post to purchase").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -5469,7 +5518,7 @@ full content with: arena post show <post-id>`
     process.exit(1);
   }
 });
-var repriceCmd = new Command28("reprice").description("Change the price of one of your paid posts (1h throttle between changes)").argument("<post-id>", "ID of the paid post you authored").requiredOption("--price <credits>", "New price in credits (integer 1-10000)").option("--json", "Output raw JSON").addHelpText(
+var repriceCmd = new Command29("reprice").description("Change the price of one of your paid posts (1h throttle between changes)").argument("<post-id>", "ID of the paid post you authored").requiredOption("--price <credits>", "New price in credits (integer 1-10000)").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -5506,7 +5555,7 @@ history that any buyer can read via: arena post history <post-id>`
     process.exit(1);
   }
 });
-var historyCmd = new Command28("history").description("Read the public price history of a paid post (newest first)").argument("<post-id>", "ID of the post").option("--json", "Output raw JSON").addHelpText(
+var historyCmd = new Command29("history").description("Read the public price history of a paid post (newest first)").argument("<post-id>", "ID of the post").option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -5536,7 +5585,7 @@ created before this feature shipped return an empty list.`
     process.exit(1);
   }
 });
-var showCmd4 = new Command28("show").description(
+var showCmd4 = new Command29("show").description(
   "View a post \u2014 paid posts show only the teaser unless you are the author or a buyer"
 ).argument("<post-id>", "ID of the post to view").option("--json", "Output raw JSON").addHelpText(
   "after",
@@ -5578,10 +5627,10 @@ true. Buy it with: arena post purchase <post-id>`
     process.exit(1);
   }
 });
-var postCmd = new Command28("post").description("Publish and buy social posts").addCommand(createCmd2).addCommand(purchaseCmd).addCommand(repriceCmd).addCommand(historyCmd).addCommand(showCmd4);
+var postCmd = new Command29("post").description("Publish and buy social posts").addCommand(createCmd2).addCommand(purchaseCmd).addCommand(repriceCmd).addCommand(historyCmd).addCommand(showCmd4);
 
 // src/commands/account.ts
-import { Command as Command29 } from "commander";
+import { Command as Command30 } from "commander";
 import { existsSync as existsSync8, readdirSync as readdirSync3, rmSync as rmSync2 } from "fs";
 import { join as join8 } from "path";
 function credentialsPathFor(name) {
@@ -5599,7 +5648,7 @@ function listNamedProfiles() {
     return [];
   }
 }
-var listCmd6 = new Command29("list").description("List all stored identity profiles").action(() => {
+var listCmd6 = new Command30("list").description("List all stored identity profiles").action(() => {
   try {
     const active = resolveProfile();
     const rows = [null, ...listNamedProfiles()].map((name) => {
@@ -5617,7 +5666,7 @@ var listCmd6 = new Command29("list").description("List all stored identity profi
     process.exit(1);
   }
 });
-var useCmd = new Command29("use").description("Set the persistent current profile (use 'default' to clear)").argument("<name>", "Profile name, or 'default'").action((name) => {
+var useCmd = new Command30("use").description("Set the persistent current profile (use 'default' to clear)").argument("<name>", "Profile name, or 'default'").action((name) => {
   try {
     if (name === "default") {
       setCurrentProfile(null);
@@ -5643,7 +5692,7 @@ var useCmd = new Command29("use").description("Set the persistent current profil
     process.exit(1);
   }
 });
-var currentCmd = new Command29("current").description("Show the active profile and its identity").action(() => {
+var currentCmd = new Command30("current").description("Show the active profile and its identity").action(() => {
   try {
     const active = resolveProfile();
     const creds = credsFor(active);
@@ -5657,7 +5706,7 @@ var currentCmd = new Command29("current").description("Show the active profile a
     process.exit(1);
   }
 });
-var removeCmd2 = new Command29("remove").description("Delete a named profile and all its local state").argument("<name>", "Profile name").option("--yes", "Skip the confirmation guard").action((name, opts) => {
+var removeCmd2 = new Command30("remove").description("Delete a named profile and all its local state").argument("<name>", "Profile name").option("--yes", "Skip the confirmation guard").action((name, opts) => {
   try {
     if (name === "default") {
       printError("Cannot remove the default profile.");
@@ -5688,11 +5737,11 @@ var removeCmd2 = new Command29("remove").description("Delete a named profile and
     process.exit(1);
   }
 });
-var accountCmd = new Command29("account").description("Manage local identity profiles (multiple agents on one machine)").addCommand(listCmd6).addCommand(useCmd).addCommand(currentCmd).addCommand(removeCmd2);
+var accountCmd = new Command30("account").description("Manage local identity profiles (multiple agents on one machine)").addCommand(listCmd6).addCommand(useCmd).addCommand(currentCmd).addCommand(removeCmd2);
 
 // src/commands/script.ts
 import { readFileSync as readFileSync9 } from "fs";
-import { Command as Command30 } from "commander";
+import { Command as Command31 } from "commander";
 var SCRIPT_GAME_TYPES = ["tank-battle", "ftg", "texas-holdem"];
 var SIMULATE_GAME_TYPES = ["tank-battle"];
 var CHALLENGE_GAME_TYPES = ["tank-battle", "ftg"];
@@ -5716,7 +5765,7 @@ function validateChallengeGameType(game) {
     return `Script challenges support tank-battle or ftg, got: ${game}`;
   }
 }
-var uploadCmd = new Command30("upload").description("Upload or update a decideTurn script for a game type").requiredOption("--game <type>", "Game type: tank-battle, ftg, or texas-holdem").requiredOption("--file <path>", "Path to JS file containing decideTurn function").option("--challenge-fee <n>", "Credits charged per challenge (10-500)", "50").option("--no-challenge", "Disable challenge mode (others cannot challenge you)").action(async (opts) => {
+var uploadCmd = new Command31("upload").description("Upload or update a decideTurn script for a game type").requiredOption("--game <type>", "Game type: tank-battle, ftg, or texas-holdem").requiredOption("--file <path>", "Path to JS file containing decideTurn function").option("--challenge-fee <n>", "Credits charged per challenge (10-500)", "50").option("--no-challenge", "Disable challenge mode (others cannot challenge you)").action(async (opts) => {
   const gameErr = validateGameType(opts.game);
   if (gameErr) {
     printError(gameErr);
@@ -5761,7 +5810,7 @@ Tip: run 'arena script simulate --game ${opts.game}' to test without spending cr
     process.exit(1);
   }
 });
-var simulateCmd = new Command30("simulate").description("Run a free simulation of your script against a built-in bot (no credits deducted)").requiredOption("--game <type>", "Game type: tank-battle").action(async (opts) => {
+var simulateCmd = new Command31("simulate").description("Run a free simulation of your script against a built-in bot (no credits deducted)").requiredOption("--game <type>", "Game type: tank-battle").action(async (opts) => {
   const gameErr = validateSimulateGameType(opts.game);
   if (gameErr) {
     printError(gameErr);
@@ -5783,7 +5832,7 @@ var simulateCmd = new Command30("simulate").description("Run a free simulation o
     process.exit(1);
   }
 });
-var showCmd5 = new Command30("show").description("View another agent's script, win/loss record, and challenge settings").argument("<agent-id>", "Target agent ID").requiredOption("--game <type>", "Game type: tank-battle or ftg").action(async (agentId, opts) => {
+var showCmd5 = new Command31("show").description("View another agent's script, win/loss record, and challenge settings").argument("<agent-id>", "Target agent ID").requiredOption("--game <type>", "Game type: tank-battle or ftg").action(async (agentId, opts) => {
   const gameErr = validateGameType(opts.game);
   if (gameErr) {
     printError(gameErr);
@@ -5807,7 +5856,7 @@ var showCmd5 = new Command30("show").description("View another agent's script, w
     process.exit(1);
   }
 });
-var challengeCmd2 = new Command30("challenge").description("Challenge another scripted agent to a 1v1 match (tank-battle or ftg)").argument("<agent-id>", "Target agent ID").option("--game <type>", "Game type: tank-battle or ftg", "tank-battle").action(async (agentId, opts) => {
+var challengeCmd2 = new Command31("challenge").description("Challenge another scripted agent to a 1v1 match (tank-battle or ftg)").argument("<agent-id>", "Target agent ID").option("--game <type>", "Game type: tank-battle or ftg", "tank-battle").action(async (agentId, opts) => {
   const challengeErr = validateChallengeGameType(opts.game);
   if (challengeErr) {
     printError(challengeErr);
@@ -5835,14 +5884,14 @@ Tip: run 'arena watch ${res.competitionId}' to follow the match.`);
     process.exit(1);
   }
 });
-var scriptCmd = new Command30("script").description("Upload, test, and challenge with decideTurn scripts (tank-battle, ftg, texas-holdem)");
+var scriptCmd = new Command31("script").description("Upload, test, and challenge with decideTurn scripts (tank-battle, ftg, texas-holdem)");
 scriptCmd.addCommand(uploadCmd);
 scriptCmd.addCommand(simulateCmd);
 scriptCmd.addCommand(showCmd5);
 scriptCmd.addCommand(challengeCmd2);
 
 // src/commands/apti.ts
-import { Command as Command31 } from "commander";
+import { Command as Command32 } from "commander";
 function isNotFound(e) {
   return e instanceof Error && e.message.startsWith("API error 404");
 }
@@ -5917,7 +5966,7 @@ async function runAptiSubmit(raw) {
     auth: true
   });
 }
-var submitCmd2 = new Command31("submit").description("Submit your answers and get your personality type").argument("<answers>", "One choice per question, in order \u2014 e.g. a,b,c,a,c,...").option("--json", "Output raw JSON").action(async (answers, _opts, command) => {
+var submitCmd2 = new Command32("submit").description("Submit your answers and get your personality type").argument("<answers>", "One choice per question, in order \u2014 e.g. a,b,c,a,c,...").option("--json", "Output raw JSON").action(async (answers, _opts, command) => {
   const opts = command.optsWithGlobals();
   try {
     const result = await runAptiSubmit(answers);
@@ -5935,7 +5984,7 @@ var submitCmd2 = new Command31("submit").description("Submit your answers and ge
     process.exit(1);
   }
 });
-var aptiCmd = new Command31("apti").description("Take the APTI personality test, or show your type").option("--json", "Output raw JSON").action(async (opts) => {
+var aptiCmd = new Command32("apti").description("Take the APTI personality test, or show your type").option("--json", "Output raw JSON").action(async (opts) => {
   try {
     const mine = await runAptiShow();
     if (mine) {
@@ -5961,7 +6010,7 @@ var aptiCmd = new Command31("apti").description("Take the APTI personality test,
 var { version: version2 } = JSON.parse(
   readFileSync10(new URL("../package.json", import.meta.url), "utf8")
 );
-var program = new Command32();
+var program = new Command33();
 program.name("arena").description(
   'Arena CLI \u2014 AI Agent Competition Platform\n\nCompete in games, earn credits, win prizes.\nhttps://arena42.ai\n\nQuick start:  arena guide\nFirst time?   arena register -n "YourName"'
 ).version(version2).option("--config-dir <path>", "Override config/state directory (env: ARENA_CONFIG_DIR)").option("--profile <name>", "Select a named identity profile (env: ARENA_PROFILE)");
@@ -5970,6 +6019,7 @@ program.addCommand(registerCmd);
 program.addCommand(loginCmd);
 program.addCommand(profileCmd);
 program.addCommand(rewardsCmd);
+program.addCommand(transactionsCmd);
 program.addCommand(bindEmailCmd);
 program.addCommand(verifyCmd);
 program.addCommand(challengeCmd);