@ykurilov/agent-chat-core 0.56.0 → 0.58.0

package/dist/types/agent-run/garbled-tail.d.ts

@@ -0,0 +1,69 @@
+import type { LanguageModel } from "ai";
+import type { AgentChatMessage } from "../conversation/types.js";
+type MessagePart = AgentChatMessage["parts"][number];
+/**
+ * Признаки срыва ответа в кашу — модель потеряла границу своего хода и пишет дальше за обоих. Правило общее для всех
+ * моделей и смотрит каждый шаг ответа отдельно. Нужен опорный признак — он же место среза: `role` — строка с ролью сразу
+ * после законченного ответа (с начала строки, после конца предложения, без двоеточия). Пара `</think>` в шаге перед такой
+ * строкой переносит место среза на первый `</think>`. Второй признак зависит от строки с ролью:
+ * - `userНу…` (роль слиплась с репликой): `think` — служебная метка в шаге (`</think>`, `<|im_end|>`, `<｜…｜>`);
+ *   `restart` — после неё ещё одна строка с ролью или склейка русских предложений «месяц.Считать»; `tool` — вызов
+ *   инструмента в том же шаге после неё;
+ * - `user` одной строкой: `think` — служебная метка в шаге; `restart` — ещё одна строка с ролью после неё;
+ * - метка шаблона (`<|im_start|>user`, `<｜User｜>`): `think` — метка конца своего хода перед ней (`<|im_end|>`);
+ *   `restart` — ещё одна строка с ролью или склейка после неё.
+ * Код (блоки ```, отступ в 4 пробела, `…`, ``…``) и цитаты (`> …`) не смотрятся. Роли за обоих (`user` и `assistant`
+ * строками или метками шаблона) — запись диалога или шаблона по просьбе, а не срыв. Метка в начале шага (DeepSeek
+ * ставит `</think>` перед текстом шага) — не след срыва.
+ */
+export type GarbleSign = "think" | "role" | "restart" | "tool";
+/** Место срыва: часть с текстом, знак в ней, с которого начинается хвост, и найденные признаки. */
+export interface GarbledTail {
+    partIndex: number;
+    offset: number;
+    signs: GarbleSign[];
+}
+/** Ищет срыв в частях ответа. `null` — срыва нет. */
+export declare function findGarbledTail(parts: readonly MessagePart[]): GarbledTail | null;
+/** Ответ без хвоста срыва и что отрезано. */
+export interface GarbledTailCut {
+    parts: MessagePart[];
+    signs: GarbleSign[];
+    /** Сколько знаков текста и рассуждений отрезано. */
+    removedChars: number;
+    /** Последний оставшийся текст до места срыва: индекс один и тот же в исходных частях и в обрезанных; -1 — нет. */
+    textIndex: number;
+}
+/**
+ * Ответ без хвоста срыва: в шаге срыва — текст до места срыва, вызовы инструментов и служебные данные (`data-*`);
+ * текст и рассуждения после места срыва в этом шаге отброшены. Следующие шаги — как были: вызовы и запросы
+ * подтверждения не пропадают. Обрыв по длине в последнем шаге снят — ответ законченный. `null` — срыва нет или без
+ * хвоста в ответе не осталось бы текста.
+ */
+export declare function cutGarbledTail(parts: readonly MessagePart[]): GarbledTailCut | null;
+/**
+ * История для модели без хвостов срыва в ответах ассистента. Только в запросе: запись не меняется. Из той же истории —
+ * те же байты (кэш модели). Нечего резать — тот же массив, сообщения без срыва — те же объекты.
+ */
+export declare function withoutGarbledTails(history: readonly AgentChatMessage[]): readonly AgentChatMessage[];
+/**
+ * Срыв, пока идёт поток ответа модели (каждый шаг попытки). Решение — по тому же правилу, что при сохранении, и только
+ * на целых строках: незаконченная строка ждёт конца строки или конца текста. Сработало — текст и рассуждения дальше не
+ * идут (ни на экран, ни в запись), вызовы инструментов после этого отброшены до запуска, шаг кончается без вызовов —
+ * нового шага нет. Отброшенный вызов при сохранении учитывается через `forCut`: запись и поток решают одинаково.
+ */
+export declare function createGarbledTailGuard(): {
+    /** Новая попытка: шаги прежней стёрты — всё сначала. */
+    reset(): void;
+    /** Модель попытки под присмотром: каждый запрос — новый шаг. */
+    wrap(model: LanguageModel): LanguageModel;
+    /** Срыв уже замечен в этой попытке: нового шага не нужно. */
+    garbled: () => boolean;
+    /** Сколько вызовов отброшено до запуска. */
+    droppedCalls: () => number;
+    /** Части ответа для правила при сохранении: отброшенный вызов — на своём месте, в конце. */
+    forCut: (saved: readonly MessagePart[]) => readonly MessagePart[];
+    /** Заглушка отброшенного вызова из `forCut`: в запись не идёт. */
+    isDroppedCall: (part: MessagePart) => boolean;
+};
+export {};

package/dist/types/agent-run/next-attempt.d.ts

@@ -1,4 +1,6 @@
 import type { ModelCatalog } from "../models/model-catalog.js";
+import type { ProviderOutageKind } from "../provider-errors/provider-outages.js";
+import type { ChatErrorKind } from "../conversation/types.js";
 import type { AttemptResult } from "./turn-attempt.js";
 /**
  * Запасные провайдеры той же модели (FR-030): `false` — выключены; `byModel` — свой порядок для модели или `false` для
@@ -68,7 +70,10 @@ export declare function fallbackProviders(input: {
     setting?: ProviderFallbackSetting;
 }): string[];
 /**
- * Переход к запасному — только при перегрузке или лимите, до первого куска ответа и один раз на ход (FR-031, FR-032).
+ * Кончились деньги или не принят ключ — провайдер не ответит ни на какой запрос: сразу следующий из списка, в любом
+ * месте хода и сколько угодно раз (список только убывает). Такой переход не тратит единственный переход по перегрузке.
+ * Переход к запасному при перегрузке, лимите или отказе по доступу (403: регион, модель) — до первого куска ответа и
+ * один раз на ход (FR-031, FR-032).
  * Переполнение — сжатие: сначала истории чата, затем первых шагов ответа, каждое не больше раза на ход (FR-012).
  * После первого куска та же перегрузка или лимит — автопродолжение у того же провайдера, до двух на ход и не при
  * запросе подтверждения (FR-037, FR-042, FR-044). Запасной после первого куска не выбирается никогда.
@@ -102,5 +107,11 @@ export declare function decideNextAttempt(result: Extract<AttemptResult, {
         nextProviderId?: string | undefined;
     };
 }): NextAttempt;
+/**
+ * Вид ошибки для человека, когда не ответил никто. Был отказ по деньгам или ключу (`firstOutage` — первый в ходе), а
+ * последний провайдер лишь занят или запрос велик — его вид: «попробуйте позже» или «короче» поможет. Иначе — исходная
+ * причина у основного: её и чинить владельцу.
+ */
+export declare function errorKindForPerson(lastKind: ChatErrorKind, firstOutage: ProviderOutageKind | undefined): ChatErrorKind;
 /** Проверка настройки при создании службы: неверная форма, неизвестная модель или чужой провайдер — `TypeError`. */
 export declare function checkProviderFallback(setting: ProviderFallbackSetting | undefined, catalog: ModelCatalog): void;

package/dist/types/agent-run/reply-checks.d.ts

