@downcity/agent 1.1.438 → 1.1.445

package/bin/session/{runtime → loop}/SessionTurnContext.js

@@ -3,8 +3,8 @@
  *
  * 关键点（中文）
  * - Session 创建并拥有上下文，Executor 和 Tool 通过领域分区协作。
- * - 所有可变数组、Plugin lease 与取消监听都封装在本模块内。
- * - Plugin 每次只获得新建的只读快照，不能越过扩展边界访问内核运行能力。
+ * - 所有可变数组、Power lease 与取消监听都封装在本模块内。
+ * - Power 每次只获得新建的只读快照，不能越过扩展边界访问内核运行能力。
  */
 import { normalize_session_origin } from "@downcity/type";
 /** SessionTurnContext 的唯一内置实现。 */
@@ -12,18 +12,16 @@ class DefaultSessionTurnContext {
     init;
     session;
     interactions;
-    shell;
     abort_controller = new AbortController();
     upstream_abort_signal;
     abort_from_upstream;
     disposed = false;
     workspace_env_snapshot;
     agent_systems_snapshot = Object.freeze([]);
-    hook_scope;
-    /** 整个 Turn 共享的 Plugin 动态上下文，不随 Step lease 切换而失效。 */
-    plugin_context_blocks_snapshot = Object.freeze([]);
+    /** 整个 Turn 共享的扩展动态上下文。 */
+    power_context_blocks_snapshot = Object.freeze([]);
     /** 并发或重复解析时复用的唯一 Promise。 */
-    plugin_context_blocks_promise;
+    power_context_blocks_promise;
     observed_user_messages = [];
     pending_assistant_parts = [];
     turn_effects = [];
@@ -50,11 +48,6 @@ class DefaultSessionTurnContext {
             ...(project_root ? { project_root } : {}),
         });
         this.interactions = init.interactions;
