@downcity/agent 1.1.408 → 1.1.437

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

@@ -1,34 +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 "../agent/SessionTypes.js";
-import type { SessionContextSnapshot, SessionSegmentSummary } from "./SessionSegment.js";
+import type { AgentSessionSystemBlock } from "../../types/agent/SessionTypes.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[];
@@ -36,67 +38,71 @@ export interface SessionComposeState {
     tools: Readonly<Record<string, Tool>>;
     /** 当前 Step 生效的 instruction system blocks。 */
     instruction_system_blocks: readonly AgentSessionSystemBlock[];
-    /** 当前 Session 由宿主注入的 system blocks。 */
+    /** 宿主注入的受托管 Plugin system blocks。 */
     managed_plugin_system_blocks: readonly AgentSessionSystemBlock[];
     /** 当前 Step 捕获的 Plugin system blocks。 */
     plugin_system_blocks: readonly AgentSessionSystemBlock[];
+    /** 当前 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>;
-}
-/** 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":"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"}
+{"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

@@ -0,0 +1,51 @@
+/**
+ * Session system 快照与模型输入组装的依赖类型。
+ *
+ * 这些字段共同描述 composition 领域所需的最小只读资源；SessionComposition 不拥有
+ * Message、Store、Model 或 Plugin 生命周期。
+ */
+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 { 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";
+/** SessionComposition 构造参数。 */
+export interface SessionCompositionOptions {
+    /** 当前 Session 所属 Agent 的稳定标识。 */
+    agent_id: string;
+    /** 当前 Session 的稳定标识。 */
+    session_id: string;
+    /** 当前 Session 的创建来源。 */
+    session_origin: SessionOrigin;
+    /** 当前 Session 使用的 Workspace 绝对根目录。 */
+    workspace_path: string;
+    /** 当前 Session 的领域持久化视图。 */
+    store: SessionStorage;
+    /** 当前 Session 使用的统一 Composer。 */
+    composer: SessionComposer;
+    /** 在每个 Step 检查点读取当前可用 Tool 集合。 */
+    get_tools: () => Record<string, Tool>;
+    /** 当前 Session 创建时捕获的 instruction system blocks。 */
+    instruction_system_blocks: AgentSessionSystemBlock[];
+    /** 显式 syncshot 时读取 Agent 最新 instruction system blocks。 */
+    get_instruction_system_blocks: () => AgentSessionSystemBlock[];
+    /** 显式 syncshot 时读取当前配置的 Hook 执行视图。 */
+    get_hooks: () => SessionHookRuntime;
+    /** 在每个 Step 检查点读取 Workspace env。 */
+    get_workspace_env: () => Record<string, string>;
+    /** 读取宿主显式注入的受托管 Plugin system blocks。 */
+    get_managed_plugin_system_blocks: () => Promise<AgentSessionSystemBlock[]>;
+    /** 读取当前 Session 实际使用的模型。 */
+    get_model: () => ModelClient | undefined;
+    /** 读取当前模型声明的上下文窗口。 */
+    get_model_context_window: () => number | undefined;
+    /** 读取当前 Session 的创建时间戳。 */
+    get_created_at: () => number;
+    /** 读取当前 Session 的参考时区。 */
+    get_timezone: () => string;
+    /** 记录 Plugin Hook 降级等可观察事件。 */
+    logger: Logger;
+}
+//# sourceMappingURL=SessionComposition.d.ts.map

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

@@ -0,0 +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,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/SessionComposition.js

@@ -0,0 +1,8 @@
+/**
+ * Session system 快照与模型输入组装的依赖类型。
+ *
+ * 这些字段共同描述 composition 领域所需的最小只读资源；SessionComposition 不拥有
+ * Message、Store、Model 或 Plugin 生命周期。
+ */
+export {};
+//# sourceMappingURL=SessionComposition.js.map

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

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

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,10 +6,9 @@
  * - `SessionStepExecutionInput` 表示 Executor 通过 Composer 装配后的 Step 输入。
  * - 输出只返回执行结果；Assistant Message 通过显式输出端口写入唯一事实源。
  */
-import type { ModelMessage, RuntimeTool as Tool } from "@downcity/type";
-import type { SessionUserMessage } from "./SessionMessage.js";
+import type { ModelClient, ModelMessage, RuntimeTool as Tool } from "@downcity/type";
 import type { SessionSystemMessage } from "../../executor/types/SessionPrompts.js";
-import type { SessionTurnContext } from "../executor/SessionTurnContext.js";
+import type { SessionTurnContext } from "../../types/executor/SessionTurnContext.js";
 /**
  * Session 执行结果。
  */
@@ -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,mCAAmC,CAAC;AAC5E,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/SessionInteractions.d.ts

@@ -4,7 +4,7 @@
  * 这里只描述内存中的等待句柄；Interaction 的权威状态始终保存在
  * SessionMessages 的 Assistant Interaction Part 中。
  */
-import type { SessionInteractionRequest, SessionInteractionResult } from "./SessionInteraction.js";
+import type { SessionInteractionRequest, SessionInteractionResult } from "@downcity/type";
 /** 单个等待用户响应的运行时 Interaction。 */
 export interface SessionPendingInteractionRuntime {
     /** 已经持久化的完整 Interaction 请求。 */

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

@@ -1 +1 @@
-{"version":3,"file":"SessionInteractions.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionInteractions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,uCAAuC,CAAC;AAE/C,gCAAgC;AAChC,MAAM,WAAW,gCAAgC;IAC/C,+BAA+B;IAC/B,OAAO,EAAE,yBAAyB,CAAC;IACnC,2BAA2B;IAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACpD,iCAAiC;IACjC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CACvC"}
+{"version":3,"file":"SessionInteractions.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionInteractions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AAExB,gCAAgC;AAChC,MAAM,WAAW,gCAAgC;IAC/C,+BAA+B;IAC/B,OAAO,EAAE,yBAAyB,CAAC;IACnC,2BAA2B;IAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;IACpD,iCAAiC;IACjC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CACvC"}

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

@@ -6,8 +6,8 @@
  * - `SessionState` 与 `Session` 共享该对象，避免重复维护配置状态。
  * - 这里只保存运行态，不承载行为逻辑。
  */
-import type { AgentSessionConfigSnapshot } from "../agent/SessionTypes.js";
-import type { SessionApprovalMode } from "./SessionInteraction.js";
+import type { AgentSessionConfigSnapshot } from "../../types/agent/SessionTypes.js";
+import type { SessionApprovalMode } from "@downcity/type";
 /**
  * 本地 Session 内存状态。
  */

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

@@ -1 +1 @@
-{"version":3,"file":"SessionLocalState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionLocalState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,cAAc,EAAE,0BAA0B,CAAC;IAE3C;;;;;;OAMG;IACH,wBAAwB,EAAE,0BAA0B,CAAC;IAErD,sCAAsC;IACtC,wBAAwB,EAAE,mBAAmB,CAAC;IAE9C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,yBAAyB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjD"}
+{"version":3,"file":"SessionLocalState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionLocalState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,cAAc,EAAE,0BAA0B,CAAC;IAE3C;;;;;;OAMG;IACH,wBAAwB,EAAE,0BAA0B,CAAC;IAErD,sCAAsC;IACtC,wBAAwB,EAAE,mBAAmB,CAAC;IAE9C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,yBAAyB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjD"}

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

@@ -3,16 +3,17 @@
  *
  * 这些类型描述 Turn 编排所依赖的领域对象，不实现任何调度行为。
  */
-import type { ShellApprovalGateway } from "@downcity/workspace";
+import type { ShellApprovalGateway } from "@downcity/type";
 import type { SessionEventHub } from "../../session/runtime/SessionEventHub.js";
 import type { SessionMessages } from "../../session/SessionMessages.js";
 import type { SessionState } from "../../session/SessionState.js";
-import type { AgentSessionTurnResult } from "../sdk/AgentSessionTurn.js";
-import type { SessionInteractionLifecycle, SessionInteractionPort } from "./SessionInteraction.js";
-import type { SessionCompactHistory, SessionExecutor } from "./SessionExecution.js";
+import type { AgentSessionTurnResult } from "../../types/sdk/AgentSessionTurn.js";
+import type { SessionInteractionLifecycle, SessionInteractionPort } from "@downcity/type";
+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 "../executor/SessionTurnContext.js";
+import type { SessionTurnContext } from "../../types/executor/SessionTurnContext.js";
+import type { SessionOrigin } from "@downcity/type";
 /** Promise 延迟控制器。 */
 export interface SessionDeferred<T> {
     /** 等待兑现的 Promise。 */
@@ -30,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;
 }
@@ -39,12 +38,14 @@ export interface ActiveSessionTurnState {
 export interface SessionLoopOptions {
     /** 当前 Session 的稳定标识。 */
     session_id: string;
+    /** 当前 Session 的完整来源元数据。 */
+    session_origin: SessionOrigin;
     /** 当前 Session 所属 Workspace 的绝对根目录。 */
     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,qBAAqB,CAAC;AAChE,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,uCAAuC,CAAC;AAC/C,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;AAEjF,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,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"}