@leafarcade/cli 0.7.0 → 0.7.1

package/README.md

@@ -2,7 +2,7 @@
 
 Let your own agent play a private board-game room while you use the browser board. The CLI reads positions and submits moves; it does not call a model, collect model credentials or implement its own opponent.
 
-**Scope of 0.7.0:** all 53 multiplayer games in unclocked, unrated rooms that admit agents. Nine games expose complete convenience move lists and 41 more list legal wire actions in `legal_wire_actions` (marked incomplete only in free-form phases such as melds, trade offers, raise amounts, bluffs and four-card discards); Categories, Draw & Guess and Letter Tiles use their documented free-form actions. Card games add `cards_labeled`, index boards add `board_labeled` and `board_legend`, and every read adds `changed_since_last_read`. Local automatic play is available through the watcher below. OAuth login, seat-scoped pairing and resuming a stopped desktop chat are not implemented. Approval-only private tables require the host to approve a joining player before that seat is admitted. Invite-only tables admit players holding the invitation. Spectator and agent admission follow the host’s settings.
+**Scope of 0.7.1:** all 53 multiplayer games in unclocked, unrated rooms that admit agents. Nine games expose complete convenience move lists and 41 more list legal wire actions in `legal_wire_actions` (marked incomplete only in free-form phases such as melds, trade offers, raise amounts, bluffs and four-card discards); Categories, Draw & Guess and Letter Tiles use their documented free-form actions. Card games add `cards_labeled`, index boards add `board_labeled` and `board_legend`, and every read adds `changed_since_last_read`. Local automatic play is available through the watcher below. OAuth login, seat-scoped pairing and resuming a stopped desktop chat are not implemented. Approval-only private tables require the host to approve a joining player before that seat is admitted. Invite-only tables admit players holding the invitation. Spectator and agent admission follow the host’s settings.
 
 ## Start a game from your agent
 

package/dist/cli.mjs

@@ -4415,6 +4415,107 @@ var action_catalog_default = {
   ]
 };
 
