@zhushanwen/subagent-engine-sdk 0.5.1 → 0.6.0

package/dist/{chunk-TW2FAMAJ.js → chunk-63ZNJHM5.js}

@@ -51,6 +51,28 @@ var REVERSE_CHANNEL_TIMEOUT_CLASS = {
   "host/askUser": "interaction"
 };
 
+// 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 = {
@@ -121,17 +143,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]
             }
           }
         }
@@ -196,6 +210,7 @@ export {
   PROTOCOL_METHODS,
   REVERSE_CHANNELS,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
+  AGENT_EVENT_TYPE_NAMES,
   protocolErrorSchema,
   requestFrameSchema,
   successResponseFrameSchema,

package/dist/chunk-CT3FEBDO.js

@@ -0,0 +1,8 @@
+// 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"];
+
+export {
+  ZCODE_HOST_DB_SUFFIX,
+  ZCODE_ISOLATED_DB_SEGMENTS
+};

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

@@ -14,7 +14,11 @@ var ENGINE_ENV_DENY_LIST = [
   "TAIJI_RUNTIME_TOKEN",
   "TAIJI_AGENT_API_KEY",
   "TAIJI_SUBAGENT_RELAY_SESSION_ID",
-  "TAIJI_SUBAGENT_RELAY_RECORD_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 = [
   "TAIJI_AGENT_DATA_DIR",

package/dist/{contract-types-Dsvy79r3.d.cts → contract-types-DaULkdpG.d.cts}

@@ -62,38 +62,71 @@ interface Turn {
  * activity = 纯活性信号：双侧 reducer no-op、不开 turn、不写状态、不落 journal
  * （core journal-wiring 对其豁免 append），只承诺「引擎活跃时周期性出现」——供宿主
  * 无进展守护刷新判活（长工具执行期）。节流属生产者实现细节，不进协议承诺。
+ *
+ * 每个成员的 type 经 `EventName<"…">` 受词表约束（编译锁①，见下方词表节）。
  */
 type AgentEvent = {
-    type: "tool_start";
+    type: EventName<"tool_start">;
     toolName: string;
     args?: unknown;
 } | {
-    type: "tool_end";
+    type: EventName<"tool_end">;
     toolName: string;
     args?: unknown;
     result?: ToolCallResult;
     isError?: boolean;
 } | {
-    type: "text_delta";
+    type: EventName<"text_delta">;
     delta: string;
 } | {
-    type: "thinking_delta";
+    type: EventName<"thinking_delta">;
     delta: string;
 } | {
-    type: "turn_end";
+    type: EventName<"turn_end">;
     summary?: string;
 } | {
-    type: "message_end";
+    type: EventName<"message_end">;
     usage?: AgentUsage;
     error?: string;
 } | {
-    type: "compaction";
+    type: EventName<"compaction">;
 } | {
-    type: "activity";
+    type: EventName<"activity">;
 } | {
-    type: "error";
+    type: EventName<"error">;
     message: string;
 };
+/**
+ * 事件类型词表（协议事件全集 9 种，运行时 SSOT）：schema 事件 `type.enum` 从本表
+ * 派生（schema.ts），测试取值遍历本表（protocol-schema.test.ts / contract-closure.test.ts）
+ * ——新增事件变体不再手写第三处。
+ *
+ * 每个成员必须带一行 `// noop-safe: <论证>`：未知成员宽容语义四行①（ADR-0071）的
+ * 逐变体登记——旧宿主 reducer 遇未知 event.type 走 default 分支零写入，标记后写
+ * 「本变体被丢弃时状态无损」的一行论证（no-op 安全性属运行时消费语义，不可静态
+ * 判定——守卫只查标记存在不查内容，落点 contract-closure.test.ts「noop-safe 标记守卫」）。
+ *
+ * 编译锁（漏改任一侧 typecheck 红，且错误指向漏点）：
+ *   ① union 侧——成员 type 必须经 `EventName<"x">` 取名（约束 = 本词表）：union 加
+ *      成员不登词表 → TS2344 直接落在漏改的成员行；
+ *   ② 词表侧——`satisfies readonly AgentEvent["type"][]`：词表加成员不加 union
+ *      → 错误直接落在词表漏改的成员行；
+ *   ③ 兜底——成员绕过 EventName 约束裸加字面量 → _EventVocabSyncLock 爆红。
+ * 新增事件变体的同步面分两层，漏改任一处 typecheck 均红且精确指路（验收 A1 演练
+ * 实证）：协议面两笔（词表 + union）即协议面全同步——schema enum 与遍历型测试断言
+ * 自动跟随；同仓消费面另有两处编译期同步点——journal-replay reducer case（穷尽
+ * switch never 检查）与 contract-closure 构造冒烟（Record<AgentEventTypeName,…>
+ * 漏键爆红）。不 bump 版本、不改任何引擎（演进政策 additive 面，判据全文见头注）。
+ */
+declare const AGENT_EVENT_TYPE_NAMES: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error"];
+/** 词表派生的事件名联合（编译锁②/③的词表侧源；schema enum 与测试取值同源）。 */
+type AgentEventTypeName = (typeof AGENT_EVENT_TYPE_NAMES)[number];
+/**
+ * 词表约束的事件 type 字面量（编译锁①）：union 成员经 `EventName<"x">` 取名，
+ * 词表漏登时 typecheck 错误落在该成员行。类型恒等（解析为同一字面量），
+ * 结构与运行时语义零变化。
+ */
+type EventName<T extends AgentEventTypeName> = T;
 /**
  * EngineHandle 的持久化形态（JSON v1）。协议 run 终态应答 / read 的
  * handle 载荷（引擎不持有宿主运行时引用，data 即全部）。
@@ -173,7 +206,7 @@ interface EngineCapabilities {
     conversation: "native" | "cold" | "unsupported";
     /** 决定 persona 路由策略（file/flag/prompt 通道）。 */
     personaInjection: "file" | "flag" | "prompt";
-    /** 粗粒度引擎：GUI 显示降级为阶段态。 */
+    /** 粗粒度引擎：GUI 显示降级为阶段态。判据 5 回指：被 streamMode 键消费（degradable 先例）。 */
     eventGranularity: "stream" | "coarse";
     /** emulated = worktree 隔离（无 OS sandbox 的引擎用文件写维度隔离补齐）。 */
     sandbox: "native" | "emulated" | "none";
@@ -336,4 +369,4 @@ interface AgentCallOpts {
     permissionMode?: string;
 }
 
-export type { AgentCallOpts as A, EngineCapabilities as E, InternalToolCall as I, ModelCatalogEntry as M, ProbeReport as P, ReplayedTurn as R, SessionView as S, ToolCall as T, WorktreeHandle as W, AgentEvent as a, AgentFailureKind as b, AgentOutcome as c, AgentOutcomeUsage as d, AgentUsage as e, AgentUsageTotal as f, AssertMutuallyAssignable as g, EngineHandleData as h, ResumeAnchor as i, ToolCallEntry as j, ToolCallResult as k, Turn as l };
+export { AGENT_EVENT_TYPE_NAMES as A, type EngineCapabilities as E, type InternalToolCall as I, type ModelCatalogEntry as M, type ProbeReport as P, type ReplayedTurn as R, type SessionView as S, type ToolCall as T, type WorktreeHandle as W, type AgentCallOpts as a, type AgentEvent as b, type AgentEventTypeName as c, type AgentFailureKind as d, type AgentOutcome as e, type AgentOutcomeUsage as f, type AgentUsage as g, type AgentUsageTotal as h, type AssertMutuallyAssignable as i, type EngineHandleData as j, type ResumeAnchor as k, type ToolCallEntry as l, type ToolCallResult as m, type Turn as n };

package/dist/{contract-types-Dsvy79r3.d.ts → contract-types-DaULkdpG.d.ts}

@@ -62,38 +62,71 @@ interface Turn {
  * activity = 纯活性信号：双侧 reducer no-op、不开 turn、不写状态、不落 journal
  * （core journal-wiring 对其豁免 append），只承诺「引擎活跃时周期性出现」——供宿主
  * 无进展守护刷新判活（长工具执行期）。节流属生产者实现细节，不进协议承诺。
+ *
+ * 每个成员的 type 经 `EventName<"…">` 受词表约束（编译锁①，见下方词表节）。
  */
 type AgentEvent = {
-    type: "tool_start";
+    type: EventName<"tool_start">;
     toolName: string;
     args?: unknown;
 } | {
-    type: "tool_end";
+    type: EventName<"tool_end">;
     toolName: string;
     args?: unknown;
     result?: ToolCallResult;
     isError?: boolean;
 } | {
-    type: "text_delta";
+    type: EventName<"text_delta">;
     delta: string;
 } | {
-    type: "thinking_delta";
+    type: EventName<"thinking_delta">;
     delta: string;
 } | {
-    type: "turn_end";
+    type: EventName<"turn_end">;
     summary?: string;
 } | {
-    type: "message_end";
+    type: EventName<"message_end">;
     usage?: AgentUsage;
     error?: string;
 } | {
-    type: "compaction";
+    type: EventName<"compaction">;
 } | {
-    type: "activity";
+    type: EventName<"activity">;
 } | {
-    type: "error";
+    type: EventName<"error">;
     message: string;
 };
+/**
+ * 事件类型词表（协议事件全集 9 种，运行时 SSOT）：schema 事件 `type.enum` 从本表
+ * 派生（schema.ts），测试取值遍历本表（protocol-schema.test.ts / contract-closure.test.ts）
+ * ——新增事件变体不再手写第三处。
+ *
+ * 每个成员必须带一行 `// noop-safe: <论证>`：未知成员宽容语义四行①（ADR-0071）的
+ * 逐变体登记——旧宿主 reducer 遇未知 event.type 走 default 分支零写入，标记后写
+ * 「本变体被丢弃时状态无损」的一行论证（no-op 安全性属运行时消费语义，不可静态
+ * 判定——守卫只查标记存在不查内容，落点 contract-closure.test.ts「noop-safe 标记守卫」）。
+ *
+ * 编译锁（漏改任一侧 typecheck 红，且错误指向漏点）：
+ *   ① union 侧——成员 type 必须经 `EventName<"x">` 取名（约束 = 本词表）：union 加
+ *      成员不登词表 → TS2344 直接落在漏改的成员行；
+ *   ② 词表侧——`satisfies readonly AgentEvent["type"][]`：词表加成员不加 union
+ *      → 错误直接落在词表漏改的成员行；
+ *   ③ 兜底——成员绕过 EventName 约束裸加字面量 → _EventVocabSyncLock 爆红。
+ * 新增事件变体的同步面分两层，漏改任一处 typecheck 均红且精确指路（验收 A1 演练
+ * 实证）：协议面两笔（词表 + union）即协议面全同步——schema enum 与遍历型测试断言
+ * 自动跟随；同仓消费面另有两处编译期同步点——journal-replay reducer case（穷尽
+ * switch never 检查）与 contract-closure 构造冒烟（Record<AgentEventTypeName,…>
+ * 漏键爆红）。不 bump 版本、不改任何引擎（演进政策 additive 面，判据全文见头注）。
+ */
+declare const AGENT_EVENT_TYPE_NAMES: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error"];
+/** 词表派生的事件名联合（编译锁②/③的词表侧源；schema enum 与测试取值同源）。 */
+type AgentEventTypeName = (typeof AGENT_EVENT_TYPE_NAMES)[number];
+/**
+ * 词表约束的事件 type 字面量（编译锁①）：union 成员经 `EventName<"x">` 取名，
+ * 词表漏登时 typecheck 错误落在该成员行。类型恒等（解析为同一字面量），
+ * 结构与运行时语义零变化。
+ */
+type EventName<T extends AgentEventTypeName> = T;
 /**
  * EngineHandle 的持久化形态（JSON v1）。协议 run 终态应答 / read 的
  * handle 载荷（引擎不持有宿主运行时引用，data 即全部）。
@@ -173,7 +206,7 @@ interface EngineCapabilities {
     conversation: "native" | "cold" | "unsupported";
     /** 决定 persona 路由策略（file/flag/prompt 通道）。 */
     personaInjection: "file" | "flag" | "prompt";
-    /** 粗粒度引擎：GUI 显示降级为阶段态。 */
+    /** 粗粒度引擎：GUI 显示降级为阶段态。判据 5 回指：被 streamMode 键消费（degradable 先例）。 */
     eventGranularity: "stream" | "coarse";
     /** emulated = worktree 隔离（无 OS sandbox 的引擎用文件写维度隔离补齐）。 */
     sandbox: "native" | "emulated" | "none";
@@ -336,4 +369,4 @@ interface AgentCallOpts {
     permissionMode?: string;
 }
 
-export type { AgentCallOpts as A, EngineCapabilities as E, InternalToolCall as I, ModelCatalogEntry as M, ProbeReport as P, ReplayedTurn as R, SessionView as S, ToolCall as T, WorktreeHandle as W, AgentEvent as a, AgentFailureKind as b, AgentOutcome as c, AgentOutcomeUsage as d, AgentUsage as e, AgentUsageTotal as f, AssertMutuallyAssignable as g, EngineHandleData as h, ResumeAnchor as i, ToolCallEntry as j, ToolCallResult as k, Turn as l };
+export { AGENT_EVENT_TYPE_NAMES as A, type EngineCapabilities as E, type InternalToolCall as I, type ModelCatalogEntry as M, type ProbeReport as P, type ReplayedTurn as R, type SessionView as S, type ToolCall as T, type WorktreeHandle as W, type AgentCallOpts as a, type AgentEvent as b, type AgentEventTypeName as c, type AgentFailureKind as d, type AgentOutcome as e, type AgentOutcomeUsage as f, type AgentUsage as g, type AgentUsageTotal as h, type AssertMutuallyAssignable as i, type EngineHandleData as j, type ResumeAnchor as k, type ToolCallEntry as l, type ToolCallResult as m, type Turn as n };

package/dist/env.cjs

@@ -87,7 +87,11 @@ var ENGINE_ENV_DENY_LIST = [
   "TAIJI_RUNTIME_TOKEN",
   "TAIJI_AGENT_API_KEY",
   "TAIJI_SUBAGENT_RELAY_SESSION_ID",
-  "TAIJI_SUBAGENT_RELAY_RECORD_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 = [
   "TAIJI_AGENT_DATA_DIR",

package/dist/env.js

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

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

@@ -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.js';
 
 /** 协议错误对象（error 帧载荷与反向请求错误应答共用形态）。 */
 interface ProtocolError {
@@ -50,7 +50,7 @@ type ReverseResponseResult =
  | {
     ack: true;
 }
-/** 未实现的交互能力（设计：未实现回 unsupported，引擎自行降级）。 */
+/** 未实现或宿主未知的通道（宽容语义③：由 askUser 语境泛化到全通道——宿主对未知 host/* 通道回 unsupported，引擎自行降级）。 */
  | {
     unsupported: true;
 };

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

@@ -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.cjs';
 
 /** 协议错误对象（error 帧载荷与反向请求错误应答共用形态）。 */
 interface ProtocolError {
@@ -50,7 +50,7 @@ type ReverseResponseResult =
  | {
     ack: true;
 }
-/** 未实现的交互能力（设计：未实现回 unsupported，引擎自行降级）。 */
+/** 未实现或宿主未知的通道（宽容语义③：由 askUser 语境泛化到全通道——宿主对未知 host/* 通道回 unsupported，引擎自行降级）。 */
  | {
     unsupported: true;
 };

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,
@@ -6616,6 +6617,8 @@ __export(src_exports, {
   STDOUT_TAIL_ECHO_CHARS: () => STDOUT_TAIL_ECHO_CHARS,
   SUPPORTED_PROTOCOL_RANGE: () => SUPPORTED_PROTOCOL_RANGE,
   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,
@@ -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]
             }
           }
         }
@@ -7694,7 +7711,11 @@ var ENGINE_ENV_DENY_LIST = [
   "TAIJI_RUNTIME_TOKEN",
   "TAIJI_AGENT_API_KEY",
   "TAIJI_SUBAGENT_RELAY_SESSION_ID",
-  "TAIJI_SUBAGENT_RELAY_RECORD_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 = [
   "TAIJI_AGENT_DATA_DIR",
@@ -8139,6 +8160,10 @@ 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 = "TAIJI_SUBAGENT_RELAY_SOCKET";
 var RELAY_ENV_NODE = "TAIJI_SUBAGENT_RELAY_NODE";
@@ -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,
@@ -8308,6 +8334,8 @@ function runEngineCliEntry(opts) {
   STDOUT_TAIL_ECHO_CHARS,
   SUPPORTED_PROTOCOL_RANGE,
   TAIJI_DATA_DIR_ENV,
+  ZCODE_HOST_DB_SUFFIX,
+  ZCODE_ISOLATED_DB_SEGMENTS,
   abortWithFallback,
   aggregateUsage,
   armEngineSelfDestruct,

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 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-pT7RYTqQ.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';
@@ -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,6 +1,6 @@
 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-DMGeUUUm.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';
@@ -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';

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,
@@ -31,7 +35,7 @@ import {
   ENGINE_ENV_PREFIXES,
   buildEngineChildEnv,
   buildOutboundChildEnv
-} from "./chunk-M3SZTDNQ.js";
+} from "./chunk-YL5W5EMV.js";
 import {
   DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS,
   ENGINE_HOST_REQUEST_TIMEOUT_ENV,
@@ -69,6 +73,7 @@ import {
   readRelayForwardEnv
 } 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,
@@ -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,
@@ -198,6 +204,8 @@ export {
   STDOUT_TAIL_ECHO_CHARS,
   SUPPORTED_PROTOCOL_RANGE,
   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-pT7RYTqQ.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-DMGeUUUm.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/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,
@@ -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,6 +1,6 @@
-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';
+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 `taiji.subagentEngine.protocol` 与 initialize 应答同值）。 */
@@ -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,6 +1,6 @@
-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';
+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 `taiji.subagentEngine.protocol` 与 initialize 应答同值）。 */
@@ -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,
@@ -43,6 +44,7 @@ import {
 } 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/zcode-db-paths.cjs

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/zcode-db-paths.ts
+var zcode_db_paths_exports = {};
+__export(zcode_db_paths_exports, {
+  ZCODE_HOST_DB_SUFFIX: () => ZCODE_HOST_DB_SUFFIX,
+  ZCODE_ISOLATED_DB_SEGMENTS: () => ZCODE_ISOLATED_DB_SEGMENTS
+});
+module.exports = __toCommonJS(zcode_db_paths_exports);
+var ZCODE_HOST_DB_SUFFIX = [".zcode", "cli", "db", "db.sqlite"];
+var ZCODE_ISOLATED_DB_SEGMENTS = ["engines", "zcode", "session-db", "db.sqlite"];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ZCODE_HOST_DB_SUFFIX,
+  ZCODE_ISOLATED_DB_SEGMENTS
+});

package/dist/zcode-db-paths.d.cts

@@ -0,0 +1,15 @@
+/**
+ * 宿主 HOME 下 zcode 会话库相对段（`~/.zcode/cli/db/db.sqlite`，绝对路径 =
+ * join(os.homedir(), ...suffix)）。2026-09 会话库隔离后定位为「存量兼容锚点」：
+ * 新 handle.dbPath 恒为隔离库路径（ZCODE_ISOLATED_DB_SEGMENTS），本段仅用于
+ * 白名单集合第二项放行「共享 HOME 时代」record 已落盘的宿主绝对路径。
+ */
+declare const ZCODE_HOST_DB_SUFFIX: readonly [".zcode", "cli", "db", "db.sqlite"];
+/**
+ * 隔离会话库相对段（`<dataDir>/engines/zcode/session-db/db.sqlite`，绝对路径 =
+ * join(dataDir, ...segments)）。选址在 journal 池目录（`engines/zcode/shared/`）
+ * 之外——池 TTL 清理不得触及会话库（设计 D1/F11）。
+ */
+declare const ZCODE_ISOLATED_DB_SEGMENTS: readonly ["engines", "zcode", "session-db", "db.sqlite"];
+
+export { ZCODE_HOST_DB_SUFFIX, ZCODE_ISOLATED_DB_SEGMENTS };

package/dist/zcode-db-paths.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 宿主 HOME 下 zcode 会话库相对段（`~/.zcode/cli/db/db.sqlite`，绝对路径 =
+ * join(os.homedir(), ...suffix)）。2026-09 会话库隔离后定位为「存量兼容锚点」：
+ * 新 handle.dbPath 恒为隔离库路径（ZCODE_ISOLATED_DB_SEGMENTS），本段仅用于
+ * 白名单集合第二项放行「共享 HOME 时代」record 已落盘的宿主绝对路径。
+ */
+declare const ZCODE_HOST_DB_SUFFIX: readonly [".zcode", "cli", "db", "db.sqlite"];
+/**
+ * 隔离会话库相对段（`<dataDir>/engines/zcode/session-db/db.sqlite`，绝对路径 =
+ * join(dataDir, ...segments)）。选址在 journal 池目录（`engines/zcode/shared/`）
+ * 之外——池 TTL 清理不得触及会话库（设计 D1/F11）。
+ */
+declare const ZCODE_ISOLATED_DB_SEGMENTS: readonly ["engines", "zcode", "session-db", "db.sqlite"];
+
+export { ZCODE_HOST_DB_SUFFIX, ZCODE_ISOLATED_DB_SEGMENTS };

package/dist/zcode-db-paths.js

@@ -0,0 +1,9 @@
+import {
+  ZCODE_HOST_DB_SUFFIX,
+  ZCODE_ISOLATED_DB_SEGMENTS
+} from "./chunk-CT3FEBDO.js";
+import "./chunk-JSBRDJBE.js";
+export {
+  ZCODE_HOST_DB_SUFFIX,
+  ZCODE_ISOLATED_DB_SEGMENTS
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/subagent-engine-sdk",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "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",