@ykurilov/agent-chat-react 0.63.2 → 0.65.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @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
+
+- 99cded9: Подробности сбоя провайдера для админа. Ответ, упавший на провайдере, хранит `error.details`: провайдер, модель, код, причина одной строкой (до 300 знаков; ключи окружения, `Bearer`, значения `key=`/`token`/`api-key`/`password`, маски ключей со `*`, параметры адресов, `org-…`/`proj_…` и e-mail вычищены; модерация может повторять текст человека) и `resetsAt` — когда провайдер снимет предел (OpenRouter «resets 2026-11-01»; только будущее до двух лет, без пояса — UTC). В браузер подробности уходят только по новому праву `chatCapabilities` → `errorDetails: true` (по умолчанию `false`, при `modelDetails: false` тоже `false`) — в истории, потоке и при переподключении; остальным — только `error.kind`. `afterTurn` получает их всегда. Экран: подпись-функция `labels.errorText(error, plain)`, без неё или если она бросила исключение — прежний текст `labels.errors[kind]`; типы `ChatError`, `ChatErrorDetails`, помощник `customErrorText`. Хранилища: тип колонки `error` — `ChatError`, миграций нет.
+
 ## 0.63.2
 
 No changes in this release.

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)).
@@ -125,6 +130,18 @@ import { AgentChat, ChatLabelsProvider, russianLabels } from "@ykurilov/agent-ch
 (`process.env.NODE_ENV !== "production"`) в консоли подсказка, какой адрес вписать.
 Состояние — `refusal: "signed_out" | "too_many_turns" | "forbidden_origin" | null` у `useAgentChat`; скин получает их в `ErrorNotice` как `kind`
 (текст — `labels.errors[kind]`).
+Сбой ответа подписывается `labels.errors[kind]`. Своя подпись — функция `labels.errorText(error, plain)`: `error` — вид и,
+если сервер их отдал (право `errorDetails`), подробности `details` (`providerId`, `modelId`, `statusCode`, `reason`,
+`resetsAt`); `plain` — `errors[kind]`. Текст уходит скину в `ErrorNotice` как `text` и диктору. Функция бросила
+исключение — подпись `plain` и одна запись в консоль. Например, админу:
+
+```tsx
+const labels = {
+  ...russianLabels,
+  errorText: (error, plain) =>
+    error.details?.resetsAt ? `${plain}. Предел снимут ${new Date(error.details.resetsAt).toLocaleDateString("ru")}` : plain,
+};
+```
 Ответ брошен упавшей копией сервера — экран сам перечитывает историю раз в 3 с и через 30 с показывает «прерван» с «Повторить»; обновлять страницу не нужно.
 Подробности — [contracts/liveness.md](../../specs/002-fast-feed-and-liveness/contracts/liveness.md).
 

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

@@ -214,6 +214,20 @@ function resetDate(moment, timeZone = "UTC", withTime = false) {
 var resetPhrase = (info) => info.resetsAt ? `, \u043E\u0431\u043D\u043E\u0432\u0438\u0442\u0441\u044F ${resetDate(info.resetsAt, info.timeZone, info.period === "rolling")}` : "";
 var mergeDate = new Intl.DateTimeFormat("ru-RU", { day: "numeric", month: "long", hour: "2-digit", minute: "2-digit" });
 var DEFAULT_VOICE_LIMIT_SECONDS = 300;
+var reportedErrorTextFailure = false;
+function customErrorText(labels, error) {
+  if (!error || !labels.errorText) return void 0;
+  const plain = labels.errors[error.kind];
+  try {
+    return labels.errorText(error, plain);
+  } catch (failure) {
+    if (!reportedErrorTextFailure) {
+      reportedErrorTextFailure = true;
+      console.error("labels.errorText \u0443\u043F\u0430\u043B \u2014 \u043F\u043E\u043A\u0430\u0437\u0430\u043D\u0430 \u043E\u0431\u044B\u0447\u043D\u0430\u044F \u043F\u043E\u0434\u043F\u0438\u0441\u044C \u0441\u0431\u043E\u044F.", failure);
+    }
+    return plain;
+  }
+}
 function voiceErrorText(errors, kind, details) {
   if (kind !== "time_limit") return errors[kind] ?? errors.other;
   const label = errors.time_limit;
@@ -2173,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) {
@@ -4079,7 +4102,7 @@ function announcementFor(messages, labels) {
   const answer = messages.findLast((message) => message.role === "assistant");
   if (!answer) return "";
   const status = answer.metadata?.status ?? "complete";
-  if (status === "error") return labels.errors[answer.metadata?.error?.kind ?? "other"];
+  if (status === "error") return customErrorText(labels, answer.metadata?.error) ?? labels.errors[answer.metadata?.error?.kind ?? "other"];
   if (status === "stopped") return labels.answerStopped;
   if (status === "interrupted") return labels.answerInterrupted;
   if (status === "awaiting_approval") return widgetQuestionOf(answer, labels) ?? labels.approvalAnnouncement;
@@ -5776,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({
@@ -5817,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);
@@ -5985,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(
@@ -6058,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,
@@ -6255,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(
@@ -6503,7 +6543,8 @@ var AgentAnswer = memo4(function AgentAnswer2({
     busy: runningActionIds?.includes(action.id) ?? false,
     onRun: () => onRunAction?.(action, message, text)
   }));
-  const notice = status === "error" ? /* @__PURE__ */ jsx9(skin.ErrorNotice, { kind: message.metadata?.error?.kind ?? "other", ...onRetry && { onRetry } }) : void 0;
+  const errorText = status === "error" ? customErrorText(labels, message.metadata?.error) : void 0;
+  const notice = status === "error" ? /* @__PURE__ */ jsx9(skin.ErrorNotice, { kind: message.metadata?.error?.kind ?? "other", ...errorText !== void 0 && { text: errorText }, ...onRetry && { onRetry } }) : void 0;
   return /* @__PURE__ */ jsx9(ThinkingClockProvider, { id: message.id, waiting: status === "streaming", children: /* @__PURE__ */ jsxs(
     skin.AgentMessage,
     {
@@ -7016,6 +7057,7 @@ export {
   splitVoiceTags,
   stripVoiceTags,
   voiceAnswerIds,
+  customErrorText,
   voiceErrorText,
   englishWorkViewLabels,
   englishWorkLabels,
@@ -7042,4 +7084,4 @@ export {
   activeChatTitle,
   useWorkspaceListSync
 };
-//# sourceMappingURL=chunk-Y5HL6THS.js.map
+//# sourceMappingURL=chunk-JLGBVDAR.js.map