@ykurilov/agent-chat-core 0.108.0 → 0.110.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 +26 -0
- package/README.md +2 -2
- package/dist/{chunk-FUIPWUAH.js → chunk-WMVDYLNE.js} +676 -539
- package/dist/chunk-WMVDYLNE.js.map +1 -0
- package/dist/index.js +3 -1
- package/dist/index.js.map +1 -1
- package/dist/storage-contract.js +1 -1
- package/dist/types/agent-run/run-agent-turn.d.ts +3 -1
- package/dist/types/agent-run/sealed-answer.d.ts +37 -0
- package/dist/types/agent-run/step-context.d.ts +13 -2
- package/dist/types/chat-service.d.ts +9 -2
- package/dist/types/index.d.ts +1 -0
- package/package.json +1 -1
- package/dist/chunk-FUIPWUAH.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,31 @@
|
|
|
1
1
|
# @ykurilov/agent-chat-core
|
|
2
2
|
|
|
3
|
+
## 0.110.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- d725597: Ответ с подсказками больше не теряется из-за дописки после них. Модель писала вопрос и тем же шагом вызывала `suggest_replies`, потом служебный инструмент (`flow_note`, `flow_side_task`) и дописывала «Жду ваш выбор…». Приложения, которые показывают человеку только последний текст хода, теряли сам вопрос: в вебе он мелькал и исчезал, в мессенджер не доходил.
|
|
8
|
+
|
|
9
|
+
Теперь шаг с текстом и показанными подсказками `suggest_replies` закрывает ответ. Дальше в этом ходе текст модели не идёт ни клиенту, ни в запись, ни в запросы следующих шагов; вызовы инструментов идут как обычно, служебные заметки сценария не теряются. Модель получает результат подсказок `SUGGESTIONS_SHOWN_AFTER_ANSWER` («показано. Ответ человеку на этом закончен…») и обычно не тратит шаг на дописку. Скрытая дописка — строка журнала `[дописка после подсказок не показана]`. Ответ, который кончился вызовом, получает в записи отметку конца хода (как у `endTurn` без текста): на следующем ходе вопрос человека не встаёт сразу за результатом инструмента.
|
|
10
|
+
|
|
11
|
+
Ответ не закрывают: черновик перед поиском («Собираю запрос» → поиск → ответ), кнопки без текста в шаге, подсказки с ошибкой, вызов рядом с подсказками, чей результат нужен ответу (поиск и т.п.). Служебные вызовы рядом закрытию не мешают: их имена — новая настройка `agent.serviceTools`. Закрытие переживает повтор попытки, запасного провайдера и «Повторить» после сбоя или «Стоп»: его восстанавливают уже записанные части ответа. После ответа человека на ждущий виджет или подтверждение закрытие снимается. Описания инструментов не менялись — начало запроса и кэш модели те же.
|
|
12
|
+
|
|
13
|
+
Приложению со своей копией `suggest_replies`, которая кончает ход через `endTurn`, можно вернуться к базовому виджету: `agent.widgets: { basic: ["suggest_replies"] }`.
|
|
14
|
+
|
|
15
|
+
## 0.109.0
|
|
16
|
+
|
|
17
|
+
### Minor Changes
|
|
18
|
+
|
|
19
|
+
- a9a6e72: Снимок шага (`agent.stepContext`) больше не выглядит как новое сообщение человека. SDK оборачивает текст приложения
|
|
20
|
+
служебным блоком `<step_context>` с постоянным заголовком: «это не новое сообщение человека, он их не видит, ход тот же —
|
|
21
|
+
продолжай отвечать на его последнее сообщение». Раньше голые строки после результата инструмента модель принимала за
|
|
22
|
+
реплику человека без слов и отвечала «жду вашего ответа» (DeepSeek, 49 ходов из 103). Место снимка прежнее — в конце
|
|
23
|
+
запроса шага: так кэш модели обрывается только на нём. Повтор блока в ответе модели вырезается, как у других служебных
|
|
24
|
+
блоков.
|
|
25
|
+
|
|
26
|
+
Приложениям: свой заголовок «это служебные строки, не сообщение человека» над снимком уберите — иначе их будет два.
|
|
27
|
+
Заголовок прибавляет к каждому шагу около 60 токенов вне кэша.
|
|
28
|
+
|
|
3
29
|
## 0.108.0
|
|
4
30
|
|
|
5
31
|
### Minor 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).
|
|
@@ -144,7 +144,7 @@ docs/getting-started.md, «Значки шагов и заголовки раз
|
|
|
144
144
|
|
|
145
145
|
- Временные ошибки провайдера повторяются тихо; перегрузка или лимит до начала ответа — один переход к запасному провайдеру той же модели (`providerFallback`). `providerFallback.onSilence: "restart-step-on-next"` — модель замолчала посреди ответа: шаг стирается (`data-step-reset`, `withoutResetSteps`) и начинается заново у следующего провайдера.
|
|
146
146
|
- «Повторить» после сбоя продолжает оборванный ход с выполненных инструментов, а не начинает заново; обрыв посреди ответа дописывается сам (до двух раз); переполнение окна модели — сжатие и продолжение, ошибка `context_overflow` только если не помогло.
|
|
147
|
-
- Пределы: `toolTimeoutMs` (120 с на серверный инструмент), `modelSilenceTimeout` (90 с до первого куска, 120 с между кусками; свой срок провайдера — поле `modelSilenceTimeout` у фабрик `create…Provider`, в том числе для запасного), `toolResultMaxLength` (50 000 знаков). `sequentialTools` пускает инструменты с последствиями по одному, очередь одна на чат.
|
|
147
|
+
- Пределы: `toolTimeoutMs` (120 с на серверный инструмент), `modelSilenceTimeout` (90 с до первого куска, 120 с между кусками; свой срок провайдера — поле `modelSilenceTimeout` у фабрик `create…Provider`, в том числе для запасного), `toolResultMaxLength` (50 000 знаков). `sequentialTools` пускает инструменты с последствиями по одному, очередь одна на чат. `serviceTools` — имена служебных инструментов: вызов рядом с подсказками не мешает им закрыть ответ.
|
|
148
148
|
- Расход не теряется: оборванные ответы пишутся оценкой (`estimated`), у OpenRouter оценка потом сверяется с настоящей ценой. Дата в запросе — по поясу человека (`timeZone`), без него — `agent.timeZone` или пояс лимитов (`limits.timeZone`), без них — сервера.
|
|
149
149
|
- Журнал промахов кэша (`cacheMissLog: false` выключает), заголовок `x-session-id` у OpenRouter, чистка секретов из ошибок инструментов (`scrubSecrets`).
|
|
150
150
|
- Защита: запись с чужой страницы — 403 (`allowedOrigins`, в том числе шаблон `https://*.example.com`), не больше трёх одновременных ответов на человека (`maxConcurrentTurnsPerUser`).
|