@zhushanwen/subagent-engine-sdk 0.2.1 → 0.3.0

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, k as ResumeAnchor, c as AgentOutcome, I as InteractAction, i as InteractResult, S as SessionView } from './contract-types-sSlgppBC.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-ByIFoLrY.js';
 
 /**
  * 引擎进程内全量任务声明 = SDK AgentCallOpts 引擎面子集 + 协议 ctx 还原字段（model/
@@ -26,7 +26,16 @@ interface EngineCtxModel {
 interface EngineStream {
     onDelta(delta: string): void;
 }
-/** run 的运行期上下文（core RunContext 结构等价镜像；chat? = 会话形态参数，缺省一次性任务）。 */
+/**
+ * 无隔离池引擎的恒定池 key（pi / zcode 共用；值锚定）：两引擎进程内全局一份运行态
+ * （pi = PI_CODING_AGENT_DIR 全局一份，zcode = 共享宿主 HOME + journal 固定分组），
+ * poolKey 恒本值。core（PI_POOL_KEY / JOURNAL_INITIAL_POOL_KEY）与两引擎包
+ * （PI_POOL_KEY / ZCODE_SHARED_POOL_KEY）的等值异名常量一律 = 本常量——**值逐字
+ * 不变**（存量 journal 落盘路径与记录含该值分段，改名不改值）。zcode 池化引擎在
+ * prepare 期经 ctx.onPoolResolved retarget 到实际池 key，与本占位值不冲突。
+ */
+declare const SHARED_POOL_KEY = "shared";
+/** run 的运行期上下文（core RunContext 结构等价镜像；resume? = 会话形态参数，缺省一次性任务）。 */
 interface RunContext {
     taskId: string;
     poolKey: string;
@@ -39,6 +48,18 @@ interface RunContext {
         from: string;
         reason: string;
     };
+    /**
+     * [F6] 根 session id（协议 run.params.ctx.sessionRootId 的进程内还原）——pi 引擎
+     * relay 归属键 SESSION_ID 的权威来源。additive 可选：宿主缺省不传。
+     */
+    sessionRootId?: string;
+    /**
+     * [Option C 协议化] 权威 subagent session 目录（协议 run.params.ctx.sessionDir 的
+     * 进程内还原）——pi 引擎组装 `--session-dir` 的唯一权威值（宿主
+     * getSubagentSessionDir 推导，引擎不自推导）。additive 可选：缺省走引擎内
+     * [LEGACY] fallback（独立运行/测试形态）。
+     */
+    sessionDir?: string;
     onPoolResolved?: (poolKey: string) => void;
     onHandleReady?: (partial: Pick<EngineHandleData, "sessionRef" | "poolKey">) => void;
     /** 一次性子进程 pid 上报（host/childSpawned 载荷形态；ChildProcess 句柄不跨协议面）。 */
@@ -47,11 +68,24 @@ interface RunContext {
         killed: boolean;
     }) => void;
     /**
-     * [v1.x] chat 会话形态参数（协议 run.params.chat 的进程内还原；缺省 = 一次性任务
-     * 形态）。recordId = chat 轮次关联键与 interact 定位键；resume 锚点存在 = 冷续
-     * （--session 续写原文件），不存在 = 首轮新建。
+     * 子进程退出态上报（host/childStateChanged 载荷形态；SR-4 接线：宿主镜像据此取消
+     * 该 pid 的挂起 dialog）。引擎侧只在 exited 相位上报——running 由 onChildSpawned 覆盖。
+     */
+    onChildStateChanged?: (p: {
+        pid: number;
+        recordId: string;
+        state: "running" | "exited";
+        killed: boolean;
+        exitCode?: number;
+        signal?: string;
+    }) => void;
+    /**
+     * [H1 U6 终态] resume 续聊参数（协议 run.params.resume 的进程内还原；唯一会话形态
+     * 键——原 v1.x `chat` 字段已随键切换退役）。recordId = 轮次关联键与镜像帧锚定键；
+     * resume 锚点存在 = 冷续（--session 续写原文件），不存在 = 首轮新建。缺省 =
+     * 一次性任务形态。
      */
