# Computer Control API
SUMMARY: Удалённое управление зарегистрированными компьютерами — постановка команд в очередь, снимки экрана, выполнение скриптов на удалённых машинах.

KEY CONTEXT:
Two sides: user-facing (Mind Key/JWT) and agent-facing (Computer Token)
Register agent: POST /computers/register { install_code } → returns computer_token
List: GET /computers/list (Mind Key or JWT)
Queue command: POST /computers/:id/commands { type, payload }
Command types: screenshot, click, move, type, key, scroll, drag
Agent poll: GET /computers/me/poll?wait=5 (Computer Token)
Agent result: POST /computers/me/commands/:cid/result (Computer Token)
One-shot screenshot: GET /computers/:id/screenshot (waits 30s for result)
Pattern: register agent on remote machine → user queues commands → agent polls and executes

Computer Control API
Computer Control API позволяет удалённо управлять зарегистрированными компьютерами.
Небольшой агент () работает на целевой машине, опрашивает сервер,
выполняет команды и отправляет результаты обратно. Это обеспечивает LLM-управляемую
GUI-автоматизацию.
Архитектура
[CODE BLOCK]
Пользовательские эндпоинты (Mind Key или JWT)
GET /computers/list
Получить список всех зарегистрированных компьютеров.
[CODE BLOCK]
GET /computers/:id
Получить информацию о конкретном компьютере.
[CODE BLOCK]
POST /computers/install-code
Сгенерировать установочный код для регистрации нового компьютера.
[CODE BLOCK]
Ответ: 
POST /computers/:id/commands
Поставить команду в очередь для выполнения удалённым агентом.
[CODE BLOCK]
Ответ: 
GET /computers/:id/command (через query)
Поставить команду в очередь через GET (для простых случаев).
[CODE BLOCK]
GET /computers/:id/commands
Получить список недавних команд компьютера.
[CODE BLOCK]
GET /computers/:id/commands/:cid
Получить статус и результат конкретной команды.
[CODE BLOCK]
GET /computers/:id/screenshot
Одноразовый вызов: поставить команду снимка экрана в очередь и ждать результат до 30 секунд.
[CODE BLOCK]
POST /computers/:id/disable
Отключить компьютер (отзывает его токен, но сохраняет запись для аудита).
[CODE BLOCK]
DELETE /computers/:id
Удалить компьютер навсегда.
[CODE BLOCK]
Эндпоинты для агентов (Computer Token)
Эти эндпоинты используются агентом , работающим на целевой
машине. Они используют Computer Token (возвращается ), а не
Mind Key.
POST /computers/register
Активировать установочный код и получить Computer Token.
[CODE BLOCK]
Ответ: 
> [!CRITICAL]
> Сохраните  — он показывается только один раз и требуется
> для всех эндпоинтов на стороне агента.
GET /computers/me/poll
Long-poll для новых команд. Агент вызывает этот метод в цикле.
[CODE BLOCK]
Возвращает сразу, если есть ожидающие команды, или через  секунд, если их нет.
POST /computers/me/commands/:cid/result
Отправить результат выполнения команды.
[CODE BLOCK]
Типы команд
| Тип | Payload | Описание |
|------|---------|-------------|
|  |  | Захват экрана в формате PNG (base64) |
|  |  | Клик по координатам |
|  |  | Перемещение мыши на координаты |
|  |  | Ввод текста в позиции курсора |
|  |  | Нажатие комбинации клавиш |
|  |  | Прокрутка колеса мыши |
|  |  | Перетаскивание |
Типовой паттерн: LLM-управляемая GUI-автоматизация
[CODE BLOCK]
Следующие шаги
- Browser Proxy — отдельный сервис для автоматизации браузера
- Руководство по Self-Hosted Agents