{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/codai-ro/json-schema/codai-ro-session-dispatch-inbox-schema.json",
  "title": "SessionDispatchInbox",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/codai-ro-devices-api-openapi.yml#/components/schemas/SessionDispatchInbox",
  "type": "object",
  "required": [
    "device_id",
    "sessions"
  ],
  "properties": {
    "device_id": {
      "type": "string",
      "format": "uuid",
      "description": "The calling device."
    },
    "sessions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "session_key",
          "title",
          "controls"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "session_key": {
            "type": "string"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "controls": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/SessionControl"
            }
          }
        }
      }
    }
  },
  "$defs": {
    "SessionControl": {
      "type": "object",
      "title": "SessionControl",
      "required": [
        "id",
        "kind",
        "text",
        "turn_id",
        "ask_id",
        "from_device_id",
        "target_device_id",
        "seq",
        "applied",
        "created_at"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "kind": {
          "$ref": "#/$defs/SessionControlKind"
        },
        "text": {
          "type": [
            "string",
            "null"
          ]
        },
        "turn_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "ask_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "from_device_id": {
          "type": "string",
          "format": "uuid"
        },
        "target_device_id": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid",
          "description": "Set only for Dispatch-originated controls."
        },
        "mode": {
          "type": "string",
          "enum": [
            "open"
          ],
          "description": "Present (`open`) only on a `mode:\"open\"` Dispatch handoff — open the session, run nothing. Absent on every other control."
        },
        "seq": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Seq of the echoed `control` event."
        },
        "applied": {
          "type": "boolean"
        },
        "created_at": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "SessionControlKind": {
      "type": "string",
      "enum": [
        "send",
        "answer",
        "approve",
        "deny",
        "cancel",
        "steer",
        "inject",
        "pause",
        "resume",
        "hydrate"
      ],
      "description": "Kind of control a non-executor can send to the executor. `hydrate` asks the executor to upload the transcript of a stub session (session owner only, like `send`)."
    }
  }
}