balatrobot 1.3.0__tar.gz → 1.3.3__tar.gz

{balatrobot-1.3.0 → balatrobot-1.3.3}/.github/workflows/release_please.yml

@@ -69,20 +69,3 @@ jobs:
           else
             echo "No changes to version files"
           fi
-      - name: Notify consumer repo of new balatrobot release
-        if: ${{ steps.release.outputs.release_created }}
-        env:
-          BALATROLLM_REPO: "coder/balatrollm"
-          BALATROLLM_TOKEN: ${{ secrets.BALATROLLM_TOKEN }}
-          BALATRO_REPO: "S1M0N38/balatro"
-          BALATRO_TOKEN: ${{ secrets.BALATRO_TOKEN }}
-        run: |
-          VERSION="${{ steps.release.outputs.version }}"
-          curl -X POST -H "Accept: application/vnd.github+json" \
-            -H "Authorization: token $BALATROLLM_TOKEN" \
-            https://api.github.com/repos/$BALATROLLM_REPO/dispatches \
-            -d "{\"event_type\":\"balatrobot_release\",\"client_payload\":{\"version\":\"$VERSION\"}}"
-          curl -X POST -H "Accept: application/vnd.github+json" \
-            -H "Authorization: token $BALATRO_TOKEN" \
-            https://api.github.com/repos/$BALATRO_REPO/dispatches \
-            -d "{\"event_type\":\"balatrobot_release\",\"client_payload\":{\"version\":\"$VERSION\"}}"

balatrobot-1.3.3/.github/workflows/release_pypi.yml

