@ykurilov/agent-chat-core 0.64.0 → 0.65.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ykurilov/agent-chat-core
 
+## 0.65.1
+
+### Patch Changes
+
+- ca56c29: Запись идущего ответа: «записать сейчас» (начатый вызов, итог инструмента) пишет только собранное к вызову; промежуточные результаты, пришедшие во время записи, идут окном 500 мс, а не второй записью следом.
+
+## 0.65.0
+
+### Minor Changes
+
+- 814ee7f: Пометка «Агент написал первым — человек молчал 1 ч 7 мин» перед ответом, который агент написал сам. Ядро: право чата `appNotices` (по умолчанию выключено) — служебные пометки приложения (`kind: "app"`) уходят в историю без текста для модели и только через белый список `appNoticeViews` (имя → безопасные данные для экрана; без функции пометка не уходит); `modelDetails: false` выключает и `appNotices`. React: `noticeLines` у `AgentChat` (имя пометки → строка), договор скина 27 — необязательный `ServiceLine`. Сценарии: в данных пометки `silentMs` (от последнего сообщения человека) и `exit`, проекция для экрана регистрируется в `withChat`, готовые строки `flowNoticeLines()` с подписями `russianFlowNoticeLabels`/`englishFlowNoticeLabels` (`FlowLabels.notices`); `FlowTestChat` передаёт их в `renderChat(chatId, { noticeLines })`. Тандем рисует `ServiceLine`. Как подключить — CHANGES.md, раздел 0.65.0.
+
 ## 0.64.0
 
 ### Minor Changes

package/README.md

@@ -82,7 +82,7 @@ import type { ChatStorage } from "@ykurilov/agent-chat-core";
 - Данные чата без записи: `service.getChatData(userId, chatId)` — копия, проверки владения как у `updateChatData`.
 - Проверка ответа виджета на сервере: `checkAnswer(answer, ctx)` у своего виджета и общая `agent.widgets.checkAnswer(call, answer, ctx)` (для всех виджетов без своей). Зовётся после схемы под замком чата. Исход: `undefined` — принять, `{ answer }` — принять с заменой, `{ refuse: "текст" }` — отказать (`WidgetAnswerRefusedError`, сервер — 409 `widget_answer_refused`, виджет остаётся открытым). `ctx` — `ownerId`, `chatId`, `messageId`, `toolName`, `toolCallId`, `input`, `subject?`, `chatData?`, `state` (записи ложатся в ответ вместе с результатом виджета, хук `onStateChanged` — с причиной `widgetAnswer`), `emitAppEvent` (событие приложения вместе с ответом виджета), `signal` (отмена по сроку или «Стопу»: приложение слушает его само). Срок — `agent.widgets.checkAnswerTimeoutMs` (5 000 мс, заметно меньше `requestTimeoutMs` страницы). Исключение — 500, ничего не записано, в журнале только имя ошибки; срок вышел — `WidgetAnswerCheckTimeoutError`, сервер — 504 `widget_check_timeout`. Чат закрыли во время проверки — `ChatClosedError`, ответ не пишется.
 - Набор виджетов по чату: `agent.widgets.enabledFor({ chat: { id, ownerId, data?, subject? } })` → имена включённых. Выключенных модель не видит (нет в инструментах запроса), их прошлые вызовы идут модели текстом. Синхронная, те же данные — тот же набор; смена набора сбрасывает кэш модели. Неизвестное имя — строка в журнал, исключение — ошибка хода. Подробно — [docs/widgets.md](../../docs/widgets.md).
