@ykurilov/agent-chat-core 0.67.0 → 0.69.0

package/dist/types/thought-titles/thought-title-text.d.ts

@@ -0,0 +1,26 @@
+/** Больше слов в заголовке раздумья не бывает: «Продумываю правила игры», а не пересказ. */
+export declare const THOUGHT_TITLE_MAX_WORDS = 6;
+/** Язык по тексту человека: есть кириллица — русский, иначе английский. */
+export declare function languageOfText(text: string): string;
+/**
+ * Написан ли текст письменностью языка: для языков на кириллице нужна кириллица и не больше латинских букв, чем
+ * кириллических; для языков на латинице — наоборот. Незнакомый язык не проверяется.
+ */
+export declare function fitsLanguage(text: string, language: string): boolean;
+/** Первый заголовок провайдера — строка целиком жирным (`**…**`), так пишет сводку рассуждений GPT. */
+export declare function providerHeadingOf(text: string): string | undefined;
+export interface ThoughtTitleRules {
+    /** Самый длинный заголовок, знаков. */
+    maxLength: number;
+    /** Язык человека, код («ru»). */
+    language: string;
+    /** Имена инструментов хода и навыков: заголовок с ними — техника, а не мысль. */
+    toolNames?: readonly string[];
+}
+/**
+ * Заголовок из ответа модели или провайдера по правилам: первая строка, без разметки, кавычек и точки на конце, с
+ * заглавной; 1–6 слов, не длиннее предела, языком человека, без кода, путей и имён инструментов. Иначе `undefined`.
+ */
+export declare function cleanThoughtTitle(raw: string, rules: ThoughtTitleRules): string | undefined;
+/** Заголовок короткого раздумья без модели: его первое предложение, если оно подходит под правила. */
+export declare function shortThoughtTitle(text: string, rules: ThoughtTitleRules): string | undefined;

package/dist/types/thought-titles/thought-titles-setting.d.ts

@@ -0,0 +1,83 @@
+import type { ModelCatalog } from "../models/model-catalog.js";
+import type { ModelChoice } from "../models/model-choice.js";
+/** Что знает функция языка заголовков: чей чат и последнее сообщение человека текстом. */
+export interface ThoughtTitleLanguageInput {
+    ownerId: string;
+    chatId: string;
+    lastUserText: string;
+}
+/**
+ * Заголовки раздумий вместо «Думал 3 сек» (`createChatService({ thoughtTitles })`). Провайдер сам отдаёт заголовки
+ * (сводка рассуждений GPT через OpenRouter) — берутся они; иначе пересказ моделью `model`. Нет настройки — заголовков
+ * нет, ход и запрос побайтно прежние.
+ */
+export interface ThoughtTitlesSetting {
+    /**
+     * `false` — выключено. Функция — решение на каждый ход (например, только для части людей); сбой функции — без
+     * заголовков, строка в журнал. По умолчанию включено, если настройка задана.
+     */
+    enabled?: boolean | ((chat: {
+        ownerId: string;
+        chatId: string;
+    }) => boolean);
+    /**
+     * Дешёвая модель каталога для пересказа, например `{ modelId: "deepseek-4.1-flash", providerId: "deepseek",
+     * reasoning: "off" }`. Нет — только заголовки провайдера и первые предложения коротких раздумий.
+     */
+    model?: ModelChoice;
+    /**
+     * Показывать заголовки тем, у кого нет права `reasoning` (по умолчанию да): включая `thoughtTitles`, приложение разрешает
+     * показывать людям сжатую суть раздумий. Сам текст раздумий им не уходит. `false` — без права `reasoning` как раньше:
+     * ни раздумий, ни заголовков.
+     */
+    showWithoutReasoning?: boolean;
+    /**
+     * Свои слова, которых не должно быть в заголовке: имена навыков, внутренние названия. Имена инструментов хода ядро
+     * знает само. Например `async () => (await skills.manage.list()).map((skill) => skill.name)`. Сбой — без них, строка в журнал.
+     */
+    hiddenNames?: (chat: {
+        ownerId: string;
+        chatId: string;
+    }) => readonly string[] | Promise<readonly string[]>;
+    /** Самый длинный заголовок, знаков. По умолчанию 60. */
+    maxLength?: number;
+    /** Сколько раз за ход звать модель заголовков. По умолчанию 6. */
+    maxPerTurn?: number;
+    /** Раздумье короче — без модели: первое предложение или прежняя подпись. По умолчанию 150 знаков. */
+    minChars?: number;
+    /** Срок ответа модели заголовков, мс. По умолчанию 8000. */
+    timeoutMs?: number;
+    /**
+     * Язык заголовков: код («ru», «en») или функция хода. Нет или функция вернула пусто — по последнему сообщению
+     * человека: есть кириллица — русский, иначе английский.
+     */
+    language?: string | ((input: ThoughtTitleLanguageInput) => string | undefined);
+}
+export interface ResolvedThoughtTitles {
+    enabled?: (chat: {
+        ownerId: string;
+        chatId: string;
+    }) => boolean;
+    showWithoutReasoning: boolean;
+    hiddenNames?: ThoughtTitlesSetting["hiddenNames"];
+    model?: ModelChoice;
+    maxLength: number;
+    maxPerTurn: number;
+    minChars: number;
+    timeoutMs: number;
+    language?: ThoughtTitlesSetting["language"];
+}
+/** Настройка к одному виду; ошибка в ней — `TypeError` при создании службы. Выключено или нет — `null`. */
+export declare function resolveThoughtTitles(setting: ThoughtTitlesSetting | undefined, catalog: ModelCatalog): ResolvedThoughtTitles | null;
+/** Язык заголовков хода: настройка, иначе по сообщению человека. Сбой функции — по сообщению, строка в журнал. */
+export declare function thoughtTitleLanguage(resolved: ResolvedThoughtTitles, input: ThoughtTitleLanguageInput, logError: (message: string) => void): string;
+/** Включены ли заголовки в этом ходе; сбой функции `enabled` — нет, строка в журнал. */
+export declare function thoughtTitlesEnabled(resolved: ResolvedThoughtTitles, chat: {
+    ownerId: string;
+    chatId: string;
+}, logError: (message: string) => void): boolean;
+/** Свои слова приложения для проверки заголовков; сбой функции — без них, строка в журнал. */
+export declare function thoughtTitleHiddenNames(resolved: ResolvedThoughtTitles, chat: {
+    ownerId: string;
+    chatId: string;
+}, logError: (message: string) => void): Promise<string[]>;

