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

Релиз 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* имеют значения по умолчанию — существующие конфиги остаются валидными, править их не нужно.

Порядок зависит от способа установки:

npm install -g @itphx/synth@latest
synth migrate --yes
synth --version
docker pull gitverse.ru/itphx/synth:0.13.4
docker rm -f synth
# затем запустите контейнер заново

Тома с данными не затрагиваются — история и настройки сохраняются.

helm upgrade synth synth/synth -f my-values.yaml --namespace synth

Данные хранятся на PVC и переживают обновление. В split-режиме образ исполнителя обновляется тем же релизом.

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

  • Этап 5 контракта сообщений — major-версия SDK, удаление старого события message.added и подписки webhook на новую модель сообщений — выходит вне 0.13.4. Текущие интеграции продолжают работать.
  • Рестарт инстанса прерывает активный ход. После старта ход переигрывается, поэтому инструменты могут выполниться повторно. Дешёвая часть отказоустойчивости (корректная остановка, grace-период, политика раскатки) появится в следующем релизе.
  • JSON-логи с request_id и SLO (доступность, латентность хода, глубина очереди) — за пределами этого релиза; метрики и алерты уже доступны.

Что дальше