@zhushanwen/subagent-engine-sdk 0.10.1 → 0.12.0

package/dist/protocol/index.cjs

@@ -26,8 +26,16 @@ __export(protocol_exports, {
   ENGINE_PROTOCOL_ERROR_CODES: () => ENGINE_PROTOCOL_ERROR_CODES,
   ENGINE_PROTOCOL_SCHEMAS: () => ENGINE_PROTOCOL_SCHEMAS,
   ENGINE_PROTOCOL_VERSION: () => ENGINE_PROTOCOL_VERSION,
+  ENGINE_SPAWN_DELIVERY_ERROR_CODES: () => ENGINE_SPAWN_DELIVERY_ERROR_CODES,
+  ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY: () => ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY,
   ENGINE_TIMEOUT_RECOVERY: () => ENGINE_TIMEOUT_RECOVERY,
+  ENGINE_TRANSPORT_ERROR_CODES: () => ENGINE_TRANSPORT_ERROR_CODES,
+  ENGINE_TRANSPORT_ERROR_RECOVERY: () => ENGINE_TRANSPORT_ERROR_RECOVERY,
   EngineSdkError: () => EngineSdkError,
+  FAILURE_CAUSE_CLOSED_KINDS: () => FAILURE_CAUSE_CLOSED_KINDS,
+  FAILURE_CAUSE_KINDS_BY_CLASS: () => FAILURE_CAUSE_KINDS_BY_CLASS,
+  FAILURE_CAUSE_KINDS_BY_CLASS_LOCK: () => FAILURE_CAUSE_KINDS_BY_CLASS_LOCK,
+  FAILURE_CAUSE_KIND_VOCAB_LOCK: () => FAILURE_CAUSE_KIND_VOCAB_LOCK,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS: () => FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   HANDSHAKE_TIMEOUT_MS: () => HANDSHAKE_TIMEOUT_MS,
   PROTOCOL_METHODS: () => PROTOCOL_METHODS,
@@ -40,7 +48,11 @@ __export(protocol_exports, {
   SET_MODEL_STAGE_TIMEOUT_MS: () => SET_MODEL_STAGE_TIMEOUT_MS,
   STDERR_TAIL_CHARS: () => STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS: () => STDOUT_TAIL_ECHO_CHARS,
+  SUBAGENT_CONTROL_CLOSED_REASONS: () => SUBAGENT_CONTROL_CLOSED_REASONS,
+  SUBAGENT_CONTROL_FRAME_KINDS: () => SUBAGENT_CONTROL_FRAME_KINDS,
+  SUBAGENT_CONTROL_PROTOCOL_VERSION: () => SUBAGENT_CONTROL_PROTOCOL_VERSION,
   SUPPORTED_PROTOCOL_RANGE: () => SUPPORTED_PROTOCOL_RANGE,
+  _EventVocabSyncLock: () => _EventVocabSyncLock,
   assertChatConversationSupported: () => assertChatConversationSupported,
   engineConversationUnsupportedError: () => engineConversationUnsupportedError,
   engineProtocolMismatchError: () => engineProtocolMismatchError,
@@ -54,6 +66,8 @@ __export(protocol_exports, {
   isRequestFrame: () => isRequestFrame,
   isResponseFrame: () => isResponseFrame,
   isReverseRequestFrame: () => isReverseRequestFrame,
+  isSubagentControlClosedReason: () => isSubagentControlClosedReason,
+  isSubagentControlFrameKind: () => isSubagentControlFrameKind,
   notificationFrameSchema: () => notificationFrameSchema,
   protocolErrorSchema: () => protocolErrorSchema,
   requestFrameSchema: () => requestFrameSchema,
@@ -132,6 +146,30 @@ var REVERSE_CHANNEL_TIMEOUT_CLASS = {
 };
 
 // src/protocol/error-codes.ts
+var ENGINE_SPAWN_DELIVERY_ERROR_CODES = [
+  "engine_prompt_not_delivered",
+  "engine_prompt_rejected",
+  "engine_spawn_handshake_timeout"
+];
+var ENGINE_TRANSPORT_ERROR_CODES = [
+  "engine_transport_unavailable",
+  "engine_transport_lost",
+  "engine_open_timeout",
+  "engine_frame_too_large",
+  "engine_backpressure_overflow"
+];
+var ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY = {
+  engine_prompt_not_delivered: "The task never reached the child pi (zero stdout after the prompt write, or the engine stdin was unavailable). Re-run the task; if it recurs, inspect the engine/pi logs (the failure carries the delivery diagnostics) and the runtime log.",
+  engine_prompt_rejected: "The child pi explicitly rejected the prompt command (success:false). Check the pi-side reason carried in the error detail (busy/queue/extension takeover states are reported by pi itself), then re-run.",
+  engine_spawn_handshake_timeout: "The engine spawn handshake did not complete in time. Check the runtime log for a spawn/handshake stall, then restart taiji and re-run the task."
+};
+var ENGINE_TRANSPORT_ERROR_RECOVERY = {
+  engine_transport_unavailable: "The runtime control socket is unreachable (connect or hello failed). The runtime side is failing explicitly instead of silently falling back to local spawn \u2014 restart taiji and re-run the task.",
+  engine_transport_lost: "The control connection to the runtime was lost mid-flight (runtime restart or crash). In-flight requests were rejected; restart taiji (or wait for the runtime to come back) and re-run the task \u2014 the connection is not retried in place.",
+  engine_open_timeout: "The runtime did not finish opening the engine channel in time (spawn/attribution stalled). Check the runtime log (engine opened / kill decision lines), then re-run the task.",
+  engine_frame_too_large: "A single frame exceeded the control-plane size limit and the channel was closed without truncation. Shrink the task/result payload (e.g. point the agent at files instead of inlining them) and re-run.",
+  engine_backpressure_overflow: "The control-plane write queue overflowed (engine consumed frames too slowly) and the overflowed scope was torn down without dropping frames silently. Re-run the task; if it recurs, reduce concurrent subagent fan-out."
+};
 var SET_MODEL_ERROR_CODES = [
   /** 目标模型不在当前进程快照（子进程模型快照冻结于 spawn 时刻——模型本身有效，
    *  下一轮 spawn 现取目录即可用；宿主按「写覆盖意图」处置，设计 §7.2 快照型失败行）。 */
@@ -176,7 +214,7 @@ var EngineSdkError = class extends Error {
     this.recovery = recovery;
     this.data = data;
   }
-  /** 协议 error 帧载荷投影。 */
+  /** 协议 error 帧载荷派生视图。 */
   toStructured() {
     return { code: this.code, message: this.message, recovery: this.recovery, data: this.data };
   }
@@ -227,12 +265,39 @@ 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/control-protocol.ts
+var SUBAGENT_CONTROL_PROTOCOL_VERSION = 1;
+var SUBAGENT_CONTROL_FRAME_KINDS = {
+  hello: "hello",
+  helloOk: "hello_ok",
+  helloReject: "hello_reject",
+  engineOpen: "engine_open",
+  engineOpened: "engine_opened",
+  engineOpenFailed: "engine_open_failed",
+  engineFrame: "engine_frame",
+  engineClose: "engine_close",
+  engineClosed: "engine_closed",
+  error: "error"
+};
+function isSubagentControlFrameKind(value) {
+  return typeof value === "string" && Object.values(SUBAGENT_CONTROL_FRAME_KINDS).includes(value);
+}
+var SUBAGENT_CONTROL_CLOSED_REASONS = {
+  engineExit: "engine_exit",
+  engineSignal: "engine_signal",
+  killedByControl: "killed_by_control",
+  openTimeout: "open_timeout"
+};
+function isSubagentControlClosedReason(value) {
+  return typeof value === "string" && Object.values(SUBAGENT_CONTROL_CLOSED_REASONS).includes(value);
+}
+
 // 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 承担
+  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺 result，turn 收尾由 turn_end/message_end 承担
   "text_delta",
   // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺正文增量，不产生半解析状态
   "thinking_delta",
@@ -240,16 +305,35 @@ var AGENT_EVENT_TYPE_NAMES = [
   "turn_end",
   // noop-safe: 旧宿主 default 分支零写入——丢弃则该 turn 滞留进行态，journal 重放仍按序重建
   "message_end",
-  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺 usage 聚合与闭合计量，已累积内容不回滚
+  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺 usage 聚合与结束计量，已累积内容不回滚
   "compaction",
   // noop-safe: 事件无载荷且现行 reducer 即直接 return——丢弃与处理零差异
   "activity",
   // noop-safe: 纯活性信号，双侧 reducer 恒 no-op（协议语义见 AgentEvent 头注），丢弃零差异
   "error",
   // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺 lastError 诊断留痕，已写状态不回滚
-  "armed"
+  "armed",
   // noop-safe: 旧宿主无武装等待窗消费点（fail-fast 属宿主新增逻辑），丢弃仅缺武装留痕，schema 强制第一道防线（引擎自查断言）不受损
+  "auto_retry"
+  // noop-safe: 旧宿主 default 分支零写入——丢弃仅缺重试边界留痕（journal 不可查失败尝试轨迹），轮成败判定与 turns/usage 计账不受损（P5 计账锚在引擎侧收尾快照，不依赖宿主消费本帧）
 ];
+var _EventVocabSyncLock = true;
+var FAILURE_CAUSE_CLOSED_KINDS = [
+  "rate_limited",
+  "protocol_unsupported",
+  "turn_budget_exhausted",
+  "timeout",
+  "no_deliverable",
+  "cancelled"
+];
+var FAILURE_CAUSE_KIND_VOCAB_LOCK = true;
+var FAILURE_CAUSE_KINDS_BY_CLASS = {
+  provider: ["rate_limited", "protocol_unsupported"],
+  harness: ["turn_budget_exhausted", "timeout"],
+  agent: ["no_deliverable"],
+  user: ["cancelled"]
+};
+var FAILURE_CAUSE_KINDS_BY_CLASS_LOCK = true;
 
 // src/protocol/schema.ts
 var ANY_JSON = {};
@@ -322,7 +406,7 @@ var notificationFrameSchema = {
             type: {
               type: "string",
               // 事件 enum 从词表 SSOT 派生（U2 词表锁：union⟷词表互证后，此处不再
-              // 手写字面量集合——手写即漂移面，病灶 1 的第三处同步点）
+              // 手写字面量集合——手写即漂移点，问题点 1 的第三处同步点）
               enum: [...AGENT_EVENT_TYPE_NAMES]
             }
           }
@@ -387,8 +471,16 @@ var runSessionParamsSchema = {
   ENGINE_PROTOCOL_ERROR_CODES,
   ENGINE_PROTOCOL_SCHEMAS,
   ENGINE_PROTOCOL_VERSION,
+  ENGINE_SPAWN_DELIVERY_ERROR_CODES,
+  ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY,
   ENGINE_TIMEOUT_RECOVERY,
+  ENGINE_TRANSPORT_ERROR_CODES,
+  ENGINE_TRANSPORT_ERROR_RECOVERY,
   EngineSdkError,
+  FAILURE_CAUSE_CLOSED_KINDS,
+  FAILURE_CAUSE_KINDS_BY_CLASS,
+  FAILURE_CAUSE_KINDS_BY_CLASS_LOCK,
+  FAILURE_CAUSE_KIND_VOCAB_LOCK,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   HANDSHAKE_TIMEOUT_MS,
   PROTOCOL_METHODS,
@@ -401,7 +493,11 @@ var runSessionParamsSchema = {
   SET_MODEL_STAGE_TIMEOUT_MS,
   STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS,
+  SUBAGENT_CONTROL_CLOSED_REASONS,
+  SUBAGENT_CONTROL_FRAME_KINDS,
+  SUBAGENT_CONTROL_PROTOCOL_VERSION,
   SUPPORTED_PROTOCOL_RANGE,
+  _EventVocabSyncLock,
   assertChatConversationSupported,
   engineConversationUnsupportedError,
   engineProtocolMismatchError,
@@ -415,6 +511,8 @@ var runSessionParamsSchema = {
   isRequestFrame,
   isResponseFrame,
   isReverseRequestFrame,
+  isSubagentControlClosedReason,
+  isSubagentControlFrameKind,
   notificationFrameSchema,
   protocolErrorSchema,
   requestFrameSchema,

package/dist/protocol/index.d.cts

@@ -1,7 +1,7 @@
-export { a as ENGINE_ERROR_CODE_PREFIX, b as ENGINE_PROTOCOL_ERROR_CODES, c as ENGINE_TIMEOUT_RECOVERY, d as EngineProtocolErrorCode, E 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 SET_MODEL_ERROR_CODES, j as SET_MODEL_NOT_ACTIVE_CODE, k as STDOUT_TAIL_ECHO_CHARS, l as SetModelErrorCode, m as SuccessResponseFrame, n as assertChatConversationSupported, o as engineConversationUnsupportedError, p as engineProtocolMismatchError, q as engineSetModelUnsupportedError, r as engineTimeoutDetail, s as isEngineErrorPassthroughCode, t as isEngineProtocolErrorCode, u as isNotificationFrame, v as isRequestFrame, w as isResponseFrame, x as isReverseRequestFrame, y as schemaEmulationFailedDetail } from '../error-codes-f-UO4a8D.cjs';
-export { C as CancelParams, c as CancelResult, D as DisposeParams, d as DisposeResult, b as InitializeParams, I as InitializeResult, L as ListModelsParams, e as ListModelsResult, P as PROTOCOL_METHODS, f as PingParams, g as PingResult, h as ProbeParams, i as ProtocolMethod, j as ProtocolParamsMap, k as ProtocolResultMap, l as ReadParams, R as RunContextParams, m as RunParams, n as RunResult, o as RunResumeParams, S as SetModelParams, a as SetModelResult, V as ValidateModelParams, p as ValidateModelResult } from '../methods-BLxg4ZFr.cjs';
+export { a as ENGINE_ERROR_CODE_PREFIX, b as ENGINE_PROTOCOL_ERROR_CODES, c as ENGINE_SPAWN_DELIVERY_ERROR_CODES, d as ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY, e as ENGINE_TIMEOUT_RECOVERY, f as ENGINE_TRANSPORT_ERROR_CODES, g as ENGINE_TRANSPORT_ERROR_RECOVERY, h as EngineProtocolErrorCode, E as EngineSdkError, i as EngineSpawnDeliveryErrorCode, j as EngineTransportErrorCode, k as ErrorResponseFrame, l as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, m as ResponseFrame, n as ReverseRequestFrame, o as ReverseResponseResult, S as SET_MODEL_ERROR_CODES, p as SET_MODEL_NOT_ACTIVE_CODE, q as STDOUT_TAIL_ECHO_CHARS, r as SetModelErrorCode, s as SuccessResponseFrame, t as assertChatConversationSupported, u as engineConversationUnsupportedError, v as engineProtocolMismatchError, w as engineSetModelUnsupportedError, x as engineTimeoutDetail, y as isEngineErrorPassthroughCode, z as isEngineProtocolErrorCode, A as isNotificationFrame, B as isRequestFrame, C as isResponseFrame, D as isReverseRequestFrame, F as schemaEmulationFailedDetail } from '../error-codes-CgcjlmeD.cjs';
+export { C as CancelParams, c as CancelResult, D as DisposeParams, d as DisposeResult, b as InitializeParams, I as InitializeResult, L as ListModelsParams, e as ListModelsResult, P as PROTOCOL_METHODS, f as PingParams, g as PingResult, h as ProbeParams, i as ProtocolMethod, j as ProtocolParamsMap, k as ProtocolResultMap, l as ReadParams, R as RunContextParams, m as RunParams, n as RunResult, o as RunResumeParams, S as SetModelParams, a as SetModelResult, V as ValidateModelParams, p as ValidateModelResult } from '../methods-BzvzcCrB.cjs';
 import { UiRequest, UiResponse } from '../ui-types.cjs';
-export { g as AGENT_EVENT_TYPE_NAMES, b as AgentCallOpts, A as AgentEvent, h as AgentEventTypeName, i as AgentFailureKind, c as AgentOutcome, j as AgentOutcomeUsage, k as AgentUsage, a as AgentUsageTotal, l as AssertMutuallyAssignable, d as EngineCapabilities, E as EngineHandleData, m as EngineProcessModel, I as InternalToolCall, f as ModelCatalogEntry, M as ModelRef, P as ProbeReport, R as ReplayedTurn, e as ResumeAnchor, S as SessionView, n as ToolCall, o as ToolCallEntry, p as ToolCallResult, T as Turn, W as WorktreeHandle } from '../contract-types-jSa1g28F.cjs';
+export { h as AGENT_EVENT_TYPE_NAMES, c as AgentCallOpts, A as AgentEvent, i as AgentEventTypeName, j as AgentFailureKind, d as AgentOutcome, k as AgentOutcomeUsage, a as AgentUsage, b as AgentUsageTotal, l as AssertMutuallyAssignable, e as EngineCapabilities, E as EngineHandleData, m as EngineProcessModel, n as EngineStopReason, F as FAILURE_CAUSE_CLOSED_KINDS, o as FAILURE_CAUSE_KINDS_BY_CLASS, p as FAILURE_CAUSE_KINDS_BY_CLASS_LOCK, q as FAILURE_CAUSE_KIND_VOCAB_LOCK, r as FailureCause, s as FailureCauseClass, t as FailureRetryability, I as InternalToolCall, g as ModelCatalogEntry, M as ModelRef, P as ProbeReport, R as ReplayedTurn, f as ResumeAnchor, S as SessionView, u as ToolCall, v as ToolCallEntry, w as ToolCallResult, T as Turn, W as WorktreeHandle, _ as _EventVocabSyncLock } from '../contract-types-C1scOS_M.cjs';
 
 /** 协议版本（引擎包 manifest `taiji.subagentEngine.protocol` 与 initialize 应答同值）。 */
 declare const ENGINE_PROTOCOL_VERSION = 1;
@@ -15,7 +15,7 @@ declare const SUPPORTED_PROTOCOL_RANGE: {
 };
 /** 版本兼容判定（core 握手判据；引擎侧对称用于拒绝过旧/过新宿主）。 */
 declare function isProtocolVersionCompatible(version: number): boolean;
-/** 正向数据面反向请求（帧④数据面类）未应答容忍时长：10s 未答 = 引擎故障 → 杀进程 + 在途 run 失败。 */
+/** 正向数据范围反向请求（帧④数据范围类）未应答容忍时长：10s 未答 = 引擎故障 → 杀进程 + 在途 run 失败。 */
 declare const REVERSE_REQUEST_TIMEOUT_MS = 10000;
 /** initialize 握手超时（ms）：超时 → engine_handshake_timeout，该引擎不可用。 */
 declare const HANDSHAKE_TIMEOUT_MS = 10000;
@@ -24,22 +24,22 @@ declare const CANCEL_SETTLE_GRACE_MS = 3000;
 /**
  * setModel 引擎侧单阶段控制窗（ms）：pi 实现等子进程 `set_model` 应答、等
  * `get_state` 回读各占一窗（设计 subagent-model-switch §7.3——命令与回读全程带
- * 存活检查，超时上限复用现役取消收敛窗量级：控制面单请求 = 秒级）。窗满且进程
+ * 存活检查，超时上限复用现役取消收敛窗量级：控制范围单请求 = 秒级）。窗满且进程
  * 仍存活 → `engine_state_readback_failed`；窗满时进程已退出 → 无活进程形态
  * （`SET_MODEL_NOT_ACTIVE_CODE`）——两种处置不可混淆。
  */
 declare const SET_MODEL_STAGE_TIMEOUT_MS = 3000;
 /**
  * setModel 正向方法的宿主侧单请求上界（ms）：≥ 引擎侧两阶段最坏时延
- * （2 × SET_MODEL_STAGE_TIMEOUT_MS）+ 协议余量；量级锚 = 数据面单请求
- * REVERSE_REQUEST_TIMEOUT_MS 的 10s 先例（控制面单请求必须秒级有界——宿主不悬挂）。
+ * （2 × SET_MODEL_STAGE_TIMEOUT_MS）+ 协议余量；量级锚 = 数据范围单请求
+ * REVERSE_REQUEST_TIMEOUT_MS 的 10s 先例（控制范围单请求必须秒级有界——宿主不悬挂）。
  */
 declare const SET_MODEL_REQUEST_TIMEOUT_MS = 10000;
 /** stderr 内存环形缓冲保留的尾部字符数（engine_crashed 帧携带崩溃现场）。 */
 declare const STDERR_TAIL_CHARS = 400;
 /**
  * 反向请求超时二分（帧④注释，R9-2）：
- * - 数据面类（host/log / host/streamDelta / host/handleReady /
+ * - 数据范围类（host/log / host/streamDelta / host/handleReady /
  *   host/childSpawned / host/childStateChanged）：10s 未答 = 引擎故障；
  * - 人机交互类（host/askUser）：不设统一超时——core 先回 {ack:true}，
  *   结果异步到达；按 ADR-0047「静默 ≠ 卡死」用无进展检测/用户取消，不据此判引擎故障。
@@ -55,11 +55,11 @@ type ReverseChannel = "host/log" | "host/askUser" | "host/streamDelta" | "host/h
  */
 declare const REVERSE_CHANNELS: readonly ["host/log", "host/askUser", "host/streamDelta", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
 /**
- * 超时二分归属（10s 数据面 / 不设统一超时的人机交互面）。实现归 W2 EngineClient；
+ * 超时二分归属（10s 数据范围 / 不设统一超时的人机交互通道）。实现归 W2 EngineClient；
  * 引擎侧自灭计时（W12）复用同表——已 ack 的 askUser 等待不计入 in-flight（R9-2）。
  */
 declare const REVERSE_CHANNEL_TIMEOUT_CLASS: Record<ReverseChannel, ReverseRequestTimeoutClass>;
-/** host/log：引擎日志落宿主日志（对齐 core HostServices.log 调用面）。 */
+/** host/log：引擎日志落宿主日志（对齐 core HostServices.log 调用范围）。 */
 interface HostLogParams {
     level: "debug" | "warn" | "error";
     component: string;
@@ -87,7 +87,7 @@ interface HostStreamDeltaParams {
 /**
  * host/handleReady：运行中句柄回填（core onHandleReady 语义：session/create 应答后、
  * 早于 run resolve；AGENTS.md 关键规则 9「重开 session 仍可见」的前提）。
- * [池抽象降级 2026-09-13] 原 poolKey 字段已随协议面 poolKey 退役删除。
+ * [池抽象降级 2026-09-13] 原 poolKey 字段已随协议范围 poolKey 退役删除。
  */
 interface HostHandleReadyParams {
     runId: string;
@@ -103,7 +103,7 @@ interface HostChildSpawnedParams {
     recordId: string;
 }
 /**
- * host/childStateChanged：childSpawned 的状态面（core 侧镜像数据源，
+ * host/childStateChanged：childSpawned 的状态侧（core 侧镜像数据源，
  * hasLiveProcessHandle/isResumable 同步读镜像，不跨进程查询）。
  * **killed 必含**（判据 `child !== undefined && !child.killed`）——类型层 required。
  */
@@ -117,6 +117,49 @@ interface HostChildStateChangedParams {
     signal?: string;
 }
 
+/** control 协议版本（帧 v 字段；runtime 与 extension 同包分发，未知 v → hello_reject {reason:"version"}，D9 版本矩阵）。 */
+declare const SUBAGENT_CONTROL_PROTOCOL_VERSION = 1;
+/**
+ * 帧 kind 判别值词表（10 成员）。as const 值即字面量类型——类型位置同样可用。
+ * 方向语义见文件头帧表：hello/engine_open/engine_frame/engine_close 为 C→R，
+ * hello_ok/hello_reject/engine_opened/engine_open_failed/engine_closed/error 为 R→C，
+ * engine_frame 双向。
+ */
+declare const SUBAGENT_CONTROL_FRAME_KINDS: {
+    readonly hello: "hello";
+    readonly helloOk: "hello_ok";
+    readonly helloReject: "hello_reject";
+    readonly engineOpen: "engine_open";
+    readonly engineOpened: "engine_opened";
+    readonly engineOpenFailed: "engine_open_failed";
+    readonly engineFrame: "engine_frame";
+    readonly engineClose: "engine_close";
+    readonly engineClosed: "engine_closed";
+    readonly error: "error";
+};
+type SubagentControlFrameKind = (typeof SUBAGENT_CONTROL_FRAME_KINDS)[keyof typeof SUBAGENT_CONTROL_FRAME_KINDS];
+/** unknown → control 帧 kind 收窄（外部输入携带 kind 时的运行时 guard）。 */
+declare function isSubagentControlFrameKind(value: unknown): value is SubagentControlFrameKind;
+/**
+ * engine_closed 帧 reason 值域（引擎通道终局归因，D8/D10）：
+ * - engine_exit：引擎进程自行退出（code 承载退出码）；
+ * - engine_signal：被信号终止（signal 承载信号名）；
+ * - killed_by_control：runtime 主动杀组（engine_close 有界等待超时 / 背压溢出 /
+ *   连接关闭 fan-out 等控制面裁决）；
+ * - open_timeout：engine_open 超时被 runtime 中止杀组（迟到 engine_opened 丢弃）。
+ * 意外退出（engine_exit/engine_signal）→ runtime 无条件 killEngineGroup（D7）；
+ * runtime transport 把 reason 映射进 onExit info（stderrTail 同帧携带）。
+ */
+declare const SUBAGENT_CONTROL_CLOSED_REASONS: {
+    readonly engineExit: "engine_exit";
+    readonly engineSignal: "engine_signal";
+    readonly killedByControl: "killed_by_control";
+    readonly openTimeout: "open_timeout";
+};
+type SubagentControlClosedReason = (typeof SUBAGENT_CONTROL_CLOSED_REASONS)[keyof typeof SUBAGENT_CONTROL_CLOSED_REASONS];
+/** unknown → engine_closed reason 收窄（外部输入携带 reason 时的运行时 guard）。 */
+declare function isSubagentControlClosedReason(value: unknown): value is SubagentControlClosedReason;
+
 /** 协议错误对象 schema。 */
 declare const protocolErrorSchema: {
     readonly $schema: "http://json-schema.org/draft-07/schema#";
@@ -235,7 +278,7 @@ declare const notificationFrameSchema: {
                     readonly properties: {
                         readonly type: {
                             readonly type: "string";
-                            readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed"];
+                            readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed", "auto_retry"];
                         };
                     };
                 };
@@ -355,7 +398,7 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
                         readonly properties: {
                             readonly type: {
                                 readonly type: "string";
-                                readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed"];
+                                readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed", "auto_retry"];
                             };
                         };
                     };
@@ -404,7 +447,7 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
     };
 };
 /**
- * 协议面凭据禁区键名（不变量 5 的测试断言依据）：帧 schema 与深载荷 TS 类型面
+ * 协议范围凭据禁区键名（不变量 5 的测试断言依据）：帧 schema 与深载荷 TS 类型范围
  * 不得出现。词表覆盖常见拼写（子串匹配，非精确枚举）。
  */
 declare const FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS: readonly ["apikey", "api_key", "token", "credential", "password", "secret"];
@@ -446,4 +489,4 @@ declare const runSessionParamsSchema: {
     };
 };
 
-export { CANCEL_SETTLE_GRACE_MS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, type HostAskUserParams, type HostAskUserResult, type HostChildSpawnedParams, type HostChildStateChangedParams, type HostHandleReadyParams, type HostLogParams, type HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReverseChannel, type ReverseRequestTimeoutClass, SET_MODEL_REQUEST_TIMEOUT_MS, SET_MODEL_STAGE_TIMEOUT_MS, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema };
+export { CANCEL_SETTLE_GRACE_MS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, type HostAskUserParams, type HostAskUserResult, type HostChildSpawnedParams, type HostChildStateChangedParams, type HostHandleReadyParams, type HostLogParams, type HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReverseChannel, type ReverseRequestTimeoutClass, SET_MODEL_REQUEST_TIMEOUT_MS, SET_MODEL_STAGE_TIMEOUT_MS, STDERR_TAIL_CHARS, SUBAGENT_CONTROL_CLOSED_REASONS, SUBAGENT_CONTROL_FRAME_KINDS, SUBAGENT_CONTROL_PROTOCOL_VERSION, SUPPORTED_PROTOCOL_RANGE, type SubagentControlClosedReason, type SubagentControlFrameKind, errorResponseFrameSchema, isProtocolVersionCompatible, isSubagentControlClosedReason, isSubagentControlFrameKind, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema };

package/dist/protocol/index.d.ts

@@ -1,7 +1,7 @@
-export { a as ENGINE_ERROR_CODE_PREFIX, b as ENGINE_PROTOCOL_ERROR_CODES, c as ENGINE_TIMEOUT_RECOVERY, d as EngineProtocolErrorCode, E 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 SET_MODEL_ERROR_CODES, j as SET_MODEL_NOT_ACTIVE_CODE, k as STDOUT_TAIL_ECHO_CHARS, l as SetModelErrorCode, m as SuccessResponseFrame, n as assertChatConversationSupported, o as engineConversationUnsupportedError, p as engineProtocolMismatchError, q as engineSetModelUnsupportedError, r as engineTimeoutDetail, s as isEngineErrorPassthroughCode, t as isEngineProtocolErrorCode, u as isNotificationFrame, v as isRequestFrame, w as isResponseFrame, x as isReverseRequestFrame, y as schemaEmulationFailedDetail } from '../error-codes-DnFru4L4.js';
-export { C as CancelParams, c as CancelResult, D as DisposeParams, d as DisposeResult, b as InitializeParams, I as InitializeResult, L as ListModelsParams, e as ListModelsResult, P as PROTOCOL_METHODS, f as PingParams, g as PingResult, h as ProbeParams, i as ProtocolMethod, j as ProtocolParamsMap, k as ProtocolResultMap, l as ReadParams, R as RunContextParams, m as RunParams, n as RunResult, o as RunResumeParams, S as SetModelParams, a as SetModelResult, V as ValidateModelParams, p as ValidateModelResult } from '../methods-C2zvZqhP.js';
+export { a as ENGINE_ERROR_CODE_PREFIX, b as ENGINE_PROTOCOL_ERROR_CODES, c as ENGINE_SPAWN_DELIVERY_ERROR_CODES, d as ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY, e as ENGINE_TIMEOUT_RECOVERY, f as ENGINE_TRANSPORT_ERROR_CODES, g as ENGINE_TRANSPORT_ERROR_RECOVERY, h as EngineProtocolErrorCode, E as EngineSdkError, i as EngineSpawnDeliveryErrorCode, j as EngineTransportErrorCode, k as ErrorResponseFrame, l as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, m as ResponseFrame, n as ReverseRequestFrame, o as ReverseResponseResult, S as SET_MODEL_ERROR_CODES, p as SET_MODEL_NOT_ACTIVE_CODE, q as STDOUT_TAIL_ECHO_CHARS, r as SetModelErrorCode, s as SuccessResponseFrame, t as assertChatConversationSupported, u as engineConversationUnsupportedError, v as engineProtocolMismatchError, w as engineSetModelUnsupportedError, x as engineTimeoutDetail, y as isEngineErrorPassthroughCode, z as isEngineProtocolErrorCode, A as isNotificationFrame, B as isRequestFrame, C as isResponseFrame, D as isReverseRequestFrame, F as schemaEmulationFailedDetail } from '../error-codes-o4rNd1Ee.js';
+export { C as CancelParams, c as CancelResult, D as DisposeParams, d as DisposeResult, b as InitializeParams, I as InitializeResult, L as ListModelsParams, e as ListModelsResult, P as PROTOCOL_METHODS, f as PingParams, g as PingResult, h as ProbeParams, i as ProtocolMethod, j as ProtocolParamsMap, k as ProtocolResultMap, l as ReadParams, R as RunContextParams, m as RunParams, n as RunResult, o as RunResumeParams, S as SetModelParams, a as SetModelResult, V as ValidateModelParams, p as ValidateModelResult } from '../methods-CPMc4cvF.js';
 import { UiRequest, UiResponse } from '../ui-types.js';
-export { g as AGENT_EVENT_TYPE_NAMES, b as AgentCallOpts, A as AgentEvent, h as AgentEventTypeName, i as AgentFailureKind, c as AgentOutcome, j as AgentOutcomeUsage, k as AgentUsage, a as AgentUsageTotal, l as AssertMutuallyAssignable, d as EngineCapabilities, E as EngineHandleData, m as EngineProcessModel, I as InternalToolCall, f as ModelCatalogEntry, M as ModelRef, P as ProbeReport, R as ReplayedTurn, e as ResumeAnchor, S as SessionView, n as ToolCall, o as ToolCallEntry, p as ToolCallResult, T as Turn, W as WorktreeHandle } from '../contract-types-jSa1g28F.js';
+export { h as AGENT_EVENT_TYPE_NAMES, c as AgentCallOpts, A as AgentEvent, i as AgentEventTypeName, j as AgentFailureKind, d as AgentOutcome, k as AgentOutcomeUsage, a as AgentUsage, b as AgentUsageTotal, l as AssertMutuallyAssignable, e as EngineCapabilities, E as EngineHandleData, m as EngineProcessModel, n as EngineStopReason, F as FAILURE_CAUSE_CLOSED_KINDS, o as FAILURE_CAUSE_KINDS_BY_CLASS, p as FAILURE_CAUSE_KINDS_BY_CLASS_LOCK, q as FAILURE_CAUSE_KIND_VOCAB_LOCK, r as FailureCause, s as FailureCauseClass, t as FailureRetryability, I as InternalToolCall, g as ModelCatalogEntry, M as ModelRef, P as ProbeReport, R as ReplayedTurn, f as ResumeAnchor, S as SessionView, u as ToolCall, v as ToolCallEntry, w as ToolCallResult, T as Turn, W as WorktreeHandle, _ as _EventVocabSyncLock } from '../contract-types-C1scOS_M.js';
 
 /** 协议版本（引擎包 manifest `taiji.subagentEngine.protocol` 与 initialize 应答同值）。 */
 declare const ENGINE_PROTOCOL_VERSION = 1;
@@ -15,7 +15,7 @@ declare const SUPPORTED_PROTOCOL_RANGE: {
 };
 /** 版本兼容判定（core 握手判据；引擎侧对称用于拒绝过旧/过新宿主）。 */
 declare function isProtocolVersionCompatible(version: number): boolean;
-/** 正向数据面反向请求（帧④数据面类）未应答容忍时长：10s 未答 = 引擎故障 → 杀进程 + 在途 run 失败。 */
+/** 正向数据范围反向请求（帧④数据范围类）未应答容忍时长：10s 未答 = 引擎故障 → 杀进程 + 在途 run 失败。 */
 declare const REVERSE_REQUEST_TIMEOUT_MS = 10000;
 /** initialize 握手超时（ms）：超时 → engine_handshake_timeout，该引擎不可用。 */
 declare const HANDSHAKE_TIMEOUT_MS = 10000;
@@ -24,22 +24,22 @@ declare const CANCEL_SETTLE_GRACE_MS = 3000;
 /**
  * setModel 引擎侧单阶段控制窗（ms）：pi 实现等子进程 `set_model` 应答、等
  * `get_state` 回读各占一窗（设计 subagent-model-switch §7.3——命令与回读全程带
- * 存活检查，超时上限复用现役取消收敛窗量级：控制面单请求 = 秒级）。窗满且进程
+ * 存活检查，超时上限复用现役取消收敛窗量级：控制范围单请求 = 秒级）。窗满且进程
  * 仍存活 → `engine_state_readback_failed`；窗满时进程已退出 → 无活进程形态
  * （`SET_MODEL_NOT_ACTIVE_CODE`）——两种处置不可混淆。
  */
 declare const SET_MODEL_STAGE_TIMEOUT_MS = 3000;
 /**
  * setModel 正向方法的宿主侧单请求上界（ms）：≥ 引擎侧两阶段最坏时延
- * （2 × SET_MODEL_STAGE_TIMEOUT_MS）+ 协议余量；量级锚 = 数据面单请求
- * REVERSE_REQUEST_TIMEOUT_MS 的 10s 先例（控制面单请求必须秒级有界——宿主不悬挂）。
+ * （2 × SET_MODEL_STAGE_TIMEOUT_MS）+ 协议余量；量级锚 = 数据范围单请求
+ * REVERSE_REQUEST_TIMEOUT_MS 的 10s 先例（控制范围单请求必须秒级有界——宿主不悬挂）。
  */
 declare const SET_MODEL_REQUEST_TIMEOUT_MS = 10000;
 /** stderr 内存环形缓冲保留的尾部字符数（engine_crashed 帧携带崩溃现场）。 */
 declare const STDERR_TAIL_CHARS = 400;
 /**
  * 反向请求超时二分（帧④注释，R9-2）：
- * - 数据面类（host/log / host/streamDelta / host/handleReady /
+ * - 数据范围类（host/log / host/streamDelta / host/handleReady /
  *   host/childSpawned / host/childStateChanged）：10s 未答 = 引擎故障；
  * - 人机交互类（host/askUser）：不设统一超时——core 先回 {ack:true}，
  *   结果异步到达；按 ADR-0047「静默 ≠ 卡死」用无进展检测/用户取消，不据此判引擎故障。
@@ -55,11 +55,11 @@ type ReverseChannel = "host/log" | "host/askUser" | "host/streamDelta" | "host/h
  */
 declare const REVERSE_CHANNELS: readonly ["host/log", "host/askUser", "host/streamDelta", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
 /**
- * 超时二分归属（10s 数据面 / 不设统一超时的人机交互面）。实现归 W2 EngineClient；
+ * 超时二分归属（10s 数据范围 / 不设统一超时的人机交互通道）。实现归 W2 EngineClient；
  * 引擎侧自灭计时（W12）复用同表——已 ack 的 askUser 等待不计入 in-flight（R9-2）。
  */
 declare const REVERSE_CHANNEL_TIMEOUT_CLASS: Record<ReverseChannel, ReverseRequestTimeoutClass>;
-/** host/log：引擎日志落宿主日志（对齐 core HostServices.log 调用面）。 */
+/** host/log：引擎日志落宿主日志（对齐 core HostServices.log 调用范围）。 */
 interface HostLogParams {
     level: "debug" | "warn" | "error";
     component: string;
@@ -87,7 +87,7 @@ interface HostStreamDeltaParams {
 /**
  * host/handleReady：运行中句柄回填（core onHandleReady 语义：session/create 应答后、
  * 早于 run resolve；AGENTS.md 关键规则 9「重开 session 仍可见」的前提）。
- * [池抽象降级 2026-09-13] 原 poolKey 字段已随协议面 poolKey 退役删除。
+ * [池抽象降级 2026-09-13] 原 poolKey 字段已随协议范围 poolKey 退役删除。
  */
 interface HostHandleReadyParams {
     runId: string;
@@ -103,7 +103,7 @@ interface HostChildSpawnedParams {
     recordId: string;
 }
 /**
- * host/childStateChanged：childSpawned 的状态面（core 侧镜像数据源，
+ * host/childStateChanged：childSpawned 的状态侧（core 侧镜像数据源，
  * hasLiveProcessHandle/isResumable 同步读镜像，不跨进程查询）。
  * **killed 必含**（判据 `child !== undefined && !child.killed`）——类型层 required。
  */
@@ -117,6 +117,49 @@ interface HostChildStateChangedParams {
     signal?: string;
 }
 
+/** control 协议版本（帧 v 字段；runtime 与 extension 同包分发，未知 v → hello_reject {reason:"version"}，D9 版本矩阵）。 */
+declare const SUBAGENT_CONTROL_PROTOCOL_VERSION = 1;
+/**
+ * 帧 kind 判别值词表（10 成员）。as const 值即字面量类型——类型位置同样可用。
+ * 方向语义见文件头帧表：hello/engine_open/engine_frame/engine_close 为 C→R，
+ * hello_ok/hello_reject/engine_opened/engine_open_failed/engine_closed/error 为 R→C，
+ * engine_frame 双向。
+ */
+declare const SUBAGENT_CONTROL_FRAME_KINDS: {
+    readonly hello: "hello";
+    readonly helloOk: "hello_ok";
+    readonly helloReject: "hello_reject";
+    readonly engineOpen: "engine_open";
+    readonly engineOpened: "engine_opened";
+    readonly engineOpenFailed: "engine_open_failed";
+    readonly engineFrame: "engine_frame";
+    readonly engineClose: "engine_close";
+    readonly engineClosed: "engine_closed";
+    readonly error: "error";
+};
+type SubagentControlFrameKind = (typeof SUBAGENT_CONTROL_FRAME_KINDS)[keyof typeof SUBAGENT_CONTROL_FRAME_KINDS];
+/** unknown → control 帧 kind 收窄（外部输入携带 kind 时的运行时 guard）。 */
+declare function isSubagentControlFrameKind(value: unknown): value is SubagentControlFrameKind;
+/**
+ * engine_closed 帧 reason 值域（引擎通道终局归因，D8/D10）：
+ * - engine_exit：引擎进程自行退出（code 承载退出码）；
+ * - engine_signal：被信号终止（signal 承载信号名）；
+ * - killed_by_control：runtime 主动杀组（engine_close 有界等待超时 / 背压溢出 /
+ *   连接关闭 fan-out 等控制面裁决）；
+ * - open_timeout：engine_open 超时被 runtime 中止杀组（迟到 engine_opened 丢弃）。
+ * 意外退出（engine_exit/engine_signal）→ runtime 无条件 killEngineGroup（D7）；
+ * runtime transport 把 reason 映射进 onExit info（stderrTail 同帧携带）。
+ */
+declare const SUBAGENT_CONTROL_CLOSED_REASONS: {
+    readonly engineExit: "engine_exit";
+    readonly engineSignal: "engine_signal";
+    readonly killedByControl: "killed_by_control";
+    readonly openTimeout: "open_timeout";
+};
+type SubagentControlClosedReason = (typeof SUBAGENT_CONTROL_CLOSED_REASONS)[keyof typeof SUBAGENT_CONTROL_CLOSED_REASONS];
+/** unknown → engine_closed reason 收窄（外部输入携带 reason 时的运行时 guard）。 */
+declare function isSubagentControlClosedReason(value: unknown): value is SubagentControlClosedReason;
+
 /** 协议错误对象 schema。 */
 declare const protocolErrorSchema: {
     readonly $schema: "http://json-schema.org/draft-07/schema#";
@@ -235,7 +278,7 @@ declare const notificationFrameSchema: {
                     readonly properties: {
                         readonly type: {
                             readonly type: "string";
-                            readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed"];
+                            readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed", "auto_retry"];
                         };
                     };
                 };
@@ -355,7 +398,7 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
                         readonly properties: {
                             readonly type: {
                                 readonly type: "string";
-                                readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed"];
+                                readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error", "armed", "auto_retry"];
                             };
                         };
                     };
@@ -404,7 +447,7 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
     };
 };
 /**
- * 协议面凭据禁区键名（不变量 5 的测试断言依据）：帧 schema 与深载荷 TS 类型面
+ * 协议范围凭据禁区键名（不变量 5 的测试断言依据）：帧 schema 与深载荷 TS 类型范围
  * 不得出现。词表覆盖常见拼写（子串匹配，非精确枚举）。
  */
 declare const FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS: readonly ["apikey", "api_key", "token", "credential", "password", "secret"];
@@ -446,4 +489,4 @@ declare const runSessionParamsSchema: {
     };
 };
 
-export { CANCEL_SETTLE_GRACE_MS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, type HostAskUserParams, type HostAskUserResult, type HostChildSpawnedParams, type HostChildStateChangedParams, type HostHandleReadyParams, type HostLogParams, type HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReverseChannel, type ReverseRequestTimeoutClass, SET_MODEL_REQUEST_TIMEOUT_MS, SET_MODEL_STAGE_TIMEOUT_MS, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema };
+export { CANCEL_SETTLE_GRACE_MS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, type HostAskUserParams, type HostAskUserResult, type HostChildSpawnedParams, type HostChildStateChangedParams, type HostHandleReadyParams, type HostLogParams, type HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReverseChannel, type ReverseRequestTimeoutClass, SET_MODEL_REQUEST_TIMEOUT_MS, SET_MODEL_STAGE_TIMEOUT_MS, STDERR_TAIL_CHARS, SUBAGENT_CONTROL_CLOSED_REASONS, SUBAGENT_CONTROL_FRAME_KINDS, SUBAGENT_CONTROL_PROTOCOL_VERSION, SUPPORTED_PROTOCOL_RANGE, type SubagentControlClosedReason, type SubagentControlFrameKind, errorResponseFrameSchema, isProtocolVersionCompatible, isSubagentControlClosedReason, isSubagentControlFrameKind, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema };

package/dist/protocol/index.js

@@ -1,18 +1,28 @@
 import {
   AGENT_EVENT_TYPE_NAMES,
   ENGINE_PROTOCOL_SCHEMAS,
+  FAILURE_CAUSE_CLOSED_KINDS,
+  FAILURE_CAUSE_KINDS_BY_CLASS,
+  FAILURE_CAUSE_KINDS_BY_CLASS_LOCK,
+  FAILURE_CAUSE_KIND_VOCAB_LOCK,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   PROTOCOL_METHODS,
   REVERSE_CHANNELS,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
+  SUBAGENT_CONTROL_CLOSED_REASONS,
+  SUBAGENT_CONTROL_FRAME_KINDS,
+  SUBAGENT_CONTROL_PROTOCOL_VERSION,
+  _EventVocabSyncLock,
   errorResponseFrameSchema,
+  isSubagentControlClosedReason,
+  isSubagentControlFrameKind,
   notificationFrameSchema,
   protocolErrorSchema,
   requestFrameSchema,
   reverseRequestFrameSchema,
   runSessionParamsSchema,
   successResponseFrameSchema
-} from "../chunk-LM7P7OTA.js";
+} from "../chunk-7R6HYT2A.js";
 import {
   isNotificationFrame,
   isRequestFrame,
@@ -24,7 +34,11 @@ import {
   ENGINE_ERROR_CODE_PREFIX,
   ENGINE_PROTOCOL_ERROR_CODES,
   ENGINE_PROTOCOL_VERSION,
+  ENGINE_SPAWN_DELIVERY_ERROR_CODES,
+  ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY,
   ENGINE_TIMEOUT_RECOVERY,
+  ENGINE_TRANSPORT_ERROR_CODES,
+  ENGINE_TRANSPORT_ERROR_RECOVERY,
   EngineSdkError,
   HANDSHAKE_TIMEOUT_MS,
   REVERSE_REQUEST_TIMEOUT_MS,
@@ -44,7 +58,7 @@ import {
   isEngineProtocolErrorCode,
   isProtocolVersionCompatible,
   schemaEmulationFailedDetail
-} from "../chunk-JZN76I3S.js";
+} from "../chunk-NVF3PADP.js";
 import "../chunk-JSBRDJBE.js";
 export {
   AGENT_EVENT_TYPE_NAMES,
@@ -53,8 +67,16 @@ export {
   ENGINE_PROTOCOL_ERROR_CODES,
   ENGINE_PROTOCOL_SCHEMAS,
   ENGINE_PROTOCOL_VERSION,
+  ENGINE_SPAWN_DELIVERY_ERROR_CODES,
+  ENGINE_SPAWN_DELIVERY_ERROR_RECOVERY,
   ENGINE_TIMEOUT_RECOVERY,
+  ENGINE_TRANSPORT_ERROR_CODES,
+  ENGINE_TRANSPORT_ERROR_RECOVERY,
   EngineSdkError,
+  FAILURE_CAUSE_CLOSED_KINDS,
+  FAILURE_CAUSE_KINDS_BY_CLASS,
+  FAILURE_CAUSE_KINDS_BY_CLASS_LOCK,
+  FAILURE_CAUSE_KIND_VOCAB_LOCK,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   HANDSHAKE_TIMEOUT_MS,
   PROTOCOL_METHODS,
@@ -67,7 +89,11 @@ export {
   SET_MODEL_STAGE_TIMEOUT_MS,
   STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS,
+  SUBAGENT_CONTROL_CLOSED_REASONS,
+  SUBAGENT_CONTROL_FRAME_KINDS,
+  SUBAGENT_CONTROL_PROTOCOL_VERSION,
   SUPPORTED_PROTOCOL_RANGE,
+  _EventVocabSyncLock,
   assertChatConversationSupported,
   engineConversationUnsupportedError,
   engineProtocolMismatchError,
@@ -81,6 +107,8 @@ export {
   isRequestFrame,
   isResponseFrame,
   isReverseRequestFrame,
+  isSubagentControlClosedReason,
+  isSubagentControlFrameKind,
   notificationFrameSchema,
   protocolErrorSchema,
   requestFrameSchema,

package/dist/server/index.cjs

@@ -88,7 +88,7 @@ var EngineSdkError = class extends Error {
     this.recovery = recovery;
     this.data = data;
   }
-  /** 协议 error 帧载荷投影。 */
+  /** 协议 error 帧载荷派生视图。 */
   toStructured() {
     return { code: this.code, message: this.message, recovery: this.recovery, data: this.data };
   }