Read live output
dsh_readRead a running conversation's output incrementally with a cursor, so you can monitor progress and partial results before the turn ends. Call repeatedly with the last cursor to track multiple conversations.
Instructions
Read a conversation's run-time output (cursor-based and incremental): see what a running conversation has produced so far without waiting for the turn to end. Typical use: dsh_list(only_running) to find active conversations, then call dsh_read repeatedly, passing back the last cursor, to watch several in turn. The output buffer is memory-only and bounded (a ring; the oldest entries are dropped) and disappears when the server or process exits. Reasoning is not buffered: live reasoning of the turn currently running is attached only with include_reasoning=true. The cursor is a revision number: an entry whose text grew is returned again; match it by seq and replace its text (do not append twice).
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": {
"conversation_id": "<conversation_id>"
},
"name": "dsh_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum entries per call. Default 200. | |
| cursor | No | The cursor returned last time; omit or pass 0 on the first call. | |
| conversation_id | Yes | Conversation id, from dsh_start or dsh_list. | |
| include_reasoning | No | Attach the live reasoning of the current turn. Default false. |