# Схемы

JSON Schema всех типов, которые встречаются в публичных эндпоинтах (99). Снимок из [openapi.json](/docs/openapi.json): `$ref: #/components/schemas/Name` – раздел `Name` на этой странице. `required` задаёт обязательные поля; `null` и отсутствие поля различаются.

## ApiCall

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "keyId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "surface": {
      "type": "string",
      "enum": [
        "rest",
        "mcp"
      ]
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "target": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "latencyMs": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "client": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ]
    },
    "at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "id",
    "keyId",
    "surface",
    "name",
    "target",
    "status",
    "latencyMs",
    "client",
    "at"
  ],
  "additionalProperties": false
}
```

## ApiCallList

```json
{
  "type": "object",
  "properties": {
    "calls": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ApiCall"
      }
    }
  },
  "required": [
    "calls"
  ],
  "additionalProperties": false
}
```

## ApiKey

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "prefix": {
      "type": "string",
      "pattern": "^aos3\\.sk_[A-Za-z0-9_-]{6}$"
    },
    "scopes": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/KeyScope"
      }
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "lastUsedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "revokedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "$ref": "#/components/schemas/ApiKeyStatus"
    }
  },
  "required": [
    "id",
    "name",
    "prefix",
    "scopes",
    "createdAt",
    "expiresAt",
    "lastUsedAt",
    "revokedAt",
    "status"
  ],
  "additionalProperties": false
}
```

## ApiKeyCreated

```json
{
  "type": "object",
  "properties": {
    "key": {
      "$ref": "#/components/schemas/ApiKey"
    },
    "secret": {
      "type": "string",
      "pattern": "^aos3\\.sk_[A-Za-z0-9_-]{43}$"
    }
  },
  "required": [
    "key",
    "secret"
  ],
  "additionalProperties": false
}
```

## ApiKeyCreateRequest

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[^\\p{C}\\p{Zl}\\p{Zp}]+$"
    },
    "scopes": {
      "minItems": 1,
      "maxItems": 5,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/KeyScope"
      }
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}
```

## ApiKeyList

```json
{
  "type": "object",
  "properties": {
    "keys": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ApiKey"
      }
    }
  },
  "required": [
    "keys"
  ],
  "additionalProperties": false
}
```

## ApiKeyStatus

```json
{
  "type": "string",
  "enum": [
    "active",
    "expired",
    "revoked"
  ]
}
```

## Attachment

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "mime": {
      "type": "string",
      "enum": [
        "image/png",
        "image/jpeg",
        "image/webp",
        "application/pdf",
        "text/plain",
        "text/markdown"
      ]
    },
    "kind": {
      "type": "string",
      "enum": [
        "image",
        "pdf",
        "text"
      ]
    },
    "size": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 10485760
    }
  },
  "required": [
    "id",
    "name",
    "mime",
    "kind",
    "size"
  ],
  "additionalProperties": false
}
```

## CatalogId

```json
{
  "type": "string",
  "maxLength": 64,
  "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
}
```

## Citation

```json
{
  "type": "object",
  "properties": {
    "source": {
      "type": "integer",
      "minimum": 0,
      "maximum": 19
    },
    "start": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "end": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "source",
    "start",
    "end"
  ],
  "additionalProperties": false
}
```

## Efir

```json
{
  "type": "object",
  "properties": {
    "id": {
      "$ref": "#/components/schemas/LessonCode"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "day": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "upcoming": {
      "type": "boolean"
    },
    "startsAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "lessonId": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/LessonCode"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "id",
    "title",
    "day",
    "minutes",
    "upcoming",
    "startsAt",
    "lessonId"
  ],
  "additionalProperties": false
}
```

## EfirList

```json
{
  "type": "object",
  "properties": {
    "efirs": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Efir"
      }
    }
  },
  "required": [
    "efirs"
  ],
  "additionalProperties": false
}
```

## ErrorBody

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "object",
      "properties": {
        "code": {
          "$ref": "#/components/schemas/ErrorCode"
        },
        "message": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        },
        "retryAfterSec": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "issues": {
          "maxItems": 50,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            },
            "required": [
              "path",
              "message"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "code",
        "message"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "error"
  ],
  "additionalProperties": false
}
```

## ErrorCode

```json
{
  "type": "string",
  "enum": [
    "BAD_REQUEST",
    "VALIDATION_FAILED",
    "ONBOARDING_INCOMPLETE",
    "UNAUTHENTICATED",
    "LOGIN_INVALID",
    "LINK_INVALID",
    "REAUTH_REQUIRED",
    "CREDENTIAL_NOT_ALLOWED",
    "INSUFFICIENT_SCOPE",
    "ORIGIN_REJECTED",
    "LOGIN_STATE_INVALID",
    "NO_ENTITLEMENT",
    "MENTORING_NOT_AVAILABLE",
    "ONBOARDING_REQUIRED",
    "NOT_FOUND",
    "VERSION_CONFLICT",
    "BUSY",
    "METHOD_NOT_ALLOWED",
    "RATE_LIMITED",
    "DAILY_LIMIT",
    "GLOBAL_BUDGET",
    "KEY_LIMIT",
    "KEY_RATE",
    "STORAGE_LIMIT",
    "ENTITLEMENT_UNAVAILABLE",
    "DICTATION_UNAVAILABLE",
    "TUTOR_UNAVAILABLE",
    "INTERNAL"
  ]
}
```

## Health

```json
{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "const": "ok"
    },
    "sha": {
      "type": "string",
      "pattern": "^[0-9a-f]{7,40}$"
    }
  },
  "required": [
    "status",
    "sha"
  ],
  "additionalProperties": false
}
```

## KeyScope

```json
{
  "type": "string",
  "enum": [
    "course:read",
    "profile:read",
    "progress:write",
    "tutor:read",
    "mentoring:read"
  ]
}
```

## LessonCard

```json
{
  "type": "object",
  "properties": {
    "id": {
      "$ref": "#/components/schemas/LessonCode"
    },
    "week": {
      "type": "integer",
      "minimum": 0,
      "maximum": 52
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "tools": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 32
      }
    },
    "summary": {
      "type": "string"
    },
    "task": {
      "type": "string"
    },
    "kind": {
      "$ref": "#/components/schemas/LessonKind"
    },
    "sectionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "gated": {
      "type": "boolean"
    },
    "locked": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "week",
    "title",
    "minutes",
    "tools",
    "summary",
    "task",
    "kind",
    "sectionId",
    "gated",
    "locked"
  ],
  "additionalProperties": false
}
```

## LessonCode

```json
{
  "type": "string",
  "maxLength": 32,
  "pattern": "^[a-z0-9]+(\\.[a-z0-9]+)*$"
}
```

## LessonDeck

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "url": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300,
          "pattern": "^\\/(?!\\/)[A-Za-z0-9._~/-]+$"
        },
        {
          "type": "string",
          "format": "uri"
        }
      ]
    }
  },
  "required": [
    "title",
    "url"
  ],
  "additionalProperties": false
}
```

