@ykurilov/agent-chat-core 0.79.0 → 0.80.0

package/dist/index.js

@@ -186,7 +186,7 @@ import {
   withoutFileParts,
   withoutGlueFragments,
   withoutResetSteps
-} from "./chunk-AJSRGBVM.js";
+} from "./chunk-Z44ZAFZC.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-AJSRGBVM.js";
+} from "./chunk-Z44ZAFZC.js";
 import "./chunk-CVRDB3NM.js";
 
 // src/storage/storage-contract.ts

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

@@ -27,7 +27,7 @@ import type { AppEvent, StaffActor } from "../turn-hooks/turn-hooks.js";
 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 { ContextBlocksRefresh, 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";
 /** Выбранная модель: по ней приложение решает, какие инструменты ей дать. */
@@ -198,6 +198,7 @@ export interface AgentTurnInput {
     viewer?: AgentViewerSource;
     /** Блоки приложения для вопроса хода: один опрос в начале хода, дальше застывают в ответе (`agent.contextBlocks`). */
     contextBlocks?: ContextBlocksSource;
+    contextBlocksRefresh?: ContextBlocksRefresh;
     /** Срок ответа `contextBlocks`, мс, уже проверенный; `Infinity` — без срока. Нет — 5 с. */
     contextBlocksTimeoutMs?: number;
     /**

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

@@ -8,7 +8,7 @@ import type { TurnRequestContext } from "./page-context/page-context.js";
 import type { BrowserCallAnswer } from "./agent-run/browser-tools.js";
 import type { AgentToolsSource } from "./agent-run/run-agent-turn.js";
 import type { StepContext } from "./agent-run/step-context.js";
-import type { ContextBlocksSource } from "./frozen-context/context-blocks.js";
+import type { ContextBlocksRefresh, ContextBlocksSource } from "./frozen-context/context-blocks.js";
 import type { ChatEvent, ChatEvents } from "./chat-events/chat-events.js";
 import type { BackgroundTasks } from "./background/background-tasks.js";
 import type { ThoughtTitlesSetting } from "./thought-titles/thought-titles-setting.js";
@@ -222,6 +222,8 @@ export interface AgentSettings {
      * `private: true` — блок не показывается в групповом ходе. Не задано — запрос побайтно прежний.
      */
     contextBlocks?: ContextBlocksSource;
+    /** Снимок до смены начала истории, как у памяти; по умолчанию `turn` — прежнее чтение каждого хода. */
+    contextBlocksRefresh?: ContextBlocksRefresh;
     /**
      * Права человека из базы приложения (админ ли, тариф): зовётся один раз в начале хода, до `contextBlocks` и сборки
      * инструментов; повторная попытка и запасной провайдер не зовут снова. Итог — полем `viewer` в `contextBlocks` и в

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

@@ -21,6 +21,8 @@ export interface HiddenContextBlock {
 }
 /** Что отдаёт источник блоков: показанные блоки и скрытые ради места. */
 export type ContextBlockEntry = ContextBlock | HiddenContextBlock;
+/** Когда перечитывать блоки приложения; по умолчанию — каждый новый ход. */
+export type ContextBlocksRefresh = "turn" | "history-start";
 export declare function isHiddenBlock(entry: ContextBlockEntry): entry is HiddenContextBlock;
 /** Что видит `agent.contextBlocks` в начале хода. Всё — копии: правка функции не доходит до хода. */
 export interface ContextBlocksInput {
@@ -62,7 +64,8 @@ export interface ContextBlocksInput {
     abortSignal: AbortSignal;
 }
 /**
- * Блоки приложения для вопроса хода: зовётся один раз в начале хода. Пустой список, `null` и `undefined` — блоков нет.
+ * Блоки приложения для вопроса хода: по умолчанию один вызов в начале нового хода; `history-start` повторяет
+ * чтение только при отсутствии снимка или смене начала истории. Пустой список, `null` и `undefined` — блоков нет.
  * Бросила, вернула не список или не ответила в срок — блоки приложения берутся из прошлого ответа.
  */
 export type ContextBlocksSource = (input: ContextBlocksInput) => ContextBlockEntry[] | null | undefined | Promise<ContextBlockEntry[] | null | undefined>;
@@ -86,6 +89,8 @@ export interface FrozenContextData {
      * Нет поля — память не читалась (групповой ход, сбой, ответ старой версии).
      */
     memoryFrom?: string;
+    /** Успешный снимок приложения при этом начале истории; только режим `history-start`. */
+    appContextFrom?: string;
     /** Служебные сообщения хода от `prepareTurn`: модель видит их текстом после блоков. В разницу блоков не входят. */
     notices?: AgentNotice[];
 }

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

@@ -22,6 +22,8 @@ export declare function freezeContext(input: {
      * чате память не перечитывается и не досылается. Нет — память читается каждый ход.
      */
     memoryFrom?: string;
+    /** Тот же триггер для приложения в opt-in режиме; нет — прежнее чтение каждого хода. */
+    appContextFrom?: string;
     base: {
         id: string;
         data: FrozenContextData;

package/dist/types/index.d.ts

@@ -95,7 +95,7 @@ export type { AgentToolsModel, AgentToolsSource } from "./agent-run/run-agent-tu
 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 type { ContextBlock, ContextBlockEntry, ContextBlocksInput, ContextBlocksRefresh, ContextBlocksSource, HiddenContextBlock } from "./frozen-context/context-blocks.js";
 export { FROZEN_CONTEXT_PART_TYPE } from "./frozen-context/context-blocks.js";
 export { END_TURN_PART_TYPE } from "./agent-run/end-turn.js";
 export type { ProviderFallbackSetting } from "./agent-run/next-attempt.js";

package/package.json

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