Релиз 0.13.4¶
Дата выхода: 4 ноября 2026.
Релиз 0.13.4 — стабилизационный выпуск линии 0.13.x. Новых крупных подсистем в нём нет: задача релиза — довести до пользователей уже написанное, закрыть найденные дефекты и зафиксировать контракты. В заметки включены все изменения волны 0.13.0–0.13.4: версии 0.13.0–0.13.3 в npm не публиковались (выходили только беты во внутреннем реестре), поэтому документ описывает всю линию целиком.
Что входит в релиз
Заметки кумулятивные: 0.13.0–0.13.3 отдельными пакетами не выходили, и публикуется только 0.13.4. Полный список коммитов и исправлений — в релизах репозитория (зеркало GitVerse: gitverse.ru/itphx/synth/releases).
Ход как последовательность шагов¶
Ответ агента больше не одно «монолитное» сообщение: ход разбит на шаги, и в каждом видно, какие инструменты вызывались и что они вернули.
- Шаги с инструментами. Вызовы, их аргументы и результаты сохраняются вместе с ходом. После перезагрузки страницы лента восстанавливается в том же виде, включая промежуточные шаги.
- Живое состояние. Пока агент работает, интерфейс показывает текущий шаг, статус активности и содержимое очереди — без «слепых» пауз.
- Очередь и вклинивание. Сообщение, отправленное во время работы, встаёт в очередь и видно сразу; его можно переставить или удалить до начала обработки. Если отправить сообщение «в разрыв», оно попадёт в текущий ход на ближайшей границе шага.
- «Стоп» с сохранением очереди. Остановка прерывает текущий ход, но не стирает очередь: после остановки можно продолжить с накопленными сообщениями.
- Надёжная синхронизация. Изменения и удаления сообщений адресуются по идентификатору, поэтому лента не «съезжает» при параллельных действиях, а после переподключения догружается только недостающее.
Пример: пока агент собирает проект, отправьте ещё два сообщения — они появятся в панели очереди, и их порядок можно поменять до старта. Нажатие «Стоп» остановит текущий ход, а очередь останется на месте.
Провайдеры и совместимость¶
- Уровень рассуждений. Для моделей, которые его поддерживают, в настройках
сессии доступен параметр effort/
reasoningLevel; выбранное значение уходит провайдеру и учитывается в маршрутизации. - Thinking-блоки. Подписанные блоки рассуждений сохраняются и передаются
обратно провайдеру без потери подписи; поддерживается несколько блоков и
reasoning_contentдля thinking-моделей DeepSeek. Блоки не смешиваются между разными парами «провайдер + модель». - Отключённые провайдеры и модели. Скрытые администратором провайдеры и модели не показываются в выборе и не попадают в отправку — даже если выбраны в старой сессии.
- Usage и стоимость. Для ответа сохраняются данные об использовании токенов, вспомогательные вызовы учитываются отдельно, а стоимость считается по тарифам провайдера.
Пример: включите в настройках модели уровень рассуждений «высокий» — в интерфейсе появится индикатор размышлений, а в статистике сессии вырастет расход токенов на reasoning.
Сжатие контекста¶
Длинные сессии теперь не упираются в лимит окна модели: контекст можно сжимать двумя способами.
- Суммаризация. Старые сообщения заменяются кратким резюме, а последние
сообщения остаются нетронутыми. Граница хвоста задаётся в токенах
(
summarizationKeepTokens), поэтому свежий контекст не теряется. - Компактизация. Более глубокая переработка истории с отдельной границей
хвоста (
compactionKeepTokens) — для совсем долгих диалогов. - Настройки инстанса. Режим, границы и лимиты заметок задаются в настройках и могут иметь разные значения по умолчанию для новых сессий.
- Прозрачность в интерфейсе. Когда сжатие срабатывает, в ленте появляется индикатор, а при приближении к лимиту — предупреждение.
- Резюме — это сообщение истории. Оно имеет роль «резюме», хранит ссылку на исходный диапазон и метаданные; покрытые сообщения скрываются, но не удаляются — история остаётся восстановимой.
Пример: в долгой сессии включите суммаризацию и задайте хвост в 8 000 токенов — старые шаги свернутся в резюме, а последние сообщения и текущий ход останутся как есть.
Вложения¶
- Потоковая загрузка. Крупные файлы передаются частями и не буферизуются в памяти целиком; состояние загрузки переживает переключение реплик и переподключение. Незавершённые загрузки удаляются автоматически через час.
- Квоты. Лимит на сессию учитывает активные загрузки; появились отдельные
пределы
attachments.maxActiveUploadsPerSession(16) иattachments.maxActiveUploads(256). Невалидный размер возвращает400, превышение квоты —413с подробностями вdetails. - Обработка перед отправкой. На границе отправки готовятся миниатюры и сжатые версии изображений, видео и аудио; оригинал в хранилище не меняется. Нативные форматы определяются по возможностям модели, а не по имени хоста.
- Вложения инструментов. Файлы и медиа, которые вернул инструмент, попадают в текущий ход и показываются отдельным служебным блоком.
Пример: приложите видео на несколько сотен мегабайт — загрузка пойдёт частями, в сообщении появится превью, а провайдеру уйдёт сжатая версия. Если файл не проходит по квоте, ошибка будет содержать конкретный предел и текущее значение.
Списки и лимиты¶
- Постраничные списки. Списки сессий, проектов и других сущностей отдаются
объектом
{items, total, offset, limit, next_offset};next_offset: nullозначает последнюю страницу. - Лёгкие сессии. Список сессий больше не тянет полную историю и очередь — интерфейс открывается быстрее, а память не растёт с числом сессий.
- Капы чтения. Чтение файла ограничено 5 МиБ, предпросмотр — 100 МиБ, листинг каталога — 10 000 записей, diff коммита — 1 МиБ. При превышении возвращается понятная ошибка или флаг усечения, а не зависание.
- Жёсткие границы. У списка моделей
limitпринимает только значения от 1 до 500; некорректное значение — ошибка400.
Пример: запросите список сессий с limit=50&offset=100 — в ответе будет
next_offset для следующей страницы. Для каталога с сотнями тысяч файлов
листинг вернёт truncated: true и первые 10 000 записей.
Инструменты и исполнитель¶
- Больше инструментов. Веб-поиск и загрузка страниц, работа с медиа,
patch-операции, управление todo, блокировки, предпросмотр и ограничение области поиска. - Чтение по частям. У
read_fileпоявилсяnextOffset— большой файл можно читать порциями, не упираясь в лимит вывода. - Надёжная запись. Учтены переводы строк (CRLF), защита от случайной
перезаписи, атомарная запись файла и уведомление
fs.changedпослеpatch— дерево файлов и редакторы обновляются сами. - Лимиты и таймауты. Предел вывода настраивается, а таймауты git, shell и поиска задаются отдельно; по истечении возвращается понятная ошибка.
- Проекты. Одновременные правки проекта не затирают друг друга: изменения применяются атомарно, а реестр репозиториев общий для всех инструментов.
- Исполнитель. Потолок таймаута команды — 600 секунд; лимиты пула соблюдаются строго (fail-closed), а образы для сборки и медиа вынесены в отдельные уровни.
Пример: читайте файл оглавлениями через nextOffset, а после patch не нужно
вручную обновлять дерево — интерфейс получит fs.changed и перерисует его сам.
Интерфейс и сессии¶
- Авто-заголовок. Название сессии предлагается сразу после первого сообщения; ложное имя можно отклонить, а заголовок — перегенерировать.
- Черновики композера. Неотправленный текст сохраняется и не пропадает при переключении сессий или перезагрузке.
- Авто-обновление PWA. Установленное приложение само сообщает о новой версии и обновляется по подтверждению.
- Синхронизация между клиентами. Сообщения, проект, план и рабочее пространство обновляются у всех открытых клиентов — лента не «залипает» после действий коллеги или второго окна.
- Очередь после рестарта. После перезапуска инстанса очередь продолжает работу; если продолжение невозможно, интерфейс предупреждает об остановке и гасит зависший индикатор.
- Просмотр файлов. Медиа и отрендеренный Markdown открываются прямо в интерфейсе, изображения масштабируются, у заголовков есть якоря, а относительные ссылки в README работают.
Гибрид и TLS¶
- Системное доверие TLS. Гибридный клиент доверяет корневым сертификатам операционной системы в дополнение к встроенным; проверка сертификата включена по умолчанию.
- Стабильный идентификатор реплики. Сервер, к которому подключён клиент, сохраняет свой идентификатор между перезапусками — правая панель и состояние не «прыгают» при переключении.
Безопасность¶
- Внутренний аудит до релиза. Пройдены проверки на утечки секретов в дереве и истории, негативная матрица доступа к сессиям, контроль роста зависимостей и обзор классов уязвимостей.
- Исправления по итогам аудита. Усилен контроль путей при git-операциях (проверка реального пути перед деструктивными действиями), сжатие контекста теперь всегда идёт через общий шлюз с фильтрами и аудитом, квоты потоковой загрузки учитываются корректно, а секретные тома Helm получают строгие права доступа.
- Зависимости. Критичных и высоких уязвимостей в продакшн-зависимостях нет; ряд библиотек обновлён до исправленных версий.
Обновление¶
Перед обновлением
- PostgreSQL. Если инстанс работает на базе, выполните
synth migrateдо запуска новой версии. Повторный прогон безопасен. - Бэкап. Перед обновлением сделайте резервную копию каталога данных, а для PostgreSQL — ещё и дамп базы.
- Схема данных. Добавлены миграции 028–030: подпись reasoning, поток шагов и
повтор сессии. Обновление с 0.12.x требует прогона
synth migrate. - Транспорт. Сессионный SSE-канал удалён: клиенты работают через общий
транспорт
/ws/events. Фоллбек на SSE остаётся на уровне общего транспорта, поэтому старые клиенты не теряют соединение. - Конфигурация. Новые поля
attachments.maxActiveUploads*имеют значения по умолчанию — существующие конфиги остаются валидными, править их не нужно.
Порядок зависит от способа установки:
Тома с данными не затрагиваются — история и настройки сохраняются.
Известные ограничения
- Этап 5 контракта сообщений — major-версия SDK, удаление старого события
message.addedи подписки webhook на новую модель сообщений — выходит вне 0.13.4. Текущие интеграции продолжают работать. - Рестарт инстанса прерывает активный ход. После старта ход переигрывается, поэтому инструменты могут выполниться повторно. Дешёвая часть отказоустойчивости (корректная остановка, grace-период, политика раскатки) появится в следующем релизе.
- JSON-логи с
request_idи SLO (доступность, латентность хода, глубина очереди) — за пределами этого релиза; метрики и алерты уже доступны.
Что дальше¶
- Возможности — полный обзор платформы.
- Вложения и мультимодальность — как прикладывать файлы и настраивать лимиты.
- Конфигурация — параметры сжатия контекста, вложений и листингов.
- Гибридный режим — локальный клиент и корпоративный сервер.
- FAQ — в том числе порядок обновления версии.