Перейти к содержанию

Релиз 0.13.10

Дата выхода: 18 ноября 2026.

В 0.13.10 исполнение команд перестало быть «режимом» и стало отдельным контуром: у него появились профили, пулы, песочница, браузер и собственный сервис, который создаёт окружения по требованию. Рядом выросли три вещи, без которых этот контур не живёт: встроенный терминал, доступ к проекту для участников и групп и автоматизация без sleep — таймеры и будильники. Вторая половина релиза — про честное состояние: причина остановки больше не теряется, фоновая работа не блокирует ход, а недоверенный контент приходит модели с понятной границей.

Заметки кумулятивные: версия 0.13.9 в npm не публиковалась (выходили только беты во внутреннем реестре и сборки на тестовом стенде), поэтому документ описывает обе волны целиком.

Что входит в релиз

Кумулятивные заметки: 0.13.9 отдельным пакетом не выходила, публикуется только 0.13.10. Полный список коммитов и исправлений — в релизах репозитория (зеркало GitVerse: gitverse.ru/itphx/synth/releases).

Изолированный контур исполнения

Раньше «исполнять команды вне сервера» означало один адрес исполнителя и надежду, что окружение подходит любой задаче. Теперь это полноценный контур: на исполнителе работают все инструменты агента — файлы, поиск, git, shell, вложения, браузер и терминал, — а сервер не читает файлы проекта сам.

  • Профили исполнения. Профиль описывает окружение: адрес, таймаут, параллельность, режим отказа, образ, сетевой класс, ресурсы (включая GPU), MCP-серверы и правила размещения. Профиль выбирается по цепочке «сессия → агент → проект → профиль по умолчанию», а проект и агент могут ограничить список допустимых профилей.
  • Каталог профилей в интерфейсе. Раздел Настройки → Исполнение: карточки профилей с образом, сетью и ресурсами, добавление своих профилей, отключение профилей из поставки, сброс к конфигурации. Каталог и режим пулов применяются после перезапуска — раздел честно показывает, что сохранено и что работает сейчас.
  • Пулы. Область пула — инстанс, проект или сессия; класс — команды, браузер или песочница. Браузерный пул всегда проектный, поэтому cookies и сессии браузера не перетекают между проектами.
  • Песочница. Разовый запуск до пяти команд в отдельном окружении — для проверки чужих инструментов и экспериментов, не затрагивая рабочий контур.
  • Сервис пулов (provisioner). Отдельный процесс, который создаёт пулы по требованию: статический список адресов или поды в Kubernetes. Он же следит за сроком жизни пулов, лимитом живых окружений и прогревом образов.
  • Изоляция как контракт. Non-root, корневая файловая система только на чтение, сетевые классы none / restricted / full через политики кластера, токен доверия только в Secret или файле. Недоступный исполнитель — это отказ, а не тихий запуск на сервере.

Подробнее — Исполнение: профили и пулы.

Встроенный терминал

У агента и человека появился общий терминал — вкладка рядом с файлами и сессией.

  • Настоящий терминал, а не имитация. Полноценная оболочка с историей, автодополнением и полноэкранными программами; работает на том же исполнителе, что и остальные инструменты.
  • Терминал принадлежит проекту. Один проект — несколько терминалов; сессия может быть привязана к своему. Каталог — рабочая копия сессии или каталог проекта.
  • Вывод не теряется. История хранится на диске и восстанавливается после перезапуска инстанса; терминал можно перезапустить, сохранив вывод.
  • Агент умеет работать в терминале. Открыть, прочитать, отправить команду и сигнал, дождаться завершения — отдельными инструментами, с запретом в режиме планирования.
  • «Спросить агента». Из терминала можно отправить вопрос вместе с фрагментом вывода — агент получит контекст, не копируя его вручную.

Подробнее — Встроенный терминал.

Доступ к проекту: участники и группы

Доступ к проекту стал одной осью вместо прежнего переключателя видимости.

  • Участники и роли. Владелец, редактор и наблюдатель: наблюдатель читает проект и не запускает ход, редактор меняет содержимое.
  • Группы из системы входа. Группы пользователя приходят из OIDC; достаточно выдать доступ группе, а не перечислять людей.
  • Передача владения. Владелец может передать проект другому человеку; прежний владелец остаётся редактором.
  • Изменение доступа видно сразу. Новый участник получает события проекта, отозванный — перестаёт; списки обновляются без перезагрузки страницы.
  • Перенос не передаёт права. Экспорт и импорт проекта не содержат участников и групп: проект приходит «только автору».

Автоматизация: таймеры и будильники

Расписания умели «каждый час по cron», но не «через 20 минут» и не «разбуди меня в 9:00».

  • Таймер и будильник. Таймер срабатывает один раз, ежедневно в заданное время или каждые N секунд; будильник — то же с отдельным именем и значком.
  • Только в проекте. Автоматизации привязаны к проекту и сессии; инстансных («глобальных») нет.
  • Один смысл — комментарий. У срабатывания нет своего промпта: есть короткий комментарий, который получает агент. Это защищает от «тихих» инструкций, спрятанных в расписании.
  • Доставка в текущий ход. Если сессия занята, срабатывание приходит в неё; если нет — запускает новый ход.
  • Панель «Автоматизация». Расписания, таймеры и будильники в одном месте, со счётчиками и историей; значки в дереве сессий показывают, что сессия «под таймером».

Пример: «напомни через два часа проверить сборку» — агент создаёт таймер, и напоминание придёт в сессию, без опроса и sleep в командах.

