Tail overseer task output
overseer_tailStream a task's live output with a status line, using since to fetch only new lines and wait_for to block until a regex matches or the task exits.
Instructions
Return a task's live output, preceded by a status line. task is a numeric id or a case-insensitive name substring; omit it for the most recent task. The status line reports status, exit_code once the task has exited, and total (lines available so far), so you never need a separate overseer_list_tasks to find out whether what you are tailing is still alive. Pass the previous total back as since to get only what is new instead of re-reading the same lines; from tells you where the returned block actually starts, and a from greater than since + 1 means output scrolled past between calls. Set wait_for to a regular expression to block until a matching line appears; use it instead of polling repeatedly. It returns as soon as it matches, or when the task exits, or at timeout_ms (default 15000, max 120000), and reports which of the three happened as waited, so a timeout is never mistaken for success. wait_for is for a wait of a few seconds. This call cannot be backgrounded, so a longer one holds up the conversation for the task's whole duration; wait for those with the wait subcommand in your shell instead, as the server instructions describe.
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": "overseer_tail"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | No | ||
| lines | No | Trailing lines to return; default 10. Pass more when diagnosing a failure, e.g. 100 for a stack trace with its footer | |
| since | No | ||
| wait_for | No | ||
| timeout_ms | No |