## LessonDetail

```json
{
  "type": "object",
  "properties": {
    "id": {
      "$ref": "#/components/schemas/LessonCode"
    },
    "week": {
      "type": "integer",
      "minimum": 0,
      "maximum": 52
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "tools": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 32
      }
    },
    "summary": {
      "type": "string"
    },
    "task": {
      "type": "string"
    },
    "kind": {
      "$ref": "#/components/schemas/LessonKind"
    },
    "sectionId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "gated": {
      "type": "boolean"
    },
    "locked": {
      "type": "boolean"
    },
    "video": {
      "$ref": "#/components/schemas/LessonVideo"
    },
    "konspekt": {
      "type": "string"
    },
    "timecodes": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Timecode"
      }
    },
    "prompts": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/LessonPrompt"
      }
    },
    "links": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/LessonLink"
      }
    },
    "plan": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/LessonPlanStep"
      }
    },
    "theory": {
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1000
      }
    },
    "deck": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/LessonDeck"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "id",
    "week",
    "title",
    "minutes",
    "tools",
    "summary",
    "task",
    "kind",
    "sectionId",
    "gated",
    "locked",
    "video",
    "konspekt",
    "timecodes",
    "prompts",
    "links",
    "plan",
    "theory",
    "deck"
  ],
  "additionalProperties": false
}
```

## LessonKind

```json
{
  "type": "string",
  "enum": [
    "lesson",
    "tech",
    "stream"
  ]
}
```

## LessonLink

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 300
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "title",
    "url",
    "description"
  ],
  "additionalProperties": false
}
```

## LessonList

```json
{
  "type": "object",
  "properties": {
    "lessons": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/LessonCard"
      }
    }
  },
  "required": [
    "lessons"
  ],
  "additionalProperties": false
}
```

## LessonPlanStep

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300
    },
    "body": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "title",
    "body"
  ],
  "additionalProperties": false
}
```

## LessonPrompt

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    }
  },
  "required": [
    "title",
    "text"
  ],
  "additionalProperties": false
}
```

## LessonSource

```json
{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "lesson": {
      "$ref": "#/components/schemas/LessonCode"
    },
    "seconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "kind": {
      "type": "string",
      "const": "lesson"
    }
  },
  "required": [
    "label",
    "lesson",
    "seconds",
    "kind"
  ],
  "additionalProperties": false
}
```

## LessonVideo

```json
{
  "type": "object",
  "properties": {
    "provider": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "url": {
      "anyOf": [
        {
          "type": "string",
          "format": "uri"
        },
        {
          "type": "null"
        }
      ]
    },
    "durationSec": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "provider",
    "url",
    "durationSec"
  ],
  "additionalProperties": false
}
```

## LinkIdentity

```json
{
  "type": "object",
  "properties": {
    "target": {
      "type": "object",
      "properties": {
        "displayName": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "username": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Za-z0-9_]{4,32}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "avatar": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 87407,
              "pattern": "^data:image\\/(jpeg|webp);base64,(?:[A-Za-z0-9+/]{4})+(?:[A-Za-z0-9+/][AQgw]==|[A-Za-z0-9+/]{2}[AEIMQUYcgkosw048]=)?$"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "displayName",
        "username",
        "avatar"
      ],
      "additionalProperties": false
    },
    "current": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "displayName": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            },
            "username": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_]{4,32}$"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "displayName",
            "username"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "target",
    "current",
    "expiresAt"
  ],
  "additionalProperties": false
}
```

## LinkTokenRequest

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$"
    }
  },
  "required": [
    "token"
  ],
  "additionalProperties": false
}
```

## MaterialSource

```json
{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "const": "material"
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "id": {
      "$ref": "#/components/schemas/CatalogId"
    }
  },
  "required": [
    "kind",
    "label",
    "id"
  ],
  "additionalProperties": false
}
```

## Me

```json
{
  "type": "object",
  "properties": {
    "student": {
      "$ref": "#/components/schemas/Student"
    },
    "flow": {
      "type": "string",
      "const": "agentos3"
    },
    "tier": {
      "$ref": "#/components/schemas/Tier"
    },
    "mentoring": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/MentoringKind"
        },
        {
          "type": "null"
        }
      ]
    },
    "offer": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/Offer"
        },
        {
          "type": "null"
        }
      ]
    },
    "access": {
      "type": "object",
      "properties": {
        "state": {
          "type": "string",
          "enum": [
            "active",
            "grace"
          ]
        },
        "checkedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        }
      },
      "required": [
        "state",
        "checkedAt"
      ],
      "additionalProperties": false
    },
    "onboarding": {
      "type": "object",
      "properties": {
        "status": {
          "$ref": "#/components/schemas/OnboardingStatus"
        },
        "done": {
          "type": "boolean"
        }
      },
      "required": [
        "status",
        "done"
      ],
      "additionalProperties": false
    },
    "planReady": {
      "type": "boolean"
    },
    "authKind": {
      "type": "string",
      "enum": [
        "cookie",
        "tma"
      ]
    },
    "features": {
      "type": "object",
      "properties": {
        "tutor": {
          "type": "boolean"
        },
        "agentKeys": {
          "type": "boolean"
        },
        "dictation": {
          "type": "boolean"
        }
      },
      "required": [
        "tutor",
        "agentKeys",
        "dictation"
      ],
      "additionalProperties": false
    },
    "limits": {
      "type": "object",
      "properties": {
        "tutorMessagesPerDay": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "tutorUsdPerDay": {
          "type": "number",
          "minimum": 0
        }
      },
      "required": [
        "tutorMessagesPerDay",
        "tutorUsdPerDay"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "student",
    "flow",
    "tier",
    "access",
    "onboarding",
    "planReady",
    "authKind",
    "features",
    "limits"
  ],
  "additionalProperties": false
}
```

## MentoringCoverage

