Recover a persisted checkpoint into a NEW task/session (starts a model request)
dsh_recover_taskStarts a new recovered task and session from a dsh_prepare_recovery plan, using checked goals, a bounded summary and fresh instructions, and returns an idempotent taskId.
Instructions
Starts a NEW task, private SDK runtime and session from a plan produced by dsh_prepare_recovery, using the checked original goal/constraints, a bounded checkpoint summary and the current instructions. The old task tree is never written and its stages are never appended. The recorded PID and recorded verification argv are never reused or executed: fresh caller-supplied verification settings are required when the source configured verification, and original protected pins must still match. A durable atomic claim returns the same new taskId with alreadyRecovered=true on retries, including after a bridge restart. A source recorded accepted/starting/running requires explicit allowUnsettledSource=true; that is a caller acknowledgment, not bridge proof of old-process liveness.
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": {
"taskId": "<taskId>",
"workspace": "<workspace>",
"planToken": "<planToken>",
"instructions": "<instructions>"
},
"name": "dsh_recover_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | ||
| budgetMs | No | ||
| maxTokens | No | ||
| planToken | Yes | planToken returned by dsh_prepare_recovery for this exact source and workspace. | |
| workspace | Yes | ||
| acceptance | No | ||
| autoRepair | No | ||
| autoContinue | No | Bounded same-live-session continuation ONLY after a real provider max_tokens/length turn end. Omission is disabled; deliveryPreset complete enables maxAttempts=2, noProgressLimit=2, totalBudgetMs=3600000. Explicit fields win. Storage/preview truncation, cancel, permission/credential failures, a dead runtime, shutdown and verifier-integrity failures never trigger it. | |
| instructions | Yes | What this recovered NEW stage must do now. The old conversation is not restored. | |
| deliveryPreset | No | ||
| deliverySource | No | Fresh explicit source scope for the recovered task. The source task's historic paths and patch baseline are never replayed. | |
| reasoningEffort | No | ||
| executionProfile | No | Fresh execution profile. Omitted inherits the source profile when it had one, preserving the same execution semantics. | |
| verificationCommand | No | Fresh argv the bridge runs itself after the recovered stage. Required when the source configured verification; the recorded argv is never executed. | |
| allowUnsettledSource | No | Explicit acknowledgment that the source was recorded accepted/starting/running and the old stop status is unknown. It is not proof that the old process is dead; recovery still starts a NEW session. | |
| verificationTimeoutMs | No | ||
| protectedVerificationFiles | No | Fresh pins for current verifier files. When the source pinned files, the same real paths and original hashes must be supplied; additional pins are allowed. |