feat(bot): add templates and tools configuration

Add Jinja2 templates for game state rendering and OpenAI tools definition
for different game states (BLIND_SELECT, SELECTING_HAND, SHOP).

Co-Authored-By: Claude <noreply@anthropic.com>

Author: S1M0N38

src/balatrollm/templates/game_state.md.jinja

@@ -0,0 +1,169 @@
+# Game State
+
+## Current Situation
+- **Game Phase**: {{ state_name }}
+{% if game -%}
+- **Round**: {{ game.round }}
+- **Ante**: Level {{ (game.round + 2) // 3 }}
+{% endif %}
+
+{% if consumables and consumables.cards and (consumables.cards | length) > 0 %}
+### Consumables ({{ consumables.cards | length }})
+{% for c in consumables.cards -%}
+  - {{ loop.index0 }}: {{ c.label }} ({{ c.config.center_key }}) | Cost: {{ c.cost | default('N/A') }}
+{% endfor %}
+{% endif %}
+
+{% if game %}
+## Resources
+- **Money**: ${{ game.dollars }}
+- **Chips**: {{ game.chips }}
+{% if game.current_round -%}
+- **Hands Remaining**: {{ game.current_round.hands_left | default(0) }}
+- **Discards Remaining**: {{ game.current_round.discards_left | default(0) }}
+{% endif -%}
+{% if game.skips > 0 -%}
+- **Skips Available**: {{ game.skips }}
+{% endif %}
+
+{% if game.blind_on_deck %}
+## Current Challenge
+- **Blind**: {{ game.blind_on_deck }}
+{# Blind target values may not be provided in game_state #}
+{% endif %}
+
+## Game Constraints
+- **Hands Played This Run**: {{ game.hands_played }}
+{% if jokers and jokers.config and jokers.config.card_limit -%}
+- **Joker Slots**: {{ jokers.cards | length }}/{{ jokers.config.card_limit }}
+{% endif -%}
+{% if game.discount_percent > 0 -%}
+- **Shop Discount**: {{ game.discount_percent }}%
+{% endif -%}
+{% if game.bankrupt_at > 0 -%}
+- **Bankruptcy Threshold**: ${{ game.bankrupt_at }}
+{% endif %}
+{% endif %}
+
+## Player Assets
+
+### Hand
+{% if hand and hand.cards -%}
+{%- set value_map = {
+  "Ace": "A", "King": "K", "Queen": "Q", "Jack": "J", "10": "T",
+  "9": "9", "8": "8", "7": "7", "6": "6", "5": "5", "4": "4", "3": "3", "2": "2"
+} -%}
+{%- set suit_map = {"Spades": "s", "Hearts": "h", "Diamonds": "d", "Clubs": "c"} -%}
+  Cards:
+{% for card in hand.cards -%}
+{%- set card_config = card.config.card -%}
+{%- set short_value = value_map.get(card_config.value, "?") -%}
+{%- set short_suit = suit_map.get(card_config.suit, "?") -%}
+    {{ loop.index0 }}: {{ short_value }}{{ short_suit }} ({{ card_config.value }} of {{ card_config.suit }})
+{% endfor %}
+  Available Indices: {{ range(hand.cards | length) | list }}
+{% else -%}
+  No cards in hand
+{% endif %}
+
+{% if jokers and jokers.cards %}
+### Jokers ({{ jokers.cards | length }})
+{% for joker in jokers.cards -%}
+  - **{{ joker.label | default('Joker ' ~ loop.index) }}** (key: {{ joker.config.center_key | default('unknown') }})
+    - Cost: {{ joker.cost | default('N/A') }} | Debuff: {{ joker.debuff | default(false) }}
+{% endfor %}
+{% else %}
+### Jokers
+  No jokers
+{% endif %}
+{% if reasoning_history %}
+
+## Previous Plays
+
+{% for reasoning in reasoning_history[-3:] -%}
+{{ loop.index }}. {{ reasoning }}
+{% endfor %}
+{% elif responses %}
+
+## Previous Plays
+
+{% for response in responses[-3:] -%}
+{%- if response.choices and response.choices[0].message.tool_calls -%}
+{%- set tool_call = response.choices[0].message.tool_calls[0] -%}
+{%- set args_json = tool_call.function.arguments -%}
+{%- set args = args_json | from_json -%}
+{%- if args.reasoning -%}
+{{ loop.index }}. {{ args.reasoning }}
+{% endif -%}
+{%- endif -%}
+{% endfor %}
+{% endif %}
+
+## Decision Required
+
+{% if state_name == "BLIND_SELECT" -%}
+You need to decide whether to **select** or **skip** the current blind.
+
+### Available Actions:
+
+- **select**: Play against this blind to earn chips and money
+- **skip**: Skip this blind to get a tag reward but no chips
+
+### Strategy:
+
+- Consider your current hand strength and jokers
+- Evaluate if you can beat the blind's chip requirement
+- Skipping gives you a tag but no progress toward winning
+{% elif state_name == "SELECTING_HAND" -%}
+You need to decide whether to **play cards** to form a poker hand or **discard cards** to try for better combinations.
+
+### Available Actions:
+
+- **play_hand**: Play selected cards as a poker hand to score chips
+- **discard**: Discard selected cards to draw new ones (uses a discard)
+
+### Strategy:
+
+- Look for the strongest poker hand you can make
+- Consider remaining hands and discards
+- Balance between playing weak hands vs. using discards to improve
+- Remember: higher poker hands score more points
+
+### Card Selection:
+
+- Use 0-based indices from the "Available indices" list above
+- You can select 1-5 cards for either action
+- Example: [0, 2, 4] selects the 1st, 3rd, and 5th cards
+{% elif state_name == "SHOP" -%}
+You are in the shop and need to decide what to do.
+
+### Available Actions:
+
+- **next_round**: End shopping and proceed to next blind
+- **reroll**: Spend money to refresh shop items
+- **buy_card (index)**: Purchase a card from the shop_jokers area by 0-based index
+- **redeem_voucher (index)**: Redeem a voucher from the shop_vouchers area by 0-based index
+
+### Strategy:
+
+- Consider your current money and what you need
+- Jokers can provide powerful ongoing effects
+- Vouchers give permanent upgrades
+- Don't overspend - you need money for future rounds
+
+### Shop Items
+
+{% if shop_jokers and shop_jokers.cards and (shop_jokers.cards | length) > 0 -%}
+Jokers / Cards:
+{% for card in shop_jokers.cards -%}
+  - {{ loop.index0 }}: {{ card.label }} ({{ card.ability.set }}) — ${{ card.cost }}
+{% endfor %}
+{% endif -%}
+
+{% if shop_vouchers and shop_vouchers.cards and (shop_vouchers.cards | length) > 0 -%}
+Vouchers:
+{% for card in shop_vouchers.cards -%}
+  - {{ loop.index0 }}: {{ card.label }} — ${{ card.cost }}
+{% endfor %}
+{% endif -%}
+{% endif %}