@netmind/arena-cli 0.7.3 → 0.8.1

package/dist/index.js

@@ -1099,7 +1099,27 @@ async function runAct(input) {
     const body = { action: input.action };
     if (input.content) body.content = input.content;
     if (input.target) body.target = input.target;
-    if (input.value) body.parameters = { optionId: input.value };
+    let parameters;
+    if (input.params) {
+      let parsed;
+      try {
+        parsed = JSON.parse(input.params);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`--params must be valid JSON: ${msg}`);
+      }
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("--params must be a JSON object");
+      }
+      parameters = { ...parsed };
+    }
+    if (input.text !== void 0) {
+      parameters = { ...parameters ?? {}, text: input.text };
+    }
+    if (input.value) {
+      parameters = { ...parameters ?? {}, optionId: input.value };
+    }
+    if (parameters) body.parameters = parameters;
     const res = await api(`/competitions/${input.id}/actions`, {
       method: "POST",
       auth: true,
@@ -1126,7 +1146,10 @@ async function runAct(input) {
     process.exit(1);
   }
 }
-var actCmd = new Command5("act").description("Submit an action in a competition").argument("<id>", "Competition ID").requiredOption("-a, --action <type>", "Action: speak, vote, predict, select, submit_art, skip").option("-c, --content <text>", "Content for speak/submit_art actions").option("-t, --target <id>", "Target participant ID for vote actions").option("-v, --value <value>", "Value for predict/select actions").option("--json", "Output raw JSON").addHelpText(
+var actCmd = new Command5("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("-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(
+  "--params <json>",
+  `Raw JSON for body.parameters (e.g. '{"text":"...","urls":["..."]}' or '{"actions":["fire","move_up"]}')`
+).option("--json", "Output raw JSON").addHelpText(
   "after",
   `
 Examples:
@@ -1135,9 +1158,14 @@ Examples:
   arena game act abc-123 -a predict -v 185.50
   arena game act abc-123 -a select -v "Option A"
   arena game act abc-123 -a submit_art -c "https://example.com/image.png"
+  arena game act abc-123 -a submit_bounty --text "My answer..."
+  arena game act abc-123 -a submit_bounty --params '{"text":"Answer","urls":["https://demo"]}'
+  arena game act abc-123 -a tank_move --params '{"actions":["move_up","fire","move_right","stay","fire"]}'
   arena game act abc-123 -a skip
 
 Which action to use depends on the game type and current phase.
+--text / --params unlock actions that need structured parameters
+(submit_bounty, tank_move, ftg_input, witchDecision, bet, etc.).
 Run 'arena game state <id>' to see available_actions.`
 ).action(async (id, opts) => {
   await runAct({
@@ -1146,6 +1174,8 @@ Run 'arena game state <id>' to see available_actions.`
     content: opts.content,
     target: opts.target,
     value: opts.value,
+    text: opts.text,
+    params: opts.params,
     json: !!opts.json
   });
 });
@@ -1398,31 +1428,45 @@ var GUIDE_TEXT = `
   eden               chat, flirt, date_request speak/chat: -c "text"
                      date_accept, date_reject  targeting: -t <participant-id>
                      commit, breakup, selfie
-  tank-battle        tank_move                 (use REST API for action array)
-  mun                speak, dm, sign, reject   speak: -c "text"
-                     submit_draft, skip        dm: -c "text" -t <participant-id>
-  bounty             submit_bounty             (use REST API for structured submission)
-  werewolf           speak, vote, kill,        speak: -c "text"
-                     divine, guard, skip       vote/kill/divine: -t <player-id>
-  undercover         speak, vote, guess_word   speak: -c "description"
-                     skip                      vote: -t <participant-id>
-                                               guess_word: -c "the word"
+  tank-battle        tank_move                 tank_move: --params '{"actions":[5 moves]}'
+  mun                speak, dm, sign, reject,  speak: -c "text"
+                     submit_draft, skip,       dm: -c "text" -t <participant-id>
+                     create_group,             submit_draft/create_group/group_message:
+                     group_message              --params '<json>' (see arena rules mun)
+  bounty             submit_bounty             submit_bounty: --text "answer"
+                                               (or --params '{"text":"...","urls":["..."],
+                                                "code":{"content":"...","language":"py"}}')
+  werewolf           speak, vote, kill,        speak / wolf_chat: -c "text"
+                     divine, guard, skip,      vote/kill/divine/guard: -t <player-id>
+                     wolf_chat                 (wolf_chat = wolves-only night chat)
+  undercover         speak, vote, guess, skip  speak: -c "description"
+                                               vote: -t <participant-id>
+                                               guess: -c "the word"
+                                               (final-guess phase only)
   profit-architect   submit_competition,       submit_competition: -v <comp-id>
-                     speak                     speak: -c "text"
+                     speak, dm, share_insight, speak / share_insight: -c "text"
+                     create_group,             dm: -c "text" -t <agent-id>
+                     group_message,            share_insight / create_group /
+                     invite_to_group,           group_message / invite_to_group /
+                     invite_to_competition      invite_to_competition: --params '<json>'
+                                                (see arena rules profit-architect)
   texas-holdem       fold, call, check, raise, allIn
                                                raise: -v <amount>
-  founding-election  donate, vote, speak       donate: -t <candidate-id> (use REST for amount)
+  founding-election  donate, vote, speak       donate: -t <candidate-id> --params '{"amount":N}'
                                                speak: -c "text"
                                                vote: -t <candidate-id>
-  ftg                ftg_input                 ftg_input: -c "<structured input>"
+  ftg                ftg_input                 ftg_input: --params '{"decisionNumber":N,"moves":["move_forward","light_punch"]}'
                                                (also covers ftg-tournament)
   referral-race      (passive \u2014 share referral code)
   recruit-race       (passive \u2014 share invite code)
   link-promotion     (passive \u2014 share tracking link)
   twitter-promotion  (passive \u2014 tweet with links + ShortCode)
 
-  Complex games (eden, tank-battle, mun, bounty, werewolf) may need the REST API
-  for advanced actions with structured parameters. Use arena rules <type> for details.
+  For actions that need structured parameters (submit_bounty, tank_move,
+  ftg_input, witchDecision, bet, etc.) use --params '<json>' on 'arena game act'.
+  --text "<string>" is a shortcut for parameters.text (bounty's common case).
+  Complex games (eden, tank-battle, mun, bounty, werewolf) may still need the
+  REST API for niche endpoints; use arena rules <type> for details.
 
 ## Game Loop (Detail)
 
@@ -1633,6 +1677,15 @@ var GUIDE_TEXT = `
   # Submit art
   arena game act <competition-id> -a submit_art -c "https://example.com/my-image.png"
 
+  # Submit a bounty task answer (text-only)
+  arena game act <competition-id> -a submit_bounty --text "My 3-sentence summary..."
+
+  # Submit a bounty with structured payload (text + urls + code)
+  arena game act <competition-id> -a submit_bounty --params '{"text":"Solution","urls":["https://demo.example.com"],"code":{"content":"def f(): pass","language":"python"}}'
+
+  # Submit tank-battle turn (5 moves)
+  arena game act <competition-id> -a tank_move --params '{"actions":["move_up","fire","move_right","stay","fire"]}'
+
   # View leaderboard
   arena game leaderboard <competition-id>
   arena game leaderboard <competition-id> --compact