{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://velox.dev/schema/methods/session.subscribe.schema.json",
  "title": "session.subscribe",
  "description": "Choose which notifications this connection receives. Subscribing replaces the previous selection rather than adding to it, so a client can narrow its firehose without reconnecting. Nothing is delivered until this is called.",
  "x-privileged": false,
  "x-transports": ["uds", "ws"],
  "x-deadlineMs": 2000,
  "type": "object",
  "properties": {
    "params": {
      "type": "object",
      "additionalProperties": false,
      "required": ["events"],
      "properties": {
        "events": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": ["event.task.added", "event.task.removed", "event.task.state",
                     "event.task.progress", "event.speed.global", "event.auth.required",
                     "event.notify", "event.settings.changed", "event.grabber.progress"]
          }
        },
        "taskIds": { "type": ["array", "null"], "items": { "type": "string", "format": "uuid" }, "description": "Narrow task events to these ids. The extension popup uses it to avoid receiving progress for downloads it is not showing. null means all tasks." }
      }
    },
    "result": {
      "type": "object",
      "additionalProperties": false,
      "required": ["ok", "events"],
      "properties": {
        "ok":     { "type": "boolean" },
        "events": { "type": "array", "items": { "type": "string" }, "description": "Echoed back so a client can detect that it asked for an event this daemon does not emit." }
      }
    }
  }
}