terminal_read
Read-onlyIdempotent
Read non-consuming output records from a terminal session starting at a cursor, with an optional bounded wait. Continue using next_cursor to retrieve new stdout and stderr data without losing records.
Instructions
Read non-consuming output records starting at cursor, with a bounded optional wait.
Cursor is an absolute record sequence, not a byte index. Continue with next_cursor. Old cursors return CURSOR_EXPIRED with base_cursor, never silent loss. stdout/stderr retain stream labels. output_complete only becomes true after tail output is drained.
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": {
"session_id": "<session_id>"
},
"name": "terminal_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | ||
| wait_ms | No | ||
| max_bytes | No | ||
| session_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||