{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/codai-ro/json-schema/codai-ro-session-control-schema.json",
  "title": "SessionControl",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/codai-ro-sessions-api-openapi.yml#/components/schemas/SessionControl",
  "type": "object",
  "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"
    }
  },
  "$defs": {
    "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`)."
    }
  }
}