@zhushanwen/subagent-engine-sdk 0.3.0 → 0.4.0

package/dist/protocol/index.d.cts

@@ -1,6 +1,6 @@
-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';
+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';
 import { UiRequest, UiResponse } from '../ui-types.cjs';
 
 /** 协议版本（引擎包 manifest `xyz-agent.subagentEngine.protocol` 与 initialize 应答同值）。 */
@@ -31,16 +31,16 @@ declare const ENGINE_EVENT_COALESCE_ENV = "XYZ_ENGINE_EVENT_COALESCE";
 declare const ENGINE_EVENT_COALESCE_DEFAULT = "0";
 /**
  * 反向请求超时二分（帧④注释，R9-2）：
- * - 数据面类（host/log / host/streamDelta / host/poolResolved / host/handleReady /
+ * - 数据面类（host/log / host/streamDelta / host/handleReady /
  *   host/childSpawned / host/childStateChanged）：10s 未答 = 引擎故障；
- * - 人机交互类（host/askUser / host/permission）：不设统一超时——core 先回 {ack:true}，
+ * - 人机交互类（host/askUser）：不设统一超时——core 先回 {ack:true}，
  *   结果异步到达；按 ADR-0047「静默 ≠ 卡死」用无进展检测/用户取消，不据此判引擎故障。
  */
 type ReverseRequestTimeoutClass = "data-plane" | "interaction";
 
 /**
  * 正向方法名联合（恰好 9 个；PROTOCOL_METHODS 常量数组与之同源互证）。
- * [H1] `interact` 成员已随 chat-run 统一退役（docs/design/subagent-chat-run-unification.md
+ * [H1] `interact` 成员已随 chat-run 统一退役（docs/architecture/subagent-chat-run-unification.md
  * §3.3 D5：续聊轮统一为「新 run + resume 锚点」，U5 删除）。
  */
 type ProtocolMethod = "initialize" | "probe" | "run" | "cancel" | "read" | "listModels" | "validateModel" | "dispose" | "ping";
