@ykurilov/agent-chat-core 0.63.1 → 0.64.0

package/dist/types/access/chat-capabilities.d.ts

@@ -7,18 +7,22 @@ import type { Chat } from "../conversation/types.js";
  * `metadata: { showOnScreen: true }` и вызовы с запросом подтверждения видны всегда. Запрет `reasoning` и `toolDetails` прячет их из истории и потока, модель и
  * хранилище получают всё. `steer` — поправка к идущему ответу (`POST …/steer`). `modelDetails` — модель, провайдер,
  * уровень рассуждений, расход токенов, метаданные поставщика, владелец чата и текст сводок сжатия в истории и потоке;
- * запрет выключает и `modelChoice`: выбирать невидимую модель нельзя.
+ * запрет выключает и `modelChoice`: выбирать невидимую модель нельзя. `errorDetails` — подробности сбоя провайдера
+ * (провайдер, модель, код, причина, когда снимут предел) в истории и потоке; единственное право, выключенное по
+ * умолчанию: подробности видны любому через инструменты разработчика, открывать их — только админу. При
+ * `modelDetails: false` выключено и оно.
  */
-export type ChatCapability = "edit" | "regenerate" | "retry" | "branches" | "modelChoice" | "answerEditing" | "chatList" | "compact" | "attachments" | "voice" | "reasoning" | "toolDetails" | "steer" | "modelDetails";
+export type ChatCapability = "edit" | "regenerate" | "retry" | "branches" | "modelChoice" | "answerEditing" | "chatList" | "compact" | "attachments" | "voice" | "reasoning" | "toolDetails" | "steer" | "modelDetails" | "errorDetails";
 /**
- * Права, как их отдаёт `resolveChatCapabilities`. `modelDetails` в типе необязательно (нет — `true`): свой литерал прав,
- * собранный до этого права, остаётся верным. Ядро и история заполняют его всегда.
+ * Права, как их отдаёт `resolveChatCapabilities`. `modelDetails` (нет — `true`) и `errorDetails` (нет — `false`) в типе
+ * необязательны: свой литерал прав, собранный до этих прав, остаётся верным. Ядро и история заполняют их всегда.
  */
