@zhushanwen/subagent-engine-sdk 0.7.1 → 0.8.0

package/dist/best-effort.cjs

@@ -24,8 +24,16 @@ __export(best_effort_exports, {
 });
 module.exports = __toCommonJS(best_effort_exports);
 
+// src/global-slots.ts
+var ENGINE_SDK_SLOT_KEYS = {
+  /** dataDir 缺省告警一次性标记（data-dir.ts）。 */
+  dataDirWarned: "@zhushanwen/subagent-engine-sdk.data-dir-warned",
+  /** logger sink 进程级单例（logger.ts）。 */
+  loggerSink: "@zhushanwen/subagent-engine-sdk.logger-sink"
+};
+
 // src/logger.ts
-var SINK_SLOT_KEY = /* @__PURE__ */ Symbol.for("@zhushanwen/subagent-engine-sdk.logger-sink");
+var SINK_SLOT_KEY = Symbol.for(ENGINE_SDK_SLOT_KEYS.loggerSink);
 function getSinkSlot() {
   let slot = Reflect.get(globalThis, SINK_SLOT_KEY);
   if (!slot) {

package/dist/best-effort.js

@@ -1,7 +1,7 @@
 import {
   bestEffort
-} from "./chunk-EJMF63R5.js";
-import "./chunk-75QEMUGV.js";
+} from "./chunk-QMEHSKNR.js";
+import "./chunk-NXNNXGTY.js";
 import "./chunk-JSBRDJBE.js";
 export {
   bestEffort

package/dist/{chunk-X24IVQKJ.js → chunk-3FVBDH3X.js}

@@ -1,11 +1,12 @@
 import {
+  ENGINE_SDK_SLOT_KEYS,
   getLogger
-} from "./chunk-75QEMUGV.js";
+} from "./chunk-NXNNXGTY.js";
 
 // src/data-dir.ts
 var logger = getLogger("subagents");
 var TAIJI_DATA_DIR_ENV = "TAIJI_AGENT_DATA_DIR";
-var WARNED_SLOT_KEY = /* @__PURE__ */ Symbol.for("@zhushanwen/subagent-engine-sdk.data-dir-warned");
+var WARNED_SLOT_KEY = Symbol.for(ENGINE_SDK_SLOT_KEYS.dataDirWarned);
 function getWarnedSlot() {
   let slot = Reflect.get(globalThis, WARNED_SLOT_KEY);
   if (!slot) {

package/dist/{chunk-YL5W5EMV.js → chunk-AF2ETADP.js}

@@ -1,6 +1,6 @@
 import {
   getLogger
-} from "./chunk-75QEMUGV.js";
+} from "./chunk-NXNNXGTY.js";
 
 // src/env.ts
 var logger = getLogger("engine-sdk/env");

package/dist/chunk-D36ZIQQK.js

@@ -0,0 +1,28 @@
+// src/protocol/frames.ts
+function isRecord(v) {
+  return typeof v === "object" && v !== null;
+}
+function isRequestFrame(frame) {
+  return isRecord(frame) && typeof frame.id === "number" && typeof frame.method === "string" && "params" in frame && !("result" in frame) && !("error" in frame);
+}
+function isResponseFrame(frame) {
+  if (!isRecord(frame) || !("id" in frame)) return false;
+  const idOk = typeof frame.id === "number" || typeof frame.id === "string";
+  if (!idOk) return false;
+  const hasResult = "result" in frame;
+  const hasError = "error" in frame;
+  return hasResult !== hasError;
+}
+function isNotificationFrame(frame) {
+  return isRecord(frame) && !("id" in frame) && frame.method === "event" && isRecord(frame.params) && typeof frame.params.runId === "string" && typeof frame.params.seq === "number" && isRecord(frame.params.event) && typeof frame.params.event.type === "string";
+}
+function isReverseRequestFrame(frame) {
+  return isRecord(frame) && typeof frame.id === "string" && typeof frame.method === "string" && frame.method.startsWith("host/") && "params" in frame;
+}
+
+export {
+  isRequestFrame,
+  isResponseFrame,
+  isNotificationFrame,
+  isReverseRequestFrame
+};

package/dist/{chunk-W23PAAGX.js → chunk-DIIYVO4O.js}

@@ -1,25 +1,3 @@
-// src/protocol/frames.ts
-function isRecord(v) {
-  return typeof v === "object" && v !== null;
-}
-function isRequestFrame(frame) {
-  return isRecord(frame) && typeof frame.id === "number" && typeof frame.method === "string" && "params" in frame && !("result" in frame) && !("error" in frame);
-}
-function isResponseFrame(frame) {
-  if (!isRecord(frame) || !("id" in frame)) return false;
-  const idOk = typeof frame.id === "number" || typeof frame.id === "string";
-  if (!idOk) return false;
-  const hasResult = "result" in frame;
-  const hasError = "error" in frame;
-  return hasResult !== hasError;
-}
-function isNotificationFrame(frame) {
-  return isRecord(frame) && !("id" in frame) && frame.method === "event" && isRecord(frame.params) && typeof frame.params.runId === "string" && typeof frame.params.seq === "number" && isRecord(frame.params.event) && typeof frame.params.event.type === "string";
-}
-function isReverseRequestFrame(frame) {
-  return isRecord(frame) && typeof frame.id === "string" && typeof frame.method === "string" && frame.method.startsWith("host/") && "params" in frame;
-}
-
 // src/protocol/methods.ts
 var PROTOCOL_METHODS = [
   "initialize",
@@ -198,17 +176,13 @@ var runSessionParamsSchema = {
       properties: {
         // ResumeAnchor.sessionRef = Record<string, string>（引擎定位键值对）
         sessionRef: { type: "object", additionalProperties: { type: "string" } },
-        journalPath: { type: "string" }
+        eventsPath: { type: "string" }
       }
     }
   }
 };
 
 export {
-  isRequestFrame,
-  isResponseFrame,
-  isNotificationFrame,
-  isReverseRequestFrame,
   PROTOCOL_METHODS,
   REVERSE_CHANNELS,
   REVERSE_CHANNEL_TIMEOUT_CLASS,

package/dist/{chunk-RCT7L777.js → chunk-F7VDVSBZ.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-SFNTX7Q3.js";
 import {
   getLogger
-} from "./chunk-75QEMUGV.js";
+} from "./chunk-NXNNXGTY.js";
 
 // src/kill-chain.ts
 var logger = getLogger("subagents");

package/dist/{chunk-HERD6RIR.js → chunk-MQPASWMA.js}

@@ -1,10 +1,10 @@
 import {
   killChain,
   safeKill
-} from "./chunk-RCT7L777.js";
+} from "./chunk-F7VDVSBZ.js";
 import {
   getLogger
-} from "./chunk-75QEMUGV.js";
+} from "./chunk-NXNNXGTY.js";
 
 // src/spawn.ts
 import { spawn } from "child_process";

