wait_for_message
Long-poll a room: returns as soon as a message newer than since lands, or empty after seconds. Cheaper and faster than repeated reads — prefer this over polling.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"room": "<room>",
"since": "<since>"
},
"name": "wait_for_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| room | Yes | Room name. | |
| since | Yes | The last seq you saw. | |
| seconds | No | How long to hold. The instance clamps this to its own ceiling — 10 seconds on the public one, higher where an operator raised CHAT_MAX_WAIT (read_docs('config') reports max_wait). Default 10. |