@ykurilov/agent-chat-core 0.63.2 → 0.64.0

package/CHANGELOG.md

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

package/README.md

@@ -82,8 +82,8 @@ 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`; по умолчанию всё `true`; `modelDetails: false` выключает и `modelChoice`). Неизвестное право или не булево значение — `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`. Меню моделей — опция `modelMenu({ userId })`: `false` — `getModelMenu(userId)` бросает `ActionForbiddenError("modelDetails")`. История несёт `modelAcceptsImages` (видит ли модель чата картинки). Права — на того, кто открыл поток.
+- Права человека в чате: `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)`.
+- Скрытие частей ответа: `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)`.
 - Чат объекта: `service.openSubjectChat({ ownerId, key, data?, title?, greeting? })` → `{ chat, created }`, один чат на ключ у человека. Инструменты получают `model.subject`, итог хода — `turn.subject`. `listChats(userId, { subjects })` — по умолчанию без чатов объектов.

package/dist/access.js

@@ -1,8 +1,8 @@
 import {
   accessRefusedResponse,
   allowedUser
-} from "./chunk-FBULM4V6.js";
-import "./chunk-FOAIG4DY.js";
+} from "./chunk-5UUWSY6V.js";
+import "./chunk-CVRDB3NM.js";
 export {
   accessRefusedResponse,
   allowedUser

package/dist/{chunk-FBULM4V6.js → chunk-5UUWSY6V.js}

@@ -1,6 +1,6 @@
 import {
   normalizeTurnRefusal
-} from "./chunk-FOAIG4DY.js";
+} from "./chunk-CVRDB3NM.js";
 
 // src/access/resolved-user.ts
 function allowedUser(resolved) {
@@ -17,4 +17,4 @@ export {
   allowedUser,
   accessRefusedResponse
 };
-//# sourceMappingURL=chunk-FBULM4V6.js.map
+//# sourceMappingURL=chunk-5UUWSY6V.js.map

package/dist/{chunk-FOAIG4DY.js → chunk-CVRDB3NM.js}

@@ -53,4 +53,4 @@ export {
   TurnRefusedError,
   validateAppEvent
 };
-//# sourceMappingURL=chunk-FOAIG4DY.js.map
+//# sourceMappingURL=chunk-CVRDB3NM.js.map

package/dist/chunk-CVRDB3NM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/turn-hooks/turn-hooks.ts"],"sourcesContent":["import type { AgentChannel, Chat, ChatError, ChatSubject, FinalAnswerStatus, StoredMessage, TokenUsage } from \"../conversation/types\";\n\n/** Что человек делает с чатом, когда приложение решает, пускать ли ход. */\nexport type TurnAction = \"send\" | \"edit\" | \"retry\" | \"regenerate\" | \"approval\" | \"widget\" | \"notice\";\n\n/** Отказ приложения в ходе: код для программы, текст для человека. */\nexport interface TurnRefusal {\n  /** Латиница в нижнем регистре, цифры и `.`, `_`, `-`; от 1 до 64 знаков. */\n  code: string;\n  /** До 300 знаков; длиннее — обрезается. */\n  message: string;\n}\n\n/**\n * Сотрудник, который действует в чужом чате (копия чата человека в песочнице). Пока он есть у хода (`model.staff`),\n * инструменты приложения данные `ownerId` только читают: любая запись в них запрещена — это обязанность инструментов.\n */\nexport interface StaffActor {\n  id: string;\n}\n\n/** Событие приложения в ответе агента: `type` — 1–100 знаков, `data` — JSON до 16 КБ. */\nexport interface AppEvent {\n  type: string;\n  data?: unknown;\n}\n\n/** Записать сообщение человека без хода: агент промолчит (рамки дня, пауза сценария). */\nexport interface TurnHold {\n  hold: true;\n}\n\n/** Ход с готовым текстом, без модели: путь `reply` из `deliverNotices`. */\nexport interface TurnReply {\n  reply: { text: string };\n}\n\n/** Что `beforeTurn` может решить, кроме «пускать»: отказ, «записать без хода» или «ответить готовым текстом». */\nexport type BeforeTurnDecision = TurnRefusal | TurnHold | TurnReply;\n\n/**\n * Проверка приложения перед ходом: вернуть отказ — ход не начнётся и ничего не запишется. `{ hold: true }` и\n * `{ reply }` — с 0.49 (сценарии): сообщение записывается, хода модели нет.\n */\nexport type BeforeTurnHandler = (input: {\n  userId: string;\n  chat: Chat;\n  action: TurnAction;\n  /** Текст сообщения человека (`send`, `edit`). */\n  text?: string;\n  /** Id сообщения человека (`send`, `edit`): по нему приложение свяжет свой резерв с ходом. */\n  messageId?: string;\n  /**\n   * Ход на пачку сообщений человека (`sendBurstMessage`): id всех её сообщений по порядку, последнее — `messageId`, а\n   * `text` — их тексты через пустую строку. Одно решение на всю пачку; счёт сообщений — по длине списка.\n   */\n  burstMessageIds?: string[];\n  /**\n   * Ход на пачку начал сам сервер после перезапуска или за упавшую копию (`answerAfterRestart`): вызова, который ждёт\n   * ответ или отказ, нет. Отказ дойдёт только до журнала — сообщить человеку может само приложение.\n   */\n  unattended?: true;\n} & AbandonedAnswers) => Promise<BeforeTurnDecision | void> | BeforeTurnDecision | void;\n\n/**\n * Ответы агента, которые уйдут с текущей ветки, если ход начнётся (`regenerate`, `edit`, `retry`): по ним приложение откатывает\n * побочные дела брошенных ответов (правки формы и т. п.). Ход не начался (`turnNotStarted`) — ветка прежняя, ничего не\n * ушло: тот хук получает те же поля. Посчитаны по ветке на миг проверки; сообщения нет на ветке — полей нет.\n */\nexport interface AbandonedAnswers {\n  /** Ответы агента, которые уходят с ветки, сверху вниз; у `edit` без ответов ниже — пустой список. */\n  abandonedAnswerIds?: string[];\n  /**\n   * Ответ, который заменит новый: переделываемый (`regenerate`), ответ на правленый вопрос (`edit`), если был, или\n   * оборванный ответ, который «Повторить» (`retry`) заменяет соседом. У «Повторить» вопроса без ответа полей нет.\n   */\n  previousAnswerId?: string;\n}\n\n/** Почему ход не начался после того, как `beforeTurn` его пропустил. */\nexport type TurnNotStartedReason =\n  /** В чате уже идёт ответ, или служба останавливается (`flush`). */\n  | \"busy\"\n  /** У человека уже идёт предел одновременных ходов. */\n  | \"too_many_turns\"\n  /** Лимит расходов исчерпан. */\n  | \"spending_limit\"\n  /** Сообщение с таким id уже есть (повтор запроса). */\n  | \"duplicate_message\"\n  /** Запрос неверен: сообщение, файл, решение, ответ на виджет. */\n  | \"invalid\"\n  /** Чат закрыли, пока ход запускался (`closeChat` между проверкой и началом хода). */\n  | \"chat_closed\"\n  /** Хода и не будет: проверка без хода (`assertTurnAllowed`), ответ ждёт ещё решений, служебное сообщение без ответа. */\n  | \"no_turn\"\n  /** Сбой (база, сеть): ход не начат. */\n  | \"error\";\n\n/**\n * Ход не начался, хотя `beforeTurn` его пропустил: приложение снимает свой резерв. Каждый пропуск `beforeTurn`\n * закрывается ровно одним: ходом (`afterTurn`) или этим хуком. Ошибка хода наружу прежняя; бросок хука — в журнал.\n */\nexport type TurnNotStartedHandler = (input: {\n  userId: string;\n  chat: Chat;\n  action: TurnAction;\n  messageId?: string;\n  text?: string;\n  /** Пачка сообщений, как в `beforeTurn`. */\n  burstMessageIds?: string[];\n  /** Ход без вызова, как в `beforeTurn`: об отказе (например, `spending_limit`) человеку может сказать только приложение. */\n  unattended?: true;\n  reason: TurnNotStartedReason;\n} & AbandonedAnswers) => Promise<void> | void;\n\n/** Кто остановил ход: человек («Стоп»), общий срок хода (`agent.turnTimeoutMs`) или остановка службы (`flush`). */\nexport type TurnStopReason = \"user\" | \"timeout\" | \"shutdown\";\n\n/** Итог законченного хода для приложения. */\nexport interface TurnResult {\n  ownerId: string;\n  /** Кто сделал ход: владелец чата, а в копии у сотрудника — сотрудник. */\n  actorId: string;\n  chatId: string;\n  messageId: string;\n  status: FinalAnswerStatus;\n  /** Кто остановил ход; только у `status: \"stopped\"` живого хода (у доделанного после перезапуска нет). */\n  stopReason?: TurnStopReason;\n  /** Ответ упёрся в предел токенов (`finishReason: \"length\"`, см. `agent.maxOutputTokens`) и оборван. */\n  lengthCut?: true;\n  /**\n   * Ход дошёл до предела шагов (`agent.maxSteps`): последний шаг был итоговым, без инструментов. Это «дошли до потолка»,\n   * а не обязательно «недоделали»: модель могла закончить дело как раз на последнем шаге. Статус обычный (`complete`).\n   * В журнале SDK — строка `[предел шагов]`.\n   */\n  stepLimit?: true;\n  /** Текстовые части ответа подряд. */\n  text: string;\n  /** Части ответа, как они записаны, кроме служебной части с блоками контекста (`data-frozen-context`). */\n  parts: StoredMessage[\"parts\"];\n  usage: TokenUsage | null;\n  /** Цена хода в долларах; `null` — у модели нет цены. */\n  costUsd: number | null;\n  /** Вид сбоя и подробности провайдера (`details`): хук на сервере получает их всегда. */\n  error?: ChatError;\n  /**\n   * Каким действием начат ход (см. `TurnAction`). `null` — итог доделан после перезапуска (`recovered`), а ядро не\n   * помнит действие; ход по служебному сообщению и тогда — `notice`.\n   */\n  trigger: TurnAction | null;\n  channel: AgentChannel;\n  /**\n   * Ход сделал сотрудник в копии чата человека (песочница): `ownerId` и `subject` — человека и его исходного чата.\n   * При `staff` в данные человека не писать.\n   */\n  staff?: StaffActor;\n  /** Объект чата (урок, заказ…): ключ и данные чата объекта. Нет — обычный чат. */\n  subject?: ChatSubject;\n  /** Данные чата (`Chat.data`) на момент итога; нет данных — поля нет. */\n  chatData?: Record<string, unknown>;\n  /** Итог доделан после перезапуска сервера, а не сразу после хода. */\n  recovered: boolean;\n}\n\n/**\n * Хук итога хода: зовётся после записи итога и расхода, до `finish` клиенту; пока он идёт, чат занят. Получает любой\n * итог: законченный, остановленный, с ошибкой, прерванный (в том числе восстановлением после перезапуска) и ждущий\n * человека. Ждущий ответ (`awaiting_approval`) после решения человека продолжается тем же сообщением — хук позовут\n * второй раз, с новым статусом. Хук может быть вызван повторно (повтор после сбоя, доделка после перезапуска):\n * ключ повтора — `messageId` + `status`. Возвращённые `events` ложатся в конец ответа частями `data-app-event`.\n */\nexport type AfterTurnHandler = (\n  result: TurnResult,\n) => Promise<{ events?: AppEvent[] } | void> | { events?: AppEvent[] } | void;\n\nexport const TURN_REFUSAL_MESSAGE_MAX_LENGTH = 300;\nexport const APP_EVENT_TYPE_MAX_LENGTH = 100;\nexport const APP_EVENT_DATA_MAX_BYTES = 16 * 1024;\n\nconst TURN_REFUSAL_CODE = /^[a-z0-9_.-]{1,64}$/;\n\nexport function isTurnRefusalCode(code: unknown): code is string {\n  return typeof code === \"string\" && TURN_REFUSAL_CODE.test(code);\n}\n\n/** Отказ по правилам: код проверен (иначе `TypeError`), текст обрезан до 300 знаков. */\nexport function normalizeTurnRefusal(refusal: TurnRefusal): TurnRefusal {\n  if (!isTurnRefusalCode(refusal?.code)) throw new TypeError(\"Код отказа — [a-z0-9_.-], от 1 до 64 знаков\");\n  if (typeof refusal.message !== \"string\") throw new TypeError(\"Текст отказа — строка\");\n  // По знакам, а не по половинкам: эмодзи на границе не рвётся.\n  const message = Array.from(refusal.message).slice(0, TURN_REFUSAL_MESSAGE_MAX_LENGTH).join(\"\");\n  return { code: refusal.code, message };\n}\n\n/** Приложение отказало в ходе: ход не начат, ничего не записано. */\nexport class TurnRefusedError extends Error {\n  readonly code: string;\n\n  constructor(refusal: TurnRefusal) {\n    const normalized = normalizeTurnRefusal(refusal);\n    super(normalized.message);\n    this.name = \"TurnRefusedError\";\n    this.code = normalized.code;\n  }\n\n  get refusal(): TurnRefusal {\n    return { code: this.code, message: this.message };\n  }\n}\n\n/** Событие по правилам или `TypeError`. Отдаёт копию: данные прошли через JSON. */\nexport function validateAppEvent(event: unknown): AppEvent {\n  if (event === null || typeof event !== \"object\") throw new TypeError(\"Событие приложения — объект { type, data? }\");\n  const { type, data } = event as { type?: unknown; data?: unknown };\n  if (typeof type !== \"string\" || type.length < 1 || type.length > APP_EVENT_TYPE_MAX_LENGTH) {\n    throw new TypeError(`Тип события приложения — строка от 1 до ${APP_EVENT_TYPE_MAX_LENGTH} знаков`);\n  }\n  if (data === undefined) return { type };\n  let json: string | undefined;\n  try {\n    json = JSON.stringify(data);\n  } catch {\n    json = undefined;\n  }\n  if (json === undefined) throw new TypeError(\"Данные события приложения — значение JSON\");\n  if (new TextEncoder().encode(json).length > APP_EVENT_DATA_MAX_BYTES) {\n    throw new TypeError(`Данные события приложения больше ${APP_EVENT_DATA_MAX_BYTES} байт`);\n  }\n  return { type, data: JSON.parse(json) };\n}\n"],"mappings":";AA+KO,IAAM,kCAAkC;AACxC,IAAM,4BAA4B;AAClC,IAAM,2BAA2B,KAAK;AAE7C,IAAM,oBAAoB;AAEnB,SAAS,kBAAkB,MAA+B;AAC/D,SAAO,OAAO,SAAS,YAAY,kBAAkB,KAAK,IAAI;AAChE;AAGO,SAAS,qBAAqB,SAAmC;AACtE,MAAI,CAAC,kBAAkB,SAAS,IAAI,EAAG,OAAM,IAAI,UAAU,iJAA6C;AACxG,MAAI,OAAO,QAAQ,YAAY,SAAU,OAAM,IAAI,UAAU,iHAAuB;AAEpF,QAAM,UAAU,MAAM,KAAK,QAAQ,OAAO,EAAE,MAAM,GAAG,+BAA+B,EAAE,KAAK,EAAE;AAC7F,SAAO,EAAE,MAAM,QAAQ,MAAM,QAAQ;AACvC;AAGO,IAAM,mBAAN,cAA+B,MAAM;AAAA,EACjC;AAAA,EAET,YAAY,SAAsB;AAChC,UAAM,aAAa,qBAAqB,OAAO;AAC/C,UAAM,WAAW,OAAO;AACxB,SAAK,OAAO;AACZ,SAAK,OAAO,WAAW;AAAA,EACzB;AAAA,EAEA,IAAI,UAAuB;AACzB,WAAO,EAAE,MAAM,KAAK,MAAM,SAAS,KAAK,QAAQ;AAAA,EAClD;AACF;AAGO,SAAS,iBAAiB,OAA0B;AACzD,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,OAAM,IAAI,UAAU,qKAA6C;AAClH,QAAM,EAAE,MAAM,KAAK,IAAI;AACvB,MAAI,OAAO,SAAS,YAAY,KAAK,SAAS,KAAK,KAAK,SAAS,2BAA2B;AAC1F,UAAM,IAAI,UAAU,sMAA2C,yBAAyB,uCAAS;AAAA,EACnG;AACA,MAAI,SAAS,OAAW,QAAO,EAAE,KAAK;AACtC,MAAI;AACJ,MAAI;AACF,WAAO,KAAK,UAAU,IAAI;AAAA,EAC5B,QAAQ;AACN,WAAO;AAAA,EACT;AACA,MAAI,SAAS,OAAW,OAAM,IAAI,UAAU,2MAA2C;AACvF,MAAI,IAAI,YAAY,EAAE,OAAO,IAAI,EAAE,SAAS,0BAA0B;AACpE,UAAM,IAAI,UAAU,qLAAoC,wBAAwB,2BAAO;AAAA,EACzF;AACA,SAAO,EAAE,MAAM,MAAM,KAAK,MAAM,IAAI,EAAE;AACxC;","names":[]}

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