package/dist/{chunk-75QEMUGV.js → chunk-NXNNXGTY.js}

@@ -1,5 +1,13 @@
+// src/global-slots.ts
+var ENGINE_SDK_SLOT_KEYS = {
+  /** dataDir 缺省告警一次性标记（data-dir.ts）。 */
+  dataDirWarned: "@zhushanwen/subagent-engine-sdk.data-dir-warned",
+  /** logger sink 进程级单例（logger.ts）。 */
+  loggerSink: "@zhushanwen/subagent-engine-sdk.logger-sink"
+};
+
 // src/logger.ts
-var SINK_SLOT_KEY = /* @__PURE__ */ Symbol.for("@zhushanwen/subagent-engine-sdk.logger-sink");
+var SINK_SLOT_KEY = Symbol.for(ENGINE_SDK_SLOT_KEYS.loggerSink);
 function getSinkSlot() {
   let slot = Reflect.get(globalThis, SINK_SLOT_KEY);
   if (!slot) {
@@ -52,6 +60,7 @@ function getLogger(component) {
 }
 
 export {
+  ENGINE_SDK_SLOT_KEYS,
   configureLoggerSink,
   resetLoggerSinkForTests,
   getLogger

package/dist/{chunk-EJMF63R5.js → chunk-QMEHSKNR.js}

@@ -1,6 +1,6 @@
 import {
   getLogger
-} from "./chunk-75QEMUGV.js";
+} from "./chunk-NXNNXGTY.js";
 
 // src/best-effort.ts
 var logger = getLogger("subagents");

package/dist/{chunk-J4G2MXDS.js → chunk-VE3NVT7K.js}

@@ -1,7 +1,7 @@
 import {
   configureLoggerSink,
   getLogger
-} from "./chunk-75QEMUGV.js";
+} from "./chunk-NXNNXGTY.js";
 
 // src/cli-entry.ts
 import * as readline from "readline";

package/dist/cli-entry.cjs

@@ -35,8 +35,16 @@ __export(cli_entry_exports, {
 module.exports = __toCommonJS(cli_entry_exports);
 var readline = __toESM(require("readline"), 1);
 
+// src/global-slots.ts
+var ENGINE_SDK_SLOT_KEYS = {
+  /** dataDir 缺省告警一次性标记（data-dir.ts）。 */
+  dataDirWarned: "@zhushanwen/subagent-engine-sdk.data-dir-warned",
+  /** logger sink 进程级单例（logger.ts）。 */
+  loggerSink: "@zhushanwen/subagent-engine-sdk.logger-sink"
+};
+
 // src/logger.ts
-var SINK_SLOT_KEY = /* @__PURE__ */ Symbol.for("@zhushanwen/subagent-engine-sdk.logger-sink");
+var SINK_SLOT_KEY = Symbol.for(ENGINE_SDK_SLOT_KEYS.loggerSink);
 function getSinkSlot() {
   let slot = Reflect.get(globalThis, SINK_SLOT_KEY);
   if (!slot) {

package/dist/cli-entry.js

@@ -1,7 +1,7 @@
 import {
   runEngineCliEntry
-} from "./chunk-J4G2MXDS.js";
-import "./chunk-75QEMUGV.js";
+} from "./chunk-VE3NVT7K.js";
+import "./chunk-NXNNXGTY.js";
 import "./chunk-JSBRDJBE.js";
 export {
   runEngineCliEntry

package/dist/{contract-types-DiWyGRXr.d.cts → contract-types-DqOD58r-.d.cts}

@@ -60,7 +60,7 @@ interface Turn {
  * 兼容」不变量 3 的类型面）。语义锚点 = pi（ACP 词汇对照见 core execution/assembly/types.ts 注释）。
  *
  * activity = 纯活性信号：双侧 reducer no-op、不开 turn、不写状态、不落 journal
- * （core journal-wiring 对其豁免 append），只承诺「引擎活跃时周期性出现」——供宿主
+ * （core event-journal-wiring 对其豁免 append），只承诺「引擎活跃时周期性出现」——供宿主
  * 无进展守护刷新判活（长工具执行期）。节流属生产者实现细节，不进协议承诺。
  *
  * armed = [D3 协议版 P6] schema 强制武装确认回执：引擎在启动期武装断言通过 +
@@ -153,7 +153,7 @@ interface EngineHandleData {
      * [池抽象降级 2026-09-13] 原 poolKey 字段已删除——两引擎 poolKey 恒 'shared'
      * （SDK SHARED_POOL_KEY），journal 固定落 engines/<engineId>/shared/，字段零信息量。
      */
-    journalPath?: string;
+    eventsPath?: string;
     /** probe 实测版本（漂移排查锚点）。 */
     engineVersion?: string;
     /** 适配器版本（golden 样本对齐排查）。 */
@@ -171,7 +171,7 @@ interface ResumeAnchor {
     /** 引擎定位键（pi = { recordId?, sessionFile? }；zcode = { sessionId, dbPath }）。 */
     sessionRef: Record<string, string>;
     /** journal 绝对路径（read 降级链第②级数据源；无 journal 缺省）。 */
-    journalPath?: string;
+    eventsPath?: string;
 }
 /** Turn → ReplayedTurn：剥离内部态（closed 恒 true——重放物无进行时语义）。 */
 interface ReplayedTurn {
@@ -296,7 +296,7 @@ interface WorktreeHandle {
 }
 /**
  * 一次引擎执行的终态（协议 run 终态应答的 outcome 载荷）。锚定 core
- * orchestration AgentResult 并追加引擎层字段（engineId / engineFallback / exitCode）。
+ * orchestration AgentResult 并追加引擎层字段（engineId / exitCode）。
  */
 interface AgentOutcome {
     content: string;
@@ -314,13 +314,8 @@ interface AgentOutcome {
     /** 仅诊断——目录可能已被 finalize 清理，不得作为 cwd 复用。 */
     worktreePath?: string;
     toolCalls?: ToolCallEntry[];
-    /** 实际执行引擎（fallback 后可能 ≠ 请求值）。 */
+    /** 实际执行引擎。 */
     engineId: string;
-    /** fallback 留痕（record 同步投影，GUI 警告条数据源）。 */
-    engineFallback?: {
-        from: string;
-        reason: string;
-    };
     /** null = 被信号杀死（杀链/abort 合成终态的判据）。 */
     exitCode?: number | null;
     /**
@@ -381,7 +376,7 @@ interface ModelCatalogEntry {
  *   - 判据② task（隔离与权限随任务声明）：worktree / fork / forkSource /
  *     denyTools / permissionMode；
  *   - 判据② task（诊断元数据）：description；
- *   - 判据③ ctx（环境值，引擎自推导与宿主不恒等）：model / cwd / engineFallback
+ *   - 判据③ ctx（环境值，引擎自推导与宿主不恒等）：model / cwd
  *     （对照 core orchestration/models/types.ts AgentCallOpts，协议层单列）；
  *   - 判据① 宿主自持不上协议：engine（路由决策已完成，收到的引擎即选中值）、
  *     timeoutMs（宿主超时链 mergeTimeoutSignal → cancel 帧，非引擎参数）、
@@ -434,4 +429,4 @@ interface AgentCallOpts {
     permissionMode?: string;
 }
 
-export { AGENT_EVENT_TYPE_NAMES as A, type EngineCapabilities as E, type InternalToolCall as I, type ModelCatalogEntry as M, type ProbeReport as P, type ReplayedTurn as R, type SessionView as S, type ToolCall as T, type WorktreeHandle as W, type AgentCallOpts as a, type AgentEvent as b, type AgentEventTypeName as c, type AgentFailureKind as d, type AgentOutcome as e, type AgentOutcomeUsage as f, type AgentUsage as g, type AgentUsageTotal as h, type AssertMutuallyAssignable as i, type EngineHandleData as j, type EngineProcessModel as k, type ResumeAnchor as l, type ToolCallEntry as m, type ToolCallResult as n, type Turn as o };
+export { type AgentEvent as A, type EngineHandleData as E, type InternalToolCall as I, type ModelCatalogEntry as M, type ProbeReport as P, type ReplayedTurn as R, type SessionView as S, type Turn as T, type WorktreeHandle as W, type AgentUsageTotal as a, type AgentCallOpts as b, type AgentOutcome as c, type EngineCapabilities as d, type ResumeAnchor as e, AGENT_EVENT_TYPE_NAMES as f, type AgentEventTypeName as g, type AgentFailureKind as h, type AgentOutcomeUsage as i, type AgentUsage as j, type AssertMutuallyAssignable as k, type EngineProcessModel as l, type ToolCall as m, type ToolCallEntry as n, type ToolCallResult as o };

package/dist/{contract-types-DiWyGRXr.d.ts → contract-types-DqOD58r-.d.ts}

@@ -60,7 +60,7 @@ interface Turn {
  * 兼容」不变量 3 的类型面）。语义锚点 = pi（ACP 词汇对照见 core execution/assembly/types.ts 注释）。
  *
  * activity = 纯活性信号：双侧 reducer no-op、不开 turn、不写状态、不落 journal
- * （core journal-wiring 对其豁免 append），只承诺「引擎活跃时周期性出现」——供宿主
+ * （core event-journal-wiring 对其豁免 append），只承诺「引擎活跃时周期性出现」——供宿主
  * 无进展守护刷新判活（长工具执行期）。节流属生产者实现细节，不进协议承诺。
  *
  * armed = [D3 协议版 P6] schema 强制武装确认回执：引擎在启动期武装断言通过 +
@@ -153,7 +153,7 @@ interface EngineHandleData {
      * [池抽象降级 2026-09-13] 原 poolKey 字段已删除——两引擎 poolKey 恒 'shared'
      * （SDK SHARED_POOL_KEY），journal 固定落 engines/<engineId>/shared/，字段零信息量。
      */
-    journalPath?: string;
+    eventsPath?: string;
     /** probe 实测版本（漂移排查锚点）。 */
     engineVersion?: string;
     /** 适配器版本（golden 样本对齐排查）。 */
@@ -171,7 +171,7 @@ interface ResumeAnchor {
     /** 引擎定位键（pi = { recordId?, sessionFile? }；zcode = { sessionId, dbPath }）。 */
     sessionRef: Record<string, string>;
     /** journal 绝对路径（read 降级链第②级数据源；无 journal 缺省）。 */
-    journalPath?: string;
+    eventsPath?: string;
 }
 /** Turn → ReplayedTurn：剥离内部态（closed 恒 true——重放物无进行时语义）。 */
 interface ReplayedTurn {
@@ -296,7 +296,7 @@ interface WorktreeHandle {
 }
 /**
  * 一次引擎执行的终态（协议 run 终态应答的 outcome 载荷）。锚定 core
- * orchestration AgentResult 并追加引擎层字段（engineId / engineFallback / exitCode）。
+ * orchestration AgentResult 并追加引擎层字段（engineId / exitCode）。
  */
 interface AgentOutcome {
     content: string;
@@ -314,13 +314,8 @@ interface AgentOutcome {
     /** 仅诊断——目录可能已被 finalize 清理，不得作为 cwd 复用。 */
     worktreePath?: string;
     toolCalls?: ToolCallEntry[];
-    /** 实际执行引擎（fallback 后可能 ≠ 请求值）。 */
+    /** 实际执行引擎。 */
     engineId: string;
-    /** fallback 留痕（record 同步投影，GUI 警告条数据源）。 */
-    engineFallback?: {
-        from: string;
-        reason: string;
-    };
     /** null = 被信号杀死（杀链/abort 合成终态的判据）。 */
     exitCode?: number | null;
     /**
@@ -381,7 +376,7 @@ interface ModelCatalogEntry {
  *   - 判据② task（隔离与权限随任务声明）：worktree / fork / forkSource /
  *     denyTools / permissionMode；
  *   - 判据② task（诊断元数据）：description；
- *   - 判据③ ctx（环境值，引擎自推导与宿主不恒等）：model / cwd / engineFallback
+ *   - 判据③ ctx（环境值，引擎自推导与宿主不恒等）：model / cwd
  *     （对照 core orchestration/models/types.ts AgentCallOpts，协议层单列）；
  *   - 判据① 宿主自持不上协议：engine（路由决策已完成，收到的引擎即选中值）、
  *     timeoutMs（宿主超时链 mergeTimeoutSignal → cancel 帧，非引擎参数）、
@@ -434,4 +429,4 @@ interface AgentCallOpts {
     permissionMode?: string;
 }
 
-export { AGENT_EVENT_TYPE_NAMES as A, type EngineCapabilities as E, type InternalToolCall as I, type ModelCatalogEntry as M, type ProbeReport as P, type ReplayedTurn as R, type SessionView as S, type ToolCall as T, type WorktreeHandle as W, type AgentCallOpts as a, type AgentEvent as b, type AgentEventTypeName as c, type AgentFailureKind as d, type AgentOutcome as e, type AgentOutcomeUsage as f, type AgentUsage as g, type AgentUsageTotal as h, type AssertMutuallyAssignable as i, type EngineHandleData as j, type EngineProcessModel as k, type ResumeAnchor as l, type ToolCallEntry as m, type ToolCallResult as n, type Turn as o };
+export { type AgentEvent as A, type EngineHandleData as E, type InternalToolCall as I, type ModelCatalogEntry as M, type ProbeReport as P, type ReplayedTurn as R, type SessionView as S, type Turn as T, type WorktreeHandle as W, type AgentUsageTotal as a, type AgentCallOpts as b, type AgentOutcome as c, type EngineCapabilities as d, type ResumeAnchor as e, AGENT_EVENT_TYPE_NAMES as f, type AgentEventTypeName as g, type AgentFailureKind as h, type AgentOutcomeUsage as i, type AgentUsage as j, type AssertMutuallyAssignable as k, type EngineProcessModel as l, type ToolCall as m, type ToolCallEntry as n, type ToolCallResult as o };

package/dist/data-dir.cjs

@@ -26,8 +26,16 @@ __export(data_dir_exports, {
 });
 module.exports = __toCommonJS(data_dir_exports);
 
+// src/global-slots.ts
+var ENGINE_SDK_SLOT_KEYS = {
+  /** dataDir 缺省告警一次性标记（data-dir.ts）。 */
+  dataDirWarned: "@zhushanwen/subagent-engine-sdk.data-dir-warned",
+  /** logger sink 进程级单例（logger.ts）。 */
+  loggerSink: "@zhushanwen/subagent-engine-sdk.logger-sink"
+};
+
 // src/logger.ts
-var SINK_SLOT_KEY = /* @__PURE__ */ Symbol.for("@zhushanwen/subagent-engine-sdk.logger-sink");
+var SINK_SLOT_KEY = Symbol.for(ENGINE_SDK_SLOT_KEYS.loggerSink);
 function getSinkSlot() {
   let slot = Reflect.get(globalThis, SINK_SLOT_KEY);
   if (!slot) {
@@ -76,7 +84,7 @@ function getLogger(component) {
 // src/data-dir.ts
 var logger = getLogger("subagents");
 var TAIJI_DATA_DIR_ENV = "TAIJI_AGENT_DATA_DIR";
-var WARNED_SLOT_KEY = /* @__PURE__ */ Symbol.for("@zhushanwen/subagent-engine-sdk.data-dir-warned");
+var WARNED_SLOT_KEY = Symbol.for(ENGINE_SDK_SLOT_KEYS.dataDirWarned);
 function getWarnedSlot() {
   let slot = Reflect.get(globalThis, WARNED_SLOT_KEY);
   if (!slot) {

package/dist/data-dir.js

@@ -2,8 +2,8 @@ import {
   TAIJI_DATA_DIR_ENV,
   resetDataDirWarnForTests,
   resolveEngineDataDir
-} from "./chunk-X24IVQKJ.js";
-import "./chunk-75QEMUGV.js";
+} from "./chunk-3FVBDH3X.js";
+import "./chunk-NXNNXGTY.js";
 import "./chunk-JSBRDJBE.js";
 export {
   TAIJI_DATA_DIR_ENV,

package/dist/env.cjs

@@ -28,8 +28,16 @@ __export(env_exports, {
 });
 module.exports = __toCommonJS(env_exports);
 
+// src/global-slots.ts
+var ENGINE_SDK_SLOT_KEYS = {
+  /** dataDir 缺省告警一次性标记（data-dir.ts）。 */
+  dataDirWarned: "@zhushanwen/subagent-engine-sdk.data-dir-warned",
+  /** logger sink 进程级单例（logger.ts）。 */
+  loggerSink: "@zhushanwen/subagent-engine-sdk.logger-sink"
+};
+
 // src/logger.ts
-var SINK_SLOT_KEY = /* @__PURE__ */ Symbol.for("@zhushanwen/subagent-engine-sdk.logger-sink");
+var SINK_SLOT_KEY = Symbol.for(ENGINE_SDK_SLOT_KEYS.loggerSink);
 function getSinkSlot() {
   let slot = Reflect.get(globalThis, SINK_SLOT_KEY);
   if (!slot) {

package/dist/env.d.cts

@@ -24,12 +24,12 @@ interface EngineChildEnvOptions {
     /** L0：relay 三键（宿主 relay 激活时传；三键必经 L0——L1 拒绝 TAIJI_SUBAGENT_ 前缀、L2 是 manifest 面，两层都到不了） */
     relay?: EngineRelayEnv;
     /**
-     * L0：引擎侧身份 env 透传通道（identityEnv）。现行事实（ext-simplify-17 D4，
-     * 20260914 真机探针证实）：PI_SUBAGENT_ROOT_SESSION_ID / PI_SUBAGENT_SELF_RECORD_ID
-     * 两键已无写入方（本通道现无人传值），引擎链统一 subagent 标记 = TAIJI_AGENT_SUBAGENT=1
-     * （见 injectL0InfraKeys 恒注入），base-tool-enhance 判据已重锚新标记。通道保留待
-     * 另行裁决，读者见 docs/architecture/ext-simplify-17-shared-extraction.md §3.1 D4
-     * 与探针报告 .tmp/dev-flow/ext-simplify-17-d4-probe.md。
+     * L0：引擎宿主（engine-host）进程的 env 透传通道。**注意它不是子代理身份通道**：
+     * 引擎宿主是长驻进程（每窗口一个），而子代理身份（recordId / depth 等）是 per-run 的
+     * ——宿主级钉值只能得到进程级粗粒度值。2026-09-30 §2.7 裁决（路 A）后，身份改由引擎在
+     * spawn 子 pi 时按 run 写回子进程 env，键表单源 = `src/identity-env.ts`，写入方 =
+     * pi 引擎 `spawn-runner.ts` 的 `applyIdentityEnvToChildEnv`；本通道保留给宿主级
+     * 基础设施键（历史用途见 docs/architecture/ext-simplify-17-shared-extraction.md §3.1 D4）。
      */
     identityEnv?: Record<string, string | undefined>;
     /** L2：manifest 声明的 envPrefixes 放行清单（保留前缀拒绝 + 形态校验） */

package/dist/env.d.ts

@@ -24,12 +24,12 @@ interface EngineChildEnvOptions {
     /** L0：relay 三键（宿主 relay 激活时传；三键必经 L0——L1 拒绝 TAIJI_SUBAGENT_ 前缀、L2 是 manifest 面，两层都到不了） */
     relay?: EngineRelayEnv;
     /**
-     * L0：引擎侧身份 env 透传通道（identityEnv）。现行事实（ext-simplify-17 D4，
-     * 20260914 真机探针证实）：PI_SUBAGENT_ROOT_SESSION_ID / PI_SUBAGENT_SELF_RECORD_ID
-     * 两键已无写入方（本通道现无人传值），引擎链统一 subagent 标记 = TAIJI_AGENT_SUBAGENT=1
-     * （见 injectL0InfraKeys 恒注入），base-tool-enhance 判据已重锚新标记。通道保留待
-     * 另行裁决，读者见 docs/architecture/ext-simplify-17-shared-extraction.md §3.1 D4
-     * 与探针报告 .tmp/dev-flow/ext-simplify-17-d4-probe.md。
+     * L0：引擎宿主（engine-host）进程的 env 透传通道。**注意它不是子代理身份通道**：
+     * 引擎宿主是长驻进程（每窗口一个），而子代理身份（recordId / depth 等）是 per-run 的
+     * ——宿主级钉值只能得到进程级粗粒度值。2026-09-30 §2.7 裁决（路 A）后，身份改由引擎在
+     * spawn 子 pi 时按 run 写回子进程 env，键表单源 = `src/identity-env.ts`，写入方 =
+     * pi 引擎 `spawn-runner.ts` 的 `applyIdentityEnvToChildEnv`；本通道保留给宿主级
+     * 基础设施键（历史用途见 docs/architecture/ext-simplify-17-shared-extraction.md §3.1 D4）。
      */
     identityEnv?: Record<string, string | undefined>;
     /** L2：manifest 声明的 envPrefixes 放行清单（保留前缀拒绝 + 形态校验） */

package/dist/env.js

@@ -4,8 +4,8 @@ import {
   ENGINE_ENV_PREFIXES,
   buildEngineChildEnv,
   buildOutboundChildEnv
-} from "./chunk-YL5W5EMV.js";
-import "./chunk-75QEMUGV.js";
+} from "./chunk-AF2ETADP.js";
+import "./chunk-NXNNXGTY.js";
 import "./chunk-JSBRDJBE.js";
 export {
   ENGINE_ENV_DENY_LIST,