@zhushanwen/subagent-core 0.8.0 → 0.9.0

package/dist/execution/engine/engine-discovery-scan.cjs

@@ -40,7 +40,7 @@ __export(engine_discovery_scan_exports, {
   scanEngines: () => scanEngines
 });
 module.exports = __toCommonJS(engine_discovery_scan_exports);
-var path5 = __toESM(require("path"), 1);
+var path6 = __toESM(require("path"), 1);
 
 // src/execution/engine/engine-manifest.ts
 var path = __toESM(require("path"), 1);
@@ -285,7 +285,7 @@ function describeValue(value) {
 
 // src/execution/engine/engine-inspect-package.ts
 var fs = __toESM(require("fs"), 1);
-var path2 = __toESM(require("path"), 1);
+var path3 = __toESM(require("path"), 1);
 var import_subagent_engine_sdk9 = require("@zhushanwen/subagent-engine-sdk");
 
 // src/execution/engine/common/data-dir.ts
@@ -314,7 +314,20 @@ var import_subagent_engine_sdk6 = require("@zhushanwen/subagent-engine-sdk");
 
 // src/execution/engine/client/mirror.ts
 var import_subagent_engine_sdk = require("@zhushanwen/subagent-engine-sdk");
-var logger3 = (0, import_subagent_engine_sdk.getLogger)("subagents");
+
+// src/execution/dialog-queue.ts
+var logger3 = getLogger("subagents");
+var SECONDS_PER_MINUTE = 60;
+var MS_PER_SECOND = 1e3;
+var DEFAULT_DIALOG_TIMEOUT_MINUTES = 30;
+var DEFAULT_DIALOG_TIMEOUT_MS = DEFAULT_DIALOG_TIMEOUT_MINUTES * SECONDS_PER_MINUTE * MS_PER_SECOND;
+var activeDialogQueue;
+function notifyChildProcessExited(pid) {
+  activeDialogQueue?.rejectChildDialogs({ pid });
+}
+
+// src/execution/engine/client/mirror.ts
+var logger4 = (0, import_subagent_engine_sdk.getLogger)("subagents");
 var SpawnedChildrenMirror = class {
   entries = /* @__PURE__ */ new Map();
   listeners = /* @__PURE__ */ new Set();
@@ -343,6 +356,7 @@ var SpawnedChildrenMirror = class {
     };
     this.entries.set(patch.pid, entry);
     this.emit({ reason: "childStateChanged", pid: patch.pid, recordId: patch.recordId });
+    if (patch.state === "exited") notifyChildProcessExited(patch.pid);
   }
   /**
    * 失效语义 2 + 3：全部镜像项整体置死（killed=true + state=exited）→ 逐项广播 →
@@ -358,6 +372,7 @@ var SpawnedChildrenMirror = class {
       entry.state = "exited";
       entry.updatedAt = Date.now();
       this.emit({ reason: "killedAll", pid: entry.pid, recordId: entry.recordId });
+      notifyChildProcessExited(entry.pid);
     }
     this.entries.clear();
   }
@@ -399,7 +414,7 @@ var SpawnedChildrenMirror = class {
       try {
         listener2(event);
       } catch (err) {
-        logger3.debug(
+        logger4.debug(
           `[spawned-children-mirror] listener threw for ${event.reason}: ${err instanceof Error ? err.message : String(err)}`
         );
       }
@@ -412,22 +427,22 @@ var import_node_child_process = require("child_process");
 var import_node_fs = require("fs");
 var import_node_path2 = require("path");
 var import_subagent_engine_sdk2 = require("@zhushanwen/subagent-engine-sdk");
-var logger4 = (0, import_subagent_engine_sdk2.getLogger)("subagents");
+var logger5 = (0, import_subagent_engine_sdk2.getLogger)("subagents");
 var CMDLINE_PROBE_TIMEOUT_MS = 3e3;
 var PIDFILE_JSON_INDENT = 2;
 function pidfilePath(engineDataDir, engineId, hostKind, hostPid) {
   return (0, import_node_path2.join)((0, import_subagent_engine_sdk2.resolveEngineDir)(engineDataDir, engineId), `engine.${hostKind}.${hostPid}.pid`);
 }
-function writePidfileAtomic(path6, content) {
-  (0, import_node_fs.mkdirSync)((0, import_node_path2.join)(path6, ".."), { recursive: true });
-  const tmp = `${path6}.${process.pid}.${Date.now()}.tmp`;
+function writePidfileAtomic(path7, content) {
+  (0, import_node_fs.mkdirSync)((0, import_node_path2.join)(path7, ".."), { recursive: true });
+  const tmp = `${path7}.${process.pid}.${Date.now()}.tmp`;
   (0, import_node_fs.writeFileSync)(tmp, `${JSON.stringify(content, null, PIDFILE_JSON_INDENT)}
 `, "utf-8");
-  (0, import_node_fs.renameSync)(tmp, path6);
+  (0, import_node_fs.renameSync)(tmp, path7);
 }
-function readPidfile(path6) {
+function readPidfile(path7) {
   try {
-    const raw = (0, import_node_fs.readFileSync)(path6, "utf-8");
+    const raw = (0, import_node_fs.readFileSync)(path7, "utf-8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.enginePid !== "number" || typeof parsed.hostPid !== "number" || typeof parsed.engineId !== "string" || typeof parsed.hostKind !== "string") {
       return void 0;
@@ -441,21 +456,21 @@ function readPidfile(path6) {
       writtenAt: typeof parsed.writtenAt === "string" ? parsed.writtenAt : ""
     };
   } catch (err) {
-    logger4.debug(`[pid-file] readPidfile(${path6}) failed, treating as stale: ${err instanceof Error ? err.message : String(err)}`);
+    logger5.debug(`[pid-file] readPidfile(${path7}) failed, treating as stale: ${err instanceof Error ? err.message : String(err)}`);
     return void 0;
   }
 }
-function removePidfile(path6) {
+function removePidfile(path7) {
   try {
-    (0, import_node_fs.rmSync)(path6, { force: true });
+    (0, import_node_fs.rmSync)(path7, { force: true });
   } catch (err) {
-    logger4.debug(`[pid-file] removePidfile(${path6}) failed (concurrent sweep = expected): ${err instanceof Error ? err.message : String(err)}`);
+    logger5.debug(`[pid-file] removePidfile(${path7}) failed (concurrent sweep = expected): ${err instanceof Error ? err.message : String(err)}`);
   }
 }
 function registerEnginePidfile(reg) {
-  const path6 = pidfilePath(reg.engineDataDir, reg.engineId, reg.hostKind, reg.hostPid);
+  const path7 = pidfilePath(reg.engineDataDir, reg.engineId, reg.hostKind, reg.hostPid);
   try {
-    writePidfileAtomic(path6, {
+    writePidfileAtomic(path7, {
       enginePid: reg.enginePid,
       hostPid: reg.hostPid,
       engineStartTime: readProcessStartTime(reg.enginePid) ?? null,
@@ -463,9 +478,9 @@ function registerEnginePidfile(reg) {
       hostKind: reg.hostKind,
       writtenAt: (/* @__PURE__ */ new Date()).toISOString()
     });
