playingcardssimulator.vercel.app

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Optional teaching line (skip if the machine already narrated the event)."
    },
    "target": {
      "type": "string",
      "description": "Which element to highlight. Use a zone id ('stock', 'hand', 'play', 'discard', 'capture', 'actions', 'pot') or a player id ('human', 'bot_1', …) to highlight that player's entire seat. For zone targets, pair with playerId to scope to a specific seat (e.g. target 'hand' + playerId 'human'). Omit or pass null to clear."
    },
    "playerId": {
      "type": "string",
      "description": "Optional player scope for zone targets — e.g. highlight bot_1's hand rather than the human's. Defaults to human for hand/capture."
    },
    "label": {
      "type": "string",
      "description": "Optional short label shown near the highlighted element (e.g. 'Click here', 'Your hand')."
    },
    "expectActionId": {
      "type": "string",
      "description": "Action id to wait for (e.g. 'stand'). Omit to accept any click."
    },
    "timeoutMs": {
      "type": "number",
      "description": "Optional max wait in milliseconds. On expiry resolves with { timedOut: true }."
    }
  }
}