@downcity/agent 1.1.438 → 1.1.445

package/bin/types/group/DispatchStrategy.js

@@ -4,7 +4,7 @@
  * 调度器只负责决定谁在什么阶段完成哪项工作，不接触 Agent 的执行能力、完整指令或
  * Session 生命周期。GroupSession 负责执行计划，并在需要时用真实结果发起下一轮判断。
  */
-import { generate_model } from "../../executor/model/ModelGenerate.js";
+import { generate_model } from "../../model/ModelGenerate.js";
 import { z } from "zod";
 /** AI 调度工具的最小输入协议；阶段串行，阶段内 assignment 并行。 */
 const dispatch_group_input_schema = z.object({

package/bin/types/group/DispatchStrategy.js.map

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

package/bin/types/group/GroupSession.d.ts

@@ -84,6 +84,28 @@ export interface GroupSessionListInput {
     /** 只返回绑定到指定 Workspace 的群聊上下文。 */
     readonly workspace_id?: string;
 }
+/**
+ * 归档一个 GroupSession 的结果。
+ *
+ * 归档是一次**目录搬迁**（活动区 → 归档区），不是打标记：
+ * 它让「活动列表」天然只含活动项，不需要在每次查询里过滤。
+ */
+export interface GroupSessionArchiveResult {
+    /** 被归档的 GroupSession 标识。 */
+    readonly session_id: string;
+    /** 归档发生的时间戳。 */
+    readonly archived_at: number;
+}
+/** 列出已归档 GroupSession 的过滤条件。 */
+export interface GroupSessionArchiveListInput {
+    /** 只返回绑定到指定 Workspace 的归档群聊。 */
+    readonly workspace_id?: string;
+}
+/** 清空归档后的结果。 */
+export interface GroupSessionCleanArchiveResult {
+    /** 被永久删除的归档 GroupSession 标识。 */
+    readonly removed_session_ids: readonly string[];
+}
 /** GroupSession 公开能力。 */
 export interface GroupSessionContract {
     /** 当前群聊上下文的稳定标识。 */
@@ -116,10 +138,28 @@ export interface GroupSessions {
     create(input?: GroupSessionCreateInput): Promise<GroupSession>;
     /** 从 Storage 恢复当前 Group 的一个群聊上下文。 */
     get(session_id: string, input?: GroupSessionGetInput): Promise<GroupSession | null>;
-    /** 从 Storage 恢复当前 Group 的全部群聊上下文。 */
+    /** 从 Storage 恢复当前 Group 的全部群聊上下文（不含已归档）。 */
     list(input?: GroupSessionListInput): Promise<readonly GroupSessionSummary[]>;
     /** 释放并移除指定群聊上下文。 */
     remove(session_id: string, input?: GroupSessionGetInput): Promise<GroupSession | null>;
+    /**
+     * 归档指定群聊上下文：从活动区迁入归档区。
+     *
+     * 与 `remove` 的区别是**可逆性**：归档只是收起来，数据仍在归档区；
+     * 而 `remove` 是永久删除。因此正在执行的群聊不能归档（先停再归档）。
+     */
+    archive(session_id: string): Promise<GroupSessionArchiveResult>;
+    /** 列出已归档的群聊上下文摘要。 */
+    archived(input?: GroupSessionArchiveListInput): Promise<readonly GroupSessionSummary[]>;
+    /** 永久清空当前 Group 的全部归档。 */
+    clean_archive(): Promise<GroupSessionCleanArchiveResult>;
+    /**
+     * 永久删除当前 Group 的全部群聊数据（活动区 + 归档区）。
+     *
+     * 它服务于「Group 被删除」：Group 是群聊的**所有者**，所有者消失时它拥有的数据
+     * 不该继续存在。与 `dispose` 的区别：那个只释放运行时实例，数据仍在磁盘上。
+     */
+    purge(): Promise<void>;
 }
 /** GroupSession 的内部依赖快照。 */
 export interface GroupSessionRuntimeContext {

package/bin/types/group/GroupSession.d.ts.map

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

package/bin/types/group/GroupSessionStore.d.ts

@@ -1,6 +1,7 @@
 /** GroupSession 持久化协议：只描述 GroupSession 所需的底层数据能力。 */
 import type { GroupMessage } from "../../types/group/Group.js";
 import type { GroupDispatchTurnRecord } from "../../types/group/GroupDispatch.js";
+import type { GroupSessionArchiveResult, GroupSessionCleanArchiveResult } from "../../types/group/GroupSession.js";
 import type { FileSystem } from "@downcity/type";
 /** GroupSession 的持久化元数据。 */
 export interface GroupSessionHistoryMeta {
@@ -65,12 +66,38 @@ export interface GroupSessionDataStore {
 export interface GroupSessionStore {
     /** 返回指定 GroupSession 的持久化视图。 */
     session(session_id: string): GroupSessionDataStore;
-    /** 判断指定 GroupSession 是否存在。 */
+    /** 判断指定 GroupSession 是否存在（活动区）。 */
     has_session(session_id: string): Promise<boolean>;
-    /** 列出当前 Group 的持久化 Session metadata。 */
+    /** 列出当前 Group 活动区的 Session metadata（不含已归档）。 */
     list_session_metadata(): Promise<GroupSessionHistoryMeta[]>;
-    /** 删除指定 GroupSession 的全部数据。 */
+    /** 删除指定 GroupSession 的全部数据（活动区）。 */
     remove_session(session_id: string): Promise<boolean>;
+    /**
+     * 把一个活动 GroupSession 迁入归档区。
+     *
+     * 与 Agent Session 的归档同形（`LocalSessionStore.archive_session`），只有一处差别：
+     * **不接受 `origin_type`**——群聊的来源只有一种，多一个参数只会让人猜该传什么。
+     *
+     * 不变量（两个方向都不允许静默成功）：
+     *
+     * - 源不存在 → 报错；
+     * - 目标已存在 → 报错（覆盖会丢掉一份真实数据）。
+     */
+    archive_session(session_id: string): Promise<GroupSessionArchiveResult>;
+    /** 列出归档区的 Session metadata。 */
+    list_archived_session_metadata(): Promise<GroupSessionHistoryMeta[]>;
+    /** 删除归档区中的指定 Session。 */
+    remove_archived_session(session_id: string): Promise<boolean>;
+    /** 永久清空归档区。 */
+    clean_archive(): Promise<GroupSessionCleanArchiveResult>;
+    /**
+     * 永久删除当前 Group 的**全部** GroupSession 数据（活动区 + 归档区）。
+     *
+     * 与 `clean_archive` 的区别：那个只动归档区，这个连活动区一起删。
+     * 它服务于「Group 被删除」——Group 是群聊的**所有者**，所有者消失时它拥有的数据不该继续存在。
+     * 没有它时删掉一个 Group 会在磁盘上留下无人认领的孤儿目录。
+     */
+    purge(): Promise<void>;
     /** 释放当前 Store 持有的资源。 */
     dispose(): Promise<void>;
 }

package/bin/types/group/GroupSessionStore.d.ts.map

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

package/bin/types/model/ModelRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRequest.d.ts","sourceRoot":"","sources":["../../../src/types/model/ModelRequest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEhE,kBAAkB;AAClB,MAAM,MAAM,2BAA2B,GAAG,CACxC,MAAM,EAAE,yBAAyB;AACjC,6BAA6B;AAC7B,KAAK,EAAE,OAAO,KACX,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/bin/types/model/ModelRequest.js.map

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

package/bin/types/sdk/AgentSessionAction.d.ts

@@ -5,15 +5,7 @@
  * - Action 运行事件由 Session 收口为 canonical `SessionAgentActionPart`。
  * - Action 不进入模型输入。
  */
-import type { SessionActionEvent, SessionActionStatus } from "@downcity/type";
-/**
- * Session action 当前状态。
- */
-export type AgentSessionActionState = SessionActionStatus;
-/**
- * Session action 记录。
- */
-export type AgentSessionActionRecord = SessionActionEvent;
+import type { SessionActionEvent } from "@downcity/type";
 /**
  * Session action 订阅事件。
  */

package/bin/types/sdk/AgentSessionAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionAction.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionAction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"AgentSessionAction.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionAction.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,CACvC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/bin/types/session/{AdaptivePartContextPolicy.d.ts → ContextCheckpoint.d.ts}

@@ -1,31 +1,32 @@
 /**
- * AdaptivePartContextPolicy 内部持久化与候选类型。
+ * Composer 上下文 checkpoint 派生类型。
  *
- * 类型集中在 types 目录，策略模块只保留上下文选择行为。
+ * checkpoint 记录「累计摘要已经覆盖到哪个 canonical Part」，属于 Composer 自己的派生
+ * 数据：可以随时删除并从 canonical history 重新累积，不参与 Session Message 语义。
  */
 import type { SessionAgentMessagePart, SessionMessage, SessionUserMessagePart } from "@downcity/type";
 /** Part 级累计摘要 checkpoint。 */
-export interface AdaptivePartCheckpointRow {
+export interface ContextCheckpointRow {
     /** checkpoint 稳定标识。 */
     checkpoint_id: string;
     /** 边界所属 Message 标识。 */
     through_message_id: string;
     /** 边界所属 Message sequence。 */
     through_message_sequence: number;
-    /** 边界 Part sequence。 */
+    /** 边界 Part sequence；边界可以落在单个 Message 内部。 */
     through_part_sequence: number;
-    /** 累计摘要正文。 */
+    /** 截至边界的累计摘要正文。 */
     summary: string;
-    /** 生成派生结果的策略版本。 */
-    policy_version: number;
+    /** 生成派生结果时的 schema 版本；不兼容的旧表会被重建。 */
+    schema_version: number;
     /** 派生记录创建时间。 */
     created_at: number;
 }
 /** 可参与摘要的稳定 Part 及其 canonical 位置。 */
-export interface StablePartCandidate {
+export interface StableContextPart {
     /** Part 所属完整 Message。 */
     message: SessionMessage;
     /** 具体 canonical Part。 */
     part: SessionUserMessagePart | SessionAgentMessagePart;
 }
-//# sourceMappingURL=AdaptivePartContextPolicy.d.ts.map
+//# sourceMappingURL=ContextCheckpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextCheckpoint.d.ts","sourceRoot":"","sources":["../../../src/types/session/ContextCheckpoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAExB,6BAA6B;AAC7B,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6BAA6B;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,4CAA4C;IAC5C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,yBAAyB;IACzB,IAAI,EAAE,sBAAsB,GAAG,uBAAuB,CAAC;CACxD"}

package/bin/types/session/ContextCheckpoint.js

@@ -0,0 +1,8 @@
+/**
+ * Composer 上下文 checkpoint 派生类型。
+ *
+ * checkpoint 记录「累计摘要已经覆盖到哪个 canonical Part」，属于 Composer 自己的派生
+ * 数据：可以随时删除并从 canonical history 重新累积，不参与 Session Message 语义。
+ */
+export {};
+//# sourceMappingURL=ContextCheckpoint.js.map

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

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

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

@@ -1,23 +1,19 @@
 /**
  * Assistant Message 状态转换器的依赖类型。
  *
- * 该类型只暴露 canonical Message 所有者允许使用的最小能力，避免内部协作者
- * 复制 SessionMessages 的消息索引或 Mutation 发布状态。
+ * 该类型只暴露 canonical Message 运行时真正需要的协作能力：持久化边界与
+ * Message 缓存。缓存是 SessionMessages 与本模块共享的唯一边界，两者都单向依赖它，
+ * 不再需要互相回指的闭包。
  */
 import type { SessionStorage } from "../../types/store/SessionStorage.js";
-import type { SessionMessage } from "@downcity/type";
-import type { SessionMutation } from "@downcity/type";
+import type { SessionMessageCache } from "../../session/messages/SessionMessageCache.js";
 /** Assistant Message 状态转换器的构造参数。 */
 export interface SessionAgentMessageStateOptions {
     /** 当前 Assistant Message 所属 Session 的稳定标识。 */
     session_id: string;
     /** 负责持久化 canonical Message 稳定检查点的 Store。 */
     store: SessionStorage;
-    /** 读取 SessionMessages 当前持有的 canonical Message 集合。 */
-    list_messages: () => Iterable<SessionMessage>;
-    /** 接受已持久化的完整 Message 快照，并按需发布 Mutation。 */
-    accept_message: (message: SessionMessage, publish_mutation?: boolean) => void;
-    /** 接受未持久化的实时 Mutation，并只更新当前运行投影。 */
-    project_mutation: (mutation: SessionMutation, message: SessionMessage) => void;
+    /** Message 运行缓存与 Mutation 发布边界。 */
+    cache: SessionMessageCache;
 }
 //# sourceMappingURL=SessionAgentMessageState.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SessionAgentMessageState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionAgentMessageState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,oCAAoC;AACpC,MAAM,WAAW,+BAA+B;IAC9C,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,EAAE,cAAc,CAAC;IACtB,qDAAqD;IACrD,aAAa,EAAE,MAAM,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9C,2CAA2C;IAC3C,cAAc,EAAE,CACd,OAAO,EAAE,cAAc,EACvB,gBAAgB,CAAC,EAAE,OAAO,KACvB,IAAI,CAAC;IACV,qCAAqC;IACrC,gBAAgB,EAAE,CAChB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,cAAc,KACpB,IAAI,CAAC;CACX"}
+{"version":3,"file":"SessionAgentMessageState.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionAgentMessageState.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAErF,oCAAoC;AACpC,MAAM,WAAW,+BAA+B;IAC9C,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,KAAK,EAAE,cAAc,CAAC;IACtB,mCAAmC;IACnC,KAAK,EAAE,mBAAmB,CAAC;CAC5B"}

package/bin/types/session/SessionAgentMessageState.js

@@ -1,8 +1,9 @@
 /**
  * Assistant Message 状态转换器的依赖类型。
  *
- * 该类型只暴露 canonical Message 所有者允许使用的最小能力，避免内部协作者
- * 复制 SessionMessages 的消息索引或 Mutation 发布状态。
+ * 该类型只暴露 canonical Message 运行时真正需要的协作能力：持久化边界与
+ * Message 缓存。缓存是 SessionMessages 与本模块共享的唯一边界，两者都单向依赖它，
+ * 不再需要互相回指的闭包。
  */
 export {};
 //# sourceMappingURL=SessionAgentMessageState.js.map

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

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

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

@@ -1,16 +1,20 @@
 /**
  * Session Composer 类型。
  *
- * Composer 是最终模型输入的唯一生成者：它组合运行快照、canonical history 与内部
- * Context Policy；不拥有 Message、Turn 或数据库连接生命周期。
+ * Composer 是唯一回答「这一步模型看到什么」的组件：它把运行快照、canonical history
+ * 快照与自己的派生状态组装成一次模型 Step 输入，并在上下文压力出现时推进派生状态。
+ *
+ * 关键点（中文）
+ * - canonical history 与派生存储都由调用方传入，Composer 不主动访问 Session 存储。
+ * - 「压缩」不是独立概念，只是 `advance_context()` 的一种实现；不做任何推进也是合法实现。
+ * - Composer 不拥有 Message、Turn 或数据库连接生命周期，也不修改 canonical history。
  */
-import type { ModelClient, ModelMessage, RuntimeTool as Tool } from "@downcity/type";
-import type { SessionSystemMessage } from "../../executor/types/SessionPrompts.js";
+import type { ModelClient, ModelMessage, AgentTool } from "@downcity/type";
+import type { SessionSystemMessage } from "@downcity/type";
 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";
+import type { SessionHookContextBlock, SessionMessage } from "@downcity/type";
+import type { ModelRequestFailureReporter } from "../../types/model/ModelRequest.js";
+import type { SessionDerivedStore } from "../../types/store/SessionStorage.js";
 /** Composer 可读取的 Session 身份快照。 */
 export interface SessionComposeIdentity {
     /** 当前 Agent 的稳定标识。 */
@@ -35,27 +39,25 @@ export interface SessionComposeState {
     /** 当前 Step 生效的 Agent instruction 文本。 */
     systems: readonly string[];
     /** 当前 Step 可使用的工具集合。 */
-    tools: Readonly<Record<string, Tool>>;
+    tools: Readonly<Record<string, AgentTool>>;
     /** 当前 Step 生效的 instruction system blocks。 */
     instruction_system_blocks: readonly AgentSessionSystemBlock[];
-    /** 宿主注入的受托管 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[];
+    /** 当前 Step 捕获的扩展 system blocks。 */
+    power_system_blocks: readonly AgentSessionSystemBlock[];
+    /** 当前 Turn 冻结的 Power 动态上下文。 */
+    power_context_blocks: readonly SessionHookContextBlock[];
 }
 /** Composer 可读取的当前 Turn 快照。 */
 export interface SessionComposeTurn {
     /** 当前 Turn 标识；只读查询时允许为空。 */
     turn_id?: string;
-    /** 当前执行已进行的上下文恢复次数。 */
-    retry_count: number;
+    /** 当前执行已进行的上下文推进次数。 */
+    advance_count: number;
 }
 /** Composer 初始化输入。 */
 export interface SessionComposerInitializeInput {
-    /** 当前 Session 的统一持久化边界。 */
-    storage: SessionStorage;
+    /** 当前 Composer 命名空间内的派生表事务。 */
+    derived: SessionDerivedStore;
 }
 /** 单次模型输入组装参数。 */
 export interface SessionComposeInput {
@@ -63,24 +65,47 @@ export interface SessionComposeInput {
     session: SessionComposeIdentity;
     /** 当前 Step 已生效的运行状态。 */
     state: SessionComposeState;
-    /** 当前 Session 的统一持久化边界。 */
-    storage: SessionStorage;
+    /** 调用方读取的 canonical history 只读快照，按 sequence 升序。 */
+    history: readonly SessionMessage[];
+    /** 当前 Composer 命名空间内的派生表事务。 */
+    derived: SessionDerivedStore;
     /** 当前 Turn 快照。 */
     turn: SessionComposeTurn;
 }
-/** 上下文超限后的恢复输入。 */
-export interface SessionContextRecoveryInput {
+/** 触发一次派生上下文推进的稳定领域原因。 */
+export type SessionContextAdvanceTrigger = 
+/** Provider 明确拒绝超出上下文窗口的请求。 */
+"provider_context_limit"
+/** Provider usage 已达到主动推进阈值。 */
+ | "usage_pressure";
+/** 上下文推进输入。 */
+export interface SessionContextAdvanceInput {
     /** 当前 Session 身份快照。 */
     session: SessionComposeIdentity;
-    /** 当前 Session 使用的模型。 */
+    /** 调用方读取的 canonical history 只读快照，按 sequence 升序。 */
+    history: readonly SessionMessage[];
+    /** 当前 Composer 命名空间内的派生表事务。 */
+    derived: SessionDerivedStore;
+    /** 触发本次推进的稳定领域原因。 */
+    trigger: SessionContextAdvanceTrigger;
+    /** 用于生成派生摘要的当前模型。 */
     model?: ModelClient;
-    /** 当前 Session 的统一持久化边界。 */
-    storage: SessionStorage;
-    /** 触发当前恢复的稳定领域原因。 */
-    reason: SessionContextRecoveryReason;
     /** 模型请求逐次失败的可选观测入口。 */
     on_model_request_failure?: ModelRequestFailureReporter;
 }
+/** Composer 对本次模型上下文的只读诊断。 */
+export interface SessionContextDiagnostics {
+    /** 生成当前上下文的 Composer 名称。 */
+    composer_name: string;
+    /** 当前上下文覆盖到的最新 canonical Message sequence。 */
+    through_sequence?: number;
+    /** 当前派生边界在 Message 内覆盖到的 Part sequence。 */
+    through_part_sequence?: number;
+    /** 当前上下文是否使用了派生摘要。 */
+    derived: boolean;
+    /** 当前使用的可选派生记录标识。 */
+    derivation_id?: string;
+}
 /** Composer 为一次模型 Step 生成的完整输入。 */
 export interface SessionStepInput {
     /** 当前 Step 的 system messages。 */
@@ -89,20 +114,24 @@ export interface SessionStepInput {
     system_blocks?: AgentSessionSystemBlock[];
     /** 当前 Step 已转换完成的标准模型消息。 */
     messages: ModelMessage[];
-    /** 当前 Step 可调用的工具集合。 */
-    tools: Record<string, Tool>;
-    /** 本次上下文策略诊断。 */
-    context_diagnostics?: SessionResolvedContextDiagnostics;
+    /** 当前 Step 可调用的工具集合；执行前由 StepInput 绑定调用环境。 */
+    tools: Record<string, AgentTool>;
+    /** 本次上下文组装诊断。 */
+    context_diagnostics?: SessionContextDiagnostics;
 }
 /** Session 级可替换 Composer。 */
 export interface SessionComposer {
-    /** Composer 的稳定可读名称。 */
+    /**
+     * Composer 稳定名称。
+     *
+     * 关键点（中文）：该值同时作为派生表命名空间，派生表前缀固定为 `composer_<name>_`。
+     */
     readonly name: string;
-    /** 初始化 Composer 及其内部 Policy。 */
+    /** 初始化当前 Composer 的派生 schema；没有派生状态时可以是空实现。 */
     initialize(input: SessionComposerInitializeInput): Promise<void>;
     /** 组装一次模型 Step 使用的最终输入。 */
     compose(input: SessionComposeInput): Promise<SessionStepInput>;
-    /** 尝试推进上下文派生状态；有效推进时返回 true。 */
-    recover_context(input: SessionContextRecoveryInput): Promise<boolean>;
+    /** 尝试推进派生上下文状态；发生有效推进时返回 true。 */
+    advance_context(input: SessionContextAdvanceInput): 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,13 @@
 /**
  * Session Composer 类型。
  *
- * Composer 是最终模型输入的唯一生成者：它组合运行快照、canonical history 与内部
- * Context Policy；不拥有 Message、Turn 或数据库连接生命周期。
+ * Composer 是唯一回答「这一步模型看到什么」的组件：它把运行快照、canonical history
+ * 快照与自己的派生状态组装成一次模型 Step 输入，并在上下文压力出现时推进派生状态。
+ *
+ * 关键点（中文）
+ * - canonical history 与派生存储都由调用方传入，Composer 不主动访问 Session 存储。
+ * - 「压缩」不是独立概念，只是 `advance_context()` 的一种实现；不做任何推进也是合法实现。
+ * - Composer 不拥有 Message、Turn 或数据库连接生命周期，也不修改 canonical history。
  */
 export {};
 //# sourceMappingURL=SessionComposer.js.map

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

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

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

@@ -3,12 +3,13 @@
  *
  * 关键点（中文）
  * - `SessionTurnExecutionInput` 表示上层 Turn 执行入口输入。
- * - `SessionStepExecutionInput` 表示 Executor 通过 Composer 装配后的 Step 输入。
+ * - `SessionStepExecutionInput` 表示执行器收到的、已装配完成的一步输入。
  * - 输出只返回执行结果；Assistant Message 通过显式输出端口写入唯一事实源。
  */
-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";
+import type { ModelClient, ModelMessage } from "@downcity/type";
+import type { BoundAgentTool } from "../../types/tool/BoundAgentTool.js";
+import type { SessionSystemMessage } from "@downcity/type";
+import type { SessionTurnContext } from "../../types/turn/SessionTurnContext.js";
 /**
  * Session 执行结果。
  */
@@ -23,6 +24,14 @@ export interface SessionTurnExecutionResult {
      * 失败时的错误信息（成功时为空）。
      */
     error?: string;
+    /**
+     * 失败时的稳定错误码；缺省时由 Session 层回退为通用 Turn 失败码。
+     *
+     * 关键点（中文）
+     * - 只用于让上层写入 canonical Error Part 时保留领域语义，不参与执行分支判断。
+     * - 成功时为空。
+     */
+    error_code?: string;
     /**
      * 本轮结束后是否需要把已完成的 canonical 历史持久化压缩。
      *
@@ -58,15 +67,10 @@ export interface SessionStepExecutionInput {
     /** 当前轮标准模型消息历史。 */
     messages: ModelMessage[];
     /**
-     * 当前轮可用工具集合。
+     * 当前轮可用工具集合；上下文已在包装层绑定。
      */
-    tools: Record<string, Tool>;
+    tools: Record<string, BoundAgentTool>;
     /** 当前模型支持的上下文窗口长度。 */
     context_window?: number;
 }
-/** 单个 Session 的统一 Turn 执行协议。 */
-export interface SessionExecutor {
-    /** 执行一个已经由 SessionLoop 创建上下文的 Turn。 */
-    execute(input: SessionTurnExecutionInput): Promise<SessionTurnExecutionResult>;
-}
 //# 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,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"}
+{"version":3,"file":"SessionExecution.d.ts","sourceRoot":"","sources":["../../../src/types/session/SessionExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E;;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,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;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,cAAc,CAAC,CAAC;IAEtC,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CAEzB"}

package/bin/types/session/SessionExecution.js

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - `SessionTurnExecutionInput` 表示上层 Turn 执行入口输入。
- * - `SessionStepExecutionInput` 表示 Executor 通过 Composer 装配后的 Step 输入。
+ * - `SessionStepExecutionInput` 表示执行器收到的、已装配完成的一步输入。
  * - 输出只返回执行结果；Assistant Message 通过显式输出端口写入唯一事实源。
  */
 export {};

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

@@ -11,7 +11,5 @@ export interface SessionPendingInteractionRuntime {
     request: SessionInteractionRequest;
     /** 兑现原执行等待 Promise 的回调。 */
     resolve: (result: SessionInteractionResult) => void;
-    /** 自动过期计时器；没有 expires_at 时省略。 */
-    timer?: ReturnType<typeof setTimeout>;
 }
 //# sourceMappingURL=SessionInteractions.d.ts.map