{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://velox.dev/schema/methods/download.list.schema.json",
  "title": "download.list",
  "description": "The main table. Filtering, sorting and paging all happen in the daemon so the GUI never materializes 100k rows to show 40. Called once on connect; after that the table is maintained from events, never re-fetched on a progress tick.",
  "x-privileged": false,
  "x-transports": ["uds", "ws"],
  "x-deadlineMs": 5000,
  "type": "object",
  "properties": {
    "params": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "filter": { "oneOf": [{ "$ref": "https://velox.dev/schema/types/TaskFilter.schema.json" }, { "type": "null" }] },
        "sort":   { "oneOf": [{ "$ref": "https://velox.dev/schema/types/TaskSort.schema.json" }, { "type": "null" }] },
        "offset": { "type": ["integer", "null"], "minimum": 0 },
        "limit":  { "type": ["integer", "null"], "minimum": 1, "maximum": 5000, "description": "Defaults to 500. The GUI pages; the extension popup asks for far fewer." }
      }
    },
    "result": {
      "type": "object",
      "additionalProperties": false,
      "required": ["total", "items"],
      "properties": {
        "total": { "type": "integer", "minimum": 0, "description": "Rows matching the filter, ignoring offset and limit." },
        "items": { "type": "array", "items": { "$ref": "https://velox.dev/schema/types/TaskSummary.schema.json" } }
      }
    }
  }
}