-    chat?: {
+    resume?: {
         recordId: string;
         resume?: ResumeAnchor;
     };
@@ -71,7 +105,6 @@ interface EnginePort {
         force?: boolean;
     }): Promise<ProbeReport>;
     run(task: EngineAgentCallOpts, ctx: RunContext): Promise<EngineRunResult>;
-    interact(handle: EngineHandle, action: InteractAction): Promise<InteractResult>;
     read(handle: EngineHandle): Promise<SessionView>;
     listModels?(): Array<{
         id: string;
@@ -85,4 +118,4 @@ interface EnginePort {
 /** ctx.ctxModel（"provider/id" canonical 词形）→ EngineCtxModel。 */
 declare function parseCtxModel(ref: string | undefined): EngineCtxModel | undefined;
 
-export { type EngineAgentCallOpts, type EngineCtxModel, type EngineHandle, type EnginePort, type EngineRunResult, type EngineStream, type RunContext, parseCtxModel };
+export { type EngineAgentCallOpts, type EngineCtxModel, type EngineHandle, type EnginePort, type EngineRunResult, type EngineStream, type RunContext, SHARED_POOL_KEY, parseCtxModel };

package/dist/port-contract.js

@@ -1,7 +1,9 @@
 import {
+  SHARED_POOL_KEY,
   parseCtxModel
-} from "./chunk-RULLX6C6.js";
+} from "./chunk-LQR73V67.js";
 import "./chunk-JSBRDJBE.js";
 export {
+  SHARED_POOL_KEY,
   parseCtxModel
 };

package/dist/protocol/index.cjs

@@ -48,7 +48,6 @@ __export(protocol_exports, {
   errorResponseFrameSchema: () => errorResponseFrameSchema,
   isEngineErrorPassthroughCode: () => isEngineErrorPassthroughCode,
   isEngineProtocolErrorCode: () => isEngineProtocolErrorCode,
-  isHostRoundLifecycleParams: () => isHostRoundLifecycleParams,
   isHostStreamDeltaParams: () => isHostStreamDeltaParams,
   isNotificationFrame: () => isNotificationFrame,
   isProtocolVersionCompatible: () => isProtocolVersionCompatible,
@@ -59,6 +58,7 @@ __export(protocol_exports, {
   protocolErrorSchema: () => protocolErrorSchema,
   requestFrameSchema: () => requestFrameSchema,
   reverseRequestFrameSchema: () => reverseRequestFrameSchema,
+  runSessionParamsSchema: () => runSessionParamsSchema,
   schemaEmulationFailedDetail: () => schemaEmulationFailedDetail,
   successResponseFrameSchema: () => successResponseFrameSchema
 });
@@ -114,7 +114,6 @@ var PROTOCOL_METHODS = [
   "probe",
   "run",
   "cancel",
-  "interact",
   "read",
   "listModels",
   "validateModel",
@@ -131,8 +130,7 @@ var REVERSE_CHANNELS = [
   "host/poolResolved",
   "host/handleReady",
   "host/childSpawned",
-  "host/childStateChanged",
-  "host/roundLifecycle"
+  "host/childStateChanged"
 ];
 var REVERSE_CHANNEL_TIMEOUT_CLASS = {
   "host/log": "data-plane",
@@ -141,7 +139,6 @@ var REVERSE_CHANNEL_TIMEOUT_CLASS = {
   "host/handleReady": "data-plane",
   "host/childSpawned": "data-plane",
   "host/childStateChanged": "data-plane",
-  "host/roundLifecycle": "data-plane",
   "host/askUser": "interaction",
   "host/permission": "interaction"
 };
@@ -153,17 +150,6 @@ function isHostStreamDeltaParams(value) {
   if (hasRunId === hasRecordId) return false;
   return typeof v.delta === "string";
 }
-function isHostRoundLifecycleParams(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const v = value;
-  const hasRunId = typeof v.runId === "string";
-  const hasRecordId = typeof v.recordId === "string";
-  if (hasRunId === hasRecordId) return false;
-  if (v.phase === "settled" || v.phase === "idle") return true;
-  if (v.phase !== "failed") return false;
-  const err = v.error;
-  return typeof err === "object" && err !== null && typeof err.code === "string" && typeof err.message === "string";
-}
 
 // src/protocol/error-codes.ts
 var ENGINE_PROTOCOL_ERROR_CODES = [
@@ -215,7 +201,7 @@ function engineProtocolMismatchError(engineVersion) {
 function engineConversationUnsupportedError(engineId) {
   return new EngineSdkError(
     "engine_capability_unsupported",
-    `engine '${engineId}' \u4E0D\u652F\u6301 conversation\uFF08capabilities.conversation = 'unsupported'\uFF0Cmanifest \u65E0 conversation gate \u4F4D\u2014\u2014\u65E0\u540C\u8FDB\u7A0B idle \u590D\u7528\uFF0Cmessage/close \u4EA4\u4E92\u63A7\u5236\u9762\u4E0D\u53EF\u7528\uFF09`,
+    `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`,
     { engineId, capability: "conversation", declared: "unsupported" }
   );
@@ -316,6 +302,7 @@ var notificationFrameSchema = {
                 "turn_end",
                 "message_end",
                 "compaction",
+                "activity",
                 "error"
               ]
             }
@@ -354,6 +341,27 @@ var FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS = [
   "secret"
 ];
 var REVERSE_CHANNEL_NAMES = REVERSE_CHANNELS;
+var runSessionParamsSchema = {
+  $schema: "http://json-schema.org/draft-07/schema#",
+  title: "EngineRunSessionParams",
+  type: "object",
+  additionalProperties: false,
+  required: ["recordId"],
+  properties: {
+    recordId: { type: "string" },
+    resume: {
+      type: "object",
+      additionalProperties: false,
+      required: ["sessionRef", "poolKey"],
+      properties: {
+        // ResumeAnchor.sessionRef = Record<string, string>（引擎定位键值对）
+        sessionRef: { type: "object", additionalProperties: { type: "string" } },
+        poolKey: { type: "string" },
+        journalPath: { type: "string" }
+      }
+    }
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CANCEL_SETTLE_GRACE_MS,
@@ -384,7 +392,6 @@ var REVERSE_CHANNEL_NAMES = REVERSE_CHANNELS;
   errorResponseFrameSchema,
   isEngineErrorPassthroughCode,
   isEngineProtocolErrorCode,
-  isHostRoundLifecycleParams,
   isHostStreamDeltaParams,
   isNotificationFrame,
   isProtocolVersionCompatible,
@@ -395,6 +402,7 @@ var REVERSE_CHANNEL_NAMES = REVERSE_CHANNELS;
   protocolErrorSchema,
   requestFrameSchema,
   reverseRequestFrameSchema,
+  runSessionParamsSchema,
   schemaEmulationFailedDetail,
   successResponseFrameSchema
 });

package/dist/protocol/index.d.cts

@@ -1,7 +1,6 @@
-import { P as ProtocolError } from '../error-codes-DHco5-i_.cjs';
-export { A as AnyFrame, 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, 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-DHco5-i_.cjs';
-import { E as EngineCapabilities, M as ModelCatalogEntry, h as EngineHandleData, I as InteractAction, A as AgentCallOpts, k as ResumeAnchor, P as ProbeReport, c as AgentOutcome, i as InteractResult, S as SessionView, e as AgentUsage } from '../contract-types-sSlgppBC.cjs';
-export { a as AgentEvent, b as AgentFailureKind, d as AgentOutcomeUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, j as InternalToolCall, R as ReplayedTurn, T as ToolCall, l as ToolCallEntry, m as ToolCallResult, n as Turn, W as WorktreeHandle } from '../contract-types-sSlgppBC.cjs';
+export { A as AnyFrame, 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-DCiilt_8.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-ByIFoLrY.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-ByIFoLrY.cjs';
 import { UiRequest, UiResponse } from '../ui-types.cjs';
 
 /** 协议版本（引擎包 manifest `xyz-agent.subagentEngine.protocol` 与 initialize 应答同值）。 */
@@ -33,17 +32,20 @@ declare const ENGINE_EVENT_COALESCE_DEFAULT = "0";
 /**
  * 反向请求超时二分（帧④注释，R9-2）：
  * - 数据面类（host/log / host/streamDelta / host/poolResolved / host/handleReady /
- *   host/childSpawned / host/childStateChanged / host/roundLifecycle[v1.x]）：10s 未答 =
- *   引擎故障；
+ *   host/childSpawned / host/childStateChanged）：10s 未答 = 引擎故障；
  * - 人机交互类（host/askUser / host/permission）：不设统一超时——core 先回 {ack:true}，
  *   结果异步到达；按 ADR-0047「静默 ≠ 卡死」用无进展检测/用户取消，不据此判引擎故障。
  */
 type ReverseRequestTimeoutClass = "data-plane" | "interaction";
 
-/** 正向方法名联合（恰好 10 个；PROTOCOL_METHODS 常量数组与之同源互证）。 */
-type ProtocolMethod = "initialize" | "probe" | "run" | "cancel" | "interact" | "read" | "listModels" | "validateModel" | "dispose" | "ping";
+/**
+ * 正向方法名联合（恰好 9 个；PROTOCOL_METHODS 常量数组与之同源互证）。
+ * [H1] `interact` 成员已随 chat-run 统一退役（docs/design/subagent-chat-run-unification.md
+ * §3.3 D5：续聊轮统一为「新 run + resume 锚点」，U5 删除）。
+ */
+type ProtocolMethod = "initialize" | "probe" | "run" | "cancel" | "read" | "listModels" | "validateModel" | "dispose" | "ping";
 /** 方法名全集（运行时顺序化枚举；与 ProtocolMethod 的同源关系由测试断言）。 */
-declare const PROTOCOL_METHODS: readonly ["initialize", "probe", "run", "cancel", "interact", "read", "listModels", "validateModel", "dispose", "ping"];
+declare const PROTOCOL_METHODS: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping"];
 /**
  * run 上下文（RunContext 字段映射的协议承载，设计 §3.3 RunContext 映射表）。
  */
@@ -65,19 +67,35 @@ interface RunContextParams {
     };
     /** 事件粒度请求（引擎按 capabilities.eventGranularity 实际能力执行）。 */
     streamMode?: "stream" | "coarse";
+    /**
+     * [F6] 根 session id——pi 引擎 relay 归属键 SESSION_ID 的权威来源（生产三来源
+     * ①本字段 ②宿主 env ③根进程 env 中，宿主派发恒走①）。additive 可选：旧引擎忽略
+     * 未知字段，undefined 不上 wire。
+     */
+    sessionRootId?: string;
+    /**
+     * [Option C 协议化] 权威 subagent session 目录——宿主以 getSubagentSessionDir
+     * (agentDir, rootCwd) 推导（宿主单一权威，Fix Gate B S6：引擎本地推导与宿主布局
+     * 三处不等价 → 跨重启续聊链断裂）。引擎用它组装 pi `--session-dir`，不自推导；
+     * 缺省（独立运行/测试）走引擎内 [LEGACY] fallback。additive 可选：旧引擎忽略
+     * 未知字段，undefined 不上 wire。
+     */
+    sessionDir?: string;
 }
 /**
- * [v1.x] chat 会话形态参数——HostChatRoundTicket 五字段过协议映射中「record」的
- * 承载位（docs/design/chat-domain-v1x-liveness-governance.md §3.2 D1 五字段映射）：
+ * [H1] run 的 resume 会话形态参数（设计 docs/design/subagent-chat-run-unification.md
+ * §3.3 D3 + §5 U1/U6 行）：原 RunChatParams（v1.x chat 会话形态参数）的泛化改名终态，
+ * 载荷同形（recordId + resume 锚点，ResumeAnchor 不变），仅键名从「chat 会话形态」
+ * 泛化为「resume 续聊」。
  *   - recordId：core 预建 record 的关联键（引擎据此回填 handle.sessionRef、上报
- *     host/childSpawned|childStateChanged 与 host/roundLifecycle 的 record 键形态）；
+ *     host/childSpawned|childStateChanged 的 record 键形态）；
  *   - resume：冷续锚点（重开已 idle 的 session 续聊；缺省 = 新 session）。对照
  *     core SpawnResumeOpts——sessionFile 经 anchor.sessionRef 携带，model/
  *     thinkingLevel 防漂移覆盖走既有 task/ctx 字段，不双写。
- * task.conversation === true 时必传（chat 路由前置 gate：manifest conversation 位
- * unsupported 的引擎同步拒 engine_capability_unsupported——见 error-codes.ts）。
+ * [H1 U6 已切换] `chat` 键整体退役（读写端同批切换，无「写新读旧」窗口），本键为
+ * 唯一会话形态参数。载荷 schema 权威 = runSessionParamsSchema（schema.ts）。
  */
-interface RunChatParams {
+interface RunResumeParams {
     recordId: string;
     resume?: ResumeAnchor;
 }
@@ -109,11 +127,11 @@ interface RunParams {
     task: AgentCallOpts;
     ctx: RunContextParams;
     /**
-     * [v1.x 可选增量] chat 会话形态参数（task.conversation=true 的 chat 路由承载）。
-     * 缺省 = 一次性任务形态，v1 引擎/宿主语义不变（向后兼容：旧引擎忽略未知字段，
-     * 帧级 schema params 不做深校验）。续聊/关断不经此参数——走既有 interact。
+     * [H1 U6 终态] resume 续聊参数（唯一会话形态键；原 v1.x `chat` 键已随键切换退役，
+     * 见 RunResumeParams）。缺省 = 一次性任务形态（向后兼容：旧引擎忽略未知字段，
+     * 帧级 schema params 不做深校验）。additive 可选：undefined 不上 wire。
      */
-    chat?: RunChatParams;
+    resume?: RunResumeParams;
 }
 /** run 终态应答（期间事件经 event 通知；长运行方法，应答到达即终态）。 */
 interface RunResult {
@@ -131,10 +149,6 @@ interface CancelParams {
 interface CancelResult {
     ok: true;
 }
-interface InteractParams {
-    handle: EngineHandleData;
-    action: InteractAction;
-}
 interface ReadParams {
     handle: EngineHandleData;
     /** 数据根必填：存量池时代引擎自算池/journal 相对 dbPath 的定位需要它（设计钉死）。 */
@@ -174,7 +188,6 @@ interface ProtocolParamsMap {
     probe: ProbeParams;
     run: RunParams;
     cancel: CancelParams;
-    interact: InteractParams;
     read: ReadParams;
     listModels: ListModelsParams;
     validateModel: ValidateModelParams;
@@ -187,7 +200,6 @@ interface ProtocolResultMap {
     probe: ProbeReport;
     run: RunResult;
     cancel: CancelResult;
-    interact: InteractResult;
     read: SessionView;
     listModels: ListModelsResult;
     validateModel: ValidateModelResult;
@@ -195,13 +207,17 @@ interface ProtocolResultMap {
     ping: PingResult;
 }
 
-/** 反向通道名联合（恰好 9 个；REVERSE_CHANNELS 常量数组与之同源互证）。 */
-type ReverseChannel = "host/log" | "host/askUser" | "host/permission" | "host/streamDelta" | "host/poolResolved" | "host/handleReady" | "host/childSpawned" | "host/childStateChanged" | "host/roundLifecycle";
-declare const REVERSE_CHANNELS: readonly ["host/log", "host/askUser", "host/permission", "host/streamDelta", "host/poolResolved", "host/handleReady", "host/childSpawned", "host/childStateChanged", "host/roundLifecycle"];
+/**
+ * 反向通道名联合（恰好 8 个；REVERSE_CHANNELS 常量数组与之同源互证）。
+ */
+type ReverseChannel = "host/log" | "host/askUser" | "host/permission" | "host/streamDelta" | "host/poolResolved" | "host/handleReady" | "host/childSpawned" | "host/childStateChanged";
+/**
+ * 通道名全集（运行时顺序化枚举；与 ReverseChannel 的同源关系由测试断言）。
+ */
+declare const REVERSE_CHANNELS: readonly ["host/log", "host/askUser", "host/permission", "host/streamDelta", "host/poolResolved", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
 /**
  * 超时二分归属（10s 数据面 / 不设统一超时的人机交互面）。实现归 W2 EngineClient；
  * 引擎侧自灭计时（W12）复用同表——已 ack 的 askUser 等待不计入 in-flight（R9-2）。
- * host/roundLifecycle 属数据面（终态回执语义：宿主必须确认收到，10s 未答 = 引擎故障）。
  */
 declare const REVERSE_CHANNEL_TIMEOUT_CLASS: Record<ReverseChannel, ReverseRequestTimeoutClass>;
 /** host/log：引擎日志落宿主日志（对齐 core HostServices.log 调用面）。 */
@@ -240,11 +256,9 @@ type HostPermissionResult = {
 /**
  * host/streamDelta：UI 实时通道（双通道之一；与 event 通知并行的渲染加速面）。
  *
- * [v1.x 关联键扩展——D1-A 裁定，W1 落地不再临场选择]：
- *   - run 域轮（含 run 会话形态首轮）：runId 关联（v1 现状不变，runId 由 core 在
- *     run 帧分配）；
- *   - interact 发起的续聊轮：**recordId** 关联（续聊轮无独立 runId——InteractParams/
- *     InteractResult 均不含，recordId 经 handle.sessionRef 送达引擎）。
+ * [H1 U6 现行语义] 关联键恒 runId（run 域轮与 chat 续聊轮已统一为 run——续聊轮
+ * 是携带 resume 锚点的新 run，runId 由 core 在 run 帧分配）。recordId 键分支是
+ * v1.x 旧引擎的兼容载荷形态（存量兼容读，现行引擎不写）。
  * 两键互斥（undefined 孪生位防双填），消费侧经 isHostStreamDeltaParams 收窄。
  */
 type HostStreamDeltaParams = {
@@ -298,57 +312,6 @@ interface HostChildStateChangedParams {
     exitCode?: number;
     signal?: string;
 }
-/**
- * 轮次关联键（D1-A 裁定的类型面）：run 域轮 = runId（v1 现状）；interact 续聊轮 =
- * recordId（经 handle.sessionRef）。undefined 孪生位保证两键互斥。
- */
-interface RoundKeyedByRun {
-    runId: string;
-    recordId?: undefined;
-}
-interface RoundKeyedByRecord {
-    recordId: string;
-    runId?: undefined;
-}
-/**
- * 轮次终态相位（事件即 record 回写载体——chat 域 record 处置由相位一一映射，
- * 设计 D2 裁决表 conversation 行：settled/idle 轮收口不终态、failed 标 failed）：
- *   - settled：轮收敛（输出完整）。消费点 = settled-watchdog disarm + D3 abort
- *     收敛判据（cancel 受理后等本事件，超 CANCEL_SETTLE_GRACE_MS 走杀链）；
- *   - idle：轮收口 + 会话进 idle 稳态（core 侧 doFinalizeRoundToIdle + idle 定时器
- *     锚点）。settled 与 idle 是两个锚点：watchdog 在 settled 即解除，idle 管置闲；
- *   - failed：轮异常终止（引擎自知失败，如 EPIPE 兜底耗尽）——error 如实上报，
- *     record 标 failed（与 run 域 AgentOutcome.error 的「失败收口」语义对齐）。
- * usage 为本轮 message_end 增量（interact 续聊轮无 event 通知通道，用量经本帧回填）。
- * 不设 seq：stdio NDJSON 单连接有序 + 数据面应答确认，无重排/重放面（与 event
- * 通知的 seq 对照——后者镜像进程内事件流基线，本帧无基线可镜像）。
- */
-interface RoundSettledPhase {
-    phase: "settled";
-    usage?: AgentUsage;
-}
-interface RoundIdlePhase {
-    phase: "idle";
-    usage?: AgentUsage;
-    /** 冷续锚点回填（session 滚动/compaction 后锚点可能变化，宿主按帧刷新）。 */
-    anchor?: ResumeAnchor;
-}
-interface RoundFailedPhase {
-    phase: "failed";
-    /** 失败原因（结构对齐协议 error 帧——code/message/recovery 可操作闭环）。 */
-    error: ProtocolError;
-    anchor?: ResumeAnchor;
-}
-/** 相位联合（消费侧 switch(phase) 判别用）。 */
-type RoundLifecyclePhase = RoundSettledPhase | RoundIdlePhase | RoundFailedPhase;
-/** host/roundLifecycle 载荷：关联键（run|record）× 相位（settled|idle|failed）。 */
-type HostRoundLifecycleParams = (RoundKeyedByRun & RoundSettledPhase) | (RoundKeyedByRun & RoundIdlePhase) | (RoundKeyedByRun & RoundFailedPhase) | (RoundKeyedByRecord & RoundSettledPhase) | (RoundKeyedByRecord & RoundIdlePhase) | (RoundKeyedByRecord & RoundFailedPhase);
-/**
- * roundLifecycle 载荷结构判定：关联键互斥 + phase 词表 + 各相位专属形状
- * （failed 必含 error.code/message）。引擎侧发帧前自检与 core 侧消费共用，
- * 防两侧各写一份判别（与 isHostStreamDeltaParams 同理）。
- */
-declare function isHostRoundLifecycleParams(value: unknown): value is HostRoundLifecycleParams;
 /** 通道 → 载荷类型映射。 */
 interface ReverseChannelParamsMap {
     "host/log": HostLogParams;
@@ -359,7 +322,6 @@ interface ReverseChannelParamsMap {
     "host/handleReady": HostHandleReadyParams;
     "host/childSpawned": HostChildSpawnedParams;
     "host/childStateChanged": HostChildStateChangedParams;
-    "host/roundLifecycle": HostRoundLifecycleParams;
 }
 /** 通道 → 异步/同步结果类型映射（ack 两阶段通道的第二阶段 result）。 */
 interface ReverseChannelResultMap {
@@ -383,9 +345,6 @@ interface ReverseChannelResultMap {
     "host/childStateChanged": {
         ok: true;
     };
-    "host/roundLifecycle": {
-        ok: true;
-    };
 }
 
 /** 协议错误对象 schema。 */
@@ -424,7 +383,7 @@ declare const requestFrameSchema: {
         };
         readonly method: {
             readonly type: "string";
-            readonly enum: readonly ["initialize", "probe", "run", "cancel", "interact", "read", "listModels", "validateModel", "dispose", "ping"];
+            readonly enum: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping"];
         };
         readonly params: {};
     };
@@ -506,7 +465,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", "error"];
+                            readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error"];
                         };
                     };
                 };
@@ -527,7 +486,7 @@ declare const reverseRequestFrameSchema: {
         };
         readonly method: {
             readonly type: "string";
-            readonly enum: readonly ["host/log", "host/askUser", "host/permission", "host/streamDelta", "host/poolResolved", "host/handleReady", "host/childSpawned", "host/childStateChanged", "host/roundLifecycle"];
+            readonly enum: readonly ["host/log", "host/askUser", "host/permission", "host/streamDelta", "host/poolResolved", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
         };
         readonly params: {};
     };
@@ -546,7 +505,7 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
             };
             readonly method: {
                 readonly type: "string";
-                readonly enum: readonly ["initialize", "probe", "run", "cancel", "interact", "read", "listModels", "validateModel", "dispose", "ping"];
+                readonly enum: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping"];
             };
             readonly params: {};
         };
@@ -626,7 +585,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", "error"];
+                                readonly enum: readonly ["tool_start", "tool_end", "text_delta", "thinking_delta", "turn_end", "message_end", "compaction", "activity", "error"];
                             };
                         };
                     };
@@ -646,7 +605,7 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
             };
             readonly method: {
                 readonly type: "string";
-                readonly enum: readonly ["host/log", "host/askUser", "host/permission", "host/streamDelta", "host/poolResolved", "host/handleReady", "host/childSpawned", "host/childStateChanged", "host/roundLifecycle"];
+                readonly enum: readonly ["host/log", "host/askUser", "host/permission", "host/streamDelta", "host/poolResolved", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
             };
             readonly params: {};
         };
@@ -681,5 +640,45 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
 declare const FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS: readonly ["apikey", "api_key", "token", "credential", "password", "secret"];
 /** 反向通道名词表导出（schema enum 与 W2 路由同源）。 */
 declare const REVERSE_CHANNEL_NAMES: readonly ReverseChannel[];
+/**
+ * run.params 的会话形态参数载荷 schema（draft-07 深载荷片段）。设计权威源：
+ * docs/design/subagent-chat-run-unification.md §3.3 D3 + §5 U1/U6 行。
+ *
+ * [H1 U6 已切换] 键切换单批完成后本 schema 面向唯一键 `resume`（RunResumeParams：
+ * recordId + 可选 ResumeAnchor），形状不变。帧级 schema（requestFrameSchema.params）
+ * 刻意不做深校验（见本文件头注释），本片段供消费方（引擎读端结构化报错 / 测试正负
+ * 样本）按需深校验。
+ */
+declare const runSessionParamsSchema: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly title: "EngineRunSessionParams";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["recordId"];
+    readonly properties: {
+        readonly recordId: {
+            readonly type: "string";
+        };
+        readonly resume: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["sessionRef", "poolKey"];
+            readonly properties: {
+                readonly sessionRef: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                    };
+                };
+                readonly poolKey: {
+                    readonly type: "string";
+                };
+                readonly journalPath: {
+                    readonly type: "string";
+                };
+            };
+        };
+    };
+};
 
-export { AgentCallOpts, AgentOutcome, AgentUsage, CANCEL_SETTLE_GRACE_MS, CRASH_REBUILD_BACKOFF_MS, CRASH_REBUILD_MAX_ATTEMPTS, type CancelParams, type CancelResult, type DisposeParams, type DisposeResult, ENGINE_EVENT_COALESCE_DEFAULT, ENGINE_EVENT_COALESCE_ENV, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, EngineCapabilities, EngineHandleData, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, type HostAskUserParams, type HostAskUserResult, type HostChildSpawnedParams, type HostChildStateChangedParams, type HostHandleReadyParams, type HostLogParams, type HostPermissionParams, type HostPermissionResult, type HostPoolResolvedParams, type HostRoundLifecycleParams, type HostStreamDeltaParams, type InitializeParams, type InitializeResult, InteractAction, type InteractParams, InteractResult, type ListModelsParams, type ListModelsResult, ModelCatalogEntry, PROTOCOL_METHODS, type PingParams, type PingResult, type ProbeParams, ProbeReport, ProtocolError, type ProtocolMethod, type ProtocolParamsMap, type ProtocolResultMap, REVERSE_CHANNELS, REVERSE_CHANNEL_NAMES, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReadParams, ResumeAnchor, type ReverseChannel, type ReverseChannelParamsMap, type ReverseChannelResultMap, type ReverseRequestTimeoutClass, type RoundFailedPhase, type RoundIdlePhase, type RoundKeyedByRecord, type RoundKeyedByRun, type RoundLifecyclePhase, type RoundSettledPhase, type RunChatParams, type RunContextParams, type RunParams, type RunResult, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, SessionView, type ValidateModelParams, type ValidateModelResult, errorResponseFrameSchema, isHostRoundLifecycleParams, isHostStreamDeltaParams, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, successResponseFrameSchema };
+export { AgentCallOpts, AgentOutcome, CANCEL_SETTLE_GRACE_MS, CRASH_REBUILD_BACKOFF_MS, CRASH_REBUILD_MAX_ATTEMPTS, type CancelParams, type CancelResult, type DisposeParams, type DisposeResult, ENGINE_EVENT_COALESCE_DEFAULT, ENGINE_EVENT_COALESCE_ENV, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, EngineCapabilities, EngineHandleData, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, type HostAskUserParams, type HostAskUserResult, type HostChildSpawnedParams, type HostChildStateChangedParams, type HostHandleReadyParams, type HostLogParams, type HostPermissionParams, type HostPermissionResult, type HostPoolResolvedParams, type HostStreamDeltaParams, type InitializeParams, type InitializeResult, type ListModelsParams, type ListModelsResult, ModelCatalogEntry, PROTOCOL_METHODS, type PingParams, type PingResult, type ProbeParams, ProbeReport, type ProtocolMethod, type ProtocolParamsMap, type ProtocolResultMap, REVERSE_CHANNELS, REVERSE_CHANNEL_NAMES, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReadParams, ResumeAnchor, type ReverseChannel, type ReverseChannelParamsMap, type ReverseChannelResultMap, type ReverseRequestTimeoutClass, type RunContextParams, type RunParams, type RunResult, type RunResumeParams, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, SessionView, type ValidateModelParams, type ValidateModelResult, errorResponseFrameSchema, isHostStreamDeltaParams, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema };