@ykurilov/agent-chat-core 0.0.0-stage → 0.55.0

package/CHANGELOG.md

@@ -0,0 +1,2259 @@
+# @ykurilov/agent-chat-core
+
+## 0.55.0
+
+### Minor Changes
+
+- 51f7b38: DeepSeek 4.1 Flash больше не пишет за собеседника: в профиле модели обрезка хвоста `sampling: { minP: 0.05 }`, она уходит
+  полем `min_p` к Together и OpenRouter (DeepSeek напрямую и Fireworks его не получают). Без неё Together изредка брал в
+  конце склеенное «?» с пустой строкой, и модель продолжала писать «user…», вторые рассуждения и новый ответ.
+  
+  Новое в профиле модели: `sampling` (параметры выбора слов, пока `minP`) и у провайдера `samplingRequest(sampling)` —
+  перевод в опции запроса. Опции профиля (`providerOptions` и `sampling`) теперь несёт сама модель из каталога
+  (`resolveLanguageModel`): их получают и служебные вызовы с готовой моделью — склейка памяти после ответа раньше шла без
+  них (в том числе без запрета хозяев OpenRouter из профиля).
+  
+  ### Как обновить приложение
+  
+  - Ничего делать не нужно. Если приложение само добавляло DeepSeek 4.1 Flash `min_p` (`addModels` с
+    `providerOptions.togetherai.min_p` / `providerOptions.openrouter.min_p`) — эту правку можно убрать: SDK делает то же.
+  - Выключить или поменять: `addModels: [{ ...профиль, sampling: { minP: 0.1 } }]` или профиль без `sampling`; одному
+    провайдеру — `providerOptions: { togetherai: { min_p: … } }` в профиле (главнее `sampling`). Подробно —
+    docs/getting-started.md, «Параметры выбора слов в профиле модели».
+- cdc7dd7: Голос: расход в лимитах, причина отказа, Next.js, язык записи, предел из настройки.
+  
+  - `UsageSource` открыт для своих видов приложения (`"font_download"` без приведения типа), штатные — в
+    `BUILT_IN_USAGE_SOURCES`, тип `BuiltInUsageSource`. Новые штатные виды `voice_input` (секунды распознавания,
+    `inputTokens` — секунды) и `voice_polish` (чистка текста). Миграций нет.
+  - `createVoiceRelay({ spending: { service, recognitionUsdPerHour, chatId? } })`: лимит до диктовки, секунды звука в журнал
+    расхода. Чистка: `polish: { askModel, model }` через службу чата; у Together — `pricing`; своя `clean` может вернуть
+    `{ text, usage }`. Расход чистки — вид `voice_polish`.
+  - Причина отказа доходит до браузера кодом закрытия (`RELAY_CLOSE`): 4401 не вошёл, 4402 лимит, 4403 нет доступа,
+    4413 слишком длинно, 4429 часто, 4502 недоступен, 1009 кусок больше предела. Отказ приложения `{ refused: { code } }`
+    переводится по `code`. Новые виды ошибок `limit`, `forbidden`, `too_long`; 4401 теперь `forbidden` (был
+    `service_unavailable`).
+  - `@ykurilov/agent-chat-voice/node`: `createVoiceUpgrade({ path, relay, maxFrameBytes })` — голос на своём HTTP-сервере
+    Node.js (Next.js custom server), `shareVoiceRelay` / `sharedVoiceRelay` — мостик внутри процесса. Нужен `ws`.
+    Кривой путь — 400, обрыв во время проверки входа не роняет процесс, `authorizeTimeoutMs` (10 с) — 503.
+  - Ретранслятор: `helloTimeoutMs` (10 с без приветствия — 4400, место свободно), `maxFrameBytes` (1 МиБ, 1009) — единый
+    для Hono и node. Чат расхода из `?chat=` — только свой (`service.assertOwnChat`), иначе `"voice"`.
+    `allowedLanguageHints` с регионом (`pt-BR`) разрешает язык `pt`. Относительный `relayUrl` снова работает.
+  - Язык каждой записи: `voice.start(listener, { chatId, language })`, `createVoiceInput({ languageHints })`; сервер
+    проверяет значение сам (`allowedLanguageHints`). `AgentChat` передаёт текущий чат и язык словаря.
+  - react: подпись `time_limit` — строка или функция от предела сервера («предел 3 минуты»); `onError(kind, details)`;
+    подписи `limit`, `forbidden`, `too_long` необязательные в своём словаре; `voiceErrorText`.
+
+## 0.54.0
+
+### Minor Changes
+
+- fa90219: Битые аргументы инструментов: дописываются забытые закрывающие `]` и `}`. Модель иногда не закрывает массив или
+  объект (`{"facts": ["a", "b"}`, `{"fields": [{…}`). Теперь ядро дописывает недостающие скобки в правильном порядке,
+  но только когда JSON оборван на законченном значении. Обрыв внутри строки, ключа, числа или слова `true`, после
+  запятой или двоеточия, а также больше трёх недостающих скобок — не чинятся. Починенный вызов, как и раньше, проверяется
+  схемой инструмента. В строке журнала `[аргументы починены]` — `правка=дописаны скобки ×N`; в `ToolInputRepair` — поле
+  `missingClosers`.
+
+## 0.53.0
+
+### Minor Changes
+
+- b6a7786: Сценарии: конец разговора без сбоев, «не сейчас», пояс по умолчанию, реплика сотрудника, тихое утро, касания с
+  карточками; расход по списку чатов.
+  
+  - Конец разговора («срок вышел», «не завершил», прощание) больше не зависит от того, начался ли ход касания. Касания
+    сценария не режет потолок ядра «5 ходов сервера подряд»; у `deliverNotices` — свой потолок `maxServerTurnsInRow`
+    (число или `false`, по умолчанию 5, `MAX_SERVER_TURNS_IN_ROW`).
+  - Мягкий потолок сценария: 50 ходов сервера подряд без человека (`timers.maxServerTurnsInRow`), дальше касания ждут
+    его сообщения, конец разговора — в свой срок. Срок без причин писать не повторяется каждый час.
+  - `canWriteNow` → `false` — «не сейчас»: касание через час; `"never"` — молчать до сообщения человека; `{ retryAt: Date }`
+    — в свой момент (негодная дата — как `false`, прошлая — через минуту). Сроки конца разговора не снимаются.
+  - Человек писал до начала дня меньше 3 часов назад (`skipMorningIfHumanWithinMin`) — касания в начале дня ждут, не только
+    утреннее. Переход ноды по сроку и ответ на ночные сообщения не ждут.
+  - Сообщения после жёсткой рамки дня ставят срок на утро сами: ответ на накопленное приходит в `dayStart` при любых
+    касаниях. Их время — в данных чата (`flowHeldHuman`); для правила 3 часов, «не завершил» и перехода «человек молчит»
+    они — сообщения человека.
+  - `attach.deliver` получает `parts` — все части ответа для человека (карточка ролика, картинка, файл, виджет), `text`
+    прежний; `deliverNotices({ awaitAnswer }).answer.parts`; `deliverableParts` из ядра.
+  - `storage.sumUsageByChat({ chatIds, ownerId?, source?, since? })` — расход по списку чатов одним запросом (память,
+    SQLite, PostgreSQL; общие тесты хранилищ).
+  - `createAgentFlow({ defaultTimeZone })` — пояс, пока пояс человека неизвестен. Порядок: человек → страница →
+    `defaultTimeZone` → пояс службы → сервер. `prepareTurn` получает `pageTimeZone` — пояс, присланный страницей.
+  - `service.appendStaffMessage({ ownerId, chatId, text, staffName?, wakeAgent? })` — реплика живого сотрудника: модель
+    видит её словами сотрудника, `person_link_view` словами человека её не считает, проверки ответа агента её текст знают,
+    ход сама не начинает.
+    `flow.noteStaffReply` пишет тем же путём и принимает `staffName`. Экран: необязательный `StaffMessage` скина (договор 25),
+    без него — ответ агента с подписью `labels.notices.staffSaid`.
+  - `flow.tick()` в публичном типе, `factId` из пакета, перемотка до утра у чата, закреплённого через `adopt` без хода.
+  
+  Как обновить приложение: снимите `it.fails` у теста «молчун все три дня»; ответ эксперта кладите
+  `appendStaffMessage` / `noteStaffReply` вместо сообщения собеседника и уберите обёртку `withoutNonPersonWords`; по желанию
+  `defaultTimeZone` и `StaffMessage` в своём скине; снимите `it.fails` у теста «касание, отложенное ночью до утра»;
+  доставляйте `message.parts` в своей доставке касаний; расход по чатам — `sumUsageByChat`.
+
+## 0.52.0
+
+No changes in this release.
+
+## 0.51.0
+
+### Minor Changes
+
+- 41b1726: Проверка ответа: **тексты приложения.** В `replyChecks` появилось `knownTexts: ({ ownerId, chatId }) => string[] | Promise<string[]>` — первое сообщение, прощание, названия роликов: слова и ссылки оттуда больше не вырезаются и не считаются чужими. Если `replyChecks` передан в `flow.withChat(…)`, сценарий сам добавляет свои тексты (общая часть, ноды, первые сообщения, прощание, рамка дня, попутные задачи). **Проверка текста вне хода:** `service.checkReply({ ownerId, chatId, text })` → `{ text, notes }` — те же проверки и тот же набор «виденного», что у хода. **Исправление:** служебные сообщения приложения (`app`, «напиши первым») и реплики сотрудника больше не делают ссылку законной — «виденное от человека» берётся только из сообщений человека (итоги фоновых задач остаются виденными). Если агент должен повторять ссылки из своих служебных сообщений, назовите их в `knownTexts`. Подробно — `docs/reply-check.md`.
+
+## 0.50.0
+
+No changes in this release.
+
+## 0.49.0
+
+### Minor Changes
+
+- 084cef7: **Ломает приложения (типы и своё хранилище сценариев):** у типа поля сценария `FlowFieldType` появилось значение `"boolean"`, у источника
+  расхода `UsageSource` — `"first_message"`, у `SteerResult.status` — `"held"`. Исчерпывающий `switch` по ним перестанет
+  собираться. Своё хранилище сценариев (`FlowStore`) должно реализовать новый `renewLease()` и третий аргумент `setDue`.
+  
+  Сценарии для приложений: программа по дням (ночь, касания, рамки дня, «срок вышел»), своя служба чата и доставка с
+  исходами, пауза сотрудника, конец разговора с итогом, карточка и пояс человека в базе приложения, попутные задачи.
+  Проверка готового ответа: «чужие слова» и «выдуманные ссылки». Подробно — `docs/flows.md`, `docs/reply-check.md`,
+  раздел 0.49.0 в `CHANGES.md`.
+  
+  - **flows**: формат сценария версии 2 (`schedule`, `nudges`, таймер `state_days`, поле `boolean`, `sideTasks`,
+    `afterEnd`; версия 1 читается сама); `attach({ portFor, deliver })`, `admit`, `pause`/`resume`/`noteStaffReply`,
+    `reportDelivery`, `onFinish`, `clientCard`, `people`, `settled`, `now`; причина перехода `reason`; перенос чата
+    через `loadFlow` (`stateId`, `startedAt`, `enteredAt`); заголовки судьи `judge.openrouter.headers`; встроенная задача
+    «узнать город»; `checkFlow(flow, catalog, { checks })` и `FlowAppChecks` из `/format`; в редакторе панели дней,
+    касаний, рамок и попутных задач, `catalog.fields`, кнопка «К началу следующего дня» (`advanceToNextDay`). Новые
+    таблицы `flow_people`, `flow_side_tasks` и колонки `flow_chats` создаются сами.
+  - **core**: `replyChecks` (список или `{ checks, web: "replace" | "hold" }`), `now`, `markUndelivered`, ответы
+    `beforeTurn` `{ hold: true }` и `{ reply: { text } }`, `deliverNotices({ timeZone, awaitAnswer, usageSource })`,
+    источник расхода `first_message`.
+  - **flows, надёжность**: обход таймеров до 5 ходов одновременно; копия продлевает аренду чата перед ходом и во время
+    него. В `FlowStore` новые `renewLease()` и `setDue(…, { unlessDelivery })`. Недоставленное касание (`failed`,
+    `window_closed`) не засчитывается — тот же шаг через свой срок от отказа; в `FlowRun` новое поле `touch`. «Окно
+    закрыто» снимает любое сообщение человека; «не завершил» считает тишину и от конца паузы сотрудника; пока ждёт
+    повтор доставки, срок не затирается и новых ходов нет.
+  - **server**: `createChatServer` передаёт службе `replyChecks` и `now`.
+  - **messengers**: `onAnswerDelivery` — исход доставки каждого ответа; закрытое окно ВК (950) —
+    `MessengerWindowClosedError` и исход `window_closed`; с `replyChecks` уходит только проверенный текст.
+  - **web-tools**: `createPersonLinkTool` — инструмент `person_link_view`, агент смотрит ссылку, которую прислал человек
+    (адрес из почты ссылкой не считается).
+  - **reply-check** (новый пакет): `foreignWords` и `unknownLinks`; ответ из одной выдуманной ссылки заменяется запасной
+    фразой `labels.linkOnlyReply` (`russianReplyCheckLabels`, `englishReplyCheckLabels`, `ReplyCheckLabels`).
+  - **react**: договор скина версии 24 — необязательное `undelivered` у ответа агента и надпись `answerUndelivered`
+    («Не доставлено»). Скин версии 23 работает без правок.
+  
+  ### Как обновить приложение
+  
+  1. Поднимите все пакеты `@ykurilov/agent-chat-*` до этой версии вместе.
+  2. Найдите в коде приложения исчерпывающие `switch` и словари по этим типам и добавьте ветки:
+     - по `FlowFieldType` (поля карточки сценария) — `"boolean"`, «да/нет», значения `true`/`false`;
+     - по `UsageSource` (отчёты расходов) — `"first_message"`, «агент написал первым»;
+     - по `SteerResult.status` — `"held"`, «сообщение записано, хода нет».
+  3. Своё хранилище сценариев (свой `FlowStore`) — добавьте `renewLease({ chatId, owner, now, leaseMs }): Promise<boolean>`
+     (продлить аренду до `now + leaseMs`; `false` — чат уже не ваш) и третий аргумент `setDue(chatId, due, { unlessDelivery })`
+     (при `unlessDelivery` не писать срок, пока чат ждёт повтора доставки). Готовые хранилища SDK это уже умеют.
+  4. Сценарии сохраняются версией 2, а 0.48 её не откроет. Перед откатом на 0.48 держите копии сценариев версии 1.
+  5. Новое по желанию: каналы SDK и сценарий — `createMessengers({ onAnswerDelivery: (report) => flow.reportDelivery(report) })`;
+     проверка ответа — `pnpm add @ykurilov/agent-chat-reply-check` и `replyChecks` в `createChatServer`.
+  6. Проверка: `pnpm typecheck` проходит, чат отвечает, сценарий версии 1 открывается в редакторе.
+
+## 0.48.0
+
+### Minor Changes
+
+- fa10d5a: Сценарии поведения агента: разговор идёт по шагам с условиями выхода, судьёй, таймерами «написать первым» и карточкой
+  клиента, плюс редактор сценария с тестовым чатом. Подробно — `docs/flows.md`.
+  
+  - **flows** (новый пакет): `createAgentFlow`, формат и проверка сценария, судья decision-1 с запасной моделью, таймеры,
+    карточка клиента, перевод чатов на новую версию, хранилища SQLite и PostgreSQL, `FlowEditor`, `FlowTestChat`, `ClientCardPanel`.
+  - **core**: новые точки для расширений — `agent.prepareTurn` (контекст хода с `resumed`, `audience`, `staff?`),
+    служебное сообщение `app`, готовый ответ `deliverNotices({ reply })`, `askModel` и `recordUsage`, источник расхода
+    `judge`, `ChatService.assertWithinLimit(ownerId, chatId)`; `chatInstructions(chat, turn?)` — второй аргумент с
+    `audience` (при сжатии истории его нет).
+  - **server**: `chatInstructions` в настройках принимает тот же второй аргумент `turn`.
+  - **messengers**: ответ сервера без модели (точный текст по таймеру сценария) теперь доходит до мессенджера.
+  - **skin-tandem**: новые входы `/flows` (`tandemFlowEditorSkin`) и `/client-card` (`tandemClientCardSkin`).
+  
+  ### Как обновить приложение
+  
+  Сценарии не нужны — обновление ничего не требует. Нужны — шаги в разделе «Как обновить приложение» в `CHANGES.md`:
+  `pnpm add @ykurilov/agent-chat-flows`, `createAgentFlow` + `flow.withChat(…)`, `flow.attach(service)`, `flow.start()`,
+  `OPENROUTER_API_KEY` на сервере. Тестовому чату нужен `readRun(chatId)` в `FlowTestChatConnection`; его адреса
+  закройте правами редактора. `firstMessages: false` теперь значит «без тихих часов и потолка», запрет —
+  `canWriteNow: () => false`. Проверка: `pnpm typecheck`, новый чат отвечает по первому состоянию сценария.
+
+## 0.47.0
+
+### Minor Changes
+
+- 5a59c33: Уровень «Максимум» больше не съедает ответ на рассуждения. В профиле модели новое поле `maxOutputTokens` (потолок вывода): уходит в каждом запросе как `max_tokens`, если приложение не задало `agent.maxOutputTokens`; у Claude Haiku 5.5 — 128 000. Ответу остаётся пятая часть предела и не меньше 16 тысяч. Новое поле `reasoning.effortShareOfOutput`: у моделей, где сила рассуждений — доля предела (Claude через OpenRouter, `xhigh` — 95 %), уровень уходит самой глубокой силой с запасом на ответ — у Haiku 5.5 «Максимум» теперь `high`. Новое поле `reasoning.tokenBudget`: модель, которая держит бюджет рассуждений, получает его числом (`reasoning.max_tokens` у OpenRouter). Как обновить своё приложение: в своей копии профиля `claude-haiku-5.5` добавьте `maxOutputTokens: 128_000` и `reasoning.effortShareOfOutput: true`.
+
+## 0.46.2
+
+### Patch Changes
+
+- 3d0d2f2: Claude через OpenRouter больше не падает с ошибкой «A maximum of 4 blocks with cache_control may be provided. Found 5» после параллельных вызовов инструментов: метка кэша у результатов инструментов — одна, на последнем результате, а у моделей `anthropic/…` в теле запроса не бывает больше 4 меток. Часовые цены записи кэша (`cacheWrite1hPerMillion`) у GPT 6 Luna, DeepSeek 4.1 Flash и GLM 5.3 Flash через OpenRouter.
+
+## 0.46.1
+
+No changes in this release.
+
+## 0.46.0
+
+### Minor Changes
+
+- 56d7528: Наблюдения «Умных форм», без ломающих изменений.
+  
+  - **Начатый вызов в базе до выполнения.** Вызов инструмента пишется в хранилище сразу, как модель его прислала, а
+    инструмент ждёт этой записи (не дольше 5 с). Упади сервер посреди инструмента — восстановленный ответ показывает
+    вызов прерванным, «Повторить» продолжает с него.
+  - **Последний шаг без действий.** На шаге без инструментов (последний шаг хода и помощника, итог по потолку хода)
+    вызов вопреки запрету не выполняется: у него закрывающий результат-отказ с постоянным текстом, подтверждение не
+    спрашивается.
+  - **`afterTurn` видит `stepLimit: true`**, когда ход упёрся в `agent.maxSteps`; в журнале строка `[предел шагов]`, в
+    ответе часть `data-step-limit` (модель её не видит). Человеку на экране ничего не показывается.
+  - **«Повторить» передаёт `previousAnswerId` и `abandonedAnswerIds`** в `beforeTurn` и `turnNotStarted`: оборванный
+    ответ, который заменит новый ответ-сосед.
+  - **React: «ответа уже нет» — лента сразу перечитывает историю.** Виджет, подтверждение и браузерный вызов, на которые
+    сервер ответил «не ждёт», перечитывают историю; сорвавшееся под нагрузкой чтение повторяется, лента не застывает.
+  - **Тандем: поле ввода не пересоздаётся**, когда приходят меню моделей, вложения, голос и другие поздние части
+    панели. Текст, набранный до загрузки меню, и фокус остаются.
+  
+  ### Как обновить приложение
+  
+  Обновление само по себе ничего не требует. Обходы, которые теперь можно убрать:
+  
+  1. Тесты, которые перед вводом текста ждут кнопку «Модель» (например, `tests/support/test-chat-ready.ts`), — ждать её
+     больше не нужно: текст, набранный раньше меню, не пропадает.
+  2. Тесты восстановления, которые перед остановкой сервера ждут `status: complete` в базе, могут обрывать сервер
+     посреди инструмента: вызов уже в базе и после восстановления виден прерванным.
+  3. Свои проверки «последний ли это шаг» внутри инструментов с последствиями (бронь, оплата) — SDK сам не выполняет
+     вызов на последнем шаге.
+  4. Свой подсчёт шагов в `afterTurn`, чтобы понять, что ход упёрся в предел, — заменить на `turn.stepLimit`.
+  5. Своё вычисление прежнего ответа для «Повторить» — брать `previousAnswerId` из `beforeTurn` / `turnNotStarted`.
+- a1933fd: Битые аргументы инструментов чинятся без повтора: лишняя закрывающая `}` или `]` (в конце JSON или после элемента
+  списка, не больше двух) убирается, починенный вызов SDK заново проверяет схемой инструмента. Каждая починка — строка
+  `[аргументы починены]` в журнале сервера без содержимого аргументов.
+
+### Patch Changes
+
+- 52cc67d: Заметка хода (место на экране, день, блоки `contextBlocks`) — у последнего входа хода. После ответа на виджет или
+  подтверждение свежая заметка встаёт сразу за ответом человека, последним сообщением запроса; раньше она оставалась в
+  давнем вопросе, и новое место модель не видела. Ничего не поменялось — заметки нет. Начало запроса байт в байт прежнее,
+  кэш модели цел. Каждая заметка продолжения — ещё одна часть `data-frozen-context` в ответе: читаете ответы из хранилища
+  сами — пропускайте все такие части.
+
+## 0.45.0
+
+No changes in this release.
+
+## 0.44.0
+
+### Minor Changes
+
+- 6a2b5d9: Живые демонстрации: блок ```html-demo в ответе запускается в изолированной рамке (`sandbox="allow-scripts"`, строгий CSP,
+  наружу только высота). `agent.liveDemos` на сервере — одна постоянная строка инструкции; `liveDemos` у `AgentChat`,
+  `ChatWorkspace` и `AgentPanel`. Договор скина v22: необязательные `AgentText.renderDemo` и `ChatSkin.demoColors`, Тандем
+  умеет. Мессенджеры вместо блока пишут `liveDemoOnSite`, если у службы чата `liveDemos` (новое необязательное поле `ChatService.liveDemos`).
+  Код живёт в рамке внутри рамки: уйти на чужой адрес он не может, WebRTC убран. Выключатель: в чате с чужим текстом (веб-инструменты, файл человека, инструмент с `metadata: { externalContent: true }`)
+  демонстрации не запускаются — признак `ChatHistory.externalContent` и кусок потока `data-external-content`. Вложенные рамки
+  и `<link rel=preconnect>` в документе демонстрации запрещены. Всё необязательное, ломающих изменений нет. Как обновить
+  приложение — в CHANGES.md, раздел 0.44.0.
+
+## 0.43.0
+
+### Minor Changes
+
+- 763f4c5: Claude Haiku 5.5 (`claude-haiku-5.5`) в `standardCatalog` через OpenRouter, с кэшем на час. Срок кэша теперь задаётся по
+  модели: `cacheTtl` в профиле, `cacheTtlByModel` и `cacheTtl` в `createOpenRouterProvider` (настройка провайдера главнее
+  профиля). У остальных моделей запрос прежний. Цена часовой записи — новое поле `cacheWrite1hPerMillion`; каталог отмечает в
+  цене `cacheWriteTtl: "1h"`, и расход считается по сроку, с которым модель пишет кэш. `requestOptions` провайдера получает
+  `profile`; новый необязательный метод `cacheTtlFor(profile)`.
+
+## 0.42.0
+
+### Minor Changes
+
+- a385276: Публичный чат больше не выдаёт посетителю служебное: модель, провайдера, расход, текст сводки сжатия и закрытые
+  ключи состояния. Ничего не ломает: по умолчанию всё как раньше.
+  
+  - Новое право `modelDetails` в `chatCapabilities` (по умолчанию `true`). `false` убирает из истории и потока ответа
+    модель, провайдера и уровень рассуждений чата, `ownerId`, `metadata.modelId`/`providerId`/`usage` у сообщений,
+    `providerMetadata`/`callProviderMetadata`/`resultProviderMetadata` у частей и кусков, провайдера у отметки
+    `data-step-reset`, текст сводок сжатия (`summary: ""`, `summaryTokens: 0` в истории и `GET …/compactions`) и
+    выключает выбор модели (`modelChoice`). То же при переподключении и смене ветки. Хранилище, модель, хуки и лимиты
+    получают всё.
+  - Опция сервера и службы `modelMenu: ({ userId }) => boolean` закрывает `GET …/models` (403 `action_forbidden`,
+    `action: "modelDetails"`): меню чата не знает, право его не закрывает.
+  - Тандем рисует разделитель сжатия без текста сводки строкой без кнопки.
+  - Опция `privateStateKeys: ["booking"]` — закрытые верхние ключи состояния чата: не уходят ни в историю, ни в поток,
+    ни в `state-changed` наблюдения (`useChatState` их не видит). `getChatState`, `onStateChanged`, события и модель
+    видят их как обычно. Имя без точки и не на `$`, иначе `TypeError` при создании. Закрытое значение не возвращайте в
+    выходе инструмента (его прячет лишь `toolDetails: false`) и в тексте ответа (не прячется никак).
+  - Экран запрашивает меню моделей после истории и только если оно нужно: разрешён выбор модели (или вложениям старого
+    сервера). История всегда несёт `modelAcceptsImages` — видит ли модель чата картинки.
+  
+  ### Как обновить приложение
+  
+  Публичному чату (посетитель без входа) в `server/chat.ts` или где создаётся обработчик. Посетитель — человек со своим
+  `userId` от `resolveUser` (например, `visitor:<id сессии из cookie>`); `isVisitor = (userId) => userId.startsWith("visitor:")`.
+  `modelDetails: false` прячет и модель, и текст сводок сжатия; `toolDetails: false` сводку не трогает.
+  
+  ```ts
+  createChatHandler({
+    // …
+    chatCapabilities: ({ userId }) => (isVisitor(userId) ? { modelDetails: false, toolDetails: false, reasoning: false /* , … */ } : {}),
+    modelMenu: ({ userId }) => !isVisitor(userId),
+    privateStateKeys: ["booking"], // верхние ключи состояния со служебными id
+  });
+  ```
+  
+  Свой скин: `CompactionDivider` может получить `summary: ""` (при `modelDetails: false`) — раскрывать нечего, покажите
+  только строку.
+
+## 0.41.0
+
+### Patch Changes
+
+- 9472fcb: Поправка на лету и английский интерфейс.
+  
+  - `onTurnFinished` в `AgentChat` приходит и для ответа, закрытого ради поправки, — перед ответом на поправку. Раньше
+    событие получал только последний ответ, и действия под первым (например, «Вернуть эту версию») не появлялись.
+    Событие есть, даже если продолжение по поправке не стартовало (лимит расходов, чужие ходы, чат закрыт).
+    **Внимание:** при поправке на ходу `onTurnFinished` теперь приходит на каждый ответ — обработчик, который сохраняет
+    снимок или считает ходы, увидит 2 события и больше.
+  - Продолжение после поправки получает `place` самой свежей поправки, где он есть, иначе начала хода: служебная заметка
+    приложения уже новая, а поправка только с `tabId` место не стирает. Вкладка и пояс — от последней поправки: браузерные
+    инструменты продолжения идут на её вкладку. Кэш цел — блок места ложится в хвост поправки.
+  - `englishLabels` — полный английский словарь чата. `englishAttachmentsLabels`, `englishWebToolTitles`,
+    `englishHistorySearchTitles`, `englishMemoryToolTitles` (два последних — и из корня пакета); `withWebToolTitles` и
+    соседи берут словарь названий вторым аргументом (по умолчанию русский).
+  
+  Как обновить: поднять версию. Английский интерфейс — `<ChatLabelsProvider labels={englishLabels}>` и
+  `createAttachmentsClient(englishAttachmentsLabels)` вместо своих словарей.
+
+## 0.40.0
+
+### Minor Changes
+
+- 0e7aab3: Наблюдения «Умных форм», без ломающих изменений:
+  
+  - `useChatState(chatId)` — состояние чата вне `AgentChat` (панель рядом с чатом): те же значения и живые обновления,
+    без своих запросов.
+  - `onModelChosen` — человек выбрал модель в меню: колбэк `AgentChat` и хук службы (`createChatService`, `createChatServer`).
+  - `{ by: "app" }` у `service.deleteChat` и `service.setModel` — сервер приложения действует без прав экрана; адреса HTTP
+    проверяют права, как раньше.
+  - «Переделать» у приветствия скрыто, а сервер такой запрос отклоняет (`InvalidMessageError`).
+  - `recoverInterruptedAnswers({ soleServer: true })` — у единственной копии сервера оборванные ответы прерываются сразу,
+    а не через 15–20 с. Только при старте процесса; не с несколькими копиями на одной базе и не в dev-режиме Next.js.
+  
+  Как обновить: поднять версию, правки не обязательны. Обходные пути можно заменить — см. CHANGES.md «0.40.0».
+
+## 0.39.1
+
+No changes in this release.
+
+## 0.39.0
+
+### Minor Changes
+
+- 3b90429: Виджеты: `onStateChanged` с причиной `widgetAnswer` после записей `checkAnswer`; `ctx.emitAppEvent` в `checkAnswer`
+  (событие вместе с ответом виджета, на странице — живым один раз); `chatId` и `toolCallId` в `CustomWidgetProps`;
+  `agent.widgets.enabledFor` — набор виджетов по чату, выключенных модель не видит, их прошлые вызовы идут модели текстом.
+  Всё необязательное, ломающих изменений нет. Как обновить приложение — в CHANGES.md, раздел 0.39.0.
+
+## 0.38.0
+
+### Minor Changes
+
+- 1cae504: Четыре добавки для форм и похожих приложений, всё необязательное, старый код работает как раньше.
+  
+  - `beforeTurn` и `turnNotStarted` у «Переделать» (`regenerate`) и правки вопроса (`edit`) получают `abandonedAnswerIds` —
+    ответы агента, которые уйдут с ветки, — и `previousAnswerId` — заменяемый ответ. Откатывайте по ним побочные дела
+    брошенных ответов; пришёл `turnNotStarted` — ветка прежняя, верните откат по тем же полям. Тип `AbandonedAnswers`.
+  - `agent.contextBlocks` получает `state` — состояние ветки на начало хода (копия). Звать `getChatState` внутри функции
+    больше не нужно.
+  - `service.getChatData(userId, chatId)` — данные чата копией, без записи и события. Вместо пустого `updateChatData(…, {})`.
+  - `endTurn(output, { text? })` — результат инструмента, после которого модель следующего шага не делает. Готовый `text`
+    идёт в ответ обычной текстовой частью без запроса к провайдеру и без расхода; `output` модель видит как обычно. Тип
+    `EndTurnOptions`. Свои реализации интерфейса `ChatService` (заглушки в тестах) дополните методом `getChatData`.
+- 4065a4a: Картинки для моделей без зрения. Зрение модели теперь решается для пары «модель + провайдер»: в профиле
+  `acceptsImagesByProvider: { together: false }` главнее `acceptsImages`, решение даёт `modelAcceptsImages(profile, providerId)`
+  из ядра, по нему меню моделей и вложения. В стандартном каталоге DeepSeek 4.1 Flash и GLM 5.3 Flash через Together
+  отмечены без зрения (у Together они только текстовые) — картинка туда больше не уходит, модель получает пометку.
+  
+  Во вложениях:
+  
+  - `createAttachments({ imagesForBlindModels: { toolName, marker?, always? } })` — модели без зрения вместо картинки идёт
+    постоянная плашка `[Картинка «shot.png», вложение <id>. Посмотреть: <toolName>.]`; к инструкции вложений дописывается
+    строка про неё. Без настройки — прежняя пометка «картинка не показана».
+  - `attachments.readChatImage({ chatId, attachmentId })` — картинка только этого чата для инструмента приложения
+    (`chatId` — из `AgentToolsModel.chatId`); чужое, не картинка, неверный номер — `undefined`.
+  - `createAttachments({ acceptedMediaTypes: ["image/png", "image/jpeg", "image/webp"] })` — файл другого типа отклоняется
+    `unsupported_type` до разбора и записи; поле ввода получает список из настроек и отказывает до загрузки.
+    Решает тип, с которым файл пришёл (поле записи `sourceMediaType`): ужатый в JPEG PNG при `["image/png"]` проходит.
+    Импорт чата вместо картинки неподходящего типа пишет «[картинка: имя]».
+  - `isAttachmentId` — из публичного входа.
+  - Снимок страницы (`page_screenshot`) тоже решает по паре «модель + провайдер».
+  
+  Ничего не ломает: приложениям без этих настроек делать ничего не нужно. Как убрать свой обход — в CHANGES.md,
+  раздел 0.38.0 «Как обновить приложение».
+
+## 0.37.0
+
+### Minor Changes
+
+- 7f49d12: Провайдера можно скрыть из меню выбора модели: поле `hiddenFromMenu: true` в фабриках `createOpenRouterProvider`,
+  `createTogetherProvider`, `createFireworksProvider`, `createDeepSeekProvider` (и в описании провайдера, собранного
+  вручную). Скрытого и его моделей нет в `GET {base}/models` и в выборе чата; `PUT /:id/model` на него отказывает, как на
+  неизвестного. Как `defaultChoice` и запасной в `providerFallback` он работает как обычный провайдер. Одно правило: скрытый
+  выбор в чате равен выбору по умолчанию. Чат с сохранённым скрытым провайдером идёт на выборе по умолчанию (запись в базе
+  не меняется); `importChat` с моделью скрытого провайдера не падает, а заводит чат без своего выбора; запомненный человеком
+  скрытый выбор не попадает в новые чаты (`openSubjectChat`). Если сам `defaultChoice` у скрытого, `GET /models` отдаёт его
+  как есть и добавляет `defaultChoice.details` (названия, картинки, уровни); `useModelChoice` показывает его текущей моделью,
+  выбрать вручную нельзя. Запасной по умолчанию и переход при молчании могут идти на скрытого. Подключение через прокси (`connectProviders`) флаг не теряет. Не boolean — ошибка при сборке каталога.
+  
+  ```ts
+  extendCatalog(standardCatalog, {
+    addProviders: [createOpenRouterProvider({ id: "or-fastest", sort: "throughput", hiddenFromMenu: true })],
+  });
+  ```
+  
+  Базовый `openrouter` прятать подменой `apiKeyEnv` больше не нужно: `createOpenRouterProvider({ hiddenFromMenu: true })`.
+- ea78982: **Ломает приложения:** изменения памяти больше не доходят в уже идущий чат на каждом ходе — они придут, когда память прочитается заново (новый чат, сжатие истории и случаи ниже).
+  
+  Память теперь ведёт себя как файл правил в Claude Code: читается один раз на чат. В идущем чате ядро не зовёт
+  `snapshot()` и `blocks()` памяти и не досылает модели ни новых, ни изменённых записей, ни строки «Больше не действует»
+  про удалённые. Запись, сделанную самим агентом, он видит в переписке как вызов инструмента.
+  
+  Память читается заново: в новом чате; после сжатия истории (целиком, новые факты не теряются); при смене начала
+  истории — правке первого сообщения или «Переделать» первого ответа; в первом личном ходе после группового (групповой
+  ход память не читает); в ходе после сбоя чтения памяти. Чат из прошлой версии перечитает память один раз, при первом
+  ходе после обновления. Дата, место на экране и блоки `agent.contextBlocks` досылаются припиской,
+  как раньше. В служебной части ответа `data-frozen-context` новое необязательное поле `memoryFrom`.
+  
+  ### Как обновить приложение
+  
+  1. Код менять не нужно: типы и настройки прежние.
+  2. Если приложение рассчитывало, что правка памяти на экране памяти или запись из другого чата сразу дойдёт до модели
+     в открытом чате, — теперь она дойдёт в новом чате. Нужна в идущем чате — дайте человеку начать новый чат или сожмите
+     историю (`service.compactNow(ownerId, chatId)`).
+  3. Свои тесты, которые ждут приписку памяти во втором ходе того же чата, поправьте: приписки больше нет; проверяйте
+     новый чат.
+  4. Своя обёртка памяти (`LongTermMemory`) с подсчётом вызовов `snapshot()`/`blocks()` на каждый ход: теперь вызов один
+     на чат и после сжатия.
+  5. Проверка: `pnpm typecheck` и тесты проходят; в новом чате модель видит свежую память.
+
+## 0.36.0
+
+### Minor Changes
+
+- 3487fb4: Публичному посетителю можно не показывать кухню агента. Новые права в `chatCapabilities`: `reasoning` (мысли модели) и
+  `toolDetails` (служебные инструменты). По умолчанию оба `true` — всё как раньше.
+  
+  - При запрете мысли и вызовы служебных инструментов (вход, выход, запрос подтверждения) не уходят в браузер: ни в историю
+    (`GET`, `getHistory`, `peekHistory`, `selectBranch`), ни в поток ответа, ни в повтор кусков после переподключения
+    (`GET …/stream`). Из метаданных ответа пропадает `reasoningDurationsMs`, у текста и вызовов — детали рассуждений
+    OpenRouter (`providerMetadata.openrouter.reasoning_details`).
+  - Модель, хранилище, `afterTurn`, сжатие и поиск по истории получают ответ целиком.
+  - Виджеты (`agent.widgets`) и браузерные инструменты видны всегда. Свой инструмент с карточкой на экране пометьте в его
+    описании — `metadata: { showOnScreen: true }` (поле AI SDK, модели не уходит). Метка записывается в каждый вызов
+    (`toolMetadata`), поэтому работает и для набора инструментов функцией от модели. Вызовы, записанные до пометки, метки
+    не имеют и при запрете скрыты.
+  
+    ```ts
+    const showCard = tool({ description: "Карточка тарифа", inputSchema, metadata: { showOnScreen: true }, execute });
+    createChatServer({
+      agent: { instructions, tools: { show_card: showCard, lookup } },
+      chatCapabilities: ({ userId }) => (isVisitor(userId) ? { reasoning: false, toolDetails: false } : {}),
+    });
+    ```
+  
+  - Права считаются на того, кто открыл поток, в момент открытия.
+  - Вызов, который спросил подтверждения (`needsApproval`), виден сам, без пометки: иначе человек не увидит вопроса и ход
+    зависнет. Вызов того же инструмента без вопроса скрыт.
+  - Свои тесты, которые сравнивают `capabilities` истории целиком, получат два новых поля `reasoning` и `toolDetails`.
+  
+  Ломает типы: тип ChatCapabilities получил новые обязательные поля, литералы надо дополнить.
+- 8c43b86: `importChat` переносит состояние чата и закрытие. Новые поля `chat.state` (JSON-объект, как его отдаёт
+  `getChatState().values`) и `chat.closed` (`{ code, message }`, как у `closeChat`). Сразу после импорта `getChatState`,
+  `model.state` и экран (`data-app-state`) видят состояние, закрытый чат закрыт: отправка — `ChatClosedError` (409
+  `chat_closed`), правка открывает новую ветку. Состояние пишется служебным сообщением перед перенесённой
+  историей: его видят все ветки («Переделать», правка любого сообщения, даже первого). История для браузера этого сообщения
+  не показывает, его записи приходят в начале первого сообщения; модель его не получает. Закрытие — частью последнего
+  сообщения: правка открывает новую ветку. Вызовы инструментов не переносятся.
+  
+  ```ts
+  await service.importChat({
+    ownerId,
+    chat: { state: { fields: { email: "a@b.ru" }, step: 3 }, closed: { code: "form_completed", message: "Заявка отправлена." } },
+    messages,
+  });
+  ```
+  
+  Ошибки до записи: не объект, верхний ключ на `$` (служебный; закрытие — только `chat.closed`), не простой JSON —
+  `TypeError`; верхний ключ больше 16 КБ или всё состояние больше 256 КБ — `AppStateTooLargeError`; неверный код
+  закрытия — `TypeError`. Своё хранилище менять не нужно.
+- 6f42418: Свой срок молчания модели у провайдера. Фабрики `createOpenRouterProvider`, `createTogetherProvider`,
+  `createFireworksProvider`, `createDeepSeekProvider` (и любое `ProviderConnection`) принимают поле
+  `modelSilenceTimeout` в том же виде, что `agent.modelSilenceTimeout`. Заданные сроки перекрывают общие, пропущенные
+  берутся из общих, `false` — без сроков. Срок действует на каждую попытку у этого провайдера, в том числе после перехода
+  на него запасным (`providerFallback`). Подключение через прокси (`connectProviders`) срок не теряет. Запрос к модели не
+  меняется.
+  
+  ```ts
+  extendCatalog(standardCatalog, {
+    addProviders: [
+      createOpenRouterProvider({ id: "or-together", only: ["together"], modelSilenceTimeout: { firstChunkMs: 3_000 } }),
+      createOpenRouterProvider({ modelSilenceTimeout: { firstChunkMs: 30_000 } }),
+    ],
+  });
+  ```
+  
+  Неверный срок — ошибка при сборке каталога, например «OpenRouter: modelSilenceTimeout.firstChunkMs: ждём число мс…».
+  Провайдер, собранный вручную и добавленный через `extendCatalog`, проверяется так же.
+- 5f13c74: Поправку к идущему ответу можно запретить правом `steer` в `chatCapabilities`. Раньше `POST …/steer` принимался, даже
+  если экран прятал поправку (`steering={false}`). Теперь при `steer: false` сервер отвечает 403
+  `{ error: { kind: "action_forbidden", action: "steer", … } }` до любой записи, `service.steer` бросает
+  `ActionForbiddenError`, а `<AgentChat>` не предлагает поправку и ждёт конца ответа. По умолчанию право `true`.
+  
+  ```ts
+  chatCapabilities: ({ userId }) => (isVisitor(userId) ? { steer: false, edit: false, regenerate: false, branches: false } : {}),
+  ```
+  
+  Свои тесты, которые сравнивают `capabilities` истории целиком, получат новое поле `steer`.
+  
+  Ломает типы: тип ChatCapabilities получил новые обязательные поля, литералы надо дополнить.
+
+## 0.35.0
+
+### Minor Changes
+
+- 2382026: **Ломает приложения:** память, сегодняшняя дата и место на экране больше не переезжают в последний вопрос на каждом
+  ходе. Они вписываются в вопрос того хода, где их прочитали, и дальше не меняются; набор хода хранится служебной частью
+  ответа `data-frozen-context`.
+  
+  Что изменилось. Раньше блок памяти, дата и место стояли в конце последнего вопроса и на следующем ходе уезжали из него.
+  Из-за этого всё после старого вопроса (рассуждения, вызовы инструментов, их результаты) каждый ход читалось заново, мимо
+  кэша модели. Теперь блоки застывают там, где их показали, как в Claude Code. Следующий ход побайтно начинается с
+  последнего шага прошлого и читает всю переписку из кэша.
+  
+  - **Изменения — только припиской.** В новый вопрос идут только изменившиеся блоки целиком и одна строка
+    `[Больше не действует: «ключ»]` про пропавшие. Ничего не менялось — вопрос без приписки.
+  - **Удалённая запись памяти** остаётся в старом вопросе, а в новом модель видит, что она больше не действует.
+  - **Запись, не влезшая в лимит памяти** (`maxBlockChars`), не считается удалённой. Модель, которая её уже видела,
+    получает строку `[Не показано ради места, но по-прежнему действует: «ключ»]` и находит её поиском. Так может любой
+    источник: элемент `{ key, hidden: true }` в списке блоков значит «блок есть, но не показан». Новый тип
+    `ContextBlockEntry = ContextBlock | HiddenContextBlock`.
+  - **Продолжение хода** (после подтверждения инструмента, автопродолжение, запасной провайдер, «Повторить») берёт блоки
+    из ответа и память заново не читает. Инструменты при этом получают свежее место (`model.place`), а модель видит
+    застывшее.
+  - **Память по записям.** `createLongTermMemory` отдаёт память блоками: шапка `<agent_memory>` (ключ `memory`) и по блоку
+    на запись (`memory:<id>`). Правка одной записи стоит одной строки, а не всего блока. Своя память может делать так же
+    через необязательный `LongTermMemory.blocks?({ userId, chatId })`; без него — один блок из `snapshot()`, как раньше.
+    Обёртка памяти в песочнице пробрасывает `blocks`. Счётчик «Показано агенту: N из M» считает записи, которые уходят
+    модели блоками.
+  - **Блоки приложения — `agent.contextBlocks`** (новое, по желанию). Приложение отдаёт список `{ key, text, private? }`:
+    скиллы, роль, правила. Он вписывается в вопрос после памяти и даты по тем же правилам:
+  
+    ```ts
+    agent: {
+      instructions,
+      contextBlocks: async ({ chatId, ownerId, chat, audience, abortSignal }) => [
+        { key: "skills", text: `Скиллы агента: ${await skillsOf(ownerId, { signal: abortSignal })}` },
+      ],
+    }
+    ```
+  
+    - Вход: `chatId`, `ownerId`, `messageId`, `chat.data`, `subject`, `channel`, `audience`, `staff`, `modelId`,
+      `providerId`, `abortSignal`. Данные и объект чата — копии.
+    - `private: true` — блок не показывается в групповом ходе (`audience: "group"`).
+    - Ключи `memory`, `memory:*`, `today`, `screen_place` заняты ядром. Такой блок, повтор ключа и пустой текст
+      отбрасываются, в `logError` строка `[блоки контекста] … отброшен`.
+    - `agent.contextBlocksTimeoutMs` — срок функции, по умолчанию 5000 мс; 0 или `Infinity` — без срока, иначе от 1000.
+      Не ответила или бросила — блоки приложения берутся из прошлого ответа чата, в `logError` строка
+      `[блоки контекста] … не ответил за N мс`. «Стоп» отменяет функцию сразу, без строки.
+    - Новые типы `ContextBlock`, `ContextBlocksInput`, `ContextBlocksSource`, `HiddenContextBlock`, `ContextBlockEntry`.
+  - **Кэш шагов у моделей с явными метками** (Claude, Gemini через OpenRouter). Со второго шага хода метка кэша стоит на
+    конце шага, до снимка `stepContext` и служебных пометок. Меток в запросе не больше трёх: инструкция, последнее
+    сообщение истории, конец шага. У провайдеров с автоматическим кэшем (DeepSeek, Fireworks, Together, GPT напрямую)
+    меток нет и запросы без лишних байтов. У Gemini через OpenRouter метка на самом конце запроса не работает (OpenRouter
+    её пропускает), поэтому у моделей `google/` она стоит на предпоследнем сообщении: конце прошлого хода или вызове
+    инструмента. У Claude через OpenRouter шаги с инструментами теперь пишутся в кэш (запись
+    дороже входа на 25%, при `cacheTtl: "1h"` — вдвое), а следующий ход читает их по цене чтения.
+  - **Журнал промахов кэша** (`[промах кэша]`) сравнивает первый шаг хода с последним шагом прошлого хода, без его
+    концовки (снимок, пометка попытки, пометка «подведи итог»).
+  - **Служебная часть `data-frozen-context`** не уходит в поток, историю (`getHistory`), `afterTurn` (`TurnResult.parts`) и
+    поиск по истории. Константа — `FROZEN_CONTEXT_PART_TYPE`. Миграций базы нет. Старый чат: первый ход после обновления
+    кладёт полный набор блоков в свой вопрос, прошлые вопросы остаются как были.
+  
+  ### Как обновить приложение
+  
+  1. Найдите места, где приложение читает ответы прямо из хранилища (`storage.listMessages`, `storage.getMessage`, свой
+     SQL по таблице сообщений) и разбирает части ответа: показ, выгрузка, подсчёт, `parts[0]`. Теперь первой частью
+     ответа стоит служебная `data-frozen-context`. В ней память человека, дата и место, показывать её нельзя. Пропускайте
+     её:
+  
+     Было:
+  
+     ```ts
+     const parts = message.parts;
+     ```
+  
+     Стало:
+  
+     ```ts
+     import { FROZEN_CONTEXT_PART_TYPE } from "@ykurilov/agent-chat-core";
+  
+     const parts = message.parts.filter((part) => part.type !== FROZEN_CONTEXT_PART_TYPE);
+     ```
+  
+     `service.getHistory`, поток, `afterTurn` и `@ykurilov/agent-chat-history-search` её уже не отдают: там ничего делать
+     не нужно.
+  2. Если у приложения есть свои тесты, которые сравнивают запрос к модели или его снимок (где стоит `<agent_memory>`,
+     «Сегодня: …», `<screen_place>`), обновите их. Блоки теперь в вопросе того хода, где их прочитали, а не в последнем
+     вопросе. Проверьте, что разница в снимке только в этом переносе.
+  3. Если приложение подставляло в вопрос свои сведения на каждом ходе (скиллы, роль) через инструкцию или `stepContext`,
+     а они меняются редко, перенесите их в `agent.contextBlocks`: кэш модели перестанет сбрасываться. Шаг по желанию.
+  4. Своя реализация `LongTermMemory` работает без правок. Если записей много и они часто меняются, добавьте метод
+     `blocks({ userId, chatId })`, который возвращает `[{ key: "memory", text: шапка, private: true }, { key: "memory:<id>",
+     text: запись, private: true }, …]`. Шаг по желанию.
+  5. Проверка. Временно запишите в `afterTurn` расход хода:
+  
+     ```ts
+     afterTurn: ({ messageId, usage }) => console.log("кэш", messageId, usage?.cachedInputTokens, "из", usage?.inputTokens),
+     ```
+  
+     В одном чате с моделью, которая сообщает о кэше (Claude или Gemini через OpenRouter, DeepSeek), задайте вопрос, на
+     который агент вызовет инструмент, и через полминуты — второй вопрос. Ожидается: на втором ходе `cachedInputTokens`
+     не меньше входа последнего шага первого хода, то есть почти весь вход прочитан из кэша. Строк `[промах кэша]` в
+     журнале сервера (`logError`) нет. На экране служебных блоков нет, агент помнит записи памяти.
+
+## 0.34.0
+
+### Minor Changes
+
+- d039ce4: Поправка на лету: человек пишет агенту, пока тот отвечает, и не ждёт конца ответа и не жмёт «Стоп».
+  
+  Что это для человека: поле ввода во время ответа свободно, «Стоп» рядом с «Отправить». Поправка сразу видна в ленте с пометкой
+  «Агент учтёт на следующем шаге». Агент берёт её после очередных вызовов инструментов и продолжает с её учётом; сделанное до
+  поправки остаётся. Ответ кончился раньше — поправка запускает новый ход. Несколько поправок — все, по порядку. «Стоп» поправку
+  не теряет. Поправка хранится в базе и видна после обновления страницы.
+  
+  Новое:
+  
+  - ядро: `service.steer(userId, chatId, message, { page? })` → `{ status: "queued" | "started", messageId }`; в истории `pendingMessages`
+    (ждущие поправки); `isCorrection`, `STEER_PART_TYPE`, тип `SteerResult`; повтор с тем же `message.id` — тот же итог без второй копии;
+  - сервер: `POST …/:id/steer` `{ message, place?, tabId? }` → `202`;
+  - react: проп `steering` у `AgentChat` (включено, если скин рисует поправки; `false` — выключить), опция `steering` у
+    `useAgentChat` (по умолчанию выключено), у него же `canSteer`, `corrections`; надпись `steeringPending`
+    (русская по умолчанию, английская в `englishWorkLabels`);
+  - договор скина 21: `ChatSkin.steering?`, `Composer.canSteer?`, `UserMessage.pending?` ([docs/skin-v21.md](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/skin-v21.md));
+  - Тандем: во время ответа «Остановить» рядом с «Отправить» в рамке поля, пометка под ждущей поправкой. На узком экране
+    кнопка голосового режима на время ответа прячется, чтобы ряд не вылез за край.
+  
+  ### Как обновить приложение
+  
+  Обязательных шагов нет: со скином Тандема поправки включаются сами, свой скин и своя лента работают как раньше.
+  
+  1. Проверьте, что `@ykurilov/agent-chat-server` обновлён вместе с `@ykurilov/agent-chat-react`: старый сервер не знает `POST …/steer`,
+     и поправка вернётся в поле с ошибкой.
+  2. Свой словарь надписей (полный объект, не поверх `russianLabels`) — добавьте `steeringPending`. Без неё будет русская надпись по умолчанию.
+  3. Свой скин: без `steering: true` поле во время ответа занято, как раньше, — поправок у людей не будет. Чтобы были, поддержите
+     `Composer.canSteer` и `UserMessage.pending` и поставьте в скин `steering: true` по [docs/skin-v21.md](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/skin-v21.md).
+  4. Своя лента на `useAgentChat`: включите `useAgentChat({ steering: true })`, рисуйте `corrections` после `messages`, пометкой — `steeringPending`.
+  5. Несколько копий сервера: поправка принимается копией, на которой идёт ответ (как «Стоп»), иначе `409 busy`. Держите запросы
+     одного чата на одной копии.
+  6. Не нужно со скином Тандема — `<AgentChat steering={false} />`.
+  7. Проверка: `pnpm typecheck`; в чате во время долгого ответа отправьте поправку — она видна с пометкой, затем агент отвечает с её учётом.
+
+## 0.33.0
+
+### Minor Changes
+
+- 4a72339: У провайдера OpenRouter появилась настройка `cacheTtl`: часовой кэш Anthropic (Claude через OpenRouter) вместо пятиминутного.
+  
+  Что это: метки кэша получают `ttl: "1h"` — на инструкции, на последнем сообщении истории и перед блоками памяти и места (срок один на все метки: Anthropic не принимает часовую метку после пятиминутной). По умолчанию (`"5m"` или без настройки) метки без срока и запросы приложения не меняются ни на байт. Запись в часовой кэш дороже (у Anthropic 2× цены входа вместо 1.25×), чтение стоит столько же. Выгодно, когда между ходами чата больше 5 минут. Неверное значение — ошибка при создании провайдера. Настройка сохраняется при `connect()` и `connectProviders`.
+  
+  Обновление ничего не требует. Чтобы включить часовой кэш:
+  
+  1. В каталоге моделей приложения замените провайдера OpenRouter:
+  
+     ```ts
+     const catalog = extendCatalog(standardCatalog, {
+       addProviders: [createOpenRouterProvider({ /* прежние настройки */ cacheTtl: "1h" })],
+     });
+     ```
+  
+  2. Если нужна цена записи, поставьте в `pricing` профиля модели `cacheWritePerMillion` под часовой срок (2× цены входа у Anthropic).
+  3. Проверка: `pnpm typecheck`; во втором запросе чата после паузы дольше 5 минут в usage есть прочитанный кэш (`cachedInputTokens`).
+
+## 0.32.0
+
+### Minor Changes
+
+- 71c32b7: **Ломает приложения:** данные чата с символом NUL (`\u0000`) теперь дают `TypeError`, раньше SQLite и память их принимали.
+  
+  Проверка одна для всех хранилищ: `createChat`, `openSubjectChat`, `importChat`, `updateChatData` и фильтр
+  `listChats({ data })`. Она касается и ключей, и строк на любой глубине. Раньше на PostgreSQL один такой чат ломал
+  поиск по данным во всём списке чатов человека, а SQLite и память молча хранили NUL.
+  
+  ### Как обновить приложение
+  
+  1. Найдите в коде приложения места, где в данные чата попадает текст снаружи (формы, мессенджеры, импорт): поиск
+     по `createChat(`, `openSubjectChat(`, `importChat(`, `updateChatData(` и `listChats(` с полем `data`.
+  2. Перед записью уберите из таких строк символ NUL.
+  
+     Было:
+  
+     ```ts
+     await chat.updateChatData(userId, chatId, { title: form.title });
+     ```
+  
+     Стало:
+  
+     ```ts
+     await chat.updateChatData(userId, chatId, { title: form.title.replaceAll("\u0000", "") });
+     ```
+  
+  3. Если такой текст может прийти в ключах объекта, чистите и ключи.
+  4. Проверка: `pnpm typecheck` проходит; запись данных с `"a\u0000b"` в тесте приложения теперь падает с `TypeError`,
+     а с очищенной строкой проходит.
+- a94bda9: **Ломает приложения:** `insertMessage` хранилища в памяти (`createInMemoryChatStorage`) бросает ошибку, если чата нет.
+  
+  Раньше хранилище в памяти молча принимало сообщение в несуществующий чат, а PostgreSQL и SQLite отказывали. Тесты на
+  памяти пропускали ошибку, которая всплывала только на настоящей базе. Теперь все три хранилища ведут себя одинаково.
+  
+  ### Как обновить приложение
+  
+  1. Найдите в тестах приложения прямые вызовы `insertMessage` на хранилище из `createInMemoryChatStorage()`.
+  2. Перед первым сообщением создайте чат.
+  
+     Было:
+  
+     ```ts
+     const storage = createInMemoryChatStorage();
+     await storage.insertMessage(message);
+     ```
+  
+     Стало:
+  
+     ```ts
+     const storage = createInMemoryChatStorage();
+     await storage.createChat({ id: message.chatId, ownerId: "anna", modelId: "m", providerId: "p" });
+     await storage.insertMessage(message);
+     ```
+  
+  3. Код, который пишет сообщения через службу чата (`createChatService`, `createChatHandler`), менять не нужно.
+  4. Проверка: тесты приложения проходят; ошибки `Чата … нет` в них не осталось.
+- 27f4b1e: Удаление чата стирает состояние его окон лимитов (окна области `chat`: начало скользящего окна, перенос перерасхода,
+  отправленные пороги). Раньше эти записи оставались в базе навсегда. Расход в журнале и окна человека и сервиса не трогаются.
+  
+  Новое: необязательный метод хранилища `deleteSpendingLimitStates(keys)` (есть в памяти, SQLite и PostgreSQL) и
+  необязательный `chatDeleted({ userId, chatId })` у `SpendingLimits` — служба чата зовёт его после удаления чата;
+  ошибка уходит в журнал сервера и удаление не отменяет.
+  
+  ### Как обновить приложение
+  
+  Ничего, если хранилище встроенное. Своё хранилище может добавить `deleteSpendingLimitStates`; без него записи окон
+  удалённых чатов просто остаются, как раньше.
+
+### Patch Changes
+
+- cae13bf: Удаление чата во время хода больше не зовёт `onStateChanged` с пустым состоянием. Раньше хвост хода мог прочитать
+  уже удалённый чат и сообщить приложению, что состояние стало пустым, как будто его стёрли.
+  
+  Обновление ничего не требует.
+- 4e44492: Итог фоновой задачи больше не остаётся без ответа агента. Раньше, если сообщение с итогом записалось, а запуск хода
+  сорвался, повторная доставка отвечала «уже доставлено», и агент молчал. Теперь повтор будит агента, если после этого
+  сообщения в чате ещё ничего нет.
+  
+  Обновление ничего не требует.
+- ac9b7d3: «Стоп» больше не теряется, пока ход ещё запускается. Раньше остановка, нажатая во время проверок перед ходом
+  (`beforeTurn`, лимит трат), отвечала «нечего останавливать», а ход потом шёл до конца. Теперь `stop` в это время
+  возвращает `true`, и ход останавливается сразу после старта; адрес `/stop` отвечает 202.
+  
+  Обновление ничего не требует.
+
+## 0.31.2
+
+No changes in this release.
+
+## 0.31.1
+
+No changes in this release.
+
+## 0.31.0
+
+No changes in this release.
+
+## 0.30.0
+
+No changes in this release.
+
+## 0.29.0
+
+No changes in this release.
+
+## 0.28.0
+
+### Minor Changes
+
+- 11c3c97: Состояние чата на ветке. Инструмент записывает данные разговора (поля анкеты, корзину, номер брони) в ответ агента рядом с
+  результатом вызова: `model.state.set("fields.email", "a@x.ru")`, `model.state.unset(path)`, `model.state.get(path?)`.
+  Состояние чата — сумма записей текущей ветки. Человек исправил старое сообщение или нажал «Переделать» — записи ушедших
+  ответов пропали из состояния; переключил ветку обратно — вернулись. Приложению для этого ничего делать не нужно.
+  
+  - Сервер приложения читает состояние: `service.getChatState(userId, chatId)` → `{ values, atMessageId }`.
+  - Запись — часть ответа `data-app-state` (`{ set: { path: value } }` или `{ unset: [path] }`). Модели не уходит, на экране
+    не рисуется, запрос к модели и кэш не меняет. Новых таблиц и миграций нет.
+  - Только значения, без прибавок: повтор вызова после сбоя ничего не задваивает. Сжатие истории и «Повторить» оборванного ответа
+    состояние не теряют.
+  - Запись до 16 КБ, всё состояние до 256 КБ — больше `AppStateTooLargeError` внутри инструмента (модель видит текст).
+    Неверный путь или не простой JSON (`Map`, `Date`, `NaN`, `Infinity`…) — `TypeError`. Ключи без точек, массивы
+    целиком: путь через строку или массив (`items.0`) — `TypeError`. После конца хода запись не принимается, строка в
+    `logError`.
+  - Верхние ключи на `$` — служебные ключи SDK: приложение их не пишет и не видит.
+  - Для своих частей и проверок: `foldAppState`, `loadBranchAppState`, `createAppStateWriter`, `appStatePart`,
+    `publicAppState`, `APP_STATE_PART_TYPE`; типы `AppStateAccess`, `AppStateValues`, `AppStateRecord`, `ChatState`.
+  - `AgentToolsModel.state` необязательное: вне хода (сжатие, фоновая задача) его нет. Тесты, собирающие
+    `AgentToolsModel` вручную, могут его не задавать.
+  
+  Обновление ничего не требует. Своя реализация `ChatService` (если есть) добавляет метод `getChatState`. Подробно и с
+  примером — `docs/in-product-agent.md`, раздел «Состояние чата на ветке».
+- d63ccaa: Ломает приложения: закрытие чата теперь запись на ветке, а не флаг навсегда. Человек исправил сообщение до точки
+  закрытия, нажал «Переделать» или перешёл на другую ветку — на новой ветке чат открыт. Вернулся стрелкой назад — снова
+  закрыт. Отправка, «Повторить», подтверждения и виджеты в закрытом чате по-прежнему запрещены (409 `chat_closed`).
+  
+  Плюс приложение узнаёт о смене состояния чата (`model.state`): на сервере — хук, на экране — проп и хук React.
+  
+  - **Сервер:** `onStateChanged({ ownerId, chatId, reason, state, previousState, atMessageId })` у `createChatServer` и
+    `createChatService`. Зовётся после хода и смены ветки (`reason`: `turn`, `editMessage`, `regenerate`, `retry`,
+    `selectBranch`, `editAnswer`), только если состояние сменилось. Ход его не ждёт. Вызовы одного чата — по очереди.
+    Сбой — повторы (`onStateChangedAttempts`, 3) в сроке (`onStateChangedTimeoutMs`, 30 000), потом строка в `logError`.
+    Доставка только пока сервер жив: упал между ответом и хуком — хук не позовётся, сверяйте по `getChatState`.
+  - **События:** `state-changed` `{ chatId, reason, state, atMessageId }` (вкладка получает через `watch`) и
+    `state-changed-failed`. `chat-closed` и `chat-reopened` теперь приходят и при смене ветки.
+  - **Экран:** `<AgentChat onStateChange={(state) => …} />` — после загрузки и при каждой смене, в том числе по ходу
+    ответа и из другой вкладки (событие `state-changed`). Внутри ленты — `useChatState()`, у `useAgentChat` — `chatState`. Тип `ChatStateValues`.
+  - **Ответ сохраняется в базу сразу после итога каждого инструмента**, а не раз в полсекунды: запись состояния
+    переживает падение сервера. Промежуточные результаты (`preliminary`) — по-прежнему раз в полсекунды.
+  - **Служебные ключи** состояния (`$…`) больше не уходят в браузер: ни в истории, ни в потоке ответа.
+  - **`getChatState` дешёвый:** читает только связи сообщений и записи состояния. SQLite и Postgres получили метод
+    `listMessagePartsOfTypes(chatId, types)`. Новых таблиц и миграций нет.
+  - **Колонка `closed`** в записи чата — копия закрытия текущей ветки для `listChats`. `chatCapabilities` (`chat.closed`)
+    и история берут закрытие с ветки. Не записалась копия — её дописывает следующее открытие истории.
+  - **Чаты, закрытые в 0.27,** остаются закрытыми. Перенос в запись ленивый, без миграции: запись появится при первой
+    правке, «Переделать», выборе ветки или правке ответа в этом чате.
+  - Ядро экспортирует `CLOSED_STATE_KEY`, `isStateMessage`, `publicAppStateParts`, `DEFAULT_STATE_CHANGED_ATTEMPTS`,
+    `DEFAULT_STATE_CHANGED_TIMEOUT_MS`, типы `StateChangedHandler`, `StateChangedInput`, `StateChangeReason`,
+    `MessagePartsLink`.
+  
+  ### Как обновить приложение
+  
+  1. **Закрытие должно быть навсегда** (нельзя уйти правкой или веткой): в настройках сервера (`createChatServer`)
+     добавьте права по закрытию.
+  
+     Было: ничего.
+  
+     Стало:
+  
+     ```ts
+     chatCapabilities: ({ chat }) =>
+       chat.closed ? { edit: false, regenerate: false, branches: false, answerEditing: false } : {},
+     ```
+  
+     Если `chatCapabilities` уже есть — допишите эту ветку в него. Если правка до закрытия вам подходит — шаг пропустите.
+  2. **`switch` по событиям чата** (`ChatEvent`, `service.events`) с проверкой полноты (`never`): добавьте ветки
+     `state-changed` и `state-changed-failed`.
+  3. **Своё хранилище** (не SQLite и не Postgres): ничего не обязательно. Для дешёвого чтения состояния добавьте
+     `listMessagePartsOfTypes(chatId, types)` → `[{ id, parentId, createdAt, parts }]` в порядке `listMessages`, только
+     части нужных типов. Общие тесты хранилища проверят его, флаг `partsOfTypes: "required"` делает его обязательным.
+     `setChatClosed` теперь пишет только копию для списка: без него закрытие работает, но список его не видит.
+  4. **Своя реализация `ChatService`** (заглушки в тестах): полей не прибавилось. Если вы проверяли, что правка или
+     «Переделать» в закрытом чате дают `ChatClosedError`, — теперь они идут.
+  5. **Таблица-копия состояния** (по желанию): `onStateChanged` с полной заменой записи —
+     `await db.upsertForm({ chatId, fields: state.fields ?? {} })`.
+  6. Проверка: `pnpm typecheck`; закройте чат инструментом, исправьте вопрос до закрытия — без шага 1 чат открыт, с
+     шагом 1 правка недоступна.
+- 6a2f903: Снимок перед каждым шагом модели: `agent.stepContext`. Приложение собирает текст (например, «что уже записано в
+  заявке и чего не хватает»), и он ложится сообщением человека в самый конец запроса шага — после результатов
+  инструментов. Инструмент записал поле на шаге 1 — на шаге 2 модель уже видит его в снимке. В историю снимок не пишется.
+  
+  ```ts
+  agent: {
+    instructions, // скажите здесь, что «Служебный снимок сервера» присылает сервер
+    stepContext: async ({ state, chat, stepNumber }) =>
+      `Служебный снимок сервера:\n${JSON.stringify({ saved: state.fields ?? {} })}`,
+  }
+  ```
+  
+  - Функция видит `state` (живое состояние ветки: записи прошлых шагов уже в нём, без служебных ключей), `stepNumber`
+    (номер шага во всём ответе, с нуля: после подтверждения счёт продолжается), `chatId`, `ownerId`, `messageId`,
+    `chat.data`, `subject`, `channel`, `audience`, `staff` (как у инструментов), `modelId`, `providerId`, `abortSignal`.
+    Данные и объект чата — копии. Текст целиком ваш.
+  - В групповом чате мессенджера (`audience: "group"`) снимок может уйти в ответ при всех: личного в нём не показывайте.
+  - `agent.stepContextTimeoutMs` — срок функции, по умолчанию 5000 мс; 0 или `Infinity` — без срока, иначе от 1000.
+    Не ответила — шаг без снимка, `abortSignal` отменён, строка `[снимок шага] … не ответил за N мс` в `logError`.
+    «Стоп» отменяет функцию сразу.
+  - Кэш модели цел: снимок на шаге один и всегда в конце, всё до него — те же байты, что на прошлом шаге. Метки кэша не
+    двигаются.
+  - Последний шаг хода: снимок, затем пометка «шаги кончились». В запросы сжатия, памяти и помощников снимок не идёт.
+  - `null` или пустая строка — шаг без снимка. Бросок — шаг без снимка, строка `[снимок шага]` в `logError`, ход идёт дальше.
+  - Живая проверка на всех парах стандартного каталога: провайдеры принимают сообщение человека сразу после результата
+    инструмента. Скажите модели в инструкции, что снимок присылает сервер: иначе осторожная модель изредка ему не верит.
+  - Журнал промахов кэша не считает снимок промахом.
+  - Новые типы `StepContext`, `StepContextInput`.
+  
+  Обновление ничего не требует: без `stepContext` запрос побайтно прежний. Подробно — `docs/in-product-agent.md`, раздел
+  «Состояние чата на ветке», «Снимок перед каждым шагом».
+- 189cba9: Проверка ответа виджета на сервере. Раньше ответ проверялся только схемой. Теперь приложение может проверить его с
+  доступом к своей базе («это время уже заняли»), отказать человеку своими словами, подменить ответ и записать состояние чата.
+  
+  ```ts
+  agent: {
+    widgets: {
+      custom: [
+        {
+          ...pickSlot, // виджет из общего файла; проверка — только на сервере
+          checkAnswer: async (answer, ctx) => {
+            const hold = await bookings.tryHold({ key: ctx.toolCallId, chatId: ctx.chatId, start: answer.slot });
+            if (!hold) return { refuse: "Это время уже заняли. Выберите другое." }; // виджет остаётся открытым
+            ctx.state.set("booking.holdId", hold.id); // ляжет в ответ вместе с результатом виджета
+            return { answer: { ...answer, holdId: hold.id } }; // подмена ответа; можно вернуть и undefined — принять как есть
+          },
+        },
+      ],
+    },
+  }
+  ```
+  
+  - Проверка зовётся после схемы, пока чат удержан за этим ответом. `ctx`: `ownerId`, `chatId`, `messageId`, `toolName`,
+    `toolCallId`, `input`, `subject?`, `chatData?`, `state` (запись, как `model.state`), `signal` (`AbortSignal`). Исходы: `undefined` — принять,
+    `{ answer }` — принять с заменой (её видят модель и экран; до 16 КБ, схемой не перепроверяется), `{ refuse }` — отказать
+    текстом до 300 знаков.
+  - Общая проверка для всех виджетов без своей, в том числе базовых (`ask_choice` и др.):
+    `agent.widgets.checkAnswer(call, answer, ctx)`, где `call` — `{ toolName, toolCallId, input }`.
+  - Отказ: служба бросает `WidgetAnswerRefusedError`, сервер отвечает `409 { error: { kind: "widget_answer_refused", code,
+    message } }` (новый вид в `HandlerErrorKind`), экран показывает текст под виджетом и оставляет виджет открытым; поле ввода и
+    `onTurnRefused` не трогает. Ничего не записано, повтор ответа возможен.
+  - Записи `ctx.state` принятого ответа ложатся частями `data-app-state` вместе с результатом виджета; отказ и исключение их
+    отбрасывают. `getChatState` и следующий ход видят их.
+  - Исключение проверки — ответ 500, ничего не записано, виджет открыт, в `logError` строка
+    `[виджет] ошибка проверки чат=… вызов=…` с именем ошибки, без её текста.
+  - Срок проверки (`agent.widgets.checkAnswerTimeoutMs`, по умолчанию 5 000 мс) — не сбой: служба бросает
+    `WidgetAnswerCheckTimeoutError`, сервер отвечает `504 { error: { kind: "widget_check_timeout", code, message } }` (новый вид
+    в `HandlerErrorKind`), ничего не записано, виджет открыт, в журнале строка `[виджет] отказ answer_check_timeout …`, а не
+    ошибка. Страница показывает под виджетом новую подпись `widgets.answerCheckTimeout` («Не удалось проверить ответ,
+    попробуйте ещё раз»; её можно переопределить в `labels`), у `WidgetFailureKind` новый вид `check_timeout`. Зависшая
+    проверка не держит чат занятым. Срок проверки держите заметно меньше `requestTimeoutMs` страницы (10 000 мс).
+  - `ctx.signal` (`AbortSignal`) срабатывает по сроку проверки и по «Стопу» в чате. После отмены служба ничего не пишет,
+    виджет остаётся открытым, но остановить работу приложения она не может: слушайте сигнал сами
+    (`fetch(url, { signal: ctx.signal })`). «Стоп» во время проверки — не сбой: служба бросает новую
+    `WidgetAnswerCheckAbortedError`, сервер отвечает `409 { error: { kind: "widget_answer_cancelled", code, message } }`
+    (новый вид в `HandlerErrorKind`), в журнале строка `[виджет] отказ answer_cancelled …`, страница тихо оставляет виджет
+    открытым, без надписи под ним.
+  - Чат закрыли (`closeChat`) во время проверки: ответ не пишется, служба бросает `ChatClosedError`, ждущий виджет закрывается
+    отказом, как при обычном закрытии.
+  - Для React: у `WidgetFailureKind` новый вид `answer_refused` (текст отказа в `text`). Скины, которые перебирают виды отказа
+    полным `switch`, добавляют ветку; готовый скин и `AgentChat` ничего не требуют.
+  - Без `checkAnswer` запрос к модели, хранилище и ответы сервера прежние.
+  
+  Обновление ничего не требует. Если приложение разбирает ответы сервера полным `switch` по `HandlerErrorKind`, добавьте
+  `widget_answer_refused`, `widget_answer_cancelled` и `widget_check_timeout`. Подробности и пример — `docs/widgets.md`, раздел «Проверка ответа на сервере».
+
+## 0.27.0
+
+### Minor Changes
+
+- d8341b2: Свои данные чата (`chat.data`) и защита таблиц SQLite. Приложения без новых опций работают как раньше: `subjectData` остался и равен `data`.
+  
+  - **`chat.data`** — JSON-объект до 16 КБ у любого чата (раньше такие данные были только у чатов объектов). Лежит в том же столбце `subject_data`: миграции нет, старые данные чатов объектов уже читаются как `data`. В браузер и в запрос к модели данные не уходят: кэш модели не меняется.
+  - **Новый чат:** `service.createChat(userId, { data })`. Из браузера: `createChatServer({ newChatData: ({ user, request }) => data })` — данные ставит сервер, браузер их не присылает. Вернули не объект — 500. Хранилище без `updateChatData` с `newChatData` — ошибка при создании обработчика; `createChat({ data })` на таком хранилище — та же понятная ошибка, данные молча не теряются.
+  - **Правка:** `service.updateChatData(userId, chatId, patch)` — сливает верхние ключи (ключ со значением `undefined` удаляется, `null` остаётся значением). Итог больше 16 КБ — `TypeError`, данные не меняются. Возвращает новые данные. Правка атомарная: две одновременные правки разных ключей не затирают друг друга. Новое значение видно со следующего хода. Верхний ключ `__proto__` в данных, правке и фильтре не принимается (`TypeError`): иначе значение тихо пропало бы при слиянии.
+  - **Список:** `service.listChats(userId, { data: { formId: "f1", mode: "test" } })` — чаты, у которых все указанные верхние ключи равны значениям. Значения только строка, число, булево или `null` (иначе `TypeError`); `1` и `"1"` — разные значения. Можно вместе с `subjects`. SQLite ищет через `json_each`, PostgreSQL — через `jsonb @>`.
+  - **Кто видит данные:** `beforeTurn` и `chatInstructions` — `chat.data`; инструменты — `model.chat.data` (в том числе при сжатии и у фоновых помощников); `afterTurn` — `turn.chatData` (данные на момент итога: правка посреди хода видна, и итог после перезапуска даёт то же). `chatCapabilities`, проверка виджета и `stepContext` получают `Chat` и тоже видят `data`.
+  - **Событие `chat-data-changed { ownerId, chatId }`** (без данных) для `onChatEvent`. Вкладке браузера оно не пересылается.
+  - **Своё хранилище:** добавьте необязательный метод `updateChatData(chatId, patch, { maxBytes })` (одна атомарная операция, возвращает чат или `null`; больше предела — `ChatDataTooLargeError`), `listChats(ownerId, { subjects?, data? })` и запись/чтение `data` (у старого кода — `subjectData`). Без `updateChatData` служба отвечает понятной ошибкой на `updateChatData` и `listChats({ data })`. Проверка — `describeChatStorageContract(…, { chatData: "required" })`.
+  - **Песочница:** в копии чата человека инструменты и `afterTurn` видят данные исходного чата, а не служебную обёртку копии; это верно и для обычного чата без ключа объекта (`subject` у него по-прежнему нет).
+  - **SQLite: защита от чужих таблиц.** Таблицы SDK не переименованы: SDK должен жить в своём файле. При открытии, до миграций, SDK смотрит, нет ли в файле чужих `chats` или `messages` (журнал миграций SDK не знает их). Тогда `createSqliteChatStorage` бросает `ForeignChatTablesError` с текстом «дайте SDK отдельный файл», файл не тронут. Если у приложения свои `chats`/`messages` в том же файле — укажите SDK другой `filePath`. Раздел «Где лежат данные SDK» — в README хранилищ.
+- 5e4ed28: **Что может сломаться:**
+  
+  - исчерпывающий `switch` по виду ошибки сервера (`HandlerErrorKind`) и виду отказа на экране (`AppRefusalKind`): новые значения `action_forbidden`, `chat_closed`, `chat_creation_refused`;
+  - исчерпывающий `switch` по причине `turnNotStarted` (`TurnNotStartedReason`): новое значение `chat_closed`;
+  - свой словарь надписей `ChatLabels`, собранный целиком: новое обязательное поле `chatListClosed`.
+  
+  Права человека в чате и закрытый чат. Приложение функцией `chatCapabilities` решает, что можно человеку: правка, «Переделать», «Повторить», ветки, выбор модели, правка ответа, список чатов, сжатие, файлы, голос. Чат можно закрыть из инструмента (`model.closeChat`) или из кода (`service.closeChat`, `reopenChat`): переписка видна, писать дальше нельзя. Хук `beforeCreateChat` решает, можно ли человеку завести новый чат. Без новых настроек всё работает как раньше. Подробно — [docs/in-product-agent.md](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/in-product-agent.md), разделы 9, 10 и 11.
+  
+  - Права: опечатка в названии права (`edits` вместо `edit`) — ошибка приложения (`TypeError`), а не молчаливый доступ. За один вызов службы права спрашиваются не больше раза.
+  - Закрытие побеждает паузу: если чат закрыт, пока ответ ждёт подтверждения или виджета, ждущие запросы закрываются отказом, как при «Стопе», и ответ считается законченным.
+  - Закрытие из инструмента записывается сразу при вызове: после падения сервера чат уже закрыт. Чат, закрытый во время проверки перед ходом, хода не начинает: 409 `chat_closed`, резерв приложения закрывается `turnNotStarted` с причиной `chat_closed`.
+  - Новый чат: `beforeCreateChat({ userId, origin? })` вернул `{ code, message }` — `POST {base}` отвечает `403 { error: { kind: "chat_creation_refused", code, message } }`, мессенджер (`/new`, первый чат) — текстом. Чаты объектов и импорт хук не спрашивают.
+  - `listChats` отдаёт `closed`: на экране и в `/chats` мессенджера у закрытого чата пометка.
+  - Сервер: запрещённое действие — `403 { error: { kind: "action_forbidden", action, code, message } }`, закрытый чат — `409 { error: { kind: "chat_closed", code, message } }`. Мессенджеры отвечают человеку текстом.
+  - Мессенджеры: голосовое при `voice: false` и файлы при `attachments: false` не скачиваются и не распознаются, `/chats` смотрит на `chatList`. Своя служба может реализовать необязательный `assertCapability`.
+  - Песочница: закрытие работает как в бою, а кнопка «Открыть чат снова» (`POST {sandboxBase}/chats/:chatId/reopen`, только админ) позволяет продолжить тест. Скину песочницы — необязательный `SandboxSkin.ChatReopen`, надписи `SandboxLabels.chatReopen` (необязательные); в Тандеме кнопка своя.
+  - Экран: кнопки по правам прячутся сами, после ответа 403 `action_forbidden` права перечитываются, закрытый чат блокирует поле и показывает текст закрытия. Голосовое сообщение при `voice: false` не уходит. Новое:
+    - `AppRefusalKind` — `chat_creation_refused`; `useChatList` — `onCreateRefused` и `creationRefusal`, `ChatWorkspace` отдаёт отказ в `onTurnRefused`;
+    - `ChatListEntry.closed` и `ChatListItemView.closed` — пометка закрытого чата в списке, надпись `chatListClosed` («Закрыт», обязательное поле `ChatLabels`);
+    - `reloadKey` у `AgentChat`, `useAgentChat` и `ChatWorkspace` — перечитать историю, когда чат изменили не через экран;
+    - `onChatUnavailable` у `AgentChat` — служебный колбэк для `ChatWorkspace`, приложению не нужен;
+    - `ChatWorkspace` при `chatList: false` не мигает списком: он появляется после первой истории (и при `chatList: true` — тоже с этой короткой задержкой) и потом не запрашивается;
+    - `onTurnRefused` получает новые виды отказов, `onChatAccessChange` сообщает права и закрытие, `ChatWorkspace` при `chatList: false` показывает только чат.
+  - Скин: договор v20 — необязательный `ChatClosedNotice` и необязательный `list` у `ChatListSkin.ChatWorkspace` ([docs/skin-v20.md](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/skin-v20.md)). Скин v19 работает без правок. В Тандеме — `TandemChatClosedNotice`.
+  - Хранилища: колонка `closed` у чатов, миграция SQLite и PostgreSQL применяется сама. Своё хранилище может реализовать необязательный `setChatClosed(chatId, closed | null)` и отдавать `closed` в `getChat`; общий тест — `describeChatStorageContract(…, { chatClosure: "required" })`.
+  
+  ### Как обновить приложение
+  
+  1. Найдите в коде приложения исчерпывающие `switch` по виду ошибки сервера чата, по `refusal.kind` из `onTurnRefused` и по `reason` в `turnNotStarted`. Искать: `kind: "turn_refused"`, `case "turn_refused"`, `case "access_refused"`, `HandlerErrorKind`, `AppRefusalKind`, `TurnNotStartedReason`, `case "busy"`.
+  2. Добавьте ветки для новых видов:
+  
+     Было:
+  
+     ```ts
+     switch (refusal.kind) {
+       case "turn_refused": return showLessonClosed(refusal.message);
+       case "access_refused": return showNoAccess(refusal.message);
+       default: { const never: never = refusal.kind; return never; }
+     }
+     ```
+  
+     Стало:
+  
+     ```ts
+     switch (refusal.kind) {
+       case "turn_refused": return showLessonClosed(refusal.message);
+       case "access_refused": return showNoAccess(refusal.message);
+       case "chat_closed":
+       case "action_forbidden": return; // чат уже показал текст сам
+       case "chat_creation_refused": return showToast(refusal.message);
+       default: { const never: never = refusal.kind; return never; }
+     }
+     ```
+  
+     В `switch` по `reason` в `turnNotStarted` добавьте `case "chat_closed":` рядом с `case "busy":`: резерв снимается так же.
+  
+  3. Свой словарь `ChatLabels`, собранный целиком (не поверх `russianChatLabels`): добавьте `chatListClosed: "Закрыт"`.
+  4. Своё хранилище чата (не SQLite и не PostgreSQL из SDK): если нужен закрытый чат, реализуйте `setChatClosed` и отдавайте `closed` в `getChat`. Без этого `closeChat` бросает ошибку, а инструменты не получают `model.closeChat`.
+  5. Проверка: `pnpm typecheck` проходит, чат открывается и отвечает.
+  
+  Заметка к 0.28: закрытие станет записью хода, и правка, «Переделать» и ветки в закрытом чате станут возможны. Чтобы сохранить нынешнее поведение, задайте права: `chatCapabilities: ({ chat }) => chat.closed ? { edit: false, regenerate: false, branches: false } : {}`.
+- e0bb519: Маршруты OpenRouter и переход на запасного провайдера посреди ответа.
+  
+  - **Маршруты OpenRouter.** `createOpenRouterProvider({ id, displayName, only, order, allowFallbacks, requireParameters })`.
+    Маршрут с `id` — отдельный провайдер каталога: например, `or-deepseek` только с хозяином `deepseek` и
+    `or-fireworks` только с `fireworks`. Он обслуживает те же модели, что `openrouter`: id моделей, цены, закреплённые
+    версии и отметка «видит картинку в результате инструмента» переходят сами. Своя запись модели для маршрута главнее.
+    Провайдер `openrouter` должен остаться в каталоге, иначе ошибка при сборке каталога. Маршруты попадают и в порядок
+    запасных провайдеров по умолчанию. С `order` сортировка `sort: "throughput"` по умолчанию больше не ставится; явный
+    `sort` остаётся. Один хозяин и в `only`, и в `ignore` — ошибка при создании; все хозяева `only` запрещены профилем
+    модели — понятная ошибка запроса.
+  - **Переход посреди ответа** (по желанию): `agent.providerFallback: { onSilence: "restart-step-on-next" }`. Модель
+    замолчала дольше `modelSilenceTimeout`, до первого куска или посреди ответа. Тогда шаг обрывается и начинается заново
+    у следующего провайдера списка `byModel`, без повтора у того же. Показанный текст шага стирается: клиент получает часть
+    `data-step-reset` («убрать всё от последней части `step-start`»). В сохранённом ответе и в запросе модели стёртого
+    нет. `useAgentChat` и мессенджеры убирают стёртое сами, и решения хука («Повторить», «Ответить заново») стёртого не
+    видят. Своя лента на сырых частях — `withoutResetSteps(parts)` из core или react. Ход с переходом сразу после `start`
+    присылает кусок `data-steps-may-reset` (только клиенту): мессенджер по нему держит части идущего шага в живом
+    сообщении до конца шага, а стёртый целиком текст заменяет фразой «Пишу ответ заново…».
+    Шаг, где инструмент уже получил вход целиком, не стирается: ответ продолжается у запасного.
+    `scope: "step"` — следующий шаг снова у основного провайдера (по умолчанию `"turn"`); только после перехода при
+    молчании, запасной по перегрузке остаётся до конца хода. Перегрузка у запасного ведёт к следующему за ним.
+    `maxSwitches` — переходов за ход, по умолчанию 1; каждый съедает шаг из предела шагов. Стёртый шаг оплачен и есть в
+    расходе хода и в записи после перезапуска сервера. Срок хода `turnTimeoutMs` идёт и во время перехода;
+    `maxOutputTokens` действует в каждом заходе; после начала `flush` новых заходов нет (`stopReason: "shutdown"`);
+    при «Стоп» или остановке службы перехода нет и показанное не стирается. В журнале сервера — строка
+    `[переход при молчании]`.
+  - **Остановка службы — для всех приложений.** С этой версии `flush` с первых мгновений ожидания идущих ответов
+    запрещает ходам новые заходы: к запасному провайдеру, автопродолжение, продолжение после сжатия. Ход, которому нужен новый
+    заход, кончается остановкой (`stopReason: "shutdown"`), даже без `onSilence`. Раньше такой ход мог начать новый
+    заход посреди остановки сервера.
+  
+  ### Как обновить приложение
+  
+  Ничего делать не нужно: без `onSilence` всё работает как раньше. Включить переход — `agent.providerFallback:
+  { byModel: { "deepseek-4.1-flash": ["or-fireworks"] }, onSilence: "restart-step-on-next" }` и маршруты в
+  `extendCatalog(..., { addProviders: [...] })`. Если лента строится на сохранённых или сырых частях без `useAgentChat` —
+  пропускайте их через `withoutResetSteps` (есть в core и в react). Если маршрут OpenRouter задаёт `order` и рассчитывал
+  на сортировку по скорости, задайте `sort: "throughput"` явно. Проверка: `pnpm typecheck`.
+
+## 0.26.2
+
+### Patch Changes
+
+- f24858a: Вопрос без ответа больше не сливается со следующим. Раньше, если ход падал сбоем модели до первых слов (или «Стоп»
+  приходился на рассуждение), следующее сообщение человека склеивалось с прежним в одно: модель читала
+  «Первое сообщениеВторое сообщение» как один вопрос.
+  
+  Теперь в запросе к модели это два отдельных сообщения человека, а между ними — ответ модели с постоянной пометкой
+  `[Ответа на это сообщение нет: ход оборвался до первых слов]`. Пометка только в запросе: в историю не пишется, человек
+  её не видит. Строгие провайдеры по-прежнему получают сообщения человека и модели по очереди.
+  
+  - **Кэш модели.** Пометка встаёт после вопроса без ответа и зависит только от истории: на каждом ходе те же байты, уже
+    отправленное начало запроса не меняется. Один раз после обновления изменится запрос только у тех чатов, где такая
+    склейка уже была, — один промах кэша на чат.
+  - **«Повторить» после сбоя** — как раньше: ответ на тот же вопрос, он в запросе один раз, пометки нет.
+  - **Правка.** Правка следующего сообщения оставляет вопрос без ответа и пометку перед ним. Правка самого вопроса без
+    ответа начинает ветку до него — ни его, ни пометки в запросе нет.
+  
+  **Что сделать в приложении:** ничего, достаточно обновить пакеты. Отдельный метод «отменить неотвеченное» не понадобился:
+  «Повторить» уже отвечает на тот же вопрос, а правка вопроса без ответа убирает его из ветки.
+
+## 0.26.1
+
+No changes in this release.
+
+## 0.26.0
+
+### Minor Changes
+
+- eb43e47: Пределы хода и честная остановка сервера. Без новых опций запрос к модели прежний. Поменялось одно: `flush()` теперь
+  закрывает идущие ответы как «Стоп», а не оставляет их «идущими» до следующего старта.
+  
+  - **Общий срок хода** — `agent.turnTimeoutMs`: число мс или `{ default?, byModel? }`. Срок вышел — ход останавливается,
+    как по «Стопу»: написанное цело, `status: "stopped"`, а `afterTurn` получает `stopReason: "timeout"`. «Стоп» человека —
+    `stopReason: "user"`, остановка сервера — `"shutdown"`. 0 или `Infinity` — без срока. Иначе от 1000 до 2³¹−1. Модель из
+    `byModel`, которой нет в каталоге, — ошибка при создании службы. Не задано — без срока. Срок считается до записи итога:
+    `afterTurn` записанного ответа он не обрывает.
+  - **Предел токенов ответа** — `agent.maxOutputTokens`: целое от 1 или `{ default?, byModel? }`. Уходит провайдеру в каждом
+    запросе к модели (в каждом шаге хода). Ответ упёрся — `afterTurn` получает `lengthCut: true`. Не задано — предела в
+    запросе нет, кэш модели не меняется.
+  - **`turnNotStarted`** — новый хук службы и `createChatHandler`: `({ userId, chat, action, messageId?, text?, reason })`. Он
+    зовётся, когда `beforeTurn` пропустил ход, а ход не начался. Причины: `busy`, `too_many_turns`, `spending_limit`,
+    `duplicate_message`, `invalid`, `no_turn`, `error`. Каждый пропуск `beforeTurn` закрывается ровно одним: `afterTurn`
+    начатого хода или `turnNotStarted`. Так резерв приложения больше не повисает. Ответ клиенту прежний (409, 429…), бросок
+    хука уходит в `logError`. Порядок проверок прежний: отказ приложения (403) по-прежнему приходит раньше «занято» (409).
+  - **`beforeTurn` получает `messageId`** — id сообщения человека у `send` и `edit`.
+  - **`flush({ waitForAnswersMs })`** у службы, `createChatHandler` и песочницы. Пока идёт остановка, новые ходы не
+    начинаются: чат занят. Идущие ответы ждутся до срока (по умолчанию 0). Не успевшие закрываются как «Стоп»: написанное
+    записывается, обрывков нет, `afterTurn` видит `stopReason: "shutdown"`. `flush` возвращается, когда все ответы записаны и
+    хуки `afterTurn` (в своём сроке), сжатие, память и фон закончены. Только после этого можно закрывать хранилище. Неверный
+    срок — `TypeError`. Остановленный ход, который за 10 с так и не записал итог (база висит), `flush` больше не ждёт:
+    строка в `logError`, ответ прервёт восстановление при следующем старте. Не прошла конечная запись — ответ помечен
+    брошенным, и любая копия прерывает его сразу, без ожидания порога.
+  - Новые типы: `TurnTimeoutSetting`, `MaxOutputTokensSetting`, `TurnNotStartedHandler`, `TurnNotStartedReason`,
+    `TurnStopReason`, `FlushOptions`. В `TurnResult` — `stopReason?`, `lengthCut?`.
+  
+  ### Как обновить приложение
+  
+  1. Остановка сервера (обработчик `SIGTERM`, где зовётся `chat.flush()`): дайте ответам доработать.
+  
+     Было:
+  
+     ```ts
+     server.close();
+     await chat.flush();
+     await storage.close();
+     ```
+  
+     Стало:
+  
+     ```ts
+     server.close();
+     await chat.flush({ waitForAnswersMs: 20_000 }); // ждёт ответы и afterTurn; не успевшие — «Стоп» с записью
+     await storage.close();
+     ```
+  
+     Без опций `flush()` тоже работает, но идущие ответы останавливаются сразу (`status: "stopped"`, раньше они становились
+     `interrupted` при следующем старте). Если приложение ждало `interrupted` после остановки, ждите `stopped` со
+     `stopReason: "shutdown"`.
+  2. Если `beforeTurn` резервирует что-то (попытку, деньги), снимайте резерв в `turnNotStarted`. Связать резерв с ходом
+     удобно по `messageId`:
+  
+     ```ts
+     beforeTurn: async ({ userId, messageId }) => { await reserveAttempt(userId, messageId); },
+     turnNotStarted: async ({ userId, messageId }) => { await releaseAttempt(userId, messageId); },
+     ```
+  3. По желанию задайте пределы хода в `agent`:
+  
+     ```ts
+     agent: { turnTimeoutMs: 180_000, maxOutputTokens: { default: 4_000, byModel: { "deepseek-4.1-flash": 2_000 } } },
+     ```
+  
+     В `afterTurn` отличайте `stopReason` (`user` / `timeout` / `shutdown`) и `lengthCut`.
+  4. Проверка: `pnpm typecheck` проходит. Остановите сервер посреди ответа: в базе ответ `stopped`, а `afterTurn` получил
+     `stopReason: "shutdown"`.
+
+## 0.25.0
+
+### Minor Changes
+
+- 99d426e: Приветствие по указанию: `greeting: { instruction }` в `createChat`, `openSubjectChat` и ответе `subjectChats`. При
+  создании чата SDK один раз будит агента служебным сообщением `conversation_started`, и агент пишет первым сам. Ровно одно
+  из `text` и `instruction`. Найденный чат не будится; сбой побудки — в `logError`, чат всё равно отдаётся.
+- d8201f6: Через OpenRouter модели видят картинку в результате инструмента: в профили вписан `openrouter` и запрещены хозяева модели,
+  которые её не видят или отвергают запрос (замер всех хозяев 2026-10-06, `specs/research-openrouter-tool-images.md`).
+  
+  - DeepSeek 4.1 Flash: `toolResultImageProviders: ["deepseek", "openrouter"]`; через OpenRouter запрещены `deepinfra`,
+    `open-inference`, `phala`, `sail-research`, `venice`.
+  - GLM 5.3 Flash: `toolResultImageProviders: ["openrouter"]` (раньше отметки не было); запрещены `cloudflare`, `deepinfra`,
+    `open-inference`, `sail-research`, `venice`.
+  - Gemini 3.8 Flash: запрещён `google-vertex` — на картинку из инструмента он отвечал ошибкой или пустым ответом. Остаётся
+    Google AI Studio.
+  - Запрет — в профиле модели (`providerOptions.openrouter.provider.ignore`) и стоит в каждом запросе: запрос одинаков от
+    хода к ходу, кэш модели не теряется.
+  - `createOpenRouterProvider` сливает маршрут из профиля со своими настройками: `maxPrice`, `sort` и т. п. сохраняются
+    (раньше маршрут из опций запроса затирал их целиком). Новая опция `ignore: string[]` — свой запрет хозяев; объединяется
+    с запретом модели.
+  
+  Обязательных действий нет, кроме шага 3 ниже. Инструменты, которые смотрят на `toolResultImageProviders` (снимок страницы в
+  `@ykurilov/agent-chat-web-tools`, свои флаги приложения вроде «модель видит картинки инструментов»), теперь включаются у
+  DeepSeek 4.1 Flash и GLM 5.3 Flash через OpenRouter сами.
+  
+  ### Как обновить приложение
+  
+  1. `pnpm update "@ykurilov/agent-chat-*" --latest`.
+  2. Если приложение для OpenRouter описывает картинку словами там, где профиль говорит «не видит», — ничего не делать:
+     решение по `profile.toolResultImageProviders?.includes(providerId)` само станет `true` для DeepSeek и GLM через OpenRouter.
+  3. Если приложение подменяло профиль модели своим `providerOptions.openrouter` (через `addModels`), сохраните в нём
+     `provider.ignore` из стандартного профиля, иначе запрет пропадёт.
+  4. Проверить: `pnpm typecheck`; в ходе через OpenRouter с картинкой в результате инструмента модель называет то, что на ней.
+
+## 0.24.0
+
+### Minor Changes
+
+- 9b895cd: Ломает приложения: только исчерпывающие `switch` по видам ошибок сервера и событиям чата (новые значения) и код, который
+  сам читает ответ `resolveUser`. Без новых настроек поведение прежнее.
+  
+  Агент внутри продукта: агент работает с объектами приложения — уроком, заказом, документом. Всё по желанию; без новых
+  настроек запрос к модели не меняется ни на байт. Подробно — `docs/in-product-agent.md`.
+  
+  - **Проверка перед ходом.** `beforeTurn({ userId, chat, action, text? })` отказывает своими словами: 403 `turn_refused`
+    до любых записей и лимитов, на отправке, правке, повторе, переделке, подтверждении, виджете, служебных сообщениях, фоновой
+    задаче и в мессенджерах. `resolveUser` может вернуть `{ refused: { code, message, status? } }` → `access_refused` на всех
+    адресах чата, голоса, голосового режима (WebSocket 4401) и мессенджеров. React: `onTurnRefused`, текст отказа вместо «нет
+    связи», сообщение возвращается в поле. Ручная проверка — `service.assertTurnAllowed`.
+  - **Итог хода.** `afterTurn(turn)` после каждого хода с повторами и сроком (`afterTurnAttempts`, `afterTurnTimeoutMs`),
+    переживает перезапуск сервера. `TurnResult`: владелец и автор хода, текст, части, расход, действие, канал, объект,
+    сотрудник. События приложения `{ type, data? }` — из хука, из инструмента (`model.emitAppEvent`) и вне хода
+    (`service.publishAppEvent`); в React `appEvents` и `onAppEvent`, события переживают перезагрузку. Модели не уходят.
+  - **Чат объекта.** Ключ и данные объекта у чата, один чат на ключ у человека: `service.openSubjectChat`, на сервере
+    `subjectChats` (`POST …/subject`), в React `<AgentChat subject="lesson:42" />`. Данные объекта видят `beforeTurn`,
+    инструменты (`model.subject`) и `afterTurn`; в браузер и модели не уходят.
+  - **Приветствие.** `greeting: { text }` — первое сообщение от агента без вызова модели. Проверено на всех моделях каталога.
+  - **Лимит сообщений.** Окно лимитов с `limitMessages` вместо `limitUsd`, `exemptUsers` — люди без лимитов,
+    `onMessageThreshold` — пороги. Отказ — 429 с `unit: "messages"`.
+  - **Импорт старой переписки.** `service.importChat({ ownerId, chat, messages })` с датами и картинками
+    (`attachments.importFile`), без хода, памяти, расхода и лимитов.
+  - **Сотрудник проверяет чат человека.** Песочница с опцией `people`: админ видит чаты человека только на чтение и
+    проверяет ответы в копии у себя. Память человека в копии только читается, расход — на админа, человек ничего не видит.
+    Инструменты приложения получают `model.staff` и в копии в данные человека не пишут.
+  - **Свои кнопки у поля ввода.** `composerActions` с помощником `{ value, setValue, send, addFiles, busy, blocked, canSend }`.
+    Договор скина v19: `Composer.actions`; скин v18 работает без кнопок, Тандем готов.
+  - **Хранилища.** Миграции применяются сами: SQLite `0015`, PostgreSQL `0014` (ключ объекта, состояние хука итога).
+  
+  ### Что может сломаться
+  
+  - **Исчерпывающие `switch` по закрытым спискам.** Новые значения: вид ошибки сервера `turn_refused` и `access_refused`
+    (`HandlerErrorKind`), события чата `after-turn-failed` и `app-event` (`ChatEvent`), `unit` у отказа лимита. Добавьте ветки
+    и надписи.
+  - **Список чатов без чатов объектов.** `listChats` и `GET {basePath}` по умолчанию не показывают чаты с ключом объекта.
+    Касается только приложений, которые начнут ими пользоваться; показать — `chatList: { subjectChats: true }` или
+    `listChats(userId, { subjects: "include" })`.
+  - **Свой `resolveUser` в обёртках.** Тип ответа — `ResolvedUser` (`{ id } | { refused } | null`). Код, который сам вызывает
+    `resolveUser` и читает `.id`, сначала проверяет `"refused" in user`.
+  - **Своё хранилище.** Для новых возможностей нужны необязательные методы (`findChatBySubject`, `importChat`,
+    `setAfterTurnState`, `listPendingAfterTurn`); без них эти возможности при включении дают ошибку при старте, остальное
+    работает. `listChats(ownerId, options?)` получил второй параметр — чаты с ключом скрывать по умолчанию.
+  - **Свой `ChatService`** (заглушки в тестах) добавляет новые методы: `openSubjectChat`, `importChat`, `assertTurnAllowed`, `peekHistory`,
+    `publishAppEvent`.
+  - **Своя реализация `SpendingLimits`** может добавить `takeMessage` — без него сообщения не считаются.
+  - **`AgentChat`: `chatId` стал необязательным** — нужен ровно один из `chatId` и `subject`; ни одного или оба — ошибка при
+    рендере. При смене `chatId` чат пересоздаётся: черновик и состояние прошлого чата не переносятся.
+  - **Окна лимитов: `limitUsd` стал необязательным** (у окна сообщений его нет). Код, который читает свои окна, проверяет
+    `limitMessages`.
+  - **Отказ сервера в React** (`ServerRefusal`) получил `kind` и `code`. 401 со словами приложения (`access_refused`) — это
+    отказ, а не «вход истёк».
+  - **«Пустой чат»** для «Нового чата»: чат объекта пустым не считается, обычный чат с одним приветствием — считается.
+  - Новый подпуть `@ykurilov/agent-chat-core/access` — помощники отказа в доступе для своих обработчиков.
+  
+  ### Как обновить приложение
+  
+  1. `pnpm up "@ykurilov/agent-chat-*@^0.24.0"`. Миграции базы применяются сами при открытии хранилища.
+  2. Исчерпывающие `switch` по `HandlerErrorKind` (сервер) и `ChatEvent` (`chatEvents` ядра): найдите их поиском и добавьте
+     ветки `turn_refused`, `access_refused`, `after-turn-failed`, `app-event`. Обязательных надписей не прибавилось: текст
+     отказа приходит с сервера. Свой словарь для лимита сообщений — необязательные `spendingMessagesLeft`,
+     `spendingMessagesExhausted`, `editMessageLimit`.
+  
+     Было: `switch (event.type) { case "tasks-changed": … case "notice-added": … default: assertNever(event) }`
+     Стало: те же ветки плюс `case "after-turn-failed": case "app-event": break;`
+  3. Свой код, который сам зовёт `resolveUser` и читает `.id`: сначала `if (user && "refused" in user) …`.
+  4. Ничего больше не нужно, если новые возможности не включать. Чтобы включить — `docs/in-product-agent.md`.
+  5. Свой скин: кнопки у поля появятся, когда `Composer` начнёт рисовать `actions` (договор v19, `docs/skin-v19.md`).
+  6. Проверка: `pnpm typecheck` без ошибок, чат открывается и отвечает как раньше.
+
+## 0.23.0
+
+No changes in this release.
+
+## 0.22.0
+
+No changes in this release.
+
+## 0.21.0
+
+### Minor Changes
+
+- 7c3bcc4: Картинки в файлы приложения и ход, который не ждёт картинку. Всё новое включается опциями: без них `createImageGeneration` работает как раньше.
+  
+  - `createImageQueue` — своя очередь картинок для инструментов приложения: заказ отвечает сразу, готовая картинка приходит в `deliver(image, job, ctx)`; `ctx.isCurrent()` и `ctx.signal` — картинка ещё нужна (запись файла делать условной). Задачи лежат в базе (`sqliteImageJobStore` из `@ykurilov/agent-chat-images/sqlite`, `postgresImageJobStore` из `/postgres`), переживают перезапуск сервера, расход пишется ровно один раз. Есть «Повторить» (`retry`), замена прежнего заказа на то же место (`key`), предел за ход, `stop()`.
+  - `createImageGeneration`: `deliver` — картинка приложению, а не во вложения; `mode: "background"` — инструмент отвечает сразу (с `jobStore`, `pollIntervalMs`, `attempts`, `onQueued`); `maxImagesPerTurn` — предел картинок за ход; `start()` и `stop()`.
+  - Ядро: `agent.tools(model)` получает `model.turnId` — номер хода, один на все попытки и запасного провайдера.
+  - Ядро: необязательный `ChatStorage.hasUsageRecord(id)` — есть ли запись расхода (память, SQLite, PostgreSQL). Своё хранилище может его не делать.
+  - Хранилища задач картинок: одна открытая задача на место (`ownerId` + `key`) — уникальный индекс; своё хранилище бросает `ImageJobKeyTakenError`.
+  - Экспорт `DEFAULT_REMOVE_BACKGROUND_PROMPT` — подсказка разделения фона.
+  - Защита денег: срок у каждого обращения к провайдеру, повторное скачивание того же адреса вместо нового заказа, второй шаг не оплачивает первый заново.
+  
+  Фоновый режим и очередь с базой: при остановке сервера до закрытия базы вызвать `await images.stop()` (или `imageQueue.stop()`).
+
+## 0.20.0
+
+### Minor Changes
+
+- fd16b01: Помощники, фоновые задачи и мессенджеры. Ничего не ломается: без новых настроек всё работает как раньше.
+  
+  - `agent.helpers` в `createChatHandler` / `createChatServer`: узкие агенты со своей моделью и инструментами; основной агент зовёт их как `helper_<имя>` и получает только итог. Человек видит все шаги помощника. Подробности: `docs/helpers.md`.
+  - `background` в `createChatHandler` / `createChatServer` принимает объект из нового пакета `@ykurilov/agent-chat-background`; тогда появляются адреса `{base}/:chatId/tasks` (список, отмена, ответ на подтверждение). Помощник с `background: true` без этого пакета — ошибка при запуске.
+  - `createChat(…, { origin })` помечает чат, созданный из мессенджера (`telegram`, `vk`, `max`); пометка видна в списке чатов.
+  
+  Что сделать в приложении: ничего обязательного. Хотите помощников — добавьте `agent.helpers`. Хотите фон или мессенджеры — поставьте новые пакеты `@ykurilov/agent-chat-background` и `@ykurilov/agent-chat-messengers` (см. их README).
+
+## 0.19.0
+
+### Minor Changes
+
+- fde2297: DeepSeek 4.1 Flash у провайдера DeepSeek видит картинку в результате инструмента (проверено вживую): в профиле появилась
+  отметка `toolResultImageProviders: ["deepseek"]`. Инструменты, которые смотрят на эту отметку (снимок страницы в
+  `@ykurilov/agent-chat-web-tools`), теперь доступны этой паре. Свой инструмент с картинкой — `toModelOutput` с частью
+  `{ type: "file", mediaType: "image/png", data }`, как у снимка страницы.
+  
+  Обновление ничего не требует. Живая проверка любой пары модель+провайдер с отметкой — `packages/core/tests/live/tool-result-images.live.test.ts`.
+- aa0fd51: Гибкие лимиты расходов. Вместо одного бюджета на месяц можно задать любой набор окон сразу: сутки, неделю или месяц по
+  часовому поясу (со своим днём начала недели), «N часов от первого запроса» или на всё время. Область окна — человек, чат или
+  весь сервис. Ход начинается, только если не исчерпано ни одно окно.
+  
+  - `createSpendingLimits({ windows: [...] })` вместо `budget` и `period`. Прежний `budget` работает как раньше (и получил
+    `period: "week"`).
+  - `carryOverrun: true` у окна: перерасход начатого хода переносится в начало следующего окна.
+  - `turn: { minRemainingUsd, maxCostUsd, maxToolCalls, overrun }` — запас на старт хода и потолки одного хода. На потолке
+    ход заканчивается итогом без новых вызовов инструментов.
+  - Человеку: свой лимит окна, блокировка (`setUserSettings`, `getUserSettings`) и ручной сброс окна (`resetWindow`).
+  - `onThreshold(event)` — событие при 80% и 100% лимита окна (пороги — `thresholds`), одно на порог в окне, проверка после
+    каждой записи расхода.
+  - `getSpending` отдаёт доллары по каждому окну (`windows`) и `blocked`.
+  - Сервер: в ответе 429 `spending_limit_reached` появились `reason` (`limit` | `blocked` | `reserve`), `windowId` и `hours`.
+    `GET …/spending` отдаёт `reason`, `windowId`, `hours`, `blocked` и список окон `windows` — только доли и время сброса,
+    без долларов.
+  - Браузер: надписи «на неделю», «на 5 ч» (с временем обновления), «сервиса», «Лимита … не хватит на новый ответ», «Новые
+    ответы для вас приостановлены». В `SpendingInfo` новые необязательные поля `hours`, `reason`, `windowId`, `windows`.
+  
+  Скользящим окнам, личным настройкам, сбросу и порогам нужны методы состояния хранилища: в памяти, SQLite и PostgreSQL они есть
+  (запись `storage-limit-state`). Подробно — README пакета `@ykurilov/agent-chat-limits`, раздел «Окна лимитов».
+  
+  **Ломает приложения:** только исчерпывающие проверки и свои словари по периоду. У `SpendingScope` появилось значение
+  `service`, у `SpendingPeriod` — `week` и `rolling` (в `@ykurilov/agent-chat-core` и `@ykurilov/agent-chat-react`).
+  
+  ### Как обновить приложение
+  
+  1. Поищите в приложении `SpendingPeriod`, `SpendingScope`, `info.period`, `info.scope` и `spendingWarning` / `spendingExhausted`
+     в своём словаре надписей. Если надпись строится по таблице периодов, добавьте новые значения:
+  
+     Было:
+  
+     ```ts
+     const periodPhrase = { month: " на месяц", day: " на день", none: "" };
+     ```
+  
+     Стало:
+  
+     ```ts
+     const periodPhrase = { month: " на месяц", week: " на неделю", day: " на день", none: "" };
+     const phrase = info.period === "rolling" ? ` на ${info.hours} ч` : periodPhrase[info.period];
+     ```
+  
+     То же для области: `info.scope === "service"` — лимит всего сервиса.
+  2. Свой словарь с `spendingExhausted`: учтите `info.reason` — `"blocked"` (человек заблокирован, `resetsAt` нет) и `"reserve"`
+     (остаток меньше запаса на старт хода).
+  3. Свой разбор ответа 429 или `GET …/spending` на сервере или в браузере: новые поля необязательные, старые на месте.
+  4. Ничего из этого нет в приложении — обновление ничего не требует.
+  5. Проверка: `pnpm typecheck` проходит; с исчерпанным лимитом чат показывает надпись и не даёт отправить сообщение.
+- 9f94dbe: OpenRouter: маршрутизация из настроек подключения. `createOpenRouterProvider` принимает `maxPrice` (потолок цены за миллион
+  токенов, за запрос и за картинку), `sort` (`throughput` по умолчанию, `price`, `latency` или `false`) и `stickyProvider`
+  (по умолчанию `true`: чат закреплён за одним хозяином модели заголовком `x-session-id`, кэш не теряется). Настройки
+  переживают переподключение через прокси.
+  
+  Обновление ничего не требует: без новых настроек запрос прежний, побайтно. Потолок цены — так:
+  
+  ```ts
+  extendCatalog(standardCatalog, {
+    addProviders: [createOpenRouterProvider({ maxPrice: { completionPerMillion: 1.3 } })],
+  });
+  ```
+- 2013f15: Цена модели теперь может зависеть от времени суток: в профиле появились часы пик (`pricing.peakHours`) — окна по дням недели
+  и часам со своим множителем, отдельный множитель для попаданий в кэш и даты-исключения. Каждый шаг хода считается по времени
+  своего запроса. DeepSeek 4.1 Flash у провайдера DeepSeek больше не считается всегда по пиковой цене: вне пика 0,15 / 0,60 / 0,003 $
+  за миллион токенов, по будням 01–04 и 06–10 UTC вдвое. Расход этой пары в лимитах в непиковые часы стал вдвое меньше — как в счёте DeepSeek.
+  
+  `costOfUsage(usage, price, at?)` принимает третьим параметром время запроса: без него — цена вне пика.
+  
+  Обновление ничего не требует. Своя модель с часами пик — по образцу:
+  
+  ```ts
+  pricing: {
+    myprovider: {
+      inputPerMillion: 0.15, outputPerMillion: 0.6, cachedInputPerMillion: 0.003, // цены вне пика
+      peakHours: { timeZone: "UTC", multiplier: 2, windows: [{ days: [1, 2, 3, 4, 5], from: "01:00", to: "04:00" }] },
+    },
+  },
+  ```
+- aa0fd51: Хранилища держат состояние лимитов расходов: начало скользящего окна, перенос перерасхода, ручной сброс, личные лимиты и
+  блокировку человека, отметки о порогах. Новая таблица `spending_limit_states` (миграция SQLite `0013`, PostgreSQL `0012`
+  применяется сама при открытии хранилища). Запись по версии: из двух одновременных записей с одной версией проходит одна,
+  поэтому две копии сервера не затрут друг друга. В `ChatStorage` — необязательные `getSpendingLimitState(key)` и
+  `saveSpendingLimitState(key, value, expectedVersion)`, тип `SpendingLimitStateRecord`.
+  
+  Обновление ничего не требует. Своё хранилище работает как раньше. Если с ним нужны окна «N часов», личные настройки, сброс
+  или пороги из `@ykurilov/agent-chat-limits`, реализуйте эти два метода и проверьте общими тестами
+  `describeChatStorageContract(createStorage, { spendingLimitState: "required" })`.
+- 05e258b: Сервер сообщает приложению, что ход агента закончен: необязательный `onTurnFinished` в настройках `createChatHandler`
+  (и `createChatService`) получает `{ userId, chatId, messageId, status, modelId, providerId }` один раз на ход при любом
+  итоге — законченном, остановленном, с ошибкой, прерванном или ждущем человека. Итог к этому мигу уже записан. Ход
+  обработчик не ждёт; если обработчик бросил или его обещание отклонено, ответ не ломается, сбой уходит в `logError`.
+  Тип — `TurnFinished` из `@ykurilov/agent-chat-core`. Без `onTurnFinished` всё как раньше.
+- aa0fd51: Потолки одного хода. У `SpendingLimits` два новых необязательных метода: `turnRules({ userId, chatId })` возвращает
+  `{ maxCostUsd?, maxToolCalls? }` перед ходом, `afterSpending({ userId, chatId })` зовётся после записи расхода хода. Дошёл ход
+  до потолка денег (по ценам профиля модели) или вызовов инструментов — следующий шаг идёт без инструментов и с просьбой
+  подвести итог, ответ кончается итогом, а не обрывом. Шаг, начатый до потолка, доделывается. Ошибка `afterSpending` уходит
+  в `logError` и ход не задевает. Тип `TurnSpendingRules`. Пакет `@ykurilov/agent-chat-limits` задаёт оба метода сам
+  (`turn` в `createSpendingLimits`).
+  
+  Обновление ничего не требует. Свои лимиты без этих методов работают как раньше.
+
+## 0.18.6
+
+No changes in this release.
+
+## 0.18.5
+
+No changes in this release.
+
+## 0.18.4
+
+No changes in this release.
+
+## 0.18.3
+
+No changes in this release.
+
+## 0.18.2
+
+No changes in this release.
+
+## 0.18.1
+
+No changes in this release.
+
+## 0.18.0
+
+### Minor Changes
+
+- 43d7ebe: Песочница агента для админа: новый пакет `@ykurilov/agent-chat-sandbox`. Админ говорит с боевым агентом и видит журнал:
+  каждое обращение к модели (что ушло, что пришло, токены, кэш, цена) и каждый вызов инструмента. Любое сообщение можно
+  поправить (текст и результаты обычных инструментов), правка создаёт ветку. Модель и системная инструкция меняются для одного
+  чата, боевые не трогаются. Память в песочнице только на чтение.
+  
+  - сервер: `createSandboxHandler({ chat, isAdmin, journal })`, журнал `createSqliteSandboxJournal` (`/sqlite`) или
+    `createPostgresSandboxJournal` (`/postgres`, схема `agent_chat`), хранится 30 дней; не админ получает 404 на любом адресе;
+  - страница: `AgentSandbox` из `@ykurilov/agent-chat-sandbox/react`, готовый скин `tandemSandboxSkin`;
+  - `createChatServer` — новый экспорт server (на нём стоят и боевой, и песочный обработчик);
+  - core: `turnObserver`, `chatInstructions`, `lockedToolOutputs`, `editAnswer`; боевой запрос к модели остаётся прежним побайтно;
+  - договор скина чата версии 15: необязательные `AgentMessage.onEdit/edited` и `ToolCallRow.outputEdited`; новые надписи
+    `answerEdited`, `toolOutputEdited`, `editAnswer`; договор скина песочницы `SandboxSkin` версии 1.
+  
+  Подробно: `docs/sandbox.md`.
+  
+  ### Как обновить приложение
+  
+  Обычному приложению делать ничего не нужно: песочница включается отдельно, миграций боевой базы нет (таблицы `sandbox_*` создаёт
+  сам журнал).
+  
+  1. Полный словарь надписей, написанный вручную без `{ ...russianLabels }`, — добавьте `answerEdited`, `toolOutputEdited`, `editAnswer`.
+  2. Свой скин версии 14 работает без правок; чтобы показать «изменено» и кнопку правки, реализуйте необязательные части версии 15.
+  3. Своя реализация сервера поверх `createChatHandler` продолжает работать; для песочницы возьмите `createChatServer`.
+  4. Проверка: `pnpm typecheck`, затем в чате отправить сообщение и получить ответ.
+
+## 0.17.0
+
+No changes in this release.
+
+## 0.16.0
+
+### Minor Changes
+
+- cf52f10: **Ломает только исчерпывающие проверки:** у `UsageSource` появилось значение `images`, у видов ошибок сервера — `widget_not_pending` и `invalid_answer`, у `ChatService` — метод `answerWidget`. Своё хранилище должно поддержать условную запись `AwaitingMessagePatch.expectedParts` (при несовпадении частей — `MessageNotAwaitingError`; помощник `sameMessageParts` из core), иначе две копии сервера могут затереть ответы друг друга; общие тесты хранилищ это проверяют. Остальное необязательно, приложение без правок работает как раньше.
+  
+  Что нового: агент может спросить кнопками, звёздами или формой (виджеты), нарисовать схему блоком ` ```mermaid ` и создать картинки через Runware. Всё включается отдельно:
+  
+  - виджеты: `agent: { widgets: { basic: true, custom: [свойВиджет] } }`, свой виджет — `defineWidget` из core и компонент в `widgets={{ … }}` у `AgentChat`; ответ человека идёт на `POST /:chatId/widgets/:toolCallId`, ход ждёт со статусом `awaiting_approval`;
+  - схемы: новый пакет `@ykurilov/agent-chat-diagrams`, `agent: { diagrams: true }` на сервере и `diagrams={diagramsClient}` на странице;
+  - картинки: новый пакет `@ykurilov/agent-chat-images` (нужен пакет вложений и `RUNWARE_API_KEY`), `images.tools(model)` в `agent.tools`, `images={imagesClient}` на странице; свой срок ожидания (210 с) инструмент сообщает ядру сам (`declareToolTimeout`), расход бронируется до заказа (`assertWithinLimit({ pendingUsd })`);
+  - окно просмотра картинок и схем: Тандем готов, своему скину — необязательные части договора версии 13 (`Widget`, `SuggestedReplies`, `GeneratedImages`, `MediaViewer`, `diagramColors`, `renderDiagram`). `splitMermaidBlocks` экспортируется из react;
+  - вложения: `Attachments.storage` и `detectFileKind` экспортируются из пакета вложений;
+  - голосовой режим произносит вопрос и варианты ждущего виджета и говорит «схема на экране» вместо блока схемы;
+  - «Стоп» на экране закрывает висящие вызовы так же, как сервер, разрешённые без результата — «результат неизвестен» (`stoppedToolCallReasons.resultUnknown`);
+  - упавший свой виджет страницы заменяется запасным видом скина, лента цела.
+  
+  Подробно: `docs/widgets.md`, `docs/diagrams.md`, `docs/images.md`, `docs/media-viewer.md`.
+  
+  ### Как обновить приложение
+  
+  Обычному приложению на SQLite или PostgreSQL из набора делать ничего не нужно: миграций нет, всё новое включается отдельно.
+  
+  1. Исчерпывающий `switch` по `UsageSource` — добавьте ветку `"images"`; по видам ошибок сервера — `"widget_not_pending"` и `"invalid_answer"`.
+  2. Своя реализация `ChatService` — добавьте метод `answerWidget({ chatId, ownerId, toolCallId, answer, page }): Promise<{ resumed: boolean }>` (тип `WidgetAnswerRequest` из core, образец — служба из core).
+  3. Своё хранилище: `updateAwaitingMessage` получает необязательное поле `expectedParts`. Если оно есть и части сообщения в базе с ним не совпадают (`sameMessageParts` из core), бросайте `MessageNotAwaitingError`; проверку и запись делайте в одной транзакции. Прогоните общие тесты хранилищ из core.
+  4. Своя обёртка `assertWithinLimit` из limits — пробрасывайте новое необязательное поле `pendingUsd`.
+  5. Проверка: `pnpm typecheck`, затем в чате отправить сообщение и получить ответ.
+
+## 0.15.0
+
+### Minor Changes
+
+- f05ad23: Часовой пояс для лимитов расходов: `createSpendingLimits({ timeZone: "Europe/Moscow" })`. Сутки и месяцы режутся
+  по полуночи этого пояса, а не по UTC (раньше московский суточный лимит обнулялся в 03:00). Переход на летнее время
+  учтён: сутки бывают 23 и 25 часов. Для сегодняшней даты агента этот пояс только запасной: главнее пояс браузера
+  человека, а пояс лимитов берётся, когда браузер свой пояс не прислал. Дата обновления лимита на экране — по поясу лимитов. Пояс не из базы IANA — ошибка при старте.
+  
+  Новое: `timeZone` в настройках лимитов и необязательное поле `timeZone` у `SpendingLimits`, `SpendingStatus`,
+  `SpendingLimitReachedError`, `SpendingReport` и `SpendingInfo` (экран); ответы `GET …/spending` и отказ 429 получают
+  `timeZone`, если пояс задан. Ядро экспортирует `resolveTimeZone`.
+  
+  ### Как обновить приложение
+  
+  Ничего делать не нужно: без `timeZone` лимиты по UTC, дата агента по поясу человека или сервера, как раньше.
+  
+  Чтобы считать сутки по Москве, в файле, где создаются лимиты:
+  
+  ```ts
+  const limits = createSpendingLimits({ storage, catalog, budget, period: "day", timeZone: "Europe/Moscow" });
+  ```
+  
+  `agent.timeZone` после этого задавать не нужно. Если он уже задан, он должен совпадать с поясом лимитов (другое имя того же пояса
+  вроде `Asia/Calcutta` и `Asia/Kolkata` — совпадение), иначе
+  служба чата не создастся (ошибка называет оба пояса). Свои надписи `spendingExhausted`, которые сами форматируют
+  `resetsAt`, могут брать пояс из `info.timeZone`. Проверка: `limits.getSpending({ userId })` отдаёт `periodStart`
+  вида `…T21:00:00.000Z` (полночь по Москве).
+- f05ad23: Встроенные провайдеры (OpenRouter, DeepSeek, Fireworks, Together) можно подключить через прокси: свой адрес `baseURL`
+  и заголовки `headers` к каждому запросу. Нужно серверу в России, откуда зарубежные провайдеры напрямую недоступны.
+  Через прокси идёт всё: ход агента, фоновые вызовы памяти и сжатия, сверка расхода OpenRouter. Меню моделей, цены и учёт
+  расходов те же. Значения заголовков вычищаются из ошибок и журналов, как ключи.
+  
+  Новое: правка каталога `extendCatalog(…, { connectProviders: { openrouter: { baseURL, headers } } })` (провайдер остаётся
+  на своём месте, с прежними настройками), фабрики `createDeepSeekProvider`, `createFireworksProvider`,
+  `createTogetherProvider`, у `createOpenRouterProvider` — `baseURL` и `headers`, тип `ProviderConnection`, поля
+  `connection` и `connect` у `ProviderDescription` (необязательные). Голос: `headers` у чистки текста
+  (`polish: { provider: "together", baseUrl, headers }`) и у звуков человека (`sounds: { baseUrl, headers }`).
+  
+  ### Как обновить приложение
+  
+  Ничего делать не нужно: без новых настроек запросы идут прямо к провайдерам, как раньше.
+  
+  Чтобы пустить провайдера через прокси, в файле, где собирается каталог моделей (обычно рядом с `createChatHandler`):
+  
+  ```ts
+  import { extendCatalog, standardCatalog } from "@ykurilov/agent-chat-core";
+  
+  const catalog = extendCatalog(standardCatalog, {
+    connectProviders: {
+      openrouter: {
+        baseURL: "https://fr-api-route.yeycourses.com/openrouter/api/v1",
+        headers: { "X-Proxy-Token": process.env.PROXY_TOKEN! },
+      },
+    },
+  });
+  
+  createChatHandler({ /* … */ catalog });
+  ```
+  
+  Токен прокси — только в окружении сервера (`PROXY_TOKEN`), не в коде. Не задан `PROXY_TOKEN` — ошибка при старте
+  (у заголовка нет значения). Значение заголовка короче 8 знаков и заголовок `Authorization` — тоже ошибка при старте.
+  Прокси должен пробрасывать заголовок ответа `x-generation-id`, иначе расход OpenRouter останется оценкой. Проверка:
+  один ответ в чате приходит, в журнале прокси виден запрос.
+
+## 0.14.0
+
+### Minor Changes
+
+- 4f33e85: Браузерные инструменты: агент делает действие на странице человека — например, открывает карточку задачи. Приложение описывает их общим модулем через `tool({ description, inputSchema })` без `execute` и подключает на сервере `agent.browserTools`, а на странице — функции с теми же именами в `browserTools` у `AgentPanelProvider`. Когда модель зовёт такой инструмент, сервер шлёт временный кусок `data-browser-call` той вкладке, с которой пришёл ход, и ждёт ответа `POST {base}/:chatId/browser-tools/:toolCallId` (`{ tabId, output }` или `{ tabId, error }`, `204`; тело больше 64 КБ — `400 invalid`, дальше не читается). Результат уходит модели, ошибка — строкой «ошибка» с её текстом, ход продолжается. Срок ответа — `agent.browserToolTimeoutMs` (по умолчанию 30 с, от 1 с до 2³¹−1 мс), после него — «Страница не ответила за N с»; «стоп» и удаление чата снимают ожидание. Без вкладки — «Действие на экране недоступно: страница не подключена». Результат больше 16 КБ — «Слишком большой результат», ошибка обрезается до 1000 знаков, пустой результат — «готово». «Спросить разрешения» работает как у обычных инструментов: функция зовётся только после «Разрешить». Ответ чужой вкладки, повторный и поздний — `409 not_pending` (`BrowserCallNotPendingError` в ядре, новый вид `not_pending` у `HandlerErrorKind`). Описание с `execute` или имя, совпавшее с инструментом приложения или памяти, — ошибка при создании службы. Вкладка исполняет каждый вызов чата один раз, в том числе после перезагрузки. Ожидание живёт в памяти процесса: как и продолжение ответа, работает на одном сервере.
+  
+  **Ломает приложения** только там, где сами реализуют интерфейс `ChatService` (например, поддельная служба в тестах): в него добавился метод `answerBrowserCall`.
+- 15fbbcc: Инструмент агента сообщает странице, что изменил данные. В ядре у `AgentToolsModel` новая функция `notifyDataChanged({ tag, details? })`: её зовут после записи, и сообщение уходит браузеру той вкладки, где идёт ответ, сразу, не дожидаясь конца вызова. Метка — 1–100 знаков, подробности — JSON до 4 КБ; неверная форма — `TypeError` внутри инструмента. После конца хода вызов ничего не делает и пишет в журнал сервера. В хранилище сообщение не попадает. В слое поведения `useAgentChat` с мостом передаёт такие сообщения приложению: на странице их ловят `useAgentDataChanges(tag, handler)` и `onDataChanged` провайдера, повтор одного и того же сообщения подписчикам не раздаётся, при закрытой панели сообщение тоже доходит.
+  
+  **Ломает приложения** только там, где сами собирают `AgentToolsModel` (например, в тестах инструментов): в объект нужно добавить `notifyDataChanged`. Инструментам, которые читают `profile`, `chatId`, `ownerId` или `place`, ничего делать не нужно.
+- c09c1e2: Основа боковой панели агента. В ядре — типы `ScreenPlace` (где человек в приложении), `DataChange` (инструмент изменил данные), `TurnRequestContext` (с чем пришёл запрос хода) и имена временных кусков потока `data-app-change`, `data-browser-call`. В слое поведения — тип `AgentAppBridge` (связь чата с приложением), необязательные `appBridge` и `initialDraft` у `AgentChat` и `useAgentChat` (`initialDraft` кладёт текст в поле ввода при открытии чата), `appBridge` у `ChatWorkspace`, `rememberKey` у `useChatList` (свой ключ запомненного чата), новый вход `@ykurilov/agent-chat-react/panel` и договор скина версии 12 — отдельный `AgentPanelSkin` (`ChatSkin`, `ChatListSkin`, `MemorySkin` не менялись).
+  
+  **Ломает приложения** только с полным словарём надписей `ChatLabels`, написанным вручную: в него добавились надписи `agentPanel…` (`agentPanelLauncher`, `agentPanelOpen`, `agentPanelClose`, `agentPanelLabel`, `agentPanelChats`, `agentPanelBackToChat`, `agentPanelBusy`). Тем, кто пишет `{ ...russianLabels, … }`, ничего делать не нужно. Без новых свойств чат работает как раньше.
+- 062ce36: Человек, чат и место на экране для инструментов агента. Функция `agent.tools(model)` получает в `model` не только `ownerId` и `chatId`, но и `place` — где сейчас человек в приложении (`{ description, data? }` или `null`); функция зовётся раз на ход, поэтому два человека одновременно не путаются. Место уходит с каждым запросом хода (отправка, правка, повтор, переделка, ответ на подтверждение) полями `place` и `tabId` в теле, а модель видит его отдельной частью в самом конце последнего сообщения человека (после пометки режима и блока памяти). В историю чата и в сжатие место не пишется, инструкция и описания инструментов не меняются, поэтому кэш модели цел. Описание длиннее `agent.placeMaxLength` (по умолчанию 1000, не меньше 100) обрезается с «…», данные больше 4 КБ отбрасываются, обе обрезки пишутся в журнал сервера без текста. Неверная форма `place` или `tabId` — `400 invalid`, ничего не записано. В службе чата у `sendMessage` и `editMessage` в `options` появилось `page`, у `retry`, `regenerate` и `answerApproval` — последний аргумент `page` (`TurnRequestContext`). `useAgentChat` с `appBridge` кладёт `tabId` и текущее место в тела всех пяти запросов; без моста тела прежние. Старые приложения работают без изменений. **Ломает** только код, который сам собирает объект `AgentToolsModel` (например, тесты инструментов): в него добавилось обязательное поле `place` (`null`, если места нет); функции `tools(model)` приложений ничего менять не нужно.
+- 656233a: Долгая память агента. Агент сам запоминает устойчивое о человеке (предпочтения, правила общения, факты о работе) и помнит это в новых чатах. В новом пакете `@ykurilov/agent-chat-memory` лежат инструмент `manage_memory`, правила записей и блок памяти для запроса. Человек видит записи на экране памяти: может добавить, исправить, удалить запись или стереть всю память. Записи у каждого человека свои, удаление чата их не трогает. Раз в сутки после ответа та же модель предлагает слить повторные записи (опция `optimizer`); код проверяет группы и применяет годные, на экране появляется раздел «Объединено» с кнопкой «Вернуть как было». Отрицание не теряется («не любит кофе» не склеивается с «любит кофе»). После сбоев проверка ждёт дольше: час, 6 часов, сутки. Пределы записей и дубли держатся при одновременных действиях (замок на человека, а в SQLite и PostgreSQL ещё и проверка внутри транзакции), в том числе при возврате склейки. Память не меняет начало запроса к модели, поэтому кэш модели сохраняется.
+  
+  **Ломает приложения** только с полным словарём надписей `ChatLabels`, написанным вручную (шаг 5): в него добавились надписи `memory…`. Остальным обновление ничего не ломает: без опции `memory` чат работает как раньше. Чтобы включить память, выполните шаги ниже. Новые адреса: `/api/chat/memory/merges` и `/api/chat/memory/merges/:runId/revert`. Миграции SQLite `0009` и `0010` и PostgreSQL `0008` и `0009` применяются сами при открытии базы (`0010` и `0009` — задел под склейку повторов записей).
+  
+  ### Как обновить приложение
+  
+  1. **Включить память на сервере** (по желанию). Пакет ставится отдельно: `pnpm add @ykurilov/agent-chat-memory`. В файле, где создаётся `createChatHandler`:
+  
+     Было:
+  
+     ```ts
+     createChatHandler({ basePath: "/api/chat", storage, resolveUser /* … */ });
+     ```
+  
+     Стало:
+  
+     ```ts
+     import { createLongTermMemory } from "@ykurilov/agent-chat-memory";
+  
+     createChatHandler({ basePath: "/api/chat", storage, resolveUser, memory: createLongTermMemory({ storage }) /* … */ });
+     ```
+  
+     Инструкция агента и инструмент `manage_memory` добавляются сами: в `agent.instructions` и `agent.tools` ничего дописывать не нужно. Имя `manage_memory` занято: своего инструмента с таким именем быть не должно (иначе ошибка при создании). Адреса `/api/chat/memory` появляются сами. Без `memory` они отвечают `404`.
+  2. **Подключить экран памяти** (по желанию). Найдите страницу, куда его поставить, и добавьте компонент; `createMemoryApi` вызывайте один раз (например, в `useMemo`):
+  
+     ```tsx
+     import { AgentMemory, createMemoryApi } from "@ykurilov/agent-chat-react";
+     import { tandemMemorySkin } from "@ykurilov/agent-chat-skin-tandem";
+  
+     const memoryApi = useMemo(() => createMemoryApi({ api: "/api/chat" }), []);
+     <AgentMemory api={memoryApi} skin={tandemMemorySkin} />
+     ```
+  3. **Подпись вызова в ленте.** Было: `labels={russianLabels}`. Стало: `labels={withMemoryToolTitles(russianLabels)}`, где `withMemoryToolTitles` — из `@ykurilov/agent-chat-memory/labels`. Вместо `manage_memory` в ленте будет «Работа с памятью».
+  4. **Свой скин (договор скина версии 11).** `ChatSkin` и `ChatListSkin` не менялись. Экрану памяти нужен отдельный `MemorySkin` из пяти компонентов (`MemoryScreen`, `MemoryGroup`, `MemoryNoteRow`, `MemoryNoteEditor`, `MemoryConfirm`). Скин Тандема даёт его готовым: `tandemMemorySkin`. Описание — `specs/017-long-term-memory/contracts/memory.md`, раздел 5.
+  5. **Полный словарь надписей.** Если приложение задаёт объект `ChatLabels` целиком, а не `{ ...russianLabels, … }`, добавьте новые надписи: все ключи, которые начинаются с `memory` (`memoryHeading`, `memoryAdd`, `memoryClearAll` и другие, полный список — тип `ChatLabels` в `@ykurilov/agent-chat-react`). Без этого `pnpm typecheck` не пройдёт.
+  6. **Своё хранилище.** Нужно только при включённой памяти. В своей реализации `ChatStorage` добавьте пять необязательных методов: `listMemoryNotes`, `insertMemoryNotes`, `updateMemoryNote`, `deleteMemoryNote`, `clearMemoryNotes`. Сигнатуры — в `ChatStorage` пакета core и в `packages/storage-sqlite/src/sqlite-storage.ts`. Без них `createLongTermMemory` остановится с ошибкой `MemoryStorageNotSupportedError` и списком недостающих методов. Для склейки повторов нужны ещё шесть методов (`claimMemoryOptimizationRun`, `finishMemoryOptimizationRun`, `applyMemoryMerge`, `revertMemoryMerge`, `listMemoryOptimizationRuns`, `listMergedMemoryNotes`); без них склейка выключена. Чтобы пределы держались при нескольких серверах, добавьте необязательные `insertMemoryNotesChecked` и `updateMemoryNoteChecked`. Общие тесты `describeChatStorageContract` проверят их сами.
+  7. **Проверка.** `pnpm typecheck` и сборка проходят. Напишите агенту «Запомни, что я пишу на TypeScript», откройте экран памяти: там запись в разделе, который выбрал агент. В новом чате спросите, что он про вас знает.
+- 96098be: Мелкие исправления (022). Символ с кодом ноль в первом сообщении больше не роняет отправку на Postgres: он выбрасывается из названия чата, из записей памяти и из сводки сжатия истории (иначе запись сжатия падала бы при каждой попытке); в самом тексте сообщения он лежит как раньше. Вложения отмечаются прикреплёнными до записи сообщения, а не после: если сервер упал между двумя шагами, чистка брошенных файлов не удалит их через сутки (файл, отмеченный зря, безвреден и уходит вместе с чатом). Во всех пакетах появилось поле `engines: { node: ">=22" }`; голосовой сервер (`createVoiceRelay`) и голосовой диалог (`createDialogRelay`) на Node 20 сразу при создании говорят понятной ошибкой, что нужен Node 22 (раньше падали при первом соединении; со своим `connectUpstream` проверки нет). В пакете вложений `react` и `@ykurilov/agent-chat-react` стали необязательными peer-зависимостями: серверу без экрана они больше не ставятся. Приложению, которое берёт `@ykurilov/agent-chat-attachments/react`, достаточно иметь их в проекте — для чата на экране они нужны и так; если они подтягивались только через вложения, добавьте их в зависимости приложения.
+- 278a718: Обрыв связи с моделью посреди ответа больше не заканчивается ошибкой (022, этап 6а). Если провайдер перегружен (`overloaded`), упёрся в лимит (`rate_limited`) или замолчал на 120 с после начала ответа, ход ждёт около 2 с и продолжает тот же ответ у того же провайдера. Модель видит написанное и пометку о сбое последним сообщением с дословным хвостом оборванного текста и дописывает с места обрыва. Если модель всё же потеряла перенос строки между пунктами списка или строками таблицы, он подставляется. Недописанные вызовы инструментов закрываются ошибкой, в ответе не остаётся вечного «выполняется». Выполненные инструменты не вызываются заново. Человек видит один ответ без плашки ошибки и без «Повторить», подписчик, подключившийся во время паузы, получает ответ с начала. Продолжений не больше двух на ход (паузы 2 и 5 с с разбросом; `retry-after` провайдера только удлиняет паузу, но не дольше 10 с). Третий обрыв — ошибка, как раньше. Ответ с запросом подтверждения не продолжается. Запасной провайдер после начала ответа не используется. Начало запроса продолжения побайтно совпадает с оборванным, кэш не теряется и ложного `[промах кэша]` нет. Расход хода — сумма попыток, одна запись. Журнал сервера: `[автопродолжение] … попытка=N из 2 пауза=…мс причина=… знаков написано=…`. «Стоп» во время паузы останавливает ход. Приложению ничего менять не нужно.
+- c1581f4: Журнал промахов кэша и привязка OpenRouter к одному серверу (022). Когда начало запроса то же, что в прошлом запросе чата, а провайдер почти ничего не взял из кэша (например, в инструкцию вписано текущее время), сервер пишет в журнал одну строку: `[промах кэша] чат=… модель=… провайдер=… токенов=20000 переплата≈$0.0540 пауза=1.5мин`. Токены — сколько входа прошло мимо кэша; переплата считается по ценам модели (нет цены кэша — `переплата=неизвестна`); пауза — время с прошлого шага. Текстов сообщений и ключей в строке нет. Промахи до 1024 токенов не считаются; первый запрос чата, другая ветка (правка, «Переделать»), сжатая история, другая модель или провайдер, а также провайдер, ни разу не сообщавший о кэше, строки не дают. Включено по умолчанию, выключается `AgentSettings.cacheMissLog: false`. Следилка держит в памяти процесса последние 500 чатов. Хвост запроса (блок памяти и место на экране), которого на следующем ходе в начале запроса уже нет, из промаха вычитается (оценка: знаки / 3).
+  
+  Кэш и хвост запроса: у провайдеров с явной меткой кэша (OpenRouter) метка стояла только на конце последнего сообщения, то есть после блока памяти и места на экране. На следующем ходе этих блоков в начале запроса нет, префикс не находился, и кэш откатывался к инструкции: вся история пересчитывалась каждый ход. Теперь та же метка стоит и на последней части вопроса перед хвостом; запрос побайтно стабилен. У провайдеров без явных меток (DeepSeek, Fireworks, Together) кэш префиксный и менять нечего.
+  
+  OpenRouter получает заголовок `x-session-id` с номером чата: запросы одного чата идут на один сервер, кэш не теряется при переходе между серверами. Заголовок безопасен: обычный номер (латиница, цифры, `._:~-`, до 128 знаков, например UUID) идёт как есть, кириллица, пробелы и слишком длинные номера заменяются стабильной короткой свёрткой; то же у `x-session-affinity` Fireworks. Приватность: номер чата уходит в OpenRouter как идентификатор сессии.
+- 213bcb3: Переписка не влезла в окно модели — ход сам сжимает историю и продолжает тот же ответ (022, этап 6). Раньше человек получал ошибку. Теперь ядро один раз сжимает историю чата до текущего вопроса, не глядя на порог и паузу после неудачного сжатия. Потом ход продолжает тот же ответ с уже выполненными шагами: инструменты второй раз не запускаются, повторного начала ответа клиент не видит. Если сжатие чата уже идёт, ход ждёт его и, если оно оставило несжатое до вопроса, один раз дожимает; «Стоп» обрывает ожидание сразу. Если в окно не влез уже сам длинный ход, первые его шаги пересказываются, а последние один-два идут как есть. Пересказ живёт только в запросах хода, в базе и на экране ответ целиком. Не помогло и это — ответ `error` с видом `context_overflow`. Если сам запрос сжатия не влез, он повторяется один раз: длинные результаты инструментов в нём сокращены до 2000 знаков. Обычное сжатие результаты не сокращает, кэш цел. Лимит шагов `maxSteps` — на весь ход: попытка после сжатия или перехода к запасному получает остаток. Расход всех попыток хода и сжатий попадает в журнал расходов и в расход ответа, даже если последняя попытка оборвалась. В журнал сервера пишутся строки `[переполнение] … сжатие=начато|готово|нечего сжимать|не вышло|выключено` и `… шаги ответа=…`. Приложению ничего менять не нужно.
+- 927c02c: Запасной провайдер той же модели и подключение надёжности к ходу (022, этап 4). Если выбранный провайдер после тихих повторов перегружен (`overloaded`) или упёрся в лимит (`rate_limited`), а ответ ещё не начался, ход один раз переходит к следующему провайдеру этой модели, чей ключ есть на сервере. Кэш при этом теряется, расход считается по цене запасного. После первого куска ответа, при неверном ключе, нехватке денег и прочих ошибках перехода нет. Новая настройка `AgentSettings.providerFallback`: не задано — включено, порядок из `providerModelIds`; `false` — выключено; `byModel[modelId]` — свой порядок или `false` для одной модели. Провайдер, которого нет у модели, или неизвестная модель — `TypeError` при создании службы. Ответ записывается с провайдером, который реально ответил: `FinishedMessagePatch.providerId?` (свои хранилища без этого поля работают как раньше), итоговый `message-metadata` и запись расхода. Выбор чата не меняется. Продолжение после подтверждения тоже переходит, одобренный инструмент не выполняется второй раз. Новая настройка `AgentSettings.toolResultMaxLength` (число или `{ default, byTool }`, не меньше 1000) задаёт предел результата инструмента; обрезка пишет в журнал строку `[результат обрезан]` без содержимого. Кривые аргументы инструментов чинятся без обращения к модели. Журнал сервера: `[повтор]` на каждый тихий повтор хода и сжатия, одна строка `[сбой провайдера]` на упавший ход, `[запасной провайдер] … кэш потерян` на переход. Экспортированы типы `ProviderFallbackSetting` и `ToolResultLimitSetting`.
+- be77ee2: Основа для надёжности хода агента (022). Новый вид ошибки `context_overflow` («Переписка не помещается в модель») у `ChatErrorKind` в ядре и в `react`, надпись `labels.errors.context_overflow` в русском словаре; Тандем показывает её сам. **Ломает:** исчерпывающий `switch` по виду ошибки и своя таблица надписей `labels.errors` без `context_overflow` перестанут проходить проверку типов — добавьте надпись. Ядро экспортирует `HANGING_TOOL_CALL_REASON` (текст для модели вместо результата прерванного вызова) и `cutAtCharBoundary(text, maxLength)` — обрезку без половинки эмодзи; веб-инструменты режут страницы и выдержки через неё, теперь эмодзи на границе не рвётся. Список перенесённых из pi-mono (MIT) признаков ошибок и лицензия — в `THIRD_PARTY_NOTICES.md`, он лежит и в пакете `core`.
+- 8b59096: Настоящий расход оборванных ответов и надёжнее переходы между попытками (022, этап 8б). «Стоп» или обрыв посреди ответа у OpenRouter сначала записывается оценкой «примерно», а затем сервер в фоне узнаёт у OpenRouter настоящий расход генерации по её номеру и дописывает запись `answer_correction` — разницу с оценкой (может быть меньше нуля); сумма записей ответа становится точной. Не узнал за ~10 минут или сервер перезапустился — остаётся оценка. Свой провайдер подключает то же новым необязательным полем описания `generationUsage` (номер генерации из заголовков и запрос расхода по номеру). Запрос, открытый, но оборванный до первого куска, теперь оценивается входом; отказ провайдера — нет. Расход хода пишется по каждому провайдеру отдельно и по его цене: основной, с которого ушли на запасной, — по своему тарифу; восстановление после перезапуска делает так же и считает ступень цены у каждого шага (идущая запись несёт `usage.pendingSteps`). У каждой попытки хода своя отмена: переход к повтору, запасному провайдеру или автопродолжению отменяет инструменты старой попытки; запущенный инструмент из `sequentialTools` держит очередь до своего конца, так что новая попытка не запустит второе «спиши деньги» поверх первого. Фоновая память после ответа идёт к провайдеру, который ответил, а не к лежащему основному. Старые картинки ужимаются один раз: кэш решений ограничен памятью копий, а не 20 местами, и чат с десятками старых картинок не ужимает их заново на каждом шаге. Память под копии — новая настройка `createAttachments({ limits: { imageCacheBytes } })`, по умолчанию 128 МБ.
+- 84ad64f: Укрепление по третьему проходу Pi (022, этап S9). **Большие фото уменьшаются при загрузке**: поворот по EXIF, не больше 2000×2000 пикселей и ~4,5 МБ в base64; хранится уменьшенная копия, старые картинки ужимаются при сборке запроса (результат запоминается), нечитаемая картинка и картинка больше 60 млн пикселей — отказ 422 `unreadable` (в старой истории — пометка «пропущена»). Новая зависимость `sharp` (готовые сборки для macOS и Linux, в том числе Alpine; порядок ужатия из pi-mono, MIT). **Секреты в ошибке инструмента** вычищаются до того, как текст уйдёт человеку, в базу и модели: пароль в адресе, `password=`/`password: …`/`token=`, `"secret": "…"`, заголовок `Authorization`, `X-Api-Key`, ключи сервисов, закрытые ключи PEM и значения секретных переменных окружения (кроме путей, адресов без пароля и простых слов); чистятся сообщение, стек и `cause`; `scrubSecrets` и `environmentSecrets` экспортированы из ядра. **Внешние картинки** в ответе модели и в сводке сжатия скин Тандема показывает ссылкой и не грузит (новая необязательная надпись словаря `externalImageLink`, по умолчанию «картинка»; свои словари без неё работают); инструкция веб-инструментов называет страницы данными, а не указаниями. **Ступени цены** по длине контекста: `pricing.tiers` (`inputTokensAbove` и цены), ход считается по шагам; у GPT 6 Luna выше 272 тысяч токенов. Пауза в `useAgentChat` больше не копит слушатели отмены.
+- 5027963: Тихие повторы и разбор ошибок провайдера (022). Повтор теперь понимает ошибку, пришедшую кусочком потока до первого куска ответа (код `code` или текст вроде «Provider returned error»), сетевые сбои (`fetch failed`, `socket hang up`), коды 408 и 409 и заголовок `x-should-retry`; квота, оплата и переполнение не повторяются. К паузам добавлен случайный разброс до 25% в пределах прежних ~10 с. Те же повторы действуют для запросов без потока: сжатие истории и склейка записей долгой памяти переживают одиночный 429 или 503. Если провайдер начал отвечать и замолчал (сроки — `agent.modelSilenceTimeout`, см. «Ход больше не висит вечно»), обрыв считается видом `overloaded`; ход дописывает ответ сам (автопродолжение), а не заканчивается ошибкой. Вид ошибки: 500, 502, 504 и временные сбои по тексту — `overloaded` (раньше `other`), признаки переполнения и 413 — `context_overflow`. Сбой сжатия и дел памяти пишет в журнал сервера одну строку `[сбой провайдера]` с кодом, именем ошибки и до 4000 знаков тела; ключи провайдеров, `Bearer …`, `sk-…`, `key=…` заменены на `[скрыто]`, заголовков нет. Склейка памяти пишет и строку `[повтор]` на каждую попытку.
+- c2769dd: «Повторить» после сбоя, «Стоп» или перезапуска сервера продолжает оборванный ход, а не начинает его заново. Новый ответ сразу показывает уже выполненные вызовы инструментов, и модель идёт дальше с них. Поэтому действия не повторяются: просили три задачи, оборвалось на третьей — после «Повторить» их ровно три, а не пять. Если выполненных вызовов не было, «Повторить» начинает ответ заново, как раньше. Прежний оборванный вариант остаётся соседним. Сменили модель или провайдера — рассуждения прежней модели в продолжение не попадают. Если провайдер перегружен, продолжение уходит к запасному. Исправлено падение сервера при «Стоп» во время браузерного инструмента. Приложению ничего менять не нужно.
+- 0cdf102: Несколько копий сервера на одной базе (022, этап 8в). Идущий ответ раз в 5 с отмечает «жив» (новая колонка `alive_at`: миграция SQLite `0012`, PostgreSQL `0011`, применяются сами). `recoverInterruptedAnswers` прерывает только брошенные ответы — без отметки дольше 15 с — и дальше сам проверяет их раз в 5 с до `flush`. Штатная остановка помечает свои ответы брошенными, и следующий старт прерывает их сразу. Новая копия при старте и обновление с перекрытием больше не обрывают живые ответы соседа; две копии, прервавшие один ответ, не задваивают расход. Цена: после падения сервера ответ ещё до ~20 с выглядит идущим (раньше перезапуск прерывал его сразу). Экран человека в это время сам перечитывает историю раз в 3 с и показывает «прерван» с «Повторить», как только сервер прервёт ответ; обновлять страницу не нужно (история отдаёт признак `detachedAnswer`, чтение истории сразу прерывает брошенный дольше порога ответ этого чата). Ход, чей ответ прервала другая копия, останавливается сам: человек видит «прерван», расход не задваивается. Время знака «жив» ставит хранилище: PostgreSQL — по часам базы, часы машин с копиями могут расходиться. Запросы одного чата держите на одной копии. Свои хранилища: два новых необязательных метода — `listSilentAnswerIds({ silentForMs, chatId? })` и лёгкая отметка `markAnswerAlive(messageId)` — и поле записи `alive` (`"now"` или `"released"`, время ставит само хранилище); общий набор контракта их проверяет. Хранилище без `listSilentAnswerIds` продолжает работать только с одной копией сервера: при старте `recoverInterruptedAnswers` прерывает все идущие ответы, проверок брошенных ответов дальше нет, а в журнал сервера пишется предупреждение. Без `markAnswerAlive` знак в тишине идёт полной записью ответа. Поле `alive` приходит в `insertMessage`, `updateStreamingMessage` и `updateAwaitingMessage`: если хранилище не ведёт знак, уберите поле перед записью, а не передавайте его в базу целиком. Переход на эту версию — один раз без перекрытия копий: старые копии не отмечают «жив», и новая прервала бы их ответы старше 15 с; сначала остановите все старые копии, потом запускайте новые. Дальше перекрытие безопасно. Если запрос истории попал не на ту копию, экран через 30 с сам покажет «прерван», хотя ответ идёт: держите запросы одного чата на одной копии. Сбой базы при конечной записи ответа повторяется через 1 и 3 с, а если не вышло — ответ остаётся для восстановления вместо вечного «идёт»; если запись прошла, а потерялся только ответ базы, повтор узнаёт свой итог и считает его удачным. Инструмент «по очереди», не слушающий отмену, после обрыва попытки держит очередь не дольше своего срока; очередь одна на чат, так что «Стоп» и сразу «Повторить» не запустят его второй раз параллельно. Восстановление пропускает ответ, на котором упало, с записью в журнал сервера, и прерывает остальные: битая запись не мешает серверу стартовать. Мелочи: адрес ответа вкладки на браузерный инструмент отвечает 413 `too_large` на слишком большое тело; неотвеченный запрос подтверждения закрывается только после сохранения нового сообщения, а если закрыть не вышло — повтор того же сообщения или «Повторить» доводят дело до конца; вызов веб-инструмента, оборванный «Стопом» или сбоем после отправки запроса, пишется в расход `web_tools`; картинки при загрузке ужимаются через очередь — разом не больше половины ядер (`limits.maxParallelImageFits`).
+- ba16989: Предел размера результата инструмента и починка кривых аргументов (022, этап 3). `trackToolErrors(tools, { limit, onCut })` режет результат любого инструмента с `execute` до предела (по умолчанию 50 000 знаков, пометка «[Результат обрезан: показано N из M знаков]» входит в предел, эмодзи не рвётся); инструменты с `toModelOutput` не режутся. `resolveToolResultLimit` проверяет настройку (целое не меньше 1000, иначе `TypeError`). `createRepairToolCall()` — параметр `repairToolCall` для `streamText`: чинит сырые переводы строк и неверные `\` в аргументах и приводит `"2"` к числу, `"true"` к булеву значению по схеме инструмента. `repairJson` перенесён из pi-mono (MIT).
+- aba59fe: Цикл агента и учёт расхода крепче (022, этап 8). Когда шаги хода кончаются, последний запрос идёт без инструментов (счёт по шагам всего хода, ход из одного шага не ограничивается) и с пометкой «подведи итог» в самом конце: ход кончается сводкой для человека, а не обрывом на вызове. Новая настройка `agent.sequentialTools` (`true` или список имён) пускает инструменты с последствиями по одному: «спиши деньги» не пойдёт одновременно с другим таким вызовом; очередь одна на чат (во всех ходах и повторах), ожидание очереди не съедает срок инструмента, «Стоп» отменяет ждущий вызов, и модель видит, что он не запускался. Оборванный вызов инструмента теперь говорит модели, что действие могло выполниться частично, и показывает последний промежуточный вывод. Ответ, упёршийся в предел длины, получает отметку: человек видит надпись «Ответ оборван по длине» (`labels.answerCutByLength`, в скине — `AgentMessage.cutByLength`), модель в следующих ходах видит пометку в конце своего ответа. Ответ из одних рассуждений (например, «Стоп» на рассуждении) больше не идёт в запрос, а сообщения человека, оказавшиеся подряд, склеиваются в одно (строгие провайдеры не принимают два подряд). Сегодняшняя дата словами идёт в конце последнего сообщения человека, только в запросе — начало запроса не меняется, кэш цел. Дата берётся по часовому поясу человека: браузер шлёт свой пояс (`timeZone`) с каждым запросом хода, сервер берёт только настоящий пояс IANA, иначе — новая настройка `agent.timeZone`, без неё — пояс сервера. Ни один ответ больше не бесплатен в журнале расхода: шаг, оборванный «Стопом» или сбоем после первых слов, и шаг, по которому провайдер не прислал числа, прикидываются по длине текста с учётом письма (кириллица, JSON и иероглифы плотнее латиницы; прикидка скорее завышает), а ответ, оборванный перезапуском сервера, записывается при следующем запуске (`recoverInterruptedAnswers`): только то, чего ещё нет в журнале, поэтому сбой после «Разрешить» не задваивает расход. Такие записи и итог ответа помечены «примерно» (`estimated`). В SQLite и PostgreSQL у записей расхода новая колонка `estimated`: миграция применяется сама при открытии хранилища. Своим хранилищам менять ничего не нужно: без колонки теряется только пометка. Фильтр `sumUsage` получил поля `messageId` и `source`: свои хранилища должны их учитывать (общие тесты `describeChatStorageContract` это проверяют).
+- 47a56ac: Ход больше не висит вечно (022, этап 6б). Серверный инструмент, который не ответил за 2 минуты, получает отмену через `abortSignal`, а модель видит ошибку «Инструмент не ответил за 120 с и отменён. Выполнено ли действие, неизвестно; не повторяй его, не проверив» и дописывает ход. Срок — настройка `agent.toolTimeoutMs` (по умолчанию 120 000 мс, 0 или `Infinity` — без предела), свой срок отдельного инструмента — `{ default?, byTool? }`, как у `toolResultMaxLength`: например, `{ byTool: { ask_user: 0 } }` для инструмента, который сам ждёт ответа человека. Инструменты с подтверждением ждут «Разрешить» без срока, срок идёт с запуска. Браузерные инструменты живут по своим 30 с, как раньше. Сроки молчания потока модели стали настройкой `agent.modelSilenceTimeout`: до первого куска ответа теперь 90 с вместо 60 (модели с долгими рассуждениями и длинным контекстом успевают ответить), между кусками — 120 с, как было; `false` — без предела. Молчание до первого куска повторяется у того же провайдера только один раз, затем — запасной провайдер, а без него ошибка: лёгший провайдер держит ход около 3 минут. Молчание посреди ответа идёт в автопродолжение. Время работы инструмента молчанием модели не считается. После срабатывания любого предела место хода освобождается, «Стоп» работает как раньше, запрос к модели не меняется — кэш цел. Журнал сервера: `[инструмент не ответил] чат=… инструмент=… срок=…мс` и `[молчание модели] … ждали=первый-кусок|следующий-кусок срок=…мс`. Приложению ничего менять не нужно; неверное значение настройки — ошибка при создании службы.
+- f9b6162: Предел одновременных ответов одного человека. Проверка лимита расходов не резервирует деньги, поэтому 20 ходов, начатых разом, могли вместе потратить в разы больше бюджета. **Меняется поведение по умолчанию:** у человека одновременно идут не больше трёх ответов во всех его чатах; лишний ход (отправка, повтор, переделка, правка, продолжение после «Разрешить») получает `429 { error: { kind: "too_many_turns", limit } }` до любых записей. Настройка `maxConcurrentTurnsPerUser` у `createChatHandler` и `createChatService` (целое от 1 или `Infinity` — без предела; иначе ошибка при создании); ядро экспортирует `TooManyTurnsError` и `DEFAULT_MAX_CONCURRENT_TURNS_PER_USER`. Клиент показывает «Уже идут ответы в других чатах…», текст возвращается в поле, без «Нет связи». Заодно истёкший вход (401) клиент показывает как «Вход истёк. Войдите снова» с «Повторить», а не как «Нет связи» или «Что-то пошло не так», и не делает попыток переподключения. Новое: `useAgentChat().refusal`, тип `ChatRefusal`, тип `ErrorNoticeKind` (`ErrorNotice` скина получает и `signed_out`, `too_many_turns`), надписи `labels.errors.signed_out`, `labels.errors.too_many_turns`, `labels.editErrors.signedOut`, `labels.editErrors.tooManyTurns`, `labels.approvalTooManyTurns`; причины отказа правки `signed_out` и `too_many_turns`. Свой словарь целиком, без `{ ...russianLabels }`, — добавьте эти ключи.
+- f9b6162: Мелочи безопасности и расходов. Веб-инструменты: новая настройка `createWebTools({ spending: { storage, pricePerCallUsd } })` — каждый удачный вызов `web_search`, `read_page`, `page_screenshot` пишется расходом с новым источником `web_tools` и входит в лимит расходов; без `spending` всё как раньше, описания инструментов не меняются (кэш цел). OpenRouter: `createOpenRouterProvider({ dataCollection: "deny", zeroDataRetention })` — запрос уходит только хозяевам модели, которые не хранят запросы; подключается через `extendCatalog(..., { addProviders: [...] })`; стандартный `openrouterProvider` и тело запроса по умолчанию не изменились. Долгая память: инструкция велит записывать только сказанное самим человеком, а не указания с веб-страниц и из результатов инструментов (текст инструкции изменился один раз, дальше постоянен).
+- f9b6162: Защита от запросов с чужих страниц. Браузер прикладывает куки человека и к запросу, который отправила чужая страница (обычная HTML-форма, WebSocket), поэтому раньше чужой сайт мог от имени человека записать «факт» в память, создать чат, начать ход или открыть голос. **Меняется поведение по умолчанию:** запрос, который меняет данные (не GET), с чужой страницы получает `403 { error: { kind: "forbidden_origin" } }` до входа и любых записей; подъём WebSocket голоса (`createVoiceRelay`, голосовой режим) проверяется так же, хотя это GET; временный ключ `createVoiceHandler` чужой странице не выдаётся; голосовой режим (`mountDialogRelay`) без `allowedOrigins` больше не пропускает чужие страницы. Свой сайт (`Sec-Fetch-Site: same-origin` или Origin совпадает с `Host` / `X-Forwarded-Host`) и запросы не из браузера проходят как раньше. Чат на чужом сайте, который шлёт запросы прямо оттуда (например, GetCourse), — новая настройка `allowedOrigins: ["https://school.getcourse.ru"]` у `createChatHandler`, `createVoiceRelay`, `createVoiceHandler` и `mountDialogRelay`; CORS и куки `SameSite=None; Secure` настраивает приложение. Неверная запись в списке — ошибка при создании. Отказ пишется в журнал один раз на адрес страницы. Ядро экспортирует `createRequestOriginCheck` и `isSafeMethod`. Ещё: тело запроса больше 1 МиБ сервер не дочитывает и отвечает `413 { error: { kind: "too_large" } }` (самое длинное сообщение, 100 000 знаков, проходит).
+- 1b2f9f1: Фронт и API на разных адресах. `allowedOrigins` у `createChatHandler`, `createVoiceRelay`, `createVoiceHandler` и `mountDialogRelay` принимает шаблон поддоменов `https://*.example.com`: он пускает `app.example.com` и `a.b.example.com`, но не сам `example.com` и не `evil-example.com`; схема и порт должны совпасть, слишком широкий шаблон (`https://*.com`, `https://*.com.`) — ошибка при создании. Общие суффиксы вроде `*.co.uk` проверка не распознаёт: в шаблон вписывают свой домен. Отказ из-за того, что `Origin` не совпал с `Host` (старый браузер или `http://` за прокси, который подменил `Host`), журнал теперь называет прямо: «Origin не совпал с Host (…); за прокси передайте Host/X-Forwarded-Host» с готовыми строками для nginx. `onRefused` у `createRequestOriginCheck` получает `{ origin, reason, hosts? }` вместо строки; новые экспорты ядра — `originRefusalHint` и тип `OriginRefusal`. Клиент на 403 с `forbidden_origin` в теле показывает «Сервер чата не принимает сообщения с этой страницы» (у правки — только в редакторе), возвращает текст в поле и в режиме разработки пишет в консоль, какой адрес вписать в `allowedOrigins`; другой 403 (например, HTML-страница прокси) — обычный сбой. Новое: `ChatRefusal` и `ErrorNoticeKind` получили `forbidden_origin` (`ErrorNotice` скина может получить этот `kind`), причина отказа правки `forbidden_origin`.
+  
+  **Изменение договора надписей:** в `ChatLabels` два новых обязательных ключа — `errors.forbidden_origin` и `editErrors.forbiddenOrigin`. Словарь на основе `{ ...russianLabels }` получает их сам; свой словарь целиком — дополните ими, иначе ошибка типов. Отдельного номера версии у договора надписей нет. Ещё: при отказе по месту хода (`too_many_turns`) или занятом чате файлы вложений больше не принимаются и не остаются ничьими; пока файлы принимаются, чат занят, и второе сообщение в него получает 409.
+- 0e8e0ae: Голосовой режим: человек продолжил говорить, пока модель ещё думает, — вторая фраза дописывается к первой, а не уходит вторым сообщением. Ход останавливается, вместо прежнего сообщения уходит склеенное («Так. Дай-ка подумать.»), модель отвечает один раз; пустого оборванного ответа и отдельного «Так.» в чате нет.
+  
+  - Склеивается, пока у хода нет ни текста, ни звука, ни начатого вызова инструмента (размышление и заполнитель не мешают). Текст или звук уже пошли, начат инструмент, сказано стоп-слово или два междометия — поведение прежнее: перебивание и отдельное сообщение. Подробности — в README пакета voice-dialog, раздел «Склейка фраз».
+  - Склейка идёт через правку последнего сообщения человека: старая фраза остаётся в базе, но обрывком склейки: переключателя веток у склеенного сообщения нет, пролистать на обрывок нельзя (если человек потом сам правит склеенное сообщение, появляется настоящая развилка без обрывков). Признак — часть `data-voice-mode` склеенного сообщения (`{ replaces: id }`), без миграции базы. Отметка голосового режима и подсказки режима сохраняются, кэш модели цел. Название чата, выведенное из заменённого сообщения, обновляется.
+  - `core`: `chatService.editMessage(userId, chatId, editedMessageId, message, options?)` принимает `{ voiceMode: true }`. `server`: `POST …/edit` принимает необязательное булево `voiceMode` (не булево — 400 `invalid`).
+  - `react`: у состояния чата появился `replaceLastVoiceMessage(text)`, у моста `DialogChatBridge` — необязательный `replaceLastMessage(text)`; `useVoiceDialog` его реализует.
+  
+  Обновление ничего не требует: движок склеивает сам, если мост и сервер той же версии. Приложение со своим мостом чата без `replaceLastMessage` работает как раньше: новая фраза в ожидании ответа перебивает ход и уходит отдельным сообщением.
+- 6b20d83: Голосовой режим («разговор»): человек говорит, слова сами уходят сообщением в чат, ответ агента звучит голосом, человека можно перебить. Новый пакет `@ykurilov/agent-chat-voice-dialog`: распознавание Soniox, озвучка ElevenLabs (голос по умолчанию «Профессиональный диктор для аудиокниг», модель `eleven_v4_turbo`), ключи только на сервере. Перебитый ответ остаётся в ленте с отметкой «Вы перебили: озвучено до «…»», она хранится и видна после перезагрузки. Расход на озвучку идёт в учёт и лимиты (`source: "speech"`). Человек выбирает голос в меню режима; выбор хранится на сервере.
+  
+  Модель узнаёт о режиме двумя служебными пометками: одна при входе («ответы озвучиваются, отвечай коротко и разговорно»), одна при возврате к тексту («разговор снова текстом»). Они стоят в конце сообщения человека, где режим сменился, а не в каждом запросе. Сообщение из режима запоминается голосовым отметкой в самом сообщении (часть `data-voice-mode` в `parts`), поэтому миграции для этого нет, пометки выводятся из сохранённого и кэш модели цел. Тексты задают настройки агента `voiceModeHint` и `textModeNote` (есть умолчания).
+  
+  Обновление ничего не ломает: без нового пакета чат работает как раньше. Диктовка в поле ввода (`@ykurilov/agent-chat-voice`) не меняется.
+  
+  ### Как обновить приложение
+  
+  Нужно, только если вы хотите голосовой режим.
+  
+  1. Поставьте пакет `@ykurilov/agent-chat-voice-dialog` той же версии, что и остальные пакеты SDK. Скин Тандем обновите вместе с SDK: договор скина теперь версии 10 (необязательный `dialog` у поля ввода, панель режима, меню голосов, отметка обрыва; свой скин может их не рисовать, тогда кнопки режима не будет).
+  2. Сервер. Рядом с чатом подключите режим (нужен WebSocket; с Hono и `@hono/node-ws`):
+  
+     ```ts
+     import { mountDialogRelay } from "@ykurilov/agent-chat-voice-dialog/hono";
+  
+     mountDialogRelay(app, {
+       path: "/api/voice-dialog",
+       upgradeWebSocket,
+       storage,
+       resolveUser,                 // тот же вход, что у чата
+       spendingLimits,              // по желанию
+       logError: (message) => console.error(message),
+       speech: {
+         voices: [{ id: "oE0n0S3wK5Mj9C62iehn", name: "Профессиональный диктор для аудиокниг" }],
+         defaultVoiceId: "oE0n0S3wK5Mj9C62iehn",
+         pricePerThousandChars: { eleven_v4_turbo: 0.11, eleven_v4: 0.22 }, // ваша цена, $ за 1000 знаков
+       },
+     });
+     ```
+  
+     Ключи `ELEVENLABS_API_KEY` и `SONIOX_API_KEY` — в окружении сервера. Next.js: WebSocket нужен свой Node-сервер, см. README пакета (`createDialogRelay`).
+  3. Браузер:
+  
+     ```tsx
+     const voiceDialog = createVoiceDialogEngine({ basePath: "/api/voice-dialog" });
+     <AgentChat api="/api/chat" skin={tandemSkin} voiceDialog={voiceDialog} />
+     ```
+  
+  4. Настройки. Слова остановки и междометия по умолчанию только русские; для другого языка задайте `bargeIn.stopWords` и `bargeIn.ignoreWords` у движка и `language` на сервере. Строгая политика содержимого страницы: добавьте `worklet-src blob:`.
+  5. Хранилище. SQLite получает миграцию 0008, PostgreSQL — 0007 (схема `agent_chat`) сами при открытии базы. Свой `ChatStorage`: добавьте необязательные методы `setVoiceCut`, `getVoiceChoice`, `setVoiceChoice` (без них отметка обрыва и выбор голоса живут только до перезагрузки) и значение `"speech"` в `UsageSource`, если учёт расхода у вас свой.
+  6. Свой экран (не наш скин): части сообщения с типом `data-voice-mode` не рисуйте, показывайте только текстовые части.
+  7. Проверка: `pnpm typecheck` проходит; в чате появилась кнопка режима, после нажатия виден статус «Слушаю», фраза уходит сообщением, ответ звучит.
+- d12dcf3: Голосовой режим: звуки человека (смех, вздох, кашель…) доходят до модели.
+  
+  - Звук с микрофона параллельно с Soniox уходит с нашего сервера в ElevenLabs Scribe (`scribe_v2`, `tag_audio_events`); слова Scribe не использует, ключ остаётся на сервере. Звук уходит кусками прямо во время фразы: каждые `sounds.chunkSeconds` (1,5 с) нового звука, с перекрытием `sounds.overlapSeconds` (0,5 с), на конце фразы — только хвост; повторы на перекрытии схлопываются. Тишина (тише `sounds.silenceRms`, 0,01) не отправляется. На конце фразы ждётся только хвост и ещё не вернувшиеся куски, не дольше `sounds.waitMs` (1000 мс, по замеру Scribe отвечает за 0,7–0,95 с): не успел — звуки приклеятся к следующей фразе. Куски не копятся в очередь (не больше двух запросов). Расход считается по фактически отправленным секундам, включая перекрытия. Фраза из одного смеха без слов ход модели не запускает.
+  - Звуки лежат в сообщении человека, в части `data-voice-mode` (`data: { sounds: ["laughter"] }`), уходят на сервер как `voiceSounds` вместе с `voiceMode` (значение не из закрытого списка — 400 `invalid`). Пометка для модели («были слышны его звуки: смех») выводится из сохранённого при сборке запроса: начало запроса от хода к ходу не меняется, кэш цел; склейка фраз сохраняет звуки обеих. На экране звуков нет. В пометке входа в режим появилось короткое правило про пометку звуков.
+  - Эхо: звук того же вида, пойманный, пока играл кусок озвучки агента с таким же звуком (тег «[laughs]», заполнитель, отдельное «Ха-ха!»), плюс короткий хвост на задержку микрофона (`soundEchoTailMs`, 0,6 с), звуком человека не считается; смех в ответ на шутку агента доходит.
+  - Ошибка или недоступность Scribe режим не ломает: разговор идёт без звуков, в журнал — предупреждение. Расход пишется записью `source: "sounds"` (`inputTokens` — секунды звука) и входит в лимиты расходов.
+  - Новое: `sounds` у `createDialogRelay` и `mountDialogRelay` (`pricePerHour` обязательна), `sendVoiceMessage(text, { sounds })` и `replaceLastVoiceMessage(text, { sounds })` (`react`, `DialogChatBridge.send/replaceLastMessage` получили `options`), `voiceSounds` у `SendMessageOptions` и в теле `…/messages`, `…/edit`, экспорты `core`: `VOICE_SOUNDS`, `isVoiceSound`, `uniqueVoiceSounds`, `voiceSoundsNote`, `soundsOfMessage`, `UsageSource` получил `"sounds"`; `react`: тип `VoiceSound`; `voice-dialog/server`: `createScribeSounds`, `createSoundsUsage`, `HUMAN_SOUND_KINDS`.
+  
+  Как обновить приложение: ничего не требуется, пока `sounds` не задан. Чтобы включить, добавьте `sounds: { pricePerHour }` (цену Scribe берите из прайса ElevenLabs; v2 — 0,22 $ за час) в настройки режима; ключ тот же `ELEVENLABS_API_KEY`. Своё хранилище расходов должно принимать `source: "sounds"` (текстовое поле, миграций не нужно). Пометка входа в режим по умолчанию стала длиннее на одно правило: кэш модели у идущих голосовых чатов один раз промахнётся. Свой `agent.voiceModeHint` (строка) заменяет пометку входа целиком, правило про звуки в нём не появится, но пометка звуков у сообщений всё равно добавится.
+- 366d785: Голосовой режим: свой набор тегов эмоций у каждого голоса.
+  
+  - В описании голоса (`speech.voices[].tags`) можно задать `{ allowed, avoid? }`: какие теги голосу идут и какие нет. Модель получает список текущего голоса в пометке входа в режим. Голос без набора получает общий список, его пометка не меняется ни на байт.
+  - Голос человека сохраняется на его сообщении в части `data-voice-mode` (`data: { voice: id }`, без миграции базы). Если голос сменился посреди разговора, первое сообщение с новым голосом один раз получает пометку с его тегами; голоса с одинаковым списком пометки не получают. Пометки выводятся из сохранённых отметок: повтор ответа, правка, перезагрузка и возврат к тексту дают то же начало запроса, кэш модели цел.
+  - Новое: `agent.voices` у `createChatService` и `createChatHandler` (интерфейс `VoiceTagSource`), `speech.catalog` у `mountDialogRelay` и `createDialogRelay` (готовый каталог голосов вместо `voices` и `defaultVoiceId`), `VoiceCatalog.tagsOf`, экспорты `core`: `VoiceTagSet`, `VoiceTagSource`, `voiceModeHint`, `voiceChangeNote`, `assertVoiceTagSet`, `sameVoiceTagSet`, `voiceOfMessage`. Наборы проверяются при запуске по правилу тега с экрана; экрану в `GET …/voices` они не уходят.
+  
+  Как обновить приложение: ничего не требуется, пока наборов нет. Чтобы задать наборы, создайте каталог `createVoiceCatalog({ voices, defaultVoiceId, storage })` и передайте его и чату (`agent.voices`), и режиму (`speech.catalog`); подробности — в README пакета, раздел «Свой набор тегов у каждого голоса». Если вы задавали свой `voiceModeHint` (строка), он по-прежнему заменяет пометку целиком, без пометок о тегах голоса.
+- 946e5d8: Голосовой режим: теги эмоций и подачи голоса.
+  
+  - Модель получает список тегов Eleven v4 («[laughs]», «[sighs]», «[whispers]», «[excited]» и других) и может ставить их в ответ; голос их отыгрывает, а на экране их нет: ни в тексте ответа, ни при копировании, ни в поиске по прошлым разговорам. Это касается только ответов голосовых ходов (сообщение человека с отметкой `data-voice-mode`): в текстовом режиме и в сводке сжатия скобки остаются как есть («[docs]», «[error]» там обычные слова). Обычные скобки («[1]», ссылки, чекбоксы, код) не трогаются. В истории для модели теги остаются, кэш цел.
+  - Одиночный тег больше не обрывает реплику: сервер не отправляет в озвучку текст без букв и цифр, а тег приклеивается к соседнему предложению; тег в конце ответа («Да. [laughs]») — к последнему.
+  - Смех и вздох агента в микрофоне не считаются перебиванием: звуки сверяются по шаблону («ха-ха-ха-ха», «ооох»), составные слова («Дай-ка») — по частям.
+  - Новые экспорты: `stripVoiceTags`, `splitVoiceTags` (`core` и `react`), `voiceAnswerIds` (`react`), `isVoiceMessage`, `VOICE_TAGS`, `DEFAULT_VOICE_MODE_HINT`, `DEFAULT_TEXT_MODE_NOTE` (`core`). `messageText` (`react`) и `searchableText` (`history-search`) получили параметр `{ voiceAnswer }`. `sendVoiceMessage` кладёт отметку `data-voice-mode` в сообщение сразу.
+  
+  Как обновить приложение: ничего не требуется. Пометки по умолчанию обновятся сами; кэш модели у идущих голосовых чатов один раз промахнётся. Если вы задавали свои `voiceModeHint` и `textModeNote`, теги в них не появятся: добавьте их сами, если нужны. Свой скин, который сам выводит текст ответа, должен вырезать теги только у ответов голосовых ходов (`voiceAnswerIds`). Побочный эффект: в ответе голосового хода слово в скобках, похожее на тег («[Google]»), тоже не показывается.
+
+### Patch Changes
+
+- b6f4855: OpenRouter: шифр рассуждений GPT и подпись рассуждений Gemini больше не теряются на ходах без вызова инструмента. Раньше провайдер SDK оставлял их только в итоге шага, и ни в хранилище, ни в следующем запросе их не было; модель получала историю без своих прежних рассуждений (у Gemini в консоль шло предупреждение «reasoning_details entries were removed because they were missing signatures»).
+  
+  - Модель OpenRouter обёрнута: полные детали шага сохраняются вместе с текстом ответа, а перед запросом переносятся на сообщение агента.
+  - Ответы чужой модели по-прежнему уходят без рассуждений и шифра.
+  - Сами модели загаданное из рассуждений пока не вспоминают (живая проверка в `specs/003-models-and-picker/live-results.md`); правка убирает потерю на нашей стороне.
+  
+  Обновление ничего не требует.
+- 7fbc105: Вызов инструмента без результата больше не ломает чат. Раньше после «Стоп» во время инструмента, обрыва провайдера или перезапуска сервера любой следующий вопрос в этом чате сразу получал ошибку, а модель даже не вызывалась (`AI_MissingToolResultsError`); сжатие такого чата тоже падало. Теперь каждый такой вызов (`input-available` или только промежуточный результат) перед запросом к модели закрывается ошибкой с постоянным текстом `HANGING_TOOL_CALL_REASON`: «Вызов инструмента оборвался до результата: действие могло выполниться частично или целиком. Не повторяй его, не проверив, что уже сделано». Закрытие делается при каждой сборке запроса одинаково, хранилище не меняется, кэш модели цел. Конец хода со статусом `stopped` или `error` и `recoverInterruptedAnswers` записывают такое же закрытие и в хранилище; запросы подтверждения закрываются прежними текстами. Заодно из запроса вырезаются непарные половинки эмодзи в тексте, рассуждениях и вызовах инструментов, в том числе из старой истории; целые эмодзи остаются.
+
+## 0.13.0
+
+### Minor Changes
+
+- 4793e4d: Чат запоминает последний выбор человека: провайдера, модель и уровень рассуждений. Новый чат открывается на них, а не на модели по умолчанию. Если модели больше нет в каталоге или у её провайдера нет ключа, новый чат открывается на выборе по умолчанию из настроек; уровень, которого у модели нет, заменяется её уровнем по умолчанию. У каждого человека свой выбор, старые чаты с сообщениями остаются на своём, а пустой чат, который открывается кнопкой «Новый чат», переходит на последний выбор. Запоминается последний выбор, в том числе сделанный в старом чате. При двух открытых вкладках побеждает позже пришедший запрос. Выбор хранится по человеку и общий для всех обработчиков на одной базе; недоступная модель заменяется моделью по умолчанию. Новый чат сразу показывает запомненный выбор, без мигания моделью по умолчанию.
+  
+  Обновление ничего не требует: SQLite и PostgreSQL получают новую таблицу сами при открытии базы (SQLite — миграция 0007, PostgreSQL — миграция 0006 в схеме `agent_chat`), встроенное хранилище в памяти тоже умеет запоминать.
+  
+  ### Как обновить приложение со своим хранилищем
+  
+  Нужно только если приложение передаёт в `createChatHandler` собственное хранилище (свою реализацию `ChatStorage`). Без этого шага всё продолжит работать как раньше: новые чаты будут открываться на `defaultChoice`.
+  
+  1. В своём хранилище добавьте два необязательных метода из `ChatStorage`:
+  
+     ```ts
+     getUserModelChoice(ownerId: string): Promise<{ modelId: string; providerId: string; reasoning?: string } | null>;
+     saveUserModelChoice(ownerId: string, choice: { modelId: string; providerId: string; reasoning?: string }): Promise<void>;
+     ```
+  
+     Один выбор на человека (`ownerId`): повторная запись заменяет прежний, запись без `reasoning` стирает сохранённый уровень. С чатами выбор не связан: удаление чата его не трогает. Пример запросов — в `packages/storage-sqlite/src/sqlite-storage.ts`.
+  2. Добавьте таблицу или коллекцию под выбор (SQLite: `owner_id` — первичный ключ, `model_id`, `provider_id`, `reasoning` — может быть пустым, `updated_at`).
+  3. В тестах хранилища вызов `describeChatStorageContract(createStorage)` сам проверит новые методы; если они есть, проверки пройдут, если нет — будут пропущены.
+  4. Проверка: `pnpm typecheck` проходит; сменить модель в чате, открыть новый чат — на нём та же модель.
+
+## 0.12.0
+
+No changes in this release.
+
+## 0.11.0
+
+No changes in this release.
+
+## 0.10.0
+
+### Minor Changes
+
+- 4a76ff3: **Ломает приложения:** у `ChatStorage` появились обязательные операции `updateAwaitingMessage` и `getMessage`, у словаря `ChatLabels` — новые ключи `approval*`; касается приложений со своим хранилищем и с полным словарём надписей.
+  
+  Подтверждение перед опасными действиями агента. Инструмент, помеченный `needsApproval: true` (или функцией от входных данных), не выполняется без разрешения человека: ход останавливается, в ленте появляется карточка с названием действия, входными данными и кнопками «Разрешить», «Отклонить» и «Всегда в этом чате». Кнопка «Всегда» есть только у инструмента с `needsApproval: true`; у инструмента с функцией её нет, каждый вызов спрашивает заново. Ждать можно сколько угодно: состояние лежит на сервере, переживает перезагрузку страницы и перезапуск сервера, ответить можно с любого устройства.
+  
+  Что изменилось:
+  
+  - `@ykurilov/agent-chat-core`: статус ответа `awaiting_approval`; `answerApproval` у сервиса чата; ответ после решения дописывается в то же сообщение, инструмент выполняется ровно раз. «Отклонить» — модель получает «пользователь отклонил» и продолжает. Новое сообщение вместо ответа на карточку считается отказом. Сбой или «Стоп» после «Разрешить» не оставляют вызов без итога: он закрывается как прервавшийся («результат неизвестен», если инструмент уже мог сработать). Ответ на карточку проверяет лимит расходов (429), а расход паузы и продолжения не считается дважды. После смены модели во время ожидания продолжение идёт на модели ждущего сообщения. Кэш модели не страдает: инструкция и набор инструментов не меняются.
+  - `@ykurilov/agent-chat-server`: адрес `POST /:chatId/approvals/:approvalId` с телом `{ "decision": "allow" | "deny" | "always" }`. Ошибки: 409 `busy` (в чате идёт другой ход), 409 `approval_not_pending` (на этот запрос отвечать уже нечем), 429 `spending_limit_reached`.
+  - `@ykurilov/agent-chat-storage-sqlite`, `@ykurilov/agent-chat-storage-postgres`: реализуют `updateAwaitingMessage` и `getMessage`. Схема базы не меняется, миграции не нужны: статус ответа хранится обычным текстом.
+  - `@ykurilov/agent-chat-react`: договор скина версии 9 — у `ToolCallRow` необязательные `title` и `approval`; хук `useAgentChat` отдаёт `respondToApproval`, `approvalPendingId`, `approvalFailure` (вид сбоя: нет связи, чат занят, лимит расходов, запрос уже не ждёт); при неудачной отправке карточка возвращается к кнопкам, а не остаётся «отклонённой». У `ToolApprovalView` в состоянии `requested` есть `canAlways` (показывать ли «Всегда») и необязательный `failureText`. Словарь получил ключи `approvalRequested`, `approvalWaiting`, `approvalAllow`, `approvalDeny`, `approvalAlways`, `approvalFailed`, `approvalSpendingLimit`, `approvalBusy`, `approvalAllowedMark`, `approvalAlwaysMark`, `approvalDeniedMark`, `approvalAnnouncement`.
+  - `@ykurilov/agent-chat-skin-tandem`: карточка подтверждения (группа с названием для читалки, «Ждёт вашего решения» и итог озвучиваются, фокус не теряется, на телефоне длинные поля не выпирают) и пометка решения в строке вызова.
+  
+  ### Как обновить приложение
+  
+  Если опасных инструментов нет, а хранилище и скин стандартные, обновление ничего не требует.
+  
+  1. Своё хранилище (`ChatStorage`): добавьте `getMessage(messageId)` — вернуть сообщение по номеру или `null`. И добавьте `updateAwaitingMessage(messageId, patch)` — перезаписать `parts` ответа со статусом `awaiting_approval` и, если в `patch.status` указано, сменить статус на `"streaming"` или `"complete"`; ответ не в этом статусе — бросить `MessageNotAwaitingError`. Готовый образец — `packages/storage-sqlite/src/sqlite-storage.ts`. Проверка: `describeChatStorageContract` из `@ykurilov/agent-chat-core/storage-contract` проходит.
+  2. Полный свой словарь надписей (`ChatLabels`, объект без `...russianLabels`): добавьте двенадцать ключей `approval*` из списка выше. Словарь `{ ...russianLabels, … }` менять не нужно.
+  3. Свой скин: если `ToolCallRow` свой, добавьте разбор `approval` — `{ state: "requested", onDecide, pending, failed, failureText?, canAlways }` (нарисовать кнопки, `onDecide("allow" | "deny" | "always")`; «Всегда» показывать только при `canAlways`; при `failed` показать `failureText`, если он есть) и `{ state: "allowed" | "always" | "denied" }` (итог решения). Нет `approval` — рисуйте строку как раньше. Название действия — в `title`.
+  4. Чтобы включить подтверждение: у опасного инструмента задайте `needsApproval: true` (можно функцией от входных данных; с функцией кнопки «Всегда» не будет) и `title` — название для карточки. Больше ничего подключать не надо.
+  5. Проверка: `pnpm typecheck`; попросите агента вызвать опасный инструмент — в ленте карточка, после «Разрешить» действие выполнено, ответ дописан в то же сообщение.
+
+## 0.9.0
+
+### Minor Changes
+
+- d07a1c3: **Ломает приложения:** только если вы сами реализовали `ChatStorage` или собрали словарь надписей целиком (без `{ ...russianLabels, … }`); остальным ничего делать не нужно.
+  
+  Новый пакет `@ykurilov/agent-chat-limits`: лимиты расходов. Бюджет в долларах на человека, на чат или на то и другое; период — календарный месяц (по умолчанию), сутки или без обнуления. Исчерпанный лимит останавливает ход до его начала; при 80% чат предупреждает.
+  
+  Что изменилось:
+  
+  - Ядро: цены в профиле модели (`ModelProfile.pricing` по провайдерам; вход, выход, чтение и запись кэша, рассуждения считаются как выход). Цены есть у всех стандартных моделей. Журнал расхода `usage_records` — токены и стоимость в долларах (`costUsd`, по ценам модели на момент хода) каждого ответа и фонового сжатия, в том числе сжатия, которое не удалось, но было оплачено; запись датируется началом хода. Журнал только дописывается и переживает удаление чата. Сумма лимита берётся из записей, поэтому смена цен и удаление модели из каталога прошлый расход не меняют. Новые методы хранилища `insertUsageRecord` и `sumUsage`.
+  - Ядро: `createChatService({ limits })` и `ChatService.getSpendingStatus`. Проверка идёт перед отправкой, повтором, переделкой и правкой, до любых записей; исчерпание — `SpendingLimitReachedError`.
+  - Сервер: `createChatHandler({ limits })`. Исчерпанный лимит — `429 {"error":{"kind":"spending_limit_reached","scope","period","resetsAt"}}`; новый адрес `GET /api/chat/:id/spending` (без сумм в долларах).
+  - `@ykurilov/agent-chat-limits`: `createSpendingLimits({ storage, catalog, budget, period?, warnAt?, unpricedModels?, now?, logError? })` и `getSpending({ userId, chatId })` для страницы «тариф» (расход чата считается только среди записей этого человека). Своя модель без цены — понятная ошибка при создании; явно `unpricedModels: "ignore"` — такие ходы пишутся с нулевой стоимостью. `compactNow` лимит не проверяет: ручное сжатие остаётся доступным.
+  - Хранилища: SQLite (миграция `0006`) и PostgreSQL (миграция `0005`) добавляют таблицу `usage_records`; миграции применяются при открытии хранилища сами, существующие данные не трогаются. Проверено на копии базы песочницы.
+  - Браузер: `AgentChat` принимает `spendingLimits`. Договор скина версии 8: необязательный компонент `SpendingNotice({ id, state, text })` (`state` бывает `none`: область для диктора всегда на странице) и необязательные свойства `Composer.sendingBlocked` и `Composer.sendingBlockedReasonId` (для `aria-describedby`). Скин Тандема их рисует; при остановке фокус переходит на надпись и возвращается в поле, когда лимит снят. Отказ 429 не запускает переподключения: текст возвращается в поле (при правке сообщения редактор остаётся открытым с текстом и надписью `editErrors.spendingLimit`), показывается «Лимит на месяц исчерпан, обновится 1 ноября»; исчерпание снимается само в момент обновления.
+  - Словарь надписей: `spendingWarning` и `spendingExhausted` (функции от сведений о лимите) и `editErrors.spendingLimit`.
+  
+  Не входит в расход: веб-инструменты (`web-tools`, другой сервис), незаконченный шаг остановленного хода и ход, оборванный перезапуском сервера. Ход, начатый в пределах бюджета, доводится до конца; одновременные ходы могут вместе выйти за бюджет (проверка не резервирует деньги).
+  
+  ### Как обновить приложение
+  
+  Если лимиты не нужны, делать ничего не нужно, кроме двух случаев:
+  
+  1. **Только если вы реализовали `ChatStorage` сами:** добавьте `insertUsageRecord(record)` и `sumUsage(filter)` (запись расхода несёт `costUsd`, сумма возвращает `costUsd`) и прогоните `describeChatStorageContract` (в нём появился блок «записи расхода»). Хранилища SQLite и PostgreSQL из этого репозитория обновляются сами.
+  2. **Только если словарь надписей написан целиком** (не через `{ ...russianLabels, … }`): добавьте функции `spendingWarning` и `spendingExhausted` и надпись `editErrors.spendingLimit`. Значения — в `russianLabels`.
+  
+  Чтобы включить лимиты:
+  
+  1. `pnpm add @ykurilov/agent-chat-limits`.
+  2. На сервере: `const limits = createSpendingLimits({ storage, catalog, budget: async ({ userId }) => ({ user: 5 }) })` и `createChatHandler({ …, limits })`. `storage` и `catalog` — те же, что у чата.
+  3. В браузере: `<AgentChat … spendingLimits />`. Скин свой — добавьте `SpendingNotice` (с `id`, состоянием `none` и `role="status"`) и учтите `Composer.sendingBlocked` и `sendingBlockedReasonId`; нет их — надписи не будет, но отправка остановится.
+  4. Проверка: с маленьким бюджетом чат сначала предупреждает, потом останавливает отправку и пишет дату обновления.
+
+## 0.8.0
+
+### Minor Changes
+
+- a24c79d: **Ломает приложения:** у `ChatStorage` три новых обязательных метода (`listChats`, `renameChat`, `deleteChat`), у `AttachmentStorage` — один (`removeAllOfChat`), а у `ChatLabels` — 16 новых обязательных надписей `chatList*`. Приложения на готовых хранилищах и готовом словаре надписей ничего менять не должны; поломка только у своих реализаций.
+  
+  Список чатов в боковой панели: создать чат, переименовать, удалить. Чат сам получает название по первому сообщению. Это расширение по желанию: приложение без `chatList` и без `ChatWorkspace` работает как раньше.
+  
+  Что изменилось:
+  
+  - `@ykurilov/agent-chat-core`: `createChatService` умеет `listChats(userId)`, `renameChat(userId, chatId, title)`, `deleteChat(userId, chatId)`. Название ставится по первому сообщению (до 60 знаков), вручную заданное не перезаписывается; длина названия до 100 знаков. Удаление настоящее: идущий ответ и сжатие останавливаются, затем убираются сообщения, записи сжатия, выбор веток, файлы вложений и сам чат. Чужой и несуществующий чат — одинаково `ChatNotFoundError`. Экспортируются `deriveChatTitle`, `normalizeChatTitle`, `InvalidChatTitleError`, тип `ChatListItem`. `Chat.title` необязательное. Набор проверок `describeChatStorageContract` расширен.
+  - `@ykurilov/agent-chat-server`: `createChatHandler({ chatList: true })` включает три адреса: `GET {basePath}` (список), `PATCH {basePath}/:id` с телом `{ title }`, `DELETE {basePath}/:id`. Без `chatList` эти адреса отвечают 404. Чужой чат — 404, неверное название — 400. Идущий ответ удалению не мешает: он останавливается. `409` при удалении — только если чат уже удаляется или в этот миг запускается ход; пока чат удаляется, сообщение, сжатие и вложения в него тоже получают `409`. Переименование `409` не даёт.
+  - `@ykurilov/agent-chat-storage-sqlite` и `@ykurilov/agent-chat-storage-postgres`: колонка `title` у чатов, методы `listChats`, `renameChat`, `deleteChat` (удаление в одной транзакции). Миграция сама заполняет названия старых чатов по их первому сообщению.
+  - `@ykurilov/agent-chat-attachments`: `AttachmentStorage` получил `removeAllOfChat(chatId)`; `createAttachments` отдаёт ядру `removeChatFiles`, и файлы удаляются вместе с чатом. Набор `describeAttachmentStorageContract` расширен.
+  - `@ykurilov/agent-chat-react`: компонент `ChatWorkspace` (список и открытый чат вместе), хук `useChatList`, у `AgentChat` необязательное `onBusyChange`. Договор скина версии 7: скин, который хочет работать с `ChatWorkspace`, дополнительно даёт `ChatWorkspace` и `ChatList` (тип `ChatListSkin`); договор самого чата не менялся. 16 новых надписей `chatList*` в словаре (`ChatLabels`).
+  - `@ykurilov/agent-chat-skin-tandem`: `TandemChatWorkspace` и `TandemChatList`. На широком экране список слева, на узком — панель по кнопке «Чаты».
+  
+  ### Как обновить приложение
+  
+  Если список чатов не нужен, а хранилища и словарь надписей готовые, обновление ничего не требует.
+  
+  Если у приложения своё `ChatStorage`:
+  
+  1. Добавьте методы `listChats(ownerId)`, `renameChat(chatId, title | null)` и `deleteChat(chatId)`. Список — только чаты владельца, самые недавно менявшиеся первыми; `deleteChat` убирает сообщения, записи сжатия, выбор веток и чат одной транзакцией. Точные правила — в общем наборе проверок.
+  2. Храните название чата (`Chat.title`, необязательное) и проведите свою миграцию.
+  3. Проверка: `describeChatStorageContract` из `@ykurilov/agent-chat-core/storage-contract` проходит.
+  
+  Если у приложения своё `AttachmentStorage`: добавьте `removeAllOfChat(chatId): Promise<number>` (удалить все файлы чата, вернуть сколько) и прогоните `describeAttachmentStorageContract`.
+  
+  Если у приложения свой полный словарь надписей (`ChatLabels` целиком, а не `{ ...russianLabels, … }`): добавьте 16 новых ключей, иначе `pnpm typecheck` упадёт. Простые строки: `chatListHeading` («Чаты»), `chatListNewChat` («Новый чат»), `chatListUntitled` («Новый чат»), `chatListLoading`, `chatListLoadFailed`, `chatListCreateFailed`, `chatListRenameFailed`, `chatListDeleteFailed`, `chatListRename`, `chatListRenameField`, `chatListDelete`, `chatListDeleteTitle`, `chatListDeleteConfirm`, `chatListDeleteCancel`. Функции от названия чата: `chatListRowMenu(title)` («Действия с чатом …») и `chatListDeleteBody(title)`.
+  Было: `const labels: ChatLabels = { …прежние надписи }`. Стало: те же надписи плюс 16 новых; проще всего `{ ...russianLabels, …свои }`.
+  
+  Чтобы включить список чатов:
+  
+  1. Сервер: `createChatHandler({ …, chatList: true })`. Базы SQLite и PostgreSQL обновятся сами при открытии.
+  2. Браузер: вместо `<AgentChat api chatId … />` — `<ChatWorkspace api="/api/chat" skin={tandemSkin} … />` (те же остальные свойства, кроме `chatId`). Открытый чат приложение может показывать в адресе: `initialChatId` и `onChatChange`.
+  3. Если скин свой: добавьте `ChatWorkspace` и `ChatList` по договору версии 7 (`ChatListSkin`). Скин Тандема обновляется вместе с пакетом.
+  4. Если приложение само создавало чат кнопкой «Новый чат», уберите её: «Новый чат» теперь в списке.
+  5. Проверка: `pnpm typecheck` (ловит недостающие методы хранилищ и надписи); в списке видны чаты пользователя, «Новый чат» открывает пустой чат, после первого сообщения чат получает название, переименование и удаление (с подтверждением) работают.
+
+## 0.7.0
+
+### Minor Changes
+
+- b8f9e9f: **Ломает приложения со своими хранилищами и своими скинами:** ответ агента можно переделать, а отправленное сообщение исправить; все варианты сохраняются, между ними переключает «‹ 2/3 ›».
+  
+  Что изменилось:
+  
+  - Под ответом агента появилась кнопка «Переделать ответ»: агент отвечает на тот же вопрос заново, прежний ответ остаётся вариантом. Под сообщением собеседника появился карандаш «Изменить сообщение»: правка идёт на месте пузыря, отправляется новой веткой с новым ответом агента.
+  - Когда у сообщения больше одного варианта, рядом стоит переключатель «‹ 2/3 ›». Выбранный вариант запоминается на сервере: после обновления страницы или на другом устройстве открывается он же.
+  - Ничего не удаляется и не переписывается: журнал переписки только дописывается, выбор варианта — отдельная запись в новой таблице `branch_selections`.
+  - Модель видит только текущую ветку: после правки она не знает прежнего текста, после переключения на прежний вариант — знает. Инструкция и инструменты в запросе не меняются, кэш модели ветки не задевают. Сжатие истории и поиск по старой переписке работают по текущей ветке (сводка действует на ветке, где она сделана).
+  - Правка сообщения с файлами (пакет вложений): файлы остаются как были и переходят в новый вариант, меняется только текст; убрать или добавить файл при правке нельзя. Сообщение из одних файлов можно отправить и с пустым текстом. Файлы проходят ту же проверку сервера, что и при обычной отправке.
+  - Пока идёт ответ, переключать, переделывать и править нельзя: сервер отвечает 409 `busy`, кнопки в экране неактивны. Если отказ всё же пришёл (ответ пошёл с другой вкладки), поле правки остаётся открытым с текстом собеседника и понятной ошибкой: текст не пропадает.
+  - Новые адреса в `createChatHandler`: `GET /api/chat/:id/branches`, `POST /api/chat/:id/branch`, `POST /api/chat/:id/regenerate`, `POST /api/chat/:id/edit`; развилки приходят и в `GET /api/chat/:id` (поле `forks`). Новые методы службы: `selectBranch`, `regenerate`, `editMessage`, `getBranchForks`. Хук `useAgentChat` отдаёт `forks`, `selectBranch`, `canRegenerate`, `regenerate`, `canEdit`, `edit` (возвращает `Promise<EditOutcome>`: правка началась, не началась или сервер отказал).
+  - Базы SQLite (миграция 0004) и PostgreSQL (миграция 0003) получают новую таблицу сами при первом запуске. Ничего запускать вручную не нужно.
+  - В скине Тандема строка с карандашом и переключателем занимает прежний промежуток между сообщениями: высота сообщений не меняется.
+  
+  ### Как обновить приложение
+  
+  1. Обновите все пакеты SDK одной командой: `pnpm update "@ykurilov/agent-chat-*" --latest`. Базы обновятся сами при первом запуске сервера.
+  2. **Если у приложения своё хранилище** (свой класс, реализующий `ChatStorage`): добавьте два метода и таблицу под них.
+  
+     ```ts
+     insertBranchSelection(record: StoredBranchSelection): Promise<void>; // дописать запись «выбран этот вариант»
+     listBranchSelections(chatId: string): Promise<StoredBranchSelection[]>; // записи чата по порядку добавления
+     ```
+  
+     `StoredBranchSelection` — `{ id, chatId, messageId, selectedAt }` (оба времени — строка ISO). Записи только добавляются, не меняются и не удаляются. Тип и общий тест `describeChatStorageContract` берутся из `@ykurilov/agent-chat-core`; тест теперь проверяет и эти методы. Приложения на памяти, SQLite и PostgreSQL из наших пакетов ничего не меняют.
+  3. **Если у приложения свой скин** (объект `ChatSkin` не из `@ykurilov/agent-chat-skin-tandem`): договор скина теперь версии 6 (версия 5 — голосовой ввод и вложения, необязательные `Composer.voice`, `Composer.attachments`, `UserMessage.attachments`). Добавьте два компонента и новые свойства сообщений.
+  
+     ```tsx
+     const BranchSwitcher: ChatSkin["BranchSwitcher"] = ({ position, count, onPrevious, onNext }) => {
+       const labels = useChatLabels();
+       return (
+         <div role="group" aria-label={labels.branchPosition(position, count)}>
+           <button type="button" aria-label={labels.previousBranch} disabled={!onPrevious} onClick={onPrevious}>‹</button>
+           {position}/{count}
+           <button type="button" aria-label={labels.nextBranch} disabled={!onNext} onClick={onNext}>›</button>
+         </div>
+       );
+     };
+     const MessageEditor: ChatSkin["MessageEditor"] = ({ value, onValueChange, onSave, onCancel, canSave, error, attachments }) => {
+       const labels = useChatLabels();
+       return (
+         <div>
+           {attachments && <ul aria-label={attachments.label}>{attachments.items.map((item) => <li key={item.id}>{item.name}</li>)}</ul>}
+           <textarea aria-label={labels.editMessage} value={value} onChange={(event) => onValueChange(event.target.value)} />
+           {error && <p role="alert">{error}</p>}
+           <button type="button" onClick={onCancel}>{labels.cancelEdit}</button>
+           <button type="button" disabled={!canSave} onClick={onSave}>{labels.saveEdit}</button>
+         </div>
+       );
+     };
+     const skin = { ...mySkin, BranchSwitcher, MessageEditor };
+     ```
+  
+     `UserMessage` получает свойства `branchSwitcher?: ReactNode` (положить рядом с сообщением) и `onEdit?: () => void` (кнопка «Изменить сообщение»; когда правка недоступна, свойства нет). `AgentMessage` получает `branchSwitcher?: ReactNode` и `onRegenerate?: () => void` (кнопка «Переделать ответ», только у последнего законченного ответа). Свойства необязательны: скин без них не ломается, только не показывает кнопок. Пример — `skins/tandem/src` в репозитории SDK.
+  4. **Если словарь надписей написан целиком**, а не через `{ ...russianLabels, … }`: добавьте ключи `previousBranch` («Предыдущий вариант»), `nextBranch` («Следующий вариант»), `branchPosition(position, count)` («Вариант 2 из 3»), `regenerate` («Переделать ответ»), `editMessage` («Изменить сообщение»), `saveEdit` («Отправить»), `cancelEdit` («Отмена»), `editErrors` — `{ busy: "Ответ ещё идёт. Дождитесь его конца и отправьте снова", offline: "Нет связи с сервером. Текст сохранён в поле", rejected: "Сервер не принял правку. Текст сохранён в поле" }`.
+  5. **Если приложение само собирает ленту через `useAgentChat`**: подключите `forks` и `selectBranch`, как в `packages/react/src/agent-chat.tsx`. Готовый `AgentChat` ничего менять не просит.
+  6. Проверка: `pnpm typecheck` проходит; отправьте сообщение, нажмите «Переделать ответ» — под ответом появится «2/2», стрелка «‹» вернёт первый вариант, после обновления страницы выбор сохранится. Подробности — раздел «Ветки ответов и правка сообщений» в `docs/getting-started.md`.
+- 7c205c4: Новый пакет `@ykurilov/agent-chat-attachments`: вложения к сообщению. В поле ввода появляются скрепка, перетаскивание и вставка файлов из буфера, превью с удалением; в ленте у сообщения — миниатюры картинок и плашки файлов. Картинки, PDF и текстовые файлы; тип определяется по содержимому.
+  
+  Что изменилось:
+  
+  - `@ykurilov/agent-chat-attachments`: `createAttachments({ storage, limits? })`, хранилища файлов `createDiskAttachmentStorage({ directory })` и `createMemoryAttachmentStorage()`, `attachmentsInstructions`, общий набор проверок своего хранилища `describeAttachmentStorageContract` (подпуть `/storage-contract`). Подпуть `/react`: `attachmentsClient`. Пределы по умолчанию: 10 файлов, 20 МБ на файл, потолок извлечённого текста; меняются в `limits`.
+  - Картинки уходят только моделям с `acceptsImages`; если модель не видит, человек узнаёт об этом до отправки. Текст PDF и текстовых файлов достаётся на сервере и идёт любой модели. Кэш модели не страдает: извлечённый текст не меняется от хода к ходу.
+  - `@ykurilov/agent-chat-core`: `createChatHandler`/`createChatService` принимают необязательное `attachments`; меню моделей несёт `acceptsImages`; задание сжатия просит назвать прикреплённые файлы в сводке (оригиналы остаются). Без `attachments` файлы в сообщении отклоняются.
+  - `@ykurilov/agent-chat-server`: новые адреса под адресом чата: `GET /attachments/settings`, `POST /:chatId/attachments`, `GET` и `DELETE /:chatId/attachments/:id`.
+  - `@ykurilov/agent-chat-react`: `AgentChat` принимает необязательное `attachments`. Договор скина версии 5: `Composer` и `UserMessage` получают необязательное `attachments`, у моделей в `ModelChoiceView` появилось необязательное `acceptsImages`.
+  - `@ykurilov/agent-chat-skin-tandem`: скрепка, превью, миниатюры и плашки файлов. Встроенный микрофон полного поля Тандема спрятан: голос — отдельная кнопка (пакет `voice`).
+  - Разбор PDF идёт в отдельном потоке с потолком памяти и сроком: зависший или «раздутый» файл обрывается, сервер живёт дальше; текст собирается до потолка символов.
+  - Лимиты на человека: `maxUnsentFiles` (30), `maxUnsentBytes` (200 МБ), `maxParallelUploads` (8), `maxParallelUploadsPerUser` (3); отказы 429 `too_many_unsent` и `busy`. Файлы с ошибкой в лимит не входят. Тело загрузки читается потоком без лишних копий. Поле ввода грузит файлы по два одновременно, остальные ждут в очереди, а на отказ `busy` повторяет несколько раз.
+  - Диск чистит недописанные остатки (`.tmp` и `.bin` без описания) по возрасту; неотправленные файлы убираются через 24 часа, прикреплённые не трогаются. Просроченный файл возвращается в поле с пометкой «загрузите снова».
+  - Файл помечается «прикреплён» только после записи сообщения (`confirmUserParts` в контракте `MessageAttachments`; `acceptUserParts` файлы не помечает). Отказ отправки возвращает текст и файлы в поле, повторный клик не очищает его раньше времени. Контракт `AttachmentsController` в `@ykurilov/agent-chat-react`: вместо `takeFiles` — `readFiles`, `markSent`, `restoreFiles`; `useAgentChat.submit` возвращает признак «принято».
+  - Текстовые логи с цветовыми кодами терминала (ANSI) принимаются как текст, коды убираются. Закрывающий тег `</attachment>` в тексте файла обезвреживается без учёта регистра.
+  - `MessageAttachments.instructions`: ядро само дописывает инструкцию про вложения к инструкции агента (один раз, дубль не появляется). Вручную `attachmentsInstructions` добавлять больше не нужно, но и не вредно.
+  - `@ykurilov/agent-chat-skin-tandem`: пока грузится список моделей, в поле со вложениями нет пустой кнопки «Выберите модель».
+  - Схема базы чата не меняется, миграции не нужны.
+  
+  ### Как обновить приложение
+  
+  Если вложения не нужны, обновление ничего не требует: без `attachments` чат работает как раньше.
+  
+  Чтобы включить вложения:
+  
+  1. `pnpm add @ykurilov/agent-chat-attachments`.
+  2. На сервере: `const attachments = createAttachments({ storage: createDiskAttachmentStorage({ directory: "./data/attachments" }) })`, передайте `attachments` в `createChatHandler` и инструкцию агенту про вложения ядро добавляет само. Папку с файлами включите в резервные копии вместе с базой.
+  3. В браузере: `<AgentChat … attachments={attachmentsClient} />` (`attachmentsClient` из `@ykurilov/agent-chat-attachments/react`).
+  4. Если скин свой: `Composer` получает `attachments` (скрепка, превью, `notice`), `UserMessage` — `attachments` (миниатюры и плашки). Нет свойства — ничего про вложения не рисовать. Свой скин на `@ykurilov/agent-chat-skin-tandem` обновляется вместе с пакетом.
+  5. Проверка: `pnpm typecheck`; в поле ввода есть скрепка, картинка и PDF прикрепляются, в ленте видны миниатюра и плашка, агент отвечает по содержимому.
+
+## 0.6.0
+
+### Minor Changes
+
+- 5252793: **Ломает приложения со своими хранилищами и своими скинами:** длинная переписка теперь сжимается сама, а у агента появился инструмент «поиск по старой переписке».
+  
+  Что изменилось:
+  
+  - Когда модель видит больше 200 тысяч токенов (у моделей с маленьким окном — 80% окна), ядро в фоне после ответа заменяет старую часть переписки короткой сводкой и оставляет свежие ~20 тысяч токенов как есть. Сообщения из базы не удаляются. В ленте на месте сжатия появляется строка «История сжата», по клику открывается сводка. Сжатие включено по умолчанию; `compaction: false` в `createChatHandler` (или `createChatService`) его выключает, `compaction: { thresholdTokens, tailTokens, summaryCeilingTokens, model, instruction }` настраивает.
+  - Новый пакет `@ykurilov/agent-chat-history-search`: инструмент `search_earlier_conversation`, который ищет точные детали в оригиналах старой переписки. Подключается по желанию.
+  - Новый адрес `GET /api/chat/:id/compactions` (в `createChatHandler`), новый метод службы `compactNow`, набор инструментов агента получает `chatId` хода.
+  - «Стоп» обрывает ожидание сжатия сразу (само сжатие доделывается в фоне). `chat.flush()` при остановке сервера ждёт идущие сжатия до `compaction.flushWaitMs` (30 секунд по умолчанию) и отменяет остальные без записи полусводки.
+  - Разделитель появляется без перезагрузки надёжно: сервер ставит признак «идёт сжатие» до конца потока ответа, а экран опрашивает `/compactions`, пока признак стоит (до 12 минут). `/compactions` стал лёгким: читает связи сообщений, а не тексты с выводами инструментов.
+  - Сводку пишет самый малый уровень рассуждений модели (или без них, где можно), а потолок вывода имеет запас, так что рассуждения не обрывают сводку по длине. Пауза после сбоя теперь действует и на исход «нечего сжимать».
+  - Поиск нормализует текст каждого сообщения один раз за вызов.
+  - Дедупликация сжатий живёт в памяти процесса, как и реестр идущих ответов: при нескольких копиях сервера возможно двойное сжатие и двойной расход токенов.
+  - Базы SQLite и PostgreSQL получают новую таблицу и новые поля сами при первом запуске. Ничего запускать вручную не нужно.
+  
+  ### Как обновить приложение
+  
+  1. Обновите все пакеты SDK одной командой: `pnpm update "@ykurilov/agent-chat-*" --latest`. Базы обновятся сами при первом запуске сервера.
+  2. **Если у приложения своё хранилище** (свой класс, реализующий `ChatStorage`): добавьте три метода.
+  
+     ```ts
+     insertCompaction(record: StoredCompaction): Promise<void>; // записать отметку сжатия
+     listCompactions(chatId: string): Promise<StoredCompaction[]>; // отметки чата по порядку добавления
+     listMessageLinks(chatId: string): Promise<MessageLink[]>; // { id, parentId, createdAt } сообщений чата, в порядке listMessages
+     ```
+  
+     Типы `StoredCompaction`, `MessageLink` и общий тест `describeChatStorageContract` берутся из `@ykurilov/agent-chat-core`; тест теперь проверяет и эти методы.
+     Приложения на памяти, SQLite и PostgreSQL из наших пакетов ничего не меняют.
+  3. **Если у приложения свой скин** (объект `ChatSkin` не из `@ykurilov/agent-chat-skin-tandem`): добавьте компонент `CompactionDivider`, договор скина теперь версии 4.
+  
+     ```tsx
+     const CompactionDivider: ChatSkin["CompactionDivider"] = ({ summary, open, onOpenChange }) => {
+       const labels = useChatLabels();
+       return (
+         <div>
+           <button type="button" aria-expanded={open} onClick={() => onOpenChange(!open)}>
+             {labels.historyCompacted}
+           </button>
+           {open && (
+             <div>
+               <p>{labels.historyCompactedHint}</p>
+               <pre>{summary}</pre>
+             </div>
+           )}
+         </div>
+       );
+     };
+     const skin = { ...mySkin, CompactionDivider };
+     ```
+  
+     `summary` — сводка в Markdown; свёрнутый разделитель — строка «История сжата». Скин Тандема обновляется вместе с пакетом.
+  4. **Если словарь надписей написан целиком**, а не через `{ ...russianLabels, … }`: добавьте ключи `historyCompacted` («История сжата») и `historyCompactedHint`.
+  5. Чтобы агент мог искать в сжатой переписке (по желанию): `pnpm add @ykurilov/agent-chat-history-search`, затем в `agent` обработчика добавьте `historySearchInstructions` в `instructions` и `...historySearch(model)` в `tools`; шаги и код — в разделе «Сжатие истории и поиск по старой переписке» файла `docs/getting-started.md`.
+  6. Проверка: `pnpm typecheck` проходит, чат открывается и отвечает. Кэш модели после первого сжатия обнуляется один раз (запрос после него дороже обычного), это ожидаемо.
+
+## 0.5.0
+
+### Minor Changes
+
+- 62027c6: Ломает приложения: в поле ввода появился выбор модели и уровня рассуждений, поэтому «какой моделью отвечать» теперь решает не сервер приложения на каждый ход, а пользователь в чате. Настройка `resolveModel` заменена на `defaultChoice` (модель для нового чата).
+  
+  Что нового простыми словами:
+  
+  - Стандартный набор моделей: DeepSeek 4.1 Flash, GLM 5.3 Flash, GPT 6 Luna, Gemini 3.8 Flash. Провайдеры: Fireworks, DeepSeek, Together и новый OpenRouter (ключ `OPENROUTER_API_KEY`, среди хозяев модели выбирается самый быстрый).
+  - В поле ввода одно меню моделей (провайдер → модель) и рядом выбор уровня рассуждений. Уровни свои у каждой модели: у DeepSeek «Выкл/Вкл», у GLM от «Низкий», у GPT и Gemini несколько уровней. У GPT рассуждения приходят зашифрованными: человеку виден только пересказ. На телефоне меню плоское («модель · провайдер»).
+  - Выбор запоминается в чате. Модель можно сменить посреди чата: рассуждения прежней модели в запрос новой не уходят, но в базе и на экране остаются. Если сохранённой модели больше нет в каталоге, чат открывается на выборе по умолчанию, сообщения не меняются.
+  - `extendCatalog` умеет больше: `removeProviders` (провайдер уходит, модель без провайдеров уходит вместе с ним) и `pinModelVersions` (закрепить версию модели у провайдера: `{ "gpt-6-luna": { openrouter: "openai/gpt-6-luna-2026-09-30" } }`). Ошибочная правка — ошибка при создании каталога.
+  - Новые адреса сервера: `GET /api/chat/models` (список для меню, без ключей) и `PUT /api/chat/:id/model` (записать выбор чата).
+  - Скин Тандема рисует `Composer` варианта `extended`. Договор скина стал версии 3: `Composer` получает необязательное `modelChoice`; свой скин без него работает как раньше. В `@ykurilov/agent-chat-react` есть хук `useModelChoice`.
+  - Кэш: у Gemini через OpenRouter метка кэша теперь стоит и на последнем сообщении истории (скользящая точка, на следующем ходе переезжает на новое), поэтому кэшируется вся переписка, а не только инструкция. Для своего провайдера то же задаётся полем `lastMessageProviderOptions` в `requestOptions`.
+  - Профиль модели получил отметку `toolResultImageProviders`: провайдеры, через которых модель видит картинку в результате инструмента (по живым замерам). У GPT 6 Luna и Gemini 3.8 Flash это `["openrouter"]`, у GLM 5.3 Flash и DeepSeek 4.1 Flash отметки нет. Ядро отметку не читает; по ней веб-инструменты решают, выдавать ли `page_screenshot`.
+  - Если ключа выбранного провайдера временно нет, ответ идёт на запасной модели, но выбор пользователя в чате не перезаписывается: когда ключ вернётся, чат снова отвечает выбранной моделью.
+  - Хранилища: у чата новое поле `reasoning` (уровень рассуждений). SQLite: колонка `chats.reasoning`, PostgreSQL: колонка `agent_chat.chats.reasoning`; миграции применяются сами при открытии базы, данные не теряются.
+  
+  ### Как обновить приложение
+  
+  1. Сервер (там, где `createChatHandler` или `createChatService`). Ищите `resolveModel`.
+  
+     Было:
+  
+     ```ts
+     createChatHandler({
+       // …
+       resolveModel: async () => ({ modelId: "deepseek-4.1-flash", providerId: "deepseek" }),
+       catalog: standardCatalog,
+     });
+     ```
+  
+     Стало:
+  
+     ```ts
+     createChatHandler({
+       // …
+       // Только для нового чата; дальше модель выбирает пользователь. Можно не задавать:
+       // тогда берётся первая модель каталога у первого провайдера с ключом.
+       defaultChoice: { modelId: "deepseek-4.1-flash", providerId: "deepseek" },
+       catalog: standardCatalog,
+     });
+     ```
+  
+     Раньше `resolveModel` мог выбирать модель по пользователю или чату. Теперь это делает пользователь в меню; ограничить выбор можно каталогом (`extendCatalog(standardCatalog, { removeProviders, removeModels, addModels, addProviders, pinModelVersions })`) и ключами на сервере: в меню попадают только провайдеры, чей ключ есть в окружении.
+  2. Ключи. Хотите GPT 6 Luna, Gemini 3.8 Flash или GLM через OpenRouter — добавьте `OPENROUTER_API_KEY` в окружение сервера. Без него этих моделей в меню не будет; остальное работает как раньше.
+  3. Свой словарь надписей. Если вы задали `ChatLabelsProvider labels={…}` не через `{ ...russianLabels, … }`, добавьте новые ключи: `reasoningLevels` (названия уровней: `off`, `on`, `minimal`, `low`, `medium`, `high`, `max`), `modelChoiceFailed` («Не удалось сменить модель») и `modelMenuFailed` («Список моделей не загрузился»). Через `{ ...russianLabels, … }` ничего делать не нужно.
+  4. Свой скин. Договор версии 3: `Composer` получает необязательное `modelChoice` (`providers`, `current`, `onChange`, `reasoningLevels`, `reasoning`, `onReasoningChange`, `error`). Не рисуете его — выбора модели в чате не будет, всё остальное работает. Подробно: `specs/003-models-and-picker/contracts/skin.md`. Скин Тандема (`tandemSkin`) обновляется вместе с пакетом, править нечего.
+  5. Своё хранилище (только если вы реализовали `ChatStorage` сами). Добавьте необязательное поле `reasoning?: string` в чат: `createChat` принимает и сохраняет его, `getChat` отдаёт (без значения — поля нет), `updateChatModel(chatId, { modelId, providerId, reasoning? })` записывает его целиком и без `reasoning` стирает сохранённый уровень. Наборы проверок `describeChatStorageContract` из `@ykurilov/agent-chat-core/storage-contract` проверяют это. Хранилища SQLite и PostgreSQL из SDK обновляются сами.
+  6. Проверка: `pnpm typecheck` проходит; в браузере в поле ввода есть меню моделей и выбор рассуждений; выбор остаётся после обновления страницы; сообщение отправляется и ответ приходит по частям.
+  7. Только если вы уже ставили `@ykurilov/agent-chat-web-tools` из main до этого выпуска: опция `screenshotProviders` убрана. Снимок страницы выдаётся по отметке `toolResultImageProviders` в профиле модели.
+  
+     Было:
+  
+     ```ts
+     const webTools = createWebTools({ ...firecrawl, screenshotProviders: ["openrouter"] });
+     ```
+  
+     Стало:
+  
+     ```ts
+     const webTools = createWebTools(firecrawl);
+     // Своя модель, у которой картинка из инструмента доходит через провайдера: добавьте отметку в профиль.
+     // extendCatalog(standardCatalog, { addModels: [{ ...профиль, toolResultImageProviders: ["openrouter"] }] })
+     ```
+- b059fcc: Переписку теперь можно хранить в PostgreSQL, а чат подключается к Next.js. Хранилища проверяются одним и тем же набором тестов.
+  
+  - Новый пакет `@ykurilov/agent-chat-storage-postgres`: `createPostgresChatStorage({ connectionString })`. Таблицы лежат в отдельной схеме `agent_chat`, миграции применяются сами при создании, два сервера на старте друг другу не мешают.
+  - В `@ykurilov/agent-chat-server` новая точка входа `@ykurilov/agent-chat-server/next`: `createNextRouteHandlers(chatHandler)` для файла маршрута App Router.
+  - В `@ykurilov/agent-chat-core` набор проверок `describeChatStorageContract` дополнен: порядок сообщений при равном времени, изоляция чатов, очень длинный ответ, пустые поля. Хранилище в памяти для тестов остаётся в ядре, отдельного пакета нет.
+  - В `@ykurilov/agent-chat-storage-sqlite` сообщения с одинаковым временем создания теперь читаются в порядке записи (раньше порядок между ними был не определён). Порядок держится на новой колонке `seq` в таблице `messages`, а не на внутреннем номере строки SQLite, который `VACUUM` вправе поменять. Миграция применяется сама при открытии базы: старые сообщения получают `seq` в том порядке, в каком лежали, данные не теряются.
+  
+  ### Как обновить приложение
+  
+  Только если вы берёте PostgreSQL или Next.js. Остальным обновление ничего не требует: SQLite и Hono работают как раньше, миграция SQLite (колонка `seq`) применится сама при первом запуске, делать с базой ничего не нужно.
+  
+  1. PostgreSQL вместо SQLite. В `server/index.ts` замените создание хранилища:
+  
+     Было:
+  
+     ```ts
+     const storage = createSqliteChatStorage({ filePath: "chat.sqlite" });
+     // при остановке: storage.close()
+     ```
+  
+     Стало:
+  
+     ```ts
+     import { createPostgresChatStorage } from "@ykurilov/agent-chat-storage-postgres";
+  
+     const storage = await createPostgresChatStorage({ connectionString: process.env.DATABASE_URL! });
+     // при остановке: await chat.flush(); await storage.close()
+     ```
+  
+     Адрес базы положите в `DATABASE_URL`. Пользователю базы нужно право создавать схему и таблицы. Переписку из SQLite пакет сам не переносит.
+  2. Next.js. Создайте `app/api/chat/[[...path]]/route.ts` с `createNextRouteHandlers` и строками `export const dynamic = "force-dynamic"` и `export const runtime = "nodejs"`; `basePath` обработчика чата должен совпадать с путём маршрута. Нужен долгоживущий сервер, не serverless. Пример и подробности: `docs/getting-started.md`, раздел «Next.js».
+  3. Проверка: `pnpm typecheck` проходит, чат отвечает по частям, «Остановить» работает.
+- 61717c6: У агента появились веб-инструменты: поиск в интернете, чтение страницы и скриншот страницы. Они вынесены в новый необязательный пакет; приложение, которому они не нужны, его не ставит и ничего не получает.
+  
+  - Новый пакет `@ykurilov/agent-chat-web-tools`: `createWebTools({ search, reader, screenshots? })` и готовые сервисы на Firecrawl `createFirecrawlServices({ apiKey, baseUrl?, headers? })` из подпути `@ykurilov/agent-chat-web-tools/firecrawl`. Сервис заменяется без правки инструментов (интерфейсы `WebSearchService`, `PageReaderService`, `PageScreenshotService`). Ключ и адрес сервиса остаются на сервере; `baseUrl` и `headers` позволяют идти через прокси. Подписи вызовов для ленты — `withWebToolTitles(russianLabels)` из подпути `@ykurilov/agent-chat-web-tools/labels`.
+  - Скриншот получают только модели с `acceptsImages: true`, у которых в профиле отмечено, что через выбранного провайдера они видят картинку в результате инструмента (`toolResultImageProviders`, см. запись про модели). Отмеченные в стандартном наборе: GPT 6 Luna и Gemini 3.8 Flash через OpenRouter.
+  - В `@ykurilov/agent-chat-core` `agent.tools` может быть функцией от выбранной модели: `(model: { profile, providerId }) => ToolSet`. Так набор инструментов зависит от модели. Обычный набор работает как раньше; экспортируются типы `AgentToolsSource` и `AgentToolsModel`.
+  
+  ### Как обновить приложение
+  
+  Только если нужны веб-инструменты. Остальным обновление ничего не требует.
+  
+  1. Поставьте пакет той же версии, что остальные: `pnpm add @ykurilov/agent-chat-web-tools`.
+  2. На сервере (там, где `createChatHandler`) добавьте инструменты и инструкцию к ним. Ключ Firecrawl — в переменной окружения сервера, не в браузерной части:
+  
+     ```ts
+     import { createWebTools, webToolsInstructions } from "@ykurilov/agent-chat-web-tools";
+     import { createFirecrawlServices } from "@ykurilov/agent-chat-web-tools/firecrawl";
+  
+     const firecrawl = createFirecrawlServices({ apiKey: process.env.FIRECRAWL_API_KEY!, baseUrl: process.env.FIRECRAWL_BASE_URL });
+     const webTools = createWebTools(firecrawl);
+  
+     createChatHandler({
+       // …
+       agent: {
+         instructions: `${appInstructions}\n${webToolsInstructions}`,
+         tools: (model) => ({ ...appTools, ...webTools(model) }),
+       },
+     });
+     ```
+  
+  3. В браузерной части подключите подписи: `<ChatLabelsProvider labels={withWebToolTitles(russianLabels)}>` вокруг `AgentChat` (`withWebToolTitles` — из `@ykurilov/agent-chat-web-tools/labels`).
+  4. Проверьте: `pnpm typecheck`; спросите агента «Найди в интернете последнюю версию Node.js» — в ленте появятся строки «Поиск в интернете: готово» и «Чтение страницы: готово», в ответе — ссылка на источник.
+
+## 0.4.0
+
+### Minor Changes
+
+- ad8cf59: **Ломает приложения:** из `@ykurilov/agent-chat-core` убраны 21 имя, которыми приложения не пользовались, и два параметра `fetch`/`now`.
+  
+  Что изменилось: идущий ответ пишется в базу не после каждого куска, а не чаще раза в 0,5 секунды. Длинные ответы больше не нагружают базу. При внезапном падении сервера теряется не больше 0,5 с текста, при штатной остановке — ничего, если вызвать новый метод `flush()` (у обработчика `createChatHandler` из `@ykurilov/agent-chat-server` он называется `chat.flush()`, у прямого `createChatService` — `service.flush()`). Ещё `registry` в `createChatService` стал необязательным: без него ядро создаёт его само.
+  
+  Убраны из публичного входа (были внутренними деталями): `createModelCatalog`, `MissingProviderKeyError`, `resolveLanguageModel`, `buildModelRequest`, `ModelRequest`, `createReasoningTimer`, `ReasoningTimer`, `DEFAULT_MAX_STEPS`, `runAgentTurn`, `AgentTurnInput`, `classifyProviderError`, `createTransientRetryMiddleware`, `transientRetryMiddleware`, `TransientRetryOptions`, `FIRST_CHUNK_TIMEOUT_MS`, `FirstChunkTimeoutError`, `isTransientProviderError`, `TRANSIENT_RETRY_DELAYS_MS`, `MAX_MESSAGE_LENGTH`, `ChatHistory`, `ChatServiceOptions`. Из настроек `createChatService` убран `fetch`.
+  
+  ### Как обновить приложение
+  
+  1. Найдите использование убранных имён: `grep -rnE "createModelCatalog|MissingProviderKeyError|resolveLanguageModel|buildModelRequest|createReasoningTimer|DEFAULT_MAX_STEPS|runAgentTurn|classifyProviderError|TransientRetry|transientRetryMiddleware|FIRST_CHUNK_TIMEOUT_MS|FirstChunkTimeoutError|isTransientProviderError|TRANSIENT_RETRY_DELAYS_MS|MAX_MESSAGE_LENGTH|ChatHistory|ChatServiceOptions" src server`. Если ничего не нашлось, шаг 2 не нужен.
+  2. Для найденного:
+     - Свой каталог моделей: вместо `createModelCatalog(...)` используйте `extendCatalog(standardCatalog, ...)`.
+     - Тип настроек службы: вместо `ChatServiceOptions` пишите `Parameters<typeof createChatService>[0]`.
+     - Остальные имена были внутренними, замены нет: уберите их использование. Свои повторы и ход агента вызывать напрямую больше нельзя, только через `createChatService`.
+  3. Если вы передавали `fetch` в `createChatService`, уберите его: для подмены сети в тестах подставляйте свою модель в каталог.
+  4. Штатная остановка сервера (по желанию, но рекомендуется): после того как сервер перестал принимать запросы, и до закрытия хранилища дождитесь дозаписи ответов. Если чат подключён через `createChatHandler` — вызывайте `await chat.flush()` (подробности в записи для `@ykurilov/agent-chat-server`). Если приложение работает напрямую с `createChatService` — `await service.flush()`.
+  
+     Было:
+  
+     ```ts
+     function shutdown() {
+       server.close();
+       closeStorage();
+       process.exit(0);
+     }
+     ```
+  
+     Стало (для прямого `createChatService`; с `createChatHandler` вместо `service` пишите `chat`):
+  
+     ```ts
+     async function shutdown() {
+       server.close();
+       await service.flush();
+       closeStorage();
+       process.exit(0);
+     }
+     ```
+  
+  5. Проверка: `pnpm typecheck` проходит, длинный ответ в чате идёт до конца, а после перезапуска сервера посреди ответа написанный текст на месте с отметкой «Ответ прерван».
+
+## 0.3.0
+
+### Minor Changes
+
+- a95b2d0: Появился третий поставщик модели DeepSeek 4.1 Flash — Together AI (`providerId: "together"`). Он входит в `standardCatalog` рядом с `deepseek` и `fireworks`; рассуждения и вызовы инструментов проверены на нём вживую.
+  
+  Обновление ничего не требует: приложения, которые работают с `deepseek` или `fireworks`, продолжают работать как раньше.
+  
+  ### Как подключить Together (по желанию)
+  
+  1. Положите ключ Together AI в переменную окружения сервера `TOGETHER_API_KEY` (в `.env` рядом с `DEEPSEEK_API_KEY` и `FIREWORKS_API_KEY`). Ключ не пишите в код и не отдавайте браузеру.
+  2. В `resolveModel` (там, где вы создаёте `createChatHandler`) верните нужного поставщика:
+  
+     ```ts
+     resolveModel: async () => ({ modelId: "deepseek-4.1-flash", providerId: "together" }),
+     ```
+  
+  3. Чат, начатый у другого поставщика, продолжается у Together без правок: рассуждения чужого поставщика в запрос не попадают.
+  4. Проверка: `pnpm typecheck` проходит, чат отвечает, а в журнале сервера нет «Нет ключа провайдера … TOGETHER_API_KEY».
+  
+  Если приложение проверяет, что браузерная сборка не содержит адресов провайдеров, добавьте в эту проверку `api.together.xyz` и `TOGETHER_API_KEY`.
+
+## 0.2.0
+
+### Minor Changes
+
+- ea50099: Первый выпуск Agent Chat SDK на складе GitHub Packages. Все пять пакетов теперь выходят вместе и
+  с одной версией: «SDK 0.2.0» значит, что каждый пакет `@ykurilov/agent-chat-*` имеет версию 0.2.0.
+  
+  Что изменилось по сравнению с тем, как пакеты подключали раньше:
+  
+  - Пакеты приходят собранными (JavaScript и типы), а не исходниками TypeScript. Голый `node`
+    запускает серверные пакеты без `tsx`.
+  - Скин Тандема (`@ykurilov/agent-chat-skin-tandem`) теперь тоже пакет. Раньше папку `skins/tandem/src`
+    копировали в приложение; копию можно удалить и подключить пакет.
+  - Дизайн-система Тандем ставится вместе со скином как `@ykurilov/tandem-ui` (в коде остаётся
+    импорт `@tandem/ui`).
+  
+  ### Как обновить приложение
+  
+  Если приложение подключало пакеты из этого репозитория без склада (ссылкой на папку или копией),
+  переведите его на склад:
+  
+  1. В корне приложения в `.npmrc` оставьте одну строку:
+  
+     ```ini
+     @ykurilov:registry=https://npm.pkg.github.com
+     ```
+  
+  2. Поставьте пакеты: `pnpm add @ykurilov/agent-chat-core @ykurilov/agent-chat-server @ykurilov/agent-chat-storage-sqlite @ykurilov/agent-chat-react`.
+  3. Если использовали скин Тандема из копии:
+     - удалите папку с копией скина (например, `src/chat-skin`);
+     - `pnpm add @ykurilov/agent-chat-skin-tandem "@tandem/ui@npm:@ykurilov/tandem-ui@^0.3.0"`;
+     - в коде замените импорт `./chat-skin` на `@ykurilov/agent-chat-skin-tandem`;
+     - в главном CSS-файле замените `@source` на папку скина на
+       `@source "../node_modules/@ykurilov/agent-chat-skin-tandem/dist";`
+       (путь считайте от CSS-файла до корня приложения).
+  4. Проверка: `pnpm typecheck`, сборка приложения, чат открывается и отвечает.