Get conversation or run result
dsh_getCollect the final result of a dispatched agent turn by conversation and run ID, including answer, tools, usage, errors and review ticket. Without a run ID, returns the most recent turn.
Instructions
Details of one conversation; with run_id, the final result of that dispatch (the place to collect asynchronous work). Without run_id it uses the most recent turn. Returns: title, workspace, permission tier, state, turn count, token usage, context pressure, pending approvals, and the turn's full result (answer, tools, usage, error) with its review ticket. The service keeps the latest 20 runs in memory. After a restart or eviction the result is read back from the sentinel file, which is on disk and survives restarts.
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_get"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run_id | No | The run_id returned by dsh_send. With only the conversation ID, look up the current or most recently started turn, including retained results after reconnecting. | |
| max_chars | No | Result budget (default 0 = no truncation, full result). Above 0 it applies to **both** text and structured output: the answer is cut to that length (with answer_truncated / next_offset), and structured.run.result.tools_used keeps only tool name, status and input_chars instead of full inputs. The complete result is always in sentinel_file. When a turn used many tools the default can exceed a client's per-result limit; about 8000 is a good value. | |
| client_run_id | No | Look the run up by its idempotency key instead of run_id. Works across restarts during sentinel retention. | |
| conversation_id | Yes | Conversation id, from dsh_start or dsh_list. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run | Yes | ||
| sentinel_file | No | ||
| conversation_id | Yes |