@ai-agent-forge/agent-forge 0.86.3 → 0.86.5

package/dist/core/agent-session.js

@@ -1578,22 +1578,48 @@ export class AgentSession {
      * Why the active turn was aborted, following codex's TurnAbortReason
      * (protocol.rs:4173). The interruption marker's visible text stays fixed;
      * the reason rides the marker `details` for hosts and plugins.
+     *
+     * 中断分级（设计 §4.2，2026-10-02）：缺省级联终止全部后台委派（原契约）；
+     * `cancelAgentTasks: false` 只停本回合（模型流/工具/bash），后台 fence 不动
+     * ——两段式 Esc 的第一次按键走这一档。
      */
-    async abort(reason) {
+    async abort(reason, options) {
         this._pendingAbortReason = reason ?? "interrupted";
         this._lastAbortReason = this._pendingAbortReason;
         // 级联取消子 agent 任务（D-044 §4.2）：fire-and-forget，不阻塞父会话自身的 abort。
-        this._agentTaskScopeAbortController.abort(reason ?? "interrupted");
+        const cancelAgentTasks = options?.cancelAgentTasks !== false;
+        if (cancelAgentTasks) {
+            this._agentTaskScopeAbortController.abort(reason ?? "interrupted");
+        }
         try {
             await this._abortInternal();
             this._appendTurnInterruptedMarker();
         }
         finally {
             this._pendingAbortReason = undefined;
-            // epoch 刷新：旧 signal 已 spent，刷新后后续回合提交的任务绑到新信号，不会被立即取消。
-            this._agentTaskScopeAbortController = new AbortController();
+            // epoch 刷新只在当前 fence 确已 spent 时发生（复审 2026-10-02：重叠
+            // abort 下无条件刷新可能把一个从未 abort 的新 controller 再替换一次，
+            // 两次刷新之间创建的任务会静默失联；spended 判定堵住所有交错变体）。
+            if (this._agentTaskScopeAbortController.signal.aborted) {
+                this._agentTaskScopeAbortController = new AbortController();
+            }
         }
     }
+    /**
+     * 只级联终止全部后台委派（设计 §4.2 中断分级）：中止 fence 并刷新 epoch，
+     * 不中止当前回合——`/stop-agents` 命令的唯一执行面。无后台任务时为幂等 no-op。
+     */
+    abortAgentTasks(reason) {
+        this._agentTaskScopeAbortController.abort(reason ?? "interrupted");
+        this._agentTaskScopeAbortController = new AbortController();
+    }
+    /**
+     * 活跃后台委派数（设计 §4.2 中断分级）：capability runtime 活跃任务集合的
+     * 有界投影——创建即入；终态经投影按状态过滤，成员随 dispose 释放。供宿主做中断分级提示与状态显示。
+     */
+    getActiveAgentTaskCount() {
+        return this._capabilityRuntime?.getActiveAgentTaskCount() ?? 0;
+    }
     /**
      * Abort without the interruption marker; used by internal flows (compaction,
      * teardown) that abort for their own bookkeeping. Takes no reason: the abort