Dispatch task
dsh_sendDispatch a task to a conversation. Give a goal, not commands: DSH decides which file, shell, search, skill, subagent and team tools to use, and this server does not preload or proxy DSH's tool surface.
Instructions
Dispatch a task to a conversation. Give a goal, not commands: DSH decides which file, shell, search, skill, subagent and team tools to use, and this server does not preload or proxy DSH's tool surface. Non-blocking by default (wait=false): it returns run_id + sentinel_file at once, the turn runs in the background and you are notified when it ends, so you can do other work and the task is never cut off by a timeout. Pass wait=true to block for the result (optionally with timeout_ms; on expiry it only moves to the background and does not cancel the turn). [A timeout never destroys the task] when wait=true reaches timeout_ms before the turn ends, this tool does not error and does not cancel: it downgrades to background, returns run_id + sentinel_file, and the turn runs to the end with the result delivered through the sentinel file (timeout_ms=0 means wait forever). In both modes a small file holding the final result is written atomically when the turn ends. Wait for it with a background task (Bash run_in_background + until [ -f sentinel_file ]; on Windows/PowerShell a Test-Path loop, and the receipt contains ready-made commands) and you are woken when it lands; no polling needed. Once the file exists, read it for the result, or collect with dsh_get(conversation_id, run_id); dsh_read shows output while the turn is running. Reasoning is hidden by default (answer plus reasoning statistics only). Results and background receipts carry a review ticket (advisory by default): verify, then submit a verdict with dsh_review. If the conversation is busy this tool errors: use dsh_send(queue=true) to enqueue (returns at once), dsh_interject to stop and redirect, or dsh_interrupt to just stop.
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>",
"prompt": "<prompt>"
},
"name": "dsh_send"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| team | No | Controls the experimental team hint for this dispatch. Pass false to suppress it for this call. From DSH 0.2.2-rc.2, DSH manages team tools and guidance per session. | |
| wait | No | **Default false**: return run_id + sentinel_file at once; the turn runs in the background and the sentinel file signals completion (recommended). true = block until the turn ends and return the full result. | |
| queue | No | Whether to enqueue when the conversation is busy (default false = error). With true it returns run_id + queue_position at once and runs after the current turn; the sentinel is written only when the run really ends, not when it is queued. Queued prompts stay in memory. After restart, unstarted receipts resolve as cancelled. Manage the queue with dsh_queue. (dsh_interject(mode='queue') also runs after the current turn, but it blocks until the new turn ends and does not use this queue.) | |
| prompt | Yes | The task. It may refer to file paths in the workspace. | |
| review | No | Review policy for this dispatch, overriding the conversation default (advisory). advisory: the result and sentinel carry a review ticket asking the caller to verify independently and submit a verdict with dsh_review; off: none this time. | |
| reasoning | No | How much reasoning to return. Default hide (answer only, reasoning as statistics). full uses a lot of context. | |
| timeout_ms | No | Upper bound on the **wait**, in milliseconds, only with wait=true. **Default 0 = wait forever** (no invented 30-minute limit). On expiry the turn is not cancelled; it moves to the background and you get a run_id. | |
| client_run_id | No | Caller-generated idempotency key (up to 128 characters, scoped to this conversation and retained with the sentinel). Submitting the same key again does not create a second run: it returns the first run's result or receipt (replayed=true). For safely resending after a response was lost in transport. | |
| conversation_id | Yes | Conversation id, from dsh_start or dsh_list. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| queued | No | ||
| run_id | Yes | ||
| status | No | ||
| replayed | No | ||
| background | No | ||
| sentinel_file | Yes | ||
| conversation_id | Yes |