@@ -50,8 +50,6 @@ declare const PROTOCOL_METHODS: readonly ["initialize", "probe", "run", "cancel"
  * run 上下文（RunContext 字段映射的协议承载，设计 §3.3 RunContext 映射表）。
  */
 interface RunContextParams {
-    /** 隔离池归属（journal 归属错 = 缺失后果）。 */
-    poolKey: string;
     /** 任务工作目录（worktree 隔离时 = worktree 路径）。 */
     cwd: string;
     /** 请求模型 ref（未传 = 引擎缺省模型）。 */
@@ -83,7 +81,7 @@ interface RunContextParams {
     sessionDir?: string;
 }
 /**
- * [H1] run 的 resume 会话形态参数（设计 docs/design/subagent-chat-run-unification.md
+ * [H1] run 的 resume 会话形态参数（设计 docs/architecture/subagent-chat-run-unification.md
  * §3.3 D3 + §5 U1/U6 行）：原 RunChatParams（v1.x chat 会话形态参数）的泛化改名终态，
  * 载荷同形（recordId + resume 锚点，ResumeAnchor 不变），仅键名从「chat 会话形态」
  * 泛化为「resume 续聊」。
@@ -208,13 +206,13 @@ interface ProtocolResultMap {
 }
 
 /**
- * 反向通道名联合（恰好 8 个；REVERSE_CHANNELS 常量数组与之同源互证）。
+ * 反向通道名联合（恰好 6 个；REVERSE_CHANNELS 常量数组与之同源互证）。
  */
-type ReverseChannel = "host/log" | "host/askUser" | "host/permission" | "host/streamDelta" | "host/poolResolved" | "host/handleReady" | "host/childSpawned" | "host/childStateChanged";
+type ReverseChannel = "host/log" | "host/askUser" | "host/streamDelta" | "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"];
+declare const REVERSE_CHANNELS: readonly ["host/log", "host/askUser", "host/streamDelta", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
 /**
  * 超时二分归属（10s 数据面 / 不设统一超时的人机交互面）。实现归 W2 EngineClient；
  * 引擎侧自灭计时（W12）复用同表——已 ack 的 askUser 等待不计入 in-flight（R9-2）。
@@ -235,59 +233,24 @@ interface HostAskUserParams {
 }
 /** host/askUser 的最终结果（ack 两阶段第二阶段，异步应答帧②的 result）。 */
 type HostAskUserResult = UiResponse;
-/**
- * host/permission：权限询问（引擎请求宿主裁决工具执行）。
- * v1 骨架字段（设计未钉死载荷细节，细化归各引擎提取设计；W2 实装 core 应答端时
- * 若需扩展走 additive 演进）。
- */
-interface HostPermissionParams {
-    runId: string;
-    toolName: string;
-    args?: unknown;
-    /** 请求方向引擎给出的原因/说明（展示用）。 */
-    reason?: string;
-}
-/** host/permission 两阶段结果。 */
-type HostPermissionResult = {
-    approved: boolean;
-} | {
-    unsupported: true;
-};
 /**
  * host/streamDelta：UI 实时通道（双通道之一；与 event 通知并行的渲染加速面）。
  *
- * [H1 U6 现行语义] 关联键恒 runId（run 域轮与 chat 续聊轮已统一为 run——续聊轮
- * 是携带 resume 锚点的新 run，runId 由 core 在 run 帧分配）。recordId 键分支是
- * v1.x 旧引擎的兼容载荷形态（存量兼容读，现行引擎不写）。
- * 两键互斥（undefined 孪生位防双填），消费侧经 isHostStreamDeltaParams 收窄。
+ * 关联键恒为 runId（runId 由 core 在 run 帧分配）；[H1] chat 续聊轮经 resume run
+ * 复用 runId 关联（原 recordId 关联键随 interact 面退役删除）。
  */
-type HostStreamDeltaParams = {
+interface HostStreamDeltaParams {
     runId: string;
-    recordId?: undefined;
     delta: string;
-} | {
-    recordId: string;
-    runId?: undefined;
-    delta: string;
-};
-/** streamDelta 载荷结构判定（关联键互斥 + delta 形状；消费侧共用，防双侧各写一份）。 */
-declare function isHostStreamDeltaParams(value: unknown): value is HostStreamDeltaParams;
-/**
- * host/poolResolved：journal 落盘路径单一权威（契约：必须在首个事件 emit 前调用——
- * 否则 journal 归属错）。载荷 = core onPoolResolved(poolKey) 的 runId 关联形态。
- */
-interface HostPoolResolvedParams {
-    runId: string;
-    poolKey: string;
 }
 /**
  * host/handleReady：运行中句柄回填（core onHandleReady 语义：session/create 应答后、
  * 早于 run resolve；AGENTS.md 关键规则 9「重开 session 仍可见」的前提）。
+ * [池抽象降级 2026-09-13] 原 poolKey 字段已随协议面 poolKey 退役删除。
  */
 interface HostHandleReadyParams {
     runId: string;
     sessionRef: Record<string, string>;
-    poolKey: string;
 }
 /**
  * host/childSpawned：引擎内一次性子进程 pid 上报。
@@ -312,40 +275,6 @@ interface HostChildStateChangedParams {
     exitCode?: number;
     signal?: string;
 }
-/** 通道 → 载荷类型映射。 */
-interface ReverseChannelParamsMap {
-    "host/log": HostLogParams;
-    "host/askUser": HostAskUserParams;
-    "host/permission": HostPermissionParams;
-    "host/streamDelta": HostStreamDeltaParams;
-    "host/poolResolved": HostPoolResolvedParams;
-    "host/handleReady": HostHandleReadyParams;
-    "host/childSpawned": HostChildSpawnedParams;
-    "host/childStateChanged": HostChildStateChangedParams;
-}
-/** 通道 → 异步/同步结果类型映射（ack 两阶段通道的第二阶段 result）。 */
-interface ReverseChannelResultMap {
-    "host/log": {
-        ok: true;
-    };
-    "host/askUser": HostAskUserResult;
-    "host/permission": HostPermissionResult;
-    "host/streamDelta": {
-        ok: true;
-    };
-    "host/poolResolved": {
-        ok: true;
-    };
-    "host/handleReady": {
-        ok: true;
-    };
-    "host/childSpawned": {
-        ok: true;
-    };
-    "host/childStateChanged": {
-        ok: true;
-    };
-}
 
 /** 协议错误对象 schema。 */
 declare const protocolErrorSchema: {
@@ -486,7 +415,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"];
+            readonly enum: readonly ["host/log", "host/askUser", "host/streamDelta", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
         };
         readonly params: {};
     };
@@ -605,7 +534,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"];
+                readonly enum: readonly ["host/log", "host/askUser", "host/streamDelta", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
             };
             readonly params: {};
         };
@@ -638,11 +567,9 @@ 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 行。
+ * docs/architecture/subagent-chat-run-unification.md §3.3 D3 + §5 U1/U6 行。
  *
  * [H1 U6 已切换] 键切换单批完成后本 schema 面向唯一键 `resume`（RunResumeParams：
  * recordId + 可选 ResumeAnchor），形状不变。帧级 schema（requestFrameSchema.params）
@@ -662,7 +589,7 @@ declare const runSessionParamsSchema: {
         readonly resume: {
             readonly type: "object";
             readonly additionalProperties: false;
-            readonly required: readonly ["sessionRef", "poolKey"];
+            readonly required: readonly ["sessionRef"];
             readonly properties: {
                 readonly sessionRef: {
                     readonly type: "object";
@@ -670,9 +597,6 @@ declare const runSessionParamsSchema: {
                         readonly type: "string";
                     };
                 };
-                readonly poolKey: {
-                    readonly type: "string";
-                };
                 readonly journalPath: {
                     readonly type: "string";
                 };
@@ -681,4 +605,4 @@ declare const runSessionParamsSchema: {
     };
 };
 
-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 };
+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 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_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReadParams, ResumeAnchor, type ReverseChannel, type ReverseRequestTimeoutClass, type RunContextParams, type RunParams, type RunResult, type RunResumeParams, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, SessionView, type ValidateModelParams, type ValidateModelResult, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema };

package/dist/protocol/index.d.ts

@@ -1,6 +1,6 @@
-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-BUx92qYi.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-ByIFoLrY.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-ByIFoLrY.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';
+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';
 import { UiRequest, UiResponse } from '../ui-types.js';
 
 /** 协议版本（引擎包 manifest `xyz-agent.subagentEngine.protocol` 与 initialize 应答同值）。 */
@@ -31,16 +31,16 @@ declare const ENGINE_EVENT_COALESCE_ENV = "XYZ_ENGINE_EVENT_COALESCE";
 declare const ENGINE_EVENT_COALESCE_DEFAULT = "0";
 /**
  * 反向请求超时二分（帧④注释，R9-2）：
- * - 数据面类（host/log / host/streamDelta / host/poolResolved / host/handleReady /
+ * - 数据面类（host/log / host/streamDelta / host/handleReady /
  *   host/childSpawned / host/childStateChanged）：10s 未答 = 引擎故障；
- * - 人机交互类（host/askUser / host/permission）：不设统一超时——core 先回 {ack:true}，
+ * - 人机交互类（host/askUser）：不设统一超时——core 先回 {ack:true}，
  *   结果异步到达；按 ADR-0047「静默 ≠ 卡死」用无进展检测/用户取消，不据此判引擎故障。
  */
 type ReverseRequestTimeoutClass = "data-plane" | "interaction";
 
 /**
  * 正向方法名联合（恰好 9 个；PROTOCOL_METHODS 常量数组与之同源互证）。
- * [H1] `interact` 成员已随 chat-run 统一退役（docs/design/subagent-chat-run-unification.md
+ * [H1] `interact` 成员已随 chat-run 统一退役（docs/architecture/subagent-chat-run-unification.md
  * §3.3 D5：续聊轮统一为「新 run + resume 锚点」，U5 删除）。
  */
 type ProtocolMethod = "initialize" | "probe" | "run" | "cancel" | "read" | "listModels" | "validateModel" | "dispose" | "ping";
@@ -50,8 +50,6 @@ declare const PROTOCOL_METHODS: readonly ["initialize", "probe", "run", "cancel"
  * run 上下文（RunContext 字段映射的协议承载，设计 §3.3 RunContext 映射表）。
  */
 interface RunContextParams {
-    /** 隔离池归属（journal 归属错 = 缺失后果）。 */
-    poolKey: string;
     /** 任务工作目录（worktree 隔离时 = worktree 路径）。 */
     cwd: string;
     /** 请求模型 ref（未传 = 引擎缺省模型）。 */
@@ -83,7 +81,7 @@ interface RunContextParams {
     sessionDir?: string;
 }
 /**
- * [H1] run 的 resume 会话形态参数（设计 docs/design/subagent-chat-run-unification.md
+ * [H1] run 的 resume 会话形态参数（设计 docs/architecture/subagent-chat-run-unification.md
  * §3.3 D3 + §5 U1/U6 行）：原 RunChatParams（v1.x chat 会话形态参数）的泛化改名终态，
  * 载荷同形（recordId + resume 锚点，ResumeAnchor 不变），仅键名从「chat 会话形态」
  * 泛化为「resume 续聊」。
@@ -208,13 +206,13 @@ interface ProtocolResultMap {
 }
 
 /**
- * 反向通道名联合（恰好 8 个；REVERSE_CHANNELS 常量数组与之同源互证）。
+ * 反向通道名联合（恰好 6 个；REVERSE_CHANNELS 常量数组与之同源互证）。
  */
-type ReverseChannel = "host/log" | "host/askUser" | "host/permission" | "host/streamDelta" | "host/poolResolved" | "host/handleReady" | "host/childSpawned" | "host/childStateChanged";
+type ReverseChannel = "host/log" | "host/askUser" | "host/streamDelta" | "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"];
+declare const REVERSE_CHANNELS: readonly ["host/log", "host/askUser", "host/streamDelta", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
 /**
  * 超时二分归属（10s 数据面 / 不设统一超时的人机交互面）。实现归 W2 EngineClient；
  * 引擎侧自灭计时（W12）复用同表——已 ack 的 askUser 等待不计入 in-flight（R9-2）。
@@ -235,59 +233,24 @@ interface HostAskUserParams {
 }
 /** host/askUser 的最终结果（ack 两阶段第二阶段，异步应答帧②的 result）。 */
 type HostAskUserResult = UiResponse;
-/**
- * host/permission：权限询问（引擎请求宿主裁决工具执行）。
- * v1 骨架字段（设计未钉死载荷细节，细化归各引擎提取设计；W2 实装 core 应答端时
- * 若需扩展走 additive 演进）。
- */
-interface HostPermissionParams {
-    runId: string;
-    toolName: string;
-    args?: unknown;
-    /** 请求方向引擎给出的原因/说明（展示用）。 */
-    reason?: string;
-}
-/** host/permission 两阶段结果。 */
-type HostPermissionResult = {
-    approved: boolean;
-} | {
-    unsupported: true;
-};
 /**
  * host/streamDelta：UI 实时通道（双通道之一；与 event 通知并行的渲染加速面）。
  *
- * [H1 U6 现行语义] 关联键恒 runId（run 域轮与 chat 续聊轮已统一为 run——续聊轮
- * 是携带 resume 锚点的新 run，runId 由 core 在 run 帧分配）。recordId 键分支是
- * v1.x 旧引擎的兼容载荷形态（存量兼容读，现行引擎不写）。
- * 两键互斥（undefined 孪生位防双填），消费侧经 isHostStreamDeltaParams 收窄。
+ * 关联键恒为 runId（runId 由 core 在 run 帧分配）；[H1] chat 续聊轮经 resume run
+ * 复用 runId 关联（原 recordId 关联键随 interact 面退役删除）。
  */
-type HostStreamDeltaParams = {
+interface HostStreamDeltaParams {
     runId: string;
-    recordId?: undefined;
     delta: string;
-} | {
-    recordId: string;
-    runId?: undefined;
-    delta: string;
-};
-/** streamDelta 载荷结构判定（关联键互斥 + delta 形状；消费侧共用，防双侧各写一份）。 */
-declare function isHostStreamDeltaParams(value: unknown): value is HostStreamDeltaParams;
-/**
- * host/poolResolved：journal 落盘路径单一权威（契约：必须在首个事件 emit 前调用——
- * 否则 journal 归属错）。载荷 = core onPoolResolved(poolKey) 的 runId 关联形态。
- */
-interface HostPoolResolvedParams {
-    runId: string;
-    poolKey: string;
 }
 /**
  * host/handleReady：运行中句柄回填（core onHandleReady 语义：session/create 应答后、
  * 早于 run resolve；AGENTS.md 关键规则 9「重开 session 仍可见」的前提）。
+ * [池抽象降级 2026-09-13] 原 poolKey 字段已随协议面 poolKey 退役删除。
  */
 interface HostHandleReadyParams {
     runId: string;
     sessionRef: Record<string, string>;
-    poolKey: string;
 }
 /**
  * host/childSpawned：引擎内一次性子进程 pid 上报。
@@ -312,40 +275,6 @@ interface HostChildStateChangedParams {
     exitCode?: number;
     signal?: string;
 }
-/** 通道 → 载荷类型映射。 */
-interface ReverseChannelParamsMap {
-    "host/log": HostLogParams;
-    "host/askUser": HostAskUserParams;
-    "host/permission": HostPermissionParams;
-    "host/streamDelta": HostStreamDeltaParams;
-    "host/poolResolved": HostPoolResolvedParams;
-    "host/handleReady": HostHandleReadyParams;
-    "host/childSpawned": HostChildSpawnedParams;
-    "host/childStateChanged": HostChildStateChangedParams;
-}
-/** 通道 → 异步/同步结果类型映射（ack 两阶段通道的第二阶段 result）。 */
-interface ReverseChannelResultMap {
-    "host/log": {
-        ok: true;
-    };
-    "host/askUser": HostAskUserResult;
-    "host/permission": HostPermissionResult;
-    "host/streamDelta": {
-        ok: true;
-    };
-    "host/poolResolved": {
-        ok: true;
-    };
-    "host/handleReady": {
-        ok: true;
-    };
-    "host/childSpawned": {
-        ok: true;
-    };
-    "host/childStateChanged": {
-        ok: true;
-    };
-}
 
 /** 协议错误对象 schema。 */
 declare const protocolErrorSchema: {
@@ -486,7 +415,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"];
+            readonly enum: readonly ["host/log", "host/askUser", "host/streamDelta", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
         };
         readonly params: {};
     };
@@ -605,7 +534,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"];
+                readonly enum: readonly ["host/log", "host/askUser", "host/streamDelta", "host/handleReady", "host/childSpawned", "host/childStateChanged"];
             };
             readonly params: {};
         };
@@ -638,11 +567,9 @@ 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 行。
+ * docs/architecture/subagent-chat-run-unification.md §3.3 D3 + §5 U1/U6 行。
  *
  * [H1 U6 已切换] 键切换单批完成后本 schema 面向唯一键 `resume`（RunResumeParams：
  * recordId + 可选 ResumeAnchor），形状不变。帧级 schema（requestFrameSchema.params）
@@ -662,7 +589,7 @@ declare const runSessionParamsSchema: {
         readonly resume: {
             readonly type: "object";
             readonly additionalProperties: false;
-            readonly required: readonly ["sessionRef", "poolKey"];
+            readonly required: readonly ["sessionRef"];
             readonly properties: {
                 readonly sessionRef: {
                     readonly type: "object";
@@ -670,9 +597,6 @@ declare const runSessionParamsSchema: {
                         readonly type: "string";
                     };
                 };
-                readonly poolKey: {
-                    readonly type: "string";
-                };
                 readonly journalPath: {
                     readonly type: "string";
                 };
@@ -681,4 +605,4 @@ declare const runSessionParamsSchema: {
     };
 };
 
-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 };
+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 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_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReadParams, ResumeAnchor, type ReverseChannel, type ReverseRequestTimeoutClass, type RunContextParams, type RunParams, type RunResult, type RunResumeParams, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, SessionView, type ValidateModelParams, type ValidateModelResult, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema };

package/dist/protocol/index.js

@@ -3,10 +3,8 @@ import {
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   PROTOCOL_METHODS,
   REVERSE_CHANNELS,
-  REVERSE_CHANNEL_NAMES,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
   errorResponseFrameSchema,
-  isHostStreamDeltaParams,
   isNotificationFrame,
   isRequestFrame,
   isResponseFrame,
@@ -17,7 +15,7 @@ import {
   reverseRequestFrameSchema,
   runSessionParamsSchema,
   successResponseFrameSchema
-} from "../chunk-TGDMOLZU.js";
+} from "../chunk-TW2FAMAJ.js";
 import {
   CANCEL_SETTLE_GRACE_MS,
   CRASH_REBUILD_BACKOFF_MS,
@@ -60,7 +58,6 @@ export {
   HANDSHAKE_TIMEOUT_MS,
   PROTOCOL_METHODS,
   REVERSE_CHANNELS,
-  REVERSE_CHANNEL_NAMES,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
   REVERSE_REQUEST_TIMEOUT_MS,
   STDERR_TAIL_CHARS,
@@ -73,7 +70,6 @@ export {
   errorResponseFrameSchema,
   isEngineErrorPassthroughCode,
   isEngineProtocolErrorCode,
-  isHostStreamDeltaParams,
   isNotificationFrame,
   isProtocolVersionCompatible,
   isRequestFrame,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhushanwen/subagent-engine-sdk",
-  "version": "0.3.0",
+  "version": "0.4.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/nesting-guard.ts

@@ -17,7 +17,7 @@
 //
 // [D3-⑤ 嵌套防护合一] 进程内执行嵌套上下文（原 SubagentService.execCtxAls，pi 路径
 // 私有）并入本文件——「嵌套防护」的两层机制（跨进程 env 标记 / 进程内 ALS 深度计数）
-// 单点于公共层。设计权威源：docs/design/subagent-dual-track-convergence.md §3.3 D3-⑤
+// 单点于公共层。设计权威源：docs/design/dual-track（已删 git 可追溯）§3.3 D3-⑤
 // + 双轨清单 #10。
 
 import { AsyncLocalStorage } from "node:async_hooks";

package/src/paths.ts

@@ -7,7 +7,7 @@ import { join } from 'node:path';
  * 自算池/journal 路径）；core 侧引用切换已完成（core execution/engine/paths.ts 为
  * re-export shim，子入口 ./engine/paths 解析路径不变）。
  *
- * 设计权威源：subagent-engine-abstraction.md D5/D6。
+ * 设计权威源：constraints.json C-ext-15（原 subagent-engine-abstraction.md D5/D6，已删，git 可追溯）。
  *
  * 为什么独立成模块：extension 写侧（journal 落盘 / preparer 池目录）与
  * runtime 校验侧（subagent-extractor 前缀白名单）必须同源推导——

package/src/port-contract.ts

@@ -63,19 +63,21 @@ export interface EngineStream {
 }
 
 /**
- * 无隔离池引擎的恒定池 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，与本占位值不冲突。
+ * journal 固定分组 key（值锚定，**只承载、不透传**）：journal 落盘路径
+ * `<dataDir>/engines/<engineId>/<本值>/journal-<taskId>.jsonl` 的第二段，两引擎恒
+ * 本值（pi / zcode 均无池化实现——pi = PI_CODING_AGENT_DIR 全局一份，zcode = 共享
+ * 宿主 HOME）。[池抽象降级 2026-09-13] poolKey 协议面（RunContext/run.params.ctx/
+ * host/poolResolved 通道/EngineHandleData）已整体退役，本常量不再跨进程透传，仅
+ * 三类消费：① journal 落盘路径构造（core journal-wiring）；② 存量 record 兼容
+ * （zcode read 旧相对 dbPath 的锚定分支 + 持久化 engineHandle.poolKey 字段——
+ * record-store 读侧守卫要求非空，值恒本常量）；③ 引擎数据目录布局 SSOT paths.ts
+ * 的签名参数。**值逐字不变**（存量 journal 落盘路径与记录含该值分段，改名不改值）。
  */
 export const SHARED_POOL_KEY = "shared";
 
 /** run 的运行期上下文（core RunContext 结构等价镜像；resume? = 会话形态参数，缺省一次性任务）。 */
 export interface RunContext {
   taskId: string;
-  poolKey: string;
   signal?: AbortSignal;
   onEvent?: (event: AgentEvent) => void;
   ctxModel?: EngineCtxModel;
@@ -94,8 +96,7 @@ export interface RunContext {
    * [LEGACY] fallback（独立运行/测试形态）。
    */
   sessionDir?: string;
-  onPoolResolved?: (poolKey: string) => void;
-  onHandleReady?: (partial: Pick<EngineHandleData, "sessionRef" | "poolKey">) => void;
+  onHandleReady?: (partial: Pick<EngineHandleData, "sessionRef">) => void;
   /** 一次性子进程 pid 上报（host/childSpawned 载荷形态；ChildProcess 句柄不跨协议面）。 */
   onChildSpawned?: (child: { pid: number | undefined; killed: boolean }) => void;
   /**