Run a DSH task to completion
dsh_runQueues a task to the DSH agent and waits for the turn to settle, ideal for short jobs. Blocks until done; for long tasks use the start and wait tools so calls don't time out.
Instructions
Queue a task and wait for the turn to settle. Convenient for short tasks; long tasks should use dsh_start + dsh_wait so the MCP call does not block. Timeout leaves the turn running and returns timedOut:true.
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": {
"task": "<task>"
},
"name": "dsh_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory for the DSH agent. Defaults to the selected connection cwd, then the MCP server cwd. | |
| task | Yes | The task text for the DSH agent. | |
| model | No | Model id; defaults to the selected connection, then DSH settings. | |
| title | No | Short human-readable task title shown in the agent overview. | |
| provider | No | DSH provider route; defaults to the selected connection, then DSH settings. | |
| sessionId | No | DSH session id, e.g. session-… returned by a previous call. | |
| timeoutMs | No | Overall budget in milliseconds; default 15 minutes. | |
| connection | No | Named bridge connection from mcp-bridge.json. Omit to use the configured default. |