-- Права человека в чате: `chatCapabilities({ userId, chat })` возвращает запреты (`edit`, `regenerate`, `retry`, `branches`, `modelChoice`, `answerEditing`, `chatList`, `compact`, `attachments`, `voice`, `reasoning`, `toolDetails`, `steer`, `modelDetails`, `errorDetails`; по умолчанию всё `true`, кроме `errorDetails`; `modelDetails: false` выключает и `modelChoice`, и `errorDetails`). Неизвестное право или не булево значение — `TypeError`. Запрещённое действие — `ActionForbiddenError(action)` до любой записи и до `beforeTurn`. За один вызов службы права спрашиваются не больше раза. История несёт `capabilities`. Вручную — `service.assertCapability(userId, chatId, capability)`.
+- Права человека в чате: `chatCapabilities({ userId, chat })` возвращает запреты (`edit`, `regenerate`, `retry`, `branches`, `modelChoice`, `answerEditing`, `chatList`, `compact`, `attachments`, `voice`, `reasoning`, `toolDetails`, `steer`, `modelDetails`, `errorDetails`, `appNotices`; по умолчанию всё `true`, кроме `errorDetails` и `appNotices` — служебных пометок приложения на экране, без текста для модели и только через белый список `appNoticeViews` (имя пометки → безопасные данные для экрана; без функции пометка не уходит); `modelDetails: false` выключает `modelChoice`, `errorDetails` и `appNotices`). Неизвестное право или не булево значение — `TypeError`. Запрещённое действие — `ActionForbiddenError(action)` до любой записи и до `beforeTurn`. За один вызов службы права спрашиваются не больше раза. История несёт `capabilities`. Вручную — `service.assertCapability(userId, chatId, capability)`.
 - Скрытие частей ответа: `reasoning: false` — мысли модели, `toolDetails: false` — служебные инструменты не уходят в историю, поток и повтор кусков после переподключения; хранилище, модель и `afterTurn` получают всё. Виджеты, браузерные инструменты, вызовы с запросом подтверждения и инструменты с `metadata: { showOnScreen: true }` в описании видны всегда. `modelDetails: false` убирает у чата истории `ownerId`, `modelId`, `providerId`, `reasoning`, у сообщений — `metadata.modelId`, `providerId`, `usage`, у частей и кусков — `providerMetadata`/`callProviderMetadata`/`resultProviderMetadata`, у `data-step-reset` — провайдера; отметки сжатия идут без текста сводки (`summary: ""`, `summaryTokens: 0`) в истории и `getCompactions`. Подробности сбоя провайдера (`metadata.error.details`: `providerId`, `modelId`, `statusCode`, `reason` — одна строка до 300 знаков без секретов, параметров адресов, `org-…`/`proj_…` и e-mail, `resetsAt` — ISO, только будущее не дальше двух лет) хранятся всегда, а в историю и поток идут только при `errorDetails: true` (например, админу); без права — только `error.kind`. Ответ модерации в `reason` может повторять текст человека — отдавайте право только тому, кому этот текст можно видеть. Меню моделей — опция `modelMenu({ userId })`: `false` — `getModelMenu(userId)` бросает `ActionForbiddenError("modelDetails")`. История несёт `modelAcceptsImages` (видит ли модель чата картинки). Права — на того, кто открыл поток.
 - Закрытый чат: `service.closeChat({ ownerId, chatId, code, message })` и `reopenChat({ ownerId, chatId })` (события `chat-closed`, `chat-reopened`), из инструмента — `model.closeChat({ code, message })`. Закрытие — запись `$closed` на ветке: из инструмента — в ответе сразу при вызове, из кода — служебной записью в конце ветки (идёт ход — после него). Правка, «Переделать», выбор ветки и правка ответа до точки закрытия открывают чат; закрыть навсегда — правами (`chatCapabilities` видит `chat.closed`). Закрытие побеждает паузу: ждущие подтверждения и виджеты закрываются отказом, как при «Стопе». В закрытом чате отправка, «Повторить», подтверждения и виджеты — `ChatClosedError`; служебные сообщения пишутся без хода. `listChats` отдаёт `closed` — копию закрытия текущей ветки (`setChatClosed`); права и история берут закрытие с ветки, не записавшуюся копию дописывает следующее открытие истории. Закрытие чатов 0.27 переносится в запись лениво, при первой правке или смене ветки.
 - `beforeCreateChat({ userId, origin? })` — можно ли человеку завести новый чат (`createChat`): `{ code, message }` → `ChatCreationRefusedError`. Чаты объектов и импорт хук не спрашивают. У чата `closed?: { code, message }`, хранилище — необязательный `setChatClosed(chatId, closed | null)`.

package/dist/{chunk-EWEEYX6U.js → chunk-4NQEQWGW.js}

@@ -1545,12 +1545,14 @@ function publicAppStateParts(parts, hidden = isReservedAppStateKey) {
     return data === void 0 ? [] : [{ ...part, data }];
   });
 }