```json
{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "to": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "gaps": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
          },
          "to": {
            "type": "string",
            "format": "date-time",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
          },
          "reason": {
            "type": "string",
            "enum": [
              "before_collection",
              "stopped",
              "unavailable_voice",
              "sync_error",
              "redacted"
            ]
          }
        },
        "required": [
          "from",
          "to",
          "reason"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "from",
    "to",
    "gaps"
  ],
  "additionalProperties": false
}
```

## MentoringDecisions

```json
{
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/MentoringStudentDecision"
      }
    },
    "nextCursor": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048,
          "pattern": "^[A-Za-z0-9_-]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "items",
    "nextCursor",
    "updatedAt"
  ],
  "additionalProperties": false
}
```

## MentoringDigests

```json
{
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/MentoringStudentDigest"
      }
    },
    "nextCursor": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048,
          "pattern": "^[A-Za-z0-9_-]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "items",
    "nextCursor",
    "updatedAt"
  ],
  "additionalProperties": false
}
```

## MentoringHomeworkDetails

```json
{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32768
    },
    "assigneeRole": {
      "type": "string",
      "enum": [
        "student",
        "mentor"
      ]
    },
    "assigneeName": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 64,
          "pattern": "^[^\\p{Cc}\\p{Cf}\\p{Cs}@<>]*$",
          "description": "Plain display name of the responsible person when the task is not the student's own. Absent or null means the student."
        },
        {
          "type": "null"
        }
      ]
    },
    "dueAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "doneCriteria": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32768
    },
    "status": {
      "type": "string",
      "enum": [
        "open",
        "in_progress",
        "done",
        "cancelled"
      ]
    },
    "stage": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "text",
    "assigneeRole",
    "dueAt",
    "doneCriteria",
    "status",
    "stage"
  ],
  "additionalProperties": false
}
```

## MentoringHomeworkTask

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "refs": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "document",
              "message",
              "segment",
              "recording"
            ]
          },
          "position": {
            "type": "object",
            "properties": {
              "startSeconds": {
                "type": "number",
                "minimum": 0
              },
              "endSeconds": {
                "type": "number",
                "minimum": 0
              },
              "ordinal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "revision": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "details": {
      "$ref": "#/components/schemas/MentoringHomeworkDetails"
    },
    "sessionId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    },
    "decisionId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    },
    "dependencies": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      }
    }
  },
  "required": [
    "id",
    "updatedAt",
    "refs",
    "details",
    "sessionId",
    "decisionId",
    "dependencies"
  ],
  "additionalProperties": false
}
```

## MentoringKind

```json
{
  "type": "string",
  "enum": [
    "curator",
    "dashi"
  ]
}
```

## MentoringMessages

```json
{
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/MentoringStudentMessage"
      }
    },
    "nextCursor": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048,
          "pattern": "^[A-Za-z0-9_-]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "items",
    "nextCursor",
    "updatedAt"
  ],
  "additionalProperties": false
}
```

## MentoringPersonalTrack

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "title": {
      "type": "string"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "version": {
      "$ref": "#/components/schemas/MentoringVersion"
    }
  },
  "required": [
    "id",
    "title",
    "updatedAt",
    "version"
  ],
  "additionalProperties": false
}
```

## MentoringSegment

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "refs": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "document",
              "message",
              "segment",
              "recording"
            ]
          },
          "position": {
            "type": "object",
            "properties": {
              "startSeconds": {
                "type": "number",
                "minimum": 0
              },
              "endSeconds": {
                "type": "number",
                "minimum": 0
              },
              "ordinal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "revision": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "details": {
      "type": "object",
      "properties": {
        "ordinal": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "startSeconds": {
          "type": "number",
          "minimum": 0
        },
        "endSeconds": {
          "type": "number",
          "minimum": 0
        },
        "speakerRole": {
          "type": "string",
          "enum": [
            "student",
            "mentor"
          ]
        },
        "text": {
          "type": "string",
          "maxLength": 8192
        },
        "status": {
          "$ref": "#/components/schemas/MentoringTranscriptStatus"
        },
        "quality": {
          "type": "string",
          "enum": [
            "verified",
            "uncertain",
            "redacted"
          ]
        }
      },
      "required": [
        "ordinal",
        "startSeconds",
        "endSeconds",
        "speakerRole",
        "text",
        "status"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "updatedAt",
    "refs",
    "details"
  ],
  "additionalProperties": false
}
```

## MentoringSessionRead

```json
{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "summary",
        "transcript"
      ]
    },
    "session": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        "refs": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "document",
                  "message",
                  "segment",
                  "recording"
                ]
              },
              "position": {
                "type": "object",
                "properties": {
                  "startSeconds": {
                    "type": "number",
                    "minimum": 0
                  },
                  "endSeconds": {
                    "type": "number",
                    "minimum": 0
                  },
                  "ordinal": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "revision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "kind"
            ],
            "additionalProperties": false
          }
        },
        "details": {
          "type": "object",
          "properties": {
            "startsAt": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
            },
            "kind": {
              "type": "string",
              "enum": [
                "call",
                "consultation"
              ]
            },
            "durationSeconds": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "status": {
              "type": "string",
              "enum": [
                "scheduled",
                "completed",
                "cancelled"
              ]
            },
            "summary": {
              "type": "string",
              "maxLength": 32768
            },
            "transcriptStatus": {
              "$ref": "#/components/schemas/MentoringTranscriptStatus"
            },
            "hostName": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64,
              "pattern": "^[^\\p{Cc}\\p{Cf}\\p{Cs}@<>]*$"
            },
            "recordingUrl": {
              "description": "HTTPS recording link. Allowed exact hosts: kinescope.io.",
              "type": "string",
              "maxLength": 2048,
              "format": "uri"
            },
            "title": {
              "type": "string",
              "minLength": 1,
              "maxLength": 120,
              "pattern": "^[^\\p{Cc}\\p{Cf}\\p{Cs}<>]*$"
            },
            "brief": {
              "type": "string",
              "minLength": 1,
              "maxLength": 400,
              "pattern": "^[^\\p{Cc}\\p{Cf}\\p{Cs}<>]*$"
            }
          },
          "required": [
            "startsAt",
            "kind",
            "durationSeconds",
            "status",
            "transcriptStatus"
          ],
          "additionalProperties": false
        },
        "trackVersionId": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid",
              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "updatedAt",
        "refs",
        "details",
        "trackVersionId"
      ],
      "additionalProperties": false
    },
    "transcriptStatus": {
      "$ref": "#/components/schemas/MentoringTranscriptStatus"
    },
    "oversizedSegment": {
      "type": "boolean"
    },
    "items": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/MentoringSegment"
      }
    },
    "nextCursor": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048,
          "pattern": "^[A-Za-z0-9_-]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "view",
    "session"
  ],
  "additionalProperties": false
}
```

## MentoringSessions

```json
{
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/MentoringStudentSession"
      }
    },
    "nextCursor": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048,
          "pattern": "^[A-Za-z0-9_-]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "items",
    "nextCursor",
    "updatedAt"
  ],
  "additionalProperties": false
}
```

## MentoringStudentDecision

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "refs": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "document",
              "message",
              "segment",
              "recording"
            ]
          },
          "position": {
            "type": "object",
            "properties": {
              "startSeconds": {
                "type": "number",
                "minimum": 0
              },
              "endSeconds": {
                "type": "number",
                "minimum": 0
              },
              "ordinal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "revision": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "details": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "authorRole": {
          "type": "string",
          "enum": [
            "student",
            "mentor"
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "proposed",
            "unconfirmed",
            "confirmed",
            "superseded",
            "cancelled"
          ]
        },
        "dueAt": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "text",
        "authorRole",
        "status",
        "dueAt"
      ],
      "additionalProperties": false
    },
    "sessionId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    },
    "supersedesId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "id",
    "updatedAt",
    "refs",
    "details",
    "sessionId",
    "supersedesId"
  ],
  "additionalProperties": false
}
```