-export type ChatCapabilities = Record<Exclude<ChatCapability, "modelDetails">, boolean> & {
+export type ChatCapabilities = Record<Exclude<ChatCapability, "modelDetails" | "errorDetails">, boolean> & {
     modelDetails?: boolean;
+    errorDetails?: boolean;
 };
 /**
- * Права в чате от приложения: частичный список, пропущенное — `true`. Тот же вход, что у `beforeTurn` (чат с данными
+ * Права в чате от приложения: частичный список, пропущенное — `true` (`errorDetails` — `false`). Тот же вход, что у `beforeTurn` (чат с данными
  * объекта). Не булево значение, неизвестное право или исключение — ошибка приложения.
  */
 export type ChatCapabilitiesHandler = (input: {
@@ -27,8 +31,8 @@ export type ChatCapabilitiesHandler = (input: {
 }) => Partial<ChatCapabilities> | void | Promise<Partial<ChatCapabilities> | void>;
 export declare const CHAT_CAPABILITIES: readonly ChatCapability[];
 /**
- * Все права разрешены и дополнены ответом приложения; `modelDetails: false` выключает и `modelChoice`. Не булево значение
- * или неизвестное право — `TypeError`.
+ * Все права, кроме `errorDetails`, разрешены и дополнены ответом приложения; `modelDetails: false` выключает и
+ * `modelChoice`, и `errorDetails`. Не булево значение или неизвестное право — `TypeError`.
  */
 export declare function resolveChatCapabilities(given: Partial<ChatCapabilities> | void | null): Required<ChatCapabilities>;
 /** Действие запрещено правами чата: сервер отвечает 403 `action_forbidden`. */

package/dist/types/access/client-visibility.d.ts

@@ -1,7 +1,7 @@
 import type { UIMessageChunk } from "ai";
 import type { ChatCapabilities } from "./chat-capabilities.js";
 /**
- * Что из ответа видит браузер по правам `reasoning`, `toolDetails` и `modelDetails`. Хранилище, модель и хуки получают
+ * Что из ответа видит браузер по правам `reasoning`, `toolDetails`, `modelDetails` и `errorDetails`. Хранилище, модель и хуки получают
  * ответ целиком: видимость — только на выходе к клиенту (история, поток, повтор кусков после переподключения).
  */
 export interface ClientVisibility {
@@ -38,4 +38,4 @@ export declare const SHOW_ON_SCREEN_KEY = "showOnScreen";
  * Видимость для прав зрителя. При `toolDetails: false` видны вызовы с пометкой `showOnScreen`, инструменты SDK, которым
  * нужен экран (`sdkScreenTool`: виджеты, браузерные), и вызовы, спросившие подтверждения.
  */
-export declare function clientVisibilityOf(capabilities: Pick<ChatCapabilities, "reasoning" | "toolDetails" | "modelDetails">, sdkScreenTool: (toolName: string) => boolean): ClientVisibility;
+export declare function clientVisibilityOf(capabilities: Pick<ChatCapabilities, "reasoning" | "toolDetails" | "modelDetails" | "errorDetails">, sdkScreenTool: (toolName: string) => boolean): ClientVisibility;

package/dist/types/agent-run/run-agent-turn.d.ts

@@ -1,7 +1,7 @@
 import type { ToolSet, UIMessageChunk } from "ai";
 import type { MessageAttachments } from "../attachments/message-attachments.js";
 import type { AgentAudience, AgentChannel, ChatSubject, GroupTurn, UsageSource } from "../conversation/types.js";
-import type { AgentChatMessage, ChatErrorKind, FinalAnswerStatus, TokenUsage } from "../conversation/types.js";
+import type { AgentChatMessage, ChatError, FinalAnswerStatus, TokenUsage } from "../conversation/types.js";
 import type { AgentHelper } from "../helpers/helper-types.js";
 import type { DataChange, ScreenPlace } from "../page-context/page-context.js";
 import type { ModelCatalog, ModelProfile } from "../models/model-catalog.js";
@@ -261,9 +261,7 @@ export interface AgentTurnInput {
         status: FinalAnswerStatus;
         parts: AgentChatMessage["parts"];
         usage: TokenUsage | null;
-        error: {
-            kind: ChatErrorKind;
-        } | null;
+        error: ChatError | null;
         providerId: string;
     }, stopWaiting: AbortSignal) => Promise<AppEvent[]>;
     /** Итог ответа записан в хранилище, до расхода и `afterTurn`: для срока хода, который не должен обрывать хук. */

package/dist/types/conversation/types.d.ts

@@ -6,6 +6,23 @@ export declare const CURRENT_FORMAT_VERSION = 1;
 export type AnswerStatus = "streaming" | "complete" | "stopped" | "error" | "interrupted" | "awaiting_approval";
 export type FinalAnswerStatus = Exclude<AnswerStatus, "streaming">;
 export type ChatErrorKind = "overloaded" | "rate_limited" | "insufficient_funds" | "invalid_key" | "context_overflow" | "other";
+/**
+ * Подробности сбоя провайдера для того, кому приложение их открыло (право `errorDetails`): кто не ответил и почему.
+ * `reason` — одна строка до 300 знаков из сообщения провайдера, секреты и параметры адресов вычищены. `resetsAt` — когда
+ * провайдер обещал снять предел (ISO), если сообщил.
+ */
+export interface ChatErrorDetails {
+    providerId: string;
+    modelId: string;
+    statusCode?: number;
+    reason?: string;
+    resetsAt?: string;
+}
+/** Сбой ответа: вид для подписи и, если есть, подробности (хранятся всегда, в браузер — по праву `errorDetails`). */
+export interface ChatError {
+    kind: ChatErrorKind;
+    details?: ChatErrorDetails;
+}
 export interface TokenUsage {
     inputTokens: number;
     cachedInputTokens: number;
@@ -97,9 +114,7 @@ export interface ChatMessageMetadata {
     usage?: TokenUsage;
     reasoningDurationsMs?: Record<string, number>;
     status?: AnswerStatus;
-    error?: {
-        kind: ChatErrorKind;
-    };
+    error?: ChatError;
     /** Есть, если озвучку ответа оборвало перебивание. */
     voiceCut?: VoiceCut;
     /** Ответ не дошёл до человека (`markUndelivered`): модель его не видит, экран подписывает «не доставлено». */
@@ -118,9 +133,7 @@ export interface StoredMessage {
     providerId: string | null;
     usage: TokenUsage | null;
     reasoningDurationsMs: Record<string, number>;
-    error: {
-        kind: ChatErrorKind;
-    } | null;
+    error: ChatError | null;
     /**
      * Отметка обрыва озвучки. Необязательное поле: старые данные и хранилища без голосового режима его не знают;
      * встроенные хранилища читают отсутствие как `null`.

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 export { BUILT_IN_USAGE_SOURCES, CURRENT_FORMAT_VERSION } from "./conversation/types.js";
-export type { AfterTurnState, AgentAudience, AgentChannel, AgentChatMessage, AnswerAliveMark, AnswerStatus, Chat, ChatErrorKind, ChatMessageMetadata, ChatSubject, ExternalChannel, FinalAnswerStatus, GroupTurn, PendingStepUsage, StoredBranchSelection, StoredCompaction, StoredMessage, TokenUsage, UsageByChatFilter, UsageChatSum, UsageFilter, UsageRecord, UsageSource, BuiltInUsageSource, UsageSum, VoiceCut, } from "./conversation/types.js";
+export type { AfterTurnState, AgentAudience, AgentChannel, AgentChatMessage, AnswerAliveMark, AnswerStatus, Chat, ChatError, ChatErrorDetails, ChatErrorKind, ChatMessageMetadata, ChatSubject, ExternalChannel, FinalAnswerStatus, GroupTurn, PendingStepUsage, StoredBranchSelection, StoredCompaction, StoredMessage, TokenUsage, UsageByChatFilter, UsageChatSum, UsageFilter, UsageRecord, UsageSource, BuiltInUsageSource, UsageSum, VoiceCut, } from "./conversation/types.js";
 export type { AgentHelper, HelperPendingApproval, HelperProgress, HelperStep, HelperStepReport, RunHelper, RunHelperInput, RunHelperResult, } from "./helpers/helper-types.js";
 export { runHelper } from "./helpers/run-helper.js";
 export { AGENT_NOTICE_PART_TYPE } from "./notices/agent-notice.js";

package/dist/types/provider-errors/classify-provider-error.d.ts

@@ -11,3 +11,5 @@ export declare function classifyProviderError(error: unknown, provider?: Pick<Pr
  * ответить. Модерация — не такой отказ: дело в содержимом, и другому провайдеру оно не передаётся.
  */
 export declare function isAccessRefusal(error: unknown): boolean;
+/** Отказ — исчерпанный предел расходов ключа, а не пустой счёт: для громкой строки владельцу. */
+export declare function isKeyLimit(error: unknown): boolean;

package/dist/types/provider-errors/provider-error-details.d.ts

@@ -0,0 +1,18 @@
+import type { ChatErrorDetails } from "../conversation/types.js";
+import type { ModelCatalog } from "../models/model-catalog.js";
+export interface ProviderErrorDetailsContext {
+    providerId: string;
+    modelId: string;
+    /** Окружение сервера: значения ключей провайдеров вычищаются из причины. */
+    env: Record<string, string | undefined>;
+    catalog: ModelCatalog;
+    /** Часы хода, мс: «через N секунд» и проверка, что дата обнуления в будущем. По умолчанию — сейчас. */
+    now?: () => number;
+}
+/**
+ * Подробности сбоя для админа: провайдер, модель, код, причина одной строкой (сообщение провайдера из тела ответа, без
+ * секретов и параметров адресов) и когда провайдер снимет предел — из метаданных (`limit_reset`, `resets_at`) или
+ * текста сообщения о пределе («Key limit exceeded … resets 2026-11-01»). Дата принимается только в будущем и не дальше
+ * двух лет; время без пояса — UTC.
+ */
+export declare function providerErrorDetails(error: unknown, context: ProviderErrorDetailsContext): ChatErrorDetails;

package/dist/types/provider-errors/provider-outages.d.ts

@@ -17,13 +17,15 @@ export interface ProviderOutages {
     /**
      * Провайдер отказал: пауза на `PROVIDER_OUTAGE_PAUSE_MS` и, не чаще раза в `PROVIDER_OUTAGE_ALERT_EVERY_MS`, строка
      * `[ВНИМАНИЕ провайдер]` в журнал. `fallbackProviderId` — кто отвечает вместо; нет — ходы падают, а
-     * `fallbacksPaused` говорит, что запасные есть, но тоже на паузе.
+     * `fallbacksPaused` говорит, что запасные есть, но тоже на паузе. `keyLimit` — деньги не на счёте кончились, а
+     * исчерпан предел расходов ключа: строка говорит об этом.
      */
     report(input: {
         providerId: string;
         kind: ProviderOutageKind;
         fallbackProviderId?: string;
         fallbacksPaused?: boolean;
+        keyLimit?: boolean;
     }): void;
     /** Вид отказа, пока провайдер на паузе или его пробует другой ход; иначе `undefined`. Ничего не меняет. */
     pausedKind(providerId: string): ProviderOutageKind | undefined;

package/dist/types/text/scrub-secrets.d.ts

@@ -4,7 +4,9 @@ export declare const MIN_SECRET_LENGTH = 8;
 /**
  * Вычищает секреты из текста, который уходит человеку, в базу, в журнал или модели: известные значения
  * (`knownSecrets`, например ключи провайдеров из окружения), пароль в адресе `схема://логин:пароль@`,
- * заголовок `Authorization`, `?key=…`, поля вроде `password=…`, `password: …` и `"token": "…"`, узнаваемые ключи сервисов.
+ * заголовок `Authorization`, `Bearer …` в любом регистре, `key=…`, поля вроде `password=…`, `password: …` и `"token": "…"`,
+ * слово ключа через пробел перед похожим на секрет значением (`token abc123def456`), узнаваемые ключи сервисов и их
+ * маски со звёздочками.
  */
 export declare function scrubSecrets(text: string, knownSecrets?: Iterable<string | undefined>): string;
 /**

package/dist/types/turn-hooks/turn-hooks.d.ts

@@ -1,4 +1,4 @@
-import type { AgentChannel, Chat, ChatErrorKind, ChatSubject, FinalAnswerStatus, StoredMessage, TokenUsage } from "../conversation/types.js";
+import type { AgentChannel, Chat, ChatError, ChatSubject, FinalAnswerStatus, StoredMessage, TokenUsage } from "../conversation/types.js";
 /** Что человек делает с чатом, когда приложение решает, пускать ли ход. */
 export type TurnAction = "send" | "edit" | "retry" | "regenerate" | "approval" | "widget" | "notice";
 /** Отказ приложения в ходе: код для программы, текст для человека. */
@@ -130,9 +130,8 @@ export interface TurnResult {
     usage: TokenUsage | null;
     /** Цена хода в долларах; `null` — у модели нет цены. */
     costUsd: number | null;
-    error?: {
-        kind: ChatErrorKind;
-    };
+    /** Вид сбоя и подробности провайдера (`details`): хук на сервере получает их всегда. */
+    error?: ChatError;
     /**
      * Каким действием начат ход (см. `TurnAction`). `null` — итог доделан после перезапуска (`recovered`), а ядро не
      * помнит действие; ход по служебному сообщению и тогда — `notice`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ykurilov/agent-chat-core",
-  "version": "0.63.1",
+  "version": "0.64.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,

package/dist/chunk-FOAIG4DY.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/turn-hooks/turn-hooks.ts"],"sourcesContent":["import type { AgentChannel, Chat, ChatErrorKind, 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  error?: { kind: ChatErrorKind };\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":";AA8KO,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":[]}