@zhushanwen/subagent-engine-sdk 0.4.0 → 0.5.0

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

@@ -1,6 +1,6 @@
 import {
   EngineSdkError
-} from "./chunk-WS4WAZVR.js";
+} from "./chunk-F5JZMK74.js";
 
 // src/node-executor.ts
 import { spawn } from "child_process";

package/dist/{chunk-WS4WAZVR.js → chunk-F5JZMK74.js}

@@ -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\uFF08\u4E00\u6B21\u6027\u4EFB\u52A1\u9ED8\u8BA4\u5F62\u6001\uFF09\uFF0C\u6216\u4FEE manifest capabilities / \u5347\u7EA7\u5F15\u64CE\u5305\uFF08\u82E5\u5F15\u64CE\u5B9E\u9645\u652F\u6301\u8BE5\u80FD\u529B\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`,
     { engineId, capability: "conversation", declared: "unsupported" }
   );
 }

package/dist/{chunk-FJT23P7T.js → chunk-WORT4PG7.js}

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

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

@@ -161,13 +161,14 @@ interface EngineCapabilities {
     /** 注意区分「引擎 RPC 层有此能力」与「subagent 链路已接通」。 */
     steer: "native" | "emulated" | "unsupported";
     /**
-     * [H1 D5 语义收窄] resume 能力位（chat 续聊 = 新 run + resume 锚点的承载前提；
+     * [H1 D5 语义收窄 + modeless] 「怎么续」形态轴兼 message 资格轴：
+     * 位非 'unsupported' = 引擎可续聊（core capability-gate 的 message 资格门消费），
+     * 值区分续聊形态——native（原地续写）/ cold（冷恢复重建 + 新 run + resume 锚点）。
      * 原名字沿用——conversation 位保留、语义从「interact 长驻控制面」收窄为
-     * 「resume 续聊能力」，gate 判据与消费方不变）。
-     * [U6 / 永久会话模型 §3.2.6 要点 4] 新值 "cold" = 冷恢复会话：resume 读通道取
-     * 结构化历史 + 新 session 注入（无热 steering）。gate 判据仍是 `=== "unsupported"`
-     * 拒绝——"cold" 在 gate 面与 "native" 等价放行，差异只在续聊形态（新 session
-     * 注入 vs 原地续写）。
+     * 「resume 续聊能力」。[modeless 波2] 会话形态键只剩 run.params.resume（协议
+     * task.conversation 已删），本轴不再是 per-run 模式开关——描述各引擎的真实
+     * 续聊差异（gate 判据仍是 `=== "unsupported"` 拒绝，"cold" 与 "native" 等价
+     * 放行）。
      */
     conversation: "native" | "cold" | "unsupported";
     /** 决定 persona 路由策略（file/flag/prompt 通道）。 */
@@ -280,7 +281,7 @@ interface ModelCatalogEntry {
  *
  * 字段裁决（对照 core orchestration/models/types.ts AgentCallOpts，2026-09-09）：
  * - 入选 = 引擎消费面：任务语义（prompt/schema/thinkingLevel/skill/skillPath/agent/persona 注入）、
- *   轮次预算（maxTurns/graceTurns/conversation/idleTimeoutMs）、隔离与权限（worktree/
+ *   轮次预算（maxTurns/graceTurns/idleTimeoutMs）、隔离与权限（worktree/
  *   fork/forkSource/denyTools/permissionMode）、诊断（description/scene）；
  * - 排除并改挂 run.params.ctx（协议层已单列，task 内双写会分叉）：model（→ctx.model）、
  *   schemaEnv（→ctx.schemaEnv）、cwd（→ctx.cwd）、engineFallback（→ctx.engineFallback）；
@@ -327,9 +328,7 @@ interface AgentCallOpts {
     forkSource?: string;
     /** Filesystem isolation: 新建 worktree | 复用外部已创建 worktree | 不隔离。 */
     worktree?: boolean | WorktreeHandle;
-    /** 可持续对话模式：true = 轮次完成进 idle 态等待 message 续聊。 */
-    conversation?: boolean;
-    /** 空闲超时毫秒数（仅 conversation 模式有意义）。显式 0/负 = 禁用 idle GC。 */
+    /** 空闲超时毫秒数（[modeless] 全体 record 的 idle 回收节奏；显式 0/负 = 禁用 idle GC）。 */
     idleTimeoutMs?: number;
     /** 工具 denylist（各引擎做语法映射）。 */
     denyTools?: string[];

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

@@ -161,13 +161,14 @@ interface EngineCapabilities {
     /** 注意区分「引擎 RPC 层有此能力」与「subagent 链路已接通」。 */
     steer: "native" | "emulated" | "unsupported";
     /**
-     * [H1 D5 语义收窄] resume 能力位（chat 续聊 = 新 run + resume 锚点的承载前提；
+     * [H1 D5 语义收窄 + modeless] 「怎么续」形态轴兼 message 资格轴：
+     * 位非 'unsupported' = 引擎可续聊（core capability-gate 的 message 资格门消费），
+     * 值区分续聊形态——native（原地续写）/ cold（冷恢复重建 + 新 run + resume 锚点）。
      * 原名字沿用——conversation 位保留、语义从「interact 长驻控制面」收窄为
-     * 「resume 续聊能力」，gate 判据与消费方不变）。
-     * [U6 / 永久会话模型 §3.2.6 要点 4] 新值 "cold" = 冷恢复会话：resume 读通道取
-     * 结构化历史 + 新 session 注入（无热 steering）。gate 判据仍是 `=== "unsupported"`
-     * 拒绝——"cold" 在 gate 面与 "native" 等价放行，差异只在续聊形态（新 session
-     * 注入 vs 原地续写）。
+     * 「resume 续聊能力」。[modeless 波2] 会话形态键只剩 run.params.resume（协议
+     * task.conversation 已删），本轴不再是 per-run 模式开关——描述各引擎的真实
+     * 续聊差异（gate 判据仍是 `=== "unsupported"` 拒绝，"cold" 与 "native" 等价
+     * 放行）。
      */
     conversation: "native" | "cold" | "unsupported";
     /** 决定 persona 路由策略（file/flag/prompt 通道）。 */
@@ -280,7 +281,7 @@ interface ModelCatalogEntry {
  *
  * 字段裁决（对照 core orchestration/models/types.ts AgentCallOpts，2026-09-09）：
  * - 入选 = 引擎消费面：任务语义（prompt/schema/thinkingLevel/skill/skillPath/agent/persona 注入）、
- *   轮次预算（maxTurns/graceTurns/conversation/idleTimeoutMs）、隔离与权限（worktree/
+ *   轮次预算（maxTurns/graceTurns/idleTimeoutMs）、隔离与权限（worktree/
  *   fork/forkSource/denyTools/permissionMode）、诊断（description/scene）；
  * - 排除并改挂 run.params.ctx（协议层已单列，task 内双写会分叉）：model（→ctx.model）、
  *   schemaEnv（→ctx.schemaEnv）、cwd（→ctx.cwd）、engineFallback（→ctx.engineFallback）；
@@ -327,9 +328,7 @@ interface AgentCallOpts {
     forkSource?: string;
     /** Filesystem isolation: 新建 worktree | 复用外部已创建 worktree | 不隔离。 */
     worktree?: boolean | WorktreeHandle;
-    /** 可持续对话模式：true = 轮次完成进 idle 态等待 message 续聊。 */
-    conversation?: boolean;
-    /** 空闲超时毫秒数（仅 conversation 模式有意义）。显式 0/负 = 禁用 idle GC。 */
+    /** 空闲超时毫秒数（[modeless] 全体 record 的 idle 回收节奏；显式 0/负 = 禁用 idle GC）。 */
     idleTimeoutMs?: number;
     /** 工具 denylist（各引擎做语法映射）。 */
     denyTools?: string[];

package/dist/env.d.cts

@@ -23,7 +23,14 @@ interface EngineChildEnvOptions {
     electronRunAsNode?: boolean;
     /** L0：relay 三键（宿主 relay 激活时传；三键必经 L0——L1 拒绝 XYZ_SUBAGENT_ 前缀、L2 是 manifest 面，两层都到不了） */
     relay?: EngineRelayEnv;
-    /** L0：引擎侧身份 env（PI_SUBAGENT_ROOT_SESSION_ID 等，base-tool-enhance / 递归可见性消费） */
+    /**
+     * L0：引擎侧身份 env 透传通道（identityEnv）。现行事实（ext-simplify-17 D4，
+     * 20260914 真机探针证实）：PI_SUBAGENT_ROOT_SESSION_ID / PI_SUBAGENT_SELF_RECORD_ID
+     * 两键已无写入方（本通道现无人传值），引擎链统一 subagent 标记 = XYZ_AGENT_SUBAGENT=1
+     * （见 injectL0InfraKeys 恒注入），base-tool-enhance 判据已重锚新标记。通道保留待
+     * 另行裁决，读者见 docs/architecture/ext-simplify-17-shared-extraction.md §3.1 D4
+     * 与探针报告 .tmp/dev-flow/ext-simplify-17-d4-probe.md。
+     */
     identityEnv?: Record<string, string | undefined>;
     /** L2：manifest 声明的 envPrefixes 放行清单（保留前缀拒绝 + 形态校验） */
     envPrefixes?: readonly string[];

package/dist/env.d.ts

@@ -23,7 +23,14 @@ interface EngineChildEnvOptions {
     electronRunAsNode?: boolean;
     /** L0：relay 三键（宿主 relay 激活时传；三键必经 L0——L1 拒绝 XYZ_SUBAGENT_ 前缀、L2 是 manifest 面，两层都到不了） */
     relay?: EngineRelayEnv;
-    /** L0：引擎侧身份 env（PI_SUBAGENT_ROOT_SESSION_ID 等，base-tool-enhance / 递归可见性消费） */
+    /**
+     * L0：引擎侧身份 env 透传通道（identityEnv）。现行事实（ext-simplify-17 D4，
+     * 20260914 真机探针证实）：PI_SUBAGENT_ROOT_SESSION_ID / PI_SUBAGENT_SELF_RECORD_ID
+     * 两键已无写入方（本通道现无人传值），引擎链统一 subagent 标记 = XYZ_AGENT_SUBAGENT=1
+     * （见 injectL0InfraKeys 恒注入），base-tool-enhance 判据已重锚新标记。通道保留待
+     * 另行裁决，读者见 docs/architecture/ext-simplify-17-shared-extraction.md §3.1 D4
+     * 与探针报告 .tmp/dev-flow/ext-simplify-17-d4-probe.md。
+     */
     identityEnv?: Record<string, string | undefined>;
     /** L2：manifest 声明的 envPrefixes 放行清单（保留前缀拒绝 + 形态校验） */
     envPrefixes?: readonly string[];

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

@@ -1,4 +1,4 @@
-import { a as AgentEvent, E as EngineCapabilities } from './contract-types-C71Sqq8d.js';
+import { a as AgentEvent, E as EngineCapabilities } from './contract-types-Dsvy79r3.js';
 
 /** 协议错误对象（error 帧载荷与反向请求错误应答共用形态）。 */
 interface ProtocolError {
@@ -87,20 +87,19 @@ declare class EngineSdkError extends Error {
 }
 declare function engineProtocolMismatchError(engineVersion: number): EngineSdkError;
 /**
- * [v1.x] resume 会话形态（run.params.resume）的 gate 拒绝具名错误（chat-domain
- * 设计 §3.2 D1-A + 验收 A6：manifest 无 conversation gate 位的引擎收到
- * conversation 请求 → 同步拒；[H1] 文案随 D5 语义收窄——续聊 = resume 续聊）。
- * 文案契约对齐 core capability-gate.ts conversation 分支（错误码
- * engine_capability_unsupported + 「去掉参数 / 修 manifest / 升级引擎包」恢复指引）
- * ——W3 chat 路由切协议客户端时以本构造器替换 core 内联文案，保持两侧一致。
+ * 引擎 conversation 位拒绝的具名错误（[modeless 波2] 语义：无 resume 续聊通道的
+ * 引擎，message 续聊资格被拒——manifest conversation 能力轴消费，core
+ * capability-gate 的 conversation 分支与 message 资格门双写点共用本构造器）。
+ * 文案契约：错误码 engine_capability_unsupported + 「去掉参数 / 修 manifest /
+ * 升级引擎包」恢复指引，两侧一致防漂移。
  */
 declare function engineConversationUnsupportedError(engineId: string): EngineSdkError;
 /**
- * [v1.x] resume 会话形态（run.params.resume / task.conversation=true）派发前的同步 gate：
- * manifest conversation 位 unsupported 即抛 engineConversationUnsupportedError——
- * 进程/record 创建前同步拒（A6：run 域不受影响，仅 chat 面被拦）。
- * 判据单源：core 侧 capability-gate.assertTaskShapeSupported 的 conversation 分支
- * 覆盖同一能力位，协议客户端路径（W3 接线）消费本函数，防两处判据漂移。
+ * resume 会话形态（run.params.resume——唯一会话形态键）派发前的同步 gate：
+ * manifest conversation 位 unsupported 即抛 engineConversationUnsupportedError
+ * ——进程/record 创建前同步拒（A6 方向防御：manifest/实装漂移时引擎侧自拒，
+ * 与 core capability-gate 同一能力位，防两侧判据漂移）。[modeless 波2] 协议
+ * task 的 conversation 键已删，本 gate 只对 resume 形态键生效。
  */
 declare function assertChatConversationSupported(engineId: string, capabilities: Pick<EngineCapabilities, "conversation">): void;
 /** stdout 尾部回显上限（engine_timeout / engine_run_failed 的错误规格载体系数）。 */

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

@@ -1,4 +1,4 @@
-import { a as AgentEvent, E as EngineCapabilities } from './contract-types-C71Sqq8d.cjs';
+import { a as AgentEvent, E as EngineCapabilities } from './contract-types-Dsvy79r3.cjs';
 
 /** 协议错误对象（error 帧载荷与反向请求错误应答共用形态）。 */
 interface ProtocolError {
@@ -87,20 +87,19 @@ declare class EngineSdkError extends Error {
 }
 declare function engineProtocolMismatchError(engineVersion: number): EngineSdkError;
 /**
- * [v1.x] resume 会话形态（run.params.resume）的 gate 拒绝具名错误（chat-domain
- * 设计 §3.2 D1-A + 验收 A6：manifest 无 conversation gate 位的引擎收到
- * conversation 请求 → 同步拒；[H1] 文案随 D5 语义收窄——续聊 = resume 续聊）。
- * 文案契约对齐 core capability-gate.ts conversation 分支（错误码
- * engine_capability_unsupported + 「去掉参数 / 修 manifest / 升级引擎包」恢复指引）
- * ——W3 chat 路由切协议客户端时以本构造器替换 core 内联文案，保持两侧一致。
+ * 引擎 conversation 位拒绝的具名错误（[modeless 波2] 语义：无 resume 续聊通道的
+ * 引擎，message 续聊资格被拒——manifest conversation 能力轴消费，core
+ * capability-gate 的 conversation 分支与 message 资格门双写点共用本构造器）。
+ * 文案契约：错误码 engine_capability_unsupported + 「去掉参数 / 修 manifest /
+ * 升级引擎包」恢复指引，两侧一致防漂移。
  */
 declare function engineConversationUnsupportedError(engineId: string): EngineSdkError;
 /**
- * [v1.x] resume 会话形态（run.params.resume / task.conversation=true）派发前的同步 gate：
- * manifest conversation 位 unsupported 即抛 engineConversationUnsupportedError——
- * 进程/record 创建前同步拒（A6：run 域不受影响，仅 chat 面被拦）。
- * 判据单源：core 侧 capability-gate.assertTaskShapeSupported 的 conversation 分支
- * 覆盖同一能力位，协议客户端路径（W3 接线）消费本函数，防两处判据漂移。
+ * resume 会话形态（run.params.resume——唯一会话形态键）派发前的同步 gate：
+ * manifest conversation 位 unsupported 即抛 engineConversationUnsupportedError
+ * ——进程/record 创建前同步拒（A6 方向防御：manifest/实装漂移时引擎侧自拒，
+ * 与 core capability-gate 同一能力位，防两侧判据漂移）。[modeless 波2] 协议
+ * task 的 conversation 键已删，本 gate 只对 resume 形态键生效。
  */
 declare function assertChatConversationSupported(engineId: string, capabilities: Pick<EngineCapabilities, "conversation">): void;
 /** stdout 尾部回显上限（engine_timeout / engine_run_failed 的错误规格载体系数）。 */

package/dist/index.cjs

@@ -6813,7 +6813,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\uFF08\u4E00\u6B21\u6027\u4EFB\u52A1\u9ED8\u8BA4\u5F62\u6001\uFF09\uFF0C\u6216\u4FEE manifest capabilities / \u5347\u7EA7\u5F15\u64CE\u5305\uFF08\u82E5\u5F15\u64CE\u5B9E\u9645\u652F\u6301\u8BE5\u80FD\u529B\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`,
     { engineId, capability: "conversation", declared: "unsupported" }
   );
 }

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-CiOO3PMg.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-C71Sqq8d.cjs';
+export { E as ENGINE_ERROR_CODE_PREFIX, a as ENGINE_PROTOCOL_ERROR_CODES, b as ENGINE_TIMEOUT_RECOVERY, c as EngineProtocolErrorCode, d as EngineSdkError, e as ErrorResponseFrame, f as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, g as ResponseFrame, h as ReverseRequestFrame, i as ReverseResponseResult, S as STDOUT_TAIL_ECHO_CHARS, j as SuccessResponseFrame, k as assertChatConversationSupported, l as engineConversationUnsupportedError, m as engineProtocolMismatchError, n as engineTimeoutDetail, o as isEngineErrorPassthroughCode, p as isEngineProtocolErrorCode, q as isNotificationFrame, r as isRequestFrame, s as isResponseFrame, t as isReverseRequestFrame, u as schemaEmulationFailedDetail } from './error-codes-SA5fGtx_.cjs';
+export { A as AgentCallOpts, a as AgentEvent, b as AgentFailureKind, c as AgentOutcome, d as AgentOutcomeUsage, e as AgentUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, E as EngineCapabilities, h as EngineHandleData, I as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, i as ResumeAnchor, S as SessionView, T as ToolCall, j as ToolCallEntry, k as ToolCallResult, l as Turn, W as WorktreeHandle } from './contract-types-Dsvy79r3.cjs';
 export { 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';

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-D5YlWaBx.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-C71Sqq8d.js';
+export { E as ENGINE_ERROR_CODE_PREFIX, a as ENGINE_PROTOCOL_ERROR_CODES, b as ENGINE_TIMEOUT_RECOVERY, c as EngineProtocolErrorCode, d as EngineSdkError, e as ErrorResponseFrame, f as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, g as ResponseFrame, h as ReverseRequestFrame, i as ReverseResponseResult, S as STDOUT_TAIL_ECHO_CHARS, j as SuccessResponseFrame, k as assertChatConversationSupported, l as engineConversationUnsupportedError, m as engineProtocolMismatchError, n as engineTimeoutDetail, o as isEngineErrorPassthroughCode, p as isEngineProtocolErrorCode, q as isNotificationFrame, r as isRequestFrame, s as isResponseFrame, t as isReverseRequestFrame, u as schemaEmulationFailedDetail } from './error-codes-OvQlqiQw.js';
+export { A as AgentCallOpts, a as AgentEvent, b as AgentFailureKind, c as AgentOutcome, d as AgentOutcomeUsage, e as AgentUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, E as EngineCapabilities, h as EngineHandleData, I as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, i as ResumeAnchor, S as SessionView, T as ToolCall, j as ToolCallEntry, k as ToolCallResult, l as Turn, W as WorktreeHandle } from './contract-types-Dsvy79r3.js';
 export { 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';

package/dist/index.js

@@ -45,7 +45,7 @@ import {
   probeNodeExecutor,
   resetEngineNodeProbeCache,
   resolveEngineNodeLaunch
-} from "./chunk-LKPVN3N6.js";
+} from "./chunk-3IBT7MTB.js";
 import {
   DEFAULT_STDERR_KEEP_DAYS,
   DEFAULT_STDERR_MAX_BYTES,
@@ -105,7 +105,7 @@ import {
   abortWithFallback,
   killChain,
   synthesizeTimeoutOutcome
-} from "./chunk-FJT23P7T.js";
+} from "./chunk-WORT4PG7.js";
 import {
   toErrorMessage
 } from "./chunk-PYO3YR7W.js";
@@ -133,7 +133,7 @@ import {
   isEngineProtocolErrorCode,
   isProtocolVersionCompatible,
   schemaEmulationFailedDetail
-} from "./chunk-WS4WAZVR.js";
+} from "./chunk-F5JZMK74.js";
 import {
   aggregateUsage,
   createReplayRecord,

package/dist/journal-io.d.cts

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

package/dist/journal-io.d.ts

@@ -1,4 +1,4 @@
-import { a as AgentEvent } from './contract-types-C71Sqq8d.js';
+import { a as AgentEvent } from './contract-types-Dsvy79r3.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-C71Sqq8d.cjs';
+import { l as Turn, f as AgentUsageTotal, a as AgentEvent, S as SessionView, h as EngineHandleData, R as ReplayedTurn } from './contract-types-Dsvy79r3.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-C71Sqq8d.js';
+import { l as Turn, f as AgentUsageTotal, a as AgentEvent, S as SessionView, h as EngineHandleData, R as ReplayedTurn } from './contract-types-Dsvy79r3.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-CiOO3PMg.cjs';
-import { A as AgentCallOpts, c as AgentOutcome } from './contract-types-C71Sqq8d.cjs';
+export { S as STDOUT_TAIL_ECHO_CHARS } from './error-codes-SA5fGtx_.cjs';
+import { A as AgentCallOpts, c as AgentOutcome } from './contract-types-Dsvy79r3.cjs';
 
 /**
  * 可杀子进程的结构形状（Node ChildProcess 的结构子集）。

package/dist/kill-chain.d.ts

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

package/dist/kill-chain.js

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

package/dist/node-executor.js

@@ -4,8 +4,8 @@ import {
   probeNodeExecutor,
   resetEngineNodeProbeCache,
   resolveEngineNodeLaunch
-} from "./chunk-LKPVN3N6.js";
-import "./chunk-WS4WAZVR.js";
+} from "./chunk-3IBT7MTB.js";
+import "./chunk-F5JZMK74.js";
 import "./chunk-JSBRDJBE.js";
 export {
   ENGINE_NODE_ENV,

package/dist/port-contract.d.cts

@@ -1,4 +1,4 @@
-import { A as AgentCallOpts, h as EngineHandleData, E as EngineCapabilities, P as ProbeReport, a as AgentEvent, i as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-C71Sqq8d.cjs';
+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';
 
 /**
  * 引擎进程内全量任务声明 = 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-C71Sqq8d.js';
+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';
 
 /**
  * 引擎进程内全量任务声明 = SDK AgentCallOpts 引擎面子集 + 协议 ctx 还原字段（model/

package/dist/protocol/index.cjs

@@ -188,7 +188,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\uFF08\u4E00\u6B21\u6027\u4EFB\u52A1\u9ED8\u8BA4\u5F62\u6001\uFF09\uFF0C\u6216\u4FEE manifest capabilities / \u5347\u7EA7\u5F15\u64CE\u5305\uFF08\u82E5\u5F15\u64CE\u5B9E\u9645\u652F\u6301\u8BE5\u80FD\u529B\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`,
     { engineId, capability: "conversation", declared: "unsupported" }
   );
 }

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-CiOO3PMg.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-C71Sqq8d.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-C71Sqq8d.cjs';
+export { E as ENGINE_ERROR_CODE_PREFIX, a as ENGINE_PROTOCOL_ERROR_CODES, b as ENGINE_TIMEOUT_RECOVERY, c as EngineProtocolErrorCode, d as EngineSdkError, e as ErrorResponseFrame, f as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, g as ResponseFrame, h as ReverseRequestFrame, i as ReverseResponseResult, S as STDOUT_TAIL_ECHO_CHARS, j as SuccessResponseFrame, k as assertChatConversationSupported, l as engineConversationUnsupportedError, m as engineProtocolMismatchError, n as engineTimeoutDetail, o as isEngineErrorPassthroughCode, p as isEngineProtocolErrorCode, q as isNotificationFrame, r as isRequestFrame, s as isResponseFrame, t as isReverseRequestFrame, u as schemaEmulationFailedDetail } from '../error-codes-SA5fGtx_.cjs';
+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';
 import { UiRequest, UiResponse } from '../ui-types.cjs';
 
 /** 协议版本（引擎包 manifest `xyz-agent.subagentEngine.protocol` 与 initialize 应答同值）。 */

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-D5YlWaBx.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-C71Sqq8d.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-C71Sqq8d.js';
+export { E as ENGINE_ERROR_CODE_PREFIX, a as ENGINE_PROTOCOL_ERROR_CODES, b as ENGINE_TIMEOUT_RECOVERY, c as EngineProtocolErrorCode, d as EngineSdkError, e as ErrorResponseFrame, f as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, g as ResponseFrame, h as ReverseRequestFrame, i as ReverseResponseResult, S as STDOUT_TAIL_ECHO_CHARS, j as SuccessResponseFrame, k as assertChatConversationSupported, l as engineConversationUnsupportedError, m as engineProtocolMismatchError, n as engineTimeoutDetail, o as isEngineErrorPassthroughCode, p as isEngineProtocolErrorCode, q as isNotificationFrame, r as isRequestFrame, s as isResponseFrame, t as isReverseRequestFrame, u as schemaEmulationFailedDetail } from '../error-codes-OvQlqiQw.js';
+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';
 import { UiRequest, UiResponse } from '../ui-types.js';
 
 /** 协议版本（引擎包 manifest `xyz-agent.subagentEngine.protocol` 与 initialize 应答同值）。 */

package/dist/protocol/index.js

@@ -40,7 +40,7 @@ import {
   isEngineProtocolErrorCode,
   isProtocolVersionCompatible,
   schemaEmulationFailedDetail
-} from "../chunk-WS4WAZVR.js";
+} from "../chunk-F5JZMK74.js";
 import "../chunk-JSBRDJBE.js";
 export {
   CANCEL_SETTLE_GRACE_MS,

package/package.json

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

package/src/env.ts

@@ -67,7 +67,14 @@ export interface EngineChildEnvOptions {
   electronRunAsNode?: boolean;
   /** L0：relay 三键（宿主 relay 激活时传；三键必经 L0——L1 拒绝 XYZ_SUBAGENT_ 前缀、L2 是 manifest 面，两层都到不了） */
   relay?: EngineRelayEnv;
-  /** L0：引擎侧身份 env（PI_SUBAGENT_ROOT_SESSION_ID 等，base-tool-enhance / 递归可见性消费） */
+  /**
+   * L0：引擎侧身份 env 透传通道（identityEnv）。现行事实（ext-simplify-17 D4，
+   * 20260914 真机探针证实）：PI_SUBAGENT_ROOT_SESSION_ID / PI_SUBAGENT_SELF_RECORD_ID
+   * 两键已无写入方（本通道现无人传值），引擎链统一 subagent 标记 = XYZ_AGENT_SUBAGENT=1
+   * （见 injectL0InfraKeys 恒注入），base-tool-enhance 判据已重锚新标记。通道保留待
+   * 另行裁决，读者见 docs/architecture/ext-simplify-17-shared-extraction.md §3.1 D4
+   * 与探针报告 .tmp/dev-flow/ext-simplify-17-d4-probe.md。
+   */
   identityEnv?: Record<string, string | undefined>;
   /** L2：manifest 声明的 envPrefixes 放行清单（保留前缀拒绝 + 形态校验） */
   envPrefixes?: readonly string[];

package/src/protocol/contract-types.ts

@@ -196,13 +196,14 @@ export interface EngineCapabilities {
   /** 注意区分「引擎 RPC 层有此能力」与「subagent 链路已接通」。 */
   steer: "native" | "emulated" | "unsupported";
   /**
-   * [H1 D5 语义收窄] resume 能力位（chat 续聊 = 新 run + resume 锚点的承载前提；
+   * [H1 D5 语义收窄 + modeless] 「怎么续」形态轴兼 message 资格轴：
+   * 位非 'unsupported' = 引擎可续聊（core capability-gate 的 message 资格门消费），
+   * 值区分续聊形态——native（原地续写）/ cold（冷恢复重建 + 新 run + resume 锚点）。
    * 原名字沿用——conversation 位保留、语义从「interact 长驻控制面」收窄为
-   * 「resume 续聊能力」，gate 判据与消费方不变）。
-   * [U6 / 永久会话模型 §3.2.6 要点 4] 新值 "cold" = 冷恢复会话：resume 读通道取
-   * 结构化历史 + 新 session 注入（无热 steering）。gate 判据仍是 `=== "unsupported"`
-   * 拒绝——"cold" 在 gate 面与 "native" 等价放行，差异只在续聊形态（新 session
-   * 注入 vs 原地续写）。
+   * 「resume 续聊能力」。[modeless 波2] 会话形态键只剩 run.params.resume（协议
+   * task.conversation 已删），本轴不再是 per-run 模式开关——描述各引擎的真实
+   * 续聊差异（gate 判据仍是 `=== "unsupported"` 拒绝，"cold" 与 "native" 等价
+   * 放行）。
    */
   conversation: "native" | "cold" | "unsupported";
   /** 决定 persona 路由策略（file/flag/prompt 通道）。 */
@@ -321,7 +322,7 @@ export interface ModelCatalogEntry {
  *
  * 字段裁决（对照 core orchestration/models/types.ts AgentCallOpts，2026-09-09）：
  * - 入选 = 引擎消费面：任务语义（prompt/schema/thinkingLevel/skill/skillPath/agent/persona 注入）、
- *   轮次预算（maxTurns/graceTurns/conversation/idleTimeoutMs）、隔离与权限（worktree/
+ *   轮次预算（maxTurns/graceTurns/idleTimeoutMs）、隔离与权限（worktree/
  *   fork/forkSource/denyTools/permissionMode）、诊断（description/scene）；
  * - 排除并改挂 run.params.ctx（协议层已单列，task 内双写会分叉）：model（→ctx.model）、
  *   schemaEnv（→ctx.schemaEnv）、cwd（→ctx.cwd）、engineFallback（→ctx.engineFallback）；
@@ -368,9 +369,7 @@ export interface AgentCallOpts {
   forkSource?: string;
   /** Filesystem isolation: 新建 worktree | 复用外部已创建 worktree | 不隔离。 */
   worktree?: boolean | WorktreeHandle;
-  /** 可持续对话模式：true = 轮次完成进 idle 态等待 message 续聊。 */
-  conversation?: boolean;
-  /** 空闲超时毫秒数（仅 conversation 模式有意义）。显式 0/负 = 禁用 idle GC。 */
+  /** 空闲超时毫秒数（[modeless] 全体 record 的 idle 回收节奏；显式 0/负 = 禁用 idle GC）。 */
   idleTimeoutMs?: number;
   /** 工具 denylist（各引擎做语法映射）。 */
   denyTools?: string[];

package/src/protocol/engine-protocol.ts

@@ -11,10 +11,11 @@
 // 不影响其他引擎与宿主。
 //
 // [v1.x 增量语义（chat-domain 设计 §3.2 D1-A/§3.3）][H1 后历史叙述——run.params.chat
-// 已随 U6 删除，现唯一会话形态键 = run.params.resume]：chat 域增量（原 run.params.chat
-// 可选参数、host/streamDelta 的 recordId 关联形态）曾以**可选载荷/可选参数**形态向后
-// 兼容，major 不 bump、不引入 minor 协商位：
-//   - 新 core × 旧引擎：conversation 请求（resume 续聊形态）被 conversation gate
+// 已随 U6 删除，现唯一会话形态键 = run.params.resume；[modeless 波2] 协议 task 的
+// conversation 键已删（core 侧 deprecated 参数不再上 wire，resume 键携带全部会话
+// 形态）]：chat 域增量曾以**可选载荷/可选参数**形态向后兼容，major 不 bump、不引入
+// minor 协商位：
+//   - 新 core × 旧引擎：会话形态请求（resume 续聊）被 conversation gate
 //     同步拒（manifest 无 gate 位，
 //     A6 方向——engine_capability_unsupported + 升级引擎包指引）；run 域零影响；
 //   事件变体增量同政策（例：activity 活性信号变体）：新变体以可选载荷形态进

package/src/protocol/error-codes.ts

@@ -101,33 +101,32 @@ export function engineProtocolMismatchError(engineVersion: number): EngineSdkErr
 }
 
 // ============================================================
-// [v1.x] conversation gate 位负向：conversation 请求（resume 续聊会话形态）同步拒
+// conversation gate 位负向：manifest 能力轴（message 资格 / 「怎么续」形态轴）
 // ============================================================
 
 /**
- * [v1.x] resume 会话形态（run.params.resume）的 gate 拒绝具名错误（chat-domain
- * 设计 §3.2 D1-A + 验收 A6：manifest 无 conversation gate 位的引擎收到
- * conversation 请求 → 同步拒；[H1] 文案随 D5 语义收窄——续聊 = resume 续聊）。
- * 文案契约对齐 core capability-gate.ts conversation 分支（错误码
- * engine_capability_unsupported + 「去掉参数 / 修 manifest / 升级引擎包」恢复指引）
- * ——W3 chat 路由切协议客户端时以本构造器替换 core 内联文案，保持两侧一致。
+ * 引擎 conversation 位拒绝的具名错误（[modeless 波2] 语义：无 resume 续聊通道的
+ * 引擎，message 续聊资格被拒——manifest conversation 能力轴消费，core
+ * capability-gate 的 conversation 分支与 message 资格门双写点共用本构造器）。
+ * 文案契约：错误码 engine_capability_unsupported + 「去掉参数 / 修 manifest /
+ * 升级引擎包」恢复指引，两侧一致防漂移。
  */
 export function engineConversationUnsupportedError(engineId: string): EngineSdkError {
   return new EngineSdkError(
     "engine_capability_unsupported",
     `engine '${engineId}' 不支持 resume 续聊（capabilities.conversation = 'unsupported'，` +
       `manifest 无 conversation gate 位）`,
-    `去掉 conversation 参数（一次性任务默认形态），或修 manifest capabilities / 升级引擎包（若引擎实际支持该能力）`,
+    `去掉 conversation 参数（modeless 下无行为效果），或修 manifest capabilities / 升级引擎包（若引擎实际支持该能力）`,
     { engineId, capability: "conversation", declared: "unsupported" },
   );
 }
 
 /**
- * [v1.x] resume 会话形态（run.params.resume / task.conversation=true）派发前的同步 gate：
- * manifest conversation 位 unsupported 即抛 engineConversationUnsupportedError——
- * 进程/record 创建前同步拒（A6：run 域不受影响，仅 chat 面被拦）。
- * 判据单源：core 侧 capability-gate.assertTaskShapeSupported 的 conversation 分支
- * 覆盖同一能力位，协议客户端路径（W3 接线）消费本函数，防两处判据漂移。
+ * resume 会话形态（run.params.resume——唯一会话形态键）派发前的同步 gate：
+ * manifest conversation 位 unsupported 即抛 engineConversationUnsupportedError
+ * ——进程/record 创建前同步拒（A6 方向防御：manifest/实装漂移时引擎侧自拒，
+ * 与 core capability-gate 同一能力位，防两侧判据漂移）。[modeless 波2] 协议
+ * task 的 conversation 键已删，本 gate 只对 resume 形态键生效。
  */
 export function assertChatConversationSupported(
   engineId: string,