@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 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`), `fireworks`
16
- (`FIREWORKS_API_KEY`), `together` (`TOGETHER_API_KEY`), `openrouter` (`OPENROUTER_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
- * следующий старт прервёт его сразу, без ожидания порога (FR-060).
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: 2e5, tailTokens: 2e4, summaryCeilingTokens: 2e4, flushWaitMs: 3e4 };
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: [fireworksProvider, deepseekProvider, togetherProvider, openrouterProvider]
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-N4BEH2WJ.js.map
15809
+ //# sourceMappingURL=chunk-YVM6GGKN.js.map