List conversations
dsh_listList conversations with live state—running, idle, or detached—so you can track several agents at once. Filter to active turns or include closed disk sessions to see what is running and what can resume.
Instructions
List conversations and their live state, for keeping track of several at once. state: running (a turn is in progress) / idle (process alive, nothing running) / detached (no process; resumable). A running conversation also reports elapsed time, the tool it is executing and how much it has output this turn. Two sources are merged: conversations this server holds, and ones on DSH's disk that are not open (DSH's session/list leaves out open sessions). Pass only_running=true for just the active ones; follow up with dsh_read to see what one is producing.
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": "dsh_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Only conversations in this workspace. | |
| only_running | No | Only return conversations with a turn in progress. Default false. **This mode skips the disk probe and answers in milliseconds** (a running conversation is always in memory). | |
| include_closed | No | Whether to include conversations on disk that are not open (including ones created by other instances or the GUI). Default true. **Cost: it spawns a DSH process to probe the disk, about 1 second measured** (cached for 10 seconds). Pass false to list only what this server has open, in milliseconds. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| running | Yes | ||
| probe_ok | No | ||
| probe_error | No | ||
| probe_cached | No | ||
| conversations | Yes | ||
| orphan_holders | No |