@ykurilov/agent-chat-react 0.63.2 → 0.64.0

package/CHANGELOG.md

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

@@ -125,6 +125,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-OAQ7TGUB.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;
@@ -4079,7 +4093,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;
@@ -6503,7 +6517,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 +7031,7 @@ export {
   splitVoiceTags,
   stripVoiceTags,
   voiceAnswerIds,
+  customErrorText,
   voiceErrorText,
   englishWorkViewLabels,
   englishWorkLabels,
@@ -7042,4 +7058,4 @@ export {
   activeChatTitle,
   useWorkspaceListSync
 };
-//# sourceMappingURL=chunk-Y5HL6THS.js.map
+//# sourceMappingURL=chunk-OAQ7TGUB.js.map