@zhushanwen/subagent-engine-sdk 0.5.0 → 0.6.0

package/dist/env.cjs

@@ -78,25 +78,29 @@ function getLogger(component) {
 // src/env.ts
 var logger = getLogger("engine-sdk/env");
 var ENGINE_ENV_PREFIXES = [
-  "XYZ_",
-  "XYZ_AGENT_",
-  "XYZ_SUBAGENT_"
+  "TAIJI_",
+  "TAIJI_AGENT_",
+  "TAIJI_SUBAGENT_"
 ];
 var ENGINE_ENV_DENY_LIST = [
-  "XYZ_AGENT_PACKAGED",
-  "XYZ_RUNTIME_TOKEN",
-  "XYZ_AGENT_API_KEY",
-  "XYZ_SUBAGENT_RELAY_SESSION_ID",
-  "XYZ_SUBAGENT_RELAY_RECORD_ID"
+  "TAIJI_AGENT_PACKAGED",
+  "TAIJI_RUNTIME_TOKEN",
+  "TAIJI_AGENT_API_KEY",
+  "TAIJI_SUBAGENT_RELAY_SESSION_ID",
+  "TAIJI_SUBAGENT_RELAY_RECORD_ID",
+  // 预设回落事实（env 名 SSOT = shared PRESET_FALLBACK_ENV_KEYS）：「本进程本次运行」
+  // 事实只对 runtime 直接 spawn 的 pi 成立，引擎一跳继承会造成子 agent pi 假披露
+  "TAIJI_PRESET_FALLBACK_FROM",
+  "TAIJI_PRESET_FALLBACK_TO"
 ];
 var ENGINE_ENV_L0_INFRA_KEYS = [
-  "XYZ_AGENT_DATA_DIR",
-  "XYZ_AGENT_ENGINE_NODE",
+  "TAIJI_AGENT_DATA_DIR",
+  "TAIJI_AGENT_ENGINE_NODE",
   "ELECTRON_RUN_AS_NODE",
-  "XYZ_AGENT_SUBAGENT",
-  "XYZ_SUBAGENT_RELAY_SOCKET",
-  "XYZ_SUBAGENT_RELAY_NODE",
-  "XYZ_SUBAGENT_RELAY_SCRIPT"
+  "TAIJI_AGENT_SUBAGENT",
+  "TAIJI_SUBAGENT_RELAY_SOCKET",
+  "TAIJI_SUBAGENT_RELAY_NODE",
+  "TAIJI_SUBAGENT_RELAY_SCRIPT"
 ];
 var ENV_PREFIX_SHAPE_RE = /^[A-Za-z0-9_]+$/;
 function deleteEnvKeysCaseInsensitive(env, names) {
@@ -146,14 +150,14 @@ function applyManifestAllowlist(env, opts) {
   }
 }
 function injectL0InfraKeys(env, opts) {
-  env.XYZ_AGENT_DATA_DIR = opts.dataDir;
-  if (opts.engineNode !== void 0) env.XYZ_AGENT_ENGINE_NODE = opts.engineNode;
+  env.TAIJI_AGENT_DATA_DIR = opts.dataDir;
+  if (opts.engineNode !== void 0) env.TAIJI_AGENT_ENGINE_NODE = opts.engineNode;
   if (opts.electronRunAsNode === true) env.ELECTRON_RUN_AS_NODE = "1";
-  env.XYZ_AGENT_SUBAGENT = "1";
+  env.TAIJI_AGENT_SUBAGENT = "1";
   if (opts.relay !== void 0) {
-    env.XYZ_SUBAGENT_RELAY_SOCKET = opts.relay.socket;
-    env.XYZ_SUBAGENT_RELAY_NODE = opts.relay.node;
-    env.XYZ_SUBAGENT_RELAY_SCRIPT = opts.relay.script;
+    env.TAIJI_SUBAGENT_RELAY_SOCKET = opts.relay.socket;
+    env.TAIJI_SUBAGENT_RELAY_NODE = opts.relay.node;
+    env.TAIJI_SUBAGENT_RELAY_SCRIPT = opts.relay.script;
   }
   if (opts.identityEnv !== void 0) {
     for (const [key, value] of Object.entries(opts.identityEnv)) {

package/dist/env.d.cts

@@ -21,12 +21,12 @@ interface EngineChildEnvOptions {
     engineNode?: string;
     /** L0：执行器为 Electron 二进制 → 注入 ELECTRON_RUN_AS_NODE=1 */
     electronRunAsNode?: boolean;
-    /** L0：relay 三键（宿主 relay 激活时传；三键必经 L0——L1 拒绝 XYZ_SUBAGENT_ 前缀、L2 是 manifest 面，两层都到不了） */
+    /** 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 标记 = XYZ_AGENT_SUBAGENT=1
+     * 两键已无写入方（本通道现无人传值），引擎链统一 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。
@@ -45,8 +45,8 @@ interface EngineChildEnvOptions {
  * L0 键在最后写入故不受 L1 剥除影响（交集为 ∅ 由测试断言兜底）。
  *
  * 层规格（impl-plan §2.12 三层表）：
- * - L0 基础设施键：XYZ_AGENT_DATA_DIR / XYZ_AGENT_ENGINE_NODE / ELECTRON_RUN_AS_NODE
- *   （条件）/ XYZ_AGENT_SUBAGENT=1 / relay 三键 / identityEnv（injectL0InfraKeys）；
+ * - L0 基础设施键：TAIJI_AGENT_DATA_DIR / TAIJI_AGENT_ENGINE_NODE / ELECTRON_RUN_AS_NODE
+ *   （条件）/ TAIJI_AGENT_SUBAGENT=1 / relay 三键 / identityEnv（injectL0InfraKeys）；
  * - L1 deny + 显式剥除（恒高于 manifest 放行）：ENGINE_ENV_DENY_LIST
  *   （deny 两键 + 凭证键 + 父身份键 + 防御性剥除三死名）；
  * - L2 manifest 放行：envPrefixes 声明前缀的 processEnv 键（保留前缀拒绝、
@@ -69,7 +69,7 @@ interface BuildOutboundChildEnvOptions {
  * execFile 等）复用——R3 MF-C：deny 键不进 git 子进程，git hooks 等后代不再可能
  * 消费生命周期标志 / WS 令牌。
  *
- * 与 @xyz-agent/shared 版 buildOutboundChildEnv 的刻意差异：**缺省不做白名单过滤**
+ * 与 @taiji/shared 版 buildOutboundChildEnv 的刻意差异：**缺省不做白名单过滤**
  * （prefixes 省略 = 全量继承父 env + deny 剥除）。理由：SDK 消费面（zsw 宿主 /
  * 引擎 CLI）不可 import shared 的 ENV_WHITELIST_PREFIXES；引擎 spawn 的基座由
  * 调用方先经 buildEngineChildEnv 组装（其 baseEnv 已是 core 过滤后的），而

package/dist/env.d.ts

@@ -21,12 +21,12 @@ interface EngineChildEnvOptions {
     engineNode?: string;
     /** L0：执行器为 Electron 二进制 → 注入 ELECTRON_RUN_AS_NODE=1 */
     electronRunAsNode?: boolean;
-    /** L0：relay 三键（宿主 relay 激活时传；三键必经 L0——L1 拒绝 XYZ_SUBAGENT_ 前缀、L2 是 manifest 面，两层都到不了） */
+    /** 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 标记 = XYZ_AGENT_SUBAGENT=1
+     * 两键已无写入方（本通道现无人传值），引擎链统一 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。
@@ -45,8 +45,8 @@ interface EngineChildEnvOptions {
  * L0 键在最后写入故不受 L1 剥除影响（交集为 ∅ 由测试断言兜底）。
  *
  * 层规格（impl-plan §2.12 三层表）：
- * - L0 基础设施键：XYZ_AGENT_DATA_DIR / XYZ_AGENT_ENGINE_NODE / ELECTRON_RUN_AS_NODE
- *   （条件）/ XYZ_AGENT_SUBAGENT=1 / relay 三键 / identityEnv（injectL0InfraKeys）；
+ * - L0 基础设施键：TAIJI_AGENT_DATA_DIR / TAIJI_AGENT_ENGINE_NODE / ELECTRON_RUN_AS_NODE
+ *   （条件）/ TAIJI_AGENT_SUBAGENT=1 / relay 三键 / identityEnv（injectL0InfraKeys）；
  * - L1 deny + 显式剥除（恒高于 manifest 放行）：ENGINE_ENV_DENY_LIST
  *   （deny 两键 + 凭证键 + 父身份键 + 防御性剥除三死名）；
  * - L2 manifest 放行：envPrefixes 声明前缀的 processEnv 键（保留前缀拒绝、
@@ -69,7 +69,7 @@ interface BuildOutboundChildEnvOptions {
  * execFile 等）复用——R3 MF-C：deny 键不进 git 子进程，git hooks 等后代不再可能
  * 消费生命周期标志 / WS 令牌。
  *
- * 与 @xyz-agent/shared 版 buildOutboundChildEnv 的刻意差异：**缺省不做白名单过滤**
+ * 与 @taiji/shared 版 buildOutboundChildEnv 的刻意差异：**缺省不做白名单过滤**
  * （prefixes 省略 = 全量继承父 env + deny 剥除）。理由：SDK 消费面（zsw 宿主 /
  * 引擎 CLI）不可 import shared 的 ENV_WHITELIST_PREFIXES；引擎 spawn 的基座由
  * 调用方先经 buildEngineChildEnv 组装（其 baseEnv 已是 core 过滤后的），而

package/dist/env.js

@@ -4,7 +4,7 @@ import {
   ENGINE_ENV_PREFIXES,
   buildEngineChildEnv,
   buildOutboundChildEnv
-} from "./chunk-BBVZK5DL.js";
+} from "./chunk-YL5W5EMV.js";
 import "./chunk-75QEMUGV.js";
 import "./chunk-JSBRDJBE.js";
 export {

package/dist/{error-codes-SA5fGtx_.d.cts → error-codes-C9BOUI5H.d.ts}

@@ -1,4 +1,4 @@
-import { a as AgentEvent, E as EngineCapabilities } from './contract-types-Dsvy79r3.cjs';
+import { b as AgentEvent, E as EngineCapabilities } from './contract-types-DaULkdpG.js';
 
 /** 协议错误对象（error 帧载荷与反向请求错误应答共用形态）。 */
 interface ProtocolError {
@@ -50,7 +50,7 @@ type ReverseResponseResult =
  | {
     ack: true;
 }
-/** 未实现的交互能力（设计：未实现回 unsupported，引擎自行降级）。 */
+/** 未实现或宿主未知的通道（宽容语义③：由 askUser 语境泛化到全通道——宿主对未知 host/* 通道回 unsupported，引擎自行降级）。 */
  | {
     unsupported: true;
 };
@@ -88,9 +88,10 @@ declare class EngineSdkError extends Error {
 declare function engineProtocolMismatchError(engineVersion: number): EngineSdkError;
 /**
  * 引擎 conversation 位拒绝的具名错误（[modeless 波2] 语义：无 resume 续聊通道的
- * 引擎，message 续聊资格被拒——manifest conversation 能力轴消费，core
- * capability-gate 的 conversation 分支与 message 资格门双写点共用本构造器）。
- * 文案契约：错误码 engine_capability_unsupported + 「去掉参数 / 修 manifest /
+ * 引擎，message 续聊资格被拒——manifest conversation 能力轴消费；[modeless 波5
+ * 收尾] core capability-gate 的显式参数分支随派发参数删除退役，本构造器消费方 =
+ * 引擎侧 resume gate（assertChatConversationSupported）与 message 资格门）。
+ * 文案契约：错误码 engine_capability_unsupported + 「换引擎续聊 / 修 manifest /
  * 升级引擎包」恢复指引，两侧一致防漂移。
  */
 declare function engineConversationUnsupportedError(engineId: string): EngineSdkError;

package/dist/{error-codes-OvQlqiQw.d.ts → error-codes-CFTOAxva.d.cts}

@@ -1,4 +1,4 @@
-import { a as AgentEvent, E as EngineCapabilities } from './contract-types-Dsvy79r3.js';
+import { b as AgentEvent, E as EngineCapabilities } from './contract-types-DaULkdpG.cjs';
 
 /** 协议错误对象（error 帧载荷与反向请求错误应答共用形态）。 */
 interface ProtocolError {
@@ -50,7 +50,7 @@ type ReverseResponseResult =
  | {
     ack: true;
 }
-/** 未实现的交互能力（设计：未实现回 unsupported，引擎自行降级）。 */
+/** 未实现或宿主未知的通道（宽容语义③：由 askUser 语境泛化到全通道——宿主对未知 host/* 通道回 unsupported，引擎自行降级）。 */
  | {
     unsupported: true;
 };
@@ -88,9 +88,10 @@ declare class EngineSdkError extends Error {
 declare function engineProtocolMismatchError(engineVersion: number): EngineSdkError;
 /**
  * 引擎 conversation 位拒绝的具名错误（[modeless 波2] 语义：无 resume 续聊通道的
- * 引擎，message 续聊资格被拒——manifest conversation 能力轴消费，core
- * capability-gate 的 conversation 分支与 message 资格门双写点共用本构造器）。
- * 文案契约：错误码 engine_capability_unsupported + 「去掉参数 / 修 manifest /
+ * 引擎，message 续聊资格被拒——manifest conversation 能力轴消费；[modeless 波5
+ * 收尾] core capability-gate 的显式参数分支随派发参数删除退役，本构造器消费方 =
+ * 引擎侧 resume gate（assertChatConversationSupported）与 message 资格门）。
+ * 文案契约：错误码 engine_capability_unsupported + 「换引擎续聊 / 修 manifest /
  * 升级引擎包」恢复指引，两侧一致防漂移。
  */
 declare function engineConversationUnsupportedError(engineId: string): EngineSdkError;

package/dist/index.cjs

@@ -6572,6 +6572,7 @@ var require_ajv = __commonJS({
 // src/index.ts
 var src_exports = {};
 __export(src_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,
@@ -6615,7 +6616,9 @@ __export(src_exports, {
   STDERR_TAIL_CHARS: () => STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS: () => STDOUT_TAIL_ECHO_CHARS,
   SUPPORTED_PROTOCOL_RANGE: () => SUPPORTED_PROTOCOL_RANGE,
-  XYZ_DATA_DIR_ENV: () => XYZ_DATA_DIR_ENV,
+  TAIJI_DATA_DIR_ENV: () => TAIJI_DATA_DIR_ENV,
+  ZCODE_HOST_DB_SUFFIX: () => ZCODE_HOST_DB_SUFFIX,
+  ZCODE_ISOLATED_DB_SEGMENTS: () => ZCODE_ISOLATED_DB_SEGMENTS,
   abortWithFallback: () => abortWithFallback,
   aggregateUsage: () => aggregateUsage,
   armEngineSelfDestruct: () => armEngineSelfDestruct,
@@ -6706,7 +6709,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
@@ -6813,7 +6816,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" }
   );
 }
@@ -6835,6 +6838,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 = {
@@ -6905,17 +6930,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]
             }
           }
         }
@@ -7071,7 +7088,7 @@ function getOrCompileValidator(schema) {
 
 // src/nesting-guard.ts
 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 {
@@ -7080,7 +7097,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.";
@@ -7529,7 +7546,7 @@ function sessionIdFromHandle(handle) {
 
 // src/data-dir.ts
 var logger2 = getLogger("subagents");
-var XYZ_DATA_DIR_ENV = "XYZ_AGENT_DATA_DIR";
+var TAIJI_DATA_DIR_ENV = "TAIJI_AGENT_DATA_DIR";
 var WARNED_SLOT_KEY = /* @__PURE__ */ Symbol.for("@zhushanwen/subagent-engine-sdk.data-dir-warned");
 function getWarnedSlot() {
   let slot = Reflect.get(globalThis, WARNED_SLOT_KEY);
@@ -7543,19 +7560,19 @@ function resetDataDirWarnForTests() {
   getWarnedSlot().current = false;
 }
 function resolveEngineDataDir(env, opts = {}) {
-  const fromEnv = env[XYZ_DATA_DIR_ENV]?.trim();
+  const fromEnv = env[TAIJI_DATA_DIR_ENV]?.trim();
   if (fromEnv !== void 0 && fromEnv !== "") return fromEnv;
   const fallback = opts.fallbackDataRoot?.trim();
   if (fallback === void 0 || 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.`
+      `[subagent-engine-sdk] engine_not_found: ${TAIJI_DATA_DIR_ENV} is not set and no fallback data root was injected. Recovery: the host must inject ${TAIJI_DATA_DIR_ENV} into the engine process env (taiji 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 \u2014 if you are running inside xyz-agent, check the runtime spawn env; standalone installs intentionally use the injected root.`
+      `[engine-data-dir] ${TAIJI_DATA_DIR_ENV} is not set; engine journal/pool fall back to the injected data root (${fallback}). The taiji host normally injects this env \u2014 if you are running inside taiji, check the runtime spawn env; standalone installs intentionally use the injected root.`
     );
   }
   return fallback;
@@ -7595,8 +7612,8 @@ function isUiResponse(value) {
 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);
@@ -7685,25 +7702,29 @@ function createUiChannelRegistry() {
 // src/env.ts
 var logger3 = getLogger("engine-sdk/env");
 var ENGINE_ENV_PREFIXES = [
-  "XYZ_",
-  "XYZ_AGENT_",
-  "XYZ_SUBAGENT_"
+  "TAIJI_",
+  "TAIJI_AGENT_",
+  "TAIJI_SUBAGENT_"
 ];
 var ENGINE_ENV_DENY_LIST = [
-  "XYZ_AGENT_PACKAGED",
-  "XYZ_RUNTIME_TOKEN",
-  "XYZ_AGENT_API_KEY",
-  "XYZ_SUBAGENT_RELAY_SESSION_ID",
-  "XYZ_SUBAGENT_RELAY_RECORD_ID"
+  "TAIJI_AGENT_PACKAGED",
+  "TAIJI_RUNTIME_TOKEN",
+  "TAIJI_AGENT_API_KEY",
+  "TAIJI_SUBAGENT_RELAY_SESSION_ID",
+  "TAIJI_SUBAGENT_RELAY_RECORD_ID",
+  // 预设回落事实（env 名 SSOT = shared PRESET_FALLBACK_ENV_KEYS）：「本进程本次运行」
+  // 事实只对 runtime 直接 spawn 的 pi 成立，引擎一跳继承会造成子 agent pi 假披露
+  "TAIJI_PRESET_FALLBACK_FROM",
+  "TAIJI_PRESET_FALLBACK_TO"
 ];
 var ENGINE_ENV_L0_INFRA_KEYS = [
-  "XYZ_AGENT_DATA_DIR",
-  "XYZ_AGENT_ENGINE_NODE",
+  "TAIJI_AGENT_DATA_DIR",
+  "TAIJI_AGENT_ENGINE_NODE",
   "ELECTRON_RUN_AS_NODE",
-  "XYZ_AGENT_SUBAGENT",
-  "XYZ_SUBAGENT_RELAY_SOCKET",
-  "XYZ_SUBAGENT_RELAY_NODE",
-  "XYZ_SUBAGENT_RELAY_SCRIPT"
+  "TAIJI_AGENT_SUBAGENT",
+  "TAIJI_SUBAGENT_RELAY_SOCKET",
+  "TAIJI_SUBAGENT_RELAY_NODE",
+  "TAIJI_SUBAGENT_RELAY_SCRIPT"
 ];
 var ENV_PREFIX_SHAPE_RE = /^[A-Za-z0-9_]+$/;
 function deleteEnvKeysCaseInsensitive(env, names) {
@@ -7753,14 +7774,14 @@ function applyManifestAllowlist(env, opts) {
   }
 }
 function injectL0InfraKeys(env, opts) {
-  env.XYZ_AGENT_DATA_DIR = opts.dataDir;
-  if (opts.engineNode !== void 0) env.XYZ_AGENT_ENGINE_NODE = opts.engineNode;
+  env.TAIJI_AGENT_DATA_DIR = opts.dataDir;
+  if (opts.engineNode !== void 0) env.TAIJI_AGENT_ENGINE_NODE = opts.engineNode;
   if (opts.electronRunAsNode === true) env.ELECTRON_RUN_AS_NODE = "1";
-  env.XYZ_AGENT_SUBAGENT = "1";
+  env.TAIJI_AGENT_SUBAGENT = "1";
   if (opts.relay !== void 0) {
-    env.XYZ_SUBAGENT_RELAY_SOCKET = opts.relay.socket;
-    env.XYZ_SUBAGENT_RELAY_NODE = opts.relay.node;
-    env.XYZ_SUBAGENT_RELAY_SCRIPT = opts.relay.script;
+    env.TAIJI_SUBAGENT_RELAY_SOCKET = opts.relay.socket;
+    env.TAIJI_SUBAGENT_RELAY_NODE = opts.relay.node;
+    env.TAIJI_SUBAGENT_RELAY_SCRIPT = opts.relay.script;
   }
   if (opts.identityEnv !== void 0) {
     for (const [key, value] of Object.entries(opts.identityEnv)) {
@@ -7831,7 +7852,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;
@@ -7918,7 +7939,7 @@ function pumpNdjsonLines(stream, onLine) {
 
 // src/node-executor.ts
 var import_node_child_process2 = require("child_process");
-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) => {
@@ -7978,7 +7999,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";
@@ -8061,8 +8082,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) {
@@ -8139,12 +8160,16 @@ function cleanupSiblingStderrLogs(logPath, env, prefix, now) {
   return cleanupStaleStderrLogs((0, import_node_path2.dirname)(logPath), env, prefix, now);
 }
 
+// src/zcode-db-paths.ts
+var ZCODE_HOST_DB_SUFFIX = [".zcode", "cli", "db", "db.sqlite"];
+var ZCODE_ISOLATED_DB_SEGMENTS = ["engines", "zcode", "session-db", "db.sqlite"];
+
 // src/relay-env.ts
-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 = {
   /** 握手被拒：协议版本不匹配（安装损坏，重装应用）。 */
@@ -8264,6 +8289,7 @@ function runEngineCliEntry(opts) {
 }
 // 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,
@@ -8307,7 +8333,9 @@ function runEngineCliEntry(opts) {
   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/index.d.cts

@@ -1,12 +1,12 @@
 export { CANCEL_SETTLE_GRACE_MS, CRASH_REBUILD_BACKOFF_MS, CRASH_REBUILD_MAX_ATTEMPTS, CancelParams, CancelResult, DisposeParams, DisposeResult, ENGINE_EVENT_COALESCE_DEFAULT, ENGINE_EVENT_COALESCE_ENV, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, HostAskUserParams, HostAskUserResult, HostChildSpawnedParams, HostChildStateChangedParams, HostHandleReadyParams, HostLogParams, HostStreamDeltaParams, InitializeParams, InitializeResult, ListModelsParams, ListModelsResult, PROTOCOL_METHODS, PingParams, PingResult, ProbeParams, ProtocolMethod, ProtocolParamsMap, ProtocolResultMap, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReadParams, ReverseChannel, ReverseRequestTimeoutClass, RunContextParams, RunParams, RunResult, RunResumeParams, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, ValidateModelParams, ValidateModelResult, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema } from './protocol/index.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-SA5fGtx_.cjs';
-export { A as AgentCallOpts, a as AgentEvent, b as AgentFailureKind, c as AgentOutcome, d as AgentOutcomeUsage, e as AgentUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, E as EngineCapabilities, h as EngineHandleData, I as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, i as ResumeAnchor, S as SessionView, 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';
+export { A as AGENT_EVENT_TYPE_NAMES, a as AgentCallOpts, b as AgentEvent, c as AgentEventTypeName, d as AgentFailureKind, e as AgentOutcome, f as AgentOutcomeUsage, g as AgentUsage, h as AgentUsageTotal, i as AssertMutuallyAssignable, E as EngineCapabilities, j as EngineHandleData, I as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, k as ResumeAnchor, S as SessionView, T as ToolCall, l as ToolCallEntry, m as ToolCallResult, n as Turn, W as WorktreeHandle } from './contract-types-DaULkdpG.cjs';
 export { SCHEMA_EMULATION_TAIL_CHARS, StructuredOutputResult, buildSchemaEmulationSegment, extractAndValidateStructuredOutput } from './schema-emulation.cjs';
 export { ExecutionNestingContext, ExecutionNestingState, NESTED_SPAWN_ENV, NestedSpawnRejectedError, SpawnEnv, assertNotNestedSpawn, buildNestedSpawnEnv } from './nesting-guard.cjs';
 export { CoreLogger, LogLevel, LoggerSink, configureLoggerSink, getLogger, resetLoggerSinkForTests } from './logger.cjs';
 export { DEFAULT_KILL_GRACE_MS, DEFAULT_NATIVE_INTERRUPT_GRACE_MS, HOST_TIMEOUT_ABORT_REASON, KillChainOptions, KillableChild, abortWithFallback, killChain, synthesizeTimeoutOutcome } from './kill-chain.cjs';
 export { ReplayRecordView, aggregateUsage, createReplayRecord, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent } from './journal-replay.cjs';
-export { XYZ_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir } from './data-dir.cjs';
+export { TAIJI_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir } from './data-dir.cjs';
 export { resolveEngineDir, resolveEnginesRoot, resolveJournalPath, resolvePoolDir, sanitizeSeg } from './paths.cjs';
 export { UiMethod, UiRequest, UiRequestHandler, UiResponse, isUiResponse } from './ui-types.cjs';
 export { ChannelHandler, ExtensionUiRequestLike, ParsedChannel, UiChannelRegistry, createUiChannelRegistry, parseChannel } from './ui-channels.cjs';
@@ -14,6 +14,7 @@ export { BuildOutboundChildEnvOptions, ENGINE_ENV_DENY_LIST, ENGINE_ENV_L0_INFRA
 export { DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS, ENGINE_HOST_REQUEST_TIMEOUT_ENV, EngineChildEnv, EngineSelfDestructOptions, ReverseRequestClock, SpawnEngineChildOptions, armEngineSelfDestruct, pumpNdjsonLines, spawnEngineChild } from './spawn.cjs';
 export { ENGINE_NODE_ENV, EngineNodeHostKind, EngineNodeLaunch, EngineNodeLaunchOptions, hostKindOf, probeNodeExecutor, resetEngineNodeProbeCache, resolveEngineNodeLaunch } from './node-executor.cjs';
 export { CleanupResult, DEFAULT_STDERR_KEEP_DAYS, DEFAULT_STDERR_MAX_BYTES, StderrRotationParams, cleanupSiblingStderrLogs, cleanupStaleStderrLogs, isPidAlive, rotateStderrLogIfNeeded, stderrLogPathFor, stderrLogPidOf, stderrRotationParams } from './logs/stderr-rotation.cjs';
+export { ZCODE_HOST_DB_SUFFIX, ZCODE_ISOLATED_DB_SEGMENTS } from './zcode-db-paths.cjs';
 export { RELAY_ENV_NODE, RELAY_ENV_RECORD_ID, RELAY_ENV_SCRIPT, RELAY_ENV_SESSION_ID, RELAY_ENV_SOCKET, RELAY_EXIT_CODES, RELAY_PROTOCOL_VERSION, isRelayActive, readRelayForwardEnv } from './relay-env.cjs';
 export { toErrorMessage } from './error-message.cjs';
 export { BestEffortLevel, bestEffort } from './best-effort.cjs';

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 export { CANCEL_SETTLE_GRACE_MS, CRASH_REBUILD_BACKOFF_MS, CRASH_REBUILD_MAX_ATTEMPTS, CancelParams, CancelResult, DisposeParams, DisposeResult, ENGINE_EVENT_COALESCE_DEFAULT, ENGINE_EVENT_COALESCE_ENV, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, HostAskUserParams, HostAskUserResult, HostChildSpawnedParams, HostChildStateChangedParams, HostHandleReadyParams, HostLogParams, HostStreamDeltaParams, InitializeParams, InitializeResult, ListModelsParams, ListModelsResult, PROTOCOL_METHODS, PingParams, PingResult, ProbeParams, ProtocolMethod, ProtocolParamsMap, ProtocolResultMap, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReadParams, ReverseChannel, ReverseRequestTimeoutClass, RunContextParams, RunParams, RunResult, RunResumeParams, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, ValidateModelParams, ValidateModelResult, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema } from './protocol/index.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-OvQlqiQw.js';
-export { A as AgentCallOpts, a as AgentEvent, b as AgentFailureKind, c as AgentOutcome, d as AgentOutcomeUsage, e as AgentUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, E as EngineCapabilities, h as EngineHandleData, I as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, i as ResumeAnchor, S as SessionView, 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';
+export { A as AGENT_EVENT_TYPE_NAMES, a as AgentCallOpts, b as AgentEvent, c as AgentEventTypeName, d as AgentFailureKind, e as AgentOutcome, f as AgentOutcomeUsage, g as AgentUsage, h as AgentUsageTotal, i as AssertMutuallyAssignable, E as EngineCapabilities, j as EngineHandleData, I as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, k as ResumeAnchor, S as SessionView, T as ToolCall, l as ToolCallEntry, m as ToolCallResult, n as Turn, W as WorktreeHandle } from './contract-types-DaULkdpG.js';
 export { SCHEMA_EMULATION_TAIL_CHARS, StructuredOutputResult, buildSchemaEmulationSegment, extractAndValidateStructuredOutput } from './schema-emulation.js';
 export { ExecutionNestingContext, ExecutionNestingState, NESTED_SPAWN_ENV, NestedSpawnRejectedError, SpawnEnv, assertNotNestedSpawn, buildNestedSpawnEnv } from './nesting-guard.js';
 export { CoreLogger, LogLevel, LoggerSink, configureLoggerSink, getLogger, resetLoggerSinkForTests } from './logger.js';
 export { DEFAULT_KILL_GRACE_MS, DEFAULT_NATIVE_INTERRUPT_GRACE_MS, HOST_TIMEOUT_ABORT_REASON, KillChainOptions, KillableChild, abortWithFallback, killChain, synthesizeTimeoutOutcome } from './kill-chain.js';
 export { ReplayRecordView, aggregateUsage, createReplayRecord, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent } from './journal-replay.js';
-export { XYZ_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir } from './data-dir.js';
+export { TAIJI_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir } from './data-dir.js';
 export { resolveEngineDir, resolveEnginesRoot, resolveJournalPath, resolvePoolDir, sanitizeSeg } from './paths.js';
 export { UiMethod, UiRequest, UiRequestHandler, UiResponse, isUiResponse } from './ui-types.js';
 export { ChannelHandler, ExtensionUiRequestLike, ParsedChannel, UiChannelRegistry, createUiChannelRegistry, parseChannel } from './ui-channels.js';
@@ -14,6 +14,7 @@ export { BuildOutboundChildEnvOptions, ENGINE_ENV_DENY_LIST, ENGINE_ENV_L0_INFRA
 export { DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS, ENGINE_HOST_REQUEST_TIMEOUT_ENV, EngineChildEnv, EngineSelfDestructOptions, ReverseRequestClock, SpawnEngineChildOptions, armEngineSelfDestruct, pumpNdjsonLines, spawnEngineChild } from './spawn.js';
 export { ENGINE_NODE_ENV, EngineNodeHostKind, EngineNodeLaunch, EngineNodeLaunchOptions, hostKindOf, probeNodeExecutor, resetEngineNodeProbeCache, resolveEngineNodeLaunch } from './node-executor.js';
 export { CleanupResult, DEFAULT_STDERR_KEEP_DAYS, DEFAULT_STDERR_MAX_BYTES, StderrRotationParams, cleanupSiblingStderrLogs, cleanupStaleStderrLogs, isPidAlive, rotateStderrLogIfNeeded, stderrLogPathFor, stderrLogPidOf, stderrRotationParams } from './logs/stderr-rotation.js';
+export { ZCODE_HOST_DB_SUFFIX, ZCODE_ISOLATED_DB_SEGMENTS } from './zcode-db-paths.js';
 export { RELAY_ENV_NODE, RELAY_ENV_RECORD_ID, RELAY_ENV_SCRIPT, RELAY_ENV_SESSION_ID, RELAY_ENV_SOCKET, RELAY_EXIT_CODES, RELAY_PROTOCOL_VERSION, isRelayActive, readRelayForwardEnv } from './relay-env.js';
 export { toErrorMessage } from './error-message.js';
 export { BestEffortLevel, bestEffort } from './best-effort.js';