download_status
Poll the progress of a download and receive timing advice to prevent premature cancellation of queued transfers.
Instructions
Poll progress of an active or recent download.
CRITICAL TIMING RULES:
Do NOT call this within 30 seconds of starting a download.
status='queued' at 0% is NORMAL for the first 1-2 minutes. P2P takes time.
Do NOT cancel a download just because it shows queued/0%. Check age_seconds.
Only consider cancelling if age_seconds > 180 (3 minutes) with no progress.
The 'message' field contains contextual guidance — READ IT and follow its sleep recommendation before polling again. Do NOT live-poll in a tight loop.
If status='not_found' or status='session_expired', the download ID is stale (server restarted). You must re-search and re-download.
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": {
"id": "<id>"
},
"name": "download_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |