@ykurilov/agent-chat-core 0.56.0 → 0.57.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/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/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 {
@@ -792,10 +801,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/index.d.ts

@@ -39,7 +39,7 @@ 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 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";
@@ -71,7 +71,7 @@ export type { RunningAnswerRegistry } from "./running-answers/running-answer-reg
 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 { 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/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/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.57.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,