@@ -0,0 +1,53 @@
+name: Release PyPI
+on:
+  push:
+    tags:
+      - v*
+  workflow_dispatch:
+jobs:
+  pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: ".python-version"
+      - name: Build
+        run: uv build
+      - name: Publish
+        run: uv publish
+      - name: Wait for PyPI availability and notify balatrollm
+        env:
+          BALATROLLM_TOKEN: ${{ secrets.BALATROLLM_TOKEN }}
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          echo "Waiting for version $VERSION to appear on PyPI..."
+
+          # Poll PyPI until version is available (max 5 minutes)
+          for i in {1..30}; do
+            PYPI_VERSION=$(curl -s https://pypi.org/pypi/balatrobot/json | jq -r .info.version)
+            if [ "$PYPI_VERSION" = "$VERSION" ]; then
+              echo "✓ Version $VERSION is available on PyPI"
+              curl -s -X POST -H "Accept: application/vnd.github+json" \
+                -H "Authorization: token $BALATROLLM_TOKEN" \
+                https://api.github.com/repos/coder/balatrollm/dispatches \
+                -d "{\"event_type\":\"balatrobot_release\",\"client_payload\":{\"version\":\"$VERSION\"}}"
+              echo "✓ Dispatched to balatrollm"
+              exit 0
+            fi
+            echo "Attempt $i/30: PyPI shows $PYPI_VERSION, waiting for $VERSION..."
+            sleep 10
+          done
+
+          echo "ERROR: Version $VERSION not available on PyPI after 5 minutes"
+          exit 1

{balatrobot-1.3.0 → balatrobot-1.3.3}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [1.3.3](https://github.com/coder/balatrobot/compare/v1.3.2...v1.3.3) (2026-01-12)
+
+
+### Continuous Integration
+
+* **release:** move release notification to pypi workflow ([2274781](https://github.com/coder/balatrobot/commit/2274781d66cdc32a09f618b5058542dc1e4dc2b4))
+
+## [1.3.2](https://github.com/coder/balatrobot/compare/v1.3.1...v1.3.2) (2026-01-12)
+
+
+### Bug Fixes
+
+* **lua.endpoint:** add nil checks for race condition in `next_round` endpoint ([ce08dcc](https://github.com/coder/balatrobot/commit/ce08dcc5a13b102ecd0ac56631791903487f7fea))
+* **lua.endpoints:** fix error message for invalid voucher/pack index in buy ([4af3d39](https://github.com/coder/balatrobot/commit/4af3d39c31a2575c7986c4cda81618ee5aa652fe))
+
+## [1.3.1](https://github.com/coder/balatrobot/compare/v1.3.0...v1.3.1) (2026-01-11)
+
+
+### Bug Fixes
+
+* **lua.endpoints:** fix `pack` with mega packs with double target selection ([ba3e270](https://github.com/coder/balatrobot/commit/ba3e2700bb31ec90c16cbc1316ee2dc5771dbf7e))
+
 ## [1.3.0](https://github.com/coder/balatrobot/compare/v1.2.2...v1.3.0) (2026-01-06)
 
 

{balatrobot-1.3.0 → balatrobot-1.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: balatrobot
-Version: 1.3.0
+Version: 1.3.3
 Summary: API for developing Balatro bots
 Project-URL: Homepage, https://github.com/coder/balatrobot
 Project-URL: Issues, https://github.com/coder/balatrobot/issues

{balatrobot-1.3.0 → balatrobot-1.3.3}/balatrobot.json

@@ -15,7 +15,7 @@
   "badge_colour": "4CAF50",
   "badge_text_colour": "FFFFFF",
   "display_name": "BB",
-  "version": "1.2.2",
+  "version": "1.3.2",
   "dependencies": [
     "Steamodded (>=1.*)"
   ]

{balatrobot-1.3.0 → balatrobot-1.3.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "balatrobot"
-version = "1.3.0"
+version = "1.3.3"
 description = "API for developing Balatro bots"
 readme = "README.md"
 authors = [

{balatrobot-1.3.0 → balatrobot-1.3.3}/src/balatrobot/__init__.py

@@ -3,5 +3,5 @@
 from balatrobot.config import Config
 from balatrobot.manager import BalatroInstance
 
-__version__ = "1.3.0"
+__version__ = "1.3.3"
 __all__ = ["BalatroInstance", "Config", "__version__"]

{balatrobot-1.3.0 → balatrobot-1.3.3}/src/lua/endpoints/buy.lua

@@ -101,8 +101,16 @@ return {
 
     -- Validate card index is in range
     if not area.cards[pos] then
+      local msg
+      if args.card then
+        msg = "Card index out of range. Index: " .. args.card .. ", Available cards: " .. area.count
+      elseif args.voucher then
+        msg = "Voucher index out of range. Index: " .. args.voucher .. ", Available: " .. area.count
+      else
+        msg = "Pack index out of range. Index: " .. args.pack .. ", Available: " .. area.count
+      end
       send_response({
-        message = "Card index out of range. Index: " .. args.card .. ", Available cards: " .. area.count,
+        message = msg,
         name = BB_ERROR_NAMES.BAD_REQUEST,
       })
       return

{balatrobot-1.3.0 → balatrobot-1.3.3}/src/lua/endpoints/next_round.lua

@@ -32,14 +32,28 @@ return {
       trigger = "condition",
       blocking = false,
       func = function()
-        local blind_pane = G.blind_select_opts[string.lower(G.GAME.blind_on_deck)]
+        -- Wait for state transition and UI to be fully initialized
+        if G.STATE ~= G.STATES.BLIND_SELECT then
+          return false
+        end
+        if not G.blind_select_opts then
+          return false
+        end
+
+        local blind_key = string.lower(G.GAME.blind_on_deck)
+        local blind_pane = G.blind_select_opts[blind_key]
+        if not blind_pane then
+          return false
+        end
+
         local select_button = blind_pane:get_UIE_by_ID("select_blind_button")
-        local done = G.STATE == G.STATES.BLIND_SELECT and select_button ~= nil
-        if done then
-          sendDebugMessage("Return next_round() - reached BLIND_SELECT state", "BB.ENDPOINTS")
-          send_response(BB_GAMESTATE.get_gamestate())
+        if not select_button then
+          return false
         end
-        return done
+
+        sendDebugMessage("Return next_round() - reached BLIND_SELECT state", "BB.ENDPOINTS")
+        send_response(BB_GAMESTATE.get_gamestate())
+        return true
       end,
     }))
   end,

{balatrobot-1.3.0 → balatrobot-1.3.3}/src/lua/endpoints/pack.lua

@@ -196,12 +196,12 @@ return {
 
           -- Highlight the target cards in hand
           if args.targets and #args.targets > 0 then
-            -- Clear existing highlights
-            for _, hand_card in ipairs(G.hand.cards) do
-              hand_card.highlighted = false
+            -- Clear existing highlights using proper CardArea method
+            for i = #G.hand.highlighted, 1, -1 do
+              G.hand:remove_from_highlighted(G.hand.highlighted[i], true)
             end
 
-            -- Highlight target cards
+            -- Highlight target cards using proper CardArea method
             for _, target_idx in ipairs(args.targets) do
               local hand_pos = target_idx + 1 -- Convert 0-based to 1-based
               if not G.hand.cards[hand_pos] then
@@ -211,8 +211,7 @@ return {
                 })
                 return true
               end
-              G.hand.cards[hand_pos].highlighted = true
-              G.hand.highlighted[#G.hand.highlighted + 1] = G.hand.cards[hand_pos]
+              G.hand:add_to_highlighted(G.hand.cards[hand_pos], true)
             end
           end
         end
@@ -320,17 +319,35 @@ return {
         trigger = "condition",
         blocking = false,
         func = function()
-          -- Calculate expected hand size
-          -- If deck has fewer cards than hand limit, hand will only have deck_size cards
+          -- Wait for state transition to complete (ensures hand is fully dealt)
+          if not G.STATE_COMPLETE then
+            return false
+          end
+
+          -- Calculate expected hand size for initial load
+          -- After cards are destroyed (mega packs), hand may have fewer cards
           local hand_limit = G.hand.config and G.hand.config.card_limit or 8
           local deck_size = G.deck and G.deck.config and G.deck.config.card_count or 52
           local expected_hand_size = math.min(deck_size, hand_limit)
 
-          -- Wait for hand to be fully loaded and positioned
+          -- Calculate minimum required cards based on target indices
+          local min_required = 1
+          if args.targets and #args.targets > 0 then
+            for _, target_idx in ipairs(args.targets) do
+              local required = target_idx + 1 -- 0-based to 1-based
+              if required > min_required then
+                min_required = required
+              end
+            end
+          end
+
+          -- Wait for hand to be ready:
+          -- - At least expected_hand_size cards (initial load), OR
+          -- - At least min_required cards (for mega packs after cards destroyed)
           local hand_ready = G.hand
             and not G.hand.REMOVED
             and G.hand.cards
-            and #G.hand.cards == expected_hand_size
+            and (#G.hand.cards >= expected_hand_size or #G.hand.cards >= min_required)
             and G.hand.T -- Table area exists
             and G.hand.T.x -- Positioned
 

{balatrobot-1.3.0 → balatrobot-1.3.3}/src/lua/utils/openrpc.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "BalatroBot API",
     "description": "JSON-RPC 2.0 API for Balatro bot development. This API allows external clients to control the Balatro game, query game state, and execute actions through an HTTP server.",
-    "version": "1.2.2",
+    "version": "1.3.2",
     "license": {
       "name": "MIT"
     }

{balatrobot-1.3.0 → balatrobot-1.3.3}/tests/fixtures/fixtures.json

@@ -1612,6 +1612,152 @@
           "pack": 1
         }
       }
+    ],
+    "seed-VEBROR8--state-SMODS_BOOSTER_OPENED--pack.key-p_arcana_mega_1": [
+      {
+        "method": "menu",
+        "params": {}
+      },
+      {
+        "method": "start",
+        "params": {
+          "deck": "RED",
+          "stake": "WHITE",
+          "seed": "VEBROR8"
+        }
+      },
+      {
+        "method": "select",
+        "params": {}
+      },
+      {
+        "method": "set",
+        "params": {
+          "chips": 1000,
+          "money": 100
+        }
+      },
+      {
+        "method": "play",
+        "params": {
+          "cards": [
+            0
+          ]
+        }
+      },
+      {
+        "method": "cash_out",
+        "params": {}
+      },
+      {
+        "method": "buy",
+        "params": {
+          "pack": 0
+        }
+      },
+      {
+        "method": "pack",
+        "params": {
+          "skip": true
+        }
+      },
+      {
+        "method": "buy",
+        "params": {
+          "pack": 0
+        }
+      },
+      {
+        "method": "pack",
+        "params": {
+          "skip": true
+        }
+      },
+      {
+        "method": "add",
+        "params": {
+          "key": "p_arcana_mega_1"
+        }
+      },
+      {
+        "method": "buy",
+        "params": {
+          "pack": 0
+        }
+      }
+    ],
+    "seed-7IDNRIV--state-SMODS_BOOSTER_OPENED--pack.cards[2].key-c_black_hole": [
+      {
+        "method": "menu",
+        "params": {}
+      },
+      {
+        "method": "start",
+        "params": {
+          "deck": "RED",
+          "stake": "WHITE",
+          "seed": "7IDNRIV"
+        }
+      },
+      {
+        "method": "select",
+        "params": {}
+      },
+      {
+        "method": "set",
+        "params": {
+          "chips": 1000,
+          "money": 100
+        }
+      },
+      {
+        "method": "play",
+        "params": {
+          "cards": [
+            0
+          ]
+        }
+      },
+      {
+        "method": "cash_out",
+        "params": {}
+      },
+      {
+        "method": "buy",
+        "params": {
+          "pack": 0
+        }
+      },
+      {
+        "method": "pack",
+        "params": {
+          "skip": true
+        }
+      },
+      {
+        "method": "buy",
+        "params": {
+          "pack": 0
+        }
+      },
+      {
+        "method": "pack",
+        "params": {
+          "skip": true
+        }
+      },
+      {
+        "method": "add",
+        "params": {
+          "key": "p_celestial_mega_1"
+        }
+      },
+      {
+        "method": "buy",
+        "params": {
+          "pack": 0
+        }
+      }
     ]
   },
   "sell": {

{balatrobot-1.3.0 → balatrobot-1.3.3}/tests/lua/endpoints/test_buy.py

@@ -49,7 +49,7 @@ class TestBuyEndpoint:
             "No jokers/consumables/cards in the shop. Reroll to restock the shop",
         )
 
-    def test_buy_invalid_index(self, client: httpx.Client) -> None:
+    def test_buy_invalid_card_index(self, client: httpx.Client) -> None:
         """Test buy endpoint with invalid card index."""
         gamestate = load_fixture(client, "buy", "state-SHOP--shop.cards[0].set-JOKER")
         assert gamestate["state"] == "SHOP"
@@ -60,6 +60,34 @@ class TestBuyEndpoint:
             "Card index out of range. Index: 999, Available cards: 2",
         )
 
+    def test_buy_invalid_voucher_index(self, client: httpx.Client) -> None:
+        """Test buy endpoint with invalid voucher index."""
+        gamestate = load_fixture(
+            client, "buy", "state-SHOP--voucher.cards[0].set-VOUCHER"
+        )
+        assert gamestate["state"] == "SHOP"
+        assert gamestate["vouchers"]["cards"][0]["set"] == "VOUCHER"
+        assert_error_response(
+            api(client, "buy", {"voucher": 999}),
+            "BAD_REQUEST",
+            "Voucher index out of range. Index: 999, Available: 1",
+        )
+
+    def test_buy_invalid_pack_index(self, client: httpx.Client) -> None:
+        """Test buy endpoint with invalid pack index."""
+        gamestate = load_fixture(
+            client,
+            "buy",
+            "state-SHOP--packs.cards[0].label-Buffoon+Pack--packs.cards[1].label-Standard+Pack",
+        )
+        assert gamestate["state"] == "SHOP"
+        assert gamestate["packs"]["cards"][0]["label"] == "Buffoon Pack"
+        assert_error_response(
+            api(client, "buy", {"pack": 999}),
+            "BAD_REQUEST",
+            "Pack index out of range. Index: 999, Available: 2",
+        )
+
     def test_buy_insufficient_funds(self, client: httpx.Client) -> None:
         """Test buy endpoint when player has insufficient funds."""
         gamestate = load_fixture(client, "buy", "state-SHOP--money-0")

{balatrobot-1.3.0 → balatrobot-1.3.3}/tests/lua/endpoints/test_pack.py

@@ -372,6 +372,37 @@ class TestPackEndpointSelection:
         after = assert_gamestate_response(result)
         assert before["jokers"]["count"] + 1 == after["jokers"]["count"]
 
+    def test_pack_celestial_black_hole(self, client: httpx.Client) -> None:
+        """Test selecting Black Hole from a celestial mega pack levels up all hands.
+
+        Black Hole is a special planet card that levels up all poker hands by 1.
+        Mega packs allow 2 selections, so we also select a second planet card.
+        """
+        load_fixture(
+            client,
+            "pack",
+            "seed-7IDNRIV--state-SMODS_BOOSTER_OPENED--pack.cards[2].key-c_black_hole",
+        )
+        before = api(client, "gamestate", {})["result"]
+
+        # First selection: Black Hole at index 2
+        result = api(client, "pack", {"card": 2})
+        after_first = assert_gamestate_response(result, state="SMODS_BOOSTER_OPENED")
+
+        # Black Hole levels up ALL hands by 1
+        for hand_name in before["hands"]:
+            assert (
+                after_first["hands"][hand_name]["level"]
+                == before["hands"][hand_name]["level"] + 1
+            )
+
+        # Second selection: any planet card at index 0
+        result = api(client, "pack", {"card": 0})
+        after_second = assert_gamestate_response(result, state="SHOP")
+
+        # Pack should be closed after second selection
+        assert "pack" not in after_second
+
 
 # =============================================================================
 # Mega Pack Multi-Selection Tests
@@ -401,6 +432,38 @@ class TestPackEndpointMegaPack:
         gamestate = assert_gamestate_response(result, state="SHOP")
         assert "pack" not in gamestate
 
+    def test_mega_pack_both_selections_with_targets(self, client: httpx.Client) -> None:
+        """Test mega pack where both selections require targets.
+
+        Pack contents (seed VEBROR8):
+          [0] c_wheel_of_fortune
+          [1] c_sun
+          [2] c_star
+          [3] c_hanged_man - requires 2 targets (first selection)
+          [4] c_chariot - requires 1 target (second selection)
+        """
+        load_fixture(
+            client,
+            "pack",
+            "seed-VEBROR8--state-SMODS_BOOSTER_OPENED--pack.key-p_arcana_mega_1",
+        )
+
+        result = api(client, "pack", {"card": 3, "targets": [0, 1]})
+        gamestate = assert_gamestate_response(result, state="SMODS_BOOSTER_OPENED")
+
+        # After first selection, pack should still be open (mega packs allow 2 selections)
+        # The Hanged Man was removed, so cards shifted:
+        # [0] c_wheel_of_fortune, [1] c_sun, [2] c_star, [3] c_chariot
+        assert "pack" in gamestate
+        assert len(gamestate["pack"]["cards"]) == 4
+
+        # Second selection: card index 3 is now c_chariot (requires 1 target)
+        result = api(client, "pack", {"card": 3, "targets": [0]})
+        gamestate = assert_gamestate_response(result, state="SHOP")
+
+        # After second selection, pack should be closed
+        assert "pack" not in gamestate
+
 
 # =============================================================================
 # Skip Tests

{balatrobot-1.3.0 → balatrobot-1.3.3}/uv.lock

@@ -48,7 +48,7 @@ wheels = [
 
 [[package]]
 name = "balatrobot"
-version = "1.2.2"
+version = "1.3.2"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

balatrobot-1.3.0/.github/workflows/release_pypi.yml

@@ -1,28 +0,0 @@
-name: Release PyPI
-on:
-  push:
-    tags:
-      - v*
-  workflow_dispatch:
-jobs:
-  pypi:
-    name: Publish to PyPI
-    runs-on: ubuntu-latest
-    environment:
-      name: pypi
-    permissions:
-      id-token: write
-      contents: read
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-      - name: Install uv
-        uses: astral-sh/setup-uv@v7
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version-file: ".python-version"
-      - name: Build
-        run: uv build
-      - name: Publish
-        run: uv publish