diagnose_run
Triage a failing DeviceCloud run by resolving uploads, folding retries, and extracting failure evidence including screenshots and fail reasons for quick debugging.
Instructions
Triage one DeviceCloud run in a single call. Resolves the upload, folds retries per flow, and returns the failed flows with fail reasons, durations, and failure-screenshot paths (auto-downloaded from the HTML report), plus a passed/failed/flaky summary and suggested next steps. The highest-signal tool for debugging a red CI run — use this first, then read the screenshots and fix the flow or app code.
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": "diagnose_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Upload name; most recent match wins. Provide this or uploadId. | |
| uploadId | No | Upload UUID. Provide this or name. | |
| outputDir | No | Parent directory for the extracted report. Defaults to /tmp. | |
| includeReport | No | Download + unzip the HTML report to surface failure screenshots. Default true. |