feat: finish buy_and_use_card docs

Author: stirby

docs/protocol-api.md

@@ -109,20 +109,20 @@ The BalatroBot API provides core functions that correspond to the main game acti
 
 ### Overview
 
-| Name                    | Description                                                                                                          |
-| ----------------------- | -------------------------------------------------------------------------------------------------------------------- |
-| `get_game_state`        | Retrieves the current complete game state                                                                            |
-| `go_to_menu`            | Returns to the main menu from any game state                                                                         |
-| `start_run`             | Starts a new game run with specified configuration                                                                   |
-| `skip_or_select_blind`  | Handles blind selection - either select the current blind to play or skip it                                         |
-| `play_hand_or_discard`  | Plays selected cards or discards them                                                                                |
-| `rearrange_hand`        | Reorders the current hand according to the supplied index list                                                       |
-| `rearrange_consumables` | Reorders the consumables according to the supplied index list                                                        |
-| `cash_out`              | Proceeds from round completion to the shop phase                                                                     |
-| `shop`                  | Performs shop actions: proceed to next round (`next_round`), purchase a card (`buy_card`), or reroll shop (`reroll`) |
-| `sell_joker`            | Sells a joker from the player's collection for money                                                                 |
-| `sell_consumable`       | Sells a consumable from the player's collection for money                                                            |
-| `use_consumable`        | Uses a consumable card from the player's collection (Tarot, Planet, or Spectral cards)                               |
+| Name                    | Description                                                                                        |
+| ----------------------- | -------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
+| `get_game_state`        | Retrieves the current complete game state                                                          |
+| `go_to_menu`            | Returns to the main menu from any game state                                                       |
+| `start_run`             | Starts a new game run with specified configuration                                                 |
+| `skip_or_select_blind`  | Handles blind selection - either select the current blind to play or skip it                       |
+| `play_hand_or_discard`  | Plays selected cards or discards them                                                              |
+| `rearrange_hand`        | Reorders the current hand according to the supplied index list                                     |
+| `rearrange_consumables` | Reorders the consumables according to the supplied index list                                      |
+| `cash_out`              | Proceeds from round completion to the shop phase                                                   |
+| `shop`                  | Performs shop actions: proceed to next round (`next_round`), purchase (and use) a card (`buy_card` | `buy_and_use_card`), or reroll shop (`reroll`) |
+| `sell_joker`            | Sells a joker from the player's collection for money                                               |
+| `sell_consumable`       | Sells a consumable from the player's collection for money                                          |
+| `use_consumable`        | Uses a consumable card from the player's collection (Tarot, Planet, or Spectral cards)             |
 
 ### Parameters
 
@@ -135,7 +135,7 @@ The following table details the parameters required for each function. Note that
 | `play_hand_or_discard`  | `action` (string): Either "play_hand" or "discard"<br>`cards` (array): Card indices (0-indexed, 1-5 cards)                                                                                                                                                                |
 | `rearrange_hand`        | `cards` (array): Card indices (0-indexed, exactly `hand_size` elements)                                                                                                                                                                                                   |
 | `rearrange_consumables` | `consumables` (array): Consumable indices (0-indexed, exactly number of consumables in consumable area)                                                                                                                                                                   |
-| `shop`                  | `action` (string): Shop action ("next_round", "buy_card", "reroll", or **"redeem_voucher"**)<br>`index` (number, required when `action` = "buy_card" or `action` = **"redeem_voucher"**): 0-based card index to purchase / redeem                                         |
+| `shop`                  | `action` (string): Shop action ("next_round", "buy_card", "buy_and_use_card", "reroll", or "redeem_voucher")<br>`index` (number, required when `action` is one of "buy_card", "redeem_voucher", "buy_and_use_card"): 0-based card index to purchase / redeem              |
 | `sell_joker`            | `index` (number): 0-based index of the joker to sell from the player's joker collection                                                                                                                                                                                   |
 | `sell_consumable`       | `index` (number): 0-based index of the consumable to sell from the player's consumable collection                                                                                                                                                                         |
 | `use_consumable`        | `index` (number): 0-based index of the consumable to use from the player's consumable collection                                                                                                                                                                          |