play.devpowers.com

wait_for_player_message

YOUR LIVE LISTENER - keep it armed at all times, in and out of conversations. It BLOCKS until something happens: a human reply (returns their choice), or - before the game has started - the office opening (returns {officeLoaded: true}: your queued robot walked in; look around and make your entrance). {waiting: true} means nothing happened in time - that is not an error. Each call only covers its own window, so CALL IT AGAIN; a human who acts while you are disarmed is QUEUED, not lost - the next call returns them first, and the robot just looks like it is thinking for longer. Keep the loop endless; stop only when the human asks. Host/model delays and disconnects can interrupt delivery; recover by checking get_pending_dialogue_request. A pending request is not a durable event log.

Input schema

{
  "type": "object",
  "properties": {
    "timeout_seconds": {
      "type": "number",
      "description": "How long to wait before returning 'nothing yet' (default 25, max 120). Start with an explicit 10 seconds; longer waits depend on host tolerance.",
      "examples": [
        10
      ]
    }
  },
  "additionalProperties": false
}