## MentoringStudentDigest

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "refs": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "document",
              "message",
              "segment",
              "recording"
            ]
          },
          "position": {
            "type": "object",
            "properties": {
              "startSeconds": {
                "type": "number",
                "minimum": 0
              },
              "endSeconds": {
                "type": "number",
                "minimum": 0
              },
              "ordinal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "revision": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "details": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
        },
        "timezone": {
          "type": "string",
          "const": "Europe/Moscow"
        },
        "summary": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "coverage": {
          "$ref": "#/components/schemas/MentoringCoverage"
        }
      },
      "required": [
        "date",
        "timezone",
        "summary",
        "coverage"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "updatedAt",
    "refs",
    "details"
  ],
  "additionalProperties": false
}
```

## MentoringStudentHomework

```json
{
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/MentoringHomeworkTask"
      }
    },
    "nextCursor": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048,
          "pattern": "^[A-Za-z0-9_-]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "items",
    "nextCursor",
    "updatedAt"
  ],
  "additionalProperties": false
}
```

## MentoringStudentMessage

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "refs": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "document",
              "message",
              "segment",
              "recording"
            ]
          },
          "position": {
            "type": "object",
            "properties": {
              "startSeconds": {
                "type": "number",
                "minimum": 0
              },
              "endSeconds": {
                "type": "number",
                "minimum": 0
              },
              "ordinal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "revision": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "details": {
      "type": "object",
      "properties": {
        "at": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        "speakerRole": {
          "type": "string",
          "enum": [
            "student",
            "mentor"
          ]
        },
        "text": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "revision": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "at",
        "speakerRole",
        "text",
        "revision"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "updatedAt",
    "refs",
    "details"
  ],
  "additionalProperties": false
}
```

## MentoringStudentSession

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "refs": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "document",
              "message",
              "segment",
              "recording"
            ]
          },
          "position": {
            "type": "object",
            "properties": {
              "startSeconds": {
                "type": "number",
                "minimum": 0
              },
              "endSeconds": {
                "type": "number",
                "minimum": 0
              },
              "ordinal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "revision": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "details": {
      "type": "object",
      "properties": {
        "startsAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        "kind": {
          "type": "string",
          "enum": [
            "call",
            "consultation"
          ]
        },
        "durationSeconds": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            },
            {
              "type": "null"
            }
          ]
        },
        "status": {
          "type": "string",
          "enum": [
            "scheduled",
            "completed",
            "cancelled"
          ]
        },
        "summary": {
          "type": "string",
          "maxLength": 32768
        },
        "transcriptStatus": {
          "$ref": "#/components/schemas/MentoringTranscriptStatus"
        },
        "hostName": {
          "type": "string",
          "minLength": 1,
          "maxLength": 64,
          "pattern": "^[^\\p{Cc}\\p{Cf}\\p{Cs}@<>]*$"
        },
        "recordingUrl": {
          "description": "HTTPS recording link. Allowed exact hosts: kinescope.io.",
          "type": "string",
          "maxLength": 2048,
          "format": "uri"
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120,
          "pattern": "^[^\\p{Cc}\\p{Cf}\\p{Cs}<>]*$"
        },
        "brief": {
          "type": "string",
          "minLength": 1,
          "maxLength": 400,
          "pattern": "^[^\\p{Cc}\\p{Cf}\\p{Cs}<>]*$"
        }
      },
      "required": [
        "startsAt",
        "kind",
        "durationSeconds",
        "status",
        "summary",
        "transcriptStatus"
      ],
      "additionalProperties": false
    },
    "trackVersionId": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "id",
    "updatedAt",
    "refs",
    "details",
    "trackVersionId"
  ],
  "additionalProperties": false
}
```

## MentoringTranscriptStatus

```json
{
  "type": "string",
  "enum": [
    "not_provided",
    "consent_required",
    "processing",
    "ready",
    "failed",
    "redacted"
  ]
}
```

## MentoringVersion

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "refs": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "document",
              "message",
              "segment",
              "recording"
            ]
          },
          "position": {
            "type": "object",
            "properties": {
              "startSeconds": {
                "type": "number",
                "minimum": 0
              },
              "endSeconds": {
                "type": "number",
                "minimum": 0
              },
              "ordinal": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "revision": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": false
      }
    },
    "details": {
      "type": "object",
      "properties": {
        "markdown": {
          "type": "string",
          "maxLength": 262144
        },
        "sections": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 256
              },
              "markdown": {
                "type": "string",
                "minLength": 1,
                "maxLength": 32768
              }
            },
            "required": [
              "title",
              "markdown"
            ],
            "additionalProperties": false
          }
        },
        "stages": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "maxLength": 256,
                "pattern": "^[A-Za-z0-9_.:-]+$"
              },
              "title": {
                "type": "string",
                "maxLength": 256
              },
              "status": {
                "type": "string",
                "enum": [
                  "planned",
                  "active",
                  "done"
                ]
              }
            },
            "required": [
              "id",
              "title",
              "status"
            ],
            "additionalProperties": false
          }
        },
        "metrics": {
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 256
              },
              "value": {
                "type": "string",
                "maxLength": 256
              }
            },
            "required": [
              "label",
              "value"
            ],
            "additionalProperties": false
          }
        },
        "changes": {
          "type": "string",
          "maxLength": 32768
        }
      },
      "required": [
        "markdown",
        "sections",
        "stages",
        "metrics",
        "changes"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "id",
    "updatedAt",
    "refs",
    "details"
  ],
  "additionalProperties": false
}
```