@@ -3,7 +3,7 @@ import {
   TurnRefusedError,
   normalizeTurnRefusal,
   validateAppEvent
-} from "./chunk-FOAIG4DY.js";
+} from "./chunk-CVRDB3NM.js";
 
 // src/conversation/types.ts
 var CURRENT_FORMAT_VERSION = 1;
@@ -525,7 +525,10 @@ var MIN_SECRET_LENGTH = 8;
 var HIDDEN = "[\u0441\u043A\u0440\u044B\u0442\u043E]";
 var SECRET_FIELD = String.raw`[\w-]*(?:password|passwd|secret|token|api[_-]?key|(?:secret|private|access)[_-]?key)(?![\w-])`;
 var FIELD_VALUE = String.raw`(?!\d+(?![^&\s"',;]))(?:"[^"]*"|'[^']*'|[^&\s"',;]+)`;
+var SECRET_LIKE = String.raw`(?=[^\s"',;]*\d)(?=[^\s"',;]*[A-Za-z])[^\s"',;]{8,}`;
 var KNOWN_KEY_PATTERNS = [
+  // Маска ключа целиком: провайдер показывает начало и последние знаки ключа.
+  /[\w-]*\*{4,}[\w-]*/g,
   /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g,
   /\bsk-[A-Za-z0-9_-]{8,}/g,
   /\b[spr]k_(?:live|test)_[A-Za-z0-9]{8,}/g,
@@ -547,7 +550,7 @@ function scrubSecrets(text, knownSecrets = []) {
     if (secret && secret.length >= MIN_SECRET_LENGTH) scrubbed = scrubbed.split(secret).join(HIDDEN);
   }
   for (const pattern of KNOWN_KEY_PATTERNS) scrubbed = scrubbed.replace(pattern, HIDDEN);
-  return scrubbed.replace(URL_PASSWORD, `$1:${HIDDEN}@`).replace(/\b((?:Proxy-)?Authorization\s*[:=]\s*)(?:(Basic|Bearer|Token|Digest)\s+)?[^\s"',;]+/gi, (_, head, scheme) => `${head}${scheme ? `${scheme} ` : ""}${HIDDEN}`).replace(/\bBearer\s+(?!\[скрыто\])[^\s"',;]+/g, `Bearer ${HIDDEN}`).replace(/([?&;]key=)[^&\s"]+/g, `$1${HIDDEN}`).replace(new RegExp(String.raw`("${SECRET_FIELD}"\s*:\s*)"[^"]*"`, "gi"), `$1"${HIDDEN}"`).replace(
+  return scrubbed.replace(URL_PASSWORD, `$1:${HIDDEN}@`).replace(/\b((?:Proxy-)?Authorization\s*[:=]\s*)(?:(Basic|Bearer|Token|Digest)\s+)?[^\s"',;]+/gi, (_, head, scheme) => `${head}${scheme ? `${scheme} ` : ""}${HIDDEN}`).replace(/\b(Bearer\s+)(?!\[скрыто\])[^\s"',;]+/gi, `$1${HIDDEN}`).replace(/([?&;]key=)[^&\s"]+/g, `$1${HIDDEN}`).replace(new RegExp(String.raw`(?<![\w-])(key\s*[:=]\s*)${SECRET_LIKE}`, "gi"), `$1${HIDDEN}`).replace(new RegExp(String.raw`(?<![\w-])((?:token|api[_-]?key|secret|password|passwd|key)\s+)${SECRET_LIKE}`, "gi"), `$1${HIDDEN}`).replace(new RegExp(String.raw`("${SECRET_FIELD}"\s*:\s*)"[^"]*"`, "gi"), `$1"${HIDDEN}"`).replace(
     new RegExp(String.raw`(?<![\w-])(${SECRET_FIELD}\s*[:=]\s*)(?!"\[скрыто\]")(${FIELD_VALUE})`, "gi"),
     (_, head, value) => /^["']/.test(value) ? `${head}${value[0]}${HIDDEN}${value[0]}` : `${head}${HIDDEN}`
   );
@@ -5326,6 +5329,100 @@ ${summary}
 </answer_progress>`;
 }
 
+// src/provider-errors/provider-error-details.ts
+import { APICallError as APICallError4 } from "ai";
+var MAX_REASON_LENGTH = 300;
+var MAX_RESET_AHEAD_MS = 2 * 366 * 24 * 60 * 60 * 1e3;
+function providerErrorDetails(error, context) {
+  const cause = underlyingError(error);
+  const statusCode = errorStatusCode(cause);
+  const { message, metadata } = providerMessageOf(cause);
+  const reason = message === void 0 ? void 0 : shownReason(message, environmentSecrets(context.env, context.catalog));
+  const nowMs = (context.now ?? Date.now)();
+  const found = resetFromMetadata(metadata, nowMs) ?? (message === void 0 ? void 0 : resetFromText(message));
+  const resetsAt = found !== void 0 && found > nowMs && found - nowMs <= MAX_RESET_AHEAD_MS ? new Date(found).toISOString() : void 0;
+  return {
+    providerId: context.providerId,
+    modelId: context.modelId,
+    ...statusCode !== void 0 && { statusCode },
+    ...reason !== void 0 && reason !== "" && { reason },
+    ...resetsAt !== void 0 && { resetsAt }
+  };
+}
+function providerMessageOf(error) {
+  if (APICallError4.isInstance(error)) {
+    const fromBody = typeof error.responseBody === "string" ? fromJson(error.responseBody) : void 0;
+    if (fromBody?.message !== void 0) return fromBody;
+    const raw = [error.responseBody, error.message].find(isText);
+    return { ...raw !== void 0 && { message: raw }, metadata: fromBody?.metadata };
+  }
+  if (typeof error === "string") return isText(error) ? { message: error } : {};
+  return fromObject(error) ?? {};
+}
+function fromJson(body) {
+  try {
+    return fromObject(JSON.parse(body));
+  } catch {
+    return void 0;
+  }
+}
+function fromObject(value) {
+  if (typeof value !== "object" || value === null) return void 0;
+  const fields = value;
+  if (typeof fields.error === "object" && fields.error !== null) {
+    const nested = fields.error;
+    if (isText(nested.message)) return { message: nested.message, metadata: nested.metadata };
+  }
+  if (isText(fields.error)) return { message: fields.error, metadata: fields.metadata };
+  if (isText(fields.message)) return { message: fields.message, metadata: fields.metadata };
+  return void 0;
+}
+var isText = (value) => typeof value === "string" && value.trim() !== "";
+var URL_WITH_QUERY = /(https?:\/\/[^\s?#"'<>]+)[?#][^\s"'<>]*/g;
+var ACCOUNT_IDS = [/\borg-[A-Za-z0-9]{6,}/g, /\bproj_[A-Za-z0-9]{6,}/g, /[\w.+-]+@[\w-]+(?:\.[\w-]+)+/g];
+function shownReason(message, knownSecrets) {
+  const oneLine2 = message.replace(/\s*[\r\n]+\s*/g, " ").trim();
+  let shown = scrubSecrets(oneLine2.replace(URL_WITH_QUERY, "$1"), knownSecrets);
+  for (const pattern of ACCOUNT_IDS) shown = shown.replace(pattern, "[\u0441\u043A\u0440\u044B\u0442\u043E]");
+  return cutAtCharBoundary(shown, MAX_REASON_LENGTH);
+}
+var RESET_FIELD = /reset/i;
+var RELATIVE_FIELD = /sec|after|in$|_in_|ms$|_ms|Ms$/i;
+var MS_FIELD = /ms$|_ms|Ms$/;
+var MIN_UNIX_SECONDS = 1e9;
+function resetFromMetadata(metadata, nowMs) {
+  if (typeof metadata !== "object" || metadata === null) return void 0;
+  for (const [key, value] of Object.entries(metadata)) {
+    if (!RESET_FIELD.test(key)) continue;
+    const parsed = typeof value === "number" ? fromNumber(key, value, nowMs) : typeof value === "string" ? fromDateText(value) : void 0;
+    if (parsed !== void 0) return parsed;
+  }
+  return void 0;
+}
+function fromNumber(key, value, nowMs) {
+  if (!Number.isFinite(value) || value <= 0) return void 0;
+  if (RELATIVE_FIELD.test(key) || value < MIN_UNIX_SECONDS) return nowMs + (MS_FIELD.test(key) ? value : value * 1e3);
+  return value < 1e12 ? value * 1e3 : value;
+}
+var LIMIT_MESSAGE_START = /^[^'"«“]{0,80}?\b(?:limit|budget|quota)\b/i;
+var QUOTED = /'[^']*'|"[^"]*"|«[^»]*»|“[^”]*”/g;
+var RESET_IN_TEXT = /\bresets?\s+(?:at\s+|on\s+)?(\d{4}-\d{2}-\d{2}(?:[T ]\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:?\d{2})?)?)/i;
+function resetFromText(message) {
+  if (!LIMIT_MESSAGE_START.test(message)) return void 0;
+  const found = RESET_IN_TEXT.exec(message.replace(QUOTED, " "))?.[1];
+  return found === void 0 ? void 0 : fromDateText(found);
+}
+function fromDateText(text) {
+  const trimmed = text.trim();
+  const match = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?)(Z|[+-]\d{2}:?\d{2})?)?$/i.exec(trimmed);
+  if (!match) return void 0;
+  const [, year, month, day, time, zone] = match;
+  const calendarDay = new Date(Date.UTC(Number(year), Number(month) - 1, Number(day)));
+  if (calendarDay.getUTCMonth() !== Number(month) - 1 || calendarDay.getUTCDate() !== Number(day)) return void 0;
+  const parsed = Date.parse(`${year}-${month}-${day}${time === void 0 ? "" : `T${time}${zone ?? "Z"}`}`);
+  return Number.isNaN(parsed) ? void 0 : parsed;
+}
+
 // src/agent-run/answer-saver.ts
 import { readUIMessageStream } from "ai";
 
@@ -6608,6 +6705,14 @@ async function runTurn(turnInput, emitRaw) {
     let errors = [];
     let terminal = [];
     let errorKind;
+    let errorDetails;
+    const detailsOf2 = (error2, failedProviderId) => providerErrorDetails(error2, {
+      providerId: failedProviderId,
+      modelId,
+      env: input.env,
+      catalog: input.catalog,
+      now: () => (input.now ?? (() => /* @__PURE__ */ new Date()))().getTime()
+    });
     let providerId = input.providerId;
     let answeredProviderId = input.providerId;
     let viewer;
@@ -6650,6 +6755,7 @@ async function runTurn(turnInput, emitRaw) {
       });
       const fallbackProviderIds = allFallbackIds.filter((candidate) => outages.pausedKind(candidate) === void 0);
       let firstOutage;
+      let firstOutageDetails;
       const primaryPaused = outages.admit(input.providerId);
       if (primaryPaused !== void 0 && fallbackProviderIds[0] !== void 0) {
         providerId = fallbackProviderIds[0];
@@ -6746,7 +6852,9 @@ async function runTurn(turnInput, emitRaw) {
         } catch (error2) {
           if (error2 instanceof MissingProviderKeyError) logError(error2.message);
           if (!input.abortSignal.aborted) {
-            errorKind = errorKindForPerson(classify(error2), firstOutage);
+            const kind = classify(error2);
+            errorKind = errorKindForPerson(kind, firstOutage);
+            errorDetails = errorKind === firstOutage ? firstOutageDetails : detailsOf2(error2, providerId);
             errors = [{ type: "error", errorText: errorKind }];
           }
           break;
@@ -6790,7 +6898,10 @@ async function runTurn(turnInput, emitRaw) {
         let next = stepsDone < maxSteps ? decideNextAttempt(result, nextState()) : { action: "fail" };
         const outage = isProviderOutage(result.kind) ? result.kind : void 0;
         if (outage) {
-          if (providerId === input.providerId) firstOutage ??= outage;
+          if (providerId === input.providerId && firstOutage === void 0) {
+            firstOutage = outage;
+            firstOutageDetails = detailsOf2(result.error, providerId);
+          }
           outages.report({
             providerId,
             kind: outage,
@@ -6879,6 +6990,7 @@ async function runTurn(turnInput, emitRaw) {
           continue;
         }
         errorKind = errorKindForPerson(result.kind, firstOutage);
+        errorDetails = errorKind === firstOutage ? firstOutageDetails : detailsOf2(result.error, providerId);
         errors = errorKind === result.kind ? attempt.errors : [{ type: "error", errorText: errorKind }];
         terminal = attempt.terminal;
         logError(
@@ -6916,6 +7028,7 @@ async function runTurn(turnInput, emitRaw) {
       if (!input.abortSignal.aborted) {
         if (error2 instanceof AgentViewerError) logError(`[agent.viewer] \u0447\u0430\u0442=${input.chatId} \u0445\u043E\u0434 \u043D\u0435 \u043D\u0430\u0447\u0430\u0442: ${error2.message}`);
         errorKind = error2 instanceof AgentViewerError ? "other" : classifyProviderError(error2, void 0);
+        errorDetails = void 0;
         errors = [{ type: "error", errorText: errorKind }];
       }
     }
@@ -6986,7 +7099,7 @@ async function runTurn(turnInput, emitRaw) {
     for (const chunk of heldText?.release() ?? []) emitShown(chunk);
     turnUsage.closeAttempt();
     const usage = messageUsage();
-    const error = status === "error" ? { kind: errorKind ?? "other" } : null;
+    const error = status === "error" ? { kind: errorKind ?? "other", ...errorDetails && { details: errorDetails } } : null;
     const answeredByBackup = answeredProviderId !== input.providerId && { providerId: answeredProviderId };
     let finished = false;
     if (!takeover.signal.aborted) {
@@ -9419,10 +9532,12 @@ var CHAT_CAPABILITIES = [
   "reasoning",
   "toolDetails",
   "steer",
-  "modelDetails"
+  "modelDetails",
+  "errorDetails"
 ];
+var OFF_BY_DEFAULT = /* @__PURE__ */ new Set(["errorDetails"]);
 function resolveChatCapabilities(given) {
-  const resolved = Object.fromEntries(CHAT_CAPABILITIES.map((capability) => [capability, true]));
+  const resolved = Object.fromEntries(CHAT_CAPABILITIES.map((capability) => [capability, !OFF_BY_DEFAULT.has(capability)]));
   if (given === void 0 || given === null) return resolved;
   if (typeof given !== "object") throw new TypeError("\u041F\u0440\u0430\u0432\u0430 \u0447\u0430\u0442\u0430 \u2014 \u043E\u0431\u044A\u0435\u043A\u0442 { \u043F\u0440\u0430\u0432\u043E: boolean }");
   const unknown = Object.keys(given).find((key) => !CHAT_CAPABILITIES.includes(key));
@@ -9433,7 +9548,10 @@ function resolveChatCapabilities(given) {
     if (typeof value !== "boolean") throw new TypeError(`\u041F\u0440\u0430\u0432\u043E \xAB${capability}\xBB \u2014 true \u0438\u043B\u0438 false`);
     resolved[capability] = value;
   }
-  if (!resolved.modelDetails) resolved.modelChoice = false;
+  if (!resolved.modelDetails) {
+    resolved.modelChoice = false;
+    resolved.errorDetails = false;
+  }
   return resolved;
 }
 var ActionForbiddenError = class extends Error {
@@ -11465,6 +11583,12 @@ var SHOWS_EVERYTHING = {
 };
 var MODEL_METADATA_KEYS = ["modelId", "providerId", "usage"];
 var MODEL_CHAT_KEYS = ["ownerId", "modelId", "providerId", "reasoning"];
+var withoutErrorDetails = (metadata) => {
+  const error = metadata.error;
+  if (typeof error !== "object" || error === null || !("details" in error)) return metadata;
+  const { details: _details, ...rest } = error;
+  return { ...metadata, error: rest };
+};
 var without = (carrier, keys) => {
   if (!keys.some((key) => key in carrier)) return carrier;
   const rest = { ...carrier };
@@ -11502,10 +11626,15 @@ function clientVisibilityOf(capabilities, sdkScreenTool) {
   const hidesReasoning = !capabilities.reasoning;
   const hidesTools = !capabilities.toolDetails;
   const hidesModel = capabilities.modelDetails === false;
-  if (!hidesReasoning && !hidesTools && !hidesModel) return SHOWS_EVERYTHING;
+  const hidesErrorDetails = hidesModel || capabilities.errorDetails !== true;
+  if (!hidesReasoning && !hidesTools && !hidesModel && !hidesErrorDetails) return SHOWS_EVERYTHING;
   const hidesCall = (toolName, call) => hidesTools && !sdkScreenTool(toolName) && !markedForScreen(call);
   const hiddenMetadataKeys = [...hidesReasoning ? ["reasoningDurationsMs"] : [], ...hidesModel ? MODEL_METADATA_KEYS : []];
-  const visibleMetadata = (metadata) => typeof metadata === "object" && metadata !== null ? without(metadata, hiddenMetadataKeys) : metadata;
+  const visibleMetadata = (metadata) => {
+    if (typeof metadata !== "object" || metadata === null) return metadata;
+    const shown = without(metadata, hiddenMetadataKeys);
+    return hidesErrorDetails ? withoutErrorDetails(shown) : shown;
+  };
   const withoutProviderData2 = (carrier) => hidesModel ? without(carrier, PROVIDER_METADATA_KEYS) : hidesReasoning ? withoutReasoningDetails(carrier) : carrier;
   return {
     showsEverything: false,
@@ -12216,10 +12345,18 @@ function createChatService(input) {
     scope.capabilities ??= askCapabilities(userId, chat);
     return scope.capabilities;
   }
+  let warnedErrorDetailsWithoutModel = 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.");
+  }
   async function askCapabilities(userId, chat) {
     if (!options2.chatCapabilities) return resolveChatCapabilities(void 0);
     try {
-      return resolveChatCapabilities(await options2.chatCapabilities({ userId, chat }));
+      const given = await options2.chatCapabilities({ userId, chat });
+      warnErrorDetailsWithoutModel(given);
+      return resolveChatCapabilities(given);
     } catch (error) {
       logError(`chatCapabilities \u0443\u043F\u0430\u043B \u0438\u043B\u0438 \u0432\u0435\u0440\u043D\u0443\u043B \u043D\u0435\u0432\u0435\u0440\u043D\u044B\u0435 \u043F\u0440\u0430\u0432\u0430 (\u0447\u0430\u0442 ${chat.id}): ${error instanceof Error ? error.message : String(error)}`);
       throw error;
@@ -14284,4 +14421,4 @@ export {
   InvalidWidgetAnswerError,
   createChatService
 };
-//# sourceMappingURL=chunk-4Y26SCCM.js.map
+//# sourceMappingURL=chunk-EWEEYX6U.js.map