@downcity/agent 1.1.430 → 1.1.437

package/bin/types/session/SessionComposer.d.ts

@@ -1,36 +1,36 @@
 /**
  * Session Composer 类型。
  *
- * Composer 是自定义 Session 的执行策略边界：它只读取 Session 的只读快照，
- * 负责组装模型输入和生成压缩计划，不持久化 Message、Metadata 或事件。
+ * Composer 是最终模型输入的唯一生成者：它组合运行快照、canonical history 与内部
+ * Context Policy；不拥有 Message、Turn 或数据库连接生命周期。
  */
-import type { ModelClient, ModelMessage } from "@downcity/type";
-import type { RuntimeTool as Tool } from "@downcity/type";
+import type { ModelClient, ModelMessage, RuntimeTool as Tool } from "@downcity/type";
 import type { SessionSystemMessage } from "../../executor/types/SessionPrompts.js";
 import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js";
-import type { SessionContextSnapshot, SessionSegmentSummary } from "../../types/session/SessionSegment.js";
 import type { SessionHookContextBlock } from "@downcity/type";
 import type { ModelRequestFailureReporter } from "../../types/executor/ModelRequest.js";
+import type { SessionStorage } from "../../types/store/SessionStorage.js";
+import type { SessionContextRecoveryReason, SessionResolvedContextDiagnostics } from "../../types/session/SessionContextPolicy.js";
 /** Composer 可读取的 Session 身份快照。 */
 export interface SessionComposeIdentity {
     /** 当前 Agent 的稳定标识。 */
     agent_id: string;
     /** 当前 Session 的稳定标识。 */
     session_id: string;
-    /** 当前 Agent 项目的绝对根目录。 */
+    /** 当前 Workspace 的绝对根目录。 */
     project_root: string;
-    /** 当前 Session 的创建时间戳，单位为毫秒。 */
+    /** 当前 Session 的创建时间戳。 */
     created_at: number;
     /** 当前 Session 使用的参考时区。 */
     timezone: string;
 }
 /** Composer 可读取的当前 Step 生效状态。 */
 export interface SessionComposeState {
-    /** 当前 Step 使用的模型实例；只读查询允许为空。 */
+    /** 当前 Step 使用的模型实例。 */
     model?: ModelClient;
-    /** 当前模型声明的上下文窗口，单位为 token。 */
+    /** 当前模型声明的上下文窗口。 */
     model_context_window?: number;
-    /** 当前 Step 生效的 Agent 环境变量快照。 */
+    /** 当前 Step 生效的 Workspace 环境变量。 */
     env: Readonly<Record<string, string>>;
     /** 当前 Step 生效的 Agent instruction 文本。 */
     systems: readonly string[];
@@ -38,71 +38,71 @@ export interface SessionComposeState {
     tools: Readonly<Record<string, Tool>>;
     /** 当前 Step 生效的 instruction system blocks。 */
     instruction_system_blocks: readonly AgentSessionSystemBlock[];
-    /** 当前 Session 由宿主注入的受托管 Plugin system blocks。 */
+    /** 宿主注入的受托管 Plugin system blocks。 */
     managed_plugin_system_blocks: readonly AgentSessionSystemBlock[];
     /** 当前 Step 捕获的 Plugin system blocks。 */
     plugin_system_blocks: readonly AgentSessionSystemBlock[];
-    /** 当前 Turn 首次解析后复用、只进入模型输入副本的 Plugin 动态上下文。 */
+    /** 当前 Turn 冻结的 Plugin 动态上下文。 */
     plugin_context_blocks: readonly SessionHookContextBlock[];
 }
 /** Composer 可读取的当前 Turn 快照。 */
 export interface SessionComposeTurn {
-    /** 当前 Turn 标识；只读查询场景允许为空。 */
+    /** 当前 Turn 标识；只读查询时允许为空。 */
     turn_id?: string;
-    /** 当前执行因上下文超限而进行的重试次数。 */
+    /** 当前执行已进行的上下文恢复次数。 */
     retry_count: number;
 }
+/** Composer 初始化输入。 */
+export interface SessionComposerInitializeInput {
+    /** 当前 Session 的统一持久化边界。 */
+    storage: SessionStorage;
+}
 /** 单次模型输入组装参数。 */
 export interface SessionComposeInput {
     /** 当前 Session 身份快照。 */
     session: SessionComposeIdentity;
     /** 当前 Step 已生效的运行状态。 */
     state: SessionComposeState;
-    /** 当前 Session 的累计 Summary 与 Active Message 快照。 */
-    history: Readonly<SessionContextSnapshot>;
+    /** 当前 Session 的统一持久化边界。 */
+    storage: SessionStorage;
     /** 当前 Turn 快照。 */
     turn: SessionComposeTurn;
 }
+/** 上下文超限后的恢复输入。 */
+export interface SessionContextRecoveryInput {
+    /** 当前 Session 身份快照。 */
+    session: SessionComposeIdentity;
+    /** 当前 Session 使用的模型。 */
+    model?: ModelClient;
+    /** 当前 Session 的统一持久化边界。 */
+    storage: SessionStorage;
+    /** 触发当前恢复的稳定领域原因。 */
+    reason: SessionContextRecoveryReason;
+    /** 模型请求逐次失败的可选观测入口。 */
+    on_model_request_failure?: ModelRequestFailureReporter;
+}
 /** Composer 为一次模型 Step 生成的完整输入。 */
 export interface SessionStepInput {
     /** 当前 Step 的 system messages。 */
     system: SessionSystemMessage[];
-    /** 当前 Step 的可解释 system block；自定义 Composer 可以省略。 */
+    /** 当前 Step 的可解释 system blocks。 */
     system_blocks?: AgentSessionSystemBlock[];
     /** 当前 Step 已转换完成的标准模型消息。 */
     messages: ModelMessage[];
     /** 当前 Step 可调用的工具集合。 */
     tools: Record<string, Tool>;
+    /** 本次上下文策略诊断。 */
+    context_diagnostics?: SessionResolvedContextDiagnostics;
 }
-/** 持久化上下文压缩所需的最小只读输入。 */
-export interface SessionCompactionInput {
-    /** 当前 Session 的稳定身份快照。 */
-    session: SessionComposeIdentity;
-    /** 当前 Session 实际使用的模型；只读或未配置场景允许为空。 */
-    model?: ModelClient;
-    /** 当前 Session 的累计 Summary 与 Active Message 快照。 */
-    history: Readonly<SessionContextSnapshot>;
-    /** 可选的模型请求逐次失败通知入口。 */
-    on_model_request_failure?: ModelRequestFailureReporter;
-}
-/** Composer 生成、等待 SessionMessages 提交的压缩计划。 */
-export interface SessionCompactionPlan {
-    /** Active 中最后一条需要移入 Segment 的 Message sequence。 */
-    through_sequence: number;
-    /** 新 Segment 使用的累计 Summary。 */
-    summary: SessionSegmentSummary;
-    /** 当前计划覆盖到的最后一条 Message 标识。 */
-    boundary_message_id: string;
-}
-/** Session 级可替换执行策略。 */
+/** Session 级可替换 Composer。 */
 export interface SessionComposer {
     /** Composer 的稳定可读名称。 */
     readonly name: string;
-    /** 组装一次模型 Step 使用的 system、history 与 tools。 */
+    /** 初始化 Composer 及其内部 Policy。 */
+    initialize(input: SessionComposerInitializeInput): Promise<void>;
+    /** 组装一次模型 Step 使用的最终输入。 */
     compose(input: SessionComposeInput): Promise<SessionStepInput>;
-    /** 根据只读历史生成压缩计划；无需压缩时返回空。 */
-    compact(input: SessionCompactionInput): Promise<SessionCompactionPlan | null>;
-    /** 判断给定错误是否应在持久化压缩后重试。 */
-    should_compact(error: unknown): boolean;
+    /** 尝试推进上下文派生状态；有效推进时返回 true。 */
+    recover_context(input: SessionContextRecoveryInput): Promise<boolean>;
 }
 //# sourceMappingURL=SessionComposer.d.ts.map

package/bin/types/session/SessionComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionComposer.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionComposer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AACvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAEpF,kCAAkC;AAClC,MAAM,WAAW,sBAAsB;IACrC,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,iCAAiC;AACjC,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8BAA8B;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gCAAgC;IAChC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtC,wCAAwC;IACxC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,wBAAwB;IACxB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACtC,6CAA6C;IAC7C,yBAAyB,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC9D,iDAAiD;IACjD,4BAA4B,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACjE,wCAAwC;IACxC,oBAAoB,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACzD,+CAA+C;IAC/C,qBAAqB,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC3D;AAED,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,kBAAkB;AAClB,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,OAAO,EAAE,sBAAsB,CAAC;IAChC,wBAAwB;IACxB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,kDAAkD;IAClD,OAAO,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IAC1C,kBAAkB;IAClB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,mDAAmD;IACnD,aAAa,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC1C,4BAA4B;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC7B;AAED,yBAAyB;AACzB,MAAM,WAAW,sBAAsB;IACrC,0BAA0B;IAC1B,OAAO,EAAE,sBAAsB,CAAC;IAChC,uCAAuC;IACvC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kDAAkD;IAClD,OAAO,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IAC1C,uBAAuB;IACvB,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;CACxD;AAED,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,+BAA+B;IAC/B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAwB;AACxB,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,8CAA8C;IAC9C,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE/D,6BAA6B;IAC7B,OAAO,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IAE9E,0BAA0B;IAC1B,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;CACzC"}
+{"version":3,"file":"SessionComposer.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionComposer.ts"],"names":[],"mappings":"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"}