+// lib/multiplayer/dice.ts
+var diceCategories = [
+  "Ones",
+  "Twos",
+  "Threes",
+  "Fours",
+  "Fives",
+  "Sixes",
+  "Three of a kind",
+  "Four of a kind",
+  "Full house",
+  "Small straight",
+  "Large straight",
+  "Five of a kind",
+  "Chance"
+];
+function createDice(count) {
+  if (!index(count - 2, 3)) throw Error("Choose two to four players.");
+  return {
+    dice: [0, 0, 0, 0, 0],
+    held: Array(5).fill(false),
+    rolls: 0,
+    sheets: Array.from({ length: count }, () => Array(13).fill(null)),
+    bonuses: Array(count).fill(0),
+    turn: 0,
+    finished: false,
+    winner: null
+  };
+}
+function diceScore(dice, category, joker = false) {
+  const counts = Array.from(
+    { length: 6 },
+    (_, i) => dice.filter((v) => v === i + 1).length
+  ), sum = dice.reduce((a, b) => a + b, 0);
+  if (category < 6) return counts[category] * (category + 1);
+  switch (category) {
+    case 6:
+      return Math.max(...counts) >= 3 ? sum : 0;
+    case 7:
+      return Math.max(...counts) >= 4 ? sum : 0;
+    case 8:
+      return joker || counts.includes(3) && counts.includes(2) ? 25 : 0;
+    case 9:
+      return joker || [0, 1, 2].some((start) => counts.slice(start, start + 4).every(Boolean)) ? 30 : 0;
+    case 10:
+      return joker || [0, 1].some((start) => counts.slice(start, start + 5).every(Boolean)) ? 40 : 0;
+    case 11:
+      return counts.includes(5) ? 50 : 0;
+    case 12:
+      return sum;
+    default:
+      throw Error("Choose a score category.");
+  }
+}
+function diceTotal(s, seat) {
+  const sheet = s.sheets[seat], upper = sheet.slice(0, 6).reduce((sum, n) => sum + (n ?? 0), 0);
+  return sheet.reduce((sum, n) => sum + (n ?? 0), 0) + (upper >= 63 ? 35 : 0) + s.bonuses[seat];
+}
+function playDice(s, type, at, entropy2) {
+  if (s.finished) throw Error("This match is finished.");
+  if (type === "roll") {
+    if (s.rolls >= 3) throw Error("Record a score after three rolls.");
+    const random = draws(entropy2, 5);
+    return {
+      ...s,
+      rolls: s.rolls + 1,
+      dice: s.dice.map(
+        (v, i) => s.rolls && s.held[i] ? v : 1 + Math.floor(random[i] * 6)
+      )
+    };
+  }
+  if (at === void 0 || !index(at, type === "hold" ? 5 : 13) || !s.rolls)
+    throw Error("Roll first, then choose a die or score category.");
+  if (type === "hold")
+    return { ...s, held: s.held.map((v, i) => i === at ? !v : v) };
+  if (type !== "score" || s.sheets[s.turn][at] !== null)
+    throw Error("Choose an unused score category.");
+  const sheets = s.sheets.map((row) => [...row]), bonuses = [...s.bonuses];
+  const five = s.dice.every((v) => v === s.dice[0]), upper = s.dice[0] - 1;
+  const joker = five && sheets[s.turn][11] !== null && sheets[s.turn][upper] !== null;
+  if (joker && sheets[s.turn].slice(6).some((n) => n === null) && at < 6)
+    throw Error(
+      "Use the five-of-a-kind joker in an unused lower category first."
+    );
+  sheets[s.turn][at] = diceScore(s.dice, at, joker);
+  if (joker && sheets[s.turn][11] === 50) bonuses[s.turn] += 100;
+  const next3 = {
+    ...s,
+    sheets,
+    bonuses,
+    turn: (s.turn + 1) % s.sheets.length,
+    rolls: 0,
+    held: Array(5).fill(false),
+    dice: [0, 0, 0, 0, 0]
+  };
+  next3.finished = sheets.every((row) => row.every((n) => n !== null));
+  if (next3.finished)
+    next3.winner = best(sheets.map((_, i) => diceTotal(next3, i)));
+  return next3;
+}
+
 // lib/agents/action-help.ts
 var help = {
   amazons: "move: numeric from/to 0\u201399 and amount for the arrow square. Select an exact legal_wire_actions entry.",
@@ -4443,8 +4544,8 @@ var help = {
   go: "place/dead: at is a zero-based row-major intersection (board_labeled shows row start indexes). pass/resume: no payload. accept: scoreKey names the scoring proposal you agree to; the CLI fills it from the position you read. Two passes start scoring: either seat marks dead groups, then both accept.",
   battleships: "auto/clear/ready: no payload. place: at is a zero-based starting square and amount selects orientation (0 horizontal, 1 vertical). fire: at is a zero-based target square. Inspect your fleet/setup phase; enemy ships remain hidden.",
   mills: "place/capture: at is a zero-based point index. move: from is the origin and at the destination. Completing a mill requires a subsequent capture action.",
-  dice: "roll: no payload. hold: at is a die index (0\u20134) to toggle its hold after rolling. score: at is a category index. Inspect the roll phase and score sheet.",
-  ludo: "roll: no payload. move: at is the index (0\u20133) of your token. Token progress is relative to your own start: -1 yard, 0\u201339 track, 40\u201343 your home lane. Opponents' progress uses their own start, offset by 20 (two players) or 10 per seat (four) on the shared 40-square track. A 6 leaves the yard and keeps the turn.",
+  dice: `roll: no payload. hold: at is a die index (0\u20134) to toggle its hold after rolling. score: at is a category index: ${diceCategories.map((name, i) => `${i} ${name}`).join(", ")}. Inspect the roll phase and score sheet.`,
+  ludo: "roll: no payload. move: at is the index (0\u20133) of your token. Token progress is relative to your own start: -1 yard, 0\u201339 track, 40\u201343 your home lane. Opponents' progress uses their own start, offset by 20 (two players) or 10 per seat (four) on the shared 40-square track. A 6 is needed to leave the yard; any 6 grants another roll, up to three in a row.",
   domino: "tile: at is your zero-based hand position (not a pip value) and amount selects the chain end: 0 left, 1 right. draw: draw until you can play, or pass when the stock is empty. next: start the following round. Scoring: open ends summing to a multiple of five score that sum; the player who empties their hand scores the opponent's pips rounded to the nearest five.",
   football: "place: at is a zero-based destination point. The state records ball, used edges and continuing rebounds.",
   backgammon: "roll: no payload. move: numeric from/to and amount (die value), one die per action. Points are 0\u201323. Positive point counts are seat 0, negative seat 1. Seat 0 moves up (enters from the bar to die-1, home 18\u201323); seat 1 moves down (enters to 24-die, home 0\u20135). from -1 means the bar; to 24 bears off for both seats. Compulsory dice usage is enforced.",
@@ -4456,17 +4557,17 @@ var help = {
   pan: "play: cards is an array of card IDs from the visible hand; take/next: no payload. Follow the table rank and legal group rules.",
   "gin-rummy": "stock/upcard/pass/next: no payload. discard/knock: at is a card ID from the visible hand. Inspect draw/discard phase and deadwood rules.",
   "sixty-six": "play: at is a card ID from the visible hand; promotion:'marriage' or 'marriage-claim' declares. exchange/close/claim/next are phase-specific commands.",
-  hearts: "select: at is a card ID from the visible hand for passing, then pass. play: at is a card ID from the visible hand. moon: amount selects a scoring choice. Follow phase, lead suit and legal cards.",
+  hearts: "select: at is a card ID from the visible hand for passing (selecting a chosen card again unselects it; visible_state.selected shows your choice), then pass. play: at is a card ID from the visible hand. moon: amount selects a scoring choice. Follow phase, lead suit and legal cards.",
   spades: "bid: amount is the bid; blind/look for blind nil where offered. play: at is a card ID from the visible hand. Follow partner, phase and lead suit.",
   "oh-hell": "bid: amount is the bid. play: at is a card ID from the visible hand. next advances a completed hand; follow dealer restrictions and lead suit.",
   "three-five-eight": "exchange: at is one card ID from your visible hand. discard: cards is exactly four distinct card IDs from your visible hand. play: at is one card ID from your visible hand. contract: amount 0\u20133 chooses a suit, 4 no trumps, 5 misere. next advances the hand.",
   bridge: "bid: amount 1\u201335 encodes level floor((amount-1)/5)+1 and strain (amount-1)%5; pass/double/redouble have no payload. play: at is the active card ID from the visible hand, including exposed dummy when you control it. Follow auction, strain and lead-suit rules.",
   "polish-hearts": "trump: amount is a suit index; pass: no payload, only when no layout card fits; play: at is a card ID from the visible hand. Follow the current penalty/trump/layout phase.",
-  thousand: "bid/declare: amount is points. kitty: at selects a kitty. exchange: cards is card IDs from the visible hand. play: at is a card ID from the visible hand; to declare a marriage, lead its queen or king with promotion:'marriage'. pass/bomb/redeal/next depend on phase. Card IDs are suit*13+rank-2 (suits clubs, diamonds, hearts, spades; ranks 9 through ace). next: the declarer deals the next hand.",
-  binokel: "bid: amount is points; trump: amount is a suit; play: at is a card ID from the visible hand. pass/next have no payload. Meld values: aces around 10 (both sets 100), kings around 8 (80), queens around 6 (60), jacks around 4 (40), trump run 15 (150), royal marriage 4, ordinary marriage 2 per pair. A bid is the team's trick points plus melds; tricks hold about 240 points per hand, so bids far above that rarely make. The declaring team needs 20 meld points.",
-  skat: "bid: amount is an auction value; hold/pass/hand/pickup act in auction/pickup phases (after a hold the bidder must bid higher or pass). discard: cards is exactly two card IDs from your visible hand. contract: amount 0 clubs, 1 diamonds, 2 hearts, 3 spades as trump, 4 grand (jacks only), 5 null, with optional promotion normal/schneider/schwarz/ouvert. play: at is a card ID from the visible hand. Jacks rank clubs, spades, hearts, diamonds. Card IDs are suit*13+rank-2 (suits clubs, diamonds, hearts, spades). next: the previous declarer deals the next hand.",
+  thousand: "bid/declare: amount is points. kitty: at selects a kitty. exchange: cards is card IDs from the visible hand. play: at is a card ID from the visible hand; to declare a marriage, lead its queen or king with promotion:'marriage'. pass/bomb/redeal/next depend on phase. Card IDs are suit*13+rank-2 (suits clubs, diamonds, hearts, spades; ranks 9 through ace). next: the dealer of the finished hand starts the next one (the deal moves on).",
+  binokel: "bid: amount is points; trump: amount is a suit; play: at is a card ID from the visible hand. pass/next have no payload. Meld values: aces around 10 (both sets 100), kings around 8 (80), queens around 6 (60), jacks around 4 (40), trump run 15 (150), royal marriage 4, ordinary marriage 2 per pair. A bid is the team's trick points plus melds; tricks hold 50 points per hand (scoring cards plus 2 for the last trick), so a contract rests mostly on melds. The declaring team needs 20 meld points.",
+  skat: "bid: amount is an auction value; hold/pass/hand/pickup act in auction/pickup phases (after a hold the bidder must bid higher or pass). discard: cards is exactly two card IDs from your visible hand. contract: amount 0 clubs, 1 diamonds, 2 hearts, 3 spades as trump, 4 grand (jacks only), 5 null, with optional promotion normal/schneider/schwarz/ouvert. play: at is a card ID from the visible hand. Jacks rank clubs, spades, hearts, diamonds. Card IDs are suit*13+rank-2 (suits clubs, diamonds, hearts, spades). next: the dealer of the finished hand starts the next one (the deal moves on).",
   baska: "announce: no payload in the honor phase. contract: amount is one of 1,3,4,5,6 and must exceed the current contract. double/pass act in auction; play: at is a card ID from the visible hand; next advances the hand.",
-  canasta: "stock/next: no payload. pickup may require melds containing the top discard plus cards from your hand. meld: melds is an array of {rank,cards} groups of card IDs from the visible hand; rank is the natural rank 3\u201314 (J 11, Q 12, K 13, A 14), with twos and jokers as wild cards. cards_labeled names each card. discard: at is a card ID from the visible hand. Follow opening meld and canasta requirements.",
+  canasta: "stock/next: no payload. pickup may require melds containing the top discard plus cards from your hand. meld: melds is an array of {rank,cards} groups of card IDs from the visible hand; rank is the natural rank 3\u201314 (J 11, Q 12, K 13, A 14), with twos and jokers as wild cards. cards_labeled names each card. discard: at is a card ID from the visible hand. Follow opening meld and canasta requirements. Warning: going out (melding or discarding your last card) before your side has the required canastas (two with 2 players, one each with 4) is accepted but loses the match.",
   "letter-tiles": "place: placements is an array of {at,rack,letter?}; at is a board index and rack a rack index, letter assigns a blank. exchange: cards is rack indexes. accept/challenge/pass/next depend on phase.",
   "draw-guess": "choose: at selects one of your offered prompts. draw: stroke is an array of 2\u2013256 {x,y} integer points, each coordinate 0\u20131000; optional amount is pen width 2/4/8/16 and promotion is a supported pen color. guess: text is your guess; guesses are permitted out of turn during drawing. clear/expire/next depend on phase. Hidden prompts stay hidden from guessers.",
   "property-trading": "roll/end/buy/auction/pay/bankrupt/pass/reject have phase-specific effects. bid: amount is the bid. mortgage/redeem/build/sell: at selects a property. tax: amount is 0 or 1. release: amount 0 pays fifty, 1 uses a release card. offer: tradeOffer contains seat,give,take,giveCash,takeCash; accept confirms the current trade."
@@ -5538,6 +5639,7 @@ var labels = {
 var singleCard = /^(upcard|starter|top|trumpCard|card|attack|defen[cs]e|turned)$/;
 var suits = ["\u2663 clubs", "\u2666 diamonds", "\u2665 hearts", "\u2660 spades"];
 var cardField = /^(hands?|hole|trick|lastTrick|tricks?Won|pile|table|attack|defen[cs]e|discards?|kitty|kitties|shownKitty|skat|crib|starter|upcard|top|community|board|melds?|layout|red|revealed|played|dummy|selected|cards?|exchange|stock|widow|talon|turned|trumpCard|last)$/;
+var hasCardLabels = (game) => game in labels;
 function cardsLabeled(game, state) {
   const label = labels[game];
   if (!label || !state || typeof state !== "object") return null;
@@ -8333,7 +8435,7 @@ var adapter3 = defineMatchAdapter({
     return {
       finished: state.winner !== null || state.draw,
       winner: state.winner,
-      label: state.draw ? "Repetition or insufficient material" : state.winner !== null ? `${state.check ? "Checkmate" : "No legal move"} \xB7 Player ${state.winner + 1} wins.` : state.check ? "Check" : ""
+      label: state.draw ? "Draw \xB7 repetition, insufficient material or the move limit" : state.winner !== null ? `${state.check ? "Checkmate" : "No legal move"} \xB7 Player ${state.winner + 1} wins.` : state.check ? "Check" : ""
     };
   },
   apply(state, _seat, action, _entropy, _now) {
@@ -8357,7 +8459,7 @@ var adapter4 = defineMatchAdapter({
     return {
       finished: state.winner !== null || state.draw,
       winner: state.winner,
-      label: state.draw ? "Repetition or insufficient material" : state.winner !== null ? `${state.check ? "Checkmate" : "No legal move"} \xB7 Player ${state.winner + 1} wins.` : state.check ? "Check" : ""
+      label: state.draw ? "Draw \xB7 repetition, insufficient material or the move limit" : state.winner !== null ? `${state.check ? "Checkmate" : "No legal move"} \xB7 Player ${state.winner + 1} wins.` : state.check ? "Check" : ""
     };
   },
   apply(state, _seat, action, _entropy, _now) {
@@ -8492,7 +8594,7 @@ var adapter10 = defineMatchAdapter({
     return {
       finished: state.winner !== null,
       winner: state.winner,
-      label: state.last
+      label: state.winner !== null ? `Player ${state.winner + 1} brings all four tokens home and wins.` : state.last
     };
   },
   apply(state, _seat, action, entropy2, _now) {
@@ -10652,6 +10754,7 @@ function settle(s, entropy2) {
     s.bills.shift();
   }
   if (["buy", "tax", "trade", "auction"].includes(s.phase)) return;
+  if (s.players[s.active].bankrupt) s.pendingMove = null;
   if (s.pendingMove !== null) {
     const distance = s.pendingMove;
     s.pendingMove = null;
@@ -11548,92 +11651,6 @@ var adapter30 = defineMatchAdapter({
   leave: leavePoker
 });
 
-// lib/multiplayer/dice.ts
-function createDice(count) {
-  if (!index(count - 2, 3)) throw Error("Choose two to four players.");
-  return {
-    dice: [0, 0, 0, 0, 0],
-    held: Array(5).fill(false),
-    rolls: 0,
-    sheets: Array.from({ length: count }, () => Array(13).fill(null)),
-    bonuses: Array(count).fill(0),
-    turn: 0,
-    finished: false,
-    winner: null
-  };
-}
-function diceScore(dice, category, joker = false) {
-  const counts = Array.from(
-    { length: 6 },
-    (_, i) => dice.filter((v) => v === i + 1).length
-  ), sum = dice.reduce((a, b) => a + b, 0);
-  if (category < 6) return counts[category] * (category + 1);
-  switch (category) {
-    case 6:
-      return Math.max(...counts) >= 3 ? sum : 0;
-    case 7:
-      return Math.max(...counts) >= 4 ? sum : 0;
-    case 8:
-      return joker || counts.includes(3) && counts.includes(2) ? 25 : 0;
-    case 9:
-      return joker || [0, 1, 2].some((start) => counts.slice(start, start + 4).every(Boolean)) ? 30 : 0;
-    case 10:
-      return joker || [0, 1].some((start) => counts.slice(start, start + 5).every(Boolean)) ? 40 : 0;
-    case 11:
-      return counts.includes(5) ? 50 : 0;
-    case 12:
-      return sum;
-    default:
-      throw Error("Choose a score category.");
-  }
-}
-function diceTotal(s, seat) {
-  const sheet = s.sheets[seat], upper = sheet.slice(0, 6).reduce((sum, n) => sum + (n ?? 0), 0);
-  return sheet.reduce((sum, n) => sum + (n ?? 0), 0) + (upper >= 63 ? 35 : 0) + s.bonuses[seat];
-}
-function playDice(s, type, at, entropy2) {
-  if (s.finished) throw Error("This match is finished.");
-  if (type === "roll") {
-    if (s.rolls >= 3) throw Error("Record a score after three rolls.");
-    const random = draws(entropy2, 5);
-    return {
-      ...s,
-      rolls: s.rolls + 1,
-      dice: s.dice.map(
-        (v, i) => s.rolls && s.held[i] ? v : 1 + Math.floor(random[i] * 6)
-      )
-    };
-  }
-  if (at === void 0 || !index(at, type === "hold" ? 5 : 13) || !s.rolls)
-    throw Error("Roll first, then choose a die or score category.");
-  if (type === "hold")
-    return { ...s, held: s.held.map((v, i) => i === at ? !v : v) };
-  if (type !== "score" || s.sheets[s.turn][at] !== null)
-    throw Error("Choose an unused score category.");
-  const sheets = s.sheets.map((row) => [...row]), bonuses = [...s.bonuses];
-  const five = s.dice.every((v) => v === s.dice[0]), upper = s.dice[0] - 1;
-  const joker = five && sheets[s.turn][11] !== null && sheets[s.turn][upper] !== null;
-  if (joker && sheets[s.turn].slice(6).some((n) => n === null) && at < 6)
-    throw Error(
-      "Use the five-of-a-kind joker in an unused lower category first."
-    );
-  sheets[s.turn][at] = diceScore(s.dice, at, joker);
-  if (joker && sheets[s.turn][11] === 50) bonuses[s.turn] += 100;
-  const next3 = {
-    ...s,
-    sheets,
-    bonuses,
-    turn: (s.turn + 1) % s.sheets.length,
-    rolls: 0,
-    held: Array(5).fill(false),
-    dice: [0, 0, 0, 0, 0]
-  };
-  next3.finished = sheets.every((row) => row.every((n) => n !== null));
-  if (next3.finished)
-    next3.winner = best(sheets.map((_, i) => diceTotal(next3, i)));
-  return next3;
-}
-
 // lib/multiplayer/adapters/dice.ts
 var adapter31 = defineMatchAdapter({
   ranking: (state) => scoreResult(state.sheets.map((_, seat) => diceTotal(state, seat)), state.winner),
@@ -12135,6 +12152,7 @@ function specific(game, state, seat) {
   }
   if (game === "go") {
     const s = state;
+    if (s.phase === "scoring" && s.accepted.includes(seat)) return [];
     if (s.phase === "scoring") return [...s.board.flatMap((p, at) => p ? [{ type: "dead", at }] : []), { type: "accept", scoreKey: goProposalKey(s) }, { type: "resume" }];
     return s.phase === "play" && s.turn === seat ? [...s.board.flatMap((p, at) => p ? [] : [{ type: "place", at }]), { type: "pass" }] : [];
   }
@@ -12188,7 +12206,7 @@ function reconstruct(game, view, seat) {
   const own = view.ownFleet, fired = view.fired, incoming = view.incoming;
   return { ...view, fleets: seat === 0 ? [own, []] : [[], own], shots: seat === 0 ? [fired, incoming] : [incoming, fired] };
 }
-var entropy = Array.from({ length: 128 }, (_, i) => i * 7919 + 1);
+var entropy = Array.from({ length: 512 }, (_, i) => i * 7919 + 1);
 function hydrate(adapter36, view, seats2) {
   let template;
   try {
@@ -12305,7 +12323,8 @@ function agentPosition(room) {
     }
   }
   const last = match?.kind === "connect-four" || match?.kind === "tic-tac-toe" || match?.kind === "gomoku" ? match.state.last : null;
-  const yours = room.phase === "playing" && !!match && turn === room.seat && !room.players[room.seat].left && !ended && !room.players.some((p) => p.paused);
+  const agreed = match?.kind === "go" && match.state.phase === "scoring" && match.state.accepted.includes(room.seat);
+  const yours = room.phase === "playing" && !!match && turn === room.seat && !agreed && !room.players[room.seat].left && !ended && !room.players.some((p) => p.paused);
   const active = room.phase === "playing" && !!match && !room.players[room.seat].left && !ended && !room.players.some((p) => p.paused);
   const grid = !complete && match ? indexedBoard(room.game, match.state) : null;
   const wire = !complete && match && enumeratedAgentGames.includes(room.game) ? active ? agentLegalActions(room.game, match.state, room.seat, room.capacity) ?? [] : [] : null;
@@ -12347,7 +12366,8 @@ function agentPosition(room) {
   };
 }
 function labeledBoard(game, board) {
-  if (!board?.length || game === "oware" || game === "dots-boxes") return null;
+  if (!board?.length || game === "dots-boxes") return null;
+  if (game === "oware") return [`seat 0 pits 1-6:  ${board[0]}`, `seat 1 pits 7-12: ${board[1]}`];
   const algebraic = game === "chess" || game === "checkers";
   const rowWidth = String(board.length).length, cell = algebraic ? 1 : String(board[0].length).length;
   const files2 = algebraic ? [..."abcdefgh"] : [...board[0]].map((_, c) => String(c + 1));
@@ -12358,6 +12378,10 @@ function labeledBoard(game, board) {
 }
 function agentMove(position, input) {
   const action = position.legal_actions.find((a) => a.type === "swap" ? input.swap === true && Object.entries(input).every(([k, v]) => k === "swap" || v === void 0) : a.type === "edge" ? input.edge === a.edge && Object.entries(input).every(([k, v]) => k === "edge" || v === void 0) : a.type === "sow" ? input.pit === a.pit && Object.entries(input).every(([k, v]) => k === "pit" || v === void 0) : !input.swap && input.edge === void 0 && input.pit === void 0 && a.type === "move" ? input.column === void 0 && input.row === void 0 && a.from === input.from && a.to === input.to && a.promotion === input.promotion : a.type === "place" || a.type === "drop" ? !input.swap && input.edge === void 0 && input.pit === void 0 && input.from === void 0 && input.to === void 0 && input.promotion === void 0 && a.column === input.column && (a.type === "drop" ? input.row === void 0 : a.row === input.row) : false);
+  if (!action && input.from !== void 0 && input.to !== void 0 && "legal_wire_actions" in position) {
+    const wire = position.legal_wire_actions?.find((a) => a.type === "move" && String(a.from) === input.from && String(a.to) === input.to && (a.promotion === void 0 || a.promotion === input.promotion));
+    if (wire) return wire;
+  }
   if (!action) throw Error("Choose an exact entry from legal_actions on your turn. Use --column for drops, --row/--column for placements, or --from/--to with explicit --promotion when listed.");
   if (action.type === "swap") return { type: "swap" };
   if (action.type === "edge") return { type: "place", at: action.edge - 1 };
@@ -12371,7 +12395,7 @@ function agentRules(game = "connect-four") {
   const rules = {
     "connect-four": "Drop into an unfilled column. Gravity places the piece in the lowest empty cell. Four or more matching pieces horizontally, vertically or diagonally wins; a full board without a winner draws.",
     chess: "Standard chess, including castling, en passant, check, checkmate, stalemate, repetition and fifty-move draws. Seat 0 is White. Pick a listed from/to move. Promotions explicitly list q, r, b and n; supply --promotion. FEN is included for complete castling and en passant state.",
-    checkers: "English draughts on 8 by 8. Seat 0 moves from the bottom towards row 1. Captures are compulsory; kings move one diagonal square in either direction. A multiple jump is submitted one step at a time: read status and continue with the same piece while it remains your turn. Crowning ends a turn. No pieces or no legal moves loses; repetition and 80 quiet half-moves draw.",
+    checkers: "English draughts on 8 by 8. Seat 0 (x) starts on ranks 1\u20133 at the bottom and moves up towards rank 8; seat 1 (o) moves down. Men move and capture forward only, as in English draughts. Captures are compulsory; kings move one diagonal square in either direction. A multiple jump is submitted one step at a time: read status and continue with the same piece while it remains your turn. Crowning ends a turn. No pieces or no legal moves loses; repetition and 80 quiet half-moves draw.",
     "tic-tac-toe": "X (seat 0) starts on a 3 by 3 board. Place on an empty square. Three matching marks horizontally, vertically or diagonally wins; a full board without a winner draws.",
     reversi: "Bracket opposing discs in a straight line; all bracketed discs flip. Seat 0 is Black and starts. The engine automatically skips players with no legal move; the same seat may move twice. No pass command is needed. When neither can move, the most discs wins; equal counts draw.",
     hex: "Connect opposite edges on the hexagonal board: seat 0 top to bottom, seat 1 left to right. On seat 1's first turn it may swap; this transposes the first stone and changes its owner. No draws.",
@@ -12558,6 +12582,7 @@ function networkCause(error) {
 var readRoom = (session, signal) => rpc(session, "read", {}, true, signal);
 var continuousGames = ["draw-guess", "categories"];
 function waitForRoom(session, after, seconds, signal, untilAction = false) {
+  const sawRevision = after !== void 0;
   return new Promise((resolve, reject) => {
     let socket, closed = false, reconnects = 0, received = false, opened = false;
     let ping, retry;
@@ -12599,7 +12624,7 @@ function waitForRoom(session, after, seconds, signal, untilAction = false) {
           received = true;
           after ??= latest.revision;
           if (latest.revision < after) throw new ServiceError("Your revision is ahead of this room. Read game status again.", "STALE_REVISION");
-          const canAct2 = !continuousGames.includes(latest.game) && (latest.turn?.yours || !!(latest.legal_wire_actions_complete && latest.legal_wire_actions?.length));
+          const canAct2 = !continuousGames.includes(latest.game) && (latest.turn?.yours || !sawRevision && !!(latest.legal_wire_actions_complete && latest.legal_wire_actions?.length));
           if (untilAction && latest.revision > after && !canAct2 && latest.phase !== "finished" && !latest.you.left && !latest.paused) after = latest.revision;
           if (latest.revision > after || canAct2 || latest.phase === "finished" || latest.you.left || latest.paused) finish6({ event: latest.phase === "finished" ? "finished" : latest.you.left ? "left" : latest.paused ? "paused" : latest.turn?.yours ? "your_turn" : canAct2 ? "can_act" : "changed", position: latest });
         } catch (error) {
@@ -12665,7 +12690,7 @@ function nextStep(position, event, brief = false, server) {
   const play = (move2) => `leafarcade game play ${room} --revision ${revision} --action ${move2}`;
   if (wire?.length && !position.turn?.yours) return `You may act now (phase action outside the normal turn): ${play("'<one legal_wire_actions entry>'")}${flag}. Otherwise wait: ${wait}`;
   if (position.turn?.yours) {
-    if (wire?.length === 1 && wire[0].type === "next" && Object.keys(wire[0]).length === 1) return `The hand is over; you deal the next one: ${play(`'{"type":"next"}'`)} --wait${flag}`;
+    if (wire?.length === 1 && wire[0].type === "next" && Object.keys(wire[0]).length === 1) return `The hand is over; start the next one (the deal moves on): ${play(`'{"type":"next"}'`)} --wait${flag}`;
     const partial = !wire && position.legal_wire_actions?.length ? "Some legal actions are listed in legal_wire_actions, but the list is not exhaustive (see game rules for melds, offers, amounts or card groups). " : "";
     const move2 = wire ? "'<one legal_wire_actions entry>'" : position.legal_actions_complete ? "'<one legal_actions entry>'" : "'<wire action JSON from game rules>'";
     const check = lineGames.includes(position.game) ? "Check your immediate win and your opponent's immediate threats (every line, including diagonals), then: " : "";
@@ -12761,7 +12786,7 @@ async function installSkill(agent = "codex", update = false) {
 // packages/cli/package.json
 var package_default = {
   name: "@leafarcade/cli",
-  version: "0.7.0",
+  version: "0.7.1",
   private: false,
   description: "Create private browser board games and play with your AI agent. Includes 53 games and an installable Codex/Claude skill.",
   type: "module",
@@ -12822,7 +12847,7 @@ var commands = {
   status: { usage: "game status --room ROOMCODE", description: "Read your seat's visible state, phase, turn, revision, outcome and action completeness. Hidden information belonging to other players stays hidden. Includes a labeled board, last_move and a concrete next command.", options: ["room", "brief", "server"] },
   "legal-actions": { usage: "game legal-actions --room ROOMCODE", description: "Read actions and legal_actions_complete. An empty partial list is not proof that no move exists. Use game rules and visible_state for JSON actions.", options: ["room", "server"] },
   play: { usage: "game play --room ROOMCODE --revision R MOVE_FLAGS [--wait]", description: "Submit one move at the exact latest revision. Use convenience flags or --action JSON, never both; --action also accepts an exact legal_actions entry unchanged. --wait then waits for your next turn or the end, like game wait. The service validates legality. On stale or uncertain results, read status before acting again.", options: ["room", "revision", "action", "column", "row", "from", "to", "promotion", "swap", "edge", "pit", "wait", "timeout", "brief", "server"] },
-  wait: { usage: "game wait --room ROOMCODE [--after-revision R] [--timeout 90]", description: "Wait for changes through WebSocket (1\u20133600 seconds, default 90). Without --after-revision it waits for the next change after the current one. Returns at once when you can already act. Returns your_turn, can_act (a phase action outside your turn), changed, paused, finished, left or waiting. Use it after every move instead of asking the human to report theirs. A timeout is normal, not resignation. This command cannot restart a stopped agent.", options: ["room", "after-revision", "timeout", "brief", "server"] },
+  wait: { usage: "game wait --room ROOMCODE [--after-revision R] [--timeout 90]", description: "Wait for changes through WebSocket (1\u20133600 seconds, default 90). Without --after-revision it waits for the next change after the current one. Returns at once when it is already your turn; optional phase actions outside your turn (such as a challenge window) return at once only without --after-revision, so you can wait through them. Returns your_turn, can_act (a phase action outside your turn), changed, paused, finished, left or waiting. Use it after every move instead of asking the human to report theirs. A timeout is normal, not resignation. This command cannot restart a stopped agent.", options: ["room", "after-revision", "timeout", "brief", "server"] },
   pause: { usage: "game pause --room ROOMCODE --revision R", description: "Save your explicit pause in an active, unclocked private match. Any paused player blocks moves. Room expiry is not extended.", options: ["room", "revision", "brief", "server"] },
   resume: { usage: "game resume --room ROOMCODE --revision R", description: "Clear your own pause. Each player who paused must resume before play continues.", options: ["room", "revision", "brief", "server"] },
   rematch: { usage: "game rematch --room ROOMCODE --revision R", description: "Request another round after a normal finish. All players must agree and remain at the table. After resignation or leaving, create a fresh room. Never request a rematch without the human asking.", options: ["room", "revision", "brief", "server"] },
@@ -12958,7 +12983,7 @@ Coordinates
 Actions
   ${rules.action_types.join(", ")}
   ${rules.action_help.game}
-  ${complete ? "Complete legal-action list: choose an exact legal_actions entry on your turn (pass it to --action unchanged, or use the flags)." : wireListed.includes(game) ? "Complete legal_wire_actions list in status, including phase actions outside your turn: pass one entry to --action unchanged. Card names are in cards_labeled." : "Partial legal-action list: inspect visible_state and game phase; use --action JSON. An empty list does not mean there are no moves."}
+  ${complete ? "Complete legal-action list: choose an exact legal_actions entry on your turn (pass it to --action unchanged, or use the flags)." : wireListed.includes(game) ? `Complete legal_wire_actions list in status, including phase actions outside your turn: pass one entry to --action unchanged.${hasCardLabels(game) ? " Card names are in cards_labeled." : ""}` : "Partial legal-action list: inspect visible_state and game phase; use --action JSON. An empty list does not mean there are no moves."}
 
 Move syntax example (illustrative; read status and verify legality first)
   leafarcade game play --room ROOMCODE --revision R ${examples[game]} --wait
@@ -13042,6 +13067,11 @@ var show = (value) => JSON.stringify(value)?.slice(0, 120) ?? "undefined";
 function stateChanges(game, before, after, limit = 30) {
   const out2 = [];
   const labels2 = [cardsLabeled(game, before) ?? {}, cardsLabeled(game, after) ?? {}];
+  const names = /* @__PURE__ */ new Map();
+  for (const side2 of labels2) for (const value of Object.values(side2)) for (const label of [value].flat()) {
+    const id = /\(id (\d+)\)$/.exec(label)?.[1];
+    if (id !== void 0) names.set(Number(id), label);
+  }
   const named = (path, value, side2) => {
     const label = labels2[side2][path];
     return label === void 0 ? show(value) : Array.isArray(label) ? label.join(", ") || "[]" : label;
@@ -13062,6 +13092,14 @@ function stateChanges(game, before, after, limit = 30) {
         a.forEach((v, i) => walk(v, b[i], [...path, String(i)]));
         return;
       }
+      const cardName = (card2) => names.get(card2) ?? show(card2);
+      if (labels2[0][here] !== void 0 || labels2[1][here] !== void 0) {
+        const added = b.filter((card2) => !a.includes(card2)), removed = a.filter((card2) => !b.includes(card2));
+        if (added.length + removed.length < Math.max(a.length, b.length)) {
+          out2.push(`${here}: ${[...added.map((c) => `+${cardName(c)}`), ...removed.map((c) => `-${cardName(c)}`)].join(", ")}`);
+          return;
+        }
+      }
       out2.push(`${here}: ${named(here, a, 0)} \u2192 ${named(here, b, 1)}`);
       return;
     }
@@ -13097,7 +13135,9 @@ async function withChanges(result, path) {
   if (!changes.length) return result;
   const boards = [before.state, position.visible_state].map((state) => state?.board);
   const cells = Array.isArray(boards[0]) && Array.isArray(boards[1]) && boards[0].length === boards[1].length ? boards[1].flatMap((value, at) => JSON.stringify(value) === JSON.stringify(boards[0][at]) ? [] : [{ at, before: boards[0][at], after: value }]) : [];
-  const annotated = { ...position, ...position.last_move === null && "board_legend" in position && cells.length && cells.length <= 12 ? { last_move: { board_changes: cells } } : {}, changed_since_last_read: { from_revision: before.revision, changes } };
+  const square2 = (at) => "abcdefgh"[at % 8] + (8 - Math.floor(at / 8));
+  const derived = position.game === "checkers" ? cells.map((cell) => ({ ...cell, at: square2(cell.at) })) : "board_legend" in position ? cells : [];
+  const annotated = { ...position, ...position.last_move === null && derived.length && derived.length <= 12 ? { last_move: { board_changes: derived } } : {}, changed_since_last_read: { from_revision: before.revision, changes } };
   return "position" in result ? { ...result, position: annotated } : annotated;
 }
 
@@ -13527,7 +13567,7 @@ function briefPosition(position) {
     ..."deadline_seconds_left" in position ? { deadline_seconds_left: position.deadline_seconds_left } : {},
     ..."board_legend" in position ? { board_legend: position.board_legend } : {},
     // Only the classic convenience games are fully described by their labeled board.
-    ...position.legal_actions_complete || !position.visible_state ? {} : { visible_state: position.visible_state },
+    ...position.legal_actions_complete && position.board_labeled || !position.visible_state ? {} : { visible_state: position.visible_state },
     ...position.cards_labeled ? { cards_labeled: position.cards_labeled } : {},
     ...position.access_requests?.length ? { access_requests: position.access_requests } : {}
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leafarcade/cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "private": false,
   "description": "Create private browser board games and play with your AI agent. Includes 53 games and an installable Codex/Claude skill.",
   "type": "module",