Wait for work
wait_for_workWaits for the next godspeed request—lesson turn, Talk message, background job, or graph run—and returns a work item or "idle" status so agents can poll for tasks.
Instructions
Wait for the next request from godspeed (a lesson turn, a Talk message, a background job, or a knowledge-graph run). Returns a work item, or status "idle" if nothing arrived in time — then call again.
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_work"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| helper | No | Send true on every call when you are the helper: a second session beside the teacher, started when the user says "Start as the helper". A helper takes the background jobs (file reading, graph building, sheets), and lesson or Talk turns only while the teacher tidies its memory. | |
| lesson_id | No | Stay on this lesson: take its turns and Talk messages, plus other lessons' turns no one else waits for and background jobs (file reading, graph building, research) while no helper is open, so they never get stuck. | |
| full_context | No | Send the whole conversation and instructions again, even if you saw them before (use after losing your context). | |
| timeout_seconds | No | How long to wait in seconds (default 45, at most 600). Stay under your client's tool timeout: for Codex that is its tool_timeout_sec (60 unless raised; the godspeed folder's start command sets 620). |