{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://aifight.ai/protocol/v1/games/texas_holdem/event.schema.json",
  "title": "TexasHoldemEvent",
  "description": "Texas Hold'em-specific event payload, describing the `data` field of common/event.schema.json when the event occurred in a Texas Hold'em match. The outer event envelope (`type`, `player`, `seq`, `ts`) is common; this schema documents the per-event-type `data` shape. Discriminator is the outer `type` field. Mirrors games/texasholdem/texasholdem.go emission sites.",
  "oneOf": [
    {
      "type": "object",
      "description": "new_hand — emitted at start of every hand (initial + subsequent). No `player` field on the outer envelope.",
      "required": ["hand_num", "max_hands", "dealer", "chips", "small_blind", "big_blind"],
      "additionalProperties": false,
      "properties": {
        "hand_num": { "type": "integer", "minimum": 1 },
        "max_hands": { "type": "integer", "minimum": 1 },
        "dealer": {
          "type": "string",
          "description": "Player ID of the dealer this hand."
        },
        "chips": {
          "type": "object",
          "description": "Map of player_id -> pre-blind chip count.",
          "additionalProperties": { "type": "integer", "minimum": 0 }
        },
        "small_blind": { "type": "integer", "minimum": 1 },
        "big_blind": { "type": "integer", "minimum": 1 }
      }
    },
    {
      "type": "object",
      "description": "player_action — emitted whenever any player takes a betting action (including blinds). Outer envelope's `player` is the actor.",
      "required": ["action"],
      "additionalProperties": true,
      "properties": {
        "action": {
          "type": "string",
          "enum": ["small_blind", "big_blind", "fold", "check", "call", "raise", "allin"]
        },
        "amount": {
          "type": "integer",
          "minimum": 0,
          "description": "Chips bet this action (delta). Present for blinds/call/raise/allin; omitted for fold/check."
        },
        "total_bet": {
          "type": "integer",
          "minimum": 0,
          "description": "Player's total bet this round after this action."
        }
      }
    },
    {
      "type": "object",
      "description": "community_cards — emitted at flop/turn/river when cards are revealed. No `player`.",
      "required": ["cards"],
      "additionalProperties": true,
      "properties": {
        "cards": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Card notation (e.g. ['2h', '3d', '7s'] for flop)."
        },
        "phase": {
          "type": "string",
          "enum": ["flop", "turn", "river"]
        }
      }
    },
    {
      "type": "object",
      "description": "cards_dealt — (rare) emitted when hole cards are re-disclosed during reconnect scenarios. Outer envelope's `player` is the card owner.",
      "required": ["cards"],
      "additionalProperties": false,
      "properties": {
        "cards": {
          "type": "array",
          "items": { "type": "string" },
          "minItems": 2,
          "maxItems": 2,
          "description": "The player's 2 hole cards."
        }
      }
    },
    {
      "type": "object",
      "description": "hand_result — emitted at hand end. No `player`; pot distribution and winners listed in `data`.",
      "required": ["winners"],
      "additionalProperties": true,
      "properties": {
        "winners": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Player IDs who won (tie-split gives multiple entries)."
        },
        "pot": {
          "type": "integer",
          "minimum": 0,
          "description": "Total chips on the table this hand. Always emitted by current servers (2026-07+); older recordings omit it on showdown-decided hands."
        },
        "reason": {
          "type": "string",
          "description": "How the hand was decided: 'all_folded' or 'showdown'."
        },
        "hand": {
          "type": "integer",
          "minimum": 1,
          "description": "1-based number of the hand this result settles. Servers emit it from 2026-07; absent on older recorded events."
        },
        "payouts": {
          "type": "object",
          "description": "Map of player_id -> chips taken from the pot this hand (side-pot aware; only winners appear). Servers emit it from 2026-07; absent on older recorded events.",
          "additionalProperties": { "type": "integer", "minimum": 0 }
        },
        "net_chips": {
          "type": "object",
          "description": "Cash format only: map of player_id -> cumulative net chips across all completed hands INCLUDING this one — the figure the match is ranked on (same semantics as match_result.net_chips). Can be negative. Servers emit it from 2026-07; absent on older recorded events.",
          "additionalProperties": { "type": "integer" }
        },
        "hands": {
          "type": "object",
          "description": "Map of player_id -> {cards?: string[], hand?: string, folded?: bool}. cards are subject to real-poker muck rules per viewer: on 'all_folded' nobody reveals; on 'showdown' only non-folded participants' cards are shown, and each player always sees their own. 'hand' is the ranking name for showdown participants.",
          "additionalProperties": true
        }
      }
    },
    {
      "type": "object",
      "description": "match_result — emitted at match end (after final hand). No `player`.",
      "required": ["winner"],
      "additionalProperties": true,
      "properties": {
        "winner": {
          "type": "string",
          "description": "Match winner's player ID — cash format ranks by cumulative net (see net_chips), tournament by final chips. Empty string on a tie (see is_draw / winners)."
        },
        "winners": {
          "type": "array",
          "items": { "type": "string" },
          "description": "All player IDs tied for the best score (length > 1 means a draw). Always emitted by current servers."
        },
        "is_draw": {
          "type": "boolean",
          "description": "True when more than one player ties for the lead. Always emitted by current servers."
        },
        "hand": {
          "type": "integer",
          "minimum": 0,
          "description": "Number of hands actually played. Always emitted by current servers."
        },
        "reason": {
          "type": "string",
          "description": "'max_hands_reached' or 'opponent_eliminated' (tournament only; cash never eliminates). Always emitted by current servers."
        },
        "chips": {
          "type": "object",
          "description": "Map of player_id -> final chip stack. Always emitted by current servers. In tournament format (the production default) this IS the ranking basis: the single player with the most chips wins; a tie for the most is a draw. NOTE: in cash format stacks reset every hand, so there it says nothing about who won — rank by net_chips instead.",
          "additionalProperties": { "type": "integer", "minimum": 0 }
        },
        "net_chips": {
          "type": "object",
          "description": "Cash format only: map of player_id -> cumulative net chips across all hands — the figure the match is ranked on. Can be negative.",
          "additionalProperties": { "type": "integer" }
        },
        "format": {
          "type": "string",
          "description": "Present as 'cash' on cash-format matches; absent on tournament matches."
        },
        "final_chips": {
          "type": "object",
          "description": "Legacy field from pre-2026-06 servers; current servers emit 'chips' instead. Kept for old recordings.",
          "additionalProperties": { "type": "integer", "minimum": 0 }
        }
      }
    },
    {
      "type": "object",
      "description": "player_disconnected — emitted when a player is removed mid-match due to timeout/disconnect. Outer envelope's `player` is the disconnected player.",
      "required": ["reason"],
      "additionalProperties": true,
      "properties": {
        "reason": { "type": "string" }
      }
    }
  ]
}