@zhushanwen/zcode-subagent-cli 0.1.2 → 0.2.1

package/dist/{chunk-IIAABOER.js → chunk-WQ7NVGKB.js}

@@ -28,6 +28,9 @@ var ZCODE_APPSERVER_ABORT_GRACE_MS = 3e3;
 var ZCODE_APPSERVER_ERR_MODEL_CONFIG_MISSING = -32603;
 var ZCODE_APPSERVER_ERR_BUSY_SESSION = -32010;
 var ZCODE_APPSERVER_HARVEST_GRACE_MS = 1e3;
+function isFailedTerminalStatus(status) {
+  return status === "failed" || status === "error";
+}
 
 // src/db-path.ts
 import * as os from "os";
@@ -680,6 +683,11 @@ var AppServerConnection = class {
   reqSeq = 0;
   /** stderr 滚动缓冲（代级：崩溃诊断用）。 */
   stderrTail = "";
+  /**
+   * stderr tee 落盘流（D6-⑦；merge 裁决：旋转走 logs/stderr-rotation 的路径式
+   * rotateStderrLogIfNeeded——W5 边界禁 import subagent-core 的 SizeRotatedAppendStream，
+   * 常驻流改裸 WriteStream + 按次轮转检查，帽语义等价）。
+   */
   stderrStream = null;
   stderrStreamFailed = false;
   /**
@@ -1366,7 +1374,13 @@ var SessionChannel = class {
     });
     const turn = {
       sessionId,
-      callbacks: { onTextDelta: opts.onTextDelta, onThinkingDelta: opts.onThinkingDelta },
+      callbacks: {
+        onTextDelta: opts.onTextDelta,
+        onThinkingDelta: opts.onThinkingDelta,
+        // [PR3] tool 执行期活性回调（SessionTurnCallbacks.onActivity 注释——宿主侧
+        // 无进展守护的工具执行期刷新面）
+        onActivity: opts.onActivity
+      },
       settled: false,
       deltas: [],
       finalText: void 0,
@@ -1482,7 +1496,9 @@ var SessionChannel = class {
     if (payload === void 0) return;
     this.refreshIdle(turn);
     if (this.applyFinalFrame(turn, payload)) return;
-    this.applyStreamDelta(turn, payload);
+    if (!this.applyStreamDelta(turn, payload) && !turn.settled) {
+      turn.callbacks.onActivity?.();
+    }
   }
   /**
    * 收尾帧判定与吸收（A.2 ⑤ 两种形态：payload.response / stopReason+content 变体）。
@@ -1506,9 +1522,12 @@ var SessionChannel = class {
   /** 增量 delta 分发：非空 delta 入账 + 回调；终态后迟到丢弃（不变量 2）。
    *  kind 区分两通道（F2）：reasoning_delta 只走 thinking 回调（不入 deltas 账本
    *  ——deltas 是 response 兜底聚合，推理文本不是答案正文）；text_delta / kind
-   *  缺席走 text 路径。 */
+   *  缺席走 text 路径。
+   *  返回值（[PR3]）：帧被 delta 路径消费（thinking 或 text，回调若注册则已触发）
+   *  → true；无 delta / 空 delta / 终态后迟到丢弃 → false（handleSessionEvent 据
+   *  此分流 onActivity——delta 帧已是宿主可见进展，不双发活性信号）。 */
   applyStreamDelta(turn, payload) {
-    if (typeof payload.delta !== "string" || payload.delta === "") return;
+    if (typeof payload.delta !== "string" || payload.delta === "") return false;
     if (turn.settled) {
       logger2.warn(
         `\u7EC8\u6001\u540E\u8FDF\u5230\u7684 delta \u4E22\u5F03\uFF08\u4F1A\u8BDD ${turn.sessionId}\uFF0C\u4E0D\u53D8\u91CF 2\uFF1Aresolve \u540E\u4E0D\u518D\u53D1\u4E8B\u4EF6\uFF09: ${payload.delta.slice(
@@ -1516,14 +1535,15 @@ var SessionChannel = class {
           DELTA_LOG_CHARS
         )}`
       );
-      return;
+      return false;
     }
     if (payload.kind === "reasoning_delta") {
       turn.callbacks.onThinkingDelta?.(payload.delta);
-      return;
+      return true;
     }
     turn.deltas.push(payload.delta);
     turn.callbacks.onTextDelta?.(payload.delta);
+    return true;
   }
   handleTelemetry(params) {
     if (!isRecord3(params)) return;
@@ -1543,13 +1563,38 @@ var SessionChannel = class {
     turn.lastTerminalStatus = status;
     this.recordTerminalError(turn, params);
     if (turn.settled) {
-      logger2.warn(
-        `\u6743\u5A01\u7EC8\u6001\u665A\u4E8E\u843D\u5B9A\u7ED3\u679C\u5230\u8FBE\uFF08\u4F1A\u8BDD ${turn.sessionId}\uFF0C\u5DF2\u843D\u5B9A source=${turn.terminal?.source}\uFF09\uFF1Aturn.terminal status="${status}" \u4EC5\u8BB0\u5F55\u4E0D\u6539\u5199\uFF08P0-1 D5\u2460\uFF09`
-      );
+      this.logLateTerminal(turn, status);
       return;
     }
     turn.settle({ status, source: "turn.terminal" });
   }
+  /**
+   * 已落定 turn 的迟到权威终态分级日志（P-Z2 后续：常态迟到降噪）。真机实证该
+   * 形态的唯一可达路径是 success 终态常态迟到（final-frame 先落定 + 权威
+   * turn.terminal 迟到）——即每个成功任务必经；原无条件 warn 经 SDK cli-entry
+   * 的 stderr 兜底 → runtime [rpc:stderr] 全量 console.error 链路，每个成功任务
+   * 产一条零异常区分度的 ERROR 级日志。按权威 status 分级（落定语义不动——
+   * lastTerminalStatus/lastTerminalError 的入账在上游无条件路径完成）：
+   *   - "success"：常态迟到，零日志；
+   *   - "interrupted"：用户中断形态，debug（stderr 兜底对 debug no-op——对齐
+   *     SDK logger CONSOLE_SINK 语义，host/log 反向请求侧仍可观测）；
+   *   - 失败类（isFailedTerminalStatus，与引擎失败分流同口径）与 unknown/未识别
+   *     status：保守 warn（原样 status 已写入文案）——假成功识破的防御面，理论
+   *     不可达但保留，宁可误报不静默。
+   */
+  logLateTerminal(turn, status) {
+    if (status === "success") return;
+    const message = `\u6743\u5A01\u7EC8\u6001\u665A\u4E8E\u843D\u5B9A\u7ED3\u679C\u5230\u8FBE\uFF08\u4F1A\u8BDD ${turn.sessionId}\uFF0C\u5DF2\u843D\u5B9A source=${turn.terminal?.source}\uFF09\uFF1Aturn.terminal status="${status}" \u4EC5\u8BB0\u5F55\u4E0D\u6539\u5199\uFF08P0-1 D5\u2460\uFF09`;
+    if (isFailedTerminalStatus(status)) {
+      logger2.warn(message);
+      return;
+    }
+    if (status === "interrupted") {
+      logger2.debug(message);
+      return;
+    }
+    logger2.warn(message);
+  }
   /** terminal 帧专属错误信息入账（⛔P-Z2 实证：真实 failed 终态的 errorCode/errorMessage
    *  只在 terminal 帧携带，read/delta 拿不到——先到/迟到都记录，消费层合成失败
    *  文案时优先采信）。二者均缺失时不挂 lastTerminalError 字段。 */
@@ -1835,6 +1880,11 @@ var ZcodeEngine = class {
       // 不变量 3a 的拼接比对不含 reasoning）
       onTextDelta: (delta) => ctx.onEvent?.({ type: "text_delta", delta }),
       onThinkingDelta: (delta) => ctx.onEvent?.({ type: "thinking_delta", delta }),
+      // [PR3] 工具执行期活性：非终态非增量的 session/event 帧（tool.updated progress
+      // 等，真机探针实证每 ~1s 一帧）→ activity 事件（零载荷纯活性信号——宿主无进展
+      // 守护对任何事件类型刷新；reducer no-op、不落 journal）。zcode 引擎
+      // conversation:"unsupported"，run 域是唯一发射面（无 chat 域接线）。
+      onActivity: () => ctx.onEvent?.({ type: "activity" }),
       onSessionCreated: (sessionId) => {
         currentSessionId = sessionId;
         rt.activeSessions.add(sessionId);
@@ -2061,6 +2111,17 @@ var ZcodeEngine = class {
     }
     await this.shutdownRuntimeAndDisposeChannel(rt);
   }
+  /**
+   * [u7a D5] 引擎在途只读快照：activeSessions 非空才算在途——poolKey 'shared' 的
+   * app-server **空闲常驻进程恒活，禁止按进程存在判定**（进程在 ≠ 在途，否则推迟
+   * 判定恒真、30min 上限从兜底变常态路径，设计 §3.3 D5 显式排除）。计数权威 =
+   * activeSessions（attempt 入 create 应答后 add / finally settle 后 delete，与
+   * dispose 的 close 帧目标集同一状态源，无双记账）。运行时未初始化（从未 run /
+   * 已 dispose）→ 恒 0。
+   */
+  inFlightSnapshot() {
+    return { inFlight: this.appserverRuntime?.activeSessions.size ?? 0 };
+  }
   /** 终态合成（extension-conventions 函数 80 行上限，从 run 提取）：aborted / run-failed / parsed 三分支。 */
   finalizeOutcome(task, ctx, final, usageAcc, startedAt) {
     const outcome = {
@@ -2129,17 +2190,6 @@ var ZcodeEngine = class {
     }
     for (const ev of synthesizeCoarseEvents(payload.response, payload.usage)) emit(ev);
   }
-  /**
-   * D1 可选面：zcode 首期不支持 conversation（capabilities 声明）——同步拒绝、
-   * 不创建进程，文案给可操作建议（A11）。
-   */
-  async interact(_handle, _action) {
-    return {
-      ok: false,
-      code: "engine_capability_unsupported",
-      message: "zcode \u5F15\u64CE\u4E0D\u652F\u6301 conversation \u4EA4\u4E92\u63A7\u5236\u9762\uFF08capabilities.conversation = 'unsupported'\uFF0C\u6BCF\u4EFB\u52A1\u81EA\u5305\u542B\u4F1A\u8BDD\uFF0C\u65E0\u540C\u8FDB\u7A0B idle \u590D\u7528\uFF09\u3002\u6062\u590D\u6307\u5F15\uFF1A\u6539\u7528\u5355\u6B21 subagent \u8C03\u7528\u91CD\u65B0\u6D3E\u53D1\u4EFB\u52A1\uFF0C\u6216\u4F7F\u7528 engine: 'pi'\uFF08chatMode idle \u590D\u7528\uFF0C\u652F\u6301 message/close/cancel\uFF09\u3002"
-    };
-  }
   /** [U7] 模型可发现性：v2 桌面登录态聚合（带凭据 provider × models），失败安全返回清单本身可能为空。 */
   listModels() {
     return listZcodeModels(this.deps.sources);
@@ -2339,9 +2389,6 @@ function authoritativeTerminalStatus(r) {
   if (r.lastTerminalStatus !== void 0) return r.lastTerminalStatus;
   return r.terminal.source === "turn.terminal" ? r.terminal.status : void 0;
 }
-function isFailedTerminalStatus(status) {
-  return status === "failed" || status === "error";
-}
 function parsedAppServerAttempt(task, r) {
   if (isFailedTerminalStatus(authoritativeTerminalStatus(r))) {
     return failedTerminalAppServerAttempt(r);
@@ -2526,7 +2573,7 @@ var EngineProtocolServer = class {
       }
     }
   }
-  /** 10 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
+  /** 9 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
   async dispatch(id, method, params) {
     const handler = this.methodHandlers[method];
     if (handler === void 0) {
@@ -2539,7 +2586,7 @@ var EngineProtocolServer = class {
     return handler(params);
   }
   /**
-   * 10 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
+   * 9 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
    * 与原 switch case 表达式一一对应）。
    */
   methodHandlers = {
@@ -2547,7 +2594,6 @@ var EngineProtocolServer = class {
     probe: (p) => this.engine.probe(probeParamsOf(p)),
     run: (p) => this.run(p),
     cancel: (p) => this.cancel(p),
-    interact: (p) => this.interact(p),
     read: (p) => this.read(p),
     listModels: () => ({ models: this.engine.listModels?.() ?? null }),
     validateModel: (p) => this.validateModel(p),
@@ -2623,9 +2669,6 @@ var EngineProtocolServer = class {
     if (active !== void 0) active.controller.abort(new Error(`cancelled by host: ${params.reason}`));
     return { ok: true };
   }
-  async interact(params) {
-    return this.engine.interact({ data: params.handle }, params.action);
-  }
   read(params) {
     return this.engine.read({ data: params.handle });
   }

package/dist/index.cjs

@@ -78,6 +78,9 @@ var ZCODE_APPSERVER_ABORT_GRACE_MS = 3e3;
 var ZCODE_APPSERVER_ERR_MODEL_CONFIG_MISSING = -32603;
 var ZCODE_APPSERVER_ERR_BUSY_SESSION = -32010;
 var ZCODE_APPSERVER_HARVEST_GRACE_MS = 1e3;
+function isFailedTerminalStatus(status) {
+  return status === "failed" || status === "error";
+}
 
 // src/registration.ts
 var import_subagent_engine_sdk10 = require("@zhushanwen/subagent-engine-sdk");
@@ -702,6 +705,11 @@ var AppServerConnection = class {
   reqSeq = 0;
   /** stderr 滚动缓冲（代级：崩溃诊断用）。 */
   stderrTail = "";
+  /**
+   * stderr tee 落盘流（D6-⑦；merge 裁决：旋转走 logs/stderr-rotation 的路径式
+   * rotateStderrLogIfNeeded——W5 边界禁 import subagent-core 的 SizeRotatedAppendStream，
+   * 常驻流改裸 WriteStream + 按次轮转检查，帽语义等价）。
+   */
   stderrStream = null;
   stderrStreamFailed = false;
   /**
@@ -1388,7 +1396,13 @@ var SessionChannel = class {
     });
     const turn = {
       sessionId,
-      callbacks: { onTextDelta: opts.onTextDelta, onThinkingDelta: opts.onThinkingDelta },
+      callbacks: {
+        onTextDelta: opts.onTextDelta,
+        onThinkingDelta: opts.onThinkingDelta,
+        // [PR3] tool 执行期活性回调（SessionTurnCallbacks.onActivity 注释——宿主侧
+        // 无进展守护的工具执行期刷新面）
+        onActivity: opts.onActivity
+      },
       settled: false,
       deltas: [],
       finalText: void 0,
@@ -1504,7 +1518,9 @@ var SessionChannel = class {
     if (payload === void 0) return;
     this.refreshIdle(turn);
     if (this.applyFinalFrame(turn, payload)) return;
-    this.applyStreamDelta(turn, payload);
+    if (!this.applyStreamDelta(turn, payload) && !turn.settled) {
+      turn.callbacks.onActivity?.();
+    }
   }
   /**
    * 收尾帧判定与吸收（A.2 ⑤ 两种形态：payload.response / stopReason+content 变体）。
@@ -1528,9 +1544,12 @@ var SessionChannel = class {
   /** 增量 delta 分发：非空 delta 入账 + 回调；终态后迟到丢弃（不变量 2）。
    *  kind 区分两通道（F2）：reasoning_delta 只走 thinking 回调（不入 deltas 账本
    *  ——deltas 是 response 兜底聚合，推理文本不是答案正文）；text_delta / kind
-   *  缺席走 text 路径。 */
+   *  缺席走 text 路径。
+   *  返回值（[PR3]）：帧被 delta 路径消费（thinking 或 text，回调若注册则已触发）
+   *  → true；无 delta / 空 delta / 终态后迟到丢弃 → false（handleSessionEvent 据
+   *  此分流 onActivity——delta 帧已是宿主可见进展，不双发活性信号）。 */
   applyStreamDelta(turn, payload) {
-    if (typeof payload.delta !== "string" || payload.delta === "") return;
+    if (typeof payload.delta !== "string" || payload.delta === "") return false;
     if (turn.settled) {
       logger2.warn(
         `\u7EC8\u6001\u540E\u8FDF\u5230\u7684 delta \u4E22\u5F03\uFF08\u4F1A\u8BDD ${turn.sessionId}\uFF0C\u4E0D\u53D8\u91CF 2\uFF1Aresolve \u540E\u4E0D\u518D\u53D1\u4E8B\u4EF6\uFF09: ${payload.delta.slice(
@@ -1538,14 +1557,15 @@ var SessionChannel = class {
           DELTA_LOG_CHARS
         )}`
       );
-      return;
+      return false;
     }
     if (payload.kind === "reasoning_delta") {
       turn.callbacks.onThinkingDelta?.(payload.delta);
-      return;
+      return true;
     }
     turn.deltas.push(payload.delta);
     turn.callbacks.onTextDelta?.(payload.delta);
+    return true;
   }
   handleTelemetry(params) {
     if (!isRecord3(params)) return;
@@ -1565,13 +1585,38 @@ var SessionChannel = class {
     turn.lastTerminalStatus = status;
     this.recordTerminalError(turn, params);
     if (turn.settled) {
-      logger2.warn(
-        `\u6743\u5A01\u7EC8\u6001\u665A\u4E8E\u843D\u5B9A\u7ED3\u679C\u5230\u8FBE\uFF08\u4F1A\u8BDD ${turn.sessionId}\uFF0C\u5DF2\u843D\u5B9A source=${turn.terminal?.source}\uFF09\uFF1Aturn.terminal status="${status}" \u4EC5\u8BB0\u5F55\u4E0D\u6539\u5199\uFF08P0-1 D5\u2460\uFF09`
-      );
+      this.logLateTerminal(turn, status);
       return;
     }
     turn.settle({ status, source: "turn.terminal" });
   }
+  /**
+   * 已落定 turn 的迟到权威终态分级日志（P-Z2 后续：常态迟到降噪）。真机实证该
+   * 形态的唯一可达路径是 success 终态常态迟到（final-frame 先落定 + 权威
+   * turn.terminal 迟到）——即每个成功任务必经；原无条件 warn 经 SDK cli-entry
+   * 的 stderr 兜底 → runtime [rpc:stderr] 全量 console.error 链路，每个成功任务
+   * 产一条零异常区分度的 ERROR 级日志。按权威 status 分级（落定语义不动——
+   * lastTerminalStatus/lastTerminalError 的入账在上游无条件路径完成）：
+   *   - "success"：常态迟到，零日志；
+   *   - "interrupted"：用户中断形态，debug（stderr 兜底对 debug no-op——对齐
+   *     SDK logger CONSOLE_SINK 语义，host/log 反向请求侧仍可观测）；
+   *   - 失败类（isFailedTerminalStatus，与引擎失败分流同口径）与 unknown/未识别
+   *     status：保守 warn（原样 status 已写入文案）——假成功识破的防御面，理论
+   *     不可达但保留，宁可误报不静默。
+   */
+  logLateTerminal(turn, status) {
+    if (status === "success") return;
+    const message = `\u6743\u5A01\u7EC8\u6001\u665A\u4E8E\u843D\u5B9A\u7ED3\u679C\u5230\u8FBE\uFF08\u4F1A\u8BDD ${turn.sessionId}\uFF0C\u5DF2\u843D\u5B9A source=${turn.terminal?.source}\uFF09\uFF1Aturn.terminal status="${status}" \u4EC5\u8BB0\u5F55\u4E0D\u6539\u5199\uFF08P0-1 D5\u2460\uFF09`;
+    if (isFailedTerminalStatus(status)) {
+      logger2.warn(message);
+      return;
+    }
+    if (status === "interrupted") {
+      logger2.debug(message);
+      return;
+    }
+    logger2.warn(message);
+  }
   /** terminal 帧专属错误信息入账（⛔P-Z2 实证：真实 failed 终态的 errorCode/errorMessage
    *  只在 terminal 帧携带，read/delta 拿不到——先到/迟到都记录，消费层合成失败
    *  文案时优先采信）。二者均缺失时不挂 lastTerminalError 字段。 */
@@ -1857,6 +1902,11 @@ var ZcodeEngine = class {
       // 不变量 3a 的拼接比对不含 reasoning）
       onTextDelta: (delta) => ctx.onEvent?.({ type: "text_delta", delta }),
       onThinkingDelta: (delta) => ctx.onEvent?.({ type: "thinking_delta", delta }),
+      // [PR3] 工具执行期活性：非终态非增量的 session/event 帧（tool.updated progress
+      // 等，真机探针实证每 ~1s 一帧）→ activity 事件（零载荷纯活性信号——宿主无进展
+      // 守护对任何事件类型刷新；reducer no-op、不落 journal）。zcode 引擎
+      // conversation:"unsupported"，run 域是唯一发射面（无 chat 域接线）。
+      onActivity: () => ctx.onEvent?.({ type: "activity" }),
       onSessionCreated: (sessionId) => {
         currentSessionId = sessionId;
         rt.activeSessions.add(sessionId);
@@ -2083,6 +2133,17 @@ var ZcodeEngine = class {
     }
     await this.shutdownRuntimeAndDisposeChannel(rt);
   }
+  /**
+   * [u7a D5] 引擎在途只读快照：activeSessions 非空才算在途——poolKey 'shared' 的
+   * app-server **空闲常驻进程恒活，禁止按进程存在判定**（进程在 ≠ 在途，否则推迟
+   * 判定恒真、30min 上限从兜底变常态路径，设计 §3.3 D5 显式排除）。计数权威 =
+   * activeSessions（attempt 入 create 应答后 add / finally settle 后 delete，与
+   * dispose 的 close 帧目标集同一状态源，无双记账）。运行时未初始化（从未 run /
+   * 已 dispose）→ 恒 0。
+   */
+  inFlightSnapshot() {
+    return { inFlight: this.appserverRuntime?.activeSessions.size ?? 0 };
+  }
   /** 终态合成（extension-conventions 函数 80 行上限，从 run 提取）：aborted / run-failed / parsed 三分支。 */
   finalizeOutcome(task, ctx, final, usageAcc, startedAt) {
     const outcome = {
@@ -2151,17 +2212,6 @@ var ZcodeEngine = class {
     }
     for (const ev of synthesizeCoarseEvents(payload.response, payload.usage)) emit(ev);
   }
-  /**
-   * D1 可选面：zcode 首期不支持 conversation（capabilities 声明）——同步拒绝、
-   * 不创建进程，文案给可操作建议（A11）。
-   */
-  async interact(_handle, _action) {
-    return {
-      ok: false,
-      code: "engine_capability_unsupported",
-      message: "zcode \u5F15\u64CE\u4E0D\u652F\u6301 conversation \u4EA4\u4E92\u63A7\u5236\u9762\uFF08capabilities.conversation = 'unsupported'\uFF0C\u6BCF\u4EFB\u52A1\u81EA\u5305\u542B\u4F1A\u8BDD\uFF0C\u65E0\u540C\u8FDB\u7A0B idle \u590D\u7528\uFF09\u3002\u6062\u590D\u6307\u5F15\uFF1A\u6539\u7528\u5355\u6B21 subagent \u8C03\u7528\u91CD\u65B0\u6D3E\u53D1\u4EFB\u52A1\uFF0C\u6216\u4F7F\u7528 engine: 'pi'\uFF08chatMode idle \u590D\u7528\uFF0C\u652F\u6301 message/close/cancel\uFF09\u3002"
-    };
-  }
   /** [U7] 模型可发现性：v2 桌面登录态聚合（带凭据 provider × models），失败安全返回清单本身可能为空。 */
   listModels() {
     return listZcodeModels(this.deps.sources);
@@ -2361,9 +2411,6 @@ function authoritativeTerminalStatus(r) {
   if (r.lastTerminalStatus !== void 0) return r.lastTerminalStatus;
   return r.terminal.source === "turn.terminal" ? r.terminal.status : void 0;
 }
-function isFailedTerminalStatus(status) {
-  return status === "failed" || status === "error";
-}
 function parsedAppServerAttempt(task, r) {
   if (isFailedTerminalStatus(authoritativeTerminalStatus(r))) {
     return failedTerminalAppServerAttempt(r);
@@ -2539,7 +2586,7 @@ var EngineProtocolServer = class {
       }
     }
   }
-  /** 10 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
+  /** 9 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
   async dispatch(id, method, params) {
     const handler = this.methodHandlers[method];
     if (handler === void 0) {
@@ -2552,7 +2599,7 @@ var EngineProtocolServer = class {
     return handler(params);
   }
   /**
-   * 10 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
+   * 9 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
    * 与原 switch case 表达式一一对应）。
    */
   methodHandlers = {
@@ -2560,7 +2607,6 @@ var EngineProtocolServer = class {
     probe: (p) => this.engine.probe(probeParamsOf(p)),
     run: (p) => this.run(p),
     cancel: (p) => this.cancel(p),
-    interact: (p) => this.interact(p),
     read: (p) => this.read(p),
     listModels: () => ({ models: this.engine.listModels?.() ?? null }),
     validateModel: (p) => this.validateModel(p),
@@ -2636,9 +2682,6 @@ var EngineProtocolServer = class {
     if (active !== void 0) active.controller.abort(new Error(`cancelled by host: ${params.reason}`));
     return { ok: true };
   }
-  async interact(params) {
-    return this.engine.interact({ data: params.handle }, params.action);
-  }
   read(params) {
     return this.engine.read({ data: params.handle });
   }

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { EnginePort, ReverseRequestClock, EngineCapabilities, ProbeReport, EngineAgentCallOpts, RunContext, EngineRunResult, EngineHandle, InteractAction, InteractResult, SessionView } from '@zhushanwen/subagent-engine-sdk';
+import { EnginePort, ReverseRequestClock, EngineCapabilities, ProbeReport, EngineAgentCallOpts, RunContext, EngineRunResult, EngineHandle, SessionView } from '@zhushanwen/subagent-engine-sdk';
 
 /** 出站帧写入面（main.ts 注入 process.stdout；测试注入内存缓冲）。 */
 type FrameWriter = (frame: unknown) => void;
@@ -30,17 +30,16 @@ declare class EngineProtocolServer {
     constructor(opts: EngineProtocolServerOptions);
     /** 入站帧消费（请求帧 + 反向请求应答帧；main.ts 的行解析器拆行后喂入）。 */
     handleFrame(frame: unknown): void;
-    /** 10 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
+    /** 9 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
     private dispatch;
     /**
-     * 10 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
+     * 9 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
      * 与原 switch case 表达式一一对应）。
      */
     private readonly methodHandlers;
     private initialize;
     private run;
     private cancel;
-    private interact;
     private read;
     private validateModel;
     private emitEvent;
@@ -214,6 +213,17 @@ declare class ZcodeEngine implements EnginePort {
      * ensureAppServerRuntime 自动重建（与崩溃重建同一代码路径，不变量 4）。
      */
     dispose(): Promise<void>;
+    /**
+     * [u7a D5] 引擎在途只读快照：activeSessions 非空才算在途——poolKey 'shared' 的
+     * app-server **空闲常驻进程恒活，禁止按进程存在判定**（进程在 ≠ 在途，否则推迟
+     * 判定恒真、30min 上限从兜底变常态路径，设计 §3.3 D5 显式排除）。计数权威 =
+     * activeSessions（attempt 入 create 应答后 add / finally settle 后 delete，与
+     * dispose 的 close 帧目标集同一状态源，无双记账）。运行时未初始化（从未 run /
+     * 已 dispose）→ 恒 0。
+     */
+    inFlightSnapshot(): {
+        inFlight: number;
+    };
     /** 终态合成（extension-conventions 函数 80 行上限，从 run 提取）：aborted / run-failed / parsed 三分支。 */
     private finalizeOutcome;
     /** abort 合成终态：exitCode=null（record 正常收尾，不留僵尸）。 */
@@ -226,11 +236,6 @@ declare class ZcodeEngine implements EnginePort {
     private applyRunFailedOutcome;
     /** parsed 合成终态：content/sessionId/usage 落位 + schema 校验分流 + coarse 事件。 */
     private applyParsedOutcome;
-    /**
-     * D1 可选面：zcode 首期不支持 conversation（capabilities 声明）——同步拒绝、
-     * 不创建进程，文案给可操作建议（A11）。
-     */
-    interact(_handle: EngineHandle, _action: InteractAction): Promise<InteractResult>;
     /** [U7] 模型可发现性：v2 桌面登录态聚合（带凭据 provider × models），失败安全返回清单本身可能为空。 */
     listModels(): Array<{
         id: string;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { EnginePort, ReverseRequestClock, EngineCapabilities, ProbeReport, EngineAgentCallOpts, RunContext, EngineRunResult, EngineHandle, InteractAction, InteractResult, SessionView } from '@zhushanwen/subagent-engine-sdk';
+import { EnginePort, ReverseRequestClock, EngineCapabilities, ProbeReport, EngineAgentCallOpts, RunContext, EngineRunResult, EngineHandle, SessionView } from '@zhushanwen/subagent-engine-sdk';
 
 /** 出站帧写入面（main.ts 注入 process.stdout；测试注入内存缓冲）。 */
 type FrameWriter = (frame: unknown) => void;
@@ -30,17 +30,16 @@ declare class EngineProtocolServer {
     constructor(opts: EngineProtocolServerOptions);
     /** 入站帧消费（请求帧 + 反向请求应答帧；main.ts 的行解析器拆行后喂入）。 */
     handleFrame(frame: unknown): void;
-    /** 10 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
+    /** 9 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
     private dispatch;
     /**
-     * 10 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
+     * 9 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
      * 与原 switch case 表达式一一对应）。
      */
     private readonly methodHandlers;
     private initialize;
     private run;
     private cancel;
-    private interact;
     private read;
     private validateModel;
     private emitEvent;
@@ -214,6 +213,17 @@ declare class ZcodeEngine implements EnginePort {
      * ensureAppServerRuntime 自动重建（与崩溃重建同一代码路径，不变量 4）。
      */
     dispose(): Promise<void>;
+    /**
+     * [u7a D5] 引擎在途只读快照：activeSessions 非空才算在途——poolKey 'shared' 的
+     * app-server **空闲常驻进程恒活，禁止按进程存在判定**（进程在 ≠ 在途，否则推迟
+     * 判定恒真、30min 上限从兜底变常态路径，设计 §3.3 D5 显式排除）。计数权威 =
+     * activeSessions（attempt 入 create 应答后 add / finally settle 后 delete，与
+     * dispose 的 close 帧目标集同一状态源，无双记账）。运行时未初始化（从未 run /
+     * 已 dispose）→ 恒 0。
+     */
+    inFlightSnapshot(): {
+        inFlight: number;
+    };
     /** 终态合成（extension-conventions 函数 80 行上限，从 run 提取）：aborted / run-failed / parsed 三分支。 */
     private finalizeOutcome;
     /** abort 合成终态：exitCode=null（record 正常收尾，不留僵尸）。 */
@@ -226,11 +236,6 @@ declare class ZcodeEngine implements EnginePort {
     private applyRunFailedOutcome;
     /** parsed 合成终态：content/sessionId/usage 落位 + schema 校验分流 + coarse 事件。 */
     private applyParsedOutcome;
-    /**
-     * D1 可选面：zcode 首期不支持 conversation（capabilities 声明）——同步拒绝、
-     * 不创建进程，文案给可操作建议（A11）。
-     */
-    interact(_handle: EngineHandle, _action: InteractAction): Promise<InteractResult>;
     /** [U7] 模型可发现性：v2 桌面登录态聚合（带凭据 provider × models），失败安全返回清单本身可能为空。 */
     listModels(): Array<{
         id: string;

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   readZcodeSessionView,
   zcodeDbPathAllowlist,
   zcodeSessionDbPath
-} from "./chunk-IIAABOER.js";
+} from "./chunk-WQ7NVGKB.js";
 
 // src/golden-sample.ts
 var ZCODE_APPSERVER_GOLDEN = {

package/dist/main.cjs

@@ -58,6 +58,9 @@ var ZCODE_APPSERVER_ABORT_GRACE_MS = 3e3;
 var ZCODE_APPSERVER_ERR_MODEL_CONFIG_MISSING = -32603;
 var ZCODE_APPSERVER_ERR_BUSY_SESSION = -32010;
 var ZCODE_APPSERVER_HARVEST_GRACE_MS = 1e3;
+function isFailedTerminalStatus(status) {
+  return status === "failed" || status === "error";
+}
 
 // src/registration.ts
 var import_subagent_engine_sdk10 = require("@zhushanwen/subagent-engine-sdk");
@@ -682,6 +685,11 @@ var AppServerConnection = class {
   reqSeq = 0;
   /** stderr 滚动缓冲（代级：崩溃诊断用）。 */
   stderrTail = "";
+  /**
+   * stderr tee 落盘流（D6-⑦；merge 裁决：旋转走 logs/stderr-rotation 的路径式
+   * rotateStderrLogIfNeeded——W5 边界禁 import subagent-core 的 SizeRotatedAppendStream，
+   * 常驻流改裸 WriteStream + 按次轮转检查，帽语义等价）。
+   */
   stderrStream = null;
   stderrStreamFailed = false;
   /**
@@ -1368,7 +1376,13 @@ var SessionChannel = class {
     });
     const turn = {
       sessionId,
-      callbacks: { onTextDelta: opts.onTextDelta, onThinkingDelta: opts.onThinkingDelta },
+      callbacks: {
+        onTextDelta: opts.onTextDelta,
+        onThinkingDelta: opts.onThinkingDelta,
+        // [PR3] tool 执行期活性回调（SessionTurnCallbacks.onActivity 注释——宿主侧
+        // 无进展守护的工具执行期刷新面）
+        onActivity: opts.onActivity
+      },
       settled: false,
       deltas: [],
       finalText: void 0,
@@ -1484,7 +1498,9 @@ var SessionChannel = class {
     if (payload === void 0) return;
     this.refreshIdle(turn);
     if (this.applyFinalFrame(turn, payload)) return;
-    this.applyStreamDelta(turn, payload);
+    if (!this.applyStreamDelta(turn, payload) && !turn.settled) {
+      turn.callbacks.onActivity?.();
+    }
   }
   /**
    * 收尾帧判定与吸收（A.2 ⑤ 两种形态：payload.response / stopReason+content 变体）。
@@ -1508,9 +1524,12 @@ var SessionChannel = class {
   /** 增量 delta 分发：非空 delta 入账 + 回调；终态后迟到丢弃（不变量 2）。
    *  kind 区分两通道（F2）：reasoning_delta 只走 thinking 回调（不入 deltas 账本
    *  ——deltas 是 response 兜底聚合，推理文本不是答案正文）；text_delta / kind
-   *  缺席走 text 路径。 */
+   *  缺席走 text 路径。
+   *  返回值（[PR3]）：帧被 delta 路径消费（thinking 或 text，回调若注册则已触发）
+   *  → true；无 delta / 空 delta / 终态后迟到丢弃 → false（handleSessionEvent 据
+   *  此分流 onActivity——delta 帧已是宿主可见进展，不双发活性信号）。 */
   applyStreamDelta(turn, payload) {
-    if (typeof payload.delta !== "string" || payload.delta === "") return;
+    if (typeof payload.delta !== "string" || payload.delta === "") return false;
     if (turn.settled) {
       logger2.warn(
         `\u7EC8\u6001\u540E\u8FDF\u5230\u7684 delta \u4E22\u5F03\uFF08\u4F1A\u8BDD ${turn.sessionId}\uFF0C\u4E0D\u53D8\u91CF 2\uFF1Aresolve \u540E\u4E0D\u518D\u53D1\u4E8B\u4EF6\uFF09: ${payload.delta.slice(
@@ -1518,14 +1537,15 @@ var SessionChannel = class {
           DELTA_LOG_CHARS
         )}`
       );
-      return;
+      return false;
     }
     if (payload.kind === "reasoning_delta") {
       turn.callbacks.onThinkingDelta?.(payload.delta);
-      return;
+      return true;
     }
     turn.deltas.push(payload.delta);
     turn.callbacks.onTextDelta?.(payload.delta);
+    return true;
   }
   handleTelemetry(params) {
     if (!isRecord3(params)) return;
@@ -1545,13 +1565,38 @@ var SessionChannel = class {
     turn.lastTerminalStatus = status;
     this.recordTerminalError(turn, params);
     if (turn.settled) {
-      logger2.warn(
-        `\u6743\u5A01\u7EC8\u6001\u665A\u4E8E\u843D\u5B9A\u7ED3\u679C\u5230\u8FBE\uFF08\u4F1A\u8BDD ${turn.sessionId}\uFF0C\u5DF2\u843D\u5B9A source=${turn.terminal?.source}\uFF09\uFF1Aturn.terminal status="${status}" \u4EC5\u8BB0\u5F55\u4E0D\u6539\u5199\uFF08P0-1 D5\u2460\uFF09`
-      );
+      this.logLateTerminal(turn, status);
       return;
     }
     turn.settle({ status, source: "turn.terminal" });
   }
+  /**
+   * 已落定 turn 的迟到权威终态分级日志（P-Z2 后续：常态迟到降噪）。真机实证该
+   * 形态的唯一可达路径是 success 终态常态迟到（final-frame 先落定 + 权威
+   * turn.terminal 迟到）——即每个成功任务必经；原无条件 warn 经 SDK cli-entry
+   * 的 stderr 兜底 → runtime [rpc:stderr] 全量 console.error 链路，每个成功任务
+   * 产一条零异常区分度的 ERROR 级日志。按权威 status 分级（落定语义不动——
+   * lastTerminalStatus/lastTerminalError 的入账在上游无条件路径完成）：
+   *   - "success"：常态迟到，零日志；
+   *   - "interrupted"：用户中断形态，debug（stderr 兜底对 debug no-op——对齐
+   *     SDK logger CONSOLE_SINK 语义，host/log 反向请求侧仍可观测）；
+   *   - 失败类（isFailedTerminalStatus，与引擎失败分流同口径）与 unknown/未识别
+   *     status：保守 warn（原样 status 已写入文案）——假成功识破的防御面，理论
+   *     不可达但保留，宁可误报不静默。
+   */
+  logLateTerminal(turn, status) {
+    if (status === "success") return;
+    const message = `\u6743\u5A01\u7EC8\u6001\u665A\u4E8E\u843D\u5B9A\u7ED3\u679C\u5230\u8FBE\uFF08\u4F1A\u8BDD ${turn.sessionId}\uFF0C\u5DF2\u843D\u5B9A source=${turn.terminal?.source}\uFF09\uFF1Aturn.terminal status="${status}" \u4EC5\u8BB0\u5F55\u4E0D\u6539\u5199\uFF08P0-1 D5\u2460\uFF09`;
+    if (isFailedTerminalStatus(status)) {
+      logger2.warn(message);
+      return;
+    }
+    if (status === "interrupted") {
+      logger2.debug(message);
+      return;
+    }
+    logger2.warn(message);
+  }
   /** terminal 帧专属错误信息入账（⛔P-Z2 实证：真实 failed 终态的 errorCode/errorMessage
    *  只在 terminal 帧携带，read/delta 拿不到——先到/迟到都记录，消费层合成失败
    *  文案时优先采信）。二者均缺失时不挂 lastTerminalError 字段。 */
@@ -1837,6 +1882,11 @@ var ZcodeEngine = class {
       // 不变量 3a 的拼接比对不含 reasoning）
       onTextDelta: (delta) => ctx.onEvent?.({ type: "text_delta", delta }),
       onThinkingDelta: (delta) => ctx.onEvent?.({ type: "thinking_delta", delta }),
+      // [PR3] 工具执行期活性：非终态非增量的 session/event 帧（tool.updated progress
+      // 等，真机探针实证每 ~1s 一帧）→ activity 事件（零载荷纯活性信号——宿主无进展
+      // 守护对任何事件类型刷新；reducer no-op、不落 journal）。zcode 引擎
+      // conversation:"unsupported"，run 域是唯一发射面（无 chat 域接线）。
+      onActivity: () => ctx.onEvent?.({ type: "activity" }),
       onSessionCreated: (sessionId) => {
         currentSessionId = sessionId;
         rt.activeSessions.add(sessionId);
@@ -2063,6 +2113,17 @@ var ZcodeEngine = class {
     }
     await this.shutdownRuntimeAndDisposeChannel(rt);
   }
+  /**
+   * [u7a D5] 引擎在途只读快照：activeSessions 非空才算在途——poolKey 'shared' 的
+   * app-server **空闲常驻进程恒活，禁止按进程存在判定**（进程在 ≠ 在途，否则推迟
+   * 判定恒真、30min 上限从兜底变常态路径，设计 §3.3 D5 显式排除）。计数权威 =
+   * activeSessions（attempt 入 create 应答后 add / finally settle 后 delete，与
+   * dispose 的 close 帧目标集同一状态源，无双记账）。运行时未初始化（从未 run /
+   * 已 dispose）→ 恒 0。
+   */
+  inFlightSnapshot() {
+    return { inFlight: this.appserverRuntime?.activeSessions.size ?? 0 };
+  }
   /** 终态合成（extension-conventions 函数 80 行上限，从 run 提取）：aborted / run-failed / parsed 三分支。 */
   finalizeOutcome(task, ctx, final, usageAcc, startedAt) {
     const outcome = {
@@ -2131,17 +2192,6 @@ var ZcodeEngine = class {
     }
     for (const ev of synthesizeCoarseEvents(payload.response, payload.usage)) emit(ev);
   }
-  /**
-   * D1 可选面：zcode 首期不支持 conversation（capabilities 声明）——同步拒绝、
-   * 不创建进程，文案给可操作建议（A11）。
-   */
-  async interact(_handle, _action) {
-    return {
-      ok: false,
-      code: "engine_capability_unsupported",
-      message: "zcode \u5F15\u64CE\u4E0D\u652F\u6301 conversation \u4EA4\u4E92\u63A7\u5236\u9762\uFF08capabilities.conversation = 'unsupported'\uFF0C\u6BCF\u4EFB\u52A1\u81EA\u5305\u542B\u4F1A\u8BDD\uFF0C\u65E0\u540C\u8FDB\u7A0B idle \u590D\u7528\uFF09\u3002\u6062\u590D\u6307\u5F15\uFF1A\u6539\u7528\u5355\u6B21 subagent \u8C03\u7528\u91CD\u65B0\u6D3E\u53D1\u4EFB\u52A1\uFF0C\u6216\u4F7F\u7528 engine: 'pi'\uFF08chatMode idle \u590D\u7528\uFF0C\u652F\u6301 message/close/cancel\uFF09\u3002"
-    };
-  }
   /** [U7] 模型可发现性：v2 桌面登录态聚合（带凭据 provider × models），失败安全返回清单本身可能为空。 */
   listModels() {
     return listZcodeModels(this.deps.sources);
@@ -2341,9 +2391,6 @@ function authoritativeTerminalStatus(r) {
   if (r.lastTerminalStatus !== void 0) return r.lastTerminalStatus;
   return r.terminal.source === "turn.terminal" ? r.terminal.status : void 0;
 }
-function isFailedTerminalStatus(status) {
-  return status === "failed" || status === "error";
-}
 function parsedAppServerAttempt(task, r) {
   if (isFailedTerminalStatus(authoritativeTerminalStatus(r))) {
     return failedTerminalAppServerAttempt(r);
@@ -2519,7 +2566,7 @@ var EngineProtocolServer = class {
       }
     }
   }
-  /** 10 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
+  /** 9 正向方法分发（表驱动：method → 处理器；未知方法 → engine_protocol_unknown_method）。 */
   async dispatch(id, method, params) {
     const handler = this.methodHandlers[method];
     if (handler === void 0) {
@@ -2532,7 +2579,7 @@ var EngineProtocolServer = class {
     return handler(params);
   }
   /**
-   * 10 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
+   * 9 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
    * 与原 switch case 表达式一一对应）。
    */
   methodHandlers = {
@@ -2540,7 +2587,6 @@ var EngineProtocolServer = class {
     probe: (p) => this.engine.probe(probeParamsOf(p)),
     run: (p) => this.run(p),
     cancel: (p) => this.cancel(p),
-    interact: (p) => this.interact(p),
     read: (p) => this.read(p),
     listModels: () => ({ models: this.engine.listModels?.() ?? null }),
     validateModel: (p) => this.validateModel(p),
@@ -2616,9 +2662,6 @@ var EngineProtocolServer = class {
     if (active !== void 0) active.controller.abort(new Error(`cancelled by host: ${params.reason}`));
     return { ok: true };
   }
-  async interact(params) {
-    return this.engine.interact({ data: params.handle }, params.action);
-  }
   read(params) {
     return this.engine.read({ data: params.handle });
   }

package/dist/main.js

@@ -1,6 +1,6 @@
 import {
   EngineProtocolServer
-} from "./chunk-IIAABOER.js";
+} from "./chunk-WQ7NVGKB.js";
 
 // src/main.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/zcode-subagent-cli",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "zcode subagent engine as an independent CLI package (W5 of subagent-engine-protocolization): speaks engine-protocol v1 over NDJSON stdio, depends only on @zhushanwen/subagent-engine-sdk (never subagent-core)",
   "type": "module",
   "license": "MIT",
@@ -61,7 +61,7 @@
     "dist/"
   ],
   "dependencies": {
-    "@zhushanwen/subagent-engine-sdk": "0.2.1"
+    "@zhushanwen/subagent-engine-sdk": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",