@zhushanwen/subagent-engine-sdk 0.4.0 → 0.5.1

package/dist/node-executor.d.ts

@@ -1,5 +1,5 @@
-/** L0 注入的引擎执行器路径 env（与 relay 的 XYZ_SUBAGENT_RELAY_NODE 不复用）。 */
-declare const ENGINE_NODE_ENV = "XYZ_AGENT_ENGINE_NODE";
+/** L0 注入的引擎执行器路径 env（与 relay 的 TAIJI_SUBAGENT_RELAY_NODE 不复用）。 */
+declare const ENGINE_NODE_ENV = "TAIJI_AGENT_ENGINE_NODE";
 /**
  * 探针：验证执行器能以纯 node 语义执行 JS（先例 = runtime relay-env.ts:47-90）。
  *
@@ -20,7 +20,7 @@ interface EngineNodeLaunchOptions {
     args?: readonly string[];
     /** 宿主形态。 */
     hostKind: EngineNodeHostKind;
-    /** 读取 XYZ_AGENT_ENGINE_NODE 的 env 快照（矩阵① 的注入通道）。 */
+    /** 读取 TAIJI_AGENT_ENGINE_NODE 的 env 快照（矩阵① 的注入通道）。 */
     env?: Record<string, string | undefined>;
     /** 宿主 process.execPath（缺省 process.execPath）。 */
     execPath?: string;
