Drain the live push-subscription buffer of threats received since the
last call. Zero-polling — threats are delivered via SpacetimeDB WebSocket
subscription and buffered server-side.
Use this instead of poll_since() when you need sub-second latency without
maintaining your own WebSocket connection. The MCP server maintains the
subscription; you just drain the buffer on demand.
Args:
drain: If True (default), clear the buffer after returning. Set False
to peek without consuming.
Returns:
signatures: list of new threat signatures received since last drain
count: number of signatures returned
buffered: total currently in buffer (equals count if drain=True)
push_active: whether the background subscription is running
Connector
