@zhushanwen/subagent-core 0.7.1 → 0.8.0

package/dist/{chunk-VURUAGMM.js → chunk-OL5BK4VN.js}

@@ -367,16 +367,16 @@ var SpawnedChildrenMirror = class {
     return this.entries.size;
   }
   /** 订阅状态广播（W6 notify/谓词接线点）。返回退订函数。 */
-  onChange(listener) {
-    this.listeners.add(listener);
+  onChange(listener2) {
+    this.listeners.add(listener2);
     return () => {
-      this.listeners.delete(listener);
+      this.listeners.delete(listener2);
     };
   }
   emit(event) {
-    for (const listener of this.listeners) {
+    for (const listener2 of this.listeners) {
       try {
-        listener(event);
+        listener2(event);
       } catch (err) {
         logger3.debug(
           `[spawned-children-mirror] listener threw for ${event.reason}: ${err instanceof Error ? err.message : String(err)}`
@@ -831,8 +831,189 @@ function waitForChildExit(child, timeoutMs) {
   });
 }
 
+// src/execution/engine/host/spawned-children.ts
+var CoreSpawnedChildrenMirror = class {
+  entries = /* @__PURE__ */ new Map();
+  /** 落项 / 覆盖（同 recordId 重 spawn = 覆盖旧句柄，与引擎侧 Map 同语义）。 */
+  register(recordId, child) {
+    this.entries.set(recordId, {
+      pid: child.pid,
+      killed: child.killed,
+      updatedAt: Date.now()
+    });
+  }
+  /** 单项置死（杀链入口：killRecordChildWithEscalation 途经）。 */
+  markKilled(recordId) {
+    const entry = this.entries.get(recordId);
+    if (entry !== void 0) {
+      entry.killed = true;
+      entry.updatedAt = Date.now();
+    }
+  }
+  /** 整体置死 + 清空（失效语义 2+3：引擎 exit / 重建 / dispose / killAll）。 */
+  killAll() {
+    this.entries.clear();
+  }
+  getChildByRecord(recordId) {
+    return this.entries.get(recordId);
+  }
+  /** 句柄存活谓词（镜像面；判据与引擎侧 `!child.killed` 同构）。 */
+  hasLiveProcessHandle(recordId) {
+    const entry = this.entries.get(recordId);
+    return entry !== void 0 && !entry.killed;
+  }
+  /** 快照（诊断/测试）。 */
+  snapshot() {
+    return [...this.entries.entries()].map(([recordId, entry]) => ({ recordId, ...entry }));
+  }
+  /** 测试隔离专用（生产禁用——进程级全局状态）。 */
+  clear() {
+    this.entries.clear();
+  }
+};
+var MIRROR_SLOT_KEY = /* @__PURE__ */ Symbol.for(
+  "@zhushanwen/pi-subagent-workflow.coreSpawnedChildrenMirror"
+);
+function coreMirrorSlot() {
+  let slot = Reflect.get(globalThis, MIRROR_SLOT_KEY);
+  if (!slot) {
+    slot = new CoreSpawnedChildrenMirror();
+    Reflect.set(globalThis, MIRROR_SLOT_KEY, slot);
+  }
+  return slot;
+}
+function coreSpawnedChildrenMirror() {
+  return coreMirrorSlot();
+}
+function registerSpawnedChildForRecord(recordId, child) {
+  coreMirrorSlot().register(recordId, { pid: child.pid, killed: child.killed });
+}
+function killRecordChildWithEscalation(recordId, _source) {
+  coreMirrorSlot().markKilled(recordId);
+}
+function killAllSpawnedChildren(_signal = "SIGTERM") {
+  const before = coreMirrorSlot().snapshot().length;
+  coreMirrorSlot().killAll();
+  return before;
+}
+function hasLiveProcessHandleCore(recordId) {
+  return coreMirrorSlot().hasLiveProcessHandle(recordId);
+}
+
+// src/shared/timer-delay.ts
+var MAX_TIMER_DELAY_MS = 2147483647;
+function assertSafeTimerDelay(ms, source) {
+  if (!Number.isFinite(ms)) {
+    throw new Error(
+      `[subagent-workflow] ${source} = ${ms} is not a finite number (NaN/\xB1Infinity). Non-finite delays collapse to 1ms in Node setTimeout and fire immediately. Recovery: fix the upstream computation that produced this value (e.g. guard division/parse results before passing them in) and retry.`
+    );
+  }
+  if (ms > MAX_TIMER_DELAY_MS) {
+    throw new Error(
+      `[subagent-workflow] ${source} = ${ms} exceeds the Node setTimeout limit (${MAX_TIMER_DELAY_MS} ms = 2^31-1); larger delays silently collapse to 1ms and fire immediately. Recovery: clamp the value to <= ${MAX_TIMER_DELAY_MS} (e.g. omit the option for "unlimited" semantics, or clamp explicitly) and retry.`
+    );
+  }
+}
+
+// src/execution/lifecycle-manager.ts
+var logger8 = getLogger("subagents");
+var MS_PER_SECOND = 1e3;
+var SECONDS_PER_MINUTE = 60;
+var IDLE_TIMEOUT_MINUTES = 5;
+var DEFAULT_IDLE_TIMEOUT_MS = IDLE_TIMEOUT_MINUTES * SECONDS_PER_MINUTE * MS_PER_SECOND;
+function getEnvIdleTimeoutMs() {
+  const raw = process.env.XYZ_SUBAGENT_IDLE_TIMEOUT_MS;
+  if (!raw) return void 0;
+  const parsed = Number(raw);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    logger8.warn(
+      `[lifecycle-manager] XYZ_SUBAGENT_IDLE_TIMEOUT_MS="${raw}" is invalid (expected a positive millisecond number) \u2014 falling back to DEFAULT_IDLE_TIMEOUT_MS (${DEFAULT_IDLE_TIMEOUT_MS}ms); set a plain ms value (e.g. 1800000) to override`
+    );
+    return void 0;
+  }
+  return parsed;
+}
+var idleTimers = /* @__PURE__ */ new Map();
+function armIdleTimer(recordId, onTimeout, timeoutMs) {
+  if (timeoutMs !== void 0 && timeoutMs <= 0) {
+    disarmIdleTimer(recordId);
+    return;
+  }
+  const resolved = timeoutMs ?? getEnvIdleTimeoutMs() ?? DEFAULT_IDLE_TIMEOUT_MS;
+  assertSafeTimerDelay(resolved, "idleTimeoutMs");
+  disarmIdleTimer(recordId);
+  const timer = setTimeout(() => {
+    if (idleTimers.get(recordId)?.timer === timer) {
+      idleTimers.delete(recordId);
+    }
+    onTimeout();
+  }, resolved);
+  timer.unref?.();
+  idleTimers.set(recordId, { timer, timeoutMs: resolved });
+}
+function disarmIdleTimer(recordId) {
+  const entry = idleTimers.get(recordId);
+  if (!entry) {
+    return;
+  }
+  clearTimeout(entry.timer);
+  idleTimers.delete(recordId);
+}
+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) {
+  return hasLiveProcessHandleCore(recordId);
+}
+function isIdle(record) {
+  return hasIdleTimer(record.id);
+}
+function isResumable(record) {
+  return record.status === "running" && !hasLiveProcessHandle(record.id);
+}
+
+// src/execution/engine/inflight-snapshot.ts
+var listener = null;
+function setInFlightListener(next) {
+  listener = next;
+}
+function getInFlightSnapshot() {
+  return { inFlight: countInFlight() };
+}
+function notifyInFlightChanged() {
+  if (listener === null) return;
+  try {
+    listener(getInFlightSnapshot());
+  } catch {
+  }
+}
+function countInFlight() {
+  let count = 0;
+  for (const entry of coreSpawnedChildrenMirror().snapshot()) {
+    const recordId = entry.recordId;
+    if (hasLiveProcessHandle(recordId) && !hasIdleTimer(recordId)) count++;
+  }
+  return count;
+}
+
 // src/execution/engine/client/engine-client.ts
-var logger8 = getLogger7("subagents");
+var logger9 = getLogger7("subagents");
+function bridgeMirrorEventToCoreMirror(event, mirror) {
+  if (event.recordId === void 0 || event.pid === void 0) return;
+  const entry = mirror.getEntry(event.pid);
+  if (entry === void 0) return;
+  const core = coreSpawnedChildrenMirror();
+  if (entry.killed) {
+    core.markKilled(event.recordId);
+  } else {
+    core.register(event.recordId, { pid: entry.pid, killed: false });
+  }
+  notifyInFlightChanged();
+}
 var DISPOSE_GRACE_MS = 3e3;
 var SIGKILL_REAP_TIMEOUT_MS = 1e4;
 var FRAME_ECHO_MAX_CHARS = 200;
@@ -895,6 +1076,7 @@ var EngineClient = class {
     };
     this.mirror.onChange((event) => {
       opts.onMirrorChanged?.(event);
+      bridgeMirrorEventToCoreMirror(event, this.mirror);
     });
   }
   get currentState() {
@@ -957,19 +1139,19 @@ var EngineClient = class {
         matchesEngineCmdline: this.opts.engineCmdlineMatcher ?? defaultEngineCmdlineMatcher(this.opts.command)
       });
       if (sweep.killed.length > 0) {
-        logger8.warn(
+        logger9.warn(
           `[engine-client:${this.engineId}] startup sweep killed stale orphan engine pids: ${sweep.killed.join(",")}`
         );
       }
       for (const removed of sweep.removed) {
-        logger8.debug(`[engine-client:${this.engineId}] swept stale pidfile ${removed.file}: ${removed.reason}`);
+        logger9.debug(`[engine-client:${this.engineId}] swept stale pidfile ${removed.file}: ${removed.reason}`);
       }
     }
     let attempt = 0;
     while (attempt <= CRASH_REBUILD_MAX_ATTEMPTS) {
       if (attempt > 0) {
         const backoff = CRASH_REBUILD_BACKOFF_MS[attempt - 1];
-        logger8.warn(
+        logger9.warn(
           `[engine-client:${this.engineId}] rebuild attempt ${attempt}/${CRASH_REBUILD_MAX_ATTEMPTS} after ${backoff}ms backoff`
         );
         await delay(backoff);
@@ -1002,7 +1184,7 @@ var EngineClient = class {
   markUnavailable(reason) {
     this.state = "unavailable";
     this.unavailableReason = reason;
-    logger8.error(`[engine-client:${this.engineId}] marked unavailable: ${reason.message}`);
+    logger9.error(`[engine-client:${this.engineId}] marked unavailable: ${reason.message}`);
   }
   /** spawn 引擎 CLI + initialize 握手 + 版本协商 + 诊断留痕。 */
   async spawnAndInitialize() {
@@ -1032,13 +1214,13 @@ var EngineClient = class {
     });
     const child = this.child;
     child.on("error", (err) => {
-      logger8.warn(`[engine-client:${this.engineId}] spawn error: ${err.message}`);
+      logger9.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) => {
-        logger8.debug(`[engine-client:${this.engineId}] ${pipe} pipe error (engine died concurrently = expected): ${err.message}`);
+        logger9.debug(`[engine-client:${this.engineId}] ${pipe} pipe error (engine died concurrently = expected): ${err.message}`);
       });
     }
     child.stdout?.setEncoding("utf-8");
@@ -1107,7 +1289,7 @@ var EngineClient = class {
     try {
       frame = JSON.parse(line);
     } catch {
-      logger8.warn(
+      logger9.warn(
         `[engine-client:${this.engineId}] dropped non-NDJSON stdout line (protocol contract: stdout is NDJSON-only): ${truncate(line, FRAME_ECHO_MAX_CHARS)}`
       );
       return;
@@ -1124,7 +1306,7 @@ var EngineClient = class {
       this.onReverseRequest(frame);
       return;
     }
-    logger8.warn(
+    logger9.warn(
       `[engine-client:${this.engineId}] dropped unrecognized frame: ${truncate(line, FRAME_ECHO_MAX_CHARS)}`
     );
   }
@@ -1248,7 +1430,7 @@ var EngineClient = class {
       try {
         await this.request("dispose", {}, { timeoutMs: DISPOSE_GRACE_MS });
       } catch (err) {
-        logger8.debug(
+        logger9.debug(
           `[engine-client:${this.engineId}] dispose frame failed, falling back to kill chain: ${err instanceof Error ? err.message : String(err)}`
         );
       }
@@ -1260,9 +1442,9 @@ var EngineClient = class {
   onEngineExit(code, signal) {
     const detail = signal !== null ? `signal ${signal}` : `exit code ${code}`;
     if (this.intentionalKill) {
-      logger8.debug(`[engine-client:${this.engineId}] engine exited after intentional kill (${detail}) \u2014 expected`);
+      logger9.debug(`[engine-client:${this.engineId}] engine exited after intentional kill (${detail}) \u2014 expected`);
     } else {
-      logger8.warn(`[engine-client:${this.engineId}] engine process exited unexpectedly (${detail})`);
+      logger9.warn(`[engine-client:${this.engineId}] engine process exited unexpectedly (${detail})`);
     }
     this.teardownProcess(detail);
     this.state = "exited";
@@ -1311,7 +1493,7 @@ var EngineClient = class {
 `);
       return true;
     } catch (err) {
-      logger8.debug(
+      logger9.debug(
         `[engine-client:${this.engineId}] stdin write failed: ${err instanceof Error ? err.message : String(err)}`
       );
       return false;
@@ -1695,7 +1877,7 @@ function getHostUiRequestEndpoint() {
 }
 
 // src/execution/engine/engine-inspect-package.ts
-var logger9 = getLogger("subagents");
+var logger10 = getLogger("subagents");
 function readEnginePackageJson(pkgDir) {
   let raw;
   try {
@@ -1774,12 +1956,12 @@ function parseOptionalDisplayFields(m, id) {
     if (typeof rawDisplayName === "string" && rawDisplayName.trim() !== "") {
       displayName = rawDisplayName;
     } else {
-      logger9.warn(`[engine-discovery] engine '${id}': displayName must be a non-empty string \u2014 ignoring`);
+      logger10.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") {
-    logger9.warn(`[engine-discovery] engine '${id}': description must be a string \u2014 ignoring`);
+    logger10.warn(`[engine-discovery] engine '${id}': description must be a string \u2014 ignoring`);
   }
   return displayName;
 }
@@ -1868,7 +2050,7 @@ function errorMessage(err) {
 // src/execution/engine/engine-discovery-roots.ts
 import * as fs2 from "fs";
 import * as path3 from "path";
-var logger10 = getLogger("subagents");
+var logger11 = getLogger("subagents");
 var ENGINE_ROOTS_ENV = "XYZ_AGENT_ENGINE_ROOTS";
 function parseEngineRootsEnv(env) {
   const raw = env[ENGINE_ROOTS_ENV];
@@ -1879,7 +2061,7 @@ function parseEngineRootsEnv(env) {
     const dir = part.trim();
     if (dir === "") continue;
     if (!path3.isAbsolute(dir)) {
-      logger10.warn(
+      logger11.warn(
         `[engine-discovery] ${ENGINE_ROOTS_ENV} entry '${dir}' is not an absolute path \u2014 dropping entry`
       );
       continue;
@@ -1948,7 +2130,7 @@ function isFile(p) {
 // src/execution/engine/config.ts
 import * as fs3 from "fs";
 import * as path4 from "path";
-var logger11 = getLogger("subagents");
+var logger12 = getLogger("subagents");
 function readExplicitEngines(agentDir) {
   const configPath = path4.join(agentDir, "subagents", "config.json");
   let parsed;
@@ -1961,7 +2143,7 @@ function readExplicitEngines(agentDir) {
   const engines = parsed["engines"];
   if (typeof engines !== "object" || engines === null || Array.isArray(engines)) {
     if (engines !== void 0) {
-      logger11.warn(
+      logger12.warn(
         `[engine-discovery] config.json engines section must be an object keyed by engine id, got ${jsonKindOf(engines)} \u2014 ignoring L3 explicit engines`
       );
     }
@@ -1989,7 +2171,7 @@ function sanitizeExplicitEntry(id, raw) {
 }
 function requireEntryObject(id, raw) {
   if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
-    logger11.warn(
+    logger12.warn(
       `[engine-discovery] config.json engines.${id} must be an object, got ${jsonKindOf(raw)} \u2014 skipping entry`
     );
     return void 0;
@@ -1998,7 +2180,7 @@ function requireEntryObject(id, raw) {
 }
 function requireCommand(id, command) {
   if (typeof command !== "string" || command.trim() === "") {
-    logger11.warn(
+    logger12.warn(
       `[engine-discovery] config.json engines.${id}.command is required (non-empty string) \u2014 skipping entry`
     );
     return void 0;
@@ -2007,7 +2189,7 @@ function requireCommand(id, command) {
 }
 function normalizeArgs(id, args) {
   if (args !== void 0 && !isStringArray(args)) {
-    logger11.warn(
+    logger12.warn(
       `[engine-discovery] config.json engines.${id}.args must be a string array \u2014 ignoring args`
     );
   }
@@ -2015,7 +2197,7 @@ function normalizeArgs(id, args) {
 }
 function normalizeConfig(id, config) {
   if (config !== void 0 && !isStringRecord(config)) {
-    logger11.warn(
+    logger12.warn(
       `[engine-discovery] config.json engines.${id}.config must be a Record<string, string> \u2014 ignoring config`
     );
   }
@@ -2023,7 +2205,7 @@ function normalizeConfig(id, config) {
 }
 function normalizeCwd(id, cwd) {
   if (cwd !== void 0 && typeof cwd !== "string") {
-    logger11.warn(
+    logger12.warn(
       `[engine-discovery] config.json engines.${id}.cwd must be a string \u2014 ignoring cwd`
     );
   }
@@ -2043,7 +2225,7 @@ function jsonKindOf(value) {
 }
 
 // src/execution/engine/registry.ts
-var logger12 = getLogger("subagents");
+var logger13 = getLogger("subagents");
 var DEFAULT_ENGINE_ID = "pi";
 function normalizeEngineId(engine) {
   return engine?.trim() || DEFAULT_ENGINE_ID;
@@ -2083,12 +2265,12 @@ function triggerEngineDispose(engine, source) {
   if (typeof engine.dispose !== "function") return;
   try {
     engine.dispose().then(void 0, (err) => {
-      logger12.warn(
+      logger13.warn(
         `[engine-registry] engine '${engine.id}' dispose rejected (${source}, best-effort continue): ${err instanceof Error ? err.message : String(err)}`
       );
     });
   } catch (err) {
-    logger12.warn(
+    logger13.warn(
       `[engine-registry] engine '${engine.id}' dispose threw synchronously (${source}, best-effort continue): ${err instanceof Error ? err.message : String(err)}`
     );
   }
@@ -2131,14 +2313,14 @@ function listEnginesByDisplayName() {
 }
 
 // src/execution/engine/engine-discovery-scan.ts
-var logger13 = getLogger("subagents");
+var logger14 = 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) {
-      logger13.debug(
+      logger14.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;
@@ -2150,13 +2332,13 @@ function scanEngines(opts) {
     const inspection = inspectEnginePackage(pkgDir, source, opts.hostKind, env);
     if (inspection.status === "skip") {
       if (!inspection.reason.includes("not an engine package")) {
-        logger13.warn(`[engine-discovery] skipping ${pkgDir} (${source}): ${inspection.reason}`);
+        logger14.warn(`[engine-discovery] skipping ${pkgDir} (${source}): ${inspection.reason}`);
         result.skipped.push({ pkgDir, reason: inspection.reason });
       }
       return;
     }
     if (inspection.status === "unusable") {
-      logger13.warn(`[engine-discovery] engine unavailable: ${inspection.reason}`);
+      logger14.warn(`[engine-discovery] engine unavailable: ${inspection.reason}`);
       result.unusable.push({ pkgDir, id: inspection.id, reason: inspection.reason });
       return;
     }
@@ -2181,7 +2363,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`;
-        logger13.warn(`[engine-discovery] ${reason} \u2014 not registering`);
+        logger14.warn(`[engine-discovery] ${reason} \u2014 not registering`);
         result.unusable.push({ pkgDir: `config.json engines.${id}`, id, reason });
         continue;
       }
@@ -2198,7 +2380,7 @@ function discoverAndRegisterEngines(opts) {
     registerEngineDescriptor(entry.id, entry.descriptor);
     loadedDiscoveryIdSet.add(entry.id);
     if (existed) {
-      logger13.debug(
+      logger14.debug(
         `[engine-discovery] engine '${entry.id}' descriptor overwritten in registry (source '${entry.source}') \u2014 same-id override`
       );
     }
@@ -2228,7 +2410,7 @@ function resolveExplicitCommand(command, env) {
 }
 function buildExplicitDescriptor(id, command, entry, opts) {
   const env = opts.env ?? process.env;
-  logger13.debug(
+  logger14.debug(
     `[engine-discovery] engine '${id}' registered from config.json engines section with conservative capabilities (no manifest)`
   );
   const caps = { ...CONSERVATIVE_CAPABILITIES };
@@ -2290,6 +2472,21 @@ export {
   parseEnvPrefixes,
   parseModelCatalog,
   getEngineDataDir,
+  registerSpawnedChildForRecord,
+  killRecordChildWithEscalation,
+  killAllSpawnedChildren,
+  MAX_TIMER_DELAY_MS,
+  assertSafeTimerDelay,
+  DEFAULT_IDLE_TIMEOUT_MS,
+  armIdleTimer,
+  disarmIdleTimer,
+  hasIdleTimer,
+  hasLiveProcessHandle,
+  isIdle,
+  isResumable,
+  setInFlightListener,
+  getInFlightSnapshot,
+  notifyInFlightChanged,
   EngineClient,
   assertTaskShapeSupported,
   RemoteEngine,

package/dist/{engine-discovery-scan-ocpM8FmI.d.cts → engine-discovery-scan-BXLA8y-z.d.cts}

@@ -1413,6 +1413,22 @@ interface EnginePort {
      * Promise 前完成；grace→SIGKILL 升级序列属异步面（promise 段）。
      */
     dispose?(): Promise<void>;
+    /**
+     * [u7a D5] 可选面：引擎在途任务只读快照（滚动重启推迟谓词的引擎侧输入——
+     * 权威源：docs/design/crash-forensics-and-watchdog.md §3.3 D5「推迟判定源 =
+     * relay ∪ 引擎池在途 ∪ pi 侧 extension 聚合上报」）。同步纯读、无副作用。
+     *
+     * 返回 null = 引擎不提供快照；成员缺席（undefined，pi 引擎不实现）= 无引擎侧
+     * 在途面——pi 形态的在途由 subagent-workflow extension 聚合上报覆盖（EnginePort
+     * 之外的第 4 通道，两通道互不替代）。可选成员保持向后兼容（port.ts 既有扩展
+     * 先例：listModels / validateModel / dispose 全为可选成员）。
+     *
+     * zcode 实现语义（显式裁决）：在途 = activeSessions 非空——poolKey 'shared' 的
+     * app-server 空闲常驻进程恒活，**禁止按进程存在判定**（会恒真、推迟常态化）。
+     */
+    inFlightSnapshot?(): {
+        inFlight: number;
+    } | null;
 }
 
 /** 引擎工厂：惰性创建引擎实例（getEngine 首次取用时执行）。 */
@@ -1515,7 +1531,7 @@ declare function parseEngineRootsEnv(env: NodeJS.ProcessEnv): string[];
  */
 declare function deriveNodeModuleRoots(argvEntry?: string | undefined): string[];
 
-/** 日志级别。对齐 @zhushanwen/pi-extension-logger 的 LogLevel（三值，无 info）。 */
+/** 日志级别。级别集合对齐 pi-extension-logger（其 LogLevel 为包内部类型、含 info 四值；实例 API 仅 debug/warn/error 三方法，core facade 据此收窄为三值）。 */
 type LogLevel = "debug" | "warn" | "error";
 /** core logger 接口。与 pi-extension-logger 的 ExtensionLogger 结构兼容——
  *  u0-log 批次替换是纯 import 源替换，调用面（方法名/参数序）逐文件等价。 */

package/dist/{engine-discovery-scan-ocpM8FmI.d.ts → engine-discovery-scan-BXLA8y-z.d.ts}

@@ -1413,6 +1413,22 @@ interface EnginePort {
      * Promise 前完成；grace→SIGKILL 升级序列属异步面（promise 段）。
      */
     dispose?(): Promise<void>;
+    /**
+     * [u7a D5] 可选面：引擎在途任务只读快照（滚动重启推迟谓词的引擎侧输入——
+     * 权威源：docs/design/crash-forensics-and-watchdog.md §3.3 D5「推迟判定源 =
+     * relay ∪ 引擎池在途 ∪ pi 侧 extension 聚合上报」）。同步纯读、无副作用。
+     *
+     * 返回 null = 引擎不提供快照；成员缺席（undefined，pi 引擎不实现）= 无引擎侧
+     * 在途面——pi 形态的在途由 subagent-workflow extension 聚合上报覆盖（EnginePort
+     * 之外的第 4 通道，两通道互不替代）。可选成员保持向后兼容（port.ts 既有扩展
+     * 先例：listModels / validateModel / dispose 全为可选成员）。
+     *
+     * zcode 实现语义（显式裁决）：在途 = activeSessions 非空——poolKey 'shared' 的
+     * app-server 空闲常驻进程恒活，**禁止按进程存在判定**（会恒真、推迟常态化）。
+     */
+    inFlightSnapshot?(): {
+        inFlight: number;
+    } | null;
 }
 
 /** 引擎工厂：惰性创建引擎实例（getEngine 首次取用时执行）。 */
@@ -1515,7 +1531,7 @@ declare function parseEngineRootsEnv(env: NodeJS.ProcessEnv): string[];
  */
 declare function deriveNodeModuleRoots(argvEntry?: string | undefined): string[];
 
-/** 日志级别。对齐 @zhushanwen/pi-extension-logger 的 LogLevel（三值，无 info）。 */
+/** 日志级别。级别集合对齐 pi-extension-logger（其 LogLevel 为包内部类型、含 info 四值；实例 API 仅 debug/warn/error 三方法，core facade 据此收窄为三值）。 */
 type LogLevel = "debug" | "warn" | "error";
 /** core logger 接口。与 pi-extension-logger 的 ExtensionLogger 结构兼容——
  *  u0-log 批次替换是纯 import 源替换，调用面（方法名/参数序）逐文件等价。 */