Честные остановки и автовосстановление

  • Причина остановки остаётся в истории. Вместо сообщения об ошибке — запись «Остановлено: причина» (лимит шагов, бюджет контекста, ошибка провайдера, остановка человеком, отказ прав, рестарт, потерянный прогон).
  • Восстановление саб-агентов. После перезапуска дочерние прогоны поднимаются заново с бюджетом попыток; при повторяющихся падениях срабатывает защита от цикла перезапусков и владелец получает сообщение.
  • Ручной повтор. Если восстановление исчерпало попытки, прогон можно запустить вручную из интерфейса.
  • Лента саб-агента по шагам. Видны шаги прогона, а не только итоговый отчёт; историю можно догрузить.

Фоновая работа

  • Авто-detach. Если вы пишете агенту, пока он ждёт длинную команду или саб-агента, блокирующая работа автоматически уходит в фон, а сообщение доставляется сразу. Очередной режим (queue) при этом ждёт завершения.
  • Живой лог с первой секунды. Вывод фоновой команды пишется сразу и доступен во вкладке процесса; после перевода в фон ничего не копируется заново.
  • Разделение потоков. У процесса отдельно видны объединённый лог, stdout и stderr.
  • Блокирующие прогоны видимы. В панели «Процессы» есть секции блокирующих саб-агентов и процессов, их можно остановить и посмотреть лог.
  • Долгие команды. Таймауты инструментов задаются в секундах; фоновый shell по умолчанию живёт сутки, поэтому долгоживущий dev-сервер перезапускается сам.

Безопасность: недоверенный контент

  • Конверт вокруг результата. Вывод веба, shell, терминала, MCP и саб-агентов приходит модели в блоке с источником и уровнем доверия; файлы проекта и git считаются доверенными, плагины — по уровню доверия.
  • Три режима фильтрации. Пометить подозрительное (flag), очистить (sanitize) или заблокировать результат (block). Настройка — в разделе «Безопасность», применяется сразу.
  • Подделка маркера не блокирует чтение. Строка, похожая на границу блока, экранируется и помечается — документация и код проекта остаются читаемыми.
  • Описания MCP-инструментов проверяются. Подозрительные описания помечаются предупреждением, но инструмент не блокируется.

LLM Gateway включён по умолчанию

Единый слой для всех обращений к моделям теперь включён во всех режимах: обфускация секретов, аудит каждого запроса и ограничение частоты работают «из коробки». Отключение остаётся явным — тумблером в интерфейсе, конфигурацией или переменной окружения; при отключении интерфейс и проверки состояния показывают предупреждение.

Ввод, чтение и интерфейс

  • Быстрый ввод. Команды /compact (сжать контекст) и /review (ревью изменений), $ — скиллы, # — сниппеты, @ — упоминания файлов и сущностей, ! — скрипты проекта.
  • Markdown как в документе. Единая типографика заголовков и списков, формулы, диаграммы mermaid, ширина чтения и редактор кода в просмотрщике.
  • Git в файловых вкладках. Изменённые файлы помечаются, есть режим diff и сводный diff репозитория.
  • Скрипты проекта. Реестр скриптов запускается командой !имя без хода модели; длинные запуски идут как фоновые процессы.
  • Мобильный интерфейс. Панель подтверждений и элементы чата больше не перекрывают ввод.

Обновление

Перед обновлением

  • База данных. Если инстанс работает на PostgreSQL, выполните synth migrate до запуска новой версии. Повторный прогон безопасен.
  • Резервная копия. Снимите копию каталога данных, а для PostgreSQL — ещё и дамп базы.
  • Порядок для split-развёртывания. Образ исполнителя и сервис пулов обновляйте вместе с сервером, начиная с сервиса пулов: сервер новой версии передаёт ему описание профиля, которого старая версия не понимает.
npm install -g @itphx/synth@0.13.10
synth migrate --yes
synth --version

Если инстанс работает как сервис, после обновления перезапустите его: synth service restart.

docker pull git.itphx.ru/itphx/synth:0.13.10
docker rm -f synth
# затем запустите контейнер заново

Тома с данными не затрагиваются — история и настройки сохраняются. В раздельном развёртывании обновите образ исполнителя тем же тегом.

helm repo update
helm upgrade synth synth/synth --version 0.13.10 -f my-values.yaml --namespace synth

Чарт обновляет сервер, интерфейс, исполнителя и сервис пулов согласованно; данные на PVC переживают обновление. Перед обновлением проверьте, что provisioner.enabled и execution.mode в values соответствуют вашей топологии.

После обновления проверьте:

  1. GET /health и GET /ready отвечают 200, состояние — ready.
  2. В разделе Настройки → Исполнение видны профили и пулы; новые профили применяются после перезапуска инстанса, если вы правили каталог в интерфейсе.
  3. В сессии выполняется простая команда — и, если включён remote, именно на исполнителе.

Известные ограничения

  • Сборка образов удалённо только описана. Собирать образы исполнителей из сессии можно лишь через внешний builder; автоматической сборки и публикации образов у платформы нет.
  • Сквозной сценарий на кластере не автоматизирован. Создание пулов, права и сетевые политики проверяются по частям; полный прогон на живом кластере выполняется вручную.
  • Управление коммитами в git-вкладке — следующий этап. Сейчас видны изменения, diff и сводка по репозиторию; создание коммитов из интерфейса появится позже.
  • В гибридном режиме терминал не пробрасывается. Терминал работает на том инстансе, где исполняются команды; из локального клиента к серверному PTY подключиться нельзя.
  • Часть настроек применяется после перезапуска. Это относится к исполнению (профили, пулы, топология), сети, прокси и TLS. Интерфейс показывает, что сохранено и что работает сейчас.
  • Таймеров нет в SDK. Управление таймерами и будильниками доступно через интерфейс, инструменты агента и HTTP API; клиентская библиотека их пока не покрывает.

Что дальше