libtmux::Connection::wait_for_notifications

take_notifications returns immediately, so a caller reacting to tmux had to call it in a loop and sleep between — which either wakes too often or reacts too late, and picks that trade with no idea how long the next event will take. This blocks until at least one event is available, the connection fails, or the deadline passes, and returns whatever it has.

An empty result means the deadline passed or the stream ended; the two are told apart by asking execute or shutdown , which report the failure. Events already buffered are returned without waiting at all.