wait_for_next_image
Blocks until a new photo is posted to a Telegram group, returning only the first unseen image. Waits without token usage; retry if timeout.
Instructions
Blocks until a new image is posted to the group, then returns it.
Use this when the user is about to send a screenshot. It notes the group's newest message when the call starts and returns the first photo after that, so it never hands back something you have already seen in this call.
Args: timeout_seconds: how long to wait, clamped to 1-240 seconds.
Waiting costs no tokens -- the process idles on a socket. If nothing arrives it returns a sentence saying so; call it again to keep waiting.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "wait_for_next_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| timeout_seconds | No |