feat(strategies): add pack endpoint support

Author: S1M0N38

src/balatrollm/bot.py

@@ -178,7 +178,7 @@ async def _run_game_loop(self, gamestate: dict[str, Any]) -> None:
             await self._balatro.call("gamestate")
 
             match current_state:
-                case "SELECTING_HAND" | "SHOP":
+                case "SELECTING_HAND" | "SHOP" | "SMODS_BOOSTER_OPENED":
                     response = await self._get_llm_response(gamestate)
                     gamestate = await self._execute_tool_call(response)
                 case "ROUND_EVAL":

src/balatrollm/strategies/default/GAMESTATE.md.jinja

@@ -193,15 +193,48 @@ Here are the vouchers that can be redeemed:
 {%- endfor %}
 {% endif %}
 
-{#- Packs purchase not yet supported
 {% if G.packs.cards %}
-Here are the booster packs that can be opened:
+### Booster Packs
+
 {% for pack in G.packs.cards -%}
-- {{ loop.index0 }}: {{ pack.label }}
+- {{ loop.index0 }}: **{{ pack.label }}**
+  - **Effect**: {{ pack.value.effect }}
   - **Cost**: ${{ pack.cost.buy }}
 {% endfor %}
 {% endif %}
--#}
+{%- endif %}
+
+{% if G.state == "SMODS_BOOSTER_OPENED" -%}
+## Pack Selection
+
+You have opened a booster pack. Choose a card or skip.
+
+### Available Cards in Pack
+
+{% for card in G.pack.cards -%}
+{% if card.set == "JOKER" %}
+- {{ loop.index0 }}: **{{ card.label }}** (Joker)
+  - **Effect**: {{ card.value.effect }}
+  - **Rarity**: {{ card.value.rarity|default('Common') }}
+{% elif card.set in ["TAROT", "PLANET", "SPECTRAL"] %}
+- {{ loop.index0 }}: **{{ card.label }}** ({{ card.set|title }})
+  - **Effect**: {{ card.value.effect }}
+{% if card.value.min_highlighted %}  - **Targets**: {{ card.value.min_highlighted }}-{{ card.value.max_highlighted }} hand cards{% endif %}
+{% elif card.set in ["DEFAULT", "ENHANCED"] %}
+- {{ loop.index0 }}: **{{ card.value.rank }} of {{ card.value.suit }}**
+{% if card.set == "ENHANCED" %}  - **Enhancement**: {{ card.value.enhancement }}{% endif %}
+{% if card.value.edition %}  - **Edition**: {{ card.value.edition }}{% endif %}
+{% if card.value.seal %}  - **Seal**: {{ card.value.seal }}{% endif %}
+{% endif %}
+{%- endfor %}
+
+{% if G.hand and G.hand.cards %}
+### Your Hand (for targeting)
+
+{% for card in G.hand.cards -%}
+- {{ loop.index0 }}: {{ card.value.rank }} of {{ card.value.suit }}{% if card.set == "ENHANCED" %} ({{ card.value.enhancement }}){% endif %}
+{% endfor %}
+{% endif %}
 {%- endif %}
 
 {% if G.state == "BLIND_SELECT" -%}
@@ -247,11 +280,12 @@ You **MUST** use one of the following tools to perform the intended action:
     - `consumables`: (list) New order of consumables (0-based indices, must include all consumables)
     - `reasoning`: (string) Strategic reasoning for this arrangement
 {% elif G.state == "SHOP" -%}
-- Buy a card or voucher from the shop
+- Buy a card, voucher, or pack from the shop
   - Function: `buy`
   - Parameters (provide exactly one of):
     - `card`: (integer) 0-based index of shop card to buy
     - `voucher`: (integer) 0-based index of voucher to buy
+    - `pack`: (integer) 0-based index of booster pack to buy and open
     - `reasoning`: (string) Strategic reasoning for this purchase
 - Reroll the shop items
   - Function: `reroll`
@@ -276,6 +310,18 @@ You **MUST** use one of the following tools to perform the intended action:
   - Function: `skip`
   - Parameters:
     - `reasoning`: (string) Strategic reasoning for skipping this blind
+{% elif G.state == "SMODS_BOOSTER_OPENED" -%}
+- Select a card from the pack
+  - Function: `pack`
+  - Parameters:
+    - `card`: (integer) 0-based index of card to select
+    - `targets`: (list, optional) 0-based indices of hand cards to target (for Tarot/Spectral that require selection)
+    - `reasoning`: (string) Strategic reasoning for this selection
+- Skip the pack selection
+  - Function: `pack`
+  - Parameters:
+    - `skip`: (boolean) Set to true to skip
+    - `reasoning`: (string) Strategic reasoning for skipping
 {% endif -%}
 {% if G.state in ["SELECTING_HAND", "SHOP"] -%}
 - Sell a joker or consumable for money

src/balatrollm/strategies/default/STRATEGY.md.jinja

@@ -196,24 +196,16 @@ By default, the shop sells:
 
 - 2 random cards (usually Jokers, but occasionally Tarot Cards and Planets)
 - 1 Voucher
-
-{#- Booster Packs not yet supported by BalatroBot API
 - 2 random Booster Packs
--#}
 
 All items in the shop have a buy cost (purchase price) and a sell cost (selling value) for the purchased items. The sell cost item is usually half of it buy cost.
 
 ### Reroll
 
 The player may pay money to reroll the shop an unlimited number of times, removing any of the remaining random cards and replacing them with 2 new random cards. The reroll cost starts at $5 and increases by $1 each reroll, resetting to $5 upon entering a new shop.
 
-{#- Pack purchase not yet supported by BalatroBot API
 However, rerolling the shop does not restock Booster Packs or the Voucher. Booster packs only restock upon entering a new shop, and the Voucher restocks after defeating the boss blind.
--#}
-
-However, rerolling the shop does not restock the Voucher. The Voucher restocks after defeating the boss blind.
 
-{#- Pack purchase not yet supported by BalatroBot API
 ### Booster Packs
 
 Two Booster Packs are always offered in each Shop, often but not always of two different types. These come in five categories:
@@ -225,7 +217,29 @@ Two Booster Packs are always offered in each Shop, often but not always of two d
 - **Spectral Packs** containing Spectral Cards for immediate use.
 
 A new set of Booster Packs will be offered with each shop. Booster Packs do not refresh when rerolling the Shop.
--#}
+
+#### Booster Pack Strategy
+
+Booster packs provide valuable cards but use them wisely:
+
+**When to Buy Packs:**
+- **Buffoon Packs**: Buy when you have joker slots available and need synergy
+- **Arcana Packs**: Good for card enhancements early game
+- **Celestial Packs**: Buy when you have a dominant hand type to level up
+- **Standard Packs**: Useful for building specific suits/ranks
+- **Spectral Packs**: High risk/reward - can duplicate jokers or destroy cards
+
+**Pack Selection Tips:**
+- For Arcana/Spectral packs, cards are used **immediately**
+- Some cards (like The Magician) require selecting target cards from your hand
+- Consider skipping if no cards benefit your current strategy
+- Buffoon/Standard packs add cards to your collection (not used immediately)
+
+**Targeting for Tarot/Spectral:**
+When a card requires targets:
+- Check the card's effect for how many cards to select
+- Target cards that will benefit most from the enhancement
+- For destructive cards, target low-value or duplicate cards
 
 ## Jokers
 

src/balatrollm/strategies/default/TOOLS.json

@@ -133,7 +133,7 @@
       "type": "function",
       "function": {
         "name": "buy",
-        "description": "Buy a card or voucher from the shop. Provide exactly one of: card or voucher.",
+        "description": "Buy a card, voucher, or pack from the shop. Provide exactly one of: card, voucher, or pack.",
         "parameters": {
           "type": "object",
           "properties": {
@@ -145,6 +145,10 @@
               "type": "integer",
               "description": "0-based index of voucher to buy"
             },
+            "pack": {
+              "type": "integer",
+              "description": "0-based index of booster pack to buy and open"
+            },
             "reasoning": {
               "type": "string",
               "description": "Strategic reasoning for this purchase"
@@ -302,5 +306,55 @@
         }
       }
     }
+  ],
+  "SMODS_BOOSTER_OPENED": [
+    {
+      "type": "function",
+      "function": {
+        "name": "pack",
+        "description": "Select a card from the opened booster pack. For Arcana/Spectral packs, cards are used immediately and may require targeting hand cards.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "card": {
+              "type": "integer",
+              "description": "0-based index of card to select from pack"
+            },
+            "targets": {
+              "type": "array",
+              "items": {"type": "integer"},
+              "description": "0-based indices of hand cards to target (required for some Tarot/Spectral cards)"
+            },
+            "reasoning": {
+              "type": "string",
+              "description": "Strategic reasoning for this selection"
+            }
+          },
+          "required": ["card", "reasoning"]
+        }
+      }
+    },
+    {
+      "type": "function",
+      "function": {
+        "name": "pack",
+        "description": "Skip the pack selection without taking any card.",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "skip": {
+              "type": "boolean",
+              "const": true,
+              "description": "Set to true to skip the pack"
+            },
+            "reasoning": {
+              "type": "string",
+              "description": "Strategic reasoning for skipping"
+            }
+          },
+          "required": ["skip", "reasoning"]
+        }
+      }
+    }
   ]
 }