@ykurilov/agent-chat-core 0.98.1 → 0.99.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,15 @@
1
1
  # @ykurilov/agent-chat-core
2
2
 
3
+ ## 0.99.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 5e688b2: Добавлен opt-in чат с историей только в браузере: отдельный createBrowserChatHandler создаёт RAM-хранилище на запрос, а createBrowserChatTransport сохраняет owner-bound шифрованный снимок до показа потока. Обычный AgentChat/Одуванчик поддерживает текст, модели, Stop, ветки и серверные инструменты. После reload/обрыва показанный текст остаётся; продолжение явное. Обычные серверные чаты и idle watch по умолчанию не меняются.
8
+
9
+ ### Как обновить приложение
10
+
11
+ Подключите 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. Старым приложениям менять подключение не требуется.
12
+
3
13
  ## 0.98.1
4
14
 
5
15
  No changes in this release.
package/README.md CHANGED
@@ -175,3 +175,9 @@ docs/getting-started.md, «Значки шагов и заголовки раз
175
175
  ### Правка ответа в обычном чате (с 0.97.0)
176
176
 
177
177
  Серверный `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).
178
+
179
+ ## Transient-снимок
180
+
181
+ Серверный `createTransientChatStorage(snapshot?)` экспортирует копию истории, веток, сжатия и числового расхода через `exportSnapshot()`. Живые аренды, знаки жизни и долговременная память не переносятся. Конструктор принимает **только доверенный серверный** `InMemoryChatSnapshot`, не JSON от браузера. Для публичного HTTP используйте `createBrowserChatHandler` сервера с проверкой владельца и seal. `createInMemoryChatStorage()` сохраняет старый контракт.
182
+
183
+ `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) {
@@ -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-5ABNI4QD.js.map