wait_for_new_message

Block until a new incoming private message from a non-bot user arrives, then return immediately with the list of chats that currently have pending (unprocessed) incoming messages. If nothing arrives within `timeout` seconds, returns {"event": false, "reason": "timeout"}. Lets the agent react to events instead of polling. Does NOT consume the pending set — use wait_for_settled_message to consume a debounced burst. Args: timeout: Max seconds to block (default 50).

Parameters