-        this.shell = Object.freeze({
-            ...(init.shell_approval_gateway
-                ? { approval_gateway: init.shell_approval_gateway }
-                : {}),
-        });
         this.upstream_abort_signal = init.abort_signal;
         this.abort_from_upstream = () => {
             if (!this.abort_controller.signal.aborted) {
@@ -84,11 +77,8 @@ class DefaultSessionTurnContext {
             get agent_systems() {
                 return context.agent_systems_snapshot;
             },
-            get hooks() {
-                return context.hook_scope;
-            },
-            get plugin_context_blocks() {
-                return context.plugin_context_blocks_snapshot;
+            get power_context_blocks() {
+                return context.power_context_blocks_snapshot;
             },
             commit: (input) => {
                 context.workspace_env_snapshot = Object.freeze({
@@ -98,15 +88,7 @@ class DefaultSessionTurnContext {
                     ...input.agent_systems,
                 ]);
             },
-            replace_hooks: async (hooks) => {
-                const previous = context.hook_scope;
-                context.hook_scope = hooks;
-                if (previous && previous !== hooks)
-                    await previous.close();
-            },
-            resolve_plugin_context_blocks: async (resolver) => await context.resolve_plugin_context_blocks(resolver),
-            release: async () => await context.release_extensions(),
-            hook_context: (call_id) => context.create_hook_context(call_id),
+            resolve_power_context_blocks: async (resolver) => await context.resolve_power_context_blocks(resolver),
         });
         this.input = Object.freeze({
             observe_user_message: (message) => {
@@ -154,43 +136,19 @@ class DefaultSessionTurnContext {
             snapshot: () => Object.freeze([...context.turn_effects]),
         });
     }
-    /** 每个 Turn 只执行一次 Plugin 动态上下文解析，并保存不可变快照。 */
-    async resolve_plugin_context_blocks(resolver) {
-        this.plugin_context_blocks_promise ??= (async () => {
+    /** 每个 Turn 只执行一次 Power 动态上下文解析，并保存不可变快照。 */
+    async resolve_power_context_blocks(resolver) {
+        this.power_context_blocks_promise ??= (async () => {
             const blocks = await resolver();
-            this.plugin_context_blocks_snapshot = Object.freeze((Array.isArray(blocks) ? blocks : []).map((block) => Object.freeze({
+            this.power_context_blocks_snapshot = Object.freeze((Array.isArray(blocks) ? blocks : []).map((block) => Object.freeze({
                 ...block,
                 ...(block.citations
                     ? { citations: Object.freeze([...block.citations]) }
                     : {}),
             })));
-            return this.plugin_context_blocks_snapshot;
+            return this.power_context_blocks_snapshot;
         })();
-        return await this.plugin_context_blocks_promise;
-    }
-    /** 为 City 扩展生成不共享根对象引用的只读快照。 */
-    create_hook_context(call_id) {
-        const normalized_call_id = String(call_id || "").trim();
-        return Object.freeze({
-            session_id: this.session.session_id,
-            session_origin: this.session.origin,
-            turn_id: this.session.turn_id,
-            ...(normalized_call_id ? { call_id: normalized_call_id } : {}),
-            ...(this.session.project_root
-                ? { project_root: this.session.project_root }
-                : {}),
-            ...(this.workspace_env_snapshot
-                ? { workspace_env: this.workspace_env_snapshot }
-                : {}),
-            agent_systems: this.agent_systems_snapshot,
-            abort_signal: this.abort_controller.signal,
-        });
-    }
-    /** 释放当前 Step 捕获的 Plugin Hook 作用域。 */
-    async release_extensions() {
-        const extensions = this.hook_scope;
-        this.hook_scope = undefined;
-        await extensions?.close();
+        return await this.power_context_blocks_promise;
     }
     /** 闭合当前运行拥有的全部资源。 */
     async dispose() {
@@ -198,21 +156,10 @@ class DefaultSessionTurnContext {
             return;
         this.disposed = true;
         this.upstream_abort_signal?.removeEventListener("abort", this.abort_from_upstream);
-        await this.release_extensions();
     }
 }
 /** 创建一次由 Session Turn 拥有的统一执行上下文。 */
 export function create_session_turn_context(init) {
     return new DefaultSessionTurnContext(init);
 }
-/** 为非 Turn 的 system 查询创建 Plugin 可读取的 Session 快照。 */
-export function create_session_hook_context(input) {
-    return Object.freeze({
-        session_id: input.session_id,
-        session_origin: Object.freeze(normalize_session_origin(input.session_origin)),
-        project_root: input.project_root,
-        workspace_env: Object.freeze({ ...input.workspace_env }),
-        agent_systems: Object.freeze([...input.agent_systems]),
-    });
-}
 //# sourceMappingURL=SessionTurnContext.js.map

package/bin/session/loop/SessionTurnContext.js.map

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

package/bin/session/loop/SessionTurnFileDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurnFileDiff.d.ts","sourceRoot":"","sources":["../../../src/session/loop/SessionTurnFileDiff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EACV,8BAA8B,EAC9B,+BAA+B,EAChC,MAAM,wCAAwC,CAAC;AAGhD,2DAA2D;AAC3D,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED,2BAA2B;AAC3B,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,+BAA+B,GACrC,IAAI,CA0BN"}

package/bin/session/{runtime → loop}/SessionTurnFileDiff.js

@@ -5,7 +5,7 @@
  * warning，不得反向改变 Turn 结果。
  */
 import { nanoid } from "nanoid";
-import { build_session_turn_file_diff, build_session_turn_file_diff_summary, } from "../../session/messages/SessionTurnFileDiffBuilder.js";
+import { build_session_turn_file_diff, build_session_turn_file_diff_summary, } from "../../session/loop/SessionTurnFileDiffBuilder.js";
 import { SESSION_TURN_FILE_DIFF_DATA_TYPE } from "../../session/messages/SessionTurnFileDiffData.js";
 /** 把当前 Turn 成功的结构化文件修改写入 canonical Assistant data part。 */
 export async function append_session_turn_file_diff(input) {

package/bin/session/loop/SessionTurnFileDiff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurnFileDiff.js","sourceRoot":"","sources":["../../../src/session/loop/SessionTurnFileDiff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,GACrC,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,gCAAgC,EAAE,MAAM,+CAA+C,CAAC;AAOjG,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAAqC;IAErC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,4BAA4B,CAC5C,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CACtC,CAAC;QACF,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,KAAK,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;gBAChD,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,gCAAgC;gBAC3C,OAAO,EAAE,kBAAkB,KAAK,CAAC,OAAO,EAAE;gBAC1C,IAAI,EAAE;oBACJ,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBACpC,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,KAAK,EAAE,IAAI,CAAC,KAAK;qBAClB,CAAC,CAAC;oBACH,SAAS,EAAE,SAAS,CAAC,SAAS;oBAC9B,SAAS,EAAE,SAAS,CAAC,SAAS;iBAC/B;aACF,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,qBAAqB,CACzB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,OAAO,EACb,yCAAyC,EACzC,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,8BAA8B,CAC5C,KAAsC;IAEtC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,oCAAoC,CAClD,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,OAAO,CACd,CAAC;QACF,IAAI,OAAO,CAAC,WAAW,KAAK,CAAC;YAAE,OAAO;QACtC,KAAK,CAAC,OAAO,CAAC;YACZ,WAAW,EAAE,MAAM,EAAE;YACrB,OAAO,EAAE,WAAW;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,qBAAqB,CACxB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,OAAO,EACb,0CAA0C,EAC1C,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED,oCAAoC;AACpC,KAAK,UAAU,qBAAqB,CAClC,MAAc,EACd,UAAkB,EAClB,OAAe,EACf,OAAe,EACf,KAAc;IAEd,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,OAAO,EAAE,EAAE;YAC7C,UAAU;YACV,OAAO;YACP,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;AACH,CAAC"}

package/bin/session/{messages → loop}/SessionTurnFileDiffBuilder.d.ts

@@ -6,10 +6,10 @@
  * - 不读取 Turn 结束时的实时工作树，因此 Shell 和外部进程不会被反向归属。
  * - 同一文件的修改状态无法连续证明时直接忽略，避免把外部插入的内容伪装成本轮修改。
  */
-import type { RuntimeToolEffect } from "@downcity/type";
+import type { ToolEffect } from "@downcity/type";
 import type { SessionTurnFileDiffData, SessionTurnFileDiffSummary } from "@downcity/type";
 /** 把当前 Turn effects 中的结构化文件修改收敛为可持久化 Diff。 */
-export declare function build_session_turn_file_diff(workspace_path: string, effects: readonly RuntimeToolEffect[]): SessionTurnFileDiffData | undefined;
+export declare function build_session_turn_file_diff(workspace_path: string, effects: readonly ToolEffect[]): SessionTurnFileDiffData | undefined;
 /** 从当前 Turn effects 收敛只含统计的实时摘要，供 Thinking 状态行轻量展示。 */
-export declare function build_session_turn_file_diff_summary(workspace_path: string, effects: readonly RuntimeToolEffect[]): SessionTurnFileDiffSummary;
+export declare function build_session_turn_file_diff_summary(workspace_path: string, effects: readonly ToolEffect[]): SessionTurnFileDiffSummary;
 //# sourceMappingURL=SessionTurnFileDiffBuilder.d.ts.map

package/bin/session/loop/SessionTurnFileDiffBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurnFileDiffBuilder.d.ts","sourceRoot":"","sources":["../../../src/session/loop/SessionTurnFileDiffBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMjD,OAAO,KAAK,EAEV,uBAAuB,EAEvB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AAaxB,8CAA8C;AAC9C,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,SAAS,UAAU,EAAE,GAC7B,uBAAuB,GAAG,SAAS,CAQrC;AAED,uDAAuD;AACvD,wBAAgB,oCAAoC,CAClD,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,SAAS,UAAU,EAAE,GAC7B,0BAA0B,CAO5B"}

package/bin/session/loop/SessionTurnFileDiffBuilder.js.map

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

package/bin/session/messages/ApprovalInteraction.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 审批交互封装。
+ *
+ * 关键点（中文）
+ * - 审批比提问多两件事：读审批模式、解释「批准 / 拒绝」。这两件事属于审批自己。
+ * - `always-allow` 时直接返回批准，**不发起交互**：通用原语不知道审批模式的存在。
+ * - 通用原语只认识信封与 type 字符串，本类负责把 `approval` 这个类型的 payload 讲通。
+ */
+import type { SessionApprovalDecision, SessionApprovalMode, SessionApprovalPort, SessionApprovalRequestInput, SessionInteractionPort } from "@downcity/type";
+/** 把一次高风险操作提交给用户裁定。 */
+export declare class ApprovalInteraction implements SessionApprovalPort {
+    private readonly interactions;
+    private readonly read_mode;
+    constructor(options: {
+        /** 当前 Session 的通用交互原语。 */
+        interactions: SessionInteractionPort;
+        /** 读取当前审批模式；每次调用实时取值，模式变更立即生效。 */
+        read_mode: () => SessionApprovalMode;
+    });
+    /**
+     * 请求一次审批。
+     *
+     * 关键点（中文）
+     * - `always-allow` 时不发起交互，直接返回批准；核心不参与该判断。
+     * - 其余情况发起 `approval` 交互，并把终态收敛为领域决定。
+     * - 非用户参与的结果（取消、失败）一律按未放行处理。
+     */
+    request(input: SessionApprovalRequestInput): Promise<SessionApprovalDecision>;
+}
+//# sourceMappingURL=ApprovalInteraction.d.ts.map

package/bin/session/messages/ApprovalInteraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApprovalInteraction.d.ts","sourceRoot":"","sources":["../../../src/session/messages/ApprovalInteraction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EAEvB,MAAM,gBAAgB,CAAC;AAGxB,uBAAuB;AACvB,qBAAa,mBAAoB,YAAW,mBAAmB;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;gBAE1C,OAAO,EAAE;QACnB,0BAA0B;QAC1B,YAAY,EAAE,sBAAsB,CAAC;QACrC,kCAAkC;QAClC,SAAS,EAAE,MAAM,mBAAmB,CAAC;KACtC;IAKD;;;;;;;OAOG;IACG,OAAO,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAuBpF"}

package/bin/session/messages/ApprovalInteraction.js

@@ -0,0 +1,61 @@
+/**
+ * 审批交互封装。
+ *
+ * 关键点（中文）
+ * - 审批比提问多两件事：读审批模式、解释「批准 / 拒绝」。这两件事属于审批自己。
+ * - `always-allow` 时直接返回批准，**不发起交互**：通用原语不知道审批模式的存在。
+ * - 通用原语只认识信封与 type 字符串，本类负责把 `approval` 这个类型的 payload 讲通。
+ */
+import { SESSION_APPROVAL_RESPONSE_SCHEMA } from "@downcity/type";
+/** 把一次高风险操作提交给用户裁定。 */
+export class ApprovalInteraction {
+    interactions;
+    read_mode;
+    constructor(options) {
+        this.interactions = options.interactions;
+        this.read_mode = options.read_mode;
+    }
+    /**
+     * 请求一次审批。
+     *
+     * 关键点（中文）
+     * - `always-allow` 时不发起交互，直接返回批准；核心不参与该判断。
+     * - 其余情况发起 `approval` 交互，并把终态收敛为领域决定。
+     * - 非用户参与的结果（取消、失败）一律按未放行处理。
+     */
+    async request(input) {
+        if (this.read_mode() === "always-allow") {
+            return { approved: true, auto_approved: true };
+        }
+        const handle = await this.interactions.request({
+            type: "approval",
+            turn_id: input.turn_id,
+            tool_call_id: input.tool_call_id,
+            ...(input.tool_name ? { tool_name: input.tool_name } : {}),
+            ...(input.source_type ? { source_type: input.source_type } : {}),
+            ...(input.title ? { title: input.title } : {}),
+            ...(input.description ? { description: input.description } : {}),
+            payload: input.payload,
+            response_schema: SESSION_APPROVAL_RESPONSE_SCHEMA,
+        });
+        const result = await handle.result;
+        return {
+            approved: is_approved(result),
+            auto_approved: false,
+            approval_id: handle.interaction_id,
+        };
+    }
+}
+/** 判断一次 Interaction 终态是否构成用户批准。 */
+function is_approved(result) {
+    if (result.status !== "resolved")
+        return false;
+    if (result.response.type !== "approval" || result.response.outcome !== "resolved") {
+        return false;
+    }
+    const payload = result.response.payload;
+    if (!payload || typeof payload !== "object" || Array.isArray(payload))
+        return false;
+    return payload.decision === "approved";
+}
+//# sourceMappingURL=ApprovalInteraction.js.map

package/bin/session/messages/ApprovalInteraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApprovalInteraction.js","sourceRoot":"","sources":["../../../src/session/messages/ApprovalInteraction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAC;AAElE,uBAAuB;AACvB,MAAM,OAAO,mBAAmB;IACb,YAAY,CAAyB;IACrC,SAAS,CAA4B;IAEtD,YAAY,OAKX;QACC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,KAAkC;QAC9C,IAAI,IAAI,CAAC,SAAS,EAAE,KAAK,cAAc,EAAE,CAAC;YACxC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;YAC7C,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO,EAAE,KAAK,CAAC,OAAgB;YAC/B,eAAe,EAAE,gCAAgC;SAClD,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;QACnC,OAAO;YACL,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC;YAC7B,aAAa,EAAE,KAAK;YACpB,WAAW,EAAE,MAAM,CAAC,cAAc;SACnC,CAAC;IACJ,CAAC;CACF;AAED,mCAAmC;AACnC,SAAS,WAAW,CAAC,MAAgC;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAClF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;IACxC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACpF,OAAQ,OAAgD,CAAC,QAAQ,KAAK,UAAU,CAAC;AACnF,CAAC"}

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

@@ -4,9 +4,9 @@
  * Model stream 只更新内存投影并发布实时 Mutation；完整 Step、Tool、Interaction
  * 与 Message 收口才通过一次 SQLite 事务提交稳定快照。数据库不承担流事件日志职责。
  */
-import type { SessionAgentInteractionPart, SessionAgentMessagePart } from "@downcity/type";
+import type { SessionAgentInteraction, SessionAgentMessagePart } from "@downcity/type";
 import type { SessionInteractionCloseInput, SessionInteractionRequest, SessionInteractionResponse } from "@downcity/type";
-import type { SessionStreamingToolLocation } from "../../types/session/SessionTool.js";
+import type { SessionOpenMessageToolLocation } from "../../types/session/SessionTool.js";
 import type { SessionAgentMessageStateOptions } from "../../types/session/SessionAgentMessageState.js";
 /** 管理 Agent Message 运行投影、语义检查点与 Interaction 原子状态。 */
 export declare class SessionAgentMessageState {
@@ -14,9 +14,13 @@ export declare class SessionAgentMessageState {
     private readonly options;
     /** 同一 Agent Message 的检查点严格串行，不同 Message 可以独立提交。 */
     private readonly write_chains;
-    private readonly interaction_writer;
     constructor(options: SessionAgentMessageStateOptions);
-    /** 只在内存中创建或替换一个 Part，并立即发布实时完整 Part。 */
+    /**
+     * 只在内存中创建或替换一个 Part，并立即发布实时完整 Part。
+     *
+     * 内容未变化时不发布：Tool 的 ready 状态会被模型事件与输入校验先后置为同一值，
+     * 无条件下发会产生同 revision、同内容的重复 Mutation。
+     */
     project_part(message_id: string, part: SessionAgentMessagePart): void;
     /** 只在内存中追加文本、推理或 Tool 输入增量，并立即发布 delta。 */
     project_delta(message_id: string, part_id: string, type: "text" | "reasoning" | "tool_input", delta: string, tool_call_id?: string): void;
@@ -24,27 +28,52 @@ export declare class SessionAgentMessageState {
     checkpoint(message_id: string): Promise<void>;
     /** 校验 Step Part identity 后原子提交模型给出的最终快照。 */
     commit_step(message_id: string, parts: SessionAgentMessagePart[]): Promise<void>;
-    /** 原子追加一组非流式 Agent Parts。 */
-    commit_parts(message_id: string, parts: readonly SessionAgentMessagePart[]): Promise<void>;
+    /**
+     * 原子追加或替换一组非流式 Agent Parts。
+     *
+     * 同 part_id 已存在时原地替换并保留原 sequence；不存在时追加到 Message 末尾。
+     * options.publish_mutation 为 false 时只更新 canonical 快照而不发布 Mutation。
+     */
+    commit_parts(message_id: string, parts: readonly SessionAgentMessagePart[], options?: {
+        publish_mutation?: boolean;
+    }): Promise<void>;
     /** 丢弃当前未提交 Step 投影，并向订阅方恢复最近持久化快照。 */
     rollback_projection(message_id: string): Promise<void>;
     /** 收口 Agent Message，并将局部非终态与失败原因一并原子提交。 */
     complete(message_id: string, outcome: "completed" | "stopped" | "failed", error?: string): Promise<void>;
-    /** 读取当前流式 Agent Message 中的指定 Tool Part。 */
-    find_streaming_tool(tool_call_id: string): SessionStreamingToolLocation | undefined;
-    /** 返回当前 Session 全部待响应 Interaction。 */
-    list_pending_interactions(): SessionAgentInteractionPart[];
-    /** 持久化 Interaction 请求及关联 Tool 状态。 */
-    request_interaction(request: SessionInteractionRequest): Promise<SessionAgentInteractionPart>;
-    /** 持久化 Interaction 响应及关联 Tool 状态。 */
-    resolve_interaction(interaction_id: string, response: SessionInteractionResponse): Promise<SessionAgentInteractionPart>;
-    /** 持久化 Interaction 关闭及关联 Tool 状态。 */
-    close_interaction(interaction_id: string, input: SessionInteractionCloseInput): Promise<SessionAgentInteractionPart>;
+    /** 读取当前可写 Agent Message 中的指定 Tool Part。 */
+    find_tool_in_open_message(tool_call_id: string): SessionOpenMessageToolLocation | undefined;
+    /** 返回当前 Session 中全部等待用户响应的 Interaction。 */
+    list_pending_interactions(): SessionAgentInteraction[];
+    /**
+     * 原子创建 Interaction，并把所属 Tool 转为 waiting-user。
+     *
+     * Interaction 是 Tool Part 的从属数据：Tool 在等待响应时阻塞，因此两者的转换
+     * 必须在同一次快照提交内完成，否则会出现“Interaction pending 但 Tool 未等待”的中间态。
+     */
+    request_interaction(request: SessionInteractionRequest): Promise<SessionAgentInteraction>;
+    /** 原子保存用户响应，并按 Interaction 结果恢复或终止所属 Tool。 */
+    resolve_interaction(interaction_id: string, response: SessionInteractionResponse): Promise<SessionAgentInteraction>;
+    /** 原子结束未响应 Interaction，并把所属 Tool 标记为失败。 */
+    close_interaction(interaction_id: string, input: SessionInteractionCloseInput): Promise<SessionAgentInteraction>;
     /** 原子保存完整 Message 快照；变更比较以数据库事实而非运行投影为准。 */
     private persist_snapshot;
     /** 串行执行同一 Message 的语义检查点。 */
     private enqueue_write;
-    /** 读取当前运行投影中的可写 Agent Message。 */
-    private require_streaming_agent;
+    /**
+     * 在所属 Tool 的串行写链内执行一次 Interaction 变更。
+     *
+     * Interaction 与 Tool 必须整体提交：先定位 Tool，再在同一串行段内读取最新快照并替换它，
+     * 避免两个并发响应基于过期快照各自提交。
+     */
+    private run_interaction_write;
+    /** 查找指定 Interaction 及其所属 Tool 与 Message。 */
+    private find_interaction;
+    /** 读取指定 Interaction，否则抛出稳定领域错误。 */
+    private require_interaction;
+    /** 读取指定 pending Interaction，否则拒绝重复响应终态 Interaction。 */
+    private require_pending_interaction;
+    /** 读取当前运行投影中的可写 Agent Message；只有 writer 持有的消息可写。 */
+    private require_writable_agent;
 }
 //# sourceMappingURL=SessionAgentMessageState.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SessionAgentMessageState.d.ts","sourceRoot":"","sources":["../../../src/session/messages/SessionAgentMessageState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAEV,2BAA2B,EAE3B,uBAAuB,EAIxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,6CAA6C,CAAC;AAEnG,qDAAqD;AACrD,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoC;IACjE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAkC;gBAEzD,OAAO,EAAE,+BAA+B;IAapD,wCAAwC;IACxC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,IAAI;IA4BrE,2CAA2C;IAC3C,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,EACzC,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI;IA2CP,8BAA8B;IACxB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,4CAA4C;IACtC,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,uBAAuB,EAAE,GAC/B,OAAO,CAAC,IAAI,CAAC;IAgBhB,6BAA6B;IACvB,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,uBAAuB,EAAE,GACxC,OAAO,CAAC,IAAI,CAAC;IAiBhB,sCAAsC;IAChC,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D,2CAA2C;IACrC,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,EAC3C,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAwDhB,2CAA2C;IAC3C,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,4BAA4B,GAAG,SAAS;IAYnF,sCAAsC;IACtC,yBAAyB,IAAI,2BAA2B,EAAE;IAI1D,qCAAqC;IAC/B,mBAAmB,CACvB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,2BAA2B,CAAC;IAIvC,qCAAqC;IAC/B,mBAAmB,CACvB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,0BAA0B,GACnC,OAAO,CAAC,2BAA2B,CAAC;IAIvC,qCAAqC;IAC/B,iBAAiB,CACrB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,2BAA2B,CAAC;IAIvC,4CAA4C;YAC9B,gBAAgB;IA0B9B,6BAA6B;YACf,aAAa;IAe3B,kCAAkC;IAClC,OAAO,CAAC,uBAAuB;CAYhC"}
+{"version":3,"file":"SessionAgentMessageState.d.ts","sourceRoot":"","sources":["../../../src/session/messages/SessionAgentMessageState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAEV,uBAAuB,EAEvB,uBAAuB,EAGxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,6CAA6C,CAAC;AAYnG,qDAAqD;AACrD,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoC;gBAErD,OAAO,EAAE,+BAA+B;IAKpD;;;;;OAKG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,IAAI;IA6BrE,2CAA2C;IAC3C,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,EACzC,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI;IAgDP,8BAA8B;IACxB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,4CAA4C;IACtC,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,uBAAuB,EAAE,GAC/B,OAAO,CAAC,IAAI,CAAC;IAgBhB;;;;;OAKG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,uBAAuB,EAAE,EACzC,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GACvC,OAAO,CAAC,IAAI,CAAC;IAkBhB,sCAAsC;IAChC,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D,2CAA2C;IACrC,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,EAC3C,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA6DhB,2CAA2C;IAC3C,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,8BAA8B,GAAG,SAAS;IAY3F,2CAA2C;IAC3C,yBAAyB,IAAI,uBAAuB,EAAE;IAgBtD;;;;;OAKG;IACG,mBAAmB,CACvB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,uBAAuB,CAAC;IAmCnC,8CAA8C;IACxC,mBAAmB,CACvB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,0BAA0B,GACnC,OAAO,CAAC,uBAAuB,CAAC;IAgCnC,2CAA2C;IACrC,iBAAiB,CACrB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,uBAAuB,CAAC;IAwBnC,4CAA4C;YAC9B,gBAAgB;IAqC9B,6BAA6B;YACf,aAAa;IAe3B;;;;;OAKG;YACW,qBAAqB;IAgBnC,4CAA4C;IAC5C,OAAO,CAAC,gBAAgB;IAkBxB,mCAAmC;IACnC,OAAO,CAAC,mBAAmB;IAM3B,uDAAuD;IACvD,OAAO,CAAC,2BAA2B;IAYnC,oDAAoD;IACpD,OAAO,CAAC,sBAAsB;CAS/B"}