Release conversation
dsh_releaseRelease the DSH process for a conversation to free its write lock so another DSH GUI can open it; optionally remove it from the registry or release all idle conversations to free memory.
Instructions
Release the DSH process a conversation occupies (this frees the write lock so the user can open the same conversation in their own DSH GUI). The conversation stays on disk and can be resumed later; forget=true writes a tombstone: it is removed from the registry and later lookups by id say it was forgotten (to bring it back, delete the tombstone file named in the error, by default $DSH_HOME/.dsh-any-agent-forgotten/<id>.json). To free memory in one go when you are done, pass all=true (each conversation is about 300-480 MB; the default MAX_LIVE=4 already reaps the least recently used one; all=true releases idle conversations and skips ones running a turn unless force=true). Releasing a single conversation stops its DSH process; if a turn is running, it is interrupted.
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_release"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | Ignore conversation_id and release every **idle** conversation process (to free memory). Conversations running a turn are skipped by default. Default false. | |
| force | No | Only with all=true: also stop conversations that are running a turn (those turns are interrupted). Default false. | |
| forget | No | Also remove it from this server's registry. Default false. | |
| conversation_id | No | Conversation id, from dsh_start or dsh_list. |