-    return path6;
+    return path7;
   } catch (err) {
-    logger4.warn(
+    logger5.warn(
       `[pid-file] pidfile write failed for ${reg.engineId} (sweep coverage degraded): ${err instanceof Error ? err.message : String(err)}`
     );
     return void 0;
@@ -475,7 +490,7 @@ function sweepEnginePidfiles(args) {
   try {
     return sweepStalePidfiles(args);
   } catch (err) {
-    logger4.warn(
+    logger5.warn(
       `[pid-file] pidfile sweep failed for ${args.engineId} (conservative skip): ${err instanceof Error ? err.message : String(err)}`
     );
     return { killed: [], removed: [], skipped: [] };
@@ -533,10 +548,10 @@ function sweepStalePidfiles(opts) {
   }
   return result;
 }
-function sweepOnePidfile(path6, file, opts, platform, result) {
-  const content = readPidfile(path6);
+function sweepOnePidfile(path7, file, opts, platform, result) {
+  const content = readPidfile(path7);
   if (content === void 0) {
-    removePidfile(path6);
+    removePidfile(path7);
     result.removed.push({ file, reason: "unreadable-or-corrupt" });
     return;
   }
@@ -553,11 +568,11 @@ function sweepOnePidfile(path6, file, opts, platform, result) {
     result.skipped.push({ file, reason: "host-pid-alive" });
     return;
   }
-  reapDeadHostEngine(path6, file, content, opts, platform, result);
+  reapDeadHostEngine(path7, file, content, opts, platform, result);
 }
-function reapDeadHostEngine(path6, file, content, opts, platform, result) {
+function reapDeadHostEngine(path7, file, content, opts, platform, result) {
   if (platform === "win32") {
-    removePidfile(path6);
+    removePidfile(path7);
     result.removed.push({ file, reason: "stale (host dead); win32 never kills" });
     return;
   }
@@ -567,7 +582,7 @@ function reapDeadHostEngine(path6, file, content, opts, platform, result) {
     return;
   }
   if (!engineAlive) {
-    removePidfile(path6);
+    removePidfile(path7);
     result.removed.push({ file, reason: "engine-pid-dead" });
     return;
   }
@@ -577,7 +592,7 @@ function reapDeadHostEngine(path6, file, content, opts, platform, result) {
     return;
   }
   if (!opts.matchesEngineCmdline(cmdline)) {
-    removePidfile(path6);
+    removePidfile(path7);
     result.removed.push({ file, reason: "cmdline-mismatch (pid reused by unrelated process)" });
     return;
   }
@@ -587,13 +602,13 @@ function reapDeadHostEngine(path6, file, content, opts, platform, result) {
     return;
   }
   if (content.engineStartTime === null || content.engineStartTime !== startTime) {
-    removePidfile(path6);
+    removePidfile(path7);
     result.removed.push({ file, reason: "engine-start-time-mismatch (pid reused)" });
     return;
   }
   const killEngine = opts.killEngine ?? defaultKillEngineProcessGroup;
   killEngine(content.enginePid);
-  removePidfile(path6);
+  removePidfile(path7);
   result.killed.push(content.enginePid);
   result.removed.push({ file, reason: "swept after kill (stale orphan)" });
 }
@@ -602,18 +617,18 @@ function defaultKillEngineProcessGroup(enginePid) {
     process.kill(-enginePid, "SIGKILL");
     return;
   } catch (groupErr) {
-    logger4.debug(`[pid-file] process-group kill(-${enginePid}) failed, falling back to single kill: ${groupErr instanceof Error ? groupErr.message : String(groupErr)}`);
+    logger5.debug(`[pid-file] process-group kill(-${enginePid}) failed, falling back to single kill: ${groupErr instanceof Error ? groupErr.message : String(groupErr)}`);
   }
   try {
     process.kill(enginePid, "SIGKILL");
   } catch (err) {
-    logger4.debug(`[pid-file] single kill(${enginePid}) failed (already dead = expected): ${err instanceof Error ? err.message : String(err)}`);
+    logger5.debug(`[pid-file] single kill(${enginePid}) failed (already dead = expected): ${err instanceof Error ? err.message : String(err)}`);
   }
 }
 
 // src/execution/engine/client/reverse-router.ts
 var import_subagent_engine_sdk3 = require("@zhushanwen/subagent-engine-sdk");
-var logger5 = (0, import_subagent_engine_sdk3.getLogger)("subagents");
+var logger6 = (0, import_subagent_engine_sdk3.getLogger)("subagents");
 function routeReverseRequest(deps, frame) {
   if (frame.method === "host/askUser") {
     handleInteractionRequest(deps, frame, deps.uiRequestHandler, (params) => params.request);
@@ -648,7 +663,7 @@ function handleInteractionRequest(deps, frame, handler, extract) {
       const result = await handler(input);
       if (!deps.isDisposed()) deps.sendResponse(frame.id, result);
     } catch (err) {
-      logger5.warn(
+      logger6.warn(
         `[engine-client:${deps.engineId}] ${frame.method} handler failed, answering cancelled: ${err instanceof Error ? err.message : String(err)}`
       );
       if (!deps.isDisposed()) deps.sendResponse(frame.id, { cancelled: true });
@@ -659,7 +674,7 @@ function handleDataPlaneRequest(deps, frame) {
   let settled = false;
   const guardTimer = setTimeout(() => {
     if (settled) return;
-    logger5.error(
+    logger6.error(
       `[engine-client:${deps.engineId}] data-plane reverse request ${frame.method} unanswered for ${import_subagent_engine_sdk3.REVERSE_REQUEST_TIMEOUT_MS}ms \u2014 treating as engine fault`
     );
     void deps.failEngine(
@@ -675,7 +690,7 @@ function handleDataPlaneRequest(deps, frame) {
     (err) => {
       settled = true;
       clearTimeout(guardTimer);
-      logger5.warn(
+      logger6.warn(
         `[engine-client:${deps.engineId}] ${frame.method} dispatch failed (answering ok, host-side bug): ${err instanceof Error ? err.message : String(err)}`
       );
       deps.sendResponse(frame.id, { ok: true });
@@ -685,7 +700,6 @@ function handleDataPlaneRequest(deps, frame) {
 var DATA_PLANE_HANDLERS = {
   "host/log": (deps, params) => dispatchLog(deps, params),
   "host/streamDelta": (deps, params) => dispatchStreamDelta(deps, params),
-  "host/roundLifecycle": (deps, params) => dispatchRoundLifecycle(deps, params),
   "host/poolResolved": (deps, params) => dispatchPoolResolved(deps, params),
   "host/handleReady": (deps, params) => dispatchHandleReady(deps, params),
   "host/childSpawned": (deps, params) => dispatchChildSpawned(deps, params),
@@ -696,22 +710,12 @@ async function dispatchDataPlane(deps, method, params) {
 }
 function dispatchLog(deps, p) {
   if (deps.log !== void 0) deps.log(p);
-  else logger5[p.level](`[engine:${p.component}] ${p.message}`, p.data);
+  else logger6[p.level](`[engine:${p.component}] ${p.message}`, p.data);
 }
 async function dispatchStreamDelta(deps, p) {
-  if (p.recordId !== void 0) {
-    await deps.recordRoutes.get(p.recordId)?.onStreamDelta?.(p.delta);
-    return;
-  }
+  if (p.runId === void 0) return;
   await deps.runRoutes.get(p.runId)?.onStreamDelta?.(p.delta);
 }
-async function dispatchRoundLifecycle(deps, p) {
-  if (p.recordId !== void 0) {
-    await deps.recordRoutes.get(p.recordId)?.onRoundLifecycle?.(p);
-    return;
-  }
-  await deps.runRoutes.get(p.runId)?.onRoundLifecycle?.(p);
-}
 async function dispatchPoolResolved(deps, p) {
   await deps.runRoutes.get(p.runId)?.onPoolResolved?.(p.poolKey);
 }
@@ -727,11 +731,11 @@ function dispatchChildSpawned(deps, p) {
   if (process.platform !== "win32" && typeof p.pid === "number") {
     try {
       process.kill(-p.pid, 0);
-      logger5.warn(
+      logger6.warn(
         `[engine-client:${deps.engineId}] childSpawned pid ${p.pid} leads its own process group (not in the engine harvest group \u2014 one-generation children + in-group descendants only; engine-detached descendants are an accepted cost per design \xA73.9)`
       );
     } catch (err) {
-      logger5.debug(
+      logger6.debug(
         `[engine-client:${deps.engineId}] childSpawned pid ${p.pid} group probe settled (${err instanceof Error ? err.message : String(err)})`
       );
     }
@@ -751,7 +755,7 @@ function dispatchChildStateChanged(deps, p) {
 // src/execution/engine/client/client-options.ts
 var import_node_path3 = require("path");
 var import_subagent_engine_sdk4 = require("@zhushanwen/subagent-engine-sdk");
-var logger6 = (0, import_subagent_engine_sdk4.getLogger)("subagents");
+var logger7 = (0, import_subagent_engine_sdk4.getLogger)("subagents");
 function defaultEngineCmdlineMatcher(command) {
   const base = (0, import_node_path3.basename)(command);
   return (cmdline) => {
@@ -764,7 +768,7 @@ function warnOnManifestDiagnostics(engineId, diag, result) {
     const answered = JSON.stringify(result.capabilities ?? null);
     const declared = JSON.stringify(diag.capabilities);
     if (answered !== declared) {
-      logger6.warn(
+      logger7.warn(
         `[engine-client:${engineId}] initialize capabilities differ from manifest (diagnostic only): manifest=${declared} answered=${answered}`
       );
     }
@@ -773,7 +777,7 @@ function warnOnManifestDiagnostics(engineId, diag, result) {
     const answered = JSON.stringify(result.models ?? null);
     const declared = JSON.stringify(diag.models ?? null);
     if (answered !== declared) {
-      logger6.warn(
+      logger7.warn(
         `[engine-client:${engineId}] initialize models differ from manifest (diagnostic only): manifest=${declared} answered=${answered}`
       );
     }
@@ -783,13 +787,13 @@ function warnOnManifestDiagnostics(engineId, diag, result) {
 // src/execution/engine/client/reaper.ts
 var import_node_child_process2 = require("child_process");
 var import_subagent_engine_sdk5 = require("@zhushanwen/subagent-engine-sdk");
-var logger7 = (0, import_subagent_engine_sdk5.getLogger)("subagents");
+var logger8 = (0, import_subagent_engine_sdk5.getLogger)("subagents");
 var KILL_GRACE_MS = 5e3;
 function killProcessTree(pid, reason, opts) {
   if (process.platform === "win32") {
     const r = (0, import_node_child_process2.spawnSync)("taskkill", ["/PID", String(pid), "/T", "/F"], { timeout: 1e4 });
     if (r.error || r.status !== 0) {
-      logger7.warn(
+      logger8.warn(
         `[engine-client:${opts.engineId}] taskkill failed for pid ${pid} (${reason}): ${r.error?.message ?? `exit ${r.status}`}`
       );
     }
@@ -800,7 +804,7 @@ function killProcessTree(pid, reason, opts) {
       process.kill(-pid, signal);
       return true;
     } catch (err) {
-      logger7.debug(
+      logger8.debug(
         `[engine-client:${opts.engineId}] process.kill(-${pid}, ${signal}) failed: ${err instanceof Error ? err.message : String(err)}`
       );
       return false;
@@ -810,7 +814,7 @@ function killProcessTree(pid, reason, opts) {
     try {
       process.kill(pid, "SIGTERM");
     } catch (err) {
-      logger7.debug(
+      logger8.debug(
         `[engine-client:${opts.engineId}] single SIGTERM to ${pid} failed (already dead = expected): ${err instanceof Error ? err.message : String(err)}`
       );
       return;
@@ -822,7 +826,7 @@ function killProcessTree(pid, reason, opts) {
         try {
           process.kill(pid, "SIGKILL");
         } catch (err) {
-          logger7.debug(
+          logger8.debug(
             `[engine-client:${opts.engineId}] SIGKILL to ${pid} failed (already dead = expected): ${err instanceof Error ? err.message : String(err)}`
           );
         }
@@ -905,17 +909,15 @@ function hasLiveProcessHandleCore(recordId) {
 }
 
 // src/execution/lifecycle-manager.ts
-var logger8 = getLogger("subagents");
-var MS_PER_SECOND = 1e3;
-var SECONDS_PER_MINUTE = 60;
+var logger9 = getLogger("subagents");
+var MS_PER_SECOND2 = 1e3;
+var SECONDS_PER_MINUTE2 = 60;
 var IDLE_TIMEOUT_MINUTES = 5;
-var DEFAULT_IDLE_TIMEOUT_MS = IDLE_TIMEOUT_MINUTES * SECONDS_PER_MINUTE * MS_PER_SECOND;
+var DEFAULT_IDLE_TIMEOUT_MS = IDLE_TIMEOUT_MINUTES * SECONDS_PER_MINUTE2 * MS_PER_SECOND2;
 var idleTimers = /* @__PURE__ */ new Map();
 function hasIdleTimer(recordId) {
   return idleTimers.has(recordId);
 }
-var ACTIVATE_LOCK_TIMEOUT_SECONDS = 30;
-var ACTIVATE_LOCK_TIMEOUT_MS = ACTIVATE_LOCK_TIMEOUT_SECONDS * MS_PER_SECOND;
 
 // src/execution/lifecycle-predicates.ts
 function hasLiveProcessHandle(recordId) {
@@ -944,7 +946,7 @@ function countInFlight() {
 }
 
 // src/execution/engine/client/engine-client.ts
-var logger9 = (0, import_subagent_engine_sdk6.getLogger)("subagents");
+var logger10 = (0, import_subagent_engine_sdk6.getLogger)("subagents");
 function bridgeMirrorEventToCoreMirror(event, mirror) {
   if (event.recordId === void 0 || event.pid === void 0) return;
   const entry = mirror.getEntry(event.pid);
@@ -986,9 +988,6 @@ var EngineClient = class {
   nextRequestId = 1;
   pending = /* @__PURE__ */ new Map();
   runRoutes = /* @__PURE__ */ new Map();
-  /** [W3 v1.x] chat 轮次路由（recordId 键，D1-A——续聊轮无 runId）；注册经
-   *  RemoteEngine.registerChatRoundRoute，record 终态注销。 */
-  recordRoutes = /* @__PURE__ */ new Map();
   stderrTail = "";
   unavailableReason;
   connectInFlight;
@@ -1008,7 +1007,6 @@ var EngineClient = class {
       permissionHandler: opts.permissionHandler,
       log: opts.log,
       runRoutes: this.runRoutes,
-      recordRoutes: this.recordRoutes,
       mirror: this.mirror,
       setPartialHandle: (partial) => {
         this.lastPartialHandle = partial;
@@ -1082,19 +1080,19 @@ var EngineClient = class {
         matchesEngineCmdline: this.opts.engineCmdlineMatcher ?? defaultEngineCmdlineMatcher(this.opts.command)
       });
       if (sweep.killed.length > 0) {
-        logger9.warn(
+        logger10.warn(
           `[engine-client:${this.engineId}] startup sweep killed stale orphan engine pids: ${sweep.killed.join(",")}`
         );
       }
       for (const removed of sweep.removed) {
-        logger9.debug(`[engine-client:${this.engineId}] swept stale pidfile ${removed.file}: ${removed.reason}`);
+        logger10.debug(`[engine-client:${this.engineId}] swept stale pidfile ${removed.file}: ${removed.reason}`);
       }
     }
     let attempt = 0;
     while (attempt <= import_subagent_engine_sdk6.CRASH_REBUILD_MAX_ATTEMPTS) {
       if (attempt > 0) {
         const backoff = import_subagent_engine_sdk6.CRASH_REBUILD_BACKOFF_MS[attempt - 1];
-        logger9.warn(
+        logger10.warn(
           `[engine-client:${this.engineId}] rebuild attempt ${attempt}/${import_subagent_engine_sdk6.CRASH_REBUILD_MAX_ATTEMPTS} after ${backoff}ms backoff`
         );
         await delay(backoff);
@@ -1127,7 +1125,7 @@ var EngineClient = class {
   markUnavailable(reason) {
     this.state = "unavailable";
     this.unavailableReason = reason;
-    logger9.error(`[engine-client:${this.engineId}] marked unavailable: ${reason.message}`);
+    logger10.error(`[engine-client:${this.engineId}] marked unavailable: ${reason.message}`);
   }
   /** spawn 引擎 CLI + initialize 握手 + 版本协商 + 诊断留痕。 */
   async spawnAndInitialize() {
@@ -1157,13 +1155,13 @@ var EngineClient = class {
     });
     const child = this.child;
     child.on("error", (err) => {
-      logger9.warn(`[engine-client:${this.engineId}] spawn error: ${err.message}`);
+      logger10.warn(`[engine-client:${this.engineId}] spawn error: ${err.message}`);
       this.appendStderrTail(`spawn error: ${err.message}
 `);
     });
     for (const pipe of ["stdin", "stdout", "stderr"]) {
       child[pipe]?.on("error", (err) => {
-        logger9.debug(`[engine-client:${this.engineId}] ${pipe} pipe error (engine died concurrently = expected): ${err.message}`);
+        logger10.debug(`[engine-client:${this.engineId}] ${pipe} pipe error (engine died concurrently = expected): ${err.message}`);
       });
     }
     child.stdout?.setEncoding("utf-8");
@@ -1232,7 +1230,7 @@ var EngineClient = class {
     try {
       frame = JSON.parse(line);
     } catch {
-      logger9.warn(
+      logger10.warn(
         `[engine-client:${this.engineId}] dropped non-NDJSON stdout line (protocol contract: stdout is NDJSON-only): ${truncate(line, FRAME_ECHO_MAX_CHARS)}`
       );
       return;
@@ -1249,7 +1247,7 @@ var EngineClient = class {
       this.onReverseRequest(frame);
       return;
     }
-    logger9.warn(
+    logger10.warn(
       `[engine-client:${this.engineId}] dropped unrecognized frame: ${truncate(line, FRAME_ECHO_MAX_CHARS)}`
     );
   }
@@ -1330,14 +1328,6 @@ var EngineClient = class {
       if (this.runRoutes.get(runId) === route) this.runRoutes.delete(runId);
     };
   }
-  /** [W3 v1.x] 注册 chat 轮次路由（recordId 键）；分发见 reverse-router.ts
-   *  （与 runRoutes 同构，键空间互斥：runId=run 帧分配 / recordId=宿主铸造）。 */
-  registerRecordRoute(recordId, route) {
-    this.recordRoutes.set(recordId, route);
-    return () => {
-      if (this.recordRoutes.get(recordId) === route) this.recordRoutes.delete(recordId);
-    };
-  }
   /** 健康检查（ADR-0047：静默 ≠ 卡死，不据此杀任务）。 */
   async ping() {
     await this.ensureConnected();
@@ -1373,7 +1363,7 @@ var EngineClient = class {
       try {
         await this.request("dispose", {}, { timeoutMs: DISPOSE_GRACE_MS });
       } catch (err) {
-        logger9.debug(
+        logger10.debug(
           `[engine-client:${this.engineId}] dispose frame failed, falling back to kill chain: ${err instanceof Error ? err.message : String(err)}`
         );
       }
@@ -1385,18 +1375,20 @@ var EngineClient = class {
   onEngineExit(code, signal) {
     const detail = signal !== null ? `signal ${signal}` : `exit code ${code}`;
     if (this.intentionalKill) {
-      logger9.debug(`[engine-client:${this.engineId}] engine exited after intentional kill (${detail}) \u2014 expected`);
+      logger10.debug(`[engine-client:${this.engineId}] engine exited after intentional kill (${detail}) \u2014 expected`);
     } else {
-      logger9.warn(`[engine-client:${this.engineId}] engine process exited unexpectedly (${detail})`);
+      logger10.warn(`[engine-client:${this.engineId}] engine process exited unexpectedly (${detail})`);
     }
     this.teardownProcess(detail);
     this.state = "exited";
   }
   /**
-   * 进程死亡 / 失败后的统一清理：镜像整体置死（失效语义 2+3：killed=true 广播后
-   * 清空）→ pidfile 删 → 在途请求 engine_crashed（附 stderr 尾）→ run 路由清空。
+   * 进程死亡 / 失败后的统一清理（收割/组杀分支各成子函数，此处只做顺序编排）：
+   * 孤儿收割（镜像置死前）→ 镜像置死（失效语义 2+3）→ pidfile 删 → 在途请求
+   * engine_crashed（附 stderr 尾）→ run 路由清空 → 活引擎组杀兜底。
    */
   teardownProcess(detail) {
+    this.reapOrphansAfterUnexpectedDeath(detail);
     this.mirror.killAll();
     if (this.pidfileWritten !== void 0) {
       removePidfile(this.pidfileWritten);
@@ -1409,8 +1401,46 @@ var EngineClient = class {
     }
     this.pending.clear();
     this.runRoutes.clear();
-    this.recordRoutes.clear();
     this.lastPartialHandle = void 0;
+    this.killLeakedAliveChild(detail);
+    if (this.state !== "unavailable" && this.state !== "disposed") {
+      this.state = "exited";
+    }
+  }
+  /**
+   * [H1 U2 / 红线①收割链] 非主动死亡且引擎已死的路径，在镜像置死**之前**补发收割
+   * 信号：孤儿真因 = 引擎意外死时宿主未发收割信号（原先 alreadyDead 分支直接跳过
+   * killProcessTree），任务子进程留在无主进程组继续写 session 文件。插入点约束：
+   *   - 位置 = mirror.killAll() 置死清空之前——Windows 通道依赖镜像快照过滤活孤儿
+   *     （置死后全量项 killed=true 不可过滤）；
+   *   - 条件 = !intentionalKill && alreadyDead——主动 dispose 链已有两层杀（引擎
+   *     killAllActiveChildren SIGTERM+30s + 宿主 killAll 组杀 5s 升级），跳过即不叠加、
+   *     优雅窗零压缩、pi trap-flush 零截断；进程仍活的路径（握手失败重建）由
+   *     killLeakedAliveChild 组杀兜底承接。
+   */
+  reapOrphansAfterUnexpectedDeath(detail) {
+    if (!this.intentionalKill && this.child !== void 0) {
+      const dying = this.child;
+      const alreadyDead = dying.exitCode !== null || dying.signalCode !== null;
+      if (alreadyDead && dying.pid !== void 0) {
+        if (process.platform === "win32") {
+          this.reapOrphansViaMirrorSnapshot(detail);
+        } else {
+          killProcessTree(
+            dying.pid,
+            `reap orphaned children after unexpected engine death (${detail})`,
+            { engineId: this.engineId }
+          );
+        }
+      }
+    }
+  }
+  /**
+   * 握手失败路径（版本越界/握手超时/启动僵死）引擎进程仍活着：必须组杀，否则
+   * crash 重建循环每次 spawn 泄漏一个常驻孤儿（测试机实测积累 370+）。主动杀
+   * （intentionalKill=true）与进程已死（exitCode/signalCode 非空）跳过重复发信号。
+   */
+  killLeakedAliveChild(detail) {
     if (this.child !== void 0) {
       const child = this.child;
       this.child = void 0;
@@ -1420,8 +1450,30 @@ var EngineClient = class {
       }
       child.removeAllListeners();
     }
-    if (this.state !== "unavailable" && this.state !== "disposed") {
-      this.state = "exited";
+  }
+  /**
+   * [H1 U2 / 红线①Windows 通道] 镜像快照收割活孤儿：镜像快照同步抓清单（置死前，
+   * 全量项含引擎一生历史死 pid——镜像对已退出子进程只改 state 不删项、唯一清空点 =
+   * killAll）→ 过滤活孤儿（state === "running" && !killed，活孤儿 ≤ 并发数）→ 逐 pid
+   * **异步 spawn** taskkill /T /F fire-and-forget（树根 = 活着的任务子进程自身，树杀
+   * 有效；快照同步抓、杀动作异步发——与 POSIX fire-and-forget 对称；禁 spawnSync：
+   * 逐个同步 N×10s 上界会冻结 onEngineExit 同步回调、推迟 pending reject（Continuation
+   * 失败通知链源头）与宿主事件循环）。
+   */
+  reapOrphansViaMirrorSnapshot(detail) {
+    const liveOrphans = this.mirror.snapshot().filter((e) => e.state === "running" && !e.killed);
+    if (liveOrphans.length === 0) return;
+    logger10.warn(
+      `[engine-client:${this.engineId}] reaping ${liveOrphans.length} orphaned task child(ren) via mirror snapshot after unexpected engine death (${detail})`
+    );
+    for (const entry of liveOrphans) {
+      const killer = (0, import_node_child_process3.spawn)("taskkill", ["/PID", String(entry.pid), "/T", "/F"], { stdio: "ignore" });
+      killer.unref();
+      killer.on("error", (err) => {
+        logger10.debug(
+          `[engine-client:${this.engineId}] taskkill spawn failed for orphan pid ${entry.pid} (${err.message})`
+        );
+      });
     }
   }
   // ── pidfile ──────────────────────────────────────────────────────────────
@@ -1436,7 +1488,7 @@ var EngineClient = class {
 `);
       return true;
     } catch (err) {
-      logger9.debug(
+      logger10.debug(
         `[engine-client:${this.engineId}] stdin write failed: ${err instanceof Error ? err.message : String(err)}`
       );
       return false;
@@ -1459,8 +1511,19 @@ function truncate(text, max) {
 }
 
 // src/execution/engine/client/remote-engine.ts
+var import_node_os2 = require("os");
+var import_node_path4 = require("path");
 var import_subagent_engine_sdk8 = require("@zhushanwen/subagent-engine-sdk");
 
+// src/execution/path-encoding.ts
+var path2 = __toESM(require("path"), 1);
+function encodeCwd(cwd) {
+  return "--" + cwd.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-") + "--";
+}
+function getSubagentSessionDir(agentDir, mainCwd) {
+  return path2.join(agentDir, "subagents", encodeCwd(mainCwd), "sessions");
+}
+
 // src/execution/engine/common/capability-gate.ts
 var import_subagent_engine_sdk7 = require("@zhushanwen/subagent-engine-sdk");
 
@@ -1475,7 +1538,7 @@ var EngineError = class extends Error {
     this.code = code;
     this.recovery = recovery;
   }
-  /** 结构化投影（InteractResult.code/message 与 GUI 警告条共用形态）。 */
+  /** 结构化投影（code/message 与 GUI 警告条共用形态）。 */
   toStructured() {
     return { code: this.code, message: this.message, recovery: this.recovery };
   }
@@ -1624,22 +1687,6 @@ var RemoteEngine = class {
       unregister();
     }
   }
-  async interact(handle, action) {
-    await this.opts.client.ensureConnected();
-    const result = await this.opts.client.request("interact", {
-      handle: handle.data,
-      action
-    });
-    return result;
-  }
-  /**
-   * [W3 v1.x] chat 轮次反向通道路由注册（recordId 键，EnginePort 可选面实现）：
-   * interact 续聊轮的 streamDelta / roundLifecycle 分发目标。薄委托 EngineClient
-   * 的 recordRoutes（键分发见 reverse-router.ts）。
-   */
-  registerChatRoundRoute(recordId, route) {
-    return this.opts.client.registerRecordRoute(recordId, route);
-  }
   /** 协议 read（dataDir 必填——引擎数据根，构造注入）。 */
   async read(handle) {
     await this.opts.client.ensureConnected();
@@ -1671,6 +1718,15 @@ function isTransientRunFailure(err) {
   if (!(err instanceof import_subagent_engine_sdk8.EngineSdkError)) return false;
   return err.code === "engine_crashed" || err.code === "engine_request_timeout" || err.code === "engine_handshake_timeout";
 }
+var PI_AGENT_DIR_ENV = "PI_CODING_AGENT_DIR";
+var PI_ROOT_CWD_ENV = "PI_SUBAGENT_ROOT_CWD";
+function deriveHostSubagentSessionDir() {
+  const agentDir = process.env[PI_AGENT_DIR_ENV];
+  const resolvedAgentDir = agentDir !== void 0 && agentDir !== "" ? agentDir : (0, import_node_path4.join)((0, import_node_os2.homedir)(), ".pi", "agent");
+  const rootCwd = process.env[PI_ROOT_CWD_ENV];
+  const resolvedRootCwd = rootCwd !== void 0 && rootCwd !== "" ? rootCwd : process.cwd();
+  return getSubagentSessionDir(resolvedAgentDir, resolvedRootCwd);
+}
 function buildRunParams(task, ctx, runId) {
   const ctxModelRef = ctx.ctxModel ? `${ctx.ctxModel.provider}/${ctx.ctxModel.id}` : void 0;
   return {
@@ -1683,9 +1739,16 @@ function buildRunParams(task, ctx, runId) {
       schemaEnv: ctx.schemaEnv ?? task.schemaEnv,
       ctxModel: ctxModelRef,
       engineFallback: ctx.engineFallback,
-      streamMode: ctx.stream !== void 0 ? "stream" : void 0
+      streamMode: ctx.stream !== void 0 ? "stream" : void 0,
+      // [F6] 根 session id（relay 归属键 SESSION_ID 权威源）——undefined 不上 wire
+      //（additive 语义，与顶层 chat 参数同写法）。
+      ...ctx.sessionRootId !== void 0 ? { sessionRootId: ctx.sessionRootId } : {},
+      // [Option C 协议化] 权威 subagent session 目录（Gate B S6）：宿主注入值优先，
+      // 缺省同源 env 推导（deriveHostSubagentSessionDir）——恒有值恒上 wire，引擎
+      // 据此组装 --session-dir 不自推导（引擎本地推导降级 [LEGACY] fallback）。
+      sessionDir: ctx.sessionDir ?? deriveHostSubagentSessionDir()
     },
-    ...ctx.chat !== void 0 ? { chat: ctx.chat } : {}
+    ...ctx.resume !== void 0 ? { resume: ctx.resume } : {}
   };
 }
 function buildRunRouteHandlers(ctx) {
@@ -1693,9 +1756,7 @@ function buildRunRouteHandlers(ctx) {
     onEvent: (event) => ctx.onEvent?.(event),
     onStreamDelta: (delta) => ctx.stream?.onDelta(delta),
     onPoolResolved: (poolKey) => ctx.onPoolResolved?.(poolKey),
-    onHandleReady: (partial) => ctx.onHandleReady?.(partial),
-    // [W3 v1.x] 首轮（run 会话形态）轮次生命周期帧（runId 键）→ 宿主消费口。
-    onRoundLifecycle: (phase) => ctx.onRoundLifecycle?.(phase)
+    onHandleReady: (partial) => ctx.onHandleReady?.(partial)
   };
 }
 function wireAbortSignal(client, runId, ctx) {
@@ -1785,11 +1846,11 @@ function getHostUiRequestEndpoint() {
 }
 
 // src/execution/engine/engine-inspect-package.ts
-var logger10 = getLogger("subagents");
+var logger11 = getLogger("subagents");
 function readEnginePackageJson(pkgDir) {
   let raw;
   try {
-    raw = fs.readFileSync(path2.join(pkgDir, "package.json"), "utf8");
+    raw = fs.readFileSync(path3.join(pkgDir, "package.json"), "utf8");
   } catch (err) {
     return { status: "skip", reason: `package.json unreadable: ${errorMessage(err)}` };
   }
@@ -1864,12 +1925,12 @@ function parseOptionalDisplayFields(m, id) {
     if (typeof rawDisplayName === "string" && rawDisplayName.trim() !== "") {
       displayName = rawDisplayName;
     } else {
-      logger10.warn(`[engine-discovery] engine '${id}': displayName must be a non-empty string \u2014 ignoring`);
+      logger11.warn(`[engine-discovery] engine '${id}': displayName must be a non-empty string \u2014 ignoring`);
     }
   }
   const rawDescription = m["description"];
   if (rawDescription !== void 0 && typeof rawDescription !== "string") {
-    logger10.warn(`[engine-discovery] engine '${id}': description must be a string \u2014 ignoring`);
+    logger11.warn(`[engine-discovery] engine '${id}': description must be a string \u2014 ignoring`);
   }
   return displayName;
 }
@@ -1957,19 +2018,19 @@ function errorMessage(err) {
 
 // src/execution/engine/engine-discovery-roots.ts
 var fs2 = __toESM(require("fs"), 1);
-var path3 = __toESM(require("path"), 1);
-var logger11 = getLogger("subagents");
+var path4 = __toESM(require("path"), 1);
+var logger12 = getLogger("subagents");
 var ENGINE_ROOTS_ENV = "XYZ_AGENT_ENGINE_ROOTS";
 function parseEngineRootsEnv(env) {
   const raw = env[ENGINE_ROOTS_ENV];
   if (raw === void 0 || raw.trim() === "") return [];
   const out = [];
   const seen = /* @__PURE__ */ new Set();
-  for (const part of raw.split(path3.delimiter)) {
+  for (const part of raw.split(path4.delimiter)) {
     const dir = part.trim();
     if (dir === "") continue;
-    if (!path3.isAbsolute(dir)) {
-      logger11.warn(
+    if (!path4.isAbsolute(dir)) {
+      logger12.warn(
         `[engine-discovery] ${ENGINE_ROOTS_ENV} entry '${dir}' is not an absolute path \u2014 dropping entry`
       );
       continue;
@@ -1983,11 +2044,11 @@ function parseEngineRootsEnv(env) {
 function deriveNodeModuleRoots(argvEntry = process.argv[1]) {
   if (!argvEntry || argvEntry.trim() === "") return [];
   const roots = [];
-  let dir = path3.dirname(path3.resolve(argvEntry));
+  let dir = path4.dirname(path4.resolve(argvEntry));
   while (true) {
-    const nm = path3.join(dir, "node_modules");
+    const nm = path4.join(dir, "node_modules");
     if (isDirectory(nm)) roots.push(nm);
-    const parent = path3.dirname(dir);
+    const parent = path4.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
@@ -2002,8 +2063,8 @@ function scanEngineRoot(root, visit) {
   }
   for (const item of entries) {
     if (!item.isDirectory()) continue;
-    const dir = path3.join(root, item.name);
-    if (isFile(path3.join(dir, "package.json"))) {
+    const dir = path4.join(root, item.name);
+    if (isFile(path4.join(dir, "package.json"))) {
       visit(dir);
       continue;
     }
@@ -2015,8 +2076,8 @@ function scanEngineRoot(root, visit) {
     }
     for (const child of sub) {
       if (!child.isDirectory()) continue;
-      const subDir = path3.join(dir, child.name);
-      if (isFile(path3.join(subDir, "package.json"))) visit(subDir);
+      const subDir = path4.join(dir, child.name);
+      if (isFile(path4.join(subDir, "package.json"))) visit(subDir);
     }
   }
 }
@@ -2037,10 +2098,10 @@ function isFile(p) {
 
 // src/execution/engine/config.ts
 var fs3 = __toESM(require("fs"), 1);
-var path4 = __toESM(require("path"), 1);
-var logger12 = getLogger("subagents");
+var path5 = __toESM(require("path"), 1);
+var logger13 = getLogger("subagents");
 function readExplicitEngines(agentDir) {
-  const configPath = path4.join(agentDir, "subagents", "config.json");
+  const configPath = path5.join(agentDir, "subagents", "config.json");
   let parsed;
   try {
     parsed = JSON.parse(fs3.readFileSync(configPath, "utf8"));
@@ -2051,7 +2112,7 @@ function readExplicitEngines(agentDir) {
   const engines = parsed["engines"];
   if (typeof engines !== "object" || engines === null || Array.isArray(engines)) {
     if (engines !== void 0) {
-      logger12.warn(
+      logger13.warn(
         `[engine-discovery] config.json engines section must be an object keyed by engine id, got ${jsonKindOf(engines)} \u2014 ignoring L3 explicit engines`
       );
     }
@@ -2079,7 +2140,7 @@ function sanitizeExplicitEntry(id, raw) {
 }
 function requireEntryObject(id, raw) {
   if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    logger12.warn(
+    logger13.warn(
       `[engine-discovery] config.json engines.${id} must be an object, got ${jsonKindOf(raw)} \u2014 skipping entry`
     );
     return void 0;
@@ -2088,7 +2149,7 @@ function requireEntryObject(id, raw) {
 }
 function requireCommand(id, command) {
   if (typeof command !== "string" || command.trim() === "") {
-    logger12.warn(
+    logger13.warn(
       `[engine-discovery] config.json engines.${id}.command is required (non-empty string) \u2014 skipping entry`
     );
     return void 0;
@@ -2097,7 +2158,7 @@ function requireCommand(id, command) {
 }
 function normalizeArgs(id, args) {
   if (args !== void 0 && !isStringArray(args)) {
-    logger12.warn(
+    logger13.warn(
       `[engine-discovery] config.json engines.${id}.args must be a string array \u2014 ignoring args`
     );
   }
@@ -2105,7 +2166,7 @@ function normalizeArgs(id, args) {
 }
 function normalizeConfig(id, config) {
   if (config !== void 0 && !isStringRecord(config)) {
-    logger12.warn(
+    logger13.warn(
       `[engine-discovery] config.json engines.${id}.config must be a Record<string, string> \u2014 ignoring config`
     );
   }
@@ -2113,7 +2174,7 @@ function normalizeConfig(id, config) {
 }
 function normalizeCwd(id, cwd) {
   if (cwd !== void 0 && typeof cwd !== "string") {
-    logger12.warn(
+    logger13.warn(
       `[engine-discovery] config.json engines.${id}.cwd must be a string \u2014 ignoring cwd`
     );
   }
@@ -2133,7 +2194,7 @@ function jsonKindOf(value) {
 }
 
 // src/execution/engine/registry.ts
-var logger13 = getLogger("subagents");
+var logger14 = getLogger("subagents");
 var ENGINE_REGISTRY_SLOT_KEY = /* @__PURE__ */ Symbol.for("@zhushanwen/pi-subagent-workflow.engineRegistry");
 function getRegistrySlot() {
   let slot = Reflect.get(globalThis, ENGINE_REGISTRY_SLOT_KEY);
@@ -2147,12 +2208,12 @@ function triggerEngineDispose(engine, source) {
   if (typeof engine.dispose !== "function") return;
   try {
     engine.dispose().then(void 0, (err) => {
-      logger13.warn(
+      logger14.warn(
         `[engine-registry] engine '${engine.id}' dispose rejected (${source}, best-effort continue): ${err instanceof Error ? err.message : String(err)}`
       );
     });
   } catch (err) {
-    logger13.warn(
+    logger14.warn(
       `[engine-registry] engine '${engine.id}' dispose threw synchronously (${source}, best-effort continue): ${err instanceof Error ? err.message : String(err)}`
     );
   }
@@ -2169,14 +2230,14 @@ function hasEngine(id) {
 }
 
 // src/execution/engine/engine-discovery-scan.ts
-var logger14 = getLogger("subagents");
+var logger15 = getLogger("subagents");
 function scanEngines(opts) {
   const env = opts.env ?? process.env;
   const result = { discovered: [], skipped: [], unusable: [] };
   const present = (entry) => {
     const idx = result.discovered.findIndex((d) => d.id === entry.id);
     if (idx >= 0) {
-      logger14.debug(
+      logger15.debug(
         `[engine-discovery] engine id '${entry.id}' from '${entry.source}' overrides earlier discovery from '${result.discovered[idx].source}' \u2014 same-id override`
       );
       result.discovered[idx] = entry;
@@ -2188,13 +2249,13 @@ function scanEngines(opts) {
     const inspection = inspectEnginePackage(pkgDir, source, opts.hostKind, env);
     if (inspection.status === "skip") {
       if (!inspection.reason.includes("not an engine package")) {
-        logger14.warn(`[engine-discovery] skipping ${pkgDir} (${source}): ${inspection.reason}`);
+        logger15.warn(`[engine-discovery] skipping ${pkgDir} (${source}): ${inspection.reason}`);
         result.skipped.push({ pkgDir, reason: inspection.reason });
       }
       return;
     }
     if (inspection.status === "unusable") {
-      logger14.warn(`[engine-discovery] engine unavailable: ${inspection.reason}`);
+      logger15.warn(`[engine-discovery] engine unavailable: ${inspection.reason}`);
       result.unusable.push({ pkgDir, id: inspection.id, reason: inspection.reason });
       return;
     }
@@ -2219,7 +2280,7 @@ function scanEngines(opts) {
       const command = resolveExplicitCommand(entry.command, env);
       if (command === void 0) {
         const reason = `engine '${id}' (config.json engines.${id}): command '${entry.command}' not found or not executable`;
-        logger14.warn(`[engine-discovery] ${reason} \u2014 not registering`);
+        logger15.warn(`[engine-discovery] ${reason} \u2014 not registering`);
         result.unusable.push({ pkgDir: `config.json engines.${id}`, id, reason });
         continue;
       }
@@ -2236,7 +2297,7 @@ function discoverAndRegisterEngines(opts) {
     registerEngineDescriptor(entry.id, entry.descriptor);
     loadedDiscoveryIdSet.add(entry.id);
     if (existed) {
-      logger14.debug(
+      logger15.debug(
         `[engine-discovery] engine '${entry.id}' descriptor overwritten in registry (source '${entry.source}') \u2014 same-id override`
       );
     }
@@ -2253,20 +2314,20 @@ function ensureEngineDiscovered(id, opts) {
 }
 function resolveExplicitCommand(command, env) {
   if (command.includes("/") || command.includes("\\")) {
-    const p = path5.isAbsolute(command) ? command : path5.resolve(command);
+    const p = path6.isAbsolute(command) ? command : path6.resolve(command);
     return canExecute(p) ? p : void 0;
   }
   const pathVar = env["PATH"] ?? env["Path"] ?? "";
-  for (const dir of pathVar.split(path5.delimiter)) {
+  for (const dir of pathVar.split(path6.delimiter)) {
     if (dir === "") continue;
-    const p = path5.join(dir, command);
+    const p = path6.join(dir, command);
     if (canExecute(p)) return p;
   }
   return void 0;
 }
 function buildExplicitDescriptor(id, command, entry, opts) {
   const env = opts.env ?? process.env;
-  logger14.debug(
+  logger15.debug(
     `[engine-discovery] engine '${id}' registered from config.json engines section with conservative capabilities (no manifest)`
   );
   const caps = { ...CONSERVATIVE_CAPABILITIES };