-function publicMessages(messages, hidden = isReservedAppStateKey) {
+function publicMessages(messages, hidden = isReservedAppStateKey, options2 = {}) {
+  const views = options2.appNoticeViews;
+  const toScreen = views ? (part) => appNoticesForScreen(part, views) : withoutAppNotices;
   const shown = [];
   let waiting = [];
   for (const message of messages) {
     const hasService = message.parts.some((part) => part.type === APP_STATE_PART_TYPE || isModelOnlyPart(part) || hasAppNotice(part));
-    const parts = hasService ? publicAppStateParts(message.parts.filter((part) => !isModelOnlyPart(part)).flatMap(withoutAppNotices), hidden) : [...message.parts];
+    const parts = hasService ? publicAppStateParts(message.parts.filter((part) => !isModelOnlyPart(part)).flatMap(toScreen), hidden) : [...message.parts];
     if (message.role === "user" && parts.length === 0) continue;
     const visible = hasService ? { ...message, parts } : message;
     if (isStateMessage(message)) {
@@ -1574,6 +1576,24 @@ function withoutAppNotices(part) {
   const notices = noticesOfPart(part).filter((notice) => notice.kind !== "app");
   return notices.length === 0 ? [] : [{ ...part, data: { ...part.data, notices } }];
 }
+function appNoticesForScreen(part, views) {
+  if (part.type !== AGENT_NOTICE_PART_TYPE || !hasAppNotice(part)) return [part];
+  const notices = noticesOfPart(part).flatMap((notice) => {
+    if (notice.kind !== "app") return [notice];
+    const data = screenDataOf(notice.name, notice.data, views);
+    return data === void 0 ? [] : [{ kind: "app", name: notice.name, data }];
+  });
+  return notices.length === 0 ? [] : [{ ...part, data: { ...part.data, notices } }];
+}
+function screenDataOf(name, data, views) {
+  const view = name !== void 0 && Object.hasOwn(views, name) ? views[name] : void 0;
+  if (!view) return void 0;
+  try {
+    return view(data);
+  } catch {
+    return void 0;
+  }
+}
 function isModelOnlyPart(part) {
   return part.type === FROZEN_CONTEXT_PART_TYPE || part.type === END_TURN_PART_TYPE;
 }
@@ -5445,6 +5465,8 @@ function createAnswerSaver(storage, messageId, durations, usage, onTakenOver, ex
   let lastWriteAt = Date.now();
   let lastSignAt = lastWriteAt;
   let unsaved = false;
+  let changes = 0;
+  let savedChanges = 0;
   let closed = false;
   let writing = null;
   let lastFence = 0;
@@ -5464,6 +5486,7 @@ function createAnswerSaver(storage, messageId, durations, usage, onTakenOver, ex
   }
   async function write() {
     unsaved = false;
+    const writtenChanges = changes;
     lastWriteAt = Date.now();
     lastSignAt = lastWriteAt;
     const parts = latest;
@@ -5477,6 +5500,7 @@ function createAnswerSaver(storage, messageId, durations, usage, onTakenOver, ex
     } catch (failure) {
       noteFailure(failure);
     }
+    savedChanges = Math.max(savedChanges, writtenChanges);
     callsWritten(parts);
   }
   async function markAlive() {
@@ -5554,7 +5578,7 @@ function createAnswerSaver(storage, messageId, durations, usage, onTakenOver, ex
             reachedFence = fence;
             reachFence(fence);
           } else {
-            unsaved = true;
+            noteChange();
             scheduleWrite();
           }
         }
@@ -5568,13 +5592,18 @@ function createAnswerSaver(storage, messageId, durations, usage, onTakenOver, ex
     if (waiting) waiting.push(chunk);
     else feed.enqueue(chunk);
   }
+  function noteChange() {
+    changes++;
+    unsaved = true;
+  }
   async function writeNow() {
+    const target = changes;
     for (; ; ) {
       clearTimeout(timer);
       timer = void 0;
       if (writing) await writing;
-      else if (unsaved && !closed) startWrite();
-      else return;
+      else if (savedChanges < target && !closed) startWrite();
+      else return scheduleWrite();
     }
   }
   async function settleAssembly() {
@@ -5612,7 +5641,7 @@ function createAnswerSaver(storage, messageId, durations, usage, onTakenOver, ex
         const held = waiting;
         waiting = null;
         for (const chunk of held) feed.enqueue(chunk);
-        unsaved = true;
+        noteChange();
         await writeNow();
       };
       const current = erase().finally(() => {
@@ -5631,7 +5660,7 @@ function createAnswerSaver(storage, messageId, durations, usage, onTakenOver, ex
       clearTimeout(aliveTimer);
       await rewinding?.catch(() => {
       });
-      unsaved = true;
+      noteChange();
       await settleAssembly();
       await writeNow();
     },
@@ -9533,9 +9562,10 @@ var CHAT_CAPABILITIES = [
   "toolDetails",
   "steer",
   "modelDetails",
-  "errorDetails"
+  "errorDetails",
+  "appNotices"
 ];
-var OFF_BY_DEFAULT = /* @__PURE__ */ new Set(["errorDetails"]);
+var OFF_BY_DEFAULT = /* @__PURE__ */ new Set(["errorDetails", "appNotices"]);
 function resolveChatCapabilities(given) {
   const resolved = Object.fromEntries(CHAT_CAPABILITIES.map((capability) => [capability, !OFF_BY_DEFAULT.has(capability)]));
   if (given === void 0 || given === null) return resolved;
@@ -9551,6 +9581,7 @@ function resolveChatCapabilities(given) {
   if (!resolved.modelDetails) {
     resolved.modelChoice = false;
     resolved.errorDetails = false;
+    resolved.appNotices = false;
   }
   return resolved;
 }
@@ -12346,10 +12377,17 @@ function createChatService(input) {
     return scope.capabilities;
   }
   let warnedErrorDetailsWithoutModel = false;
+  let warnedAppNoticesWithoutModel = false;
   function warnErrorDetailsWithoutModel(given) {
-    if (warnedErrorDetailsWithoutModel || given?.errorDetails !== true || given.modelDetails !== false) return;
-    warnedErrorDetailsWithoutModel = true;
-    logError("chatCapabilities: errorDetails: true \u043F\u0440\u0438 modelDetails: false \u0432\u044B\u043A\u043B\u044E\u0447\u0435\u043D\u043E \u2014 \u043F\u043E\u0434\u0440\u043E\u0431\u043D\u043E\u0441\u0442\u0438 \u0441\u0431\u043E\u044F \u043D\u0430\u0437\u044B\u0432\u0430\u044E\u0442 \u043C\u043E\u0434\u0435\u043B\u044C \u0438 \u043F\u0440\u043E\u0432\u0430\u0439\u0434\u0435\u0440\u0430.");
+    if (given?.modelDetails !== false) return;
+    if (!warnedErrorDetailsWithoutModel && given.errorDetails === true) {
+      warnedErrorDetailsWithoutModel = true;
+      logError("chatCapabilities: errorDetails: true \u043F\u0440\u0438 modelDetails: false \u0432\u044B\u043A\u043B\u044E\u0447\u0435\u043D\u043E \u2014 \u043F\u043E\u0434\u0440\u043E\u0431\u043D\u043E\u0441\u0442\u0438 \u0441\u0431\u043E\u044F \u043D\u0430\u0437\u044B\u0432\u0430\u044E\u0442 \u043C\u043E\u0434\u0435\u043B\u044C \u0438 \u043F\u0440\u043E\u0432\u0430\u0439\u0434\u0435\u0440\u0430.");
+    }
+    if (!warnedAppNoticesWithoutModel && given.appNotices === true) {
+      warnedAppNoticesWithoutModel = true;
+      logError("chatCapabilities: appNotices: true \u043F\u0440\u0438 modelDetails: false \u0432\u044B\u043A\u043B\u044E\u0447\u0435\u043D\u043E \u2014 \u0441\u043B\u0443\u0436\u0435\u0431\u043D\u044B\u0435 \u043F\u043E\u043C\u0435\u0442\u043A\u0438 \u043F\u043E\u043A\u0430\u0437\u044B\u0432\u0430\u044E\u0442 \u0440\u0430\u0431\u043E\u0442\u0443 \u0441\u0446\u0435\u043D\u0430\u0440\u0438\u044F.");
+    }
   }
   async function askCapabilities(userId, chat) {
     if (!options2.chatCapabilities) return resolveChatCapabilities(void 0);
@@ -12559,6 +12597,7 @@ function createChatService(input) {
     const pending = runningAt < 0 ? [] : branch.slice(runningAt + 1);
     const capabilities = await capabilitiesOf(userId, withClosure(stored, closed), scope);
     const visibility = clientVisibilityOf(capabilities, isScreenTool);
+    const screenNotices = capabilities.appNotices && options2.appNoticeViews ? { appNoticeViews: options2.appNoticeViews } : {};
     const undelivered = undeliveredIdsOf(branch);
     const markedUndelivered = (message) => undelivered.has(message.id) ? { ...message, metadata: { ...message.metadata, undelivered: true } } : message;
     const visible = (list) => visibility.showsEverything ? list : list.map((message) => visibility.visibleMessage(message));
@@ -12570,10 +12609,13 @@ function createChatService(input) {
       messages: visible(
         publicMessages(
           shown.filter((message) => message.id !== runningAnswerId || resumeBases.get(chatId)?.id === runningAnswerId).map((message) => message.id === runningAnswerId ? resumeBases.get(chatId) : markedUndelivered(toAgentChatMessage(message))),
-          hiddenStateKey
+          hiddenStateKey,
+          screenNotices
         )
       ),
-      ...pending.length > 0 && { pendingMessages: visible(publicMessages(pending.map(toAgentChatMessage), hiddenStateKey)) },
+      ...pending.length > 0 && {
+        pendingMessages: visible(publicMessages(pending.map(toAgentChatMessage), hiddenStateKey, screenNotices))
+      },
       // Ход передаётся новому ответу на поправки: он вот-вот пойдёт, поток подождёт его.
       running: runningId !== null || handOffs.has(chatId),
       detachedAnswer: isDetachedAnswer(answerBeforeCorrections(branch), runningId),
@@ -14421,4 +14463,4 @@ export {
   InvalidWidgetAnswerError,
   createChatService
 };
-//# sourceMappingURL=chunk-EWEEYX6U.js.map
+//# sourceMappingURL=chunk-4NQEQWGW.js.map