## MentoringVersions

```json
{
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/MentoringVersion"
      }
    },
    "nextCursor": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2048,
          "pattern": "^[A-Za-z0-9_-]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "updatedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "items",
    "nextCursor",
    "updatedAt"
  ],
  "additionalProperties": false
}
```

## NextLesson

```json
{
  "type": "object",
  "properties": {
    "lesson": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/LessonCard"
        },
        {
          "type": "null"
        }
      ]
    },
    "reason": {
      "type": "string",
      "enum": [
        "continue",
        "next",
        "onboarding",
        "done"
      ]
    }
  },
  "required": [
    "lesson",
    "reason"
  ],
  "additionalProperties": false
}
```

## Offer

```json
{
  "type": "string",
  "enum": [
    "tutoring"
  ]
}
```

## OidcCallbackRequest

```json
{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$"
    }
  },
  "required": [
    "code",
    "state"
  ],
  "additionalProperties": false
}
```

## OidcStartResponse

```json
{
  "type": "object",
  "properties": {
    "authorizeUrl": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "authorizeUrl"
  ],
  "additionalProperties": false
}
```

## Onboarding

```json
{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "number",
      "const": 2
    },
    "status": {
      "$ref": "#/components/schemas/OnboardingStatus"
    },
    "step": {
      "type": "integer",
      "minimum": 0,
      "maximum": 12
    },
    "answers": {
      "$ref": "#/components/schemas/OnboardingDraft"
    },
    "completedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "schemaVersion",
    "status",
    "step",
    "answers",
    "completedAt"
  ],
  "additionalProperties": false
}
```

## OnboardingDraft

```json
{
  "type": "object",
  "properties": {
    "role": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "Основатель бизнеса",
            "Руководитель команды",
            "Эксперт / фрилансер",
            "Работаю в найме"
          ]
        },
        {
          "type": "string",
          "const": ""
        }
      ]
    },
    "business": {
      "type": "string",
      "maxLength": 2000
    },
    "scenario": {
      "maxItems": 13,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Продажи и заявки",
          "Контент и маркетинг",
          "Поддержка клиентов",
          "Аналитика бизнеса",
          "Личный помощник",
          "Документы и отчёты",
          "Операции и задачи команды",
          "Найм и HR",
          "Финансы и учёт",
          "Исследования и поиск информации",
          "Обучение команды",
          "Разработка и автоматизация",
          "Другое"
        ]
      }
    },
    "scenarioOther": {
      "type": "string",
      "maxLength": 200
    },
    "level": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "Только пробую нейросети",
            "Пользуюсь ChatGPT/Claude каждый день",
            "Писал промпты, настраивал GPTs или проекты",
            "Собирал ботов и автоматизации (n8n, Make, Zapier)",
            "Пишу код или работал с Claude Code / Cursor / Codex"
          ]
        },
        {
          "type": "string",
          "const": ""
        }
      ]
    },
    "aiTools": {
      "maxItems": 14,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ChatGPT",
          "Claude",
          "Gemini",
          "Perplexity",
          "DeepSeek",
          "GigaChat",
          "YandexGPT / Алиса",
          "Cursor",
          "Claude Code",
          "Codex",
          "n8n / Make / Zapier",
          "Telegram-боты",
          "Пока ничего не использую",
          "Другое"
        ]
      }
    },
    "aiToolsOther": {
      "type": "string",
      "maxLength": 200
    },
    "setup": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "hermes",
            "codex",
            "claude",
            "plugin"
          ]
        },
        {
          "type": "string",
          "const": ""
        }
      ]
    },
    "budget": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "lt50",
            "50_100",
            "100_200",
            "200_500",
            "500p"
          ]
        },
        {
          "type": "string",
          "const": ""
        }
      ]
    },
    "tools": {
      "maxItems": 49,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Telegram",
          "WhatsApp",
          "VK",
          "Max",
          "Instagram",
          "YouTube",
          "Дзен",
          "amoCRM",
          "Битрикс24",
          "RetailCRM",
          "YCLIENTS",
          "1С",
          "МойСклад",
          "Контур",
          "Т-Бизнес",
          "СберБизнес",
          "Точка",
          "Эвотор",
          "Google Docs и Sheets",
          "Яндекс Документы и Диск",
          "Excel",
          "Notion",
          "Yonote",
          "Miro",
          "Trello",
          "Яндекс Трекер",
          "Kaiten",
          "WEEEK",
          "Wildberries",
          "Ozon",
          "Яндекс Маркет",
          "Авито",
          "Тильда",
          "WordPress",
          "Яндекс Директ",
          "Яндекс Метрика",
          "VK Реклама",
          "GetCourse",
          "Unisender",
          "Gmail",
          "Яндекс 360",
          "Google Календарь",
          "Zoom",
          "Телемост",
          "n8n",
          "Make",
          "Zapier",
          "Albato",
          "Другое"
        ]
      }
    },
    "toolsOther": {
      "type": "string",
      "maxLength": 200
    },
    "time": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "1–3 часа в неделю",
            "3–5 часов в неделю",
            "5–10 часов в неделю",
            "Больше 10 часов"
          ]
        },
        {
          "type": "string",
          "const": ""
        }
      ]
    },
    "hardware": {
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Есть сервер (VPS)",
          "Платный публичный VPN",
          "Свой VPN",
          "Есть только компьютер",
          "Нужна помощь с настройкой"
        ]
      }
    },
    "os": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "macOS",
            "Windows",
            "Linux"
          ]
        },
        {
          "type": "string",
          "const": ""
        }
      ]
    },
    "goal": {
      "type": "string",
      "maxLength": 2000
    },
    "about": {
      "type": "string",
      "maxLength": 2000
    },
    "socialsPersonal": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/SocialLink"
      }
    },
    "socialsBusiness": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/SocialLink"
      }
    },
    "website": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/Website"
        },
        {
          "type": "string",
          "const": ""
        }
      ]
    }
  },
  "additionalProperties": false
}
```

## OnboardingDraftPatch

