@zhushanwen/subagent-engine-sdk 0.5.0 → 0.6.0

package/dist/index.js

@@ -11,6 +11,10 @@ import {
 import {
   runEngineCliEntry
 } from "./chunk-J4G2MXDS.js";
+import {
+  ZCODE_HOST_DB_SUFFIX,
+  ZCODE_ISOLATED_DB_SEGMENTS
+} from "./chunk-CT3FEBDO.js";
 import {
   resolveEngineDir,
   resolveEnginesRoot,
@@ -24,28 +28,28 @@ import {
 import {
   createUiChannelRegistry,
   parseChannel
-} from "./chunk-7I4XGL5J.js";
+} from "./chunk-BBWUC2EE.js";
 import {
   ENGINE_ENV_DENY_LIST,
   ENGINE_ENV_L0_INFRA_KEYS,
   ENGINE_ENV_PREFIXES,
   buildEngineChildEnv,
   buildOutboundChildEnv
-} from "./chunk-BBVZK5DL.js";
+} from "./chunk-YL5W5EMV.js";
 import {
   DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS,
   ENGINE_HOST_REQUEST_TIMEOUT_ENV,
   armEngineSelfDestruct,
   pumpNdjsonLines,
   spawnEngineChild
-} from "./chunk-3K2P2CM2.js";
+} from "./chunk-CNQTJJF5.js";
 import {
   ENGINE_NODE_ENV,
   hostKindOf,
   probeNodeExecutor,
   resetEngineNodeProbeCache,
   resolveEngineNodeLaunch
-} from "./chunk-3IBT7MTB.js";
+} from "./chunk-W3BKI2BP.js";
 import {
   DEFAULT_STDERR_KEEP_DAYS,
   DEFAULT_STDERR_MAX_BYTES,
@@ -56,7 +60,7 @@ import {
   stderrLogPathFor,
   stderrLogPidOf,
   stderrRotationParams
-} from "./chunk-HYES77BR.js";
+} from "./chunk-MSAJXIP4.js";
 import {
   RELAY_ENV_NODE,
   RELAY_ENV_RECORD_ID,
@@ -67,8 +71,9 @@ import {
   RELAY_PROTOCOL_VERSION,
   isRelayActive,
   readRelayForwardEnv
-} from "./chunk-DSQ7JQKM.js";
+} from "./chunk-GSW3DMN6.js";
 import {
+  AGENT_EVENT_TYPE_NAMES,
   ENGINE_PROTOCOL_SCHEMAS,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   PROTOCOL_METHODS,
@@ -85,7 +90,7 @@ import {
   reverseRequestFrameSchema,
   runSessionParamsSchema,
   successResponseFrameSchema
-} from "./chunk-TW2FAMAJ.js";
+} from "./chunk-63ZNJHM5.js";
 import {
   SCHEMA_EMULATION_TAIL_CHARS,
   buildSchemaEmulationSegment,
@@ -97,7 +102,7 @@ import {
   NestedSpawnRejectedError,
   assertNotNestedSpawn,
   buildNestedSpawnEnv
-} from "./chunk-365AUV6N.js";
+} from "./chunk-YE472JOO.js";
 import {
   DEFAULT_KILL_GRACE_MS,
   DEFAULT_NATIVE_INTERRUPT_GRACE_MS,
@@ -105,7 +110,7 @@ import {
   abortWithFallback,
   killChain,
   synthesizeTimeoutOutcome
-} from "./chunk-WORT4PG7.js";
+} from "./chunk-QOEXD2FT.js";
 import {
   toErrorMessage
 } from "./chunk-PYO3YR7W.js";
