@zhushanwen/zcode-subagent-cli 0.2.0 → 0.2.1

package/dist/{chunk-36VY2TNC.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";
@@ -1371,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,
@@ -1487,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 变体）。
@@ -1511,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(
@@ -1521,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;
@@ -1548,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 字段。 */
@@ -1840,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);
@@ -2145,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);
@@ -2355,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);
@@ -2542,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) {
@@ -2555,7 +2586,7 @@ var EngineProtocolServer = class {
     return handler(params);
   }
   /**
-   * 10 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
+   * 9 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
    * 与原 switch case 表达式一一对应）。
    */
   methodHandlers = {
@@ -2563,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),
@@ -2639,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");
@@ -1393,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,
@@ -1509,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 变体）。
@@ -1533,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(
@@ -1543,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;
@@ -1570,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 字段。 */
@@ -1862,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);
@@ -2167,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);
@@ -2377,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);
@@ -2555,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) {
@@ -2568,7 +2599,7 @@ var EngineProtocolServer = class {
     return handler(params);
   }
   /**
-   * 10 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
+   * 9 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
    * 与原 switch case 表达式一一对应）。
    */
   methodHandlers = {
@@ -2576,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),
@@ -2652,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;
@@ -237,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;
@@ -237,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-36VY2TNC.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");
@@ -1373,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,
@@ -1489,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 变体）。
@@ -1513,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(
@@ -1523,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;
@@ -1550,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 字段。 */
@@ -1842,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);
@@ -2147,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);
@@ -2357,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);
@@ -2535,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) {
@@ -2548,7 +2579,7 @@ var EngineProtocolServer = class {
     return handler(params);
   }
   /**
-   * 10 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
+   * 9 正向方法 → 处理器映射（每个处理器消费原始 params 并自行收敛类型——
    * 与原 switch case 表达式一一对应）。
    */
   methodHandlers = {
@@ -2556,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),
@@ -2632,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-36VY2TNC.js";
+} from "./chunk-WQ7NVGKB.js";
 
 // src/main.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/zcode-subagent-cli",
-  "version": "0.2.0",
+  "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",