@ykurilov/agent-chat-core 0.64.0 → 0.65.0

package/dist/index.js

@@ -174,7 +174,7 @@ import {
   withoutFileParts,
   withoutGlueFragments,
   withoutResetSteps
-} from "./chunk-EWEEYX6U.js";
+} from "./chunk-SA3DXJYB.js";
 import {
   APP_EVENT_DATA_MAX_BYTES,
   APP_EVENT_TYPE_MAX_LENGTH,

package/dist/storage-contract.js

@@ -13,7 +13,7 @@ import {
   extendCatalog,
   newStoredMessage,
   standardCatalog
-} from "./chunk-EWEEYX6U.js";
+} from "./chunk-SA3DXJYB.js";
 import "./chunk-CVRDB3NM.js";
 
 // src/storage/storage-contract.ts

package/dist/types/access/chat-capabilities.d.ts

@@ -10,19 +10,23 @@ import type { Chat } from "../conversation/types.js";
  * запрет выключает и `modelChoice`: выбирать невидимую модель нельзя. `errorDetails` — подробности сбоя провайдера
  * (провайдер, модель, код, причина, когда снимут предел) в истории и потоке; единственное право, выключенное по
  * умолчанию: подробности видны любому через инструменты разработчика, открывать их — только админу. При
- * `modelDetails: false` выключено и оно.
+ * `modelDetails: false` выключено и оно. `appNotices` — служебные пометки приложения (`kind: "app"`: касание после
+ * молчания, срок шага сценария) на экране — без текста для модели, только те, у кого есть проекция для экрана
+ * (`appNoticeViews` службы), и только её данные; тоже выключено по умолчанию: клиент в боевом чате их не видит,
+ * включают в проверке и тестовом чате. При `modelDetails: false` выключено и оно.
  */
-export type ChatCapability = "edit" | "regenerate" | "retry" | "branches" | "modelChoice" | "answerEditing" | "chatList" | "compact" | "attachments" | "voice" | "reasoning" | "toolDetails" | "steer" | "modelDetails" | "errorDetails";
+export type ChatCapability = "edit" | "regenerate" | "retry" | "branches" | "modelChoice" | "answerEditing" | "chatList" | "compact" | "attachments" | "voice" | "reasoning" | "toolDetails" | "steer" | "modelDetails" | "errorDetails" | "appNotices";
 /**
- * Права, как их отдаёт `resolveChatCapabilities`. `modelDetails` (нет — `true`) и `errorDetails` (нет — `false`) в типе
+ * Права, как их отдаёт `resolveChatCapabilities`. `modelDetails` (нет — `true`), `errorDetails` и `appNotices` (нет — `false`) в типе
  * необязательны: свой литерал прав, собранный до этих прав, остаётся верным. Ядро и история заполняют их всегда.
  */