@@ -133,7 +138,7 @@ import {
   isEngineProtocolErrorCode,
   isProtocolVersionCompatible,
   schemaEmulationFailedDetail
-} from "./chunk-F5JZMK74.js";
+} from "./chunk-WMDMXP2F.js";
 import {
   aggregateUsage,
   createReplayRecord,
@@ -143,10 +148,10 @@ import {
   updateFromEvent
 } from "./chunk-AIG5LSGK.js";
 import {
-  XYZ_DATA_DIR_ENV,
+  TAIJI_DATA_DIR_ENV,
   resetDataDirWarnForTests,
   resolveEngineDataDir
-} from "./chunk-GT6YLLN4.js";
+} from "./chunk-X24IVQKJ.js";
 import {
   configureLoggerSink,
   getLogger,
@@ -154,6 +159,7 @@ import {
 } from "./chunk-75QEMUGV.js";
 import "./chunk-JSBRDJBE.js";
 export {
+  AGENT_EVENT_TYPE_NAMES,
   CANCEL_SETTLE_GRACE_MS,
   CRASH_REBUILD_BACKOFF_MS,
   CRASH_REBUILD_MAX_ATTEMPTS,
@@ -197,7 +203,9 @@ export {
   STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS,
   SUPPORTED_PROTOCOL_RANGE,
-  XYZ_DATA_DIR_ENV,
+  TAIJI_DATA_DIR_ENV,
+  ZCODE_HOST_DB_SUFFIX,
+  ZCODE_ISOLATED_DB_SEGMENTS,
   abortWithFallback,
   aggregateUsage,
   armEngineSelfDestruct,

package/dist/journal-io.d.cts

@@ -1,4 +1,4 @@
-import { a as AgentEvent } from './contract-types-Dsvy79r3.cjs';
+import { b as AgentEvent } from './contract-types-DaULkdpG.cjs';
 
 /**
  * 重放 journal：读取路径下全部事件，重放即得 AgentEvent 流（read 第②级）。

package/dist/journal-io.d.ts

@@ -1,4 +1,4 @@
-import { a as AgentEvent } from './contract-types-Dsvy79r3.js';
+import { b as AgentEvent } from './contract-types-DaULkdpG.js';
 
 /**
  * 重放 journal：读取路径下全部事件，重放即得 AgentEvent 流（read 第②级）。

package/dist/journal-replay.d.cts

@@ -1,4 +1,4 @@
-import { l as Turn, f as AgentUsageTotal, a as AgentEvent, S as SessionView, h as EngineHandleData, R as ReplayedTurn } from './contract-types-Dsvy79r3.cjs';
+import { n as Turn, h as AgentUsageTotal, b as AgentEvent, S as SessionView, j as EngineHandleData, R as ReplayedTurn } from './contract-types-DaULkdpG.cjs';
 
 /**
  * reducer 的 record 视图（core ExecutionRecord 的结构子集：reducer 只触碰这四个字段）。

package/dist/journal-replay.d.ts

@@ -1,4 +1,4 @@
-import { l as Turn, f as AgentUsageTotal, a as AgentEvent, S as SessionView, h as EngineHandleData, R as ReplayedTurn } from './contract-types-Dsvy79r3.js';
+import { n as Turn, h as AgentUsageTotal, b as AgentEvent, S as SessionView, j as EngineHandleData, R as ReplayedTurn } from './contract-types-DaULkdpG.js';
 
 /**
  * reducer 的 record 视图（core ExecutionRecord 的结构子集：reducer 只触碰这四个字段）。

package/dist/kill-chain.d.cts

@@ -1,5 +1,5 @@
-export { S as STDOUT_TAIL_ECHO_CHARS } from './error-codes-SA5fGtx_.cjs';
-import { A as AgentCallOpts, c as AgentOutcome } from './contract-types-Dsvy79r3.cjs';
+export { S as STDOUT_TAIL_ECHO_CHARS } from './error-codes-CFTOAxva.cjs';
+import { a as AgentCallOpts, e as AgentOutcome } from './contract-types-DaULkdpG.cjs';
 
 /**
  * 可杀子进程的结构形状（Node ChildProcess 的结构子集）。

package/dist/kill-chain.d.ts

@@ -1,5 +1,5 @@
-export { S as STDOUT_TAIL_ECHO_CHARS } from './error-codes-OvQlqiQw.js';
-import { A as AgentCallOpts, c as AgentOutcome } from './contract-types-Dsvy79r3.js';
+export { S as STDOUT_TAIL_ECHO_CHARS } from './error-codes-C9BOUI5H.js';
+import { a as AgentCallOpts, e as AgentOutcome } from './contract-types-DaULkdpG.js';
 
 /**
  * 可杀子进程的结构形状（Node ChildProcess 的结构子集）。

package/dist/kill-chain.js

@@ -5,11 +5,11 @@ import {
   abortWithFallback,
   killChain,
   synthesizeTimeoutOutcome
-} from "./chunk-WORT4PG7.js";
+} from "./chunk-QOEXD2FT.js";
 import "./chunk-PYO3YR7W.js";
 import {
   STDOUT_TAIL_ECHO_CHARS
-} from "./chunk-F5JZMK74.js";
+} from "./chunk-WMDMXP2F.js";
 import "./chunk-75QEMUGV.js";
 import "./chunk-JSBRDJBE.js";
 export {

package/dist/logs/stderr-rotation.cjs

@@ -60,8 +60,8 @@ function positiveIntEnv(env, key) {
 }
 function stderrRotationParams(env) {
   return {
-    maxBytes: positiveIntEnv(env, "XYZ_LOG_MAX_BYTES") ?? DEFAULT_STDERR_MAX_BYTES,
-    keepDays: positiveIntEnv(env, "XYZ_LOG_KEEP_DAYS") ?? DEFAULT_STDERR_KEEP_DAYS
+    maxBytes: positiveIntEnv(env, "TAIJI_LOG_MAX_BYTES") ?? DEFAULT_STDERR_MAX_BYTES,
+    keepDays: positiveIntEnv(env, "TAIJI_LOG_KEEP_DAYS") ?? DEFAULT_STDERR_KEEP_DAYS
   };
 }
 function stderrLogPathFor(engineDataDir, pid, prefix) {

package/dist/logs/stderr-rotation.d.cts

@@ -1,7 +1,7 @@
 declare const DEFAULT_STDERR_MAX_BYTES: number;
 /** 缺省保留天数（与宿主 logger 同源缺省：7 天）。 */
 declare const DEFAULT_STDERR_KEEP_DAYS = 7;
-/** 轮转参数（env 覆盖面 = 宿主 logger 同款 XYZ_LOG_* 两键）。 */
+/** 轮转参数（env 覆盖面 = 宿主 logger 同款 TAIJI_LOG_* 两键）。 */
 interface StderrRotationParams {
     maxBytes: number;
     keepDays: number;

package/dist/logs/stderr-rotation.d.ts

@@ -1,7 +1,7 @@
 declare const DEFAULT_STDERR_MAX_BYTES: number;
 /** 缺省保留天数（与宿主 logger 同源缺省：7 天）。 */
 declare const DEFAULT_STDERR_KEEP_DAYS = 7;
-/** 轮转参数（env 覆盖面 = 宿主 logger 同款 XYZ_LOG_* 两键）。 */
+/** 轮转参数（env 覆盖面 = 宿主 logger 同款 TAIJI_LOG_* 两键）。 */
 interface StderrRotationParams {
     maxBytes: number;
     keepDays: number;

package/dist/logs/stderr-rotation.js

@@ -8,7 +8,7 @@ import {
   stderrLogPathFor,
   stderrLogPidOf,
   stderrRotationParams
-} from "../chunk-HYES77BR.js";
+} from "../chunk-MSAJXIP4.js";
 import "../chunk-JSBRDJBE.js";
 export {
   DEFAULT_STDERR_KEEP_DAYS,

package/dist/nesting-guard.cjs

@@ -28,7 +28,7 @@ __export(nesting_guard_exports, {
 });
 module.exports = __toCommonJS(nesting_guard_exports);
 var import_node_async_hooks = require("async_hooks");
-var NESTED_SPAWN_ENV = "XYZ_AGENT_SUBAGENT";
+var NESTED_SPAWN_ENV = "TAIJI_AGENT_SUBAGENT";
 var NATIVE_NESTED_KEYS = ["CLAUDECODE", "ZSW_NESTED"];
 var NATIVE_NESTED_PREFIXES = ["PI_SUBAGENT_"];
 var NestedSpawnRejectedError = class extends Error {
@@ -37,7 +37,7 @@ var NestedSpawnRejectedError = class extends Error {
   recovery;
   constructor() {
     super(
-      "nested_spawn_rejected: this process is already a subagent (XYZ_AGENT_SUBAGENT=1)"
+      "nested_spawn_rejected: this process is already a subagent (TAIJI_AGENT_SUBAGENT=1)"
     );
     this.name = "NestedSpawnRejectedError";
     this.recovery = "Subagents must not spawn further subagents (unbounded recursion guard). Do the work directly inside the current task instead of delegating.";

package/dist/nesting-guard.d.cts

@@ -1,5 +1,5 @@
 /** 统一嵌套标记 env 名（D8）。值恒 '1'。 */
-declare const NESTED_SPAWN_ENV = "XYZ_AGENT_SUBAGENT";
+declare const NESTED_SPAWN_ENV = "TAIJI_AGENT_SUBAGENT";
 /** env 对象形状（NodeJS.ProcessEnv 的结构子集，测试可传普通对象）。 */
 type SpawnEnv = Record<string, string | undefined>;
 /**
@@ -13,7 +13,7 @@ declare class NestedSpawnRejectedError extends Error {
     constructor();
 }
 /**
- * 构造子代理 spawn env：注入 XYZ_AGENT_SUBAGENT=1 + 剥离引擎原生嵌套标记。
+ * 构造子代理 spawn env：注入 TAIJI_AGENT_SUBAGENT=1 + 剥离引擎原生嵌套标记。
  * 返回新对象，不改入参（spawn env 组装链中的多层 spread 安全）。
  */
 declare function buildNestedSpawnEnv(baseEnv: SpawnEnv): SpawnEnv;

package/dist/nesting-guard.d.ts

@@ -1,5 +1,5 @@
 /** 统一嵌套标记 env 名（D8）。值恒 '1'。 */
-declare const NESTED_SPAWN_ENV = "XYZ_AGENT_SUBAGENT";
+declare const NESTED_SPAWN_ENV = "TAIJI_AGENT_SUBAGENT";
 /** env 对象形状（NodeJS.ProcessEnv 的结构子集，测试可传普通对象）。 */
 type SpawnEnv = Record<string, string | undefined>;
 /**
@@ -13,7 +13,7 @@ declare class NestedSpawnRejectedError extends Error {
     constructor();
 }
 /**
- * 构造子代理 spawn env：注入 XYZ_AGENT_SUBAGENT=1 + 剥离引擎原生嵌套标记。
+ * 构造子代理 spawn env：注入 TAIJI_AGENT_SUBAGENT=1 + 剥离引擎原生嵌套标记。
  * 返回新对象，不改入参（spawn env 组装链中的多层 spread 安全）。
  */
 declare function buildNestedSpawnEnv(baseEnv: SpawnEnv): SpawnEnv;

package/dist/nesting-guard.js

@@ -4,7 +4,7 @@ import {
   NestedSpawnRejectedError,
   assertNotNestedSpawn,
   buildNestedSpawnEnv
-} from "./chunk-365AUV6N.js";
+} from "./chunk-YE472JOO.js";
 import "./chunk-JSBRDJBE.js";
 export {
   ExecutionNestingContext,

package/dist/node-executor.cjs

@@ -48,7 +48,7 @@ var EngineSdkError = class extends Error {
 };
 
 // src/node-executor.ts
-var ENGINE_NODE_ENV = "XYZ_AGENT_ENGINE_NODE";
+var ENGINE_NODE_ENV = "TAIJI_AGENT_ENGINE_NODE";
 var PROBE_TIMEOUT_MS = 5e3;
 function probeNodeExecutor(execPath, isElectron) {
   return new Promise((resolve) => {
@@ -108,7 +108,7 @@ async function resolvePiExtensionLaunch(entryPath, entryArgs, env) {
   if (engineNode === void 0 || engineNode === "") {
     throw engineNotFound(
       `pi extension host must spawn engines via injected executor ${ENGINE_NODE_ENV}, but it is not set (host process.execPath is the pi binary, not a node executor)`,
-      `The xyz-agent runtime injects ${ENGINE_NODE_ENV} when spawning the pi host. If you are running the extension inside a packaged app, report this as a packaging regression; standalone pi installs do not use the pi-extension host kind.`
+      `The taiji runtime injects ${ENGINE_NODE_ENV} when spawning the pi host. If you are running the extension inside a packaged app, report this as a packaging regression; standalone pi installs do not use the pi-extension host kind.`
     );
   }
   const isElectron = env.ELECTRON_RUN_AS_NODE === "1";

package/dist/node-executor.d.cts

@@ -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.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-3IBT7MTB.js";
-import "./chunk-F5JZMK74.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-Dsvy79r3.cjs';
+import { a as AgentCallOpts, j as EngineHandleData, E as EngineCapabilities, P as ProbeReport, b as AgentEvent, k as ResumeAnchor, e as AgentOutcome, S as SessionView } from './contract-types-DaULkdpG.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-Dsvy79r3.js';
+import { a as AgentCallOpts, j as EngineHandleData, E as EngineCapabilities, P as ProbeReport, b as AgentEvent, k as ResumeAnchor, e as AgentOutcome, S as SessionView } from './contract-types-DaULkdpG.js';
 
 /**
  * 引擎进程内全量任务声明 = SDK AgentCallOpts 引擎面子集 + 协议 ctx 还原字段（model/

package/dist/protocol/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/protocol/index.ts
 var protocol_exports = {};
 __export(protocol_exports, {
+  AGENT_EVENT_TYPE_NAMES: () => AGENT_EVENT_TYPE_NAMES,
   CANCEL_SETTLE_GRACE_MS: () => CANCEL_SETTLE_GRACE_MS,
   CRASH_REBUILD_BACKOFF_MS: () => CRASH_REBUILD_BACKOFF_MS,
   CRASH_REBUILD_MAX_ATTEMPTS: () => CRASH_REBUILD_MAX_ATTEMPTS,
@@ -81,7 +82,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 +189,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\uFF08modeless \u4E0B\u65E0\u884C\u4E3A\u6548\u679C\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" }
   );
 }
@@ -210,6 +211,28 @@ function schemaEmulationFailedDetail(error, tail) {
   return `structured output emulation failed after tolerant extraction and one host-side retry: ${error}. Raw output tail: ${truncate(tail, DETAIL_ECHO_MAX_CHARS)}. Recovery: retry with a strengthened prompt or relax the schema; if it still fails switch to a schema-native engine (engine: pi).`;
 }
 
+// src/protocol/contract-types.ts
+var AGENT_EVENT_TYPE_NAMES = [
+  "tool_start",
+  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺 tool 起始占位（显示降级），turn 结构不受损
+  "tool_end",
+  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺 result，turn 收口由 turn_end/message_end 承担
+  "text_delta",
+  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺正文增量，不产生半解析状态
+  "thinking_delta",
+  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺推理增量，不产生半解析状态
+  "turn_end",
+  // noop-safe: 旧宿主 default 分支零写入——丢弃则该 turn 滞留进行态，journal 重放仍按序重建
+  "message_end",
+  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺 usage 聚合与闭合计量，已累积内容不回滚
+  "compaction",
+  // noop-safe: 事件无载荷且现行 reducer 即直接 return——丢弃与处理零差异
+  "activity",
+  // noop-safe: 纯活性信号，双侧 reducer 恒 no-op（协议语义见 AgentEvent 头注），丢弃零差异
+  "error"
+  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺 lastError 诊断留痕，已写状态不回滚
+];
+
 // src/protocol/schema.ts
 var ANY_JSON = {};
 var protocolErrorSchema = {
@@ -280,17 +303,9 @@ var notificationFrameSchema = {
           properties: {
             type: {
               type: "string",
-              enum: [
-                "tool_start",
-                "tool_end",
-                "text_delta",
-                "thinking_delta",
-                "turn_end",
-                "message_end",
-                "compaction",
-                "activity",
-                "error"
-              ]
+              // 事件 enum 从词表 SSOT 派生（U2 词表锁：union⟷词表互证后，此处不再
+              // 手写字面量集合——手写即漂移面，病灶 1 的第三处同步点）
+              enum: [...AGENT_EVENT_TYPE_NAMES]
             }
           }
         }
@@ -348,6 +363,7 @@ var runSessionParamsSchema = {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AGENT_EVENT_TYPE_NAMES,
   CANCEL_SETTLE_GRACE_MS,
   CRASH_REBUILD_BACKOFF_MS,
   CRASH_REBUILD_MAX_ATTEMPTS,

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-SA5fGtx_.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';
+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-CFTOAxva.cjs';
+import { E as EngineCapabilities, M as ModelCatalogEntry, a as AgentCallOpts, k as ResumeAnchor, j as EngineHandleData, P as ProbeReport, e as AgentOutcome, S as SessionView } from '../contract-types-DaULkdpG.cjs';
+export { A as AGENT_EVENT_TYPE_NAMES, b as AgentEvent, c as AgentEventTypeName, d as AgentFailureKind, f as AgentOutcomeUsage, g as AgentUsage, h as AgentUsageTotal, i as AssertMutuallyAssignable, I as InternalToolCall, R as ReplayedTurn, T as ToolCall, l as ToolCallEntry, m as ToolCallResult, n as Turn, W as WorktreeHandle } from '../contract-types-DaULkdpG.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）：
@@ -50,8 +50,9 @@ declare const PROTOCOL_METHODS: readonly ["initialize", "probe", "run", "cancel"
  * run 上下文（RunContext 字段映射的协议承载，设计 §3.3 RunContext 映射表）。
  */
 interface RunContextParams {
-    /** 任务工作目录（worktree 隔离时 = worktree 路径）。 */
-    cwd: string;
+    /** 任务工作目录（worktree 隔离时 = worktree 路径）。缺省不上 wire——引擎侧
+     *  回退自身进程 cwd（spawn 继承语义）。 */
+    cwd?: string;
     /** 请求模型 ref（未传 = 引擎缺省模型）。 */
     model?: string;
     /** 结构化输出 schema 的 env 注入形态（schemaEnv 降级通道）。 */

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-OvQlqiQw.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';
+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-C9BOUI5H.js';
+import { E as EngineCapabilities, M as ModelCatalogEntry, a as AgentCallOpts, k as ResumeAnchor, j as EngineHandleData, P as ProbeReport, e as AgentOutcome, S as SessionView } from '../contract-types-DaULkdpG.js';
+export { A as AGENT_EVENT_TYPE_NAMES, b as AgentEvent, c as AgentEventTypeName, d as AgentFailureKind, f as AgentOutcomeUsage, g as AgentUsage, h as AgentUsageTotal, i as AssertMutuallyAssignable, I as InternalToolCall, R as ReplayedTurn, T as ToolCall, l as ToolCallEntry, m as ToolCallResult, n as Turn, W as WorktreeHandle } from '../contract-types-DaULkdpG.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）：
@@ -50,8 +50,9 @@ declare const PROTOCOL_METHODS: readonly ["initialize", "probe", "run", "cancel"
  * run 上下文（RunContext 字段映射的协议承载，设计 §3.3 RunContext 映射表）。
  */
 interface RunContextParams {
-    /** 任务工作目录（worktree 隔离时 = worktree 路径）。 */
-    cwd: string;
+    /** 任务工作目录（worktree 隔离时 = worktree 路径）。缺省不上 wire——引擎侧
+     *  回退自身进程 cwd（spawn 继承语义）。 */
+    cwd?: string;
     /** 请求模型 ref（未传 = 引擎缺省模型）。 */
     model?: string;
     /** 结构化输出 schema 的 env 注入形态（schemaEnv 降级通道）。 */

package/dist/protocol/index.js

@@ -1,4 +1,5 @@
 import {
+  AGENT_EVENT_TYPE_NAMES,
   ENGINE_PROTOCOL_SCHEMAS,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   PROTOCOL_METHODS,
@@ -15,7 +16,7 @@ import {
   reverseRequestFrameSchema,
   runSessionParamsSchema,
   successResponseFrameSchema
-} from "../chunk-TW2FAMAJ.js";
+} from "../chunk-63ZNJHM5.js";
 import {
   CANCEL_SETTLE_GRACE_MS,
   CRASH_REBUILD_BACKOFF_MS,
@@ -40,9 +41,10 @@ import {
   isEngineProtocolErrorCode,
   isProtocolVersionCompatible,
   schemaEmulationFailedDetail
-} from "../chunk-F5JZMK74.js";
+} from "../chunk-WMDMXP2F.js";
 import "../chunk-JSBRDJBE.js";
 export {
+  AGENT_EVENT_TYPE_NAMES,
   CANCEL_SETTLE_GRACE_MS,
   CRASH_REBUILD_BACKOFF_MS,
   CRASH_REBUILD_MAX_ATTEMPTS,

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 语义）。 */