@ykurilov/agent-chat-core 0.98.1 → 0.100.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 +25 -0
- package/README.md +12 -2
- package/dist/{chunk-N4BEH2WJ.js → chunk-YVM6GGKN.js} +60 -14
- package/dist/chunk-YVM6GGKN.js.map +1 -0
- package/dist/index.js +30 -1
- package/dist/index.js.map +1 -1
- package/dist/storage-contract.js +1 -1
- package/dist/types/agent-run/answer-saver.d.ts +3 -4
- package/dist/types/agent-run/run-agent-turn.d.ts +1 -0
- package/dist/types/chat-service.d.ts +1 -1
- package/dist/types/conversation/browser-chat.d.ts +19 -0
- package/dist/types/index.d.ts +4 -0
- package/dist/types/storage/in-memory-storage.d.ts +16 -0
- package/dist/types/transient-chat.d.ts +6 -0
- package/package.json +1 -1
- package/dist/chunk-N4BEH2WJ.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,30 @@
|
|
|
1
1
|
# @ykurilov/agent-chat-core
|
|
2
2
|
|
|
3
|
+
## 0.100.0
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 2f96ad1: Автосжатие по умолчанию включено у всех агентов с порогом 250000 токенов (ранее 200000), но не выше 80% окна модели. Хвост/сводка остаются по 20000 токенов. Выключение только явным compaction: false.
|
|
8
|
+
|
|
9
|
+
### Как обновить приложение
|
|
10
|
+
|
|
11
|
+
Без настроек, с пустым compaction и undefined-полями действует новый порог. Собственный compaction.thresholdTokens сохраняет приоритет с прежним ограничением 80% окна. Явно закреплённые в приложении 200000 не меняются сами; для стандартного поведения убрать это переопределение.
|
|
12
|
+
- 79b85b8: Стандартный порядок провайдеров: DeepSeek API → OpenRouter → Fireworks → Together. Он согласован для нового выбора, меню и запасных. Модель по умолчанию — DeepSeek 4.1 Flash; первый запасной прямого DeepSeek — OpenRouter с deepseek/deepseek-v4.1-flash-1017. Для GLM без прямого DeepSeek первым становится OpenRouter.
|
|
13
|
+
|
|
14
|
+
### Как обновить приложение
|
|
15
|
+
|
|
16
|
+
Без явных настроек действует новый приоритет доступных провайдеров. Явные defaultChoice и providerFallback.byModel сохраняют приоритет; сохранённый доступный выбор чата не заменяется. Отключение запасных через false прежнее.
|
|
17
|
+
|
|
18
|
+
## 0.99.0
|
|
19
|
+
|
|
20
|
+
### Minor Changes
|
|
21
|
+
|
|
22
|
+
- 5e688b2: Добавлен opt-in чат с историей только в браузере: отдельный createBrowserChatHandler создаёт RAM-хранилище на запрос, а createBrowserChatTransport сохраняет owner-bound шифрованный снимок до показа потока. Обычный AgentChat/Одуванчик поддерживает текст, модели, Stop, ветки и серверные инструменты. После reload/обрыва показанный текст остаётся; продолжение явное. Обычные серверные чаты и idle watch по умолчанию не меняются.
|
|
23
|
+
|
|
24
|
+
### Как обновить приложение
|
|
25
|
+
|
|
26
|
+
Подключите createBrowserChatHandler из @ykurilov/agent-chat-server к отдельному POST endpoint, с resolveUser, серверными catalog/agent, постоянными namespace и snapshotKey (32 случайных байта). createBrowserChatTransport из @ykurilov/agent-chat-react получает endpoint/ownerId/chatId/loadSnapshot/saveSnapshot; передайте его chatProps в обычный AgentChat, вызывайте dispose при замене. Приложение сохраняет весь снимок атомарно в IndexedDB с revision guards. Не подключайте обычные attachments/voice/subject/appBridge: первая версия без файлов, голоса, памяти, helpers, widgets, browser RPC, фона и approval-инструментов. Биллинг/лимиты между запросами — внешние numeric callbacks, не transient ledger. Контракт и ограничения: docs/browser-owned-chat.md. Старым приложениям менять подключение не требуется.
|
|
27
|
+
|
|
3
28
|
## 0.98.1
|
|
4
29
|
|
|
5
30
|
No changes in this release.
|
package/README.md
CHANGED
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
# @ykurilov/agent-chat-core
|
|
2
2
|
|
|
3
|
+
Автосжатие истории включено по умолчанию у всех агентов: порог 250 000 токенов, но не выше 80% окна выбранной модели. Пропущенный `compaction`, `{}` и поля со значением `undefined` сохраняют это поведение; только явный `compaction: false` выключает сжатие. Приложение может задать свой `compaction.thresholdTokens`; хвост и потолок сводки по умолчанию остаются по 20 000 токенов.
|
|
4
|
+
|
|
5
|
+
Стандартный приоритет провайдеров: `deepseek` → `openrouter` → `fireworks` → `together`. Без явного `defaultChoice` выбирается DeepSeek 4.1 Flash через прямой DeepSeek API; если его ключа нет, используется первый доступный провайдер в этом порядке. Тот же порядок задаёт меню и стандартных запасных (для модели берутся только поддерживаемые провайдеры с ключами, выбранный пропускается). Первый запасной прямого DeepSeek — OpenRouter с `deepseek/deepseek-v4.1-flash-1017`. Явные `defaultChoice` и `providerFallback.byModel` имеют приоритет; `providerFallback: false` по-прежнему отключает запасных.
|
|
6
|
+
|
|
3
7
|
Ядро чата с агентом. Работает только на сервере: ходит к провайдерам моделей, ведёт ход
|
|
4
8
|
агента с инструментами, хранит переписку, останавливает и повторяет ответы.
|
|
5
9
|
|
|
@@ -12,8 +16,8 @@ import type { ChatStorage } from "@ykurilov/agent-chat-core";
|
|
|
12
16
|
```
|
|
13
17
|
|
|
14
18
|
- `standardCatalog` — стандартные модели и провайдеры. Модели: `deepseek-4.1-flash`, `glm-5.3-flash`,
|
|
15
|
-
`gpt-6-luna`, `gemini-3.8-flash`, `claude-haiku-5.5` (через OpenRouter, кэш на час). Провайдеры и ключи: `deepseek` (`DEEPSEEK_API_KEY`), `
|
|
16
|
-
(`FIREWORKS_API_KEY`), `together` (`TOGETHER_API_KEY`)
|
|
19
|
+
`gpt-6-luna`, `gemini-3.8-flash`, `claude-haiku-5.5` (через OpenRouter, кэш на час). Провайдеры и ключи: `deepseek` (`DEEPSEEK_API_KEY`), `openrouter` (`OPENROUTER_API_KEY`, сортировка по скорости),
|
|
20
|
+
`fireworks` (`FIREWORKS_API_KEY`), `together` (`TOGETHER_API_KEY`).
|
|
17
21
|
Кто какую модель отдаёт — в [docs/getting-started.md](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/getting-started.md), шаг 3.
|
|
18
22
|
- `extendCatalog(base, { addModels, removeModels, addProviders, removeProviders, pinModelVersions, connectProviders })` — свой набор
|
|
19
23
|
моделей: убрать, добавить, закрепить версию модели у провайдера. Порядок: убрать → добавить → закрепить.
|
|
@@ -175,3 +179,9 @@ docs/getting-started.md, «Значки шагов и заголовки раз
|
|
|
175
179
|
### Правка ответа в обычном чате (с 0.97.0)
|
|
176
180
|
|
|
177
181
|
Серверный `answerEditing: true` и право `chatCapabilities.answerEditing` включают адрес правки ответа для Next/Hono. В `AgentChat` со скином «Одуванчик» передайте `answerEditor={true}` либо объект с `renderFields({ data, setData, disabled, message })` для своих полей. `onAnswerEdited` получает id исходного и нового ответа, оба текста, владельца, чат и JSON `data` приложения. Прежний пользовательский `answerEditing={{ edits, renderEditor }}` совместим и имеет приоритет. [Контракт, пределы доставки хука и обновление приложения](../../docs/answer-editing.md).
|
|
182
|
+
|
|
183
|
+
## Transient-снимок
|
|
184
|
+
|
|
185
|
+
Серверный `createTransientChatStorage(snapshot?)` экспортирует копию истории, веток, сжатия и числового расхода через `exportSnapshot()`. Живые аренды, знаки жизни и долговременная память не переносятся. Конструктор принимает **только доверенный серверный** `InMemoryChatSnapshot`, не JSON от браузера. Для публичного HTTP используйте `createBrowserChatHandler` сервера с проверкой владельца и seal. `createInMemoryChatStorage()` сохраняет старый контракт.
|
|
186
|
+
|
|
187
|
+
`checkpointTransientChat(service)` сохраняет текущую сборку без остановки хода; `getTransientChatHistory(service,userId,chatId)` ждёт checkpoint и отдаёт обычную проекцию прав видимости вместе с активным ответом. Обычный getHistory не меняется. [Режим browser-owned](../../docs/browser-owned-chat.md).
|
|
@@ -6098,10 +6098,14 @@ function createAnswerSaver(storage, messageId, durations, usage, onTakenOver, ex
|
|
|
6098
6098
|
await current;
|
|
6099
6099
|
return latest;
|
|
6100
6100
|
},
|
|
6101
|
-
/**
|
|
6102
|
-
|
|
6103
|
-
|
|
6104
|
-
|
|
6101
|
+
/** Сохраняет принятую сборку до контрольной метки, не останавливая запись и знак жизни. */
|
|
6102
|
+
async checkpoint() {
|
|
6103
|
+
await rewinding?.catch(() => {
|
|
6104
|
+
});
|
|
6105
|
+
await settleAssembly();
|
|
6106
|
+
await writeNow();
|
|
6107
|
+
},
|
|
6108
|
+
/** Штатная остановка: пишет остаток и освобождает ответ для восстановления без порога тишины. */
|
|
6105
6109
|
async flush() {
|
|
6106
6110
|
released = true;
|
|
6107
6111
|
clearTimeout(aliveTimer);
|
|
@@ -7271,6 +7275,16 @@ async function runTurn(turnInput, emitRaw) {
|
|
|
7271
7275
|
emitToClient({ type: "message-metadata", messageMetadata: metadata });
|
|
7272
7276
|
};
|
|
7273
7277
|
input.flushers?.add(saver.flush);
|
|
7278
|
+
let finalizingSnapshot = false;
|
|
7279
|
+
let finishSnapshot;
|
|
7280
|
+
const snapshotFinished = new Promise((resolve) => {
|
|
7281
|
+
finishSnapshot = resolve;
|
|
7282
|
+
});
|
|
7283
|
+
const checkpoint = async () => {
|
|
7284
|
+
await saver.checkpoint();
|
|
7285
|
+
if (finalizingSnapshot) await snapshotFinished;
|
|
7286
|
+
};
|
|
7287
|
+
input.checkpointers?.add(checkpoint);
|
|
7274
7288
|
try {
|
|
7275
7289
|
const maxSteps = input.maxSteps ?? DEFAULT_MAX_STEPS;
|
|
7276
7290
|
let stepsDone = 0;
|
|
@@ -7680,6 +7694,7 @@ async function runTurn(turnInput, emitRaw) {
|
|
|
7680
7694
|
const closure = chatClosure.close();
|
|
7681
7695
|
browser?.close();
|
|
7682
7696
|
input.flushers?.delete(saver.flush);
|
|
7697
|
+
finalizingSnapshot = true;
|
|
7683
7698
|
if (thoughtTitles) {
|
|
7684
7699
|
if (!input.abortSignal.aborted && errors.length === 0) await thoughtTitles.settle(input.thoughtTitles.settleMs ?? THOUGHT_TITLES_SETTLE_MS);
|
|
7685
7700
|
thoughtTitles.close();
|
|
@@ -7862,6 +7877,8 @@ async function runTurn(turnInput, emitRaw) {
|
|
|
7862
7877
|
input.leaseSignal?.removeEventListener("abort", onLeaseLost);
|
|
7863
7878
|
thoughtTitles?.close();
|
|
7864
7879
|
input.flushers?.delete(saver.flush);
|
|
7880
|
+
input.checkpointers?.delete(checkpoint);
|
|
7881
|
+
finishSnapshot();
|
|
7865
7882
|
}
|
|
7866
7883
|
}
|
|
7867
7884
|
function replayCopiedParts(message, emitToClient) {
|
|
@@ -8925,7 +8942,7 @@ function deliverableParts(parts) {
|
|
|
8925
8942
|
}
|
|
8926
8943
|
|
|
8927
8944
|
// src/compaction/compaction-settings.ts
|
|
8928
|
-
var DEFAULTS = { thresholdTokens:
|
|
8945
|
+
var DEFAULTS = { thresholdTokens: 25e4, tailTokens: 2e4, summaryCeilingTokens: 2e4, flushWaitMs: 3e4 };
|
|
8929
8946
|
var THRESHOLD_WINDOW_SHARE = 0.8;
|
|
8930
8947
|
var NEAR_LIMIT_WINDOW_SHARE = 0.9;
|
|
8931
8948
|
function resolveCompactionSettings(setting) {
|
|
@@ -9698,9 +9715,9 @@ var deepseek41FlashProfile = {
|
|
|
9698
9715
|
// 1017: прямой DeepSeek обновляет alias сам; остальные провайдеры используют датированный id.
|
|
9699
9716
|
providerModelIds: {
|
|
9700
9717
|
deepseek: "deepseek-flash",
|
|
9718
|
+
openrouter: "deepseek/deepseek-v4.1-flash-1017",
|
|
9701
9719
|
fireworks: "accounts/fireworks/models/deepseek-v4p1-flash-1017",
|
|
9702
|
-
together: "deepseek-ai/DeepSeek-V4.1-Flash-1017"
|
|
9703
|
-
openrouter: "deepseek/deepseek-v4.1-flash-1017"
|
|
9720
|
+
together: "deepseek-ai/DeepSeek-V4.1-Flash-1017"
|
|
9704
9721
|
},
|
|
9705
9722
|
// Цены за миллион токенов: каталоги провайдеров 2026-10-22.
|
|
9706
9723
|
pricing: {
|
|
@@ -9787,9 +9804,9 @@ var glm53FlashProfile = {
|
|
|
9787
9804
|
// Запрет стоит всегда, а не только при картинке: запрос одинаков в каждом ходе, кэш и выбранный хозяин не теряются.
|
|
9788
9805
|
providerOptions: { openrouter: { provider: { ignore: ["cloudflare", "deepinfra", "open-inference", "sail-research", "venice"] } } },
|
|
9789
9806
|
providerModelIds: {
|
|
9807
|
+
openrouter: "z-ai/glm-5.3-flash",
|
|
9790
9808
|
fireworks: "accounts/fireworks/models/glm-5p3-flash",
|
|
9791
|
-
together: "zai-org/GLM-5.3-Flash"
|
|
9792
|
-
openrouter: "z-ai/glm-5.3-flash"
|
|
9809
|
+
together: "zai-org/GLM-5.3-Flash"
|
|
9793
9810
|
},
|
|
9794
9811
|
// Цены: прайс-листы провайдеров на 2026-09-30, доллары за миллион токенов (specs/012-spending-limits/research.md).
|
|
9795
9812
|
pricing: {
|
|
@@ -9835,7 +9852,7 @@ var gpt6LunaProfile = {
|
|
|
9835
9852
|
// src/models/standard-catalog.ts
|
|
9836
9853
|
var standardCatalog = createModelCatalog({
|
|
9837
9854
|
models: [deepseek41FlashProfile, glm53FlashProfile, gpt6LunaProfile, gemini38FlashProfile, claudeHaiku55Profile],
|
|
9838
|
-
providers: [
|
|
9855
|
+
providers: [deepseekProvider, openrouterProvider, fireworksProvider, togetherProvider]
|
|
9839
9856
|
});
|
|
9840
9857
|
|
|
9841
9858
|
// src/storage/chat-data.ts
|
|
@@ -10524,6 +10541,27 @@ function createRunningAnswerRegistry() {
|
|
|
10524
10541
|
};
|
|
10525
10542
|
}
|
|
10526
10543
|
|
|
10544
|
+
// src/transient-chat.ts
|
|
10545
|
+
var checkpoints = /* @__PURE__ */ new WeakMap();
|
|
10546
|
+
function registerTransientCheckpoint(service, checkpoint) {
|
|
10547
|
+
checkpoints.set(service, checkpoint);
|
|
10548
|
+
}
|
|
10549
|
+
async function checkpointTransientChat(service) {
|
|
10550
|
+
const checkpoint = checkpoints.get(service);
|
|
10551
|
+
if (!checkpoint) throw new TypeError("Transient checkpoint is unavailable for this service");
|
|
10552
|
+
await checkpoint();
|
|
10553
|
+
}
|
|
10554
|
+
var histories = /* @__PURE__ */ new WeakMap();
|
|
10555
|
+
function registerTransientHistory(service, history) {
|
|
10556
|
+
histories.set(service, history);
|
|
10557
|
+
}
|
|
10558
|
+
async function getTransientChatHistory(service, userId, chatId) {
|
|
10559
|
+
const history = histories.get(service);
|
|
10560
|
+
if (!history) throw new TypeError("Transient history is unavailable for this service");
|
|
10561
|
+
await checkpointTransientChat(service);
|
|
10562
|
+
return history(userId, chatId);
|
|
10563
|
+
}
|
|
10564
|
+
|
|
10527
10565
|
// src/voice-tags.ts
|
|
10528
10566
|
var MIN_LETTERS = 3;
|
|
10529
10567
|
var MAX_LENGTH = 40;
|
|
@@ -13323,6 +13361,7 @@ function createChatService(input) {
|
|
|
13323
13361
|
const writingUndelivered = /* @__PURE__ */ new Set();
|
|
13324
13362
|
const afterTurnWork = /* @__PURE__ */ new Set();
|
|
13325
13363
|
const flushers = /* @__PURE__ */ new Set();
|
|
13364
|
+
const checkpointers = /* @__PURE__ */ new Set();
|
|
13326
13365
|
const liveAnswerIds = /* @__PURE__ */ new Set();
|
|
13327
13366
|
const steering = createTurnSteering();
|
|
13328
13367
|
const handOffs = /* @__PURE__ */ new Map();
|
|
@@ -13750,7 +13789,7 @@ function createChatService(input) {
|
|
|
13750
13789
|
async function choiceForNewChat(userId) {
|
|
13751
13790
|
return await rememberedChoice(userId) ?? defaultChoice;
|
|
13752
13791
|
}
|
|
13753
|
-
async function historyOf(userId, chatId, { write, scope }) {
|
|
13792
|
+
async function historyOf(userId, chatId, { write, scope, includeRunning }) {
|
|
13754
13793
|
const stored = await ownChat(userId, chatId);
|
|
13755
13794
|
const runningId = registry.runningMessageId(chatId);
|
|
13756
13795
|
let { messages, selections, branch } = await loadTree(chatId);
|
|
@@ -13782,7 +13821,7 @@ function createChatService(input) {
|
|
|
13782
13821
|
// Служебные и закрытые ключи состояния и служебные сообщения в браузер не уходят (FR-003).
|
|
13783
13822
|
messages: visible(
|
|
13784
13823
|
publicMessages(
|
|
13785
|
-
shown.filter((message) => message.id !== runningAnswerId || resumeBases.get(chatId)?.id === runningAnswerId).map((message) => message.id === runningAnswerId ? resumeBases.get(chatId) : markedUndelivered(toAgentChatMessage(message))),
|
|
13824
|
+
shown.filter((message) => includeRunning || message.id !== runningAnswerId || resumeBases.get(chatId)?.id === runningAnswerId).map((message) => message.id === runningAnswerId && !includeRunning ? resumeBases.get(chatId) : markedUndelivered(toAgentChatMessage(message))),
|
|
13786
13825
|
hiddenStateKey,
|
|
13787
13826
|
screenNotices
|
|
13788
13827
|
)
|
|
@@ -14183,7 +14222,8 @@ function createChatService(input) {
|
|
|
14183
14222
|
},
|
|
14184
14223
|
createdAt: launch.createdAt,
|
|
14185
14224
|
logError,
|
|
14186
|
-
flushers
|
|
14225
|
+
flushers,
|
|
14226
|
+
checkpointers
|
|
14187
14227
|
});
|
|
14188
14228
|
});
|
|
14189
14229
|
} catch (error) {
|
|
@@ -15477,6 +15517,10 @@ function createChatService(input) {
|
|
|
15477
15517
|
});
|
|
15478
15518
|
if (storage.listSilentAnswerIds) startStaleSweep();
|
|
15479
15519
|
else logError("\u0410\u0432\u0442\u043E\u043C\u0430\u0442\u0438\u0447\u0435\u0441\u043A\u043E\u0435 \u0432\u043E\u0441\u0441\u0442\u0430\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0435 \u043E\u0442\u0432\u0435\u0442\u043E\u0432 \u043D\u0435\u0434\u043E\u0441\u0442\u0443\u043F\u043D\u043E: \u0443 \u0445\u0440\u0430\u043D\u0438\u043B\u0438\u0449\u0430 \u043D\u0435\u0442 listSilentAnswerIds. \u041E\u0431\u043D\u043E\u0432\u0438\u0442\u0435 \u0430\u0434\u0430\u043F\u0442\u0435\u0440; \u0434\u043B\u044F \u0435\u0434\u0438\u043D\u0441\u0442\u0432\u0435\u043D\u043D\u043E\u0439 \u043A\u043E\u043F\u0438\u0438 \u0441\u0435\u0440\u0432\u0435\u0440\u0430 \u044F\u0432\u043D\u043E \u0432\u044B\u0437\u043E\u0432\u0438\u0442\u0435 recoverInterruptedAnswers \u043F\u0440\u0438 \u0437\u0430\u043F\u0443\u0441\u043A\u0435.");
|
|
15520
|
+
registerTransientHistory(service, (userId, chatId) => historyOf(userId, chatId, { write: true, includeRunning: true }));
|
|
15521
|
+
registerTransientCheckpoint(service, async () => {
|
|
15522
|
+
await Promise.all([...checkpointers].map((checkpoint) => checkpoint()));
|
|
15523
|
+
});
|
|
15480
15524
|
return service;
|
|
15481
15525
|
function isDetachedAnswer(last, runningId) {
|
|
15482
15526
|
return runningId === null && last?.status === "streaming" && !liveAnswerIds.has(last.id);
|
|
@@ -15724,6 +15768,8 @@ export {
|
|
|
15724
15768
|
TooManyTurnsError,
|
|
15725
15769
|
ChatBusyError,
|
|
15726
15770
|
createRunningAnswerRegistry,
|
|
15771
|
+
checkpointTransientChat,
|
|
15772
|
+
getTransientChatHistory,
|
|
15727
15773
|
splitVoiceTags,
|
|
15728
15774
|
stripVoiceTags,
|
|
15729
15775
|
VOICE_TAGS,
|
|
@@ -15760,4 +15806,4 @@ export {
|
|
|
15760
15806
|
InvalidWidgetAnswerError,
|
|
15761
15807
|
createChatService
|
|
15762
15808
|
};
|
|
15763
|
-
//# sourceMappingURL=chunk-
|
|
15809
|
+
//# sourceMappingURL=chunk-YVM6GGKN.js.map
|