package/dist/types/thought-titles/turn-thought-titles.d.ts

@@ -0,0 +1,56 @@
+import type { UIMessageChunk } from "ai";
+/** Заголовки раздумий по порядковому номеру части рассуждения в сообщении («0», «1»…), как `reasoningDurationsMs`. */
+export type ThoughtTitles = Record<string, string>;
+export interface TurnThoughtTitlesInput {
+    /** Язык человека, код («ru»). */
+    language: string;
+    maxLength: number;
+    /** Сколько раз за ход можно звать модель заголовков. */
+    maxPerTurn: number;
+    /** Раздумье короче — его первое предложение, если оно на языке человека; иначе — пересказ моделью. */
+    minChars: number;
+    /** Пересказ моделью заголовков: сырой ответ модели; `signal` — «Стоп» хода. Нет — только заголовки провайдера и короткие. */
+    summarize?: (text: string, signal?: AbortSignal) => Promise<string | undefined>;
+    /** Имена инструментов и навыков хода (и не вызванных): заголовок с ними — техника, а не мысль. */
+    toolNames?: readonly string[];
+    /** Сигнал хода: «Стоп» отменяет начатые пересказы, новых не будет. */
+    signal?: AbortSignal;
+    /**
+     * Продолжение ответа: сколько раздумий уже в сообщении, их заголовки и сколько раз уже звали модель (`asked`):
+     * `maxPerTurn` — на ответ целиком.
+     */
+    existing?: {
+        count: number;
+        titles: ThoughtTitles;
+        asked?: number;
+    };
+    /** Карта заголовков изменилась: полная копия. После `close` не зовётся. */
+    onChange: (titles: ThoughtTitles) => void;
+    logError: (message: string) => void;
+}
+export type TurnThoughtTitles = ReturnType<typeof createTurnThoughtTitles>;
+/** Сколько конец хода ждёт недоделанные заголовки, мс: дольше — они остаются без заголовка. */
+export declare const THOUGHT_TITLES_SETTLE_MS = 1500;
+/** Заголовки для хода: всё, кроме того, что ход знает сам. `settleMs` — ожидание в конце хода (`THOUGHT_TITLES_SETTLE_MS`). */
+export type TurnThoughtTitlesSource = Omit<TurnThoughtTitlesInput, "existing" | "onChange" | "logError" | "signal"> & {
+    settleMs?: number;
+};
+/**
+ * Заголовки раздумий одного хода. Смотрит куски потока: копит текст каждого раздумья, на его конце решает — заголовок
+ * провайдера (жирная строка на языке человека), короткое раздумье (первое предложение, если оно на языке человека),
+ * иначе пересказ моделью (не больше `maxPerTurn` за ход). Ход не ждёт: модель отвечает в фоне, готовый заголовок уходит в `onChange`.
+ */
+export declare function createTurnThoughtTitles(input: TurnThoughtTitlesInput): {
+    observe(chunk: UIMessageChunk): void;
+    /** Имена инструментов набора попытки: весь набор, а не только вызванные. */
+    addToolNames(names: readonly string[]): void;
+    /** Шаг стёрт: в сообщении осталось `kept` раздумий, заголовки и ответы после них забываются; счёт запросов — нет. */
+    rewind(kept: number): void;
+    titles: () => ThoughtTitles;
+    /** Раздумья этого хода, которые пересказывала модель: для отметки в частях. */
+    askedKeys: () => string[];
+    /** Ждёт начатые пересказы, но не дольше `timeoutMs`: ход кончается, недоделанные останутся без заголовка. */
+    settle(timeoutMs: number): Promise<void>;
+    /** Ход кончился: поздние заголовки больше не принимаются. */
+    close(): void;
+};

package/package.json

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