package/bin/types/session/SessionComposer.js

@@ -1,8 +1,8 @@
 /**
  * Session Composer 类型。
  *
- * Composer 是自定义 Session 的执行策略边界：它只读取 Session 的只读快照，
- * 负责组装模型输入和生成压缩计划，不持久化 Message、Metadata 或事件。
+ * Composer 是最终模型输入的唯一生成者：它组合运行快照、canonical history 与内部
+ * Context Policy；不拥有 Message、Turn 或数据库连接生命周期。
  */
 export {};
 //# sourceMappingURL=SessionComposer.js.map

package/bin/types/session/SessionComposition.d.ts

@@ -7,8 +7,7 @@
 import type { ModelClient, RuntimeTool as Tool } from "@downcity/type";
 import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js";
 import type { SessionOrigin } from "@downcity/type";
-import type { SessionDataStore } from "../../types/store/SessionDataStore.js";
-import type { SessionMessages } from "../../session/SessionMessages.js";
+import type { SessionStorage } from "../../types/store/SessionStorage.js";
 import type { SessionHookRuntime } from "@downcity/type";
 import type { SessionComposer } from "../../types/session/SessionComposer.js";
 import type { Logger } from "../../utils/logger/Logger.js";
@@ -23,9 +22,7 @@ export interface SessionCompositionOptions {
     /** 当前 Session 使用的 Workspace 绝对根目录。 */
     workspace_path: string;
     /** 当前 Session 的领域持久化视图。 */
-    store: SessionDataStore;
-    /** canonical Message 唯一事实源。 */
-    messages: SessionMessages;
+    store: SessionStorage;
     /** 当前 Session 使用的统一 Composer。 */
     composer: SessionComposer;
     /** 在每个 Step 检查点读取当前可用 Tool 集合。 */

package/bin/types/session/SessionComposition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionComposition.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionComposition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,+BAA+B;AAC/B,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,cAAc,EAAE,aAAa,CAAC;IAC9B,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,KAAK,EAAE,gBAAgB,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,eAAe,CAAC;IAC1B,kCAAkC;IAClC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,mDAAmD;IACnD,yBAAyB,EAAE,uBAAuB,EAAE,CAAC;IACrD,0DAA0D;IAC1D,6BAA6B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAC/D,sCAAsC;IACtC,SAAS,EAAE,MAAM,kBAAkB,CAAC;IACpC,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,yCAAyC;IACzC,gCAAgC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC3E,4BAA4B;IAC5B,SAAS,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACzC,sBAAsB;IACtB,wBAAwB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACnD,2BAA2B;IAC3B,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,0BAA0B;IAC1B,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"SessionComposition.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionComposition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,+BAA+B;AAC/B,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,cAAc,EAAE,aAAa,CAAC;IAC9B,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,KAAK,EAAE,cAAc,CAAC;IACtB,iCAAiC;IACjC,QAAQ,EAAE,eAAe,CAAC;IAC1B,kCAAkC;IAClC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,mDAAmD;IACnD,yBAAyB,EAAE,uBAAuB,EAAE,CAAC;IACrD,0DAA0D;IAC1D,6BAA6B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAC/D,sCAAsC;IACtC,SAAS,EAAE,MAAM,kBAAkB,CAAC;IACpC,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,yCAAyC;IACzC,gCAAgC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC3E,4BAA4B;IAC5B,SAAS,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACzC,sBAAsB;IACtB,wBAAwB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACnD,2BAA2B;IAC3B,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,0BAA0B;IAC1B,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/bin/types/session/SessionContextPolicy.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Session Composer 的上下文策略协议。
+ *
+ * Policy 只读取 canonical Message，并在自己的命名空间维护可删除、可重建的派生数据；
+ * 它不修改 Session Message、State 或 Turn 生命周期。
+ */
+import type { ModelClient, ModelMessage, SessionSystemBlock } from "@downcity/type";
+import type { ModelRequestFailureReporter } from "../../types/executor/ModelRequest.js";
+import type { SessionComposerStorage } from "../../types/store/SessionStorage.js";
+/** Composer 可以处理的上下文恢复原因。 */
+export type SessionContextRecoveryReason = 
+/** Provider 明确拒绝超出上下文窗口的请求。 */
+"provider_context_limit"
+/** Provider usage 已达到主动压缩阈值。 */
+ | "usage_pressure";
+/** Policy 初始化输入。 */
+export interface SessionContextPolicyInitializeInput {
+    /** 当前 Policy 已限定命名空间的派生存储。 */
+    storage: SessionComposerStorage;
+}
+/** Policy 正常解析上下文的输入。 */
+export interface SessionContextPolicyInput {
+    /** 当前 Policy 已限定命名空间的派生存储。 */
+    storage: SessionComposerStorage;
+    /** 解析文件 Part 时使用的 Workspace 根目录。 */
+    project_root: string;
+}
+/** 上下文恢复输入。 */
+export interface SessionContextPolicyRecoveryInput extends SessionContextPolicyInput {
+    /** 触发当前恢复的稳定领域原因。 */
+    reason: SessionContextRecoveryReason;
+    /** 用于生成派生摘要的当前模型。 */
+    model?: ModelClient;
+    /** 模型请求逐次失败的可选观测入口。 */
+    on_model_request_failure?: ModelRequestFailureReporter;
+}
+/** Policy 对本次模型上下文的只读诊断。 */
+export interface SessionResolvedContextDiagnostics {
+    /** 生成当前上下文的 Policy 名称。 */
+    policy_name: string;
+    /** 当前上下文覆盖到的最新 canonical Message sequence。 */
+    through_sequence?: number;
+    /** 当前派生边界在 Message 内覆盖到的 Part sequence。 */
+    through_part_sequence?: number;
+    /** 当前上下文是否使用了派生摘要或检索结果。 */
+    derived: boolean;
+    /** 当前使用的可选派生记录标识。 */
+    derivation_id?: string;
+}
+/** Policy 已确定顺序的最终模型历史。 */
+export interface SessionResolvedContext {
+    /** 送入模型的标准历史消息。 */
+    messages: ModelMessage[];
+    /** 由 Policy 生成、且不伪装成普通历史消息的显式 system 上下文。 */
+    system_blocks?: SessionSystemBlock[];
+    /** 不进入 canonical history 的策略诊断。 */
+    diagnostics: SessionResolvedContextDiagnostics;
+}
+/** Session Composer 内部可替换的上下文策略。 */
+export interface SessionContextPolicy {
+    /** Policy 稳定名称，同时作为派生表命名空间。 */
+    readonly name: string;
+    /** 初始化当前 Policy 的派生 schema。 */
+    initialize(input: SessionContextPolicyInitializeInput): Promise<void>;
+    /** 从 canonical history 与派生数据生成模型历史。 */
+    resolve(input: SessionContextPolicyInput): Promise<SessionResolvedContext>;
+    /** 模型上下文失败后尝试推进派生状态；发生有效变化时返回 true。 */
+    recover(input: SessionContextPolicyRecoveryInput): Promise<boolean>;
+}
+//# sourceMappingURL=SessionContextPolicy.d.ts.map

package/bin/types/session/SessionContextPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionContextPolicy.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E,6BAA6B;AAC7B,MAAM,MAAM,4BAA4B;AACtC,+BAA+B;AAC7B,wBAAwB;AAC1B,gCAAgC;GAC9B,gBAAgB,CAAC;AAErB,oBAAoB;AACpB,MAAM,WAAW,mCAAmC;IAClD,8BAA8B;IAC9B,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED,yBAAyB;AACzB,MAAM,WAAW,yBAAyB;IACxC,8BAA8B;IAC9B,OAAO,EAAE,sBAAsB,CAAC;IAChC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAe;AACf,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF,qBAAqB;IACrB,MAAM,EAAE,4BAA4B,CAAC;IACrC,qBAAqB;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,uBAAuB;IACvB,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;CACxD;AAED,4BAA4B;AAC5B,MAAM,WAAW,iCAAiC;IAChD,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,2BAA2B;AAC3B,MAAM,WAAW,sBAAsB;IACrC,mBAAmB;IACnB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACrC,mCAAmC;IACnC,WAAW,EAAE,iCAAiC,CAAC;CAChD;AAED,oCAAoC;AACpC,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,UAAU,CAAC,KAAK,EAAE,mCAAmC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,uCAAuC;IACvC,OAAO,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC3E,uCAAuC;IACvC,OAAO,CAAC,KAAK,EAAE,iCAAiC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE"}

package/bin/types/session/SessionContextPolicy.js

@@ -0,0 +1,8 @@
+/**
+ * Session Composer 的上下文策略协议。
+ *
+ * Policy 只读取 canonical Message，并在自己的命名空间维护可删除、可重建的派生数据；
+ * 它不修改 Session Message、State 或 Turn 生命周期。
+ */
+export {};
+//# sourceMappingURL=SessionContextPolicy.js.map

package/bin/types/session/SessionContextPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionContextPolicy.js","sourceRoot":"","sources":["../../../src/types/session/SessionContextPolicy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/bin/types/session/SessionExecution.d.ts

@@ -6,8 +6,7 @@
  * - `SessionStepExecutionInput` 表示 Executor 通过 Composer 装配后的 Step 输入。
  * - 输出只返回执行结果；Assistant Message 通过显式输出端口写入唯一事实源。
  */
-import type { ModelMessage, RuntimeTool as Tool } from "@downcity/type";
-import type { SessionUserMessage } from "@downcity/type";
+import type { ModelClient, ModelMessage, RuntimeTool as Tool } from "@downcity/type";
 import type { SessionSystemMessage } from "../../executor/types/SessionPrompts.js";
 import type { SessionTurnContext } from "../../types/executor/SessionTurnContext.js";
 /**
@@ -24,14 +23,6 @@ export interface SessionTurnExecutionResult {
      * 失败时的错误信息（成功时为空）。
      */
     error?: string;
-    /**
-     * 本轮执行结束后待写入长期历史的 user 消息。
-     *
-     * 关键点（中文）
-     * - 这些消息通常由 tool 运行时在执行过程中动态注入。
-     * - 为保证消息顺序稳定，统一在 assistant 结果落盘后再由外层 Session 持久化。
-     */
-    deferred_persisted_user_messages?: SessionUserMessage[];
     /**
      * 本轮结束后是否需要把已完成的 canonical 历史持久化压缩。
      *
@@ -45,10 +36,6 @@ export interface SessionTurnExecutionResult {
  * Session Turn 执行入口输入。
  */
 export interface SessionTurnExecutionInput {
-    /**
-     * 本轮用户输入查询文本。
-     */
-    query: string;
     /**
      * 本轮唯一的显式 Turn 上下文。
      *
@@ -62,38 +49,24 @@ export interface SessionTurnExecutionInput {
  * Executor 通过 Composer 装配后的中间运行态。
  */
 export interface SessionStepExecutionInput {
-    /**
-     * 当前轮用户查询文本。
-     */
-    query: string;
+    /** 当前 Step 使用的模型实例。 */
+    model: ModelClient;
     /**
      * 当前轮 system messages。
      */
     system: SessionSystemMessage[];
     /** 当前轮标准模型消息历史。 */
     messages: ModelMessage[];
-    /** 当前模型历史所包含的最新持久化 Summary 标识。 */
-    history_summary_id?: string;
     /**
      * 当前轮可用工具集合。
      */
     tools: Record<string, Tool>;
+    /** 当前模型支持的上下文窗口长度。 */
+    context_window?: number;
 }
 /** 单个 Session 的统一 Turn 执行协议。 */
 export interface SessionExecutor {
     /** 执行一个已经由 SessionLoop 创建上下文的 Turn。 */
     execute(input: SessionTurnExecutionInput): Promise<SessionTurnExecutionResult>;
 }
-/** Session 领域执行一次持久化历史压缩的统一回调。 */
-export type SessionCompactHistory = (input: {
-    /** 触发压缩的 Turn 标识；非 Turn 维护操作允许为空。 */
-    turn_id?: string;
-}) => Promise<{
-    /** 是否生成并成功提交了压缩计划。 */
-    compacted: boolean;
-    /** 没有压缩时的稳定原因。 */
-    reason?: string;
-    /** 压缩失败时的具体错误文本。 */
-    error?: string;
-}>;
 //# sourceMappingURL=SessionExecution.d.ts.map

package/bin/types/session/SessionExecution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionExecution.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,gCAAgC,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAExD;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;OAMG;IACH,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAE/B,mBAAmB;IACnB,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC7B;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,OAAO,CACL,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACxC;AAED,kCAAkC;AAClC,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE;IAC1C,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAK,OAAO,CAAC;IACZ,sBAAsB;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC"}
+{"version":3,"file":"SessionExecution.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,WAAW,IAAI,IAAI,EACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,YAAY,EAAE,kBAAkB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,uBAAuB;IACvB,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAE/B,mBAAmB;IACnB,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE5B,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CAEzB;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,OAAO,CACL,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACxC"}

package/bin/types/session/SessionLoop.d.ts

@@ -9,7 +9,7 @@ import type { SessionMessages } from "../../session/SessionMessages.js";
 import type { SessionState } from "../../session/SessionState.js";
 import type { AgentSessionTurnResult } from "../../types/sdk/AgentSessionTurn.js";
 import type { SessionInteractionLifecycle, SessionInteractionPort } from "@downcity/type";
-import type { SessionCompactHistory, SessionExecutor } from "../../types/session/SessionExecution.js";
+import type { SessionExecutor } from "../../types/session/SessionExecution.js";
 import type { SessionQueue } from "../../session/SessionQueue.js";
 import type { Logger } from "../../utils/logger/Logger.js";
 import type { SessionTurnContext } from "../../types/executor/SessionTurnContext.js";
@@ -31,8 +31,6 @@ export interface ActiveSessionTurnState {
     deferred_finished: SessionDeferred<AgentSessionTurnResult>;
     /** 当前 Turn 进入执行阶段后拥有的唯一上下文。 */
     turn_context: SessionTurnContext | null;
-    /** 下一 Step 是否需要重新读取 canonical history。 */
-    history_reload_requested: boolean;
     /** 当前 Turn 是否已经接收并持久化首条 Prompt。 */
     prompt_started: boolean;
 }
@@ -46,8 +44,8 @@ export interface SessionLoopOptions {
     workspace_path: string;
     /** 当前 Session 的模型执行器。 */
     executor: SessionExecutor;
-    /** 由 Session 领域提供的 canonical 历史压缩入口。 */
-    compact_history: SessionCompactHistory;
+    /** Turn 结束后按需维护 Composer 派生上下文。 */
+    maintain_context: () => Promise<void>;
     /** 当前 Session 的配置与 Metadata 状态。 */
     state: SessionState;
     /** 当前 Session 的 canonical Message 入口。 */

package/bin/types/session/SessionLoop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionLoop.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionLoop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,2BAA2B,EAC3B,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EAChB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,qBAAqB;AACrB,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,sBAAsB;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED,uBAAuB;AACvB,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtC,0BAA0B;IAC1B,iBAAiB,EAAE,eAAe,CAAC,sBAAsB,CAAC,CAAC;IAC3D,+BAA+B;IAC/B,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,0CAA0C;IAC1C,wBAAwB,EAAE,OAAO,CAAC;IAClC,mCAAmC;IACnC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAwB;AACxB,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,cAAc,EAAE,aAAa,CAAC;IAC9B,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,wCAAwC;IACxC,eAAe,EAAE,qBAAqB,CAAC;IACvC,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,eAAe,CAAC;IAC1B,gCAAgC;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,6BAA6B;IAC7B,YAAY,EAAE,2BAA2B,GAAG,sBAAsB,CAAC;IACnE,2BAA2B;IAC3B,sBAAsB,EAAE,oBAAoB,CAAC;CAC9C"}
+{"version":3,"file":"SessionLoop.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionLoop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EACV,2BAA2B,EAC3B,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,qBAAqB;AACrB,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,sBAAsB;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED,uBAAuB;AACvB,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtC,0BAA0B;IAC1B,iBAAiB,EAAE,eAAe,CAAC,sBAAsB,CAAC,CAAC;IAC3D,+BAA+B;IAC/B,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,mCAAmC;IACnC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAwB;AACxB,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,cAAc,EAAE,aAAa,CAAC;IAC9B,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,eAAe,CAAC;IAC1B,gCAAgC;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,6BAA6B;IAC7B,YAAY,EAAE,2BAA2B,GAAG,sBAAsB,CAAC;IACnE,2BAA2B;IAC3B,sBAAsB,EAAE,oBAAoB,CAAC;CAC9C"}

package/bin/types/session/SessionMessages.d.ts

@@ -4,18 +4,18 @@
  * 这些类型只描述 canonical Message 领域入口的参数，不包含持久化行为。
  */
 import type { JsonObject } from "@downcity/type";
-import type { SessionMessageStore } from "../../types/store/SessionDataStore.js";
+import type { SessionStorage } from "../../types/store/SessionStorage.js";
 import type { SessionAttachmentStore } from "../../types/store/SessionAttachmentStore.js";
 import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
-import type { SessionAssistantResultPart, SessionPromptPart } from "@downcity/type";
-import type { SessionAssistantMessagePart, SessionUserMessagePart } from "@downcity/type";
+import type { SessionAgentContent, SessionUserContent } from "@downcity/type";
+import type { SessionAgentMessagePart, SessionUserMessagePart } from "@downcity/type";
 import type { SessionMutation } from "@downcity/type";
 /** SessionMessages 构造参数。 */
 export interface SessionMessagesOptions {
     /** 当前 Session 标识。 */
     session_id: string;
     /** Message 快照持久化 Store。 */
-    store: SessionMessageStore;
+    store: SessionStorage;
     /** 当前 Session 的附件持久化能力。 */
     attachment_store: SessionAttachmentStore;
     /** 持久化成功后的实时 Mutation 发布函数。 */
@@ -25,8 +25,6 @@ export interface SessionMessagesOptions {
 export interface AppendSessionUserMessageInput {
     /** 当前输入所属 Turn。 */
     turn_id: string;
-    /** 当前输入是普通 Prompt 还是 Steering 输入。 */
-    input_type: "prompt" | "steer";
     /** User 结构化 Part。 */
     parts: SessionUserMessagePart[];
     /** 可选的稳定 Message 标识。 */
@@ -35,33 +33,25 @@ export interface AppendSessionUserMessageInput {
     visibility?: "visible" | "internal";
 }
 /** Assistant Message 创建参数。 */
-export interface OpenSessionAssistantMessageInput {
+export interface OpenSessionAgentMessageInput {
     /** 当前 Assistant 所属 Turn。 */
     turn_id: string;
-    /** 当前 Assistant 是普通回复还是压缩 Summary。 */
-    kind?: "normal" | "summary";
     /** 当前 Message 的默认展示范围。 */
     visibility?: "visible" | "internal";
     /** 可选的稳定 Message 标识。 */
     message_id?: string;
-    /** Summary 已覆盖到的来源 Message 标识。 */
-    summary_through_message_id?: string;
 }
 /** 已完成 Assistant Message 的直接写入参数。 */
-export interface AppendCompletedAssistantMessageInput {
+export interface AppendCompletedAgentMessageInput {
     /** 当前 Assistant 所属 Turn。 */
     turn_id?: string;
     /** Assistant 完整结构化 Part。 */
-    parts: SessionAssistantMessagePart[];
-    /** 当前 Assistant 是普通回复还是压缩 Summary。 */
-    kind?: "normal" | "summary";
+    parts: SessionAgentMessagePart[];
     /** 当前 Message 的默认展示范围。 */
     visibility?: "visible" | "internal";
-    /** Summary 已覆盖到的来源 Message 标识。 */
-    summary_through_message_id?: string;
 }
-/** Action Message 创建参数。 */
-export interface OpenSessionActionMessageInput {
+/** Action Part 及其所属 Agent Message 的创建参数。 */
+export interface OpenSessionAgentActionPartInput {
     /** 可选的稳定 Message 标识，用于更新同一个 Action 生命周期。 */
     message_id?: string;
     /** 当前 Action 所属 Turn。 */
@@ -77,8 +67,8 @@ export interface OpenSessionActionMessageInput {
     /** Action 创建或更新后是否发布对应 Session Mutation。 */
     publish_mutation?: boolean;
 }
-/** 完成 Action Message 时允许覆盖的内容。 */
-export interface CompleteSessionActionMessageInput {
+/** 完成 Action Part 时允许覆盖的内容。 */
+export interface CompleteSessionAgentActionPartInput {
     /** 完成时覆盖的可选标题。 */
     title?: string;
     /** 完成时覆盖的可选描述。 */
@@ -86,8 +76,8 @@ export interface CompleteSessionActionMessageInput {
     /** 完成时写入的可选结构化数据。 */
     data?: JsonObject;
 }
-/** Error Message 创建参数。 */
-export interface AppendSessionErrorMessageInput {
+/** 将 Error Part 归入所属 Turn Agent Message 的参数。 */
+export interface AppendSessionAgentErrorPartInput {
     /** 当前错误影响 Session 还是单个 Turn。 */
     scope: "session" | "turn";
     /** 当前错误所属 Turn。 */
@@ -102,14 +92,14 @@ export interface AppendSessionErrorMessageInput {
 /** 公开 Session API 追加 User Message 的输入。 */
 export interface AppendExternalSessionUserMessageInput {
     /** 可选的结构化 User 内容。 */
-    parts?: SessionPromptPart[];
+    parts?: SessionUserContent[];
     /** 未提供结构化内容时使用的纯文本。 */
     text?: string;
 }
 /** 公开 Session API 追加 Assistant Message 的输入。 */
-export interface AppendExternalSessionAssistantMessageInput {
+export interface AppendExternalSessionAgentMessageInput {
     /** 可选的结构化 Assistant 内容。 */
-    parts?: SessionAssistantResultPart[];
+    parts?: SessionAgentContent[];
     /** 未提供结构化内容时使用的纯文本。 */
     text?: string;
 }
@@ -121,7 +111,7 @@ export interface AppendSessionPromptMessageInput {
     prompt: AgentSessionPromptInput;
     /** 当前输入所属 Turn。 */
     turn_id: string;
-    /** 当前输入是普通 Prompt 还是 Steering 输入。 */
-    input_type: "prompt" | "steer";
+    /** 幂等 Prompt 使用的稳定 User Message ID。 */
+    message_id?: string;
 }
 //# sourceMappingURL=SessionMessages.d.ts.map

package/bin/types/session/SessionMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionMessages.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionMessages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SessionMessages.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionMessages.ts"],"names":[],"mappings":"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"}

package/bin/types/session/SessionOptions.d.ts

@@ -13,7 +13,7 @@ import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.js"
 import type { SessionHookRuntime } from "@downcity/type";
 import type { SessionComposer } from "../../types/session/SessionComposer.js";
 import type { Logger } from "../../utils/logger/Logger.js";
-import type { SessionDataStore } from "../../types/store/SessionDataStore.js";
+import type { SessionStorage } from "../../types/store/SessionStorage.js";
 import type { SessionOrigin } from "@downcity/type";
 /**
  * Agent 可管理的本地 Session 实例。
@@ -49,9 +49,9 @@ export interface SessionOptions {
     /** 当前 Session 的创建来源与物理存储分区。 */
     origin: SessionOrigin;
     /** 当前 Session 独享的领域持久化视图。 */
-    store: SessionDataStore;
+    store: SessionStorage;
     /** 为 fork 创建另一个 Session 的领域持久化视图。 */
-    get_session_store: (session_id: string) => SessionDataStore;
+    create_session_store: (session_id: string) => SessionStorage;
     /**
      * 将 fork 创建的子 Session 交回 AgentSessions 登记。
      *
@@ -103,7 +103,7 @@ export interface SessionOptions {
     ensure_configured?: (session: AgentManagedSession) => Promise<void>;
     /** 读取 Agent 当前持有的运行时模型实例。 */
     get_agent_model: () => ModelClient | undefined;
-    /** 当前 Session 使用的统一执行策略；省略时使用默认 Composer。 */
-    composer?: SessionComposer;
+    /** 为当前 Session 及其 fork 子 Session 创建独立 Composer 的工厂。 */
+    create_composer?: () => SessionComposer;
 }
 //# sourceMappingURL=SessionOptions.d.ts.map

package/bin/types/session/SessionOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionOptions.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,gBAAgB,IAAI,WAAW,CAAC;IAEhC,+BAA+B;IAC/B,wBAAwB,CAAC,IAAI,IAAI,CAAC;IAElC;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC;CAEzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IAEvB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+BAA+B;IAC/B,MAAM,EAAE,aAAa,CAAC;IAEtB,6BAA6B;IAC7B,KAAK,EAAE,gBAAgB,CAAC;IAExB,qCAAqC;IACrC,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAE5D;;;;;;OAMG;IACH,uBAAuB,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAEhE;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEtC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,yBAAyB,EAAE,uBAAuB,EAAE,CAAC;IAErD;;;;;;OAMG;IACH,6BAA6B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAE/D;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD,0DAA0D;IAC1D,SAAS,EAAE,MAAM,kBAAkB,CAAC;IAEpC,gDAAgD;IAChD,gCAAgC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE3E;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,6BAA6B;IAC7B,eAAe,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IAE/C,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B"}
+{"version":3,"file":"SessionOptions.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,gBAAgB,IAAI,WAAW,CAAC;IAEhC,+BAA+B;IAC/B,wBAAwB,CAAC,IAAI,IAAI,CAAC;IAElC;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC;CAEzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IAEvB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,+BAA+B;IAC/B,MAAM,EAAE,aAAa,CAAC;IAEtB,6BAA6B;IAC7B,KAAK,EAAE,cAAc,CAAC;IAEtB,qCAAqC;IACrC,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,cAAc,CAAC;IAE7D;;;;;;OAMG;IACH,uBAAuB,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAEhE;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAEtC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,yBAAyB,EAAE,uBAAuB,EAAE,CAAC;IAErD;;;;;;OAMG;IACH,6BAA6B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAE/D;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD,0DAA0D;IAC1D,SAAS,EAAE,MAAM,kBAAkB,CAAC;IAEpC,gDAAgD;IAChD,gCAAgC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE3E;;OAEG;IACH,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,6BAA6B;IAC7B,eAAe,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IAE/C,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,eAAe,CAAC;CACzC"}