@ykurilov/agent-chat-core 0.55.0 → 0.56.0

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

@@ -0,0 +1,60 @@
+import type { AgentAudience, AgentChannel, ChatSubject } from "../conversation/types.js";
+import type { StaffActor } from "../turn-hooks/turn-hooks.js";
+/**
+ * Кто смотрит на ход: права и признаки человека, которые приложение берёт из своей базы (`agent.viewer`). Ядро его не
+ * читает, только передаёт. `isAdmin` — общий признак для пакетов (серверы MCP, навыки): «только админы» видны, когда он
+ * `true`. Остальные поля — свои у приложения.
+ */
+export interface AgentViewer {
+    isAdmin?: boolean;
+    readonly [key: string]: unknown;
+}
+/** Что видит `agent.viewer` в начале хода. */
+export interface AgentViewerInput {
+    /** Кто делает ход: сотрудник в копии чата человека, иначе владелец чата. */
+    userId: string;
+    chatId: string;
+    /** Владелец чата. */
+    ownerId: string;
+    /** Ответ агента, который строит этот ход; у фонового помощника — пустая строка. */
+    messageId: string;
+    chat: {
+        data?: Record<string, unknown>;
+    };
+    subject?: ChatSubject;
+    channel: AgentChannel;
+    audience: AgentAudience;
+    staff?: StaffActor;
+    /** «Стоп» и срок хода. */
+    abortSignal: AbortSignal;
+}
+/**
+ * Права человека на ход: зовётся один раз в начале хода (повторная попытка и запасной провайдер не зовут снова), до
+ * блоков контекста и сборки инструментов. Итог идёт полем `viewer` в `contextBlocks` и в `AgentToolsModel`; в запрос к
+ * модели сам не попадает. Бросила или вернула не объект — ход кончается ошибкой.
+ */
+export type AgentViewerSource = (input: AgentViewerInput) => AgentViewer | Promise<AgentViewer>;
+/** `agent.viewer` бросила или вернула не объект: ход кончается ошибкой, в журнал сервера — причина. */
+export declare class AgentViewerError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Зовёт `agent.viewer`: итог заморожен (правка не доходит до хода), «Стоп» обрывает ожидание. */
+export declare function resolveAgentViewer(source: AgentViewerSource, input: AgentViewerInput): Promise<AgentViewer>;
+/** Вход `agent.viewer` из полей хода. */
+export declare function viewerInput(turn: {
+    chatId: string;
+    ownerId?: string;
+    messageId: string;
+    chatData?: Record<string, unknown>;
+    subject?: ChatSubject;
+    channel?: AgentChannel;
+    audience: AgentAudience;
+    staff?: StaffActor;
+    abortSignal: AbortSignal;
+}): AgentViewerInput;
+/** Срок `agent.viewer` вне хода человека (сжатие истории, фоновый помощник): «Стопа» там нет, зависание не держит работу. */
+export declare const VIEWER_OUTSIDE_TURN_TIMEOUT_MS = 10000;
+/** `agent.viewer` для сжатия и фонового помощника: те же правила, что в ходе, плюс срок ответа. */
+export declare function resolveViewerOutsideTurn(source: AgentViewerSource, turn: Omit<Parameters<typeof viewerInput>[0], "abortSignal">, signal?: AbortSignal): Promise<AgentViewer>;

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

@@ -24,6 +24,7 @@ import type { PreparedTurn } from "../turn-hooks/turn-preparation.js";
 import type { ChatClosure } from "../access/chat-closure.js";
 import type { HiddenStateKey } from "../app-state/state-messages.js";
 import type { ContextBlocksSource } from "../frozen-context/context-blocks.js";