@@ -86,7 +86,9 @@ export declare function withTextAt(parts: readonly MessagePart[], index: number,
 export declare function createShownSteps(): {
     observe(chunk: UIMessageChunk): void;
     /** Сколько шагов стереть с конца, чтобы убрать шаг последнего текста; `null` — текста на экране нет. */
-    resetsToLastText(): number | null;
+    resetsToLastText: () => number | null;
+    /** То же для текста `fromEnd`-го с конца (0 — последний); `null` — такого текста на экране нет. */
+    resetsToText: (fromEnd: number) => number | null;
 };
 /**
  * Куски, которыми экран заменяет показанное исправленным (`web: "replace"`): сброс `resets` шагов с конца и шаги от

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

@@ -5,6 +5,7 @@ import type { AgentChatMessage, ChatErrorKind, FinalAnswerStatus, TokenUsage } f
 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";
+import type { ProviderOutages } from "../provider-errors/provider-outages.js";
 import type { LongTermMemory } from "../memory/long-term-memory.js";
 import type { ModelSilenceLimits } from "../provider-errors/model-silence.js";
 import type { ChatStorage } from "../storage/chat-storage.js";
@@ -279,6 +280,11 @@ export interface AgentTurnInput {
     toolResultLimit?: ResolvedToolResultLimit;
     /** Запасные провайдеры той же модели, уже проверенные. Нет — значение по умолчанию из `next-attempt`. */
     providerFallback?: ProviderFallbackSetting;
+    /**
+     * Память службы об отказах провайдеров по деньгам и ключу: основной на паузе — ход сразу у запасного. Нет — своя на
+     * ход: громкая строка в журнал есть, паузы между ходами нет.
+     */
+    providerOutages?: ProviderOutages;
     /** Сроки ответа серверных инструментов по имени, уже проверенные. Нет — 120 с всем. */
     toolTimeout?: ResolvedToolTimeout;
     /** Серверные инструменты, которые идут по одному (FR-049), уже проверенные. Нет — все вместе. */

package/dist/types/agent-run/staff-replies.d.ts

@@ -0,0 +1,7 @@
+import type { AgentChatMessage } from "../conversation/types.js";
+/**
+ * Реплика сотрудника — не вопрос к агенту и не его ход: в запросе она идёт в одном сообщении с соседними словами человека
+ * (до неё и после неё), через пустую строку. Иначе два сообщения человека подряд получили бы между собой пометку
+ * «ход оборвался» (`withUnansweredMarked`), хотя хода не было. Склейка зависит только от истории: на каждом ходе те же байты.
+ */
+export declare function withStaffRepliesJoined(history: readonly AgentChatMessage[]): readonly AgentChatMessage[];

package/dist/types/bursts/message-bursts.d.ts

@@ -16,6 +16,16 @@ export declare const MAX_BURST_QUIET_MS = 600000;
 export declare const BURST_PENDING_GRACE_MS = 120000;
 /** Чат занят другой копией сервера (её ход или аренда): через столько пачка пробует снова. */
 export declare const BURST_BUSY_RETRY_MS = 1000;
+/**
+ * Запись ждущей пачки в хранилище (`savePendingBurst`) удерживается копией, что ждёт окно, ещё столько после конца окна;
+ * пока копия ждёт или решает, она продлевает удержание каждые `BURST_HOLD_RENEW_MS`. Срок вышел — пачку считают
+ * брошенной (копия упала): её берёт обход другой копии или следующего запуска.
+ */
+export declare const BURST_HOLD_MS = 30000;
+/** Как часто живая копия продлевает удержание своей ждущей пачки. */
+export declare const BURST_HOLD_RENEW_MS = 10000;
+/** Сколько брошенных пачек одна копия решает одновременно: обход берёт их порциями, пока не кончатся. */
+export declare const BURST_SWEEP_LIMIT = 10;
 /** `at` — время записи сообщения, мс: по нему решается, одна ли пачка у соседей (`continuesBurst`). */
 export declare function burstPart(quietMs: number, at: number): AgentChatMessage["parts"][number];
 export declare function isBurstMessage(message: Pick<AgentChatMessage, "role" | "parts">): boolean;
@@ -74,6 +84,8 @@ export interface BurstWaits {
     wait(chatId: string, ms: number, cancelled: () => Error): Promise<void>;
     /** Кончает ожидания чата сейчас: их пачки решают заново (например, после «Стоп»). */
     wake(chatId: string): void;
+    /** Кончает все ожидания сейчас: пачки решают заново по часам службы (`tickBursts`). */
+    wakeAll(): void;
     /** Ждёт ли в чате хоть одно окно или решение по пачке (`holding`). */
     has(chatId: string): boolean;
     /** Решение по пачке идёт: чат считается ждущим, пока `work` не кончится. */

package/dist/types/chat-events/chat-events.d.ts

@@ -18,6 +18,11 @@ export type ChatEvent = {
      * мессенджер его не шлют. Нет — доставляют каналы, как прежде.
      */
     deliveredByApp?: true;
+    /**
+     * Ход начал сервер сам, и потока у вызова нет: ответ на пачку, брошенную упавшей или перезапущенной копией
+     * (`sendBurstMessage`). Каналы провожают такой ход, как ход по служебному сообщению. Нет — поток у вызова.
+     */
+    unattended?: true;
 } | {
     type: "turn-finished";
     ownerId: string;
@@ -121,6 +126,8 @@ export interface ChatEvents {
     /** Возвращает отписку. */
     subscribe(listener: (event: ChatEvent) => void): () => void;
     emit(event: ChatEvent): void;
+    /** Есть ли слушатели. Необязательный: своя рассылка (общая шина копий) может не знать — тогда не проверяется. */
+    hasListeners?(): boolean;
 }
 /** Рассылка событий в памяти процесса. Упавший слушатель не мешает остальным. */
 export declare function createChatEvents(logError?: (error: unknown) => void): ChatEvents;

package/dist/types/chat-service.d.ts

@@ -256,6 +256,15 @@ export interface SendBurstOptions extends SendMessageOptions {
      * умолчанию 3000; целое от 0 до 600 000. 0 — без ожидания, но сообщения, пришедшие во время хода, всё равно склеиваются.
      */
     quietMs?: number;
+    /**
+     * Пачка переживает перезапуск без повтора вызова: хранилище с ждущими пачками (`savePendingBurst`) помнит её до
+     * ответа, а упала или перезапустилась копия посреди окна — ответит обход (`recoverInterruptedAnswers`, `tickBursts`).
+     * Такой ход приходит событием `turn-started` с `unattended: true`; поток — `subscribe` (ход уже кончился — `null`:
+     * ответ в истории). Запись пачки не удалась — вызов отказывает до записи сообщения. Своей очереди повторов каналу
+     * не нужно. Нет — как раньше: после перезапуска канал повторяет вызов с тем же `message.id` (так делают мессенджеры
+     * SDK; обход и повтор вместе дали бы ответ, который повтор не напечатает).
+     */
+    answerAfterRestart?: boolean;
 }
 /** Сообщение пачки записано; ход на пачку — позже. */
 export interface BurstMessageResult {
@@ -376,6 +385,12 @@ export interface ChatServiceOptions {
     lockedToolOutputs?: readonly string[];
     /** События чата вне потока ответа. Нет — служба создаёт свои (`createChatServer` создаёт сам). */
     chatEvents?: ChatEvents;
+    /**
+     * Несколько служб чата на одном хранилище (своя инструкция на версию продукта и т. п.): какой службе отдать брошенную
+     * пачку (`answerAfterRestart`), найденную обходом этой службы (при старте, регулярно, `tickBursts`). Нет — отвечает
+     * сама эта служба. Задайте один и тот же `serviceFor` всем службам на этом хранилище: брошенные проверяет любая.
+     */
+    abandonedBursts?: AbandonedBurstsOptions;
     /** Фоновые задачи (пакет `@ykurilov/agent-chat-background`). Нет — запрос к модели побайтно прежний. */
     background?: BackgroundTasks;
     /**
@@ -568,6 +583,19 @@ export declare class WidgetNotPendingError extends Error {
 export declare class InvalidWidgetAnswerError extends Error {
     constructor(toolCallId: string);
 }
+/** Кому отдать брошенную пачку (`ChatServiceOptions.abandonedBursts`). */
+export interface AbandonedBurstsOptions {
+    /**
+     * Служба чата этой пачки: эта же, другая служба приложения или новая, созданная сейчас (`createChatService` или
+     * `createChatServer`). `null` — нужной службы нет: пачка никому не отдаётся и ждёт следующего обхода (через 30 с).
+     * Бросок — то же, со строкой в журнал. Зовётся на каждую взятую пачку, до хода; `chat` — чат из хранилища.
+     */
+    serviceFor(burst: {
+        ownerId: string;
+        chatId: string;
+        chat: Chat;
+    }): ChatService | null | undefined | Promise<ChatService | null | undefined>;
+}
 /** Ответ человека на запрос подтверждения. */
 export type ApprovalAnswer = "allow" | "deny" | "always";
 /** Ответ человека на ждущий виджет. */
@@ -792,10 +820,19 @@ export interface ChatService {
      * на пачку с `burstMessageIds`, касания сценария (`deliverNotices` с `wakeAgent`) пока ждут (`busy`). Решение — по
      * общей истории: годится для нескольких копий сервера. Повтор с тем же id (сервер упал посреди окна) не пишет копию,
      * а доводит ход. Права и закрытый чат — до записи, как у `sendMessage`; лимит расходов — при начале хода.
+     * Окно идёт по часам службы (`now`, ручной обход — `tickBursts`). С `answerAfterRestart` пачка переживает перезапуск
+     * без повтора вызова: ответит обход, событием `turn-started` с `unattended: true`.
      * @throws ChatBusyError ответ идёт на другой копии сервера или служба останавливается.
      * @throws TypeError неверное `quietMs`.
      */
     sendBurstMessage(userId: string, chatId: string, message: IncomingUserMessage, options?: SendBurstOptions): Promise<BurstMessageResult>;
+    /**
+     * Обход пачек сейчас: окна этой копии решают заново по часам службы (`now`), брошенные пачки из хранилища (их копия
+     * упала, срок удержания `BURST_HOLD_MS` после окна вышел) получают ход. Сам идёт раз в `STALE_ANSWERS_SWEEP_EVERY_MS`
+     * после `recoverInterruptedAnswers`. Звать вручную — когда часы службы подменены (тесты, прогон сценариев): сдвинули
+     * часы, вызвали, ход начался без настоящего ожидания.
+     */
+    tickBursts(): Promise<void>;
     /**
      * Поправка, пока агент отвечает: сообщение человека пишется сразу (ребёнок идущего ответа или прошлой поправки), агент
      * берёт его на ближайшей границе шага — ответ закрывается, и ход продолжается новым ответом на поправки (поток —

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

@@ -1,6 +1,7 @@
 import type { ModelMessage } from "ai";
 import type { UsageSource } from "../conversation/types.js";
 import type { ModelCatalog } from "../models/model-catalog.js";
+import type { ProviderOutages } from "../provider-errors/provider-outages.js";
 import type { ModelSilenceLimits } from "../provider-errors/model-silence.js";
 import type { ChatStorage } from "../storage/chat-storage.js";
 import type { ProviderFallbackSetting } from "../agent-run/next-attempt.js";
@@ -28,6 +29,8 @@ export interface HelperRunContext {
     /** Очередь инструментов «по одному» чата: помощник делит её с основным агентом. */
     toolQueue?: ToolQueue;
     providerFallback?: ProviderFallbackSetting;
+    /** Память службы об отказах провайдеров по деньгам и ключу. Нет — своя на запуск. */
+    providerOutages?: ProviderOutages;
     modelSilence?: ModelSilenceLimits;
     turnObserver?: TurnObserver;
     /** Проверка лимита расходов перед каждым шагом; бросает `SpendingLimitReachedError`. Нет — без лимита. */

package/dist/types/index.d.ts

@@ -39,7 +39,9 @@ export type { OpenRouterMaxPrice, OpenRouterProviderOptions } from "./models/pro
 export { aliveAtByLocalClock, assertKnownFormatVersion, ChatAlreadyExistsError, DuplicateChatSubjectError, DuplicateMessageError, MessageAlreadyFinishedError, MessageNotAwaitingError, RELEASED_ANSWER_ALIVE_AT, sameMessageParts, silenceBoundaryByLocalClock, UnsupportedFormatVersionError, } from "./storage/chat-storage.js";
 export { assertChatData, assertChatDataFilter, CHAT_DATA_MAX_BYTES, ChatDataTooLargeError, chatDataFields, chatDataMatches, chatDataOfInput, mergeChatData } from "./storage/chat-data.js";
 export type { ChatDataFilter, ChatDataFilterValue } from "./storage/chat-data.js";
-export type { AwaitingMessagePatch, ChatListOptions, ChatStorage, ChatSubjectFilter, FinishedMessagePatch, ImportedChat, MessageLink, MessagePartsLink, NewChatInput, SpendingLimitStateRecord, StreamingMessagePatch, } from "./storage/chat-storage.js";
+export { migratePostgresSchema } from "./storage/postgres-migrations.js";
+export type { PostgresMigrationConnection, PostgresMigrationOptions } from "./storage/postgres-migrations.js";
+export type { AwaitingMessagePatch, ChatListOptions, ChatStorage, ChatSubjectFilter, FinishedMessagePatch, ImportedChat, MessageLink, MessagePartsLink, NewChatInput, SpendingLimitStateRecord, StoredPendingBurst, StreamingMessagePatch, } from "./storage/chat-storage.js";
 export { SpendingLimitReachedError } from "./spending/spending-limits.js";
 export { APP_EVENT_DATA_MAX_BYTES, APP_EVENT_TYPE_MAX_LENGTH, isTurnRefusalCode, normalizeTurnRefusal, TURN_REFUSAL_MESSAGE_MAX_LENGTH, TurnRefusedError, validateAppEvent, } from "./turn-hooks/turn-hooks.js";
 export { DEFAULT_AFTER_TURN_ATTEMPTS, DEFAULT_AFTER_TURN_TIMEOUT_MS } from "./turn-hooks/after-turn.js";
@@ -69,9 +71,9 @@ export { createInMemoryChatStorage } from "./storage/in-memory-storage.js";
 export { ChatBusyError, createRunningAnswerRegistry } from "./running-answers/running-answer-registry.js";
 export type { RunningAnswerRegistry } from "./running-answers/running-answer-registry.js";
 export { ChatNotFoundError, createChatService, InvalidMessageError, InvalidModelChoiceError, NothingToRetryError, } from "./chat-service.js";
-export type { ActionOptions, AgentSettings, ChatBranchForks, ChatCompactions, ChatHistory, ChatListItem, ChatService, ChatInstructions, ChatInstructionsTurn, ChatState, CompactionMarker, CompactionOutcome, CompactionSettings, FlushOptions, CheckReplyInput, CheckReplyResult, IncomingUserMessage, ModelChoice, ModelChosenHandler, ModelMenu, RecoverInterruptedAnswersOptions, SendMessageOptions, SendBurstOptions, BurstMessageResult, SteerResult, } from "./chat-service.js";
+export type { AbandonedBurstsOptions, ActionOptions, AgentSettings, ChatBranchForks, ChatCompactions, ChatHistory, ChatListItem, ChatService, ChatInstructions, ChatInstructionsTurn, ChatState, CompactionMarker, CompactionOutcome, CompactionSettings, FlushOptions, CheckReplyInput, CheckReplyResult, IncomingUserMessage, ModelChoice, ModelChosenHandler, ModelMenu, RecoverInterruptedAnswersOptions, SendMessageOptions, SendBurstOptions, BurstMessageResult, SteerResult, } from "./chat-service.js";
 export { STEER_PART_TYPE, isCorrection } from "./steering/turn-steering.js";
-export { BURST_PART_TYPE, DEFAULT_BURST_QUIET_MS, isBurstMessage } from "./bursts/message-bursts.js";
+export { BURST_HOLD_MS, BURST_PART_TYPE, BURST_SWEEP_LIMIT, DEFAULT_BURST_QUIET_MS, isBurstMessage } from "./bursts/message-bursts.js";
 export { GREETING_LEAD } from "./agent-run/greeting-lead.js";
 export { GREETING_MAX_LENGTH, IMPORT_MAX_IMAGE_BYTES, IMPORT_MAX_IMAGES, IMPORT_MAX_MESSAGES, SUBJECT_DATA_MAX_BYTES, SUBJECT_KEY_MAX_LENGTH } from "./subject-chats/subject-chats.js";
 export type { ChatGreeting, ImportChatInput, ImportedImagePart, ImportedMessageInput, OpenSubjectChatInput, OpenSubjectChatResult, } from "./subject-chats/subject-chats.js";

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

@@ -6,3 +6,8 @@ import type { ProviderDescription } from "../models/model-catalog.js";
  * Порядок общий с тихими повторами: «не повторять» → переполнение → «повторять».
  */
 export declare function classifyProviderError(error: unknown, provider?: Pick<ProviderDescription, "errorHints">): ChatErrorKind;
+/**
+ * Провайдер отказал по доступу (403 без слов о ключе и деньгах): регион, доступ к модели. Другой провайдер может
+ * ответить. Модерация — не такой отказ: дело в содержимом, и другому провайдеру оно не передаётся.
+ */
+export declare function isAccessRefusal(error: unknown): boolean;

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

@@ -1,6 +1,6 @@
 /** Запрос не влез в окно модели: признаки в тексте или код 413. Признаки лимита запросов — не переполнение. */
 export declare function isContextOverflow(text: string, statusCode?: number): boolean;
-/** Квота, бюджет или оплата исчерпаны: повторять не нужно. */
-export declare function isNotRetryable(text: string): boolean;
+/** Квота, бюджет или оплата исчерпаны: повторять не нужно. При коде 429 — только явные признаки пустого счёта. */
+export declare function isNotRetryable(text: string, statusCode?: number): boolean;
 /** Текст похож на временный сбой провайдера или сети. */
 export declare function looksTransient(text: string): boolean;

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

@@ -0,0 +1,41 @@
+import type { ChatErrorKind } from "../conversation/types.js";
+/** Отказ, после которого провайдер не ответит ни на какой запрос: кончились деньги или не принят ключ. */
+export type ProviderOutageKind = Extract<ChatErrorKind, "insufficient_funds" | "invalid_key">;
+export declare function isProviderOutage(kind: ChatErrorKind): kind is ProviderOutageKind;
+/** Сколько провайдер на паузе после отказа: новые ходы это время сразу идут к запасному. */
+export declare const PROVIDER_OUTAGE_PAUSE_MS: number;
+/** Громкая строка о провайдере — не чаще. */
+export declare const PROVIDER_OUTAGE_ALERT_EVERY_MS: number;
+/** Пауза кончилась: один ход пробует провайдера, остальные это время идут мимо. Проба без итога — через этот срок следующая. */
+export declare const PROVIDER_OUTAGE_PROBE_MS = 60000;
+/**
+ * Память службы об отказах провайдеров по деньгам и ключу. Пустой счёт за минуты не пополнится: ходы на паузе не
+ * стучат в него каждый раз, а после паузы его пробует один ход, не все разом. Кэш при этом не теряется — ответить
+ * основной всё равно не может, а запасной на паузе получает все запросы подряд, и его кэш тёплый.
+ */
+export interface ProviderOutages {
+    /**
+     * Провайдер отказал: пауза на `PROVIDER_OUTAGE_PAUSE_MS` и, не чаще раза в `PROVIDER_OUTAGE_ALERT_EVERY_MS`, строка
+     * `[ВНИМАНИЕ провайдер]` в журнал. `fallbackProviderId` — кто отвечает вместо; нет — ходы падают, а
+     * `fallbacksPaused` говорит, что запасные есть, но тоже на паузе.
+     */
+    report(input: {
+        providerId: string;
+        kind: ProviderOutageKind;
+        fallbackProviderId?: string;
+        fallbacksPaused?: boolean;
+    }): void;
+    /** Вид отказа, пока провайдер на паузе или его пробует другой ход; иначе `undefined`. Ничего не меняет. */
+    pausedKind(providerId: string): ProviderOutageKind | undefined;
+    /**
+     * Ход хочет к провайдеру: `undefined` — можно, вид отказа — нельзя. Пауза кончилась — первый получает пробу
+     * на `PROVIDER_OUTAGE_PROBE_MS`, остальные до её итога — вид отказа.
+     */
+    admit(providerId: string): ProviderOutageKind | undefined;
+    /** Провайдер ответил: пауза снята. Счёт громких строк остаётся — «мигающий» провайдер не шумит. */
+    recovered(providerId: string): void;
+}
+export declare function createProviderOutages(options: {
+    now: () => number;
+    logError: (message: string) => void;
+}): ProviderOutages;

package/dist/types/storage/chat-storage.d.ts

@@ -1,6 +1,7 @@
 import type { ChatClosure } from "../access/chat-closure.js";
 import type { ModelChoice } from "../models/model-choice.js";
 import type { ChatDataFilter } from "./chat-data.js";
+import type { TurnRequestContext } from "../page-context/page-context.js";
 import type { MemoryError, MemoryNote, MemoryNoteInput, MemoryRevertGuard, MemoryWriteGuard } from "../memory/long-term-memory.js";
 import type { ExternalChannel } from "../conversation/types.js";
 import type { MemoryMergeApplyResult, MemoryMergeInput, MemoryMergeRevertResult, MemoryOptimizationOutcome, MemoryOptimizationRules, MemoryOptimizationRun, MemoryOptimizationStatus, MergedMemoryNote } from "../memory/memory-optimization.js";
@@ -208,6 +209,38 @@ export interface ChatStorage {
      * Необязательный: без него такие чаты свободны через срок аренды.
      */
     clearChatTurnLeases?(): Promise<void>;
+    /**
+     * Пачка сообщений человека ждёт хода (`sendBurstMessage`): запись на чат, новая заменяет прежнюю. Нужна, чтобы пачку,
+     * чьё окно тишины ждала упавшая или перезапущенная копия сервера, ответила другая копия или следующий запуск.
+     *
+     * Необязательный (вместе с `takeAbandonedBursts`, `renewPendingBurst` и `removePendingBurst`): без него окно тишины живёт только в памяти
+     * копии — после перезапуска пачка ответит, только когда приложение повторит вызов.
+     */
+    savePendingBurst?(burst: StoredPendingBurst): Promise<void>;
+    /**
+     * Брошенные пачки — `heldUntil` не позже `abandonedBefore` — атомарно переходят к `holder` до `heldUntil` и
+     * возвращаются, не больше `limit`, ранние `dueAt` первыми. Две копии разом одну пачку не получат. `exceptHolder` —
+     * записи этого держателя не берутся, каким бы ни был их срок.
+     */
+    takeAbandonedBursts?(take: {
+        abandonedBefore: string;
+        holder: string;
+        heldUntil: string;
+        limit: number;
+        exceptHolder?: string;
+    }): Promise<StoredPendingBurst[]>;
+    /**
+     * Продлить удержание до `heldUntil`, если запись чата всё ещё о сообщении `messageId` и держит её `holder`. Продлено —
+     * `true`; запись другая, взята другой копией или снята — `false`, ничего не меняется.
+     */
+    renewPendingBurst?(renew: {
+        chatId: string;
+        messageId: string;
+        holder: string;
+        heldUntil: string;
+    }): Promise<boolean>;
+    /** Снять запись пачки чата, если она всё ещё о сообщении `messageId`; о другом сообщении или нет — тихо ничего. */
+    removePendingBurst?(chatId: string, messageId: string): Promise<void>;
     /** Новая запись сжатия. Записи только добавляются; сообщения не меняются. Повтор id — ошибка. */
     insertCompaction(record: StoredCompaction): Promise<void>;
     /** Записи сжатия чата в порядке добавления. */
@@ -370,3 +403,17 @@ export declare class UnsupportedFormatVersionError extends Error {
 }
 /** Для адаптеров: сообщение из будущей версии формата прочитать нельзя. */
 export declare function assertKnownFormatVersion(message: Pick<StoredMessage, "id" | "formatVersion">): void;
+/** Пачка, ждущая хода (`ChatStorage.savePendingBurst`). Время — ISO 8601 по часам службы. */
+export interface StoredPendingBurst {
+    chatId: string;
+    ownerId: string;
+    /** Последнее сообщение пачки: на него ход. */
+    messageId: string;
+    /** Конец окна тишины: раньше ход не начинается. */
+    dueAt: string;
+    /** Копия сервера, которая ждёт окно, и до какого времени её ожидание считается живым. Прошло — пачка брошена. */
+    holder: string;
+    heldUntil: string;
+    /** Страница хода (`SendMessageOptions.page`): ход после перезапуска идёт с ней. */
+    page?: TurnRequestContext;
+}

package/dist/types/storage/postgres-migrations.d.ts

@@ -0,0 +1,28 @@
+/** Соединение PostgreSQL, которое нужно помощнику миграций. Подходит `PoolClient` из `pg`: core от `pg` не зависит. */
+export interface PostgresMigrationConnection {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: unknown[];
+    }>;
+    release(): void;
+}
+export interface PostgresMigrationOptions<Connection extends PostgresMigrationConnection> {
+    /** Новое соединение из пула, например `() => pool.connect()`; на каждую попытку — своё. */
+    connect(): Promise<Connection>;
+    /** Своя блокировка пакета: одновременно мигрирует только одна копия этого пакета. */
+    lockKey: number;
+    /** Миграции пакета на этом соединении, например `migrate(drizzle(connection), …)`. */
+    migrate(connection: Connection): Promise<void>;
+    /** Паузы перед повторами, если всё же столкнулись с соседом. */
+    retryDelaysMs?: readonly number[];
+}
+/** Схема всех пакетов SDK. */
+export declare const AGENT_CHAT_SCHEMA = "agent_chat";
+/** Общая блокировка на создание схемы: одна на все пакеты, держится только на `create schema`. */
+export declare const AGENT_CHAT_SCHEMA_LOCK_KEY = 7311900441;
+/**
+ * Создаёт схему `agent_chat` и применяет миграции пакета так, чтобы пакеты могли стартовать одновременно на пустой базе.
+ * Схема создаётся под общей блокировкой, затем она отпускается и берётся своя блокировка пакета: блокировки не
+ * вложены, поэтому взаимной блокировки нет, а разные пакеты ждут друг друга только на создании схемы.
+ * Столкнулись всё же («уже есть») — повтор с начала на новом соединении.
+ */
+export declare function migratePostgresSchema<Connection extends PostgresMigrationConnection>(options: PostgresMigrationOptions<Connection>): Promise<void>;

package/dist/types/storage/storage-contract.d.ts

@@ -33,4 +33,9 @@ export declare function describeChatStorageContract(createStorage: () => ChatSto
      * `clearChatTurnLeases`) обязана быть.
      */
     chatTurnLease?: "required";
+    /**
+     * `pendingBursts: "required"` — ждущие пачки (`savePendingBurst`, `takeAbandonedBursts`, `renewPendingBurst`,
+     * `removePendingBurst`) обязаны быть.
+     */
+    pendingBursts?: "required";
 }): void;

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

@@ -9,6 +9,8 @@ export interface TurnGateInput extends AbandonedAnswers {
     messageId?: string;
     /** Ход на пачку сообщений (`sendBurstMessage`): их id по порядку, последнее — `messageId`. */
     burstMessageIds?: string[];
+    /** Ход на пачку без вызова (обход ждущих пачек). */
+    unattended?: true;
 }
 /**
  * С чем пропущен ход: обычный ход модели, «записать и промолчать» (`hold`) или готовый текст без модели (`reply`).

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

@@ -49,6 +49,11 @@ export type BeforeTurnHandler = (input: {
      * `text` — их тексты через пустую строку. Одно решение на всю пачку; счёт сообщений — по длине списка.
      */
     burstMessageIds?: string[];
+    /**
+     * Ход на пачку начал сам сервер после перезапуска или за упавшую копию (`answerAfterRestart`): вызова, который ждёт
+     * ответ или отказ, нет. Отказ дойдёт только до журнала — сообщить человеку может само приложение.
+     */
+    unattended?: true;
 } & AbandonedAnswers) => Promise<BeforeTurnDecision | void> | BeforeTurnDecision | void;
 /**
  * Ответы агента, которые уйдут с текущей ветки, если ход начнётся (`regenerate`, `edit`, `retry`): по ним приложение откатывает
@@ -94,6 +99,8 @@ export type TurnNotStartedHandler = (input: {
     text?: string;
     /** Пачка сообщений, как в `beforeTurn`. */
     burstMessageIds?: string[];
+    /** Ход без вызова, как в `beforeTurn`: об отказе (например, `spending_limit`) человеку может сказать только приложение. */
+    unattended?: true;
     reason: TurnNotStartedReason;
 } & AbandonedAnswers) => Promise<void> | void;
 /** Кто остановил ход: человек («Стоп»), общий срок хода (`agent.turnTimeoutMs`) или остановка службы (`flush`). */

package/package.json

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