-export type ChatCapabilities = Record<Exclude<ChatCapability, "modelDetails" | "errorDetails">, boolean> & {
+export type ChatCapabilities = Record<Exclude<ChatCapability, "modelDetails" | "errorDetails" | "appNotices">, boolean> & {
     modelDetails?: boolean;
     errorDetails?: boolean;
+    appNotices?: boolean;
 };
 /**
- * Права в чате от приложения: частичный список, пропущенное — `true` (`errorDetails` — `false`). Тот же вход, что у `beforeTurn` (чат с данными
+ * Права в чате от приложения: частичный список, пропущенное — `true` (`errorDetails` и `appNotices` — `false`). Тот же вход, что у `beforeTurn` (чат с данными
  * объекта). Не булево значение, неизвестное право или исключение — ошибка приложения.
  */
 export type ChatCapabilitiesHandler = (input: {
@@ -31,8 +35,8 @@ export type ChatCapabilitiesHandler = (input: {
 }) => Partial<ChatCapabilities> | void | Promise<Partial<ChatCapabilities> | void>;
 export declare const CHAT_CAPABILITIES: readonly ChatCapability[];
 /**
- * Все права, кроме `errorDetails`, разрешены и дополнены ответом приложения; `modelDetails: false` выключает и
- * `modelChoice`, и `errorDetails`. Не булево значение или неизвестное право — `TypeError`.
+ * Все права, кроме `errorDetails` и `appNotices`, разрешены и дополнены ответом приложения; `modelDetails: false` выключает и
+ * `modelChoice`, `errorDetails` и `appNotices`. Не булево значение или неизвестное право — `TypeError`.
  */
 export declare function resolveChatCapabilities(given: Partial<ChatCapabilities> | void | null): Required<ChatCapabilities>;
 /** Действие запрещено правами чата: сервер отвечает 403 `action_forbidden`. */

package/dist/types/app-state/state-messages.d.ts

@@ -38,7 +38,8 @@ export declare function publicAppStateParts<P extends {
 }>(parts: readonly P[], hidden?: HiddenStateKey): P[];
 /**
  * Сообщения для браузера: части без служебных ключей, без застывших блоков контекста, отметки `endTurn` и служебных
- * сообщений вида `app` (они только для модели);
+ * сообщений вида `app` (они только для модели; с `appNoticeViews` — остаются те, у кого есть проекция для экрана: без
+ * текста для модели, `data` — проекция);
  * сообщение человека, у которого не осталось частей, не уходит. Служебное сообщение состояния (`isStateMessage`) перед
  * обычным не показывается: его открытые записи едут в начале этого сообщения, и экран сворачивает то же состояние.
  */
@@ -47,9 +48,16 @@ export declare function publicMessages<M extends {
     parts: ReadonlyArray<{
         type: string;
     }>;
-}>(messages: readonly M[], hidden?: HiddenStateKey): M[];
+}>(messages: readonly M[], hidden?: HiddenStateKey, options?: {
+    appNoticeViews?: AppNoticeViews;
+}): M[];
 /** Кусок потока для браузера: запись состояния без скрытых ключей; ничего не осталось — `undefined`. */
 export declare function publicStateChunk(chunk: UIMessageChunk, hidden?: HiddenStateKey): UIMessageChunk | undefined;
+/**
+ * Проекции пометок приложения для экрана (`appNoticeViews` службы): имя пометки → безопасные для браузера данные из
+ * `data`. Нет проекции, она вернула `undefined` или упала — пометка в браузер не уходит.
+ */
+export type AppNoticeViews = Readonly<Record<string, (data: unknown) => unknown>>;
 /** Части только для модели: застывшие блоки контекста и отметка конца хода инструментом без слов. */
 export declare function isModelOnlyPart(part: {
     type: string;

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

@@ -27,6 +27,7 @@ import type { CompactionSettings } from "./compaction/compaction-settings.js";
 import type { ChatGreeting, ImportChatInput, OpenSubjectChatInput, OpenSubjectChatResult } from "./subject-chats/subject-chats.js";
 import type { AppStateValues } from "./app-state/app-state.js";
 import type { StateChangedHandler } from "./app-state/state-changed.js";
+import type { AppNoticeViews } from "./app-state/state-messages.js";
 import type { BranchFork } from "./conversation/branches.js";
 import type { AnswerEdit } from "./conversation/answer-edit.js";
 import type { ReplyChecksSetting } from "./agent-run/reply-check-types.js";
@@ -454,6 +455,12 @@ export interface ChatServiceOptions {
      * @throws TypeError (при создании службы) неверное имя.
      */
     privateStateKeys?: readonly string[];
+    /**
+     * Проекции пометок приложения (`kind: "app"`) для экрана при праве `appNotices`: имя пометки → безопасные данные
+     * (`(data) => ({ silentMs })`). Пометка без проекции в браузер не уходит, даже с правом. Сценарии (`flow.withChat`)
+     * добавляют свои сами.
+     */
+    appNoticeViews?: AppNoticeViews;
 }
 /** Ход, для которого берётся инструкция чата; у сжатия его нет. */
 export interface ChatInstructionsTurn {

package/dist/types/index.d.ts

@@ -60,6 +60,7 @@ export { accessRefusedResponse, allowedUser } from "./access/resolved-user.js";
 export type { AccessRefusal, ResolvedUser } from "./access/resolved-user.js";
 export { ActionForbiddenError, CHAT_CAPABILITIES, resolveChatCapabilities } from "./access/chat-capabilities.js";
 export type { ChatCapabilities, ChatCapabilitiesHandler, ChatCapability } from "./access/chat-capabilities.js";
+export type { AppNoticeViews } from "./app-state/state-messages.js";
 export { CHAT_CLOSED_PART_TYPE, ChatClosedError, normalizeChatClosure } from "./access/chat-closure.js";
 export type { ChatClosure } from "./access/chat-closure.js";
 export { ChatCreationRefusedError } from "./access/chat-creation.js";

package/package.json

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