Релиз 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-развёртывания. Образ исполнителя и сервис пулов обновляйте вместе с сервером, начиная с сервиса пулов: сервер новой версии передаёт ему описание профиля, которого старая версия не понимает.
Если инстанс работает как сервис, после обновления перезапустите его:
synth service restart.
Тома с данными не затрагиваются — история и настройки сохраняются. В раздельном развёртывании обновите образ исполнителя тем же тегом.
helm repo update
helm upgrade synth synth/synth --version 0.13.10 -f my-values.yaml --namespace synth
Чарт обновляет сервер, интерфейс, исполнителя и сервис пулов согласованно;
данные на PVC переживают обновление. Перед обновлением проверьте, что
provisioner.enabled и execution.mode в values соответствуют вашей
топологии.
После обновления проверьте:
GET /healthиGET /readyотвечают200, состояние —ready.- В разделе Настройки → Исполнение видны профили и пулы; новые профили применяются после перезапуска инстанса, если вы правили каталог в интерфейсе.
- В сессии выполняется простая команда — и, если включён
remote, именно на исполнителе.
Известные ограничения¶
- Сборка образов удалённо только описана. Собирать образы исполнителей из сессии можно лишь через внешний builder; автоматической сборки и публикации образов у платформы нет.
- Сквозной сценарий на кластере не автоматизирован. Создание пулов, права и сетевые политики проверяются по частям; полный прогон на живом кластере выполняется вручную.
- Управление коммитами в git-вкладке — следующий этап. Сейчас видны изменения, diff и сводка по репозиторию; создание коммитов из интерфейса появится позже.
- В гибридном режиме терминал не пробрасывается. Терминал работает на том инстансе, где исполняются команды; из локального клиента к серверному PTY подключиться нельзя.
- Часть настроек применяется после перезапуска. Это относится к исполнению (профили, пулы, топология), сети, прокси и TLS. Интерфейс показывает, что сохранено и что работает сейчас.
- Таймеров нет в SDK. Управление таймерами и будильниками доступно через интерфейс, инструменты агента и HTTP API; клиентская библиотека их пока не покрывает.
Что дальше¶
- Исполнение: профили и пулы — как устроен контур и что видно в админке.
- Возможности — полный обзор платформы.
- Безопасность — шлюз, права и фильтрация недоверенного контента.
- Автоматизация — таймеры, будильники и расписания.
- Обслуживание — обновление, перезапуск и откат.