```json
{
  "type": "object",
  "properties": {
    "role": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Основатель бизнеса",
                "Руководитель команды",
                "Эксперт / фрилансер",
                "Работаю в найме"
              ]
            },
            {
              "type": "string",
              "const": ""
            }
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "business": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    },
    "scenario": {
      "anyOf": [
        {
          "maxItems": 13,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "Продажи и заявки",
              "Контент и маркетинг",
              "Поддержка клиентов",
              "Аналитика бизнеса",
              "Личный помощник",
              "Документы и отчёты",
              "Операции и задачи команды",
              "Найм и HR",
              "Финансы и учёт",
              "Исследования и поиск информации",
              "Обучение команды",
              "Разработка и автоматизация",
              "Другое"
            ]
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "scenarioOther": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "level": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "Только пробую нейросети",
                "Пользуюсь ChatGPT/Claude каждый день",
                "Писал промпты, настраивал GPTs или проекты",
                "Собирал ботов и автоматизации (n8n, Make, Zapier)",
                "Пишу код или работал с Claude Code / Cursor / Codex"
              ]
            },
            {
              "type": "string",
              "const": ""
            }
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "aiTools": {
      "anyOf": [
        {
          "maxItems": 14,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "ChatGPT",
              "Claude",
              "Gemini",
              "Perplexity",
              "DeepSeek",
              "GigaChat",
              "YandexGPT / Алиса",
              "Cursor",
              "Claude Code",
              "Codex",
              "n8n / Make / Zapier",
              "Telegram-боты",
              "Пока ничего не использую",
              "Другое"
            ]
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "aiToolsOther": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "setup": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "hermes",
                "codex",
                "claude",
                "plugin"
              ]
            },
            {
              "type": "string",
              "const": ""
            }
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "budget": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "lt50",
                "50_100",
                "100_200",
                "200_500",
                "500p"
              ]
            },
            {
              "type": "string",
              "const": ""
            }
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "tools": {
      "anyOf": [
        {
          "maxItems": 49,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "Telegram",
              "WhatsApp",
              "VK",
              "Max",
              "Instagram",
              "YouTube",
              "Дзен",
              "amoCRM",
              "Битрикс24",
              "RetailCRM",
              "YCLIENTS",
              "1С",
              "МойСклад",
              "Контур",
              "Т-Бизнес",
              "СберБизнес",
              "Точка",
              "Эвотор",
              "Google Docs и Sheets",
              "Яндекс Документы и Диск",
              "Excel",
              "Notion",
              "Yonote",
              "Miro",
              "Trello",
              "Яндекс Трекер",
              "Kaiten",
              "WEEEK",
              "Wildberries",
              "Ozon",
              "Яндекс Маркет",
              "Авито",
              "Тильда",
              "WordPress",
              "Яндекс Директ",
              "Яндекс Метрика",
              "VK Реклама",
              "GetCourse",
              "Unisender",
              "Gmail",
              "Яндекс 360",
              "Google Календарь",
              "Zoom",
              "Телемост",
              "n8n",
              "Make",
              "Zapier",
              "Albato",
              "Другое"
            ]
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "toolsOther": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ]
    },
    "time": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "1–3 часа в неделю",
                "3–5 часов в неделю",
                "5–10 часов в неделю",
                "Больше 10 часов"
              ]
            },
            {
              "type": "string",
              "const": ""
            }
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "hardware": {
      "anyOf": [
        {
          "maxItems": 5,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "Есть сервер (VPS)",
              "Платный публичный VPN",
              "Свой VPN",
              "Есть только компьютер",
              "Нужна помощь с настройкой"
            ]
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "os": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "macOS",
                "Windows",
                "Linux"
              ]
            },
            {
              "type": "string",
              "const": ""
            }
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "goal": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    },
    "about": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    },
    "socialsPersonal": {
      "anyOf": [
        {
          "maxItems": 10,
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/SocialLink"
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "socialsBusiness": {
      "anyOf": [
        {
          "maxItems": 10,
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/SocialLink"
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "website": {
      "anyOf": [
        {
          "anyOf": [
            {
              "$ref": "#/components/schemas/Website"
            },
            {
              "type": "string",
              "const": ""
            }
          ]
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "additionalProperties": false
}
```

## OnboardingPatchRequest

```json
{
  "type": "object",
  "properties": {
    "step": {
      "type": "integer",
      "minimum": 0,
      "maximum": 12
    },
    "answers": {
      "$ref": "#/components/schemas/OnboardingDraftPatch"
    }
  },
  "required": [
    "step",
    "answers"
  ],
  "additionalProperties": false
}
```

## OnboardingSetupRequest

```json
{
  "type": "object",
  "properties": {
    "setup": {
      "$ref": "#/components/schemas/SetupId"
    }
  },
  "required": [
    "setup"
  ],
  "additionalProperties": false
}
```

## OnboardingStatus

```json
{
  "type": "string",
  "enum": [
    "draft",
    "in_review",
    "plan_ready"
  ]
}
```

## PasswordChangeRequest

```json
{
  "type": "object",
  "properties": {
    "currentPassword": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "newPassword": {
      "type": "string",
      "minLength": 8,
      "maxLength": 128
    }
  },
  "required": [
    "currentPassword",
    "newPassword"
  ],
  "additionalProperties": false
}
```

## PasswordForgotRequest

```json
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}
```

## PasswordLoginRequest

```json
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "password": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "email",
    "password"
  ],
  "additionalProperties": false
}
```

