{
  "name": "download.provideAuth \u2014 answer a 401 challenge and remember it",
  "description": "The task was sitting in retry_wait after event.auth.required. This does not restart the transfer itself: the daemon retries with the credential attached and the task's state.transition to connecting/downloading happens on its own, reported the normal way through event.task.state.",
  "transport": "uds",
  "request": {
    "jsonrpc": "2.0",
    "id": 80,
    "method": "download.provideAuth",
    "params": {
      "taskId": "$taskId",
      "username": "svc-releases",
      "password": "hunter2-not-a-real-password",
      "save": true
    }
  },
  "response": {
    "jsonrpc": "2.0",
    "id": 80,
    "result": {
      "ok": true
    }
  },
  "assertions": [
    "the password never appears in a log line, ever, on either side of this call",
    "save true stores the credential in the Secret Service keyed by host and realm, not in SQLite",
    "the task itself is not touched synchronously by this call \u2014 it moves out of retry_wait when the daemon's own retry succeeds, reported via event.task.state",
    "this method is refused with -32003 over the WebSocket transport"
  ]
}