@ykurilov/agent-chat-core 0.107.2 → 0.109.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +27 -0
- package/README.md +1 -1
- package/dist/{chunk-D3PW7DT4.js → chunk-2MVJW2PT.js} +513 -387
- package/dist/chunk-2MVJW2PT.js.map +1 -0
- package/dist/index.js +18 -1
- package/dist/index.js.map +1 -1
- package/dist/storage-contract.js +53 -1
- package/dist/storage-contract.js.map +1 -1
- package/dist/types/agent-run/run-agent-turn.d.ts +1 -1
- package/dist/types/agent-run/step-context.d.ts +13 -2
- package/dist/types/chat-service.d.ts +14 -4
- package/dist/types/index.d.ts +3 -2
- package/dist/types/page-context/page-context.d.ts +8 -1
- package/dist/types/running-answers/stop-requests.d.ts +38 -0
- package/dist/types/storage/chat-storage.d.ts +25 -0
- package/dist/types/storage/storage-contract.d.ts +2 -0
- package/package.json +1 -1
- package/dist/chunk-D3PW7DT4.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,32 @@
|
|
|
1
1
|
# @ykurilov/agent-chat-core
|
|
2
2
|
|
|
3
|
+
## 0.109.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- a9a6e72: Снимок шага (`agent.stepContext`) больше не выглядит как новое сообщение человека. SDK оборачивает текст приложения
|
|
8
|
+
служебным блоком `<step_context>` с постоянным заголовком: «это не новое сообщение человека, он их не видит, ход тот же —
|
|
9
|
+
продолжай отвечать на его последнее сообщение». Раньше голые строки после результата инструмента модель принимала за
|
|
10
|
+
реплику человека без слов и отвечала «жду вашего ответа» (DeepSeek, 49 ходов из 103). Место снимка прежнее — в конце
|
|
11
|
+
запроса шага: так кэш модели обрывается только на нём. Повтор блока в ответе модели вырезается, как у других служебных
|
|
12
|
+
блоков.
|
|
13
|
+
|
|
14
|
+
Приложениям: свой заголовок «это служебные строки, не сообщение человека» над снимком уберите — иначе их будет два.
|
|
15
|
+
Заголовок прибавляет к каждому шагу около 60 токенов вне кэша.
|
|
16
|
+
|
|
17
|
+
## 0.108.0
|
|
18
|
+
|
|
19
|
+
### Minor Changes
|
|
20
|
+
|
|
21
|
+
- b951be1: «Стоп», нажатый сразу после отправки, останавливает именно этот ход — как бы ни легли запросы. Раньше «Стоп», дошедший до сервера раньше начала хода (маршрут, вход, чтение базы) или попавший на другую копию сервера, получал «нечего останавливать», и ответ дописывался до конца.
|
|
22
|
+
|
|
23
|
+
- Каждый запрос, начинающий ход (отправка, правка, переделка, повтор, решение по подтверждению, ответ на виджет, поправка, начавшая ход), несёт новый `turnRequestId` (`TurnRequestContext.turnRequestId`). Экран SDK шлёт его сам и называет в теле `POST /stop` (`{ turnRequestId }`).
|
|
24
|
+
- Сервер: ход этого запроса идёт на копии — останавливается сразу; ещё не начался или идёт на другой копии — «Стоп» запоминается (`202`), ход останавливается сразу после старта или на сверке с базой раз в 2 с (`STOP_REQUESTS_CHECK_EVERY_MS`). Ход другого запроса такой «Стоп» не трогает: запоздавший «Стоп» не остановит следующий вопрос. `service.stop(userId, chatId, { turnRequestId })`.
|
|
25
|
+
- Ответ на поправки — новый ход с id последней поправки: «Стоп» прежнего ответа его не трогает (на любой копии), «Стоп» с id поправки останавливает.
|
|
26
|
+
- `POST /stop` с `turnRequestId` всегда отвечает `202` (остановлено или запомнено), даже если хода с этим id так и не будет. Без id — как раньше: `202` или `204`.
|
|
27
|
+
- Хранилища: необязательные `saveStopRequest(request, { keepPerOwner })` / `hasStopRequest`. Запись несёт `ownerId`, живёт час; у человека не больше `keepPerOwner` (служба передаёт 100) живых записей — сверх уходят его самые ранние, чужие не трогаются. Тот же предел — в памяти копии. SQLite и PostgreSQL — таблица `stop_requests`, миграция применяется сама. Свои хранилища без этих методов работают как раньше: ранний «Стоп» держится в памяти копии.
|
|
28
|
+
- «Стоп» без `turnRequestId` (свои клиенты, ход, к которому экран только подключился) работает как раньше.
|
|
29
|
+
|
|
3
30
|
## 0.107.2
|
|
4
31
|
|
|
5
32
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -79,7 +79,7 @@ import type { ChatStorage } from "@ykurilov/agent-chat-core";
|
|
|
79
79
|
- `service.flush({ waitForAnswersMs })` — штатная остановка: ждёт идущие ответы до срока, остальные закрывает как «Стоп», ждёт `afterTurn`.
|
|
80
80
|
- События приложения `{ type, data? }`: из инструмента `model.emitAppEvent(event)`, вне хода `service.publishAppEvent({ ownerId, chatId, event })`. Модели не уходят.
|
|
81
81
|
- Состояние чата на ветке: инструмент пишет `model.state.set(path, value)` / `unset(path)`, читает `get(path?)` (путь через точку; ключи без точек, массивы целиком; значения — простой JSON). Запись ложится частью ответа `data-app-state`, модели не уходит. Состояние — свёртка записей текущей ветки из хранилища: правка, «Переделать» и выбор ветки меняют его сами, сжатие и «Повторить» не теряют. `service.getChatState(userId, chatId)` → `{ values, atMessageId }` (читает только связи и записи состояния; своему хранилищу — необязательный `listMessagePartsOfTypes`). `onStateChanged({ ownerId, chatId, reason, state, previousState, atMessageId })` — состояние сменилось после хода или смены ветки (`reason`: `turn`, `editMessage`, `regenerate`, `retry`, `selectBranch`, `editAnswer`, `widgetAnswer` — записи `checkAnswer` виджета), с повторами (`onStateChangedAttempts`, 3) и сроком (`onStateChangedTimeoutMs`, 30 000), по очереди внутри чата (смена, которая к попытке уже устарела, не доставляется: новую разошлёт записавшая её копия), события `state-changed` и `state-changed-failed`. Доставка — только пока сервер жив: сверка копии — по `getChatState`. Ответ пишется в базу сразу после итога каждого инструмента (промежуточные результаты — окном 500 мс). Запись до 16 КБ, состояние до 256 КБ (`AppStateTooLargeError`); после конца хода запись не принимается; верхние ключи на `$` — служебные ключи SDK. `privateStateKeys` — закрытые верхние ключи приложения: не уходят в историю, поток и `state-changed` наблюдения; `getChatState`, `onStateChanged`, события и модель их видят. Закрытое значение не возвращайте в выходе инструмента и тексте ответа. Для своих частей: `foldAppState`, `loadBranchAppState`, `createAppStateWriter`, `appStatePart`.
|
|
82
|
-
- Снимок перед каждым шагом: `agent.stepContext: ({ state, stepNumber, chat, subject, … }) => string | null` — текст ложится
|
|
82
|
+
- Снимок перед каждым шагом: `agent.stepContext: ({ state, stepNumber, chat, subject, … }) => string | null` — текст ложится в самый конец запроса шага, после результатов инструментов, служебным блоком `<step_context>` с постоянным заголовком «это не новое сообщение человека, ход тот же» (свой заголовок не нужен), в историю не пишется. Снимок на шаге один, всё до него от шага к шагу те же байты (кэш модели). `null` — шаг без снимка, бросок — без снимка и строка в журнал. Функция видит те же `channel`, `audience`, `staff`, что инструменты (в группе личного не показывайте), данные чата — копиями. Срок `agent.stepContextTimeoutMs` (по умолчанию 5 с): не ответила — шаг без снимка, `abortSignal` отменён. Типы `StepContext`, `StepContextInput`.
|
|
83
83
|
- Застывающий контекст: память, сегодняшняя дата, место на экране и блоки приложения вписываются в вопрос человека один раз за ход и дальше не меняются ни на байт. Следующий ход побайтно начинается с последнего шага прошлого (с рассуждениями и инструментами), поэтому всё прошлое читается из кэша модели. В новый вопрос идут только изменившиеся блоки и строка `[Больше не действует: «ключ»]` про пропавшие. Источник может вернуть `{ key, hidden: true }` — блок есть, но не показан ради места: вместо «больше не действует» модель, видевшая его, получит `[Не показано ради места, но по-прежнему действует: «ключ»]`. Набор хода хранится служебной частью ответа `data-frozen-context` (`FROZEN_CONTEXT_PART_TYPE`): в поток, историю, `afterTurn` и поиск по истории она не уходит. Продолжение после подтверждения, автопродолжение, запасной провайдер и «Повторить» берут блоки из ответа и источники заново не опрашивают. Память строже остальных блоков: читается один раз на чат — в первом ходе, после сжатия истории, при смене начала истории (правка первого сообщения, «Переделать» первого ответа), в первом личном ходе после группового и после сбоя чтения — и в идущем чате не перечитывается и не досылается (ни изменения, ни новые записи, ни «Больше не действует»); `snapshot()` и `blocks()` в остальных ходах не зовутся. Своя долгая память может отдавать блоки по записям: `LongTermMemory.blocks?({ userId, chatId })`; без него — один блок из `snapshot()`.
|
|
84
84
|
- Блоки приложения в вопросе хода: `agent.contextBlocks: ({ chatId, ownerId, chat, state, subject, channel, audience, … }) => [{ key, text, private? }] | null` — список скиллов, роль, правила. Зовётся один раз в начале хода; текст вписывается в вопрос после памяти и даты и дальше не меняется ни на байт (кэш модели), ядро его не оборачивает. На следующих ходах в вопрос идут только изменённые блоки целиком и строка `[Больше не действует: «ключ»]` про убранные. Ключи `memory`, `memory:*`, `today`, `screen_place` заняты ядром: такой блок отбрасывается со строкой в журнал. `private: true` — в групповом ходе блок не показывается. Срок `agent.contextBlocksTimeoutMs` (по умолчанию 5 с; 0 или `Infinity` — без срока, иначе от 1000): не ответила или бросила — блоки приложения берутся из прошлого ответа, в журнал строка `[блоки контекста] …`, `abortSignal` отменён; «Стоп» — без строки. Блоки хранятся служебной частью ответа: в потоке, истории, `afterTurn` и поиске по истории её нет. Типы `ContextBlock`, `ContextBlocksInput`, `ContextBlocksSource`, `HiddenContextBlock`, `ContextBlockEntry`.
|
|
85
85
|
- `agent.contextBlocksRefresh: "history-start"` включает снимок приложения до смены начала видимой истории, как у памяти. Без настройки и при `"turn"` источник по-прежнему читается каждый новый ход. Снимок хранится в frozen context ветки; своего кэша или SQL-миграций не требуется. Изменения вне переписки передаются через `prepareTurn.notices`, права проверяются сервером. [Триггеры, ошибки и пример](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/context-blocks-refresh.md).
|