hosted-agents

hosted-agents — скилл Muratcan Koylan о проектировании hosted и background-инфраструктуры для AI-агентов. Он относится к системам, где агент выполняется в удалённом изолированном окружении, а не на устройстве пользователя. В область скилла входят sandbox execution, remote coding environments, warm pools, сохранение сессии, multiplayer collaboration, интерфейсы для Slack, Web и Chrome extension, а также сценарии, в которых агент запускает дочерние сессии. Это архитектурное руководство: оно помогает разложить систему и выбрать границы компонентов, но само по себе не предоставляет sandbox, API или готовый deployment. Главная предлагаемая граница состоит из трёх слоёв, которые масштабируются независимо. Первый слой отвечает за изолированное выполнение и жизненный цикл sandbox. Второй — API для состояния и координации клиентов. Третий — интерфейсы, через которые пользователь наблюдает работу и продолжает сессию. Такой раздел позволяет менять инфраструктуру sandbox без копирования агентской логики в каждом клиенте. Для framework скилл рекомендует server-first устройство: TUI, desktop, web, Slack и другие поверхности остаются тонкими клиентами, а единый backend сохраняет одинаковое поведение и подключает плагины, поток событий и контроль инструментов. Скорость пользовательской сессии должна ограничиваться временем до первого токена от провайдера модели, поэтому подготовку среды предлагают вынести до ввода prompt. В image registry pattern периодически собирается образ с repository на известном commit, runtime-зависимостями, уже выполненными setup и build шагами и кэшами тестов. В качестве практического ориентира указан цикл около тридцати минут; это пример политики, а не гарантия свежести. После выдачи образа остаётся синхронизировать небольшой delta. Snapshot и restore нужны как минимум после сборки базового образа, после изменений агента и перед завершением sandbox, чтобы продолжение сессии не начиналось с полного clone и install. Для высокой нагрузки скилл предлагает warm pool заранее подготовленных sandbox и predictive warm-up с момента, когда пользователь начинает печатать. Чтение файлов можно разрешить ещё до завершения синхронизации repository, потому что исследовательская работа часто не зависит от последних изменений; записи при этом блокируются до окончания sync. Состояние изолируется на уровне сессии, например отдельной SQLite-базой, чтобы один агент не влиял на производительность и данные другого. Потоковые обновления должны включать токены, события инструментов и уведомления об изменённых файлах; для долгих WebSocket-соединений источник упоминает hibernation APIs. Для background-агентов важны авторство и границы полномочий. В каждом sandbox нужно явно задать git identity. Изменения сначала отправляются в ветку, затем API получает branch и session ID и создаёт PR с пользовательским GitHub token, чтобы audit trail принадлежал человеку, а не приложению. Модель скилла также предполагает multiplayer с явной attribution каждой команды и общим состоянием сессии, а self-spawning — только через ограниченный набор примитивов start, status и продолжения работы. Перед реализацией нужно определить lifecycle sandbox, политику образов и warm pool, правила чтения и записи, auth, извлечение логов и PR, лимиты бюджета и teardown. Без этих решений hosted agent остаётся набором удалённых процессов, а не воспроизводимой системой.