Envelope & Payload

interface A2GEnvelope<T = unknown> {
  type: string;              // Message type (e.g., "game_action_request")
  messageId: string;         // UUID v4 — unique per session, used for replay protection
  sequence?: number;         // Monotonically increasing per session (uint64)
  protocolVersion: string;   // "1.0"
  timestamp: number;         // Unix epoch milliseconds (sender's clock)
  gameType?: string;         // Present on game messages (e.g., "texas-holdem")
  tableId?: string;          // Present on game messages (e.g., "table-42")
  payload?: T;               // Game-specific data — core protocol doesn't inspect this
}

// Poker: agent raises to 50
{
  "type": "submit_action",
  "messageId": "msg-123",
  "gameType": "texas-holdem",
  "tableId": "table-1",
  "payload": { "action": "raise", "amount": 50 }
}

// Roulette: agent bets on red
{
  "type": "submit_action",
  "messageId": "msg-456",
  "gameType": "european-roulette",
  "tableId": "table-7",
  "payload": { "action": "place_bet", "betType": "red", "amount": 25 }
}