Turn

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/ctlsurf-com/json-schema/ctlsurf-com-turn-schema.json",
  "title": "Turn",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/ctlsurf-com-page-agent-api-openapi.yml#/components/schemas/Turn",
  "properties": {
    "message": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 1,
      "title": "Message"
    },
    "history": {
      "items": {
        "$ref": "#/$defs/Message"
      },
      "type": "array",
      "maxItems": 12,
      "title": "History"
    },
    "selected_block_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ],
      "title": "Selected Block Id"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "message"
  ],
  "$defs": {
    "Message": {
      "properties": {
        "role": {
          "type": "string",
          "enum": [
            "user",
            "assistant"
          ],
          "title": "Role"
        },
        "content": {
          "type": "string",
          "maxLength": 6000,
          "minLength": 1,
          "title": "Content"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "role",
        "content"
      ],
      "title": "Message"
    }
  }
}