@@ -42,7 +42,7 @@ interface EngineNodeLaunch {
  *
  * 判定序（与规格逐行对应）：
  *   Windows + entry .cmd → cmd.exe /c 显式形态（禁 shell:true 的注入面）；
- *   pi-extension → 注入执行器（env XYZ_AGENT_ENGINE_NODE），缺失/探针失败 =
+ *   pi-extension → 注入执行器（env TAIJI_AGENT_ENGINE_NODE），缺失/探针失败 =
  *     engine_not_found + 指引；
  *   runtime-sidecar → process.execPath（Electron 时 electronRunAsNode，探针先行）；
  *   standalone → PATH node（探针失败 = engine_not_found + 安装指引）；
@@ -54,7 +54,7 @@ declare function resolveEngineNodeLaunch(opts: EngineNodeLaunchOptions): Promise
 /**
  * EngineClient 的自由字符串 hostKind（'pi' / 'runtime' / …）→ 矩阵行归一：
  *   'runtime*' → runtime-sidecar（②：sidecar execPath 权威）；
- *   env 已注入 XYZ_AGENT_ENGINE_NODE（打包态 runtime 注入主 pi 进程的通道）→
+ *   env 已注入 TAIJI_AGENT_ENGINE_NODE（打包态 runtime 注入主 pi 进程的通道）→
  *     pi-extension（①：必须用注入执行器——pi 宿主自身 execPath 是 pi binary）；
  *   其余 → standalone（③：PATH node）。
  */

package/dist/node-executor.js

@@ -4,8 +4,8 @@ import {
   probeNodeExecutor,
   resetEngineNodeProbeCache,
   resolveEngineNodeLaunch
-} from "./chunk-LKPVN3N6.js";
-import "./chunk-WS4WAZVR.js";
+} from "./chunk-W3BKI2BP.js";
+import "./chunk-WMDMXP2F.js";
 import "./chunk-JSBRDJBE.js";
 export {
   ENGINE_NODE_ENV,

package/dist/port-contract.d.cts

@@ -1,4 +1,4 @@
-import { A as AgentCallOpts, h as EngineHandleData, E as EngineCapabilities, P as ProbeReport, a as AgentEvent, i as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-C71Sqq8d.cjs';
+import { A as AgentCallOpts, h as EngineHandleData, E as EngineCapabilities, P as ProbeReport, a as AgentEvent, i as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-Dsvy79r3.cjs';
 
 /**
  * 引擎进程内全量任务声明 = SDK AgentCallOpts 引擎面子集 + 协议 ctx 还原字段（model/

package/dist/port-contract.d.ts

@@ -1,4 +1,4 @@
-import { A as AgentCallOpts, h as EngineHandleData, E as EngineCapabilities, P as ProbeReport, a as AgentEvent, i as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-C71Sqq8d.js';
+import { A as AgentCallOpts, h as EngineHandleData, E as EngineCapabilities, P as ProbeReport, a as AgentEvent, i as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-Dsvy79r3.js';
 
 /**
  * 引擎进程内全量任务声明 = SDK AgentCallOpts 引擎面子集 + 协议 ctx 还原字段（model/

package/dist/protocol/index.cjs

@@ -81,7 +81,7 @@ var CRASH_REBUILD_BACKOFF_MS = [
   CRASH_REBUILD_BACKOFF_STEP_3_MS
 ];
 var STDERR_TAIL_CHARS = 400;
-var ENGINE_EVENT_COALESCE_ENV = "XYZ_ENGINE_EVENT_COALESCE";
+var ENGINE_EVENT_COALESCE_ENV = "TAIJI_ENGINE_EVENT_COALESCE";
 var ENGINE_EVENT_COALESCE_DEFAULT = "0";
 
 // src/protocol/frames.ts
@@ -188,7 +188,7 @@ function engineConversationUnsupportedError(engineId) {
   return new EngineSdkError(
     "engine_capability_unsupported",
     `engine '${engineId}' \u4E0D\u652F\u6301 resume \u7EED\u804A\uFF08capabilities.conversation = 'unsupported'\uFF0Cmanifest \u65E0 conversation gate \u4F4D\uFF09`,
-    `\u53BB\u6389 conversation \u53C2\u6570\uFF08\u4E00\u6B21\u6027\u4EFB\u52A1\u9ED8\u8BA4\u5F62\u6001\uFF09\uFF0C\u6216\u4FEE manifest capabilities / \u5347\u7EA7\u5F15\u64CE\u5305\uFF08\u82E5\u5F15\u64CE\u5B9E\u9645\u652F\u6301\u8BE5\u80FD\u529B\uFF09`,
+    `\u6539\u7528\u58F0\u660E conversation \u80FD\u529B\u7684\u5F15\u64CE\u7EED\u804A\uFF08\u6216\u4EE5\u65B0\u4EFB\u52A1\u91CD\u6D3E\uFF09\uFF0C\u6216\u4FEE manifest capabilities / \u5347\u7EA7\u5F15\u64CE\u5305\uFF08\u82E5\u5F15\u64CE\u5B9E\u9645\u652F\u6301\u8BE5\u80FD\u529B\uFF09`,
     { engineId, capability: "conversation", declared: "unsupported" }
   );
 }

package/dist/protocol/index.d.cts

@@ -1,9 +1,9 @@
-export { E as ENGINE_ERROR_CODE_PREFIX, a as ENGINE_PROTOCOL_ERROR_CODES, b as ENGINE_TIMEOUT_RECOVERY, c as EngineProtocolErrorCode, d as EngineSdkError, e as ErrorResponseFrame, f as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, g as ResponseFrame, h as ReverseRequestFrame, i as ReverseResponseResult, S as STDOUT_TAIL_ECHO_CHARS, j as SuccessResponseFrame, k as assertChatConversationSupported, l as engineConversationUnsupportedError, m as engineProtocolMismatchError, n as engineTimeoutDetail, o as isEngineErrorPassthroughCode, p as isEngineProtocolErrorCode, q as isNotificationFrame, r as isRequestFrame, s as isResponseFrame, t as isReverseRequestFrame, u as schemaEmulationFailedDetail } from '../error-codes-CiOO3PMg.cjs';
-import { E as EngineCapabilities, M as ModelCatalogEntry, A as AgentCallOpts, i as ResumeAnchor, h as EngineHandleData, P as ProbeReport, c as AgentOutcome, S as SessionView } from '../contract-types-C71Sqq8d.cjs';
-export { a as AgentEvent, b as AgentFailureKind, d as AgentOutcomeUsage, e as AgentUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, I as InternalToolCall, R as ReplayedTurn, T as ToolCall, j as ToolCallEntry, k as ToolCallResult, l as Turn, W as WorktreeHandle } from '../contract-types-C71Sqq8d.cjs';
+export { E as ENGINE_ERROR_CODE_PREFIX, a as ENGINE_PROTOCOL_ERROR_CODES, b as ENGINE_TIMEOUT_RECOVERY, c as EngineProtocolErrorCode, d as EngineSdkError, e as ErrorResponseFrame, f as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, g as ResponseFrame, h as ReverseRequestFrame, i as ReverseResponseResult, S as STDOUT_TAIL_ECHO_CHARS, j as SuccessResponseFrame, k as assertChatConversationSupported, l as engineConversationUnsupportedError, m as engineProtocolMismatchError, n as engineTimeoutDetail, o as isEngineErrorPassthroughCode, p as isEngineProtocolErrorCode, q as isNotificationFrame, r as isRequestFrame, s as isResponseFrame, t as isReverseRequestFrame, u as schemaEmulationFailedDetail } from '../error-codes-pT7RYTqQ.cjs';
+import { E as EngineCapabilities, M as ModelCatalogEntry, A as AgentCallOpts, i as ResumeAnchor, h as EngineHandleData, P as ProbeReport, c as AgentOutcome, S as SessionView } from '../contract-types-Dsvy79r3.cjs';
+export { a as AgentEvent, b as AgentFailureKind, d as AgentOutcomeUsage, e as AgentUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, I as InternalToolCall, R as ReplayedTurn, T as ToolCall, j as ToolCallEntry, k as ToolCallResult, l as Turn, W as WorktreeHandle } from '../contract-types-Dsvy79r3.cjs';
 import { UiRequest, UiResponse } from '../ui-types.cjs';
 
-/** 协议版本（引擎包 manifest `xyz-agent.subagentEngine.protocol` 与 initialize 应答同值）。 */
+/** 协议版本（引擎包 manifest `taiji.subagentEngine.protocol` 与 initialize 应答同值）。 */
 declare const ENGINE_PROTOCOL_VERSION = 1;
 /**
  * core 侧支持的协议版本区间（半开区间 [min, max)）：当前 = [1, 2)。
@@ -27,7 +27,7 @@ declare const CRASH_REBUILD_BACKOFF_MS: readonly [1000, 2000, 4000];
 /** stderr 内存环形缓冲保留的尾部字符数（engine_crashed 帧携带崩溃现场）。 */
 declare const STDERR_TAIL_CHARS = 400;
 /** 事件合并开关 env 名（设计级默认关闭 = 值 "0"；A1 要求事件逐字段等价，合并不可开）。 */
-declare const ENGINE_EVENT_COALESCE_ENV = "XYZ_ENGINE_EVENT_COALESCE";
+declare const ENGINE_EVENT_COALESCE_ENV = "TAIJI_ENGINE_EVENT_COALESCE";
 declare const ENGINE_EVENT_COALESCE_DEFAULT = "0";
 /**
  * 反向请求超时二分（帧④注释，R9-2）：

package/dist/protocol/index.d.ts

@@ -1,9 +1,9 @@
-export { E as ENGINE_ERROR_CODE_PREFIX, a as ENGINE_PROTOCOL_ERROR_CODES, b as ENGINE_TIMEOUT_RECOVERY, c as EngineProtocolErrorCode, d as EngineSdkError, e as ErrorResponseFrame, f as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, g as ResponseFrame, h as ReverseRequestFrame, i as ReverseResponseResult, S as STDOUT_TAIL_ECHO_CHARS, j as SuccessResponseFrame, k as assertChatConversationSupported, l as engineConversationUnsupportedError, m as engineProtocolMismatchError, n as engineTimeoutDetail, o as isEngineErrorPassthroughCode, p as isEngineProtocolErrorCode, q as isNotificationFrame, r as isRequestFrame, s as isResponseFrame, t as isReverseRequestFrame, u as schemaEmulationFailedDetail } from '../error-codes-D5YlWaBx.js';
-import { E as EngineCapabilities, M as ModelCatalogEntry, A as AgentCallOpts, i as ResumeAnchor, h as EngineHandleData, P as ProbeReport, c as AgentOutcome, S as SessionView } from '../contract-types-C71Sqq8d.js';
-export { a as AgentEvent, b as AgentFailureKind, d as AgentOutcomeUsage, e as AgentUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, I as InternalToolCall, R as ReplayedTurn, T as ToolCall, j as ToolCallEntry, k as ToolCallResult, l as Turn, W as WorktreeHandle } from '../contract-types-C71Sqq8d.js';
+export { E as ENGINE_ERROR_CODE_PREFIX, a as ENGINE_PROTOCOL_ERROR_CODES, b as ENGINE_TIMEOUT_RECOVERY, c as EngineProtocolErrorCode, d as EngineSdkError, e as ErrorResponseFrame, f as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, g as ResponseFrame, h as ReverseRequestFrame, i as ReverseResponseResult, S as STDOUT_TAIL_ECHO_CHARS, j as SuccessResponseFrame, k as assertChatConversationSupported, l as engineConversationUnsupportedError, m as engineProtocolMismatchError, n as engineTimeoutDetail, o as isEngineErrorPassthroughCode, p as isEngineProtocolErrorCode, q as isNotificationFrame, r as isRequestFrame, s as isResponseFrame, t as isReverseRequestFrame, u as schemaEmulationFailedDetail } from '../error-codes-DMGeUUUm.js';
+import { E as EngineCapabilities, M as ModelCatalogEntry, A as AgentCallOpts, i as ResumeAnchor, h as EngineHandleData, P as ProbeReport, c as AgentOutcome, S as SessionView } from '../contract-types-Dsvy79r3.js';
+export { a as AgentEvent, b as AgentFailureKind, d as AgentOutcomeUsage, e as AgentUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, I as InternalToolCall, R as ReplayedTurn, T as ToolCall, j as ToolCallEntry, k as ToolCallResult, l as Turn, W as WorktreeHandle } from '../contract-types-Dsvy79r3.js';
 import { UiRequest, UiResponse } from '../ui-types.js';
 
-/** 协议版本（引擎包 manifest `xyz-agent.subagentEngine.protocol` 与 initialize 应答同值）。 */
+/** 协议版本（引擎包 manifest `taiji.subagentEngine.protocol` 与 initialize 应答同值）。 */
 declare const ENGINE_PROTOCOL_VERSION = 1;
 /**
  * core 侧支持的协议版本区间（半开区间 [min, max)）：当前 = [1, 2)。
@@ -27,7 +27,7 @@ declare const CRASH_REBUILD_BACKOFF_MS: readonly [1000, 2000, 4000];
 /** stderr 内存环形缓冲保留的尾部字符数（engine_crashed 帧携带崩溃现场）。 */
 declare const STDERR_TAIL_CHARS = 400;
 /** 事件合并开关 env 名（设计级默认关闭 = 值 "0"；A1 要求事件逐字段等价，合并不可开）。 */
-declare const ENGINE_EVENT_COALESCE_ENV = "XYZ_ENGINE_EVENT_COALESCE";
+declare const ENGINE_EVENT_COALESCE_ENV = "TAIJI_ENGINE_EVENT_COALESCE";
 declare const ENGINE_EVENT_COALESCE_DEFAULT = "0";
 /**
  * 反向请求超时二分（帧④注释，R9-2）：

package/dist/protocol/index.js

@@ -40,7 +40,7 @@ import {
   isEngineProtocolErrorCode,
   isProtocolVersionCompatible,
   schemaEmulationFailedDetail
-} from "../chunk-WS4WAZVR.js";
+} from "../chunk-WMDMXP2F.js";
 import "../chunk-JSBRDJBE.js";
 export {
   CANCEL_SETTLE_GRACE_MS,

package/dist/relay-env.cjs

@@ -31,11 +31,11 @@ __export(relay_env_exports, {
   readRelayForwardEnv: () => readRelayForwardEnv
 });
 module.exports = __toCommonJS(relay_env_exports);
-var RELAY_ENV_SOCKET = "XYZ_SUBAGENT_RELAY_SOCKET";
-var RELAY_ENV_NODE = "XYZ_SUBAGENT_RELAY_NODE";
-var RELAY_ENV_SCRIPT = "XYZ_SUBAGENT_RELAY_SCRIPT";
-var RELAY_ENV_SESSION_ID = "XYZ_SUBAGENT_RELAY_SESSION_ID";
-var RELAY_ENV_RECORD_ID = "XYZ_SUBAGENT_RELAY_RECORD_ID";
+var RELAY_ENV_SOCKET = "TAIJI_SUBAGENT_RELAY_SOCKET";
+var RELAY_ENV_NODE = "TAIJI_SUBAGENT_RELAY_NODE";
+var RELAY_ENV_SCRIPT = "TAIJI_SUBAGENT_RELAY_SCRIPT";
+var RELAY_ENV_SESSION_ID = "TAIJI_SUBAGENT_RELAY_SESSION_ID";
+var RELAY_ENV_RECORD_ID = "TAIJI_SUBAGENT_RELAY_RECORD_ID";
 var RELAY_PROTOCOL_VERSION = 1;
 var RELAY_EXIT_CODES = {
   /** 握手被拒：协议版本不匹配（安装损坏，重装应用）。 */

package/dist/relay-env.d.cts

@@ -1,8 +1,8 @@
-declare const RELAY_ENV_SOCKET = "XYZ_SUBAGENT_RELAY_SOCKET";
-declare const RELAY_ENV_NODE = "XYZ_SUBAGENT_RELAY_NODE";
-declare const RELAY_ENV_SCRIPT = "XYZ_SUBAGENT_RELAY_SCRIPT";
-declare const RELAY_ENV_SESSION_ID = "XYZ_SUBAGENT_RELAY_SESSION_ID";
-declare const RELAY_ENV_RECORD_ID = "XYZ_SUBAGENT_RELAY_RECORD_ID";
+declare const RELAY_ENV_SOCKET = "TAIJI_SUBAGENT_RELAY_SOCKET";
+declare const RELAY_ENV_NODE = "TAIJI_SUBAGENT_RELAY_NODE";
+declare const RELAY_ENV_SCRIPT = "TAIJI_SUBAGENT_RELAY_SCRIPT";
+declare const RELAY_ENV_SESSION_ID = "TAIJI_SUBAGENT_RELAY_SESSION_ID";
+declare const RELAY_ENV_RECORD_ID = "TAIJI_SUBAGENT_RELAY_RECORD_ID";
 /** relay 协议版本（握手帧 v 字段；runtime 与代理同包分发，不匹配=安装损坏）。 */
 declare const RELAY_PROTOCOL_VERSION = 1;
 /** 代理专用退出码（extension/引擎侧表现为「子进程非零退出」→ engine_run_failed 语义）。 */

package/dist/relay-env.d.ts

@@ -1,8 +1,8 @@
-declare const RELAY_ENV_SOCKET = "XYZ_SUBAGENT_RELAY_SOCKET";
-declare const RELAY_ENV_NODE = "XYZ_SUBAGENT_RELAY_NODE";
-declare const RELAY_ENV_SCRIPT = "XYZ_SUBAGENT_RELAY_SCRIPT";
-declare const RELAY_ENV_SESSION_ID = "XYZ_SUBAGENT_RELAY_SESSION_ID";
-declare const RELAY_ENV_RECORD_ID = "XYZ_SUBAGENT_RELAY_RECORD_ID";
+declare const RELAY_ENV_SOCKET = "TAIJI_SUBAGENT_RELAY_SOCKET";
+declare const RELAY_ENV_NODE = "TAIJI_SUBAGENT_RELAY_NODE";
+declare const RELAY_ENV_SCRIPT = "TAIJI_SUBAGENT_RELAY_SCRIPT";
+declare const RELAY_ENV_SESSION_ID = "TAIJI_SUBAGENT_RELAY_SESSION_ID";
+declare const RELAY_ENV_RECORD_ID = "TAIJI_SUBAGENT_RELAY_RECORD_ID";
 /** relay 协议版本（握手帧 v 字段；runtime 与代理同包分发，不匹配=安装损坏）。 */
 declare const RELAY_PROTOCOL_VERSION = 1;
 /** 代理专用退出码（extension/引擎侧表现为「子进程非零退出」→ engine_run_failed 语义）。 */

package/dist/relay-env.js

@@ -8,7 +8,7 @@ import {
   RELAY_PROTOCOL_VERSION,
   isRelayActive,
   readRelayForwardEnv
-} from "./chunk-DSQ7JQKM.js";
+} from "./chunk-GSW3DMN6.js";
 import "./chunk-JSBRDJBE.js";
 export {
   RELAY_ENV_NODE,

package/dist/spawn.cjs

@@ -106,7 +106,7 @@ function spawnEngineChild(opts) {
   return child;
 }
 var DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS = 3e4;
-var ENGINE_HOST_REQUEST_TIMEOUT_ENV = "XYZ_ENGINE_HOST_REQUEST_TIMEOUT_MS";
+var ENGINE_HOST_REQUEST_TIMEOUT_ENV = "TAIJI_ENGINE_HOST_REQUEST_TIMEOUT_MS";
 var SWEEP_INTERVAL_MS = 1e3;
 function resolveHostRequestTimeoutMs(opts) {
   if (opts.hostRequestTimeoutMs !== void 0) return opts.hostRequestTimeoutMs;

package/dist/spawn.d.cts

@@ -27,7 +27,7 @@ declare function spawnEngineChild(opts: SpawnEngineChildOptions): ChildProcess;
 /** in-flight 未 ack 反向请求的计时超时缺省值（辅助判据，30s）。 */
 declare const DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS = 30000;
 /** 计时超时覆盖 env 名（引擎 CLI 启动时读；非法值 warn + 回落缺省）。 */
-declare const ENGINE_HOST_REQUEST_TIMEOUT_ENV = "XYZ_ENGINE_HOST_REQUEST_TIMEOUT_MS";
+declare const ENGINE_HOST_REQUEST_TIMEOUT_ENV = "TAIJI_ENGINE_HOST_REQUEST_TIMEOUT_MS";
 /** 反向请求计时面操作接口（消费方 = 引擎 CLI 的反向通道分发层）。 */
 interface ReverseRequestClock {
     /** 反向请求已发出（未 ack）——进入计时面。 */
@@ -46,7 +46,7 @@ interface ReverseRequestClock {
 interface EngineSelfDestructOptions {
     /** 主判据数据源：宿主→引擎的协议 stdin（EOF = 宿主死亡 → 立即自灭）。 */
     stdin: NodeJS.ReadableStream;
-    /** 辅助判据超时（缺省 30s；显式传值优先于 env XYZ_ENGINE_HOST_REQUEST_TIMEOUT_MS）。 */
+    /** 辅助判据超时（缺省 30s；显式传值优先于 env TAIJI_ENGINE_HOST_REQUEST_TIMEOUT_MS）。 */
     hostRequestTimeoutMs?: number;
     /** 计时超时的 env 覆盖源（缺省读 process.env；测试注入用）。 */
     timeoutEnv?: Record<string, string | undefined>;

package/dist/spawn.d.ts

@@ -27,7 +27,7 @@ declare function spawnEngineChild(opts: SpawnEngineChildOptions): ChildProcess;
 /** in-flight 未 ack 反向请求的计时超时缺省值（辅助判据，30s）。 */
 declare const DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS = 30000;
 /** 计时超时覆盖 env 名（引擎 CLI 启动时读；非法值 warn + 回落缺省）。 */
-declare const ENGINE_HOST_REQUEST_TIMEOUT_ENV = "XYZ_ENGINE_HOST_REQUEST_TIMEOUT_MS";
+declare const ENGINE_HOST_REQUEST_TIMEOUT_ENV = "TAIJI_ENGINE_HOST_REQUEST_TIMEOUT_MS";
 /** 反向请求计时面操作接口（消费方 = 引擎 CLI 的反向通道分发层）。 */
 interface ReverseRequestClock {
     /** 反向请求已发出（未 ack）——进入计时面。 */
@@ -46,7 +46,7 @@ interface ReverseRequestClock {
 interface EngineSelfDestructOptions {
     /** 主判据数据源：宿主→引擎的协议 stdin（EOF = 宿主死亡 → 立即自灭）。 */
     stdin: NodeJS.ReadableStream;
-    /** 辅助判据超时（缺省 30s；显式传值优先于 env XYZ_ENGINE_HOST_REQUEST_TIMEOUT_MS）。 */
+    /** 辅助判据超时（缺省 30s；显式传值优先于 env TAIJI_ENGINE_HOST_REQUEST_TIMEOUT_MS）。 */
     hostRequestTimeoutMs?: number;
     /** 计时超时的 env 覆盖源（缺省读 process.env；测试注入用）。 */
     timeoutEnv?: Record<string, string | undefined>;

package/dist/spawn.js

@@ -4,7 +4,7 @@ import {
   armEngineSelfDestruct,
   pumpNdjsonLines,
   spawnEngineChild
-} from "./chunk-3K2P2CM2.js";
+} from "./chunk-CNQTJJF5.js";
 import "./chunk-75QEMUGV.js";
 import "./chunk-JSBRDJBE.js";
 export {

package/dist/ui-channels.cjs

@@ -27,8 +27,8 @@ module.exports = __toCommonJS(ui_channels_exports);
 var NUL = "\0";
 function normalizeChannelName(markerLiteral) {
   let name = markerLiteral;
-  if (name.startsWith("XYZ_")) {
-    name = name.slice("XYZ_".length);
+  if (name.startsWith("TAIJI_")) {
+    name = name.slice("TAIJI_".length);
   }
   if (name.endsWith(":")) {
     name = name.slice(0, -1);

package/dist/ui-channels.js

@@ -1,7 +1,7 @@
 import {
   createUiChannelRegistry,
   parseChannel
-} from "./chunk-7I4XGL5J.js";
+} from "./chunk-BBWUC2EE.js";
 import "./chunk-JSBRDJBE.js";
 export {
   createUiChannelRegistry,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/subagent-engine-sdk",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Engine-side SDK for the subagent engine protocol: NDJSON stdio contract types, engine primitives (schema emulation, nesting guard, kill chain, journal replay projection, data-dir/paths resolution) — the shared contract root between subagent-core and engine CLI packages (engines import SDK only, never core)",
   "type": "module",
   "license": "MIT",
@@ -34,10 +34,8 @@
       "default": "./dist/protocol/index.js"
     }
   },
-  "$comment": "W1 骨架（docs/design/subagent-engine-protocolization.impl-plan.md §2.1）。双形态同 subagent-core 先例（D4）：workspace 消费走 import 条件 -> src；npm 消费走 publishConfig -> dist。exports 面先收窄到 ./ 与 ./protocol（exports = semver 契约，收窄不放宽；引擎包 W5/W7 消费经主 barrel）。协议版本独立于包版本：ENGINE_PROTOCOL_VERSION = 1（src/protocol/engine-protocol.ts）。不变量：本包禁止 import @zhushanwen/subagent-core（守卫 .githooks/check-engine-sdk-boundary.mjs）。src/env.ts 与 src/spawn.ts 是 W12 领地（impl-plan §2.12），本单元仅空骨架占位。tsup entry 逐模块具名登记（§2.1 末行），新增模块必须同步登记。",
+  "$comment": "W1 骨架（docs/design/subagent-engine-protocolization.impl-plan.md §2.1）。双形态同 subagent-core 先例（D4）：workspace 消费走 import 条件 -> src；npm 消费走 publishConfig -> dist。exports 面先收窄到 ./ 与 ./protocol（exports = semver 契约，收窄不放宽；引擎包 W5/W7 消费经主 barrel）。协议版本独立于包版本：ENGINE_PROTOCOL_VERSION = 1（src/protocol/engine-protocol.ts）。不变量：本包禁止 import @zhushanwen/subagent-core（守卫 .githooks/check-engine-sdk-boundary.mjs）。src/env.ts 与 src/spawn.ts 是 W12 领地（impl-plan §2.12），本单元仅空骨架占位。tsup entry 逐模块具名登记（§2.1 末行），新增模块必须同步登记。files 不含 src/（对齐 subagent-core 2026-09-16 同型收敛）：npm 消费面经 publishConfig 整体替换后全指 dist，TS 源仅服务 workspace（node_modules symlink 直读磁盘源文件，不经 tarball）；dist 产物无 sourcemap/sourceMappingURL，移除 src 零断链。已知残留：顶层 main（src/index.ts，workspace 形态载体）被 npm files 规则强制隐含打进 tarball，对 npm 消费者不可达，纯体积噪声。",
   "files": [
-    "src/",
-    "!src/__tests__",
     "dist/"
   ],
   "dependencies": {

package/src/best-effort.ts

@@ -1,37 +0,0 @@
-// src/best-effort.ts
-//
-// best-effort IO 清理的错误吞咽 helper 单源（round1-reuse R11 微副本收编，实现体
-// 自 core src/execution/best-effort.ts 迁移；pi 引擎包 best-effort.ts 副本自本模块
-// re-export 收编。core 版保留自持：其 logger 经 configureCore HostServices 通道解析，
-// 与 SDK LoggerSink 通道是真差异，非可消副本）。
-//
-// 用途：sidecar 写入 / worktree remove / alive marker 删除等次要 IO，失败不影响
-// 主流程（session 已完成或正在收尾）。这类 catch 故意吞错——但 taste/no-silent-catch
-// 规则禁止空 catch 或仅 console 的 catch。本 helper 提供一条「实质调用语句」让
-// catch 合规，同时把错误记录到 debug/error 便于排查（经共享 logger 路由，不裸 console）。
-
-import { getLogger } from "./logger.ts";
-
-const logger = getLogger("subagents");
-
-/** 错误日志级别。debug = 次要清理（默认）；error = 关键步骤但需继续后续清理。 */
-export type BestEffortLevel = "debug" | "error";
-
-/**
- * 吞咽 best-effort IO 的错误，按 level 经共享 logger 记录。
- *
- *   - debug（默认）：次要清理（sidecar/worktree/alive marker），失败属预期路径
- *   - error：关键步骤抛错但需继续后续清理（如 finalizeRecord 的 B9 链：completeRecord
- *     抛错后仍要执行 finalized/cleanup，错误需可见但不阻断）
- *
- * 错误对象优先取 message（避免打印巨大堆栈/对象），其他类型原样传入。
- */
-export function bestEffort(err: unknown, context: string, level: BestEffortLevel = "debug"): void {
-  const detail = err instanceof Error ? err.message : err;
-  const msg = `[subagents] best-effort ${context} failed`;
-  if (level === "error") {
-    logger.error(msg, { detail });
-  } else {
-    logger.debug(msg, { detail });
-  }
-}

package/src/cli-entry.ts

@@ -1,82 +0,0 @@
-// src/cli-entry.ts
-//
-// 引擎 CLI 进程入口样板单源（S4 簇 2 收编：pi/zcode 两包 main.ts 的逐字同构段
-// 迁移——差异仅 component 字符串与各包自己的 EngineProtocolServer；实现以 pi
-// main.ts 为基线逐字迁移，坏行截断长度 200、日志格式、启动序逐字节保持）。
-//
-// 职界分割：armEngineSelfDestruct 与 EngineProtocolServer 构造留调用方薄层——
-// server 构造需要 arm 产出的 ReverseRequestClock，实例传入后无法回补。本入口承接
-// 其余启动序：configureLoggerSink（stderr 兜底 + host/log 反向请求）→ readline
-// NDJSON 行循环 → close 留痕。
-//
-// stdout/stdin 用 process 全局（与 spawn.ts 同款先例——入口函数只在进程入口调用）。
-// 进程退出面：宿主 stdin EOF → 自灭守卫（薄层 arm）杀进程组；正常 dispose 不退进程。
-
-import * as readline from "node:readline";
-
-import { configureLoggerSink, getLogger } from "./logger.ts";
-
-/**
- * 引擎协议服务器的结构化最小接口（调用方薄层注入本包 EngineProtocolServer 实例；
- * 结构子集避免 SDK 反向依赖各包 server 类型）。
- */
-export interface CliProtocolServerSink {
-  /** 入站协议帧处理（readline 已拆行 + JSON.parse 后的帧）。 */
-  handleFrame(frame: unknown): void;
-  /** 数据面反向请求（host/log 等；应答分类由各包 server 实现承载）。 */
-  reverseRequest(method: string, params: unknown): Promise<unknown>;
-}
-
-/** runEngineCliEntry 参数。 */
-export interface RunEngineCliEntryOptions {
-  /** logger component 标签（如 "pi-engine-cli" / "zcode-engine-cli"）。 */
-  component: string;
-  /** 调用方构造的协议服务器实例（构造参数含 armEngineSelfDestruct 产出的 reverseClock）。 */
-  server: CliProtocolServerSink;
-}
-
-/** 坏行进日志的截断长度（够诊断、不刷屏）。 */
-const INBOUND_LOG_CHARS = 200;
-
-/**
- * 引擎 CLI 进程入口样板（行为与收编前两包 main.ts 逐字节等价）：
- * configureLoggerSink → stdin 行解析（NDJSON）→ server.handleFrame → close 留痕。
- */
-export function runEngineCliEntry(opts: RunEngineCliEntryOptions): void {
-  const logger = getLogger(opts.component);
-  const server = opts.server;
-
-  // stdout 是协议独占通道：应用日志一律走 host/log 反向请求 + stderr 兜底，禁写 stdout。
-  configureLoggerSink({
-    log(level, component, message, data) {
-      // stderr 兜底先落（反向通道未就绪/失败时日志不丢）；host/log 为数据面反向请求
-      // （10s 应答分类），失败吞掉——日志面不能拖垮主链路。
-      // debug 不写 stderr：对齐 logger.ts CONSOLE_SINK 的「debug no-op」语义——
-      // 引擎 stderr 落宿主 [rpc:stderr] 全量 ERROR 级链路，debug 刷屏会淹没真异常
-      // （常态路径的分级降噪依赖此跳过）；host/log 反向请求仍全级别透传。
-      if (level !== "debug") {
-        process.stderr.write(`[${level}] [${component}] ${message}${data !== undefined ? ` ${JSON.stringify(data)}` : ""}\n`);
-      }
-      void server.reverseRequest("host/log", { level, component, message }).catch(() => undefined);
-    },
-  });
-
-  const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
-  rl.on("line", (line) => {
-    const text = line.trim();
-    if (text === "") return;
-    try {
-      server.handleFrame(JSON.parse(text));
-    } catch (err) {
-      // 坏行跳过不断流（对端 EngineClient 同款纪律）；stdout 协议通道不回显坏行。
-      logger.warn(`unparseable inbound protocol line (ignored): ${text.slice(0, INBOUND_LOG_CHARS)}`, {
-        reason: err instanceof Error ? err.message : String(err),
-      });
-    }
-  });
-  rl.on("close", () => {
-    // stdin EOF：自灭守卫已挂（armEngineSelfDestruct 的 once('close') 杀进程组）；
-    // 此处仅留痕（守卫先注册，杀链不依赖本 handler）。
-    logger.debug("stdin closed (host exit path)");
-  });
-}

package/src/data-dir.ts

@@ -1,89 +0,0 @@
-// src/data-dir.ts
-//
-// 引擎数据目录解析（引擎侧原语，自 core execution/engine/common/data-dir.ts 迁入
-// @zhushanwen/subagent-engine-sdk）。迁移处置（impl-plan §2.1 data-dir 行）：**拆
-// seam**——今天 core 版缺 env 时回退 getHostServices().dataRoot()（引擎进程无
-// configureCore 通道，不可复制）；SDK 版 = **参数化/env 优先**，core 侧保留
-// getHostServices() 绑定（core 文件不动，引用切换归 W2+）。
-//
-// SDK 版缺省语义（impl-plan §2.9 数据根注入矩阵，写死）：env 优先；缺 env 且调用方
-// 未显式注入 fallback → **显式报错**（错误信息可操作：env 名 + 期望注入动作），不留
-// 静默漂目录。带 fallback 注入（pi 扩展宿主 = core 侧解析后显式传入）时保留
-// warn-once 语义（回退非权威通道必须可观测），与 core 版行为逐字对齐。
-//
-// 通道调查结论（2026-08-25，P2 实测证据链，自 core 版头部保留）：
-//   - runtime spawn pi 主会话时 RpcClient 出站 env 从 runtime process.env 继承
-//     XYZ_ 前缀白名单变量（调查当时经私有 buildSafeEnv，现已被 buildPiOutboundEnv
-//     → buildOutboundChildEnv 共享构建器取代），且显式设置 PI_CODING_AGENT_DIR；
-//   - dev 模式 Electron main 设置 XYZ_AGENT_DATA_DIR（apps/electron/main/main.ts:122），
-//     经 process-control.ts:262 透传给 runtime → 透传链成立；
-//   - prod 默认路径（~/.xyz-agent 缺省）下 runtime 进程 env 中**没有**该变量
-//     → runtime 侧 process-manager.ts spawn env 补注入 XYZ_AGENT_DATA_DIR 修复。
-
-import { getLogger } from "./logger.ts";
-
-const logger = getLogger("subagents");
-
-/** xyz-agent 数据目录 env 名（与 packages/shared/src/paths.ts 的 SSOT 变量同名）。 */
-export const XYZ_DATA_DIR_ENV = "XYZ_AGENT_DATA_DIR";
-
-// warn-once 配置态：globalThis[Symbol.for] slot（core host-services 同款范式）——
-// CJS 多 entry 内联副本下模块级 `let` 会分裂成多份（每份各 warn 一次），slot 跨副本一致。
-const WARNED_SLOT_KEY = Symbol.for("@zhushanwen/subagent-engine-sdk.data-dir-warned");
-
-function getWarnedSlot(): { current: boolean } {
-  let slot = Reflect.get(globalThis, WARNED_SLOT_KEY) as { current: boolean } | undefined;
-  if (!slot) {
-    slot = { current: false };
-    Reflect.set(globalThis, WARNED_SLOT_KEY, slot);
-  }
-  return slot;
-}
-
-/** 测试隔离专用：重置 warn-once 标记（生产禁用）。 */
-export function resetDataDirWarnForTests(): void {
-  getWarnedSlot().current = false;
-}
-
-/**
- * 解析引擎数据目录（journal 落盘 / 隔离池的根）：
- *   1. env[XYZ_AGENT_DATA_DIR]（宿主注入，权威通道）；
- *   2. 缺失 + opts.fallbackDataRoot 显式传入（宿主解析过的数据根）→ 用之 + warn 一次
- *      （非权威通道回退必须可观测——journal 落点变化不留静默漂移）；
- *   3. 两者皆缺 → 抛错（engine_not_found 语义：错误含 env 名、期望值示例与恢复动作；
- *      impl-plan §2.9「缺 env 且无注入 → 显式报错（附期望路径）」）。
- *
- * 每次调用重新解析（env 读取是零成本操作，不缓存路径防测试/宿主切换时读到旧值）。
- */
-export function resolveEngineDataDir(
-  env: NodeJS.ProcessEnv,
-  opts: { fallbackDataRoot?: string; warn?: (msg: string) => void } = {},
-): string {
-  const fromEnv = env[XYZ_DATA_DIR_ENV]?.trim();
-  if (fromEnv !== undefined && fromEnv !== "") return fromEnv;
-
-  const fallback = opts.fallbackDataRoot?.trim();
-  if (fallback === undefined || fallback === "") {
-    throw new Error(
-      `[subagent-engine-sdk] engine_not_found: ${XYZ_DATA_DIR_ENV} is not set and no fallback data root was injected. ` +
-        `Recovery: the host must inject ${XYZ_DATA_DIR_ENV} into the engine process env ` +
-        `(xyz-agent runtime / pi extension host do this at spawn), or pass ` +
-        `{ fallbackDataRoot } when calling resolveEngineDataDir from a host that resolves the data root itself.`,
-    );
-  }
-
-  if (!getWarnedSlot().current) {
-    getWarnedSlot().current = true;
-    const warn = opts.warn ?? defaultWarn;
-    warn(
-      `[engine-data-dir] ${XYZ_DATA_DIR_ENV} is not set; engine journal/pool fall back to the injected data root ` +
-        `(${fallback}). The xyz-agent host normally injects this env — if you are running inside xyz-agent, ` +
-        `check the runtime spawn env; standalone installs intentionally use the injected root.`,
-    );
-  }
-  return fallback;
-}
-
-function defaultWarn(msg: string): void {
-  logger.warn(msg);
-}