@ykurilov/agent-chat-react 0.64.0 → 0.65.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ykurilov/agent-chat-react
 
+## 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

@@ -39,6 +39,11 @@ import { AgentChat, ChatLabelsProvider, russianLabels } from "@ykurilov/agent-ch
   необязательными `wide` (по ширине ответа со своей пропорцией) и `caption` (подпись под картинкой). Договор скина
   версии 26; скин версии 25 работает без правок: плитка ближайшей обычной пропорции без подписи —
   [docs/skin-v26.md](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/skin-v26.md).
+- Служебные пометки приложения (`kind: "app"`) — серой строкой перед ответом агента: «Агент написал первым — человек
+  молчал 1 ч 7 мин». Нужны право чата `appNotices` на сервере (по умолчанию выключено), `noticeLines` у `AgentChat`
+  (имя пометки → строка; для сценариев — `flowNoticeLines()`) и `ServiceLine` у скина. Договор скина версии 27; скин
+  версии 26 работает без правок: пометок не видно —
+  [docs/skin-v27.md](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/skin-v27.md).
 - `ChatWorkspace` — список чатов и открытый чат вместе: создать, переименовать, удалить (нужен `chatList: true` на сервере). Хук — `useChatList`. Скину дополнительно нужны `ChatWorkspace` и `ChatList` (`ChatListSkin`, договор версии 7).
 - `AgentMemory` — экран долгой памяти агента: записи по разделам, добавить, изменить, удалить, «Стереть всю память» (нужна опция `memory` на сервере, пакет `@ykurilov/agent-chat-memory`). `api` — `createMemoryApi({ api: "/api/chat" })`, создавать один раз; `skin` — `MemorySkin` (`tandemMemorySkin`). Хук — `useMemoryNotes`. Без памяти на сервере экран пишет, что память не включена. Договор скина версии 11 — отдельный `MemorySkin`, `ChatSkin` не менялся ([contracts/memory.md](../../specs/017-long-term-memory/contracts/memory.md)).
 - Панель агента: вход `@ykurilov/agent-chat-react/panel`; основной вход его не подтягивает. `AgentPanelProvider` ставится в корневой макет выше страниц (`api`, `userKey`, `browserTools`, `mode` — `overlay` или `push`, `width`, `onDataChanged`, `fetch` — свой `fetch` только для списка чатов), `AgentPanel` рисует кнопку, рамку и чат через скин. Хуки: `useAgentPanel` (`open`, `openChat`, `openNewChat({ draft })`, `pageInset` — отступ страницы в режиме `push`, на экране ≤ 640 px он 0, `busy`), `useAgentPlace({ description, data? })` (где человек; модель видит только описание, `data` — только инструменты), `useAgentDataChanges(tag, handler)` (страница узнаёт, что инструмент изменил данные). Браузерные инструменты — функции в `browserTools` с теми же именами, что описания на сервере (`BrowserToolImplementations`); нет функции — модель получает «Инструмент недоступен на этой странице» (надпись `agentPanelToolUnavailable`). Подробно — [docs/getting-started.md](../../docs/getting-started.md#панель-агента-в-приложении-по-желанию). Общие части: `AgentAppBridge` (связь чата с приложением; `appBridge` в `AgentChat`, `useAgentChat`, `ChatWorkspace`), `initialDraft` (текст в поле ввода при открытии чата), `rememberKey` в `useChatList` (свой ключ запомненного чата). Договор скина версии 12 — отдельный `AgentPanelSkin` (`AgentPanelLauncher`, `AgentPanel`), надписи `agentPanel…` в словаре; `ChatSkin`, `ChatListSkin` и `MemorySkin` не менялись ([contracts/skin.md](../../specs/021-agent-panel/contracts/skin.md)).

package/dist/{chunk-OAQ7TGUB.js → chunk-JLGBVDAR.js}

@@ -2187,8 +2187,17 @@ function useBackgroundTasks({ chatUrl: chatUrl2, enabled, version, fetch: custom
 
 // src/notices/agent-notices.ts
 var AGENT_NOTICE_PART_TYPE = "data-agent-notice";
+var isAgentNoticePart = (part) => part.type === AGENT_NOTICE_PART_TYPE;
 function agentNoticesOf(message) {
-  return rawNoticesOf(message).filter((notice) => notice.kind !== STAFF_NOTICE_KIND);
+  return rawNoticesOf(message).filter((notice) => notice.kind !== STAFF_NOTICE_KIND && notice.kind !== APP_NOTICE_KIND);
+}
+var APP_NOTICE_KIND = "app";
+function appNoticesOf(message) {
+  return rawNoticesOf(message).flatMap((notice) => {
+    if (notice.kind !== APP_NOTICE_KIND) return [];
+    const { name, data } = notice;
+    return typeof name === "string" ? [{ name, data }] : [];
+  });
 }
 var STAFF_NOTICE_KIND = "staff";
 function staffRepliesOf(message) {
@@ -5790,7 +5799,7 @@ function SubjectAgentChat(props) {
   if (found.state === "failed") return /* @__PURE__ */ jsx9(props.skin.ErrorNotice, { kind: "other", onRetry: found.retry });
   return /* @__PURE__ */ jsx9(SubjectChatLoading, { skin: props.skin });
 }
-function AgentChatBody({ api, chatId, skin, liveness, voice, voiceDialog, attachments: attachmentsPlugin, spendingLimits, onBusyChange, appBridge, initialDraft, answerEditing, onFeedChange, messageActions, onTurnFinished, onTurnRefused, composerActions, onAppEvent, onChatAccessChange, onStateChange, onModelChosen, onChatUnavailable, reloadKey, steering, widgets, diagrams, liveDemos, images, videos, appEvents, workView, stepPhrases }) {
+function AgentChatBody({ api, chatId, skin, liveness, voice, voiceDialog, attachments: attachmentsPlugin, spendingLimits, onBusyChange, appBridge, initialDraft, answerEditing, onFeedChange, messageActions, onTurnFinished, onTurnRefused, composerActions, onAppEvent, onChatAccessChange, onStateChange, onModelChosen, onChatUnavailable, reloadKey, steering, widgets, diagrams, liveDemos, images, videos, appEvents, workView, stepPhrases, noticeLines }) {
   const spendingNoticeId = useId2();
   const closedNoticeId = useId2();
   const chat = useAgentChat({
@@ -5831,9 +5840,10 @@ function AgentChatBody({ api, chatId, skin, liveness, voice, voiceDialog, attach
       ...videos && { videos },
       ...appEvents && { appEvents },
       ...workView && { workView },
-      ...stepPhrases && { stepPhrases }
+      ...stepPhrases && { stepPhrases },
+      ...noticeLines && { noticeLines }
     }),
-    [widgets, diagrams, liveDemos, imageClients, videos, appEvents, workView, stepPhrases]
+    [widgets, diagrams, liveDemos, imageClients, videos, appEvents, workView, stepPhrases, noticeLines]
   );
   const scrollRef = useRef17(null);
   const feedRef = useRef17(null);
@@ -5999,7 +6009,10 @@ ${text}` : text),
       const NoticeView = skin.AgentNoticeView;
       const notices2 = agentNoticesOf(message);
       const staffReplies = staffRepliesOf(message);
-      const shown = staffReplies.length > 0 ? /* @__PURE__ */ jsx9(StaffReplies, { skin, replies: staffReplies, label: labels.notices.staffSaid }) : notices2.length > 0 ? NoticeView ? /* @__PURE__ */ jsx9(Fragment2, { children: notices2.map((notice2, noticeIndex) => /* @__PURE__ */ jsx9(NoticeView, { ...noticeViewOf(notice2, noticeControls) }, noticeIndex)) }) : (
+      const appNotices = appNoticesOf(message);
+      const serviceLines = appNotices.length > 0 && /* @__PURE__ */ jsx9(ServiceLines, { skin, notices: appNotices, lines: extensions.noticeLines });
+      const onlyAppNotices = appNotices.length > 0 && notices2.length === 0 && staffReplies.length === 0 && message.parts.every(isAgentNoticePart);
+      const content = onlyAppNotices ? /* @__PURE__ */ jsx9(Fragment2, {}) : staffReplies.length > 0 ? /* @__PURE__ */ jsx9(StaffReplies, { skin, replies: staffReplies, label: labels.notices.staffSaid }) : notices2.length > 0 ? NoticeView ? /* @__PURE__ */ jsx9(Fragment2, { children: notices2.map((notice2, noticeIndex) => /* @__PURE__ */ jsx9(NoticeView, { ...noticeViewOf(notice2, noticeControls) }, noticeIndex)) }) : (
         // Скин без плашек (v16): короткая строка из словаря, не пустой пузырь; править служебное сообщение нельзя.
         /* @__PURE__ */ jsx9(skin.UserMessage, { text: noticesAsText(notices2, labels.notices), ...branchSwitcher && { branchSwitcher } })
       ) : message.role === "user" ? editingId === message.id ? /* @__PURE__ */ jsx9(
@@ -6072,6 +6085,10 @@ ${text}` : text),
           }
         }
       );
+      const shown = serviceLines ? /* @__PURE__ */ jsxs(Fragment2, { children: [
+        serviceLines,
+        content
+      ] }) : content;
       const markers = dividers.get(message.id);
       return markers ? /* @__PURE__ */ jsxs(Fragment2, { children: [
         shown,
@@ -6269,6 +6286,15 @@ var EDIT_REFUSAL_ERRORS = {
   // Текст сервера идёт в редактор как есть; надпись — на случай, если текста почему-то нет.
   server_refused: "rejected"
 };
+function ServiceLines({ skin, notices, lines }) {
+  const View = skin.ServiceLine;
+  if (!View || !lines) return null;
+  const texts = notices.flatMap((notice) => {
+    const text = Object.hasOwn(lines, notice.name) ? lines[notice.name](notice) : void 0;
+    return text ? [{ name: notice.name, text }] : [];
+  });
+  return /* @__PURE__ */ jsx9(Fragment2, { children: texts.map(({ name, text }, index) => /* @__PURE__ */ jsx9(View, { text }, `${name}-${index}`)) });
+}
 function StaffReplies({ skin, replies, label }) {
   const View = skin.StaffMessage;
   return /* @__PURE__ */ jsx9(Fragment2, { children: replies.map(
@@ -7058,4 +7084,4 @@ export {
   activeChatTitle,
   useWorkspaceListSync
 };
-//# sourceMappingURL=chunk-OAQ7TGUB.js.map
+//# sourceMappingURL=chunk-JLGBVDAR.js.map