@ykurilov/agent-chat-react 0.0.0-stage → 0.55.0

package/dist/types/helpers/helper-call.d.ts

@@ -0,0 +1,57 @@
+import type { DynamicToolUIPart, ToolUIPart } from "ai";
+import type { ApprovalDecision, ApprovalFailureKind } from "../chat-types.js";
+import type { HelperCallView } from "../skin-contract.js";
+/** Шаг помощника: вызов его инструмента или кусок текста. */
+export type HelperStep = {
+    type: "tool";
+    toolName: string;
+    input: unknown;
+    output?: unknown;
+    error?: string;
+} | {
+    type: "text";
+    text: string;
+};
+/** Ход помощника, как его пишет сервер в вывод вызова `helper_*` (в том числе промежуточный). */
+export interface HelperProgress {
+    task: string;
+    steps: HelperStep[];
+    text: string;
+    status: "running" | "awaiting_approval" | "done" | "failed" | "background";
+    pendingApproval?: {
+        approvalId: string;
+        toolName: string;
+        title?: string;
+        input: unknown;
+    };
+    taskId?: string;
+    error?: string;
+    /** Только на экране: решение человека по подтверждению помощника, пока сервер не прислал продолжение. */
+    decided?: "allowed" | "always" | "denied";
+}
+/** Приставка имени инструмента-помощника; часть протокола, слово не менять. */
+export declare const HELPER_TOOL_PREFIX = "helper_";
+type ToolPart = ToolUIPart | DynamicToolUIPart;
+export declare const isHelperToolName: (name: string) => boolean;
+export declare const isHelperPart: (part: ToolPart) => boolean;
+/** Ход помощника из вывода вызова; нет вывода или он чужой формы — `undefined`. */
+export declare function helperProgressOf(part: {
+    output?: unknown;
+}): HelperProgress | undefined;
+/** Id запроса подтверждения внутри помощника, который ждёт человека. */
+export declare function pendingHelperApprovalId(part: {
+    output?: unknown;
+}): string | undefined;
+export interface HelperCallControls {
+    onApproval: (approvalId: string, decision: ApprovalDecision) => void;
+    approvalPendingId: string | null;
+    approvalFailure: {
+        id: string;
+        kind: ApprovalFailureKind;
+        text?: string;
+    } | null;
+    failureText: (kind: ApprovalFailureKind) => string;
+}
+/** Что рисует `skin.HelperCallRow`, кроме раскрытия: имя без приставки, задание, шаги, итог, статус, подтверждение и его действие. */
+export declare function helperCallViewOf(part: ToolPart, controls: HelperCallControls): Omit<HelperCallView, "open" | "onOpenChange">;
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,53 @@
+export { AgentChat } from "./agent-chat.js";
+export { STEP_RESET_PART_TYPE, withoutResetSteps } from "./step-reset.js";
+export type { AttachmentsController, AttachmentsPlugin, ComposerAttachmentItem, ComposerAttachments, MessageAttachmentItem, MessageAttachmentsView, } from "./attachments-contract.js";
+export type { AgentChatProps } from "./agent-chat.js";
+export type { AgentChatExtensions, CustomWidgets, DiagramsClient, ImagesClient, VideosClient } from "./agent-chat-extensions.js";
+export type { MediaViewerItem } from "./media-viewer/media-viewer-types.js";
+export type { MessageAction, MessageActionContext, MessageActionTarget } from "./message-actions.js";
+export type { ComposerActions, ComposerHelper } from "./composer-actions.js";
+export type { TurnFinishedEvent } from "./turn-finished.js";
+export type { AppEvent, AppEventHandler, AppEventInfo, AppEventViews } from "./app-events.js";
+/** Блоки ```mermaid в тексте ответа: скин делит ими текст и нумерует схемы так же, как слой поведения. */
+export { splitMermaidBlocks } from "./diagrams/mermaid-blocks.js";
+export type { MarkdownSegment } from "./diagrams/mermaid-blocks.js";
+/** Блоки ```mermaid и ```html-demo вместе: скин со схемами и демонстрациями делит текст одним разбором. */
+export { LIVE_DEMO_LANGUAGE, splitAnswerFences } from "./live-demos/answer-fences.js";
+export type { AnswerFenceKinds, AnswerSegment } from "./live-demos/answer-fences.js";
+export { LIVE_DEMO_CSP, LIVE_DEMO_SANDBOX, MAX_LIVE_DEMO_BYTES } from "./live-demos/live-demo-document.js";
+export type { AgentChatMessage, AnswerStatus, ApprovalDecision, BranchFork, ChatErrorKind, ChatMessageMetadata, ErrorNoticeKind, ChatModelChoice, CompactionMarker, ReasoningLevelId, TokenUsage, VoiceCut, VoiceSound, } from "./chat-types.js";
+export { ChatLabelsProvider, englishLabels, englishWorkLabels, englishWorkViewLabels, russianLabels, useChatLabels, voiceErrorText } from "./labels.js";
+export { useThinkingStatus } from "./thinking-status/thinking-status.js";
+export type { ThinkingStatus } from "./thinking-status/thinking-status.js";
+export type { ChatLabels, DiagramLabels, HelperLabels, LiveDemoLabels, ImageLabels, MessengerStatusLabels, NoticeLabels, ResolvedChatLabels, TaskLabels, VideoLabels, ViewerLabels, VoiceDialogLabels, VoiceErrorLabels, VoiceSpeechLabels, WidgetLabels, WorkViewLabels, } from "./labels.js";
+export type { StepCall, StepPhrase, StepPhrases, StepPhraseText, WorkView } from "./work-view/step-phrases.js";
+export type { SpendingInfo, SpendingPeriod, SpendingRefusalReason, SpendingScope, SpendingView, SpendingWindowInfo } from "./spending-status.js";
+export type { AgentNoticeViewKind, AgentNoticeViewProps, AgentVideoView, ChatOriginView, ChatSkin, CustomWidgetProps, DiagramColors, DiagramView, FormFieldView, LiveDemoColors, LiveDemoView, GeneratedImagesView, HelperCallStatus, HelperCallView, HelperStepView, MediaViewerProps, MessageActionView, ModelChoiceView, StaffMessageView, TaskCardView, TaskStatusView, ToolApprovalView, ToolCallState, VoiceInputView, WidgetView, WorkStepsView, } from "./skin-contract.js";
+export type { AgentAppBridge, AppDataChange, BrowserCall, BrowserCallResult, ScreenPlace } from "./app-bridge/app-bridge.js";
+export { useAgentChat } from "./use-agent-chat.js";
+export type { AppRefusal, AppRefusalKind } from "./app-refusal.js";
+export type { ChatAccess, ChatCapabilities, ChatCapability, ChatClosure } from "./chat-access.js";
+export { useChatState } from "./chat-state/chat-state.js";
+export type { ChatStateValues } from "./chat-state/chat-state.js";
+export type { ServerRefusal } from "./server-refusal.js";
+export type { AgentChatState, ChatRefusal, ConnectionState, EditNotStartedReason, EditOutcome, EditRefusalReason, LivenessOptions, UseAgentChatOptions } from "./use-agent-chat.js";
+export { useModelChoice } from "./use-model-choice.js";
+export type { UseModelChoiceOptions } from "./use-model-choice.js";
+export type { DictatedText, VoiceErrorDetails, VoiceErrorKind, VoiceInput, VoiceListener, VoiceSession, VoiceStartContext } from "./voice-input.js";
+export { ChatWorkspace } from "./chat-list/chat-workspace.js";
+export type { ChatWorkspaceProps } from "./chat-list/chat-workspace.js";
+export type { ChatListDeleteRequestView, ChatListItemView, ChatListSkin } from "./chat-list/chat-list-skin.js";
+export { useChatList } from "./chat-list/use-chat-list.js";
+export type { ChatListActionError, ChatListState, ChatListStatus, UseChatListOptions } from "./chat-list/use-chat-list.js";
+export type { ChatListEntry } from "./chat-list/chat-list-client.js";
+export type { AnswerEnd, AssistantActivity, AssistantTextDelta, DialogChatBridge, VoiceDialogEngine, VoiceDialogError, VoiceDialogOpenOptions, VoiceDialogState, VoiceDialogView, VoiceDialogVoice, VoiceDialogVoices, } from "./voice-dialog.js";
+export { AgentMemory } from "./memory/agent-memory.js";
+export type { AgentMemoryProps } from "./memory/agent-memory.js";
+export { createMemoryApi, MemoryRequestError } from "./memory/memory-client.js";
+export type { MemoryConfirmTarget, MemoryMergeGroupView, MemoryNoteEditorErrors, MemorySkin } from "./memory/memory-skin.js";
+export type { MemoryActionResult, MemoryApi, MemoryCounts, MemoryFailure, MemoryMerge, MemoryMergeGroup, MemoryNote, MemoryNoteInput, MemoryStatus, } from "./memory/memory-types.js";
+export { useMemoryNotes } from "./memory/use-memory-notes.js";
+export type { MemoryNotesState } from "./memory/use-memory-notes.js";
+export { splitVoiceTags, stripVoiceTags } from "./voice-tags.js";
+export { voiceAnswerIds } from "./voice-turn.js";
+export type { SplitVoiceTags, VoiceTagMatch, VoiceTagOptions } from "./voice-tags.js";