## PasswordResetRequest

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$"
    },
    "password": {
      "type": "string",
      "minLength": 8,
      "maxLength": 128
    }
  },
  "required": [
    "token",
    "password"
  ],
  "additionalProperties": false
}
```

## PasswordResetResponse

```json
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}
```

## PasswordSetupRequest

```json
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "maxLength": 254,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "orderEmail": {
      "type": "boolean",
      "const": true
    },
    "currentPassword": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "additionalProperties": false
}
```

## PasswordStatus

```json
{
  "type": "object",
  "properties": {
    "email": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 254,
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "hasPassword": {
      "type": "boolean"
    },
    "mailEnabled": {
      "type": "boolean"
    },
    "orderEmail": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 254,
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "orderEmailMasked": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 80,
          "pattern": "^[^@\\s*]{0,2}\\*\\*\\*@[^@\\s*.]{0,2}\\*\\*\\*\\.[^@\\s*.]{1,63}$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "email",
    "hasPassword",
    "mailEnabled",
    "orderEmail",
    "orderEmailMasked"
  ],
  "additionalProperties": false
}
```

## PlanContent

```json
{
  "type": "object",
  "properties": {
    "letter": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 300
        },
        "paragraphs": {
          "minItems": 1,
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 3000
          }
        }
      },
      "required": [
        "title",
        "paragraphs"
      ],
      "additionalProperties": false
    },
    "stack": {
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "setup": {
            "$ref": "#/components/schemas/SetupId"
          },
          "recommended": {
            "type": "boolean"
          },
          "note": {
            "type": "string",
            "minLength": 1,
            "maxLength": 3000
          }
        },
        "required": [
          "setup",
          "recommended",
          "note"
        ],
        "additionalProperties": false
      }
    },
    "dashboards": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "value": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20
          },
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          }
        },
        "required": [
          "name",
          "value",
          "label"
        ],
        "additionalProperties": false
      }
    },
    "repos": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "maxLength": 3000
          }
        },
        "required": [
          "title",
          "url",
          "description"
        ],
        "additionalProperties": false
      }
    },
    "skills": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 300
          },
          "description": {
            "type": "string",
            "minLength": 1,
            "maxLength": 3000
          },
          "url": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "title",
          "description",
          "url"
        ],
        "additionalProperties": false
      }
    },
    "project": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 300
        },
        "description": {
          "type": "string",
          "minLength": 1,
          "maxLength": 3000
        }
      },
      "required": [
        "title",
        "description"
      ],
      "additionalProperties": false
    },
    "milestones": {
      "minItems": 1,
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 300
      }
    }
  },
  "required": [
    "letter",
    "stack",
    "dashboards",
    "repos",
    "skills",
    "project",
    "milestones"
  ],
  "additionalProperties": false
}
```

## PlanMilestonesUpdateRequest

```json
{
  "type": "object",
  "properties": {
    "milestonesDone": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 11
      }
    },
    "expectedVersion": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "milestonesDone",
    "expectedVersion"
  ],
  "additionalProperties": false
}
```

## PlanResponse

```json
{
  "type": "object",
  "properties": {
    "status": {
      "$ref": "#/components/schemas/OnboardingStatus"
    },
    "plan": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/PlanContent"
        },
        {
          "type": "null"
        }
      ]
    },
    "version": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "publishedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "status",
    "plan",
    "version",
    "publishedAt"
  ],
  "additionalProperties": false
}
```

## Progress

```json
{
  "type": "object",
  "properties": {
    "completed": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/LessonCode"
      }
    },
    "positions": {
      "type": "object",
      "propertyNames": {
        "$ref": "#/components/schemas/LessonCode"
      },
      "additionalProperties": {
        "type": "number",
        "minimum": 0
      }
    },
    "homework": {
      "type": "object",
      "propertyNames": {
        "$ref": "#/components/schemas/LessonCode"
      },
      "additionalProperties": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "maxLength": 4000
          },
          "sent": {
            "type": "boolean"
          }
        },
        "required": [
          "text",
          "sent"
        ],
        "additionalProperties": false
      }
    },
    "milestonesDone": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 11
      }
    }
  },
  "required": [
    "completed",
    "positions",
    "homework",
    "milestonesDone"
  ],
  "additionalProperties": false
}
```

## ProgressUpdateRequest

```json
{
  "type": "object",
  "properties": {
    "lessonId": {
      "$ref": "#/components/schemas/LessonCode"
    },
    "positionSec": {
      "type": "number",
      "minimum": 0,
      "maximum": 86400
    },
    "completed": {
      "type": "boolean"
    },
    "homework": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "maxLength": 4000
        },
        "sent": {
          "type": "boolean"
        }
      },
      "required": [
        "text",
        "sent"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "lessonId"
  ],
  "additionalProperties": false
}
```

## RevokeAllResponse

```json
{
  "type": "object",
  "properties": {
    "revoked": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "revoked"
  ],
  "additionalProperties": false
}
```

## SearchResults

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "lesson": {
            "$ref": "#/components/schemas/LessonCode"
          },
          "seconds": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "title": {
            "type": "string"
          },
          "snippet": {
            "type": "string",
            "maxLength": 500
          }
        },
        "required": [
          "label",
          "lesson",
          "seconds",
          "title",
          "snippet"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "query",
    "results"
  ],
  "additionalProperties": false
}
```

## Section

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "kind": {
      "type": "string",
      "enum": [
        "efirs",
        "pretraining",
        "week",
        "tech",
        "skills"
      ]
    },
    "number": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "lessons": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/LessonCard"
      }
    }
  },
  "required": [
    "id",
    "kind",
    "number",
    "title",
    "lessons"
  ],
  "additionalProperties": false
}
```

## SectionList

```json
{
  "type": "object",
  "properties": {
    "sections": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Section"
      }
    }
  },
  "required": [
    "sections"
  ],
  "additionalProperties": false
}
```

## SessionInfo

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "kind": {
      "type": "string",
      "enum": [
        "cookie",
        "tma"
      ]
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "lastSeenAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        {
          "type": "null"
        }
      ]
    },
    "device": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ]
    },
    "current": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "kind",
    "createdAt",
    "lastSeenAt",
    "device",
    "current"
  ],
  "additionalProperties": false
}
```

## SessionList

```json
{
  "type": "object",
  "properties": {
    "sessions": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/SessionInfo"
      }
    }
  },
  "required": [
    "sessions"
  ],
  "additionalProperties": false
}
```

## SetupId

```json
{
  "type": "string",
  "enum": [
    "hermes",
    "codex",
    "claude",
    "plugin"
  ]
}
```

## SkillSource

```json
{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "const": "skill"
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "id": {
      "$ref": "#/components/schemas/CatalogId"
    }
  },
  "required": [
    "kind",
    "label",
    "id"
  ],
  "additionalProperties": false
}
```

## SocialLink

```json
{
  "anyOf": [
    {
      "$ref": "#/components/schemas/Website"
    },
    {
      "type": "string",
      "pattern": "^@(?=[A-Za-z0-9_.]*[A-Za-z])(?![A-Za-z0-9_.]*\\d{7})[A-Za-z0-9_.]{2,64}$"
    }
  ]
}
```

## Source

```json
{
  "oneOf": [
    {
      "$ref": "#/components/schemas/LessonSource"
    },
    {
      "$ref": "#/components/schemas/SkillSource"
    },
    {
      "$ref": "#/components/schemas/MaterialSource"
    }
  ]
}
```

