@downcity/agent 1.1.14 → 1.1.17

package/bin/session/composer/compaction/SessionCompactionComposer.d.ts

@@ -3,19 +3,18 @@
  *
  * 关键点（中文）
  * - 负责“何时压缩 + 压缩策略参数”决策。
- * - 具体读写由 SessionHistoryComposer 执行（CompactionComposer 不直接落盘）。
+ * - 具体读写由 SessionHistoryStore 执行（CompactionComposer 不直接落盘）。
  */
 import type { LanguageModel, SystemModelMessage } from "ai";
-import { SessionComposer } from "../../composer/SessionComposer.js";
-import type { SessionHistoryComposer } from "../../composer/history/SessionHistoryComposer.js";
+import type { SessionHistoryStore } from "../../../session/store/history/SessionHistoryStore.js";
 /**
  * compaction Composer 执行输入。
  */
 export type SessionCompactionInput = {
     /**
-     * 当前会话 history Composer。
+     * 当前会话 history Store。
      */
-    historyComposer: SessionHistoryComposer;
+    historyStore: SessionHistoryStore;
     /**
      * 当前模型实例。
      */
@@ -25,22 +24,22 @@ export type SessionCompactionInput = {
      */
     system: SystemModelMessage[];
     /**
-     * 当前重试次数（由 Runner 递增）。
+     * 当前重试次数（由 Executor 递增）。
      */
     retryCount: number;
 };
 /**
- * Compaction Composer 抽象类。
+ * Compaction Composer 协议。
  */
-export declare abstract class SessionCompactionComposer extends SessionComposer {
+export interface SessionCompactionComposer {
     /**
      * Composer 名（由具体实现声明）。
      */
-    abstract readonly name: string;
+    readonly name: string;
     /**
      * 执行 compact（best-effort）。
      */
-    abstract run(input: SessionCompactionInput): Promise<{
+    run(input: SessionCompactionInput): Promise<{
         compacted: boolean;
         reason?: string;
     }>;
@@ -49,8 +48,8 @@ export declare abstract class SessionCompactionComposer extends SessionComposer
      *
      * 关键点（中文）
      * - 由 compaction Composer 实现侧维护错误识别策略。
-     * - Runner 不感知具体错误文案，只按该布尔结果决定是否重试。
+     * - Executor 不感知具体错误文案，只按该布尔结果决定是否重试。
      */
-    abstract shouldCompactOnError(error: unknown): boolean;
+    shouldCompactOnError(error: unknown): boolean;
 }
 //# sourceMappingURL=SessionCompactionComposer.d.ts.map

package/bin/session/composer/compaction/SessionCompactionComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionCompactionComposer.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/compaction/SessionCompactionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAElG;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,eAAe,EAAE,sBAAsB,CAAC;IAExC;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAE7B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,8BAAsB,yBAA0B,SAAQ,eAAe;IACrE;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC;QACnD,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;;;;;OAMG;IACH,QAAQ,CAAC,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAMvD"}
+{"version":3,"file":"SessionCompactionComposer.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/compaction/SessionCompactionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,YAAY,EAAE,mBAAmB,CAAC;IAElC;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAE7B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAC1C,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAEH;;;;;;OAMG;IACH,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;CAC/C"}

package/bin/session/composer/compaction/SessionCompactionComposer.js

@@ -3,12 +3,7 @@
  *
  * 关键点（中文）
  * - 负责“何时压缩 + 压缩策略参数”决策。
- * - 具体读写由 SessionHistoryComposer 执行（CompactionComposer 不直接落盘）。
+ * - 具体读写由 SessionHistoryStore 执行（CompactionComposer 不直接落盘）。
  */
-import { SessionComposer } from "../../composer/SessionComposer.js";
-/**
- * Compaction Composer 抽象类。
- */
-export class SessionCompactionComposer extends SessionComposer {
-}
+export {};
 //# sourceMappingURL=SessionCompactionComposer.js.map

package/bin/session/composer/compaction/SessionCompactionComposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"SessionCompactionComposer.js","sourceRoot":"","sources":["../../../../src/session/composer/compaction/SessionCompactionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AA4BvE;;GAEG;AACH,MAAM,OAAgB,yBAA0B,SAAQ,eAAe;CA2BtE"}
+{"version":3,"file":"SessionCompactionComposer.js","sourceRoot":"","sources":["../../../../src/session/composer/compaction/SessionCompactionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.d.ts

@@ -3,10 +3,9 @@
  *
  * 关键点（中文）
  * - 只负责压缩参数策略（retry 越多，窗口越紧）。
- * - 真正的读写与 compact 执行交由 history Composer。
+ * - 真正的读写与 compact 执行交由 history Store。
  */
-import type { SessionCompactionInput } from "../../../composer/compaction/SessionCompactionComposer.js";
-import { SessionCompactionComposer } from "../../../composer/compaction/SessionCompactionComposer.js";
+import type { SessionCompactionComposer, SessionCompactionInput } from "../../../composer/compaction/SessionCompactionComposer.js";
 type JsonlSessionCompactionComposerOptions = {
     keepLastMessages?: number;
     maxInputTokensApprox?: number;
@@ -16,7 +15,7 @@ type JsonlSessionCompactionComposerOptions = {
 /**
  * JsonlSessionCompactionComposer 默认实现。
  */
-export declare class JsonlSessionCompactionComposer extends SessionCompactionComposer {
+export declare class JsonlSessionCompactionComposer implements SessionCompactionComposer {
     readonly name = "summary_compaction_composer";
     private readonly options;
     constructor(options?: JsonlSessionCompactionComposerOptions);

package/bin/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JsonlSessionCompactionComposer.d.ts","sourceRoot":"","sources":["../../../../../src/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AACxG,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAEtG,KAAK,qCAAqC,GAAG;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,qBAAa,8BAA+B,SAAQ,yBAAyB;IAC3E,QAAQ,CAAC,IAAI,iCAAiC;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;gBAEpD,OAAO,CAAC,EAAE,qCAAqC;IAK3D,OAAO,CAAC,aAAa;IAsCf,GAAG,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAChD,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAYF;;;;;;OAMG;IACH,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAS9C"}
+{"version":3,"file":"JsonlSessionCompactionComposer.d.ts","sourceRoot":"","sources":["../../../../../src/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,2DAA2D,CAAC;AAEnE,KAAK,qCAAqC,GAAG;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,qBAAa,8BAA+B,YAAW,yBAAyB;IAC9E,QAAQ,CAAC,IAAI,iCAAiC;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;gBAEpD,OAAO,CAAC,EAAE,qCAAqC;IAI3D,OAAO,CAAC,aAAa;IAsCf,GAAG,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAChD,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAYF;;;;;;OAMG;IACH,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAS9C"}

package/bin/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js

@@ -3,17 +3,15 @@
  *
  * 关键点（中文）
  * - 只负责压缩参数策略（retry 越多，窗口越紧）。
- * - 真正的读写与 compact 执行交由 history Composer。
+ * - 真正的读写与 compact 执行交由 history Store。
  */
-import { SessionCompactionComposer } from "../../../composer/compaction/SessionCompactionComposer.js";
 /**
  * JsonlSessionCompactionComposer 默认实现。
  */
-export class JsonlSessionCompactionComposer extends SessionCompactionComposer {
+export class JsonlSessionCompactionComposer {
     name = "summary_compaction_composer";
     options;
     constructor(options) {
-        super();
         this.options = options || {};
     }
     resolvePolicy(retryCount) {
@@ -43,7 +41,7 @@ export class JsonlSessionCompactionComposer extends SessionCompactionComposer {
     }
     async run(input) {
         const policy = this.resolvePolicy(input.retryCount);
-        return await input.historyComposer.compact({
+        return await input.historyStore.compact({
             model: input.model,
             system: input.system,
             keepLastMessages: policy.keepLastMessages,

package/bin/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"JsonlSessionCompactionComposer.js","sourceRoot":"","sources":["../../../../../src/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"JsonlSessionCompactionComposer.js","sourceRoot":"","sources":["../../../../../src/session/composer/compaction/jsonl/JsonlSessionCompactionComposer.ts"],"names":[],"mappings":"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"}

package/bin/session/composer/{execution/LocalSessionExecutionComposer.d.ts → context/LocalSessionContextComposer.d.ts}

@@ -1,17 +1,16 @@
 /**
- * LocalSessionExecutionComposer：本地 session 运行时编排 Composer 实现。
+ * LocalSessionContextComposer：本地 session 运行时编排 Composer 实现。
  *
  * 关键点（中文）
  * - 统一组装 tools。
- * - step 边界回调从 SessionRunScope 读取，Runner 不直接管理来源。
+ * - step 边界回调从 SessionRunScope 读取，Executor 不直接管理来源。
  */
 import type { ModelMessage } from "ai";
-import { SessionExecutionComposer } from "../../composer/execution/SessionExecutionComposer.js";
-import type { SessionExecutionComposeResult } from "../../composer/execution/SessionExecutionComposer.js";
+import type { SessionContextComposer, SessionContextComposeResult } from "../../composer/context/SessionContextComposer.js";
 import type { SessionMessageV1 } from "../../../session/types/SessionMessages.js";
 import type { SessionSystemMessage } from "../../../session/types/SessionPrompts.js";
 import type { Tool } from "ai";
-type LocalSessionExecutionComposerOptions = {
+type LocalSessionContextComposerOptions = {
     /**
      * 可选默认 session id。
      */
@@ -22,14 +21,14 @@ type LocalSessionExecutionComposerOptions = {
     getTools: () => Record<string, Tool>;
 };
 /**
- * LocalSessionExecutionComposer 默认 Composer 实现。
+ * LocalSessionContextComposer 默认 Composer 实现。
  */
-export declare class LocalSessionExecutionComposer extends SessionExecutionComposer {
-    readonly name = "runtime_execution_composer";
+export declare class LocalSessionContextComposer implements SessionContextComposer {
+    readonly name = "runtime_context_composer";
     private readonly sessionId;
     private readonly getTools;
-    constructor(options: LocalSessionExecutionComposerOptions);
-    compose(): Promise<SessionExecutionComposeResult>;
+    constructor(options: LocalSessionContextComposerOptions);
+    compose(): Promise<SessionContextComposeResult>;
     createPrepareStepHandler(input: {
         system: SessionSystemMessage[];
         appendMergedUserMessages: (messages: SessionMessageV1[]) => Promise<ModelMessage[]>;
@@ -46,4 +45,4 @@ export declare class LocalSessionExecutionComposer extends SessionExecutionCompo
     buildFallbackAssistantMessage(text: string): SessionMessageV1;
 }
 export {};
-//# sourceMappingURL=LocalSessionExecutionComposer.d.ts.map
+//# sourceMappingURL=LocalSessionContextComposer.d.ts.map

package/bin/session/composer/context/LocalSessionContextComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSessionContextComposer.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/context/LocalSessionContextComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAMvC,OAAO,KAAK,EACV,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,qDAAqD,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B,KAAK,kCAAkC,GAAG;IACxC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,qBAAa,2BAA4B,YAAW,sBAAsB;IACxE,QAAQ,CAAC,IAAI,8BAA8B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;gBAE9D,OAAO,EAAE,kCAAkC;IAKjD,OAAO,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAkBrD,wBAAwB,CACtB,KAAK,EAAE;QACL,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,wBAAwB,EAAE,CACxB,QAAQ,EAAE,gBAAgB,EAAE,KACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;KAC9B,GACA,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QACnD,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC;IA+CF,yBAAyB,IAAI,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC;IAqBnE;;OAEG;IACH,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;CAqB9D"}

package/bin/session/composer/{execution/LocalSessionExecutionComposer.js → context/LocalSessionContextComposer.js}

@@ -1,22 +1,20 @@
 /**
- * LocalSessionExecutionComposer：本地 session 运行时编排 Composer 实现。
+ * LocalSessionContextComposer：本地 session 运行时编排 Composer 实现。
  *
  * 关键点（中文）
  * - 统一组装 tools。
- * - step 边界回调从 SessionRunScope 读取，Runner 不直接管理来源。
+ * - step 边界回调从 SessionRunScope 读取，Executor 不直接管理来源。
  */
 import { generateId } from "../../../utils/Id.js";
 import { drainInjectedUserMessages, getSessionRunScope, } from "../../SessionRunScope.js";
-import { SessionExecutionComposer } from "../../composer/execution/SessionExecutionComposer.js";
 /**
- * LocalSessionExecutionComposer 默认 Composer 实现。
+ * LocalSessionContextComposer 默认 Composer 实现。
  */
-export class LocalSessionExecutionComposer extends SessionExecutionComposer {
-    name = "runtime_execution_composer";
+export class LocalSessionContextComposer {
+    name = "runtime_context_composer";
     sessionId;
     getTools;
     constructor(options) {
-        super();
         this.sessionId = String(options.sessionId || "").trim();
         this.getTools = options.getTools;
     }
@@ -25,7 +23,7 @@ export class LocalSessionExecutionComposer extends SessionExecutionComposer {
         const ctx = getSessionRunScope();
         const sessionId = String(ctx?.sessionId || this.sessionId || "").trim();
         if (!sessionId) {
-            throw new Error("LocalSessionExecutionComposer.compose requires a sessionId from sessionRunScope or options.sessionId");
+            throw new Error("LocalSessionContextComposer.compose requires a sessionId from sessionRunScope or options.sessionId");
         }
         // 关键点（中文）：sessionId 统一回填到请求上下文，后续组件直接读取。
         if (ctx && typeof ctx === "object") {
@@ -98,7 +96,7 @@ export class LocalSessionExecutionComposer extends SessionExecutionComposer {
         const ctx = getSessionRunScope();
         const sessionId = String(ctx?.sessionId || this.sessionId || "").trim();
         if (!sessionId) {
-            throw new Error("LocalSessionExecutionComposer.buildFallbackAssistantMessage requires a sessionId from sessionRunScope or options.sessionId");
+            throw new Error("LocalSessionContextComposer.buildFallbackAssistantMessage requires a sessionId from sessionRunScope or options.sessionId");
         }
         return {
             id: `a:${sessionId}:${generateId()}`,
@@ -114,4 +112,4 @@ export class LocalSessionExecutionComposer extends SessionExecutionComposer {
         };
     }
 }
-//# sourceMappingURL=LocalSessionExecutionComposer.js.map
+//# sourceMappingURL=LocalSessionContextComposer.js.map

package/bin/session/composer/context/LocalSessionContextComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSessionContextComposer.js","sourceRoot":"","sources":["../../../../src/session/composer/context/LocalSessionContextComposer.ts"],"names":[],"mappings":"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"}

package/bin/session/composer/{execution/SessionExecutionComposer.d.ts → context/SessionContextComposer.d.ts}

@@ -1,39 +1,38 @@
 /**
- * SessionExecutionComposer：单次 Session run 编排 Composer 抽象。
+ * SessionContextComposer：单次 Session run context 组装协议。
  *
  * 关键点（中文）
- * - 负责 tools/onStepCallback 等运行时编排。
+ * - 负责 tools / prepareStep / onStepFinish / fallback message factory 等运行上下文组装。
  * - 不负责历史读写，不负责 system 解析，不负责 compact。
  */
 import type { ModelMessage, Tool } from "ai";
 import type { SessionMessageV1 } from "../../../session/types/SessionMessages.js";
 import type { SessionSystemMessage } from "../../../session/types/SessionPrompts.js";
-import { SessionComposer } from "../../composer/SessionComposer.js";
 /**
- * 本轮运行编排输出。
+ * 本轮运行上下文组装输出。
  */
-export type SessionExecutionComposeResult = {
+export type SessionContextComposeResult = {
     /**
      * 本轮工具集合。
      */
     tools: Record<string, Tool>;
 };
 /**
- * 运行编排 Composer 抽象类。
+ * 运行上下文 Composer 协议。
  */
-export declare abstract class SessionExecutionComposer extends SessionComposer {
+export interface SessionContextComposer {
     /**
      * Composer 名（由具体实现声明）。
      */
-    abstract readonly name: string;
+    readonly name: string;
     /**
-     * 组装一次 run 所需运行态。
+     * 组装一次 run 所需上下文。
      */
-    abstract compose(): Promise<SessionExecutionComposeResult>;
+    compose(): Promise<SessionContextComposeResult>;
     /**
      * 构造 prepareStep 回调。
      */
-    abstract createPrepareStepHandler(input: {
+    createPrepareStepHandler(input: {
         /**
          * 当前轮 system 消息。
          */
@@ -51,13 +50,13 @@ export declare abstract class SessionExecutionComposer extends SessionComposer {
     /**
      * 构造 onStepFinish 回调。
      */
-    abstract createOnStepFinishHandler(): (stepResult: unknown) => Promise<void>;
+    createOnStepFinishHandler(): (stepResult: unknown) => Promise<void>;
     /**
      * 构造 fallback assistant 消息。
      *
      * 关键点（中文）
-   * - fallback 消息构造由 execution Composer 内部实现，Runner 不直接依赖 history Composer。
+     * - fallback 消息构造由 ContextComposer 内部实现，Executor 不直接依赖 history Composer。
      */
-    abstract buildFallbackAssistantMessage(text: string): SessionMessageV1;
+    buildFallbackAssistantMessage(text: string): SessionMessageV1;
 }
-//# sourceMappingURL=SessionExecutionComposer.d.ts.map
+//# sourceMappingURL=SessionContextComposer.d.ts.map

package/bin/session/composer/context/SessionContextComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionContextComposer.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/context/SessionContextComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAEhD;;OAEG;IACH,wBAAwB,CACtB,KAAK,EAAE;QACL;;WAEG;QACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B;;WAEG;QACH,wBAAwB,EAAE,CACxB,QAAQ,EAAE,gBAAgB,EAAE,KACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;KAC9B,GACA,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QACnD,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC,CAAC;IAEH;;OAEG;IACH,yBAAyB,IAAI,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;;OAKG;IACH,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;CAC/D"}

package/bin/session/composer/context/SessionContextComposer.js

@@ -0,0 +1,9 @@
+/**
+ * SessionContextComposer：单次 Session run context 组装协议。
+ *
+ * 关键点（中文）
+ * - 负责 tools / prepareStep / onStepFinish / fallback message factory 等运行上下文组装。
+ * - 不负责历史读写，不负责 system 解析，不负责 compact。
+ */
+export {};
+//# sourceMappingURL=SessionContextComposer.js.map

package/bin/session/composer/context/SessionContextComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionContextComposer.js","sourceRoot":"","sources":["../../../../src/session/composer/context/SessionContextComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/session/composer/history/SessionHistoryComposer.d.ts

@@ -2,13 +2,13 @@
  * SessionHistoryComposer：会话历史 Composer 抽象。
  *
  * 关键点（中文）
- * - 负责“历史读写 + 运行输入准备 + 文本消息工厂”。
+ * - 负责把历史事实源组装成本轮模型输入消息。
+ * - 不负责 append / list / meta / archive 等落盘能力。
  * - 不负责模型调用，不负责执行编排。
  */
 import type { LanguageModel, Tool } from "ai";
-import type { SessionMessageV1, SessionMetadataV1 } from "../../../session/types/SessionMessages.js";
+import type { SessionMessageV1 } from "../../../session/types/SessionMessages.js";
 import type { SessionSystemMessage } from "../../../session/types/SessionPrompts.js";
-import { SessionComposer } from "../../composer/SessionComposer.js";
 /**
  * prepare 输入参数。
  */
@@ -30,127 +30,25 @@ export type SessionHistoryPrepareInput = {
      */
     model: LanguageModel;
     /**
-     * 当前重试次数（由 Runner 递增）。
+     * 当前重试次数（由 Executor 递增）。
      */
     retryCount: number;
 };
 /**
- * compact 输入参数。
+ * SessionHistoryComposer 协议。
  */
-export type SessionHistoryCompactInput = {
-    /**
-     * 当前模型实例。
-     */
-    model: LanguageModel;
-    /**
-     * 当前轮 system messages。
-     */
-    system: SessionSystemMessage[];
-    /**
-     * 保留最近消息条数。
-     */
-    keepLastMessages: number;
-    /**
-     * 输入 token 近似上限。
-     */
-    maxInputTokensApprox: number;
-    /**
-     * compact 时是否归档旧消息。
-     */
-    archiveOnCompact: boolean;
-    /**
-     * 前段压缩比例（0-1）。
-     *
-     * 关键点（中文）
-     * - 例如 0.5 表示“优先压缩最早 50% 的 UIMessage”。
-     * - 具体切分由 history Composer 实现侧做边界校正。
-     */
-    compactRatio: number;
-};
-/**
- * SessionHistoryComposer 抽象类。
- */
-export declare abstract class SessionHistoryComposer extends SessionComposer {
+export interface SessionHistoryComposer {
     /**
      * Composer 名（由具体实现声明）。
      */
-    abstract readonly name: string;
+    readonly name: string;
     /**
      * 当前会话 ID。
      */
-    abstract readonly sessionId: string;
+    readonly sessionId: string;
     /**
      * 为本轮 Session 执行准备模型输入消息。
      */
-    abstract prepare(input: SessionHistoryPrepareInput): Promise<SessionMessageV1[]>;
-    /**
-     * 执行一次 compact（best-effort）。
-     */
-    abstract compact(input: SessionHistoryCompactInput): Promise<{
-        compacted: boolean;
-        reason?: string;
-    }>;
-    /**
-     * 追加一条消息到历史。
-     */
-    abstract append(message: SessionMessageV1): Promise<void>;
-    /**
-     * 读取完整消息历史。
-     */
-    abstract list(): Promise<SessionMessageV1[]>;
-    /**
-     * 读取消息区间 [start, end)。
-     */
-    abstract slice(start: number, end: number): Promise<SessionMessageV1[]>;
-    /**
-     * 读取消息总条数。
-     */
-    abstract size(): Promise<number>;
-    /**
-     * 读取元信息。
-     */
-    abstract meta(): Promise<Record<string, unknown>>;
-    /**
-     * 构造 user 文本消息。
-     */
-    abstract userText(input: {
-        /**
-         * 用户文本内容。
-         */
-        text: string;
-        /**
-         * 消息元信息（除 schema 字段）。
-         */
-        metadata: Omit<SessionMetadataV1, "v" | "ts"> & Partial<Pick<SessionMetadataV1, "ts">>;
-        /**
-         * 可选消息 ID（默认自动生成）。
-         */
-        id?: string;
-    }): SessionMessageV1;
-    /**
-     * 构造 assistant 文本消息。
-     */
-    abstract assistantText(input: {
-        /**
-         * 助手文本内容。
-         */
-        text: string;
-        /**
-         * 消息元信息（除 schema 字段）。
-         */
-        metadata: Omit<SessionMetadataV1, "v" | "ts"> & Partial<Pick<SessionMetadataV1, "ts">>;
-        /**
-         * 可选消息 ID（默认自动生成）。
-         */
-        id?: string;
-        /**
-         * 消息种类（普通/摘要）。
-         */
-        kind?: "normal" | "summary";
-        /**
-         * 消息来源（egress/compact）。
-         */
-        source?: "egress" | "compact";
-    }): SessionMessageV1;
+    prepare(input: SessionHistoryPrepareInput): Promise<SessionMessageV1[]>;
 }
 //# sourceMappingURL=SessionHistoryComposer.d.ts.map

package/bin/session/composer/history/SessionHistoryComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionHistoryComposer.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/history/SessionHistoryComposer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SessionHistoryComposer.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/history/SessionHistoryComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACzE"}

package/bin/session/composer/history/SessionHistoryComposer.js

@@ -2,13 +2,9 @@
  * SessionHistoryComposer：会话历史 Composer 抽象。
  *
  * 关键点（中文）
- * - 负责“历史读写 + 运行输入准备 + 文本消息工厂”。
+ * - 负责把历史事实源组装成本轮模型输入消息。
+ * - 不负责 append / list / meta / archive 等落盘能力。
  * - 不负责模型调用，不负责执行编排。
  */
-import { SessionComposer } from "../../composer/SessionComposer.js";
-/**
- * SessionHistoryComposer 抽象类。
- */
-export class SessionHistoryComposer extends SessionComposer {
-}
+export {};
 //# sourceMappingURL=SessionHistoryComposer.js.map

package/bin/session/composer/history/SessionHistoryComposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"SessionHistoryComposer.js","sourceRoot":"","sources":["../../../../src/session/composer/history/SessionHistoryComposer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAuEvE;;GAEG;AACH,MAAM,OAAgB,sBAAuB,SAAQ,eAAe;CAyGnE"}
+{"version":3,"file":"SessionHistoryComposer.js","sourceRoot":"","sources":["../../../../src/session/composer/history/SessionHistoryComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/session/composer/history/SessionHistoryWriter.d.ts

@@ -3,21 +3,21 @@
  *
  * 关键点（中文）
  * - 只负责当前 session 的 user / assistant 消息补写。
- * - 只依赖当前 session 的 history Composer，不感知其他 session。
+ * - 只依赖当前 session 的 history Store，不感知其他 session。
  * - 会话更新后的通知也收在这里，避免把写入细节散到 Session 主类里。
  */
 import type { JsonObject } from "../../../types/common/Json.js";
 import type { SessionMessageV1 } from "../../../session/types/SessionMessages.js";
-import type { SessionHistoryComposer } from "../../composer/history/SessionHistoryComposer.js";
+import type { SessionHistoryStore } from "../../../session/store/history/SessionHistoryStore.js";
 type SessionHistoryWriterOptions = {
     /**
      * 当前 session 标识。
      */
     sessionId: string;
     /**
-     * 获取当前 session 对应的 history Composer。
+     * 获取当前 session 对应的 history Store。
      */
-    getHistoryComposer: () => SessionHistoryComposer;
+    getHistoryStore: () => SessionHistoryStore;
     /**
      * session 更新后的异步回调。
      */
@@ -28,7 +28,7 @@ type SessionHistoryWriterOptions = {
  */
 export declare class SessionHistoryWriter {
     private readonly sessionId;
-    private readonly getHistoryComposer;
+    private readonly getHistoryStore;
     private readonly runAfterSessionUpdated?;
     constructor(options: SessionHistoryWriterOptions);
     /**

package/bin/session/composer/history/SessionHistoryWriter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionHistoryWriter.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/history/SessionHistoryWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAElG,KAAK,2BAA2B,GAAG;IACjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;IAEjD;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoD;IACvF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAwD;gBAEpF,OAAO,EAAE,2BAA2B;IAShD;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/C;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC9B,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BjB;;OAEG;IACG,sBAAsB,CAAC,MAAM,EAAE;QACnC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;CA4BlB"}
+{"version":3,"file":"SessionHistoryWriter.d.ts","sourceRoot":"","sources":["../../../../src/session/composer/history/SessionHistoryWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAE1F,KAAK,2BAA2B,GAAG;IACjC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,eAAe,EAAE,MAAM,mBAAmB,CAAC;IAE3C;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,CAAC;AAEF;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiD;IACjF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAwD;gBAEpF,OAAO,EAAE,2BAA2B;IAShD;;OAEG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/C;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC9B,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BjB;;OAEG;IACG,sBAAsB,CAAC,MAAM,EAAE;QACnC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;QAClC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;CA4BlB"}