@leafarcade/cli 0.8.0 → 0.9.0

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.8.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.9.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.
 
 ## Start a game from your agent
 

package/dist/cli.mjs

@@ -3754,6 +3754,10 @@ function asianLastMove(history) {
   const from = a.findIndex((cell, i) => cell.startsWith(mine) && !b[i].startsWith(mine));
   return { from: from < 0 ? null : from, to };
 }
+function drawReason(history) {
+  const last = history.at(-1);
+  return history.filter((key2) => key2 === last).length >= 3 ? "Draw \xB7 the same position occurred three times." : "Draw \xB7 too many moves without progress (no capture or man move).";
+}
 
 // lib/random.ts
 function randomStep(seed) {
@@ -4271,13 +4275,22 @@ function createGin(entropy2) {
 }
 function playGin(s, type, at, entropy2) {
   if (type === "next" && s.phase === "round")
-    return deal2(
-      s.result.startsWith("Stock") ? s.dealer : 1 - s.dealer,
-      s.scores,
-      s.wins,
-      s.round + 1,
-      entropy2
-    );
+    return {
+      ...deal2(
+        s.result.startsWith("Stock") ? s.dealer : 1 - s.dealer,
+        s.scores,
+        s.wins,
+        s.round + 1,
+        entropy2
+      ),
+      previous: [
+        s.result,
+        ...s.hands.map((h, i) => {
+          const layout = ginLayout(h);
+          return `Player ${i + 1}: melds ${layout.melds.map((m) => m.map(cardLabel).join(" ")).join(" \xB7 ") || "none"}; deadwood ${layout.deadwood.map(cardLabel).join(" ") || "none"} (${layout.value}).`;
+        })
+      ].join(" ")
+    };
   if (["finished", "round"].includes(s.phase))
     throw Error("This round is finished.");
   const t = structuredClone(s), seat = s.turn;
@@ -4396,7 +4409,7 @@ var multiplayerGames = [
     symbol: "1000",
     players: "2\u20134 players",
     description: "Bid your hand. Marry a new trump.",
-    rules: "A 24-card deck, nine through ace; strength is nine, jack, queen, king, ten, ace. Three active players receive seven cards and a three-card kitty. With four seats the dealer sits out and scores revealed kitty aces (50 each) and marriages. Two players receive ten cards each and choose one of two two-card kitties. The first active player opens at 100; bid in tens, no higher than 120 plus held marriages. Winner takes a kitty, gives each other active player a card (or discards two with two seats), then declares at least the auction bid. Follow suit and beat the winner when possible; if void, trump when held. Leading a held queen-king pair with the marriage declaration earns clubs 60, diamonds 80, hearts 100 or spades 40 and changes trump. Card points: ace 11, ten 10, king 4, queen 3, jack 2. Remaining kitty cards score for the last trick winner. Declarer makes or loses their contract; others round their points to tens. At 800, only declarer earns further points. First to 1000 wins, with declarer winning a simultaneous finish. The first bomb cancels freely; subsequent bombs award opponents 60 (40 with four seats). Four nines can request a redeal."
+    rules: "A 24-card deck, nine through ace; strength is nine, jack, queen, king, ten, ace. Three active players receive seven cards and a three-card kitty. With four seats the dealer sits out and scores revealed kitty aces (50 each) and marriages. Two players receive ten cards each and choose one of two two-card kitties. The first active player opens at 100; bid in tens, no higher than 120 plus held marriages. Winner takes a kitty, gives each other active player a card (or discards two with two seats), then declares at least the auction bid. Follow suit and beat the winner when possible; if void, trump when held. Leading a held queen-king pair with the marriage declaration earns clubs 60, diamonds 80, hearts 100 or spades 40 and changes trump. Card points: ace 11, ten 10, king 4, queen 3, jack 2. Cards left from the kitties, including the declarer\u2019s two discards in a two-player game, score for the last trick winner. Declarer makes or loses their contract; others round their points to tens. At 800, only declarer earns further points. First to 1000 wins, with declarer winning a simultaneous finish. The first bomb cancels freely; subsequent bombs award opponents 60 (40 with four seats). Four nines can request a redeal."
   },
   {
     id: "binokel",
@@ -4516,7 +4529,7 @@ var multiplayerGames = [
     symbol: "\u2654",
     players: "2 players",
     description: "Claim sixty-six. Close the stock with care.",
-    rules: "Six cards each from a 24-card deck. Rank order: nine, jack, queen, king, ten, ace; values 0, 2, 3, 4, 10, 11. While stock is open, play freely; trick winner draws first. Exchange trump nine after winning a trick. Before leading, you may close the stock; then follow suit, overtake if possible, otherwise trump. A queen\u2013king marriage declared while leading with open stock earns 20, or 40 in trump, once you have won a trick (including the one it leads). Claim 66 before leading, or immediately with a marriage. False claims or failed closure award the opponent 2/3 match points. Otherwise round wins earn 1\u20133 based on opponent points. An unclosed last trick adds ten. First to seven match points wins."
+    rules: "Six cards each from a 24-card deck. Rank order: nine, jack, queen, king, ten, ace; values 0, 2, 3, 4, 10, 11. While stock is open, play freely; trick winner draws first, and the trump upcard is the last card drawn. Exchange trump nine after winning a trick. Before leading, you may close the stock; then follow suit, overtake if possible, otherwise trump. A queen\u2013king marriage declared while leading with open stock earns 20, or 40 in trump, once you have won a trick (including the one it leads). Claim 66 before leading, or immediately with a marriage. False claims or failed closure award the opponent 2/3 match points. Otherwise round wins earn 1\u20133 based on opponent points. An unclosed last trick adds ten. First to seven match points wins."
   },
   {
     id: "spades",
@@ -4628,7 +4641,7 @@ var multiplayerGames = [
     symbol: "\u25CC",
     players: "2 players",
     description: "Sow seeds. Capture twos and threes.",
-    rules: "Each of twelve pits starts with four seeds. Sow counterclockwise, skipping the starting pit on a full lap. Ending on an opposing pit with two or three seeds captures it and preceding opposing pits with two or three. Captures that empty the entire opposing row are cancelled. Feed an empty opponent if possible. More than 24 captured seeds wins. No legal feeding move or three repetitions ends play; remaining seeds go to their owners."
+    rules: "Each of twelve pits starts with four seeds. Sow counterclockwise, skipping the starting pit on a full lap. Ending on an opposing pit with two or three seeds captures it and preceding opposing pits with two or three. Captures that would empty the entire opposing row (a grand slam) are cancelled. Feed an empty opponent if possible. More than 24 captured seeds wins. No legal feeding move or three repetitions ends play; remaining seeds go to their owners."
   },
   {
     id: "mills",
@@ -8708,7 +8721,7 @@ var adapter5 = defineMatchAdapter({
     return {
       finished: state.winner !== null || state.draw,
       winner: state.winner,
-      label: state.draw ? "Draw" : state.winner !== null ? `Player ${state.winner + 1} wins \xB7 the opponent has no legal move.` : ""
+      label: state.draw ? drawReason(state.history) : state.winner !== null ? `Player ${state.winner + 1} wins \xB7 the opponent has no legal move.` : ""
     };
   },
   apply(state, _seat, action, _entropy, _now) {
@@ -8726,7 +8739,7 @@ var adapter6 = defineMatchAdapter({
   actions: ["move", "sequence"],
   create: () => createInternational(),
   turn: (s) => s.turn,
-  outcome: (s) => ({ finished: s.winner !== null || s.draw, winner: s.winner, label: s.draw ? "Draw" : s.winner !== null ? `Player ${s.winner + 1} wins \xB7 the opponent has no legal move.` : "" }),
+  outcome: (s) => ({ finished: s.winner !== null || s.draw, winner: s.winner, label: s.draw ? drawReason(s.history) : s.winner !== null ? `Player ${s.winner + 1} wins \xB7 the opponent has no legal move.` : "" }),
   apply(s, _seat, a) {
     if (a.type === "move" && typeof a.from === "number" && typeof a.to === "number") return moveInternational(s, a.from, a.to);
     if (a.type === "sequence" && Array.isArray(a.cards) && a.cards.length >= 2 && a.cards.length <= 21) {
@@ -9061,6 +9074,7 @@ function playThousand(s, a, entropy2) {
   if (a.type === "next" && s.phase === "round") {
     t.round++;
     t.dealer = (s.dealer + 1) % s.hands.length;
+    t.previous = s.result;
     return deal6(t, entropy2);
   }
   if (a.type === "redeal" && s.phase === "auction" && s.hands[seat].filter((c) => cardRank(c) === 9).length === 4)
@@ -9107,9 +9121,9 @@ function playThousand(s, a, entropy2) {
     return t;
   }
   if (a.type === "bomb" && ["kitty", "exchange", "declare"].includes(s.phase)) {
-    if (t.bombs[seat]++ > 0)
-      t.players.filter((i) => i !== seat && t.scores[i] < 800).forEach((i) => t.scores[i] += t.hands.length === 4 ? 40 : 60);
-    t.result = "Declarer cancels the hand with a bomb.";
+    const penalty2 = t.bombs[seat]++ > 0 ? t.hands.length === 4 ? 40 : 60 : 0;
+    t.players.filter((i) => i !== seat && t.scores[i] < 800).forEach((i) => t.scores[i] += penalty2);
+    t.result = `Player ${seat + 1} cancels the hand with a bomb${penalty2 ? `; the other players score ${penalty2}` : " (the first bomb is free)"}.`;
     finish4(t);
     return t;
   }
@@ -9154,10 +9168,12 @@ function playThousand(s, a, entropy2) {
         (n, c) => n + pointValue(cardRank(c)),
         0
       );
+      const before = t.scores;
       t.scores = t.scores.map(
         (n, i) => i === t.bidder ? n + (t.points[i] >= t.contract ? t.contract : -t.contract) : t.players.includes(i) && n < 800 ? n + Math.round(t.points[i] / 10) * 10 : n
       );
-      t.result = `Hand points ${t.points.join(" / ")} \xB7 Contract ${t.contract}.`;
+      const made = t.points[t.bidder] >= t.contract, change = (i) => `${t.scores[i] - before[i] >= 0 ? "+" : ""}${t.scores[i] - before[i]}`;
+      t.result = `Player ${t.bidder + 1} ${made ? "makes" : "fails"} ${t.contract} with ${t.points[t.bidder]} (${change(t.bidder)}). ${t.players.filter((i) => i !== t.bidder).map((i) => `Player ${i + 1} ${t.points[i]} points (${before[i] >= 800 ? "not scored: 800 rule" : change(i)})`).join(", ")}.`;
       finish4(t);
     }
     return t;
@@ -10413,6 +10429,7 @@ function playMakao(s, a, entropy2) {
   const t = structuredClone(s), seat = s.turn;
   if (a.type === "catch" && s.unannounced !== null && s.unannounced !== seat) {
     draw(t, s.unannounced, 5, entropy2);
+    t.last = { seat: s.unannounced, type: "caught", count: 5 };
     t.unannounced = null;
     t.result = "Missed Makao: draw five.";
     return t;
@@ -10421,12 +10438,13 @@ function playMakao(s, a, entropy2) {
     t.unannounced = null;
     if (s.wait) {
       t.blocked[seat] = s.wait - 1;
+      t.last = { seat, type: "wait", count: s.wait };
       t.wait = 0;
       advance3(t);
       return t;
     }
     if (s.penalty) {
-      draw(t, seat, s.penalty, entropy2);
+      t.last = { seat, type: "penalty", count: draw(t, seat, s.penalty, entropy2).length };
       t.penalty = 0;
       t.suit = null;
       advance3(t);
@@ -10434,11 +10452,13 @@ function playMakao(s, a, entropy2) {
     }
     const received = draw(t, seat, 1, entropy2);
     t.drawn = received[0] ?? null;
+    t.last = { seat, type: "draw", count: received.length };
     t.phase = "drawn";
     if (t.drawn === null) advance3(t);
     return t;
   }
   if (a.type === "pass" && s.phase === "drawn") {
+    t.last = { seat, type: "keep", count: 1 };
     t.unannounced = null;
     t.suit = null;
     advance3(t);
@@ -10453,6 +10473,7 @@ function playMakao(s, a, entropy2) {
     throw Error("Request an ordinary rank, or choose no demand.");
   t.unannounced = null;
   t.hands[seat] = t.hands[seat].filter((c) => !cards.includes(c));
+  t.last = { seat, type: "play", cards: [...cards], ...t.hands[seat].length === 1 && a.promotion === "makao" ? { announced: true } : {} };
   t.pile.push(...cards);
   t.suit = null;
   if (rank2 === 14) t.suit = a.amount;
@@ -11406,7 +11427,7 @@ function panLegal(s, cards) {
 }
 function playPan(s, type, cards, entropy2) {
   if (type === "next" && s.phase === "round")
-    return deal12(s.hands.length, entropy2, s.letters, s.round + 1);
+    return { ...deal12(s.hands.length, entropy2, s.letters, s.round + 1), previous: s.result };
   if (s.phase !== "play") throw Error("This round is finished.");
   const t = structuredClone(s), seat = s.turn;
   if (type === "play" && panLegal(s, cards)) {
@@ -11560,7 +11581,7 @@ function award2(t, winner2, failure = false) {
 }
 function playSixtySix(s, type, at, marriage = false, claimMarriage = false, entropy2) {
   if (type === "next" && s.phase === "round")
-    return deal13(1 - s.dealer, s.scores, s.round + 1, entropy2);
+    return { ...deal13(1 - s.dealer, s.scores, s.round + 1, entropy2), previous: s.result };
   if (s.phase !== "play") throw Error("This round is finished.");
   const t = structuredClone(s), seat = s.turn;
   if (type === "close" && !s.trick.length && s.closed === null && s.upcard !== null) {
@@ -11605,6 +11626,7 @@ function playSixtySix(s, type, at, marriage = false, claimMarriage = false, entr
     t.tricks[winner2]++;
     t.turn = winner2;
     t.lastTrick = t.trick;
+    t.played = [...s.played ?? [], ...t.trick.map((c) => c.card)];
     t.trick = [];
     if (t.closed === null && t.upcard !== null)
       for (const i of [winner2, 1 - winner2]) {
@@ -12425,11 +12447,16 @@ function agentPosition(room) {
       knock_limit: 10
     };
   })() : null;
+  const ruleNotes = match?.kind === "thousand" ? match.state.scores.flatMap((score, seat) => match.state.phase !== "finished" && score >= 800 ? [`Seat ${seat} (${room.players[seat]?.name ?? "empty"}) has ${score} points: from 800, defending points no longer score; only a made contract adds points.`] : []) : [];
+  const sixtyUnseen = match?.kind === "sixty-six" && match.state.phase === "play" ? (() => {
+    const s = match.state, seen = /* @__PURE__ */ new Set([...(s.hands[room.seat] ?? []).filter((c) => c !== null), ...s.played ?? [], ...s.trick.map((c) => c.card), ...s.upcard === null ? [] : [s.upcard]]);
+    return Array.from({ length: 24 }, (_, i) => Math.floor(i / 6) * 13 + 7 + i % 6).filter((c) => !seen.has(c)).map((c) => `${cardLabel(c)} (id ${c})`);
+  })() : null;
   const asianMove = match?.kind === "shogi" || match?.kind === "xiangqi" ? asianLastMove(match.state.history) : null;
   const asianLast = asianMove && (match?.kind === "shogi" || match?.kind === "xiangqi") ? { ...asianMove, by: match.state.history.at(-1).mover } : null;
   const millLast = match?.kind === "mills" ? millLastTurn(match.state) : null;
-  const cribbageCard = match?.kind === "cribbage" && match.state.phase === "peg" ? match.state.sequence.at(-1) : void 0;
-  const cribbageLast = match?.kind === "cribbage" && cribbageCard !== void 0 ? { by_seat: match.state.played.findIndex((cards) => cards.includes(cribbageCard)), played: `${cribbageLabel(cribbageCard)} (id ${cribbageCard})`, count: match.state.total } : null;
+  const peg = match?.kind === "cribbage" && match.state.phase === "peg" ? match.state.lastPeg : void 0;
+  const cribbageLast = peg ? { by_seat: peg.seat, ...peg.go ? { type: "go" } : { played: `${cribbageLabel(peg.card)} (id ${peg.card})` }, count: peg.count, ...peg.count === 31 || match?.kind === "cribbage" && match.state.total === 0 && peg.count > 0 ? { count_reset: true } : {} } : null;
   return {
     protocol_version: 1,
     room: room.code,
@@ -12447,13 +12474,15 @@ function agentPosition(room) {
     board_labeled: dotsLabeled ?? (match?.kind === "oware" ? [...labeledBoard(room.game, board) ?? [], `captured: seat 0 ${match.state.scores[0]}, seat 1 ${match.state.scores[1]}`] : null) ?? labeledBoard(room.game, board) ?? grid?.labeled ?? null,
     ...grid ? { board_legend: grid.legend } : dotsLabeled ? { board_legend: "One line per box: owner (X seat 0, O seat 1, . open), then its four edges as one-based edge numbers (--edge N); * marks a drawn edge. A box with three drawn edges can be taken now." } : {},
     // Chess and its variants record the last move in SAN.
-    last_move: (match?.kind === "chess" || match?.kind === "atomic-chess" || match?.kind === "three-check") && match.state.last ? { san: match.state.last } : checkerLast ? { from: square(checkerLast.from), to: square(checkerLast.to) } : cribbageLast ? cribbageLast : asianLast ? { by_seat: asianLast.by, ...asianLast.from === null ? { type: "drop" } : { from: asianLast.from }, to: asianLast.to } : match?.kind === "oware" && match.state.last !== null ? { last_seed_in_pit: match.state.last + 1 } : millLast ? { by_seat: millLast.seat, ...millLast.from === null ? { type: "place" } : { type: "move", from: millLast.from }, at: millLast.to, ...millLast.captured.length ? { captured: millLast.captured } : {} } : last === null ? null : room.game === "connect-four" ? { column: last % columns + 1, row_from_top: Math.floor(last / columns) + 1 } : { row: Math.floor(last / columns) + 1, column: last % columns + 1 },
+    last_move: (match?.kind === "chess" || match?.kind === "atomic-chess" || match?.kind === "three-check") && match.state.last ? { san: match.state.last } : checkerLast ? { from: square(checkerLast.from), to: square(checkerLast.to) } : cribbageLast ? cribbageLast : match?.kind === "makao" && match.state.last ? { by_seat: match.state.last.seat, type: match.state.last.type, ...match.state.last.cards ? { cards: match.state.last.cards.map((c) => `${cardLabel(c)} (id ${c})`) } : {}, ...match.state.last.count !== void 0 && match.state.last.type !== "play" ? { count: match.state.last.count } : {}, ...match.state.last.announced ? { announced_makao: true } : {} } : asianLast ? { by_seat: asianLast.by, ...asianLast.from === null ? { type: "drop" } : { from: asianLast.from }, to: asianLast.to } : match?.kind === "oware" && match.state.last !== null ? { last_seed_in_pit: match.state.last + 1 } : millLast ? { by_seat: millLast.seat, ...millLast.from === null ? { type: "place" } : { type: "move", from: millLast.from }, at: millLast.to, ...millLast.captured.length ? { captured: millLast.captured } : {} } : last === null ? null : room.game === "connect-four" ? { column: last % columns + 1, row_from_top: Math.floor(last / columns) + 1 } : { row: Math.floor(last / columns) + 1, column: last % columns + 1 },
     ...room.game === "chess" ? { fen } : {},
     // The side to move is in check (chess family, xiangqi, shogi).
     ...match && room.phase === "playing" && (match.kind === "chess" ? chessPosition(match.state).inCheck() : "check" in match.state && match.state.check === true) ? { in_check: true } : {},
     visible_state: match?.state ?? null,
     cards_labeled: match ? cardsLabeled(room.game, match.state) : null,
     ...ginHint ? { gin_deadwood: ginHint } : {},
+    ...sixtyUnseen ? { sixty_six_unseen: sixtyUnseen } : {},
+    ...ruleNotes.length ? { rule_notes: ruleNotes } : {},
     // Timed rounds (drawing, categories): agents cannot measure time, so give the remaining seconds.
     ...typeof match?.state?.deadline === "number" && room.serverNow ? { deadline_seconds_left: Math.max(0, Math.ceil((match.state.deadline - room.serverNow) / 1e3)) } : {},
     action_types: action_catalog_default[room.game],
@@ -12795,7 +12824,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; start the next one (the deal moves on): ${play(`'{"type":"next"}'`)} --wait${flag}`;
+    if (wire?.length === 1 && wire[0].type === "next" && Object.keys(wire[0]).length === 1) return `The hand is over and you deal the next one: ${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: " : "";
@@ -12803,12 +12832,19 @@ function nextStep(position, event, brief = false, server) {
       state?.penalty ? `A ${state.penalty}-card penalty is active: answer with a matching attack card, or draw takes all ${state.penalty}. ` : "",
       state?.wait ? `A ${state.wait}-turn wait is active: answer with a 4, or draw serves the wait (no cards drawn). ` : "",
       state?.blocked?.[position.you.seat] ? `You are blocked for ${state.blocked[position.you.seat]} more turn(s). ` : "",
-      state?.demand !== null && state?.demand !== void 0 ? `Jack demand in force: ${state.demand === 13 ? "king" : `rank ${state.demand}`}. ` : "",
-      state?.suit !== null && state?.suit !== void 0 ? `Ace suit in force: ${["clubs", "diamonds", "hearts", "spades"][state.suit]}. ` : ""
+      state?.demand !== null && state?.demand !== void 0 ? `Jack demand in force: ${state.demand === 13 ? "king" : `rank ${state.demand}`}, or answer with a jack${state.demandTurns ? ` (${state.demandTurns} turn(s) left)` : ""}. ` : "",
+      state?.suit !== null && state?.suit !== void 0 ? `Ace suit in force: ${["clubs", "diamonds", "hearts", "spades"][state.suit]}. ` : "",
+      state?.phase === "drawn" && state.drawn !== null && state.drawn !== void 0 ? `You drew ${cardLabel(state.drawn)} (id ${state.drawn}): play it if it is listed, otherwise pass to keep it. ` : "",
+      wire?.some((action) => action.type === "play" && Array.isArray(action.cards) && action.cards.length === (state?.hands?.[position.you.seat]?.length ?? 0) - 1) ? 'A play that leaves you one card must use its entry with "promotion":"makao", or the opponent can make you draw five. ' : ""
     ].join(""))(position.visible_state) : "";
+    const chain = position.visible_state?.chain;
+    const jumper = (position.legal_actions?.[0] ?? wire?.[0])?.from;
+    const capture = chain !== null && chain !== void 0 && jumper !== void 0 ? `Your capture continues: jump again with the piece on ${String(jumper)} (one jump per call). ` : "";
     const mill = position.game === "mills" && wire?.length && wire.every((action) => action.type === "capture") ? "You completed a mill: remove one opposing piece (only pieces outside mills, unless all are in mills). " : "";
-    return `Your move. ${mill}${makao}${partial}${check}${play(move2)} --wait${flag}`;
+    return `Your move. ${capture}${mill}${makao}${partial}${check}${play(move2)} --wait${flag}`;
   }
+  const dealing = ["round", "show"].includes(String(position.visible_state?.phase));
+  if (dealing && position.turn) return `The hand is over; seat ${position.turn.seat} (${position.players[position.turn.seat]?.name ?? "empty"}) deals the next one. Do not send next yourself. Wait: ${wait}`;
   if (event === "waiting") return `No change yet. If the other players are still playing, wait again: ${wait}. After several silent waits, stop and tell the human how to resume.`;
   const outOfTurn = position.legal_actions_complete || position.legal_wire_actions_complete ? "" : " Some phases allow out-of-turn actions; check game rules for this phase first.";
   const mover = position.turn ? ` (seat ${position.turn.seat}, ${position.players[position.turn.seat]?.name ?? "empty"}, to act)` : "";
@@ -12899,7 +12935,7 @@ async function installSkill(agent = "codex", update = false) {
 // packages/cli/package.json
 var package_default = {
   name: "@leafarcade/cli",
-  version: "0.8.0",
+  version: "0.9.0",
   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",
@@ -13195,6 +13231,15 @@ function stateChanges(game, before, after, limit = 30) {
     const here = path.join(".");
     const primitive = (v) => v === null || typeof v !== "object";
     if (Array.isArray(a) && Array.isArray(b)) {
+      if (a.length && b.length && [...a, ...b].every((v) => typeof v === "string")) {
+        for (let k = 0; k < a.length; k++) {
+          const kept = a.slice(k);
+          if (kept.every((v, i) => v === b[i]) && b.length > kept.length) {
+            out2.push(`${here}: + ${b.slice(kept.length).map((v) => show(v)).join(", ")}`);
+            return;
+          }
+        }
+      }
       if (a.length === b.length && a.length > 4 && a.every(primitive) && b.every(primitive)) {
         a.forEach((v, i) => {
           if (v !== b[i] && out2.length <= limit) out2.push(`${here}[${i}]: ${show(v)} \u2192 ${show(b[i])}`);
@@ -13666,6 +13711,7 @@ var scores = (position) => {
   const value = position.visible_state?.scores;
   return Array.isArray(value) && value.length && value.every((n) => typeof n === "number") ? value : null;
 };
+var withoutLegal = (state) => Object.fromEntries(Object.entries(state).filter(([key2]) => key2 !== "legalActions"));
 function briefPosition(position) {
   const turn = position.turn ? position.turn.yours ? "yours" : seatName(position, position.turn.seat) : null;
   const wire = "legal_wire_actions" in position ? position.legal_wire_actions ?? [] : null;
@@ -13693,9 +13739,12 @@ 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.board_labeled || !position.visible_state ? {} : { visible_state: position.visible_state },
+    // The legal moves are listed once at the top level, not again inside the state.
+    ...position.legal_actions_complete && position.board_labeled || !position.visible_state ? {} : { visible_state: withoutLegal(position.visible_state) },
     ...position.cards_labeled ? { cards_labeled: position.cards_labeled } : {},
     ..."gin_deadwood" in position ? { gin_deadwood: position.gin_deadwood } : {},
+    ..."sixty_six_unseen" in position ? { sixty_six_unseen: position.sixty_six_unseen } : {},
+    ..."rule_notes" in position ? { rule_notes: position.rule_notes } : {},
     ...position.access_requests?.length ? { access_requests: position.access_requests } : {}
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leafarcade/cli",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "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",

package/skills/leafarcade/SKILL.md

@@ -35,7 +35,7 @@ When the human already has a room code, use `leafarcade join ROOMCODE --name "My
 ## The play loop
 
 - **Wait on the table yourself.** After your move, use `play --wait` or `game wait`. Never ask the human to tell you they moved.
-- Read `game rules --game GAME_ID` once. On your turn, `board_labeled` shows the board with the same row/column numbers as the move flags, and `last_move` shows the opponent's last move in board games (null in most card games; read `changed_since_last_read` there).
+- Read `game rules --game GAME_ID` once. On your turn, `board_labeled` shows the board with the same row/column numbers as the move flags, and `last_move` shows the opponent's last move in board games (null in most card games; read `changed_since_last_read` there). Some games add hints: `rule_notes` (rules in force now, such as Thousand's 800 rule), `gin_deadwood` and `sixty_six_unseen` (cards you have not seen this deal).
 - Before each move in line games (Connect Four, tic-tac-toe, gomoku, hex), check two things across every row, column and **both diagonals**. First, can you win now? Second, does the opponent threaten to win next turn?
 - Most games list every legal move. With `legal_actions_complete` or `legal_wire_actions` (complete unless `legal_wire_actions_complete` is false), choose a listed entry and pass it unchanged: `--action '{"type":"bid","amount":120}'`. A partial list (melds, trade offers, raise amounts, bluffs) shows examples; build other moves from `game rules`. Wire indexes are zero-based; the convenience flags are one-based.
 - Card games add `cards_labeled` (for example `"hands.1": ["Q♠ (id 49)", …]`): read card names there, not from raw IDs. Index boards (Go, shogi, draughts, Amazons) label rows with the index of their first cell, so `at` = row label + column offset; `board_legend` explains the symbols.