@zhushanwen/subagent-engine-sdk 0.5.0 → 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-7I4XGL5J.js → chunk-BBWUC2EE.js}

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

package/dist/{chunk-3K2P2CM2.js → chunk-CNQTJJF5.js}

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

package/dist/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-DSQ7JQKM.js → chunk-GSW3DMN6.js}

@@ -1,9 +1,9 @@
 // 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 = {
   /** 握手被拒：协议版本不匹配（安装损坏，重装应用）。 */

package/dist/{chunk-HYES77BR.js → chunk-MSAJXIP4.js}

@@ -18,8 +18,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/{chunk-WORT4PG7.js → chunk-QOEXD2FT.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-PYO3YR7W.js";
 import {
   engineTimeoutDetail
-} from "./chunk-F5JZMK74.js";
+} from "./chunk-WMDMXP2F.js";
 import {
   getLogger
 } from "./chunk-75QEMUGV.js";

package/dist/{chunk-3IBT7MTB.js → chunk-W3BKI2BP.js}

@@ -1,10 +1,10 @@
 import {
   EngineSdkError
-} from "./chunk-F5JZMK74.js";
+} from "./chunk-WMDMXP2F.js";
 
 // src/node-executor.ts
 import { spawn } from "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) => {
@@ -64,7 +64,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/{chunk-F5JZMK74.js → chunk-WMDMXP2F.js}

@@ -17,7 +17,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/error-codes.ts
@@ -71,7 +71,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" }
   );
 }

package/dist/{chunk-GT6YLLN4.js → chunk-X24IVQKJ.js}

@@ -4,7 +4,7 @@ import {
 
 // src/data-dir.ts
 var logger = 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);
@@ -18,19 +18,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;
@@ -40,7 +40,7 @@ function defaultWarn(msg) {
 }
 
 export {
-  XYZ_DATA_DIR_ENV,
+  TAIJI_DATA_DIR_ENV,
   resetDataDirWarnForTests,
   resolveEngineDataDir
 };

package/dist/{chunk-365AUV6N.js → chunk-YE472JOO.js}

@@ -1,6 +1,6 @@
 // src/nesting-guard.ts
 import { AsyncLocalStorage } from "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 {
@@ -9,7 +9,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/{chunk-BBVZK5DL.js → chunk-YL5W5EMV.js}

@@ -5,25 +5,29 @@ import {
 // 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) {
@@ -73,14 +77,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/{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/data-dir.cjs

@@ -20,7 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/data-dir.ts
 var data_dir_exports = {};
 __export(data_dir_exports, {
-  XYZ_DATA_DIR_ENV: () => XYZ_DATA_DIR_ENV,
+  TAIJI_DATA_DIR_ENV: () => TAIJI_DATA_DIR_ENV,
   resetDataDirWarnForTests: () => resetDataDirWarnForTests,
   resolveEngineDataDir: () => resolveEngineDataDir
 });
@@ -75,7 +75,7 @@ function getLogger(component) {
 
 // src/data-dir.ts
 var logger = 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);
@@ -89,19 +89,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;
@@ -111,7 +111,7 @@ function defaultWarn(msg) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  XYZ_DATA_DIR_ENV,
+  TAIJI_DATA_DIR_ENV,
   resetDataDirWarnForTests,
   resolveEngineDataDir
 });

package/dist/data-dir.d.cts

@@ -1,10 +1,10 @@
-/** xyz-agent 数据目录 env 名（与 packages/shared/src/paths.ts 的 SSOT 变量同名）。 */
-declare const XYZ_DATA_DIR_ENV = "XYZ_AGENT_DATA_DIR";
+/** taiji 数据目录 env 名（与 packages/shared/src/paths.ts 的 SSOT 变量同名）。 */
+declare const TAIJI_DATA_DIR_ENV = "TAIJI_AGENT_DATA_DIR";
 /** 测试隔离专用：重置 warn-once 标记（生产禁用）。 */
 declare function resetDataDirWarnForTests(): void;
 /**
  * 解析引擎数据目录（journal 落盘 / 隔离池的根）：
- *   1. env[XYZ_AGENT_DATA_DIR]（宿主注入，权威通道）；
+ *   1. env[TAIJI_AGENT_DATA_DIR]（宿主注入，权威通道）；
  *   2. 缺失 + opts.fallbackDataRoot 显式传入（宿主解析过的数据根）→ 用之 + warn 一次
  *      （非权威通道回退必须可观测——journal 落点变化不留静默漂移）；
  *   3. 两者皆缺 → 抛错（engine_not_found 语义：错误含 env 名、期望值示例与恢复动作；
@@ -17,4 +17,4 @@ declare function resolveEngineDataDir(env: NodeJS.ProcessEnv, opts?: {
     warn?: (msg: string) => void;
 }): string;
 
-export { XYZ_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir };
+export { TAIJI_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir };

package/dist/data-dir.d.ts

@@ -1,10 +1,10 @@
-/** xyz-agent 数据目录 env 名（与 packages/shared/src/paths.ts 的 SSOT 变量同名）。 */
-declare const XYZ_DATA_DIR_ENV = "XYZ_AGENT_DATA_DIR";
+/** taiji 数据目录 env 名（与 packages/shared/src/paths.ts 的 SSOT 变量同名）。 */
+declare const TAIJI_DATA_DIR_ENV = "TAIJI_AGENT_DATA_DIR";
 /** 测试隔离专用：重置 warn-once 标记（生产禁用）。 */
 declare function resetDataDirWarnForTests(): void;
 /**
  * 解析引擎数据目录（journal 落盘 / 隔离池的根）：
- *   1. env[XYZ_AGENT_DATA_DIR]（宿主注入，权威通道）；
+ *   1. env[TAIJI_AGENT_DATA_DIR]（宿主注入，权威通道）；
  *   2. 缺失 + opts.fallbackDataRoot 显式传入（宿主解析过的数据根）→ 用之 + warn 一次
  *      （非权威通道回退必须可观测——journal 落点变化不留静默漂移）；
  *   3. 两者皆缺 → 抛错（engine_not_found 语义：错误含 env 名、期望值示例与恢复动作；
@@ -17,4 +17,4 @@ declare function resolveEngineDataDir(env: NodeJS.ProcessEnv, opts?: {
     warn?: (msg: string) => void;
 }): string;
 
-export { XYZ_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir };
+export { TAIJI_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir };

package/dist/data-dir.js

@@ -1,12 +1,12 @@
 import {
-  XYZ_DATA_DIR_ENV,
+  TAIJI_DATA_DIR_ENV,
   resetDataDirWarnForTests,
   resolveEngineDataDir
-} from "./chunk-GT6YLLN4.js";
+} from "./chunk-X24IVQKJ.js";
 import "./chunk-75QEMUGV.js";
 import "./chunk-JSBRDJBE.js";
 export {
-  XYZ_DATA_DIR_ENV,
+  TAIJI_DATA_DIR_ENV,
   resetDataDirWarnForTests,
   resolveEngineDataDir
 };