package/dist/types/labels.d.ts

@@ -0,0 +1,468 @@
+import type { ReactNode } from "react";
+import type { ErrorNoticeKind, ReasoningLevelId } from "./chat-types.js";
+import type { MemoryFailure } from "./memory/memory-types.js";
+import type { ChatOriginView, HelperCallStatus, TaskStatusView } from "./skin-contract.js";
+import type { SpendingInfo } from "./spending-status.js";
+import type { VoiceDialogError, VoiceDialogState } from "./voice-dialog.js";
+import type { VoiceErrorDetails, VoiceErrorKind } from "./voice-input.js";
+/** Почему правка не ушла или не принята: идёт ответ, нет связи, сервер не принял. */
+export type EditErrorKind = "busy" | "offline" | "rejected" | "spendingLimit" | "signedOut" | "tooManyTurns" | "forbiddenOrigin";
+/** Надписи голосового режима (договор скина, версия 10). */
+export interface VoiceDialogLabels {
+    /** Кнопка включения режима. */
+    start: string;
+    /** Кнопка выхода из режима. */
+    exit: string;
+    /** Название меню голосов и подпись кнопки. */
+    voiceMenu: string;
+    /** Состояние режима словами. */
+    states: Record<VoiceDialogState, string>;
+    errors: Record<VoiceDialogError, string>;
+    /** Отметка у ответа, озвучку которого оборвали: «Вы перебили: озвучено до «…»». */
+    interruptedMark: (spokenTail: string) => string;
+}
+/** Надписи виджетов агента (договор скина, версия 13). */
+export interface WidgetLabels {
+    /** Пометка у виджета, на который человек ответил сообщением. */
+    answeredByMessage: string;
+    /** Кнопка отправки выбора, оценки и формы. */
+    submit: string;
+    /** Подсказка под вариантами: ответ можно написать словами. */
+    choose: string;
+    /** Подпись одной звезды или деления шкалы для экранного диктора: «Оценка 3 из 5». */
+    ratingStars: (value: number, total: number) => string;
+    /** Ответ не отправился. */
+    answerFailed: string;
+    /** Виджет из другой ветки: нажать его нельзя. */
+    notCurrentBranch: string;
+    /** Запасной вид, когда у скина нет виджета: ответить можно сообщением. */
+    fallback: string;
+    /** Пометка обязательного поля формы и ошибка пустого обязательного поля. */
+    formRequired: string;
+    /** Для экранного диктора, когда ход остановился на виджете. */
+    asked: string;
+    /** Для экранного диктора, когда ответ ушёл на сервер. */
+    answerSent: string;
+    /** Кнопка отправки формы. */
+    formSubmit: string;
+    /** Пределы выбора нескольких вариантов: «Выберите от 1 до 3». */
+    choiceRange: (min: number, max: number) => string;
+    /** Число или дата вне пределов; нет одного края — `undefined`. */
+    formOutOfRange: (min: string | undefined, max: string | undefined) => string;
+    /** В поле числа не число. */
+    formNotNumber: string;
+    /** В поле даты не дата. */
+    formNotDate: string;
+    /** Текст длиннее предела. */
+    formTooLong: (max: number) => string;
+    /** Сервер ответил, что вопрос уже не ждёт: на него ответили в другой вкладке или закрыли. */
+    alreadyAnswered: string;
+    /** Сервер не принял ответ (не прошёл проверку). */
+    answerRejected: string;
+    /** Проверка ответа на сервере не уложилась в срок: ответ не принят, виджет открыт. */
+    answerCheckTimeout: string;
+}
+/** Надписи схем (договор скина, версия 13). */
+export interface DiagramLabels {
+    loading: string;
+    failed: string;
+    /** Подпись кнопки «открыть схему во весь экран». */
+    open: string;
+}
+/** Надписи живых демонстраций (договор скина, версия 22). */
+export interface LiveDemoLabels {
+    /** Плашка, пока блок дописывается. */
+    loading: string;
+    /** Подпись рамки для диктора. */
+    title: string;
+    /** Пометка под кодом: демонстрация больше предела. */
+    tooLarge: string;
+    /** Пометка под кодом: ответ закончился, а блок не закрыт. */
+    unfinished: string;
+    /** Пометка под кодом: демонстрация попыталась уйти со своей страницы. */
+    leftPage: string;
+    /** Пометка под кодом: в чате есть чужой текст (интернет, файл), демонстрации в нём не запускаются. */
+    externalContent: string;
+}
+/** Надписи картинок агента и вложений-картинок (договор скина, версия 13). */
+export interface ImageLabels {
+    loading: string;
+    /** Подпись упавшей картинки; причину добавляет скин. */
+    failed: string;
+    /** Создание остановлено кнопкой «Стоп». */
+    stopped: string;
+    /** Подпись кнопки «открыть картинку в окне просмотра». */
+    open: string;
+}
+/** Надписи видео агента (договор скина, версия 14). */
+export interface VideoLabels {
+    /** Подпись кнопки-карточки, которая запускает плеер. */
+    play: string;
+    /** «с 3:20» — с какой минуты начнётся видео. */
+    from: (time: string) => string;
+    fullscreen: string;
+}
+/** Надписи помощников (договор скина, версия 18). */
+export interface HelperLabels {
+    /** Заголовок задания помощнику: «Поручено». */
+    assigned: string;
+    /** Заголовок итога помощника: «Вернул». */
+    returned: string;
+    status: Record<HelperCallStatus, string>;
+}
+/** Надписи фоновых задач (договор скина, версия 18). */
+export interface TaskLabels {
+    status: Record<TaskStatusView, string>;
+    cancel: string;
+    /** Пока отмена идёт. */
+    canceling: string;
+    /** «идёт 2 мин 5 сек» у идущей задачи, «заняла 2 мин 5 сек» у законченной. */
+    elapsed: (ms: number, finished: boolean) => string;
+}
+/** Надписи служебных сообщений (договор скина, версия 18). */
+export interface NoticeLabels {
+    taskDone: string;
+    taskFailed: string;
+    taskCanceled: string;
+    taskInterrupted: string;
+    taskTimedOut: string;
+    taskAwaitingApproval: string;
+    conversationStarted: string;
+    /** Подпись реплики живого сотрудника у скина без `StaffMessage` (версия 25): «Сотрудник Ольга». */
+    staffSaid: (staffName: string | undefined) => string;
+    /** Служебное сообщение одной строкой — у скина без `AgentNoticeView`: «Отчёт»: задача готова. Без названия — только `status`. */
+    line: (title: string, status: string) => string;
+}
+/** Строки статуса хода в мессенджерах: что делает агент, пока ответа ещё нет (договор скина, версия 18). */
+export interface MessengerStatusLabels {
+    thinking: string;
+    /** «Использую инструмент: поиск в памяти». */
+    usingTool: (title: string) => string;
+    /** «Помощник «Аналитик» работает». */
+    helperWorking: (name: string) => string;
+    /** «Задача «Отчёт» ушла в фон». */
+    taskInBackground: (title: string) => string;
+    waitingForApproval: string;
+}
+/** Надписи простого вида работы агента (`workView: "simple"`, договор скина, версия 23). */
+export interface WorkViewLabels {
+    /** Шаг идёт, а фразы для инструмента нет: «Работаю». Без многоточия: его добавляет `live`. */
+    stepRunning: string;
+    /** Шаг готов, а фразы нет: «Сделал шаг». */
+    stepDone: string;
+    /** Шаг не получился: «Делаю календарь — не вышло»; `running` — фраза «идёт» без многоточия. */
+    stepFailed: (running: string) => string;
+    /** Шаг без фразы не получился: «Шаг не получился». */
+    stepFailedUnknown: string;
+    /** Ответ закончился посреди шага («Стоп», обрыв): «Делаю календарь — не закончил». */
+    stepUnfinished: (running: string) => string;
+    /** То же без фразы: «Шаг не закончен». */
+    stepUnfinishedUnknown: string;
+    /** Одинаковые шаги подряд одной строкой: «Поискал в интернете ×5». */
+    stepRepeated: (phrase: string, count: number) => string;
+    /** Модель думает: «Думаю». */
+    thinking: string;
+    /** Живая строка: «Рисую календарь…». */
+    live: (phrase: string) => string;
+    /** Свёрнутые шаги: «Сделано 3 шага»; `count` — число вызовов, вместе с повторами. */
+    stepsDone: (count: number) => string;
+    /** Помощник работает и закончил, если приложение не дало фраз: «Помощник «Аналитик» работает». */
+    helperRunning: (name: string) => string;
+    helperDone: (name: string) => string;
+}
+/** Надписи окна просмотра (договор скина, версия 13). */
+export interface ViewerLabels {
+    close: string;
+    next: string;
+    previous: string;
+    /** Кнопка «вписать в экран» после масштабирования. */
+    fit: string;
+    /** Счётчик «3 из 12»; только при нескольких элементах. */
+    counter: (position: number, total: number) => string;
+}
+/** Надписи для голоса вне голосового режима (договор скина, версия 13). */
+export interface VoiceSpeechLabels {
+    /** Что слышно вместо блока схемы. */
+    diagramOnScreen: string;
+    /** Что слышно на месте карточки видео (версия 14). */
+    videoOnScreen: string;
+    /** Фраза к озвучке ждущего выбора: вопрос и варианты. */
+    widgetChoices: (question: string, options: readonly string[]) => string;
+    /** Фраза к озвучке ждущей формы, оценки или своего виджета; `title` — вопрос или заголовок, если есть. */
+    widgetOnScreen: (title?: string) => string;
+}
+/**
+ * Все надписи интерфейса чата. Скин берёт их отсюда и сам строк не пишет. Группы версии 13 (`widgets`, `diagram`, `images`,
+ * `viewer`, `voice`) и версии 14 (`videos`) необязательные: словарь приложения, написанный раньше, работает, недостающее берётся из `russianLabels`;
+ * внутри группы можно перекрыть любой один ключ.
+ */
+export interface ChatLabels {
+    /**
+     * Язык словаря (BCP 47): `ru` у `russianLabels`, `en` у `englishLabels`. Скин по нему выбирает свои надписи — например,
+     * Тандем ставит словарь дизайн-системы на том же языке. Нет — скин решает сам (Тандем: русский или словарь приложения).
+     */
+    locale?: string;
+    composerPlaceholder: string;
+    /** Подпись поля ввода для экранного диктора. */
+    composerLabel: string;
+    send: string;
+    stop: string;
+    copyAnswer: string;
+    copied: string;
+    copyCode: string;
+    reasoningRunning: string;
+    reasoningDone: (seconds: number) => string;
+    /**
+     * Фразы, которые сменяют друг друга каждые 3–4 с, пока модель думает и текста ответа ещё нет. Пустой набор — одна
+     * `reasoningRunning`. Нет — русские по умолчанию, а если `reasoningRunning` своя (словарь на другом языке) — она одна.
+     */
+    thinkingPhrases?: readonly string[];
+    /** Время ожидания ответа рядом с фразой: «12 с», «1 мин 5 с». Нет, а `reasoningRunning` своя — «0:12», «1:05». */
+    thinkingElapsed?: (seconds: number) => string;
+    toolRunning: (toolName: string) => string;
+    toolDone: (toolName: string) => string;
+    toolError: (toolName: string) => string;
+    /** Подпись картинки со снимком страницы для экранного диктора. */
+    screenshotAlt: string;
+    /** Снимок страницы не загрузился: вместо картинки этот текст и ссылка на страницу. */
+    screenshotUnavailable: string;
+    answerStopped: string;
+    answerInterrupted: string;
+    answerEmpty: string;
+    /** Подпись ссылки вместо картинки с чужого адреса, если у картинки нет своей подписи. Нет — русская по умолчанию. */
+    externalImageLink?: string;
+    /** Отметка у ответа, который модель не дописала: упёрлась в предел длины ответа. Нет — русская по умолчанию. */
+    answerCutByLength?: string;
+    /** Отметка у ответа агента, который исправил человек (версия 15). Нет — русская по умолчанию. */
+    answerEdited?: string;
+    /** Серая отметка у ответа, который не дошёл до человека (версия 24). Нет — русская по умолчанию. */
+    answerUndelivered?: string;
+    /** Отметка у вызова инструмента, чей результат исправил человек (версия 15). Нет — русская по умолчанию. */
+    toolOutputEdited?: string;
+    /** Кнопка «изменить» у ответа агента (версия 15). Нет — русская по умолчанию. */
+    editAnswer?: string;
+    /** Пометка у поправки, которую агент ещё не взял (версия 21): «учтёт на следующем шаге». Нет — русская по умолчанию. */
+    steeringPending?: string;
+    retry: string;
+    /** Идут попытки подключиться к серверу. */
+    reconnecting: string;
+    /** Попытки исчерпаны: сервер недоступен. */
+    connectionLost: string;
+    /** Чат чужой или его нет: сервер не различает эти случаи. */
+    chatNotFound: string;
+    errors: Record<ErrorNoticeKind, string>;
+    /** Названия уровней рассуждений в меню выбора; названия моделей и провайдеров приходят с сервера. */
+    reasoningLevels: Record<ReasoningLevelId, string>;
+    /** Разделитель на границе сжатой истории. */
+    historyCompacted: string;
+    /** Пояснение под разделителем, когда открыта сводка. */
+    historyCompactedHint: string;
+    /** Где сейчас переключатель веток, для экранного диктора: «Вариант 2 из 3». */
+    branchPosition: (position: number, count: number) => string;
+    previousBranch: string;
+    nextBranch: string;
+    /** Кнопка у последнего ответа: новый ответ на тот же вопрос. */
+    regenerate: string;
+    /** Кнопка у отправленного сообщения и подпись поля правки. */
+    editMessage: string;
+    /** Отправить исправленное сообщение. */
+    saveEdit: string;
+    cancelEdit: string;
+    /** Под полем правки, когда правку не удалось отправить; текст в поле остаётся. */
+    editErrors: Record<EditErrorKind, string>;
+    /** Под полем правки, когда сервер отказал по лимиту сообщений (у денег — `editErrors.spendingLimit`). */
+    editMessageLimit?: string;
+    /** Не удалось сохранить выбор модели. */
+    modelChoiceFailed: string;
+    /** Не удалось получить список моделей. */
+    modelMenuFailed: string;
+    /** Кнопка микрофона в покое. */
+    voiceStart: string;
+    /** Кнопка микрофона, пока идёт запись. */
+    voiceStop: string;
+    /** Кнопка микрофона, пока готовится запись: нажатие отменяет. */
+    voiceConnecting: string;
+    /** Кнопка микрофона, пока сервер причёсывает надиктованный текст (убирает «э-э», расставляет знаки). */
+    voicePolishing: string;
+    voiceErrors: VoiceErrorLabels;
+    voiceDialog: VoiceDialogLabels;
+    /** Заголовок карточки: что агент хочет сделать (`action` — название действия). */
+    approvalRequested: (action: string) => string;
+    /** Пока человек не решил. */
+    approvalWaiting: string;
+    approvalAllow: string;
+    approvalDeny: string;
+    approvalAlways: string;
+    /** Ответ не дошёл до сервера. */
+    approvalFailed: string;
+    /** Ответ не принят: лимит расходов исчерпан. */
+    approvalSpendingLimit: string;
+    /** Ответ не принят: в чате идёт другой ход. */
+    approvalBusy: string;
+    /** Ответ не принят: у человека уже идут ответы в других чатах. */
+    approvalTooManyTurns: string;
+    approvalAllowedMark: string;
+    approvalAlwaysMark: string;
+    approvalDeniedMark: string;
+    /** Для экранного диктора, когда ход остановился на запросе. */
+    approvalAnnouncement: string;
+    /** Расход подошёл к лимиту, но чат ещё работает: «Использовано 80% лимита на месяц». */
+    spendingWarning: (info: SpendingInfo) => string;
+    /** Лимит исчерпан, новые сообщения не отправляются: «Лимит на месяц исчерпан, обновится 1 ноября». */
+    spendingExhausted: (info: SpendingInfo) => string;
+    /** Окно сообщений подошло к лимиту (`unit: "messages"`): «Осталось 2 сообщения». */
+    spendingMessagesLeft?: (remaining: number, info: SpendingInfo) => string;
+    /** Окно сообщений исчерпано: «Лимит сообщений исчерпан, обновится 8 октября». */
+    spendingMessagesExhausted?: (info: SpendingInfo) => string;
+    /** Заголовок списка чатов и кнопка «Чаты» на узком экране. */
+    chatListHeading: string;
+    chatListNewChat: string;
+    /** Название чата, в котором ещё ничего не писали. */
+    chatListUntitled: string;
+    /** Пометка чата, начатого в мессенджере: «Telegram», «ВКонтакте», «MAX». */
+    chatListOrigin: Record<ChatOriginView, string>;
+    /** Пометка закрытого чата в списке (причину скин берёт из `closed.message`). */
+    chatListClosed: string;
+    chatListLoading: string;
+    chatListLoadFailed: string;
+    chatListCreateFailed: string;
+    chatListRenameFailed: string;
+    chatListDeleteFailed: string;
+    /** Кнопка меню строки: «Действия с чатом …». */
+    chatListRowMenu: (title: string) => string;
+    chatListRename: string;
+    chatListRenameField: string;
+    chatListDelete: string;
+    chatListDeleteTitle: string;
+    chatListDeleteBody: (title: string) => string;
+    chatListDeleteConfirm: string;
+    chatListDeleteCancel: string;
+    /** Экран памяти агента: заголовок и счётчик «Записей: 12 из 200». */
+    memoryHeading: string;
+    memoryCount: (total: number, limit: number) => string;
+    /** Подсказка, когда в запрос агента попадают не все записи: остальное он находит поиском. */
+    memoryShownHint: (shown: number, total: number) => string;
+    memoryAdd: string;
+    memoryClearAll: string;
+    memoryLoading: string;
+    memoryEmpty: string;
+    /** Сервер ответил 404: память в этом приложении не включена. */
+    memoryUnavailable: string;
+    memoryLoadFailed: string;
+    memoryEdit: string;
+    memoryDelete: string;
+    /** Подписи кнопок записи для экранного диктора: «Изменить запись «Любит чай»». */
+    memoryEditNote: (content: string) => string;
+    memoryDeleteNote: (content: string) => string;
+    /** Заголовок группы записей для экранного диктора: «Работа, записей: 3». */
+    memoryGroupLabel: (name: string, count: number) => string;
+    memoryNewNoteTitle: string;
+    memoryEditNoteTitle: string;
+    memoryPathField: string;
+    memoryPathHint: string;
+    memoryContentField: string;
+    memorySave: string;
+    memoryCancel: string;
+    /** Ошибки полей: проверка до отправки. */
+    memoryFieldErrors: {
+        pathRequired: string;
+        pathTooMany: string;
+        pathTooLong: string;
+        contentRequired: string;
+        contentTooLong: string;
+    };
+    /** Почему действие с памятью не удалось. */
+    memoryErrors: Record<MemoryFailure, string>;
+    memoryDeleteTitle: string;
+    memoryDeleteBody: (content: string) => string;
+    memoryClearTitle: string;
+    memoryClearBody: (total: number) => string;
+    memoryConfirmDelete: string;
+    memoryConfirmClear: string;
+    memoryConfirmCancel: string;
+    /** Блок «Объединено»: агент склеил повторы; «было» — скрытые оригиналы, «стало» — запись в списке. */
+    memoryMergesHeading: string;
+    /** Когда слияние сделано: «30 сентября в 12:05» (по местному времени). */
+    memoryMergeDate: (finishedAt: Date) => string;
+    memoryMergeBefore: string;
+    memoryMergeAfter: string;
+    memoryMergeRevert: string;
+    /** Имя кнопки для экранного диктора: у каждого слияния своя, «Вернуть как было (30 сентября в 12:05)». */
+    memoryMergeRevertFor: (when: string) => string;
+    /** Вместо кнопки, когда результат склейки с тех пор менялся. */
+    memoryMergeNotRevertible: string;
+    /** Когда «Вернуть как было» отклонено: памяти не хватит места или запись, что вернулась бы, уже добавлена заново. */
+    memoryRevertErrors: Record<"limit_reached" | "duplicate", string>;
+    /** Панель агента (договор скина версии 12): кнопка в углу страницы, подписи панели и списка чатов над чатом. */
+    agentPanelLauncher: string;
+    agentPanelOpen: string;
+    agentPanelClose: string;
+    agentPanelLabel: string;
+    agentPanelChats: string;
+    agentPanelBackToChat: string;
+    /** Значок на кнопке, пока идёт ответ. */
+    agentPanelBusy: string;
+    /** Ответ модели, когда браузерного инструмента нет на этой странице (функции нет у `AgentPanelProvider`). */
+    agentPanelToolUnavailable: string;
+    widgets?: Partial<WidgetLabels>;
+    diagram?: Partial<DiagramLabels>;
+    demo?: Partial<LiveDemoLabels>;
+    images?: Partial<ImageLabels>;
+    videos?: Partial<VideoLabels>;
+    viewer?: Partial<ViewerLabels>;
+    voice?: Partial<VoiceSpeechLabels>;
+    helpers?: Partial<HelperLabels>;
+    tasks?: Partial<TaskLabels>;
+    notices?: Partial<NoticeLabels>;
+    messengerStatus?: Partial<MessengerStatusLabels>;
+    workView?: Partial<WorkViewLabels>;
+}
+/** Словарь, в котором есть и необязательные надписи: их подставляет `ChatLabelsProvider`. */
+export type ResolvedChatLabels = Omit<ChatLabels, "widgets" | "diagram" | "demo" | "images" | "videos" | "viewer" | "voice" | "helpers" | "tasks" | "notices" | "messengerStatus" | "workView"> & Required<Pick<ChatLabels, "externalImageLink" | "answerCutByLength" | "answerEdited" | "answerUndelivered" | "toolOutputEdited" | "editAnswer" | "steeringPending" | "thinkingPhrases" | "thinkingElapsed" | "spendingMessagesLeft" | "spendingMessagesExhausted" | "editMessageLimit">> & {
+    widgets: WidgetLabels;
+    diagram: DiagramLabels;
+    demo: LiveDemoLabels;
+    images: ImageLabels;
+    videos: VideoLabels;
+    viewer: ViewerLabels;
+    voice: VoiceSpeechLabels;
+    helpers: HelperLabels;
+    tasks: TaskLabels;
+    notices: NoticeLabels;
+    messengerStatus: MessengerStatusLabels;
+    workView: WorkViewLabels;
+};
+/**
+ * Подписи ошибок голоса. `time_limit` — строка или функция от предела записи, названного сервером (секунды).
+ * `limit`, `forbidden`, `too_long` можно не задавать: возьмутся подписи по умолчанию на языке словаря (`locale`).
+ */
+export type VoiceErrorLabels = Record<Exclude<VoiceErrorKind, "time_limit" | "limit" | "forbidden" | "too_long">, string> & {
+    time_limit: string | ((maxSessionSeconds: number) => string);
+    limit?: string;
+    forbidden?: string;
+    too_long?: string;
+};
+/** Подпись ошибки голоса для человека. */
+export declare function voiceErrorText(errors: VoiceErrorLabels, kind: VoiceErrorKind, details?: VoiceErrorDetails): string;
+/** Английские надписи простого вида работы агента (версия 23); входят в `englishLabels`. */
+export declare const englishWorkViewLabels: WorkViewLabels;
+/** Английские надписи версий 18 и 21 для приложений, которые подключают их через `ChatLabels`. */
+export declare const englishWorkLabels: Pick<ResolvedChatLabels, "helpers" | "tasks" | "notices" | "messengerStatus" | "steeringPending">;
+export declare const russianLabels: ResolvedChatLabels;
+/** Полный английский словарь чата: `<ChatLabelsProvider labels={englishLabels}>`. Свои поправки — поверх него. */
+export declare const englishLabels: ResolvedChatLabels;
+/**
+ * Тексты закрытых «Стопом» вызовов: те же, что записывает сервер (core: `HANGING_TOOL_CALL_REASON`, `INTERRUPTED_REASON`,
+ * `RESULT_UNKNOWN_REASON`).
+ * Не надписи для человека, а часть ответа; лежат здесь, потому что надписи в коде вне словаря запрещены.
+ */
+export declare const stoppedToolCallReasons: {
+    readonly hanging: "Вызов инструмента оборвался до результата: действие могло выполниться частично или целиком. Не повторяй его, не проверив, что уже сделано";
+    readonly interrupted: "Ход прерван раньше, чем пользователь ответил на запрос. Действие не выполнялось.";
+    readonly resultUnknown: "Пользователь разрешил действие, но ход прервался до результата. Неизвестно, выполнено оно или нет; не повторяй его, не проверив.";
+};
+export declare function ChatLabelsProvider({ labels, children }: {
+    labels: ChatLabels;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useChatLabels(): ResolvedChatLabels;

package/dist/types/live-demos/answer-fences.d.ts

@@ -0,0 +1,25 @@
+/** Кусок текста ответа: обычная разметка, схема ```mermaid или живая демонстрация ```html-demo. */
+export type AnswerSegment = {
+    kind: "markdown";
+    markdown: string;
+}
+/** `source` — текст блока без ограждений; `closed` — блок закрыт; `markdown` — блок целиком, как в тексте. */
+ | {
+    kind: "mermaid" | "demo";
+    source: string;
+    closed: boolean;
+    markdown: string;
+};
+/** Какие блоки выделять: схемы (`diagrams`) и живые демонстрации (`demos`). Остальные остаются разметкой. */
+export interface AnswerFenceKinds {
+    diagrams?: boolean;
+    demos?: boolean;
+}
+/** Язык блока живой демонстрации. */
+export declare const LIVE_DEMO_LANGUAGE = "html-demo";
+/**
+ * Делит Markdown на обычные куски и блоки ```mermaid и ```html-demo верхнего уровня (по правилам ограждений CommonMark):
+ * блок внутри другого блока кода и блок с отступом в четыре пробела — обычный код. Номер блока — его порядок среди
+ * кусков того же вида; им скин зовёт `renderDiagram`/`renderDemo`, и слой поведения считает так же.
+ */
+export declare function splitAnswerFences(markdown: string, kinds: AnswerFenceKinds): AnswerSegment[];