## Student

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "tgId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "username": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^[A-Za-z0-9_]{4,32}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "avatarUrl": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\/api\\/v1\\/me\\/avatar\\?v=[0-9a-f]{32}$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "id",
    "tgId",
    "name",
    "username",
    "avatarUrl"
  ],
  "additionalProperties": false
}
```

## Tier

```json
{
  "type": "string",
  "enum": [
    "group",
    "personal"
  ]
}
```

## Timecode

```json
{
  "type": "object",
  "properties": {
    "t": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "text": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "t",
    "label",
    "text"
  ],
  "additionalProperties": false
}
```

## TmaExchangeRequest

```json
{
  "type": "object",
  "properties": {
    "initData": {
      "type": "string",
      "minLength": 1,
      "maxLength": 8192
    }
  },
  "required": [
    "initData"
  ],
  "additionalProperties": false
}
```

## TmaExchangeResponse

```json
{
  "type": "object",
  "properties": {
    "session": {
      "$ref": "#/components/schemas/TmaToken"
    },
    "me": {
      "$ref": "#/components/schemas/Me"
    }
  },
  "required": [
    "session",
    "me"
  ],
  "additionalProperties": false
}
```

## TmaToken

```json
{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^aos3\\.tt_[A-Za-z0-9_-]{43}$"
    },
    "expiresAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    },
    "absoluteExpiresAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "token",
    "expiresAt",
    "absoluteExpiresAt"
  ],
  "additionalProperties": false
}
```

## TranscribeResponse

```json
{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 20000
    },
    "durationSec": {
      "type": "number",
      "minimum": 0
    },
    "remainingSecToday": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "text",
    "durationSec",
    "remainingSecToday"
  ],
  "additionalProperties": false
}
```

## Transcript

```json
{
  "type": "object",
  "properties": {
    "lessonId": {
      "$ref": "#/components/schemas/LessonCode"
    },
    "segments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "t": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "text": {
            "type": "string"
          }
        },
        "required": [
          "t",
          "text"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "lessonId",
    "segments"
  ],
  "additionalProperties": false
}
```

## TutorFact

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "fact": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "category": {
      "type": "string",
      "enum": [
        "goal",
        "setup",
        "preference",
        "progress",
        "other"
      ]
    },
    "createdBy": {
      "type": "string",
      "enum": [
        "tutor",
        "student"
      ]
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "id",
    "fact",
    "category",
    "createdBy",
    "createdAt"
  ],
  "additionalProperties": false
}
```

## TutorFacts

```json
{
  "type": "object",
  "properties": {
    "facts": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/TutorFact"
      }
    }
  },
  "required": [
    "facts"
  ],
  "additionalProperties": false
}
```

## TutorMessage

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "role": {
      "type": "string",
      "enum": [
        "user",
        "assistant"
      ]
    },
    "text": {
      "type": "string",
      "maxLength": 65536
    },
    "sources": {
      "maxItems": 20,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Source"
      }
    },
    "parts": {
      "maxItems": 8,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/TutorPart"
      }
    },
    "citations": {
      "default": [],
      "maxItems": 100,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Citation"
      }
    },
    "error": {
      "type": "boolean"
    },
    "feedback": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "up",
            "down"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "attachments": {
      "maxItems": 4,
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Attachment"
      }
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "id",
    "role",
    "text",
    "sources",
    "citations",
    "error",
    "feedback",
    "attachments",
    "createdAt"
  ],
  "additionalProperties": false
}
```

## TutorMessagesPage

```json
{
  "type": "object",
  "properties": {
    "messages": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/TutorMessage"
      }
    },
    "nextBefore": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "messages",
    "nextBefore"
  ],
  "additionalProperties": false
}
```

## TutorPart

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "const": "progress"
        },
        "lessonsDone": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10000
        },
        "lessonsTotal": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10000
        },
        "milestonesDone": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10000
        },
        "milestonesTotal": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10000
        }
      },
      "required": [
        "type",
        "lessonsDone",
        "lessonsTotal",
        "milestonesDone",
        "milestonesTotal"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "const": "lesson"
        },
        "code": {
          "$ref": "#/components/schemas/LessonCode"
        },
        "label": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "positionSec": {
          "type": "integer",
          "minimum": 0,
          "maximum": 86400
        },
        "durationSec": {
          "type": "integer",
          "minimum": 0,
          "maximum": 86400
        }
      },
      "required": [
        "type",
        "code",
        "title",
        "positionSec",
        "durationSec"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "const": "checklist"
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "items": {
          "minItems": 1,
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 300
              },
              "done": {
                "type": "boolean"
              }
            },
            "required": [
              "text",
              "done"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "type",
        "title",
        "items"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "const": "compare"
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "options": {
          "minItems": 2,
          "maxItems": 4,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 80
              },
              "points": {
                "minItems": 1,
                "maxItems": 8,
                "type": "array",
                "items": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 300
                }
              }
            },
            "required": [
              "name",
              "points"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "type",
        "title",
        "options"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "const": "chips"
        },
        "questions": {
          "minItems": 2,
          "maxItems": 3,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          }
        }
      },
      "required": [
        "type",
        "questions"
      ],
      "additionalProperties": false
    }
  ]
}
```

## TutorSendRequest

```json
{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "text": {
      "type": "string",
      "maxLength": 4000
    },
    "attachments": {
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      }
    }
  },
  "required": [
    "requestId",
    "text"
  ],
  "additionalProperties": false
}
```

## TutorSendResponse

```json
{
  "type": "object",
  "properties": {
    "userMessage": {
      "$ref": "#/components/schemas/TutorMessage"
    },
    "reply": {
      "$ref": "#/components/schemas/TutorMessage"
    },
    "messagesLeftToday": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "userMessage",
    "reply",
    "messagesLeftToday"
  ],
  "additionalProperties": false
}
```

## Upload

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "mime": {
      "type": "string",
      "enum": [
        "image/png",
        "image/jpeg",
        "image/webp",
        "application/pdf",
        "text/plain",
        "text/markdown"
      ]
    },
    "kind": {
      "type": "string",
      "enum": [
        "image",
        "pdf",
        "text"
      ]
    },
    "size": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 10485760
    },
    "width": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 4096
        },
        {
          "type": "null"
        }
      ]
    },
    "height": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 4096
        },
        {
          "type": "null"
        }
      ]
    },
    "pages": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 20
        },
        {
          "type": "null"
        }
      ]
    },
    "textTruncated": {
      "type": "boolean"
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
    }
  },
  "required": [
    "id",
    "name",
    "mime",
    "kind",
    "size",
    "width",
    "height",
    "pages",
    "textTruncated",
    "createdAt"
  ],
  "additionalProperties": false
}
```

## Website

```json
{
  "type": "string",
  "maxLength": 500,
  "format": "uri"
}
```