+import type { AgentViewer, AgentViewerSource } from "./agent-viewer.js";
 import type { AppStateAccess, AppStateValues } from "../app-state/app-state.js";
 /** Выбранная модель: по ней приложение решает, какие инструменты ей дать. */
 export interface AgentToolsModel {
@@ -89,6 +90,11 @@ export interface AgentToolsModel {
      * Нет — вызов вне хода (сжатие, фоновая задача): вне хода приложение пишет в данные чата.
      */
     state?: AppStateAccess;
+    /**
+     * Права человека на ход (`agent.viewer`): один объект на все попытки и шаги хода, тот же, что у `contextBlocks`.
+     * Нет `agent.viewer` (или модель собрана вне хода) — поля нет.
+     */
+    viewer?: AgentViewer;
 }
 /** Инструменты агента: один набор для всех моделей или набор, зависящий от выбранной модели. */
 export type AgentToolsSource = ToolSet | ((model: AgentToolsModel) => ToolSet);
@@ -174,6 +180,8 @@ export interface AgentTurnInput {
     stepContext?: StepContext;
     /** Срок ответа `stepContext`, мс, уже проверенный; `Infinity` — без срока. Нет — 5 с. */
     stepContextTimeoutMs?: number;
+    /** Права человека: один вызов в начале хода, до блоков и инструментов (`agent.viewer`). */
+    viewer?: AgentViewerSource;
     /** Блоки приложения для вопроса хода: один опрос в начале хода, дальше застывают в ответе (`agent.contextBlocks`). */
     contextBlocks?: ContextBlocksSource;
     /** Срок ответа `contextBlocks`, мс, уже проверенный; `Infinity` — без срока. Нет — 5 с. */

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

@@ -45,6 +45,7 @@ import type { BeforeCreateChatHandler } from "./access/chat-creation.js";
 import type { AskModel, PrepareTurn, RecordUsage } from "./turn-hooks/prepare-turn.js";
 import type { AfterTurnHandler, AppEvent, BeforeTurnHandler, StaffActor, TurnAction, TurnNotStartedHandler } from "./turn-hooks/turn-hooks.js";
 import type { AgentWidgetSettings } from "./widgets/widget-types.js";
+import type { AgentViewerSource } from "./agent-run/agent-viewer.js";
 import type { TurnFinishedHandler } from "./agent-run/turn-finished.js";
 export { DEFAULT_TEXT_MODE_NOTE, DEFAULT_VOICE_MODE_HINT };
 /**
@@ -203,6 +204,16 @@ export interface AgentSettings {
      * `private: true` — блок не показывается в групповом ходе. Не задано — запрос побайтно прежний.
      */
     contextBlocks?: ContextBlocksSource;
+    /**
+     * Права человека из базы приложения (админ ли, тариф): зовётся один раз в начале хода, до `contextBlocks` и сборки
+     * инструментов; повторная попытка и запасной провайдер не зовут снова. Итог — полем `viewer` в `contextBlocks` и в
+     * модели инструментов (`AgentToolsModel.viewer`), в запрос к модели не идёт. Ещё зовётся перед сжатием истории и
+     * запуском фонового помощника: их инструменты те же (канал и группа — по последнему сообщению человека; срок ответа
+     * 10 с). Бросила или вернула не объект — ход кончается ошибкой
+     * (`other`), в журнал сервера — `[agent.viewer] …`. `isAdmin` читают пакеты (серверы MCP, навыки). Не задано —
+     * поля `viewer` нет.
+     */
+    viewer?: AgentViewerSource;
     /**
      * Срок ответа `contextBlocks`, мс. Не ответила или бросила — блоки приложения берутся из прошлого ответа чата, в
      * журнал сервера — строка `[блоки контекста] …`; функция получает отмену через `abortSignal`. «Стоп» отменяет её

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

@@ -1,5 +1,6 @@
 import type { MessageAttachments } from "../attachments/message-attachments.js";
 import type { AgentToolsSource } from "../agent-run/run-agent-turn.js";
+import type { AgentViewerSource } from "../agent-run/agent-viewer.js";
 import type { TurnObserver } from "../agent-run/turn-observer.js";
 import type { AgentChatMessage, Chat, StoredMessage } from "../conversation/types.js";
 import type { ModelCatalog } from "../models/model-catalog.js";
@@ -92,9 +93,11 @@ export interface CompactionServiceOptions {
     storage: ChatStorage;
     catalog: ModelCatalog;
     env: Record<string, string | undefined>;
+    /** `viewer` — права человека: инструменты сжатия те же, что у хода (кэш). */
     agent: {
         instructions: string;
         tools?: AgentToolsSource;
+        viewer?: AgentViewerSource;
     };
     attachments?: MessageAttachments;
     /** `null` — автосжатие выключено; записи, уже сделанные, всё равно применяются к истории. */

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

@@ -188,8 +188,10 @@ export interface StoredBranchSelection {
  * `first_message` — ход, в котором агент пишет первым (касание, утро сценария): `deliverNotices({ usageSource })`.
  * `voice_input` — диктовка через сервер (`@ykurilov/agent-chat-voice`, режим `relay`): `inputTokens` — секунды звука,
  * `modelId` — модель распознавания. `voice_polish` — чистка надиктованного текста моделью.
+ * `mcp_tool` — вызов инструмента сервера MCP (`@ykurilov/agent-chat-mcp`), если сервер сообщил стоимость: `modelId` —
+ * имя инструмента `<префикс>__<имя>`, `providerId` — `mcp`, токенов нет.
  */
-export declare const BUILT_IN_USAGE_SOURCES: readonly ["answer", "answer_correction", "compaction", "memory", "speech", "sounds", "web_tools", "images", "helper", "background", "judge", "first_message", "voice_input", "voice_polish"];
+export declare const BUILT_IN_USAGE_SOURCES: readonly ["answer", "answer_correction", "compaction", "memory", "speech", "sounds", "web_tools", "images", "helper", "background", "judge", "first_message", "voice_input", "voice_polish", "mcp_tool"];
 /** Штатные виды расхода SDK. */
 export type BuiltInUsageSource = (typeof BUILT_IN_USAGE_SOURCES)[number];
 /**

package/dist/types/frozen-context/context-blocks.d.ts

@@ -2,6 +2,7 @@ import type { AgentAudience, AgentChannel, ChatSubject } from "../conversation/t
 import type { AppStateValues } from "../app-state/app-state.js";
 import type { AgentNotice } from "../notices/agent-notice.js";
 import type { StaffActor } from "../turn-hooks/turn-hooks.js";
+import type { AgentViewer } from "../agent-run/agent-viewer.js";
 /** Тип служебной части ответа с застывшими блоками хода. Клиенту не уходит, модели — только текстом блоков. */
 export declare const FROZEN_CONTEXT_PART_TYPE = "data-frozen-context";
 /** Блок контекста: ключ уникален в наборе, текст идёт модели как есть. Личный блок не показывается в групповом ходе. */
@@ -44,6 +45,8 @@ export interface ContextBlocksInput {
     audience: AgentAudience;
     /** Сотрудник, который делает ход в копии чата человека; нет — ход делает сам владелец. */
     staff?: StaffActor;
+    /** Права человека на ход (`agent.viewer`), тот же объект, что у инструментов. Нет `agent.viewer` — поля нет. */
+    viewer?: AgentViewer;
     modelId: string;
     providerId: string;
     /** Отмена: «Стоп», срок функции (`agent.contextBlocksTimeoutMs`), срок хода. */

package/dist/types/frozen-context/turn-context.d.ts

@@ -1,4 +1,5 @@
 import type { AgentTurnInput } from "../agent-run/run-agent-turn.js";
+import type { AgentViewer } from "../agent-run/agent-viewer.js";
 import type { AppStateValues } from "../app-state/app-state.js";
 import type { AgentChatMessage } from "../conversation/types.js";
 import type { FrozenContextData } from "./context-blocks.js";
@@ -10,6 +11,7 @@ export declare function frozenContextForTurn(input: AgentTurnInput, turn: {
     history: readonly AgentChatMessage[];
     answer?: AgentChatMessage;
     state: AppStateValues;
+    viewer?: AgentViewer;
 }): Promise<{
     data: FrozenContextData;
     fresh: boolean;
@@ -23,4 +25,5 @@ export declare function resumeNoteForTurn(input: AgentTurnInput, turn: {
     history: readonly AgentChatMessage[];
     answer: AgentChatMessage;
     state: AppStateValues;
+    viewer?: AgentViewer;
 }): Promise<FrozenContextData | undefined>;

package/dist/types/index.d.ts

@@ -78,6 +78,8 @@ export type { ChatGreeting, ImportChatInput, ImportedImagePart, ImportedMessageI
 export { AttachmentRejectedError, withoutFileParts } from "./attachments/message-attachments.js";
 export type { IncomingFilePart, MessageAttachments, StoredFilePart } from "./attachments/message-attachments.js";
 export type { AgentToolsModel, AgentToolsSource } from "./agent-run/run-agent-turn.js";
+export { AgentViewerError } from "./agent-run/agent-viewer.js";
+export type { AgentViewer, AgentViewerInput, AgentViewerSource } from "./agent-run/agent-viewer.js";
 export type { StepContext, StepContextInput } from "./agent-run/step-context.js";
 export type { ContextBlock, ContextBlockEntry, ContextBlocksInput, ContextBlocksSource, HiddenContextBlock } from "./frozen-context/context-blocks.js";
 export { FROZEN_CONTEXT_PART_TYPE } from "./frozen-context/context-blocks.js";

package/package.json

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