@zhushanwen/subagent-engine-sdk 0.2.1 → 0.4.0

package/dist/{chunk-A75XDJIC.js → chunk-AIG5LSGK.js}

@@ -164,6 +164,9 @@ function updateFromEvent(record, event) {
     // ── compaction：不产生数据（不变）──
     case "compaction":
       return;
+    // ── activity：纯活性信号，reducer no-op（协议语义见 contract-types）──
+    case "activity":
+      return;
     default: {
       const _exhaustive = event;
       return _exhaustive;

package/dist/{chunk-ZXEAW25V.js → chunk-BBVZK5DL.js}

@@ -14,10 +14,7 @@ var ENGINE_ENV_DENY_LIST = [
   "XYZ_RUNTIME_TOKEN",
   "XYZ_AGENT_API_KEY",
   "XYZ_SUBAGENT_RELAY_SESSION_ID",
-  "XYZ_SUBAGENT_RELAY_RECORD_ID",
-  "XYZ_SUBAGENT_RELAY_STDIN",
-  "XYZ_SUBAGENT_RELAY_STDOUT",
-  "XYZ_SUBAGENT_RELAY_STDERR"
+  "XYZ_SUBAGENT_RELAY_RECORD_ID"
 ];
 var ENGINE_ENV_L0_INFRA_KEYS = [
   "XYZ_AGENT_DATA_DIR",

package/dist/chunk-EUSM6ZX4.js

@@ -0,0 +1,10 @@
+// src/ui-types.ts
+function isUiResponse(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return typeof v.value === "string" || typeof v.confirmed === "boolean" || v.cancelled === true || v.ack === true;
+}
+
+export {
+  isUiResponse
+};

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

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

package/dist/{chunk-N3RL6OVM.js → chunk-J4G2MXDS.js}

@@ -11,8 +11,10 @@ function runEngineCliEntry(opts) {
   const server = opts.server;
   configureLoggerSink({
     log(level, component, message, data) {
-      process.stderr.write(`[${level}] [${component}] ${message}${data !== void 0 ? ` ${JSON.stringify(data)}` : ""}
+      if (level !== "debug") {
+        process.stderr.write(`[${level}] [${component}] ${message}${data !== void 0 ? ` ${JSON.stringify(data)}` : ""}
 `);
+      }
       void server.reverseRequest("host/log", { level, component, message }).catch(() => void 0);
     }
   });

package/dist/{chunk-ZOFFJNJD.js → chunk-LKPVN3N6.js}

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

package/dist/{chunk-RULLX6C6.js → chunk-LQR73V67.js}

@@ -1,4 +1,5 @@
 // src/port-contract.ts
+var SHARED_POOL_KEY = "shared";
 function parseCtxModel(ref) {
   if (ref === void 0 || ref.trim() === "") return void 0;
   const slash = ref.indexOf("/");
@@ -7,5 +8,6 @@ function parseCtxModel(ref) {
 }
 
 export {
+  SHARED_POOL_KEY,
   parseCtxModel
 };

package/dist/{chunk-YFSN3D5N.js → chunk-TW2FAMAJ.js}

@@ -26,7 +26,6 @@ var PROTOCOL_METHODS = [
   "probe",
   "run",
   "cancel",
-  "interact",
   "read",
   "listModels",
   "validateModel",
@@ -38,44 +37,19 @@ var PROTOCOL_METHODS = [
 var REVERSE_CHANNELS = [
   "host/log",
   "host/askUser",
-  "host/permission",
   "host/streamDelta",
-  "host/poolResolved",
   "host/handleReady",
   "host/childSpawned",
-  "host/childStateChanged",
-  "host/roundLifecycle"
+  "host/childStateChanged"
 ];
 var REVERSE_CHANNEL_TIMEOUT_CLASS = {
   "host/log": "data-plane",
   "host/streamDelta": "data-plane",
-  "host/poolResolved": "data-plane",
   "host/handleReady": "data-plane",
   "host/childSpawned": "data-plane",
   "host/childStateChanged": "data-plane",
-  "host/roundLifecycle": "data-plane",
-  "host/askUser": "interaction",
-  "host/permission": "interaction"
+  "host/askUser": "interaction"
 };
-function isHostStreamDeltaParams(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;
-  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/schema.ts
 var ANY_JSON = {};
@@ -155,6 +129,7 @@ var notificationFrameSchema = {
                 "turn_end",
                 "message_end",
                 "compaction",
+                "activity",
                 "error"
               ]
             }
@@ -192,7 +167,26 @@ var FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS = [
   "password",
   "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"],
+      properties: {
+        // ResumeAnchor.sessionRef = Record<string, string>（引擎定位键值对）
+        sessionRef: { type: "object", additionalProperties: { type: "string" } },
+        journalPath: { type: "string" }
+      }
+    }
+  }
+};
 
 export {
   isRequestFrame,
@@ -202,8 +196,6 @@ export {
   PROTOCOL_METHODS,
   REVERSE_CHANNELS,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
-  isHostStreamDeltaParams,
-  isHostRoundLifecycleParams,
   protocolErrorSchema,
   requestFrameSchema,
   successResponseFrameSchema,
@@ -212,5 +204,5 @@ export {
   reverseRequestFrameSchema,
   ENGINE_PROTOCOL_SCHEMAS,
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
-  REVERSE_CHANNEL_NAMES
+  runSessionParamsSchema
 };

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

@@ -70,7 +70,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" }
   );

package/dist/cli-entry.cjs

@@ -92,8 +92,10 @@ function runEngineCliEntry(opts) {
   const server = opts.server;
   configureLoggerSink({
     log(level, component, message, data) {
-      process.stderr.write(`[${level}] [${component}] ${message}${data !== void 0 ? ` ${JSON.stringify(data)}` : ""}
+      if (level !== "debug") {
+        process.stderr.write(`[${level}] [${component}] ${message}${data !== void 0 ? ` ${JSON.stringify(data)}` : ""}
 `);
+      }
       void server.reverseRequest("host/log", { level, component, message }).catch(() => void 0);
     }
   });

package/dist/cli-entry.js

@@ -1,6 +1,6 @@
 import {
   runEngineCliEntry
-} from "./chunk-N3RL6OVM.js";
+} from "./chunk-J4G2MXDS.js";
 import "./chunk-75QEMUGV.js";
 import "./chunk-JSBRDJBE.js";
 export {

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

@@ -7,7 +7,7 @@
  *   const _assert: _CoreSdkAgentEvent = true;
  */
 type AssertMutuallyAssignable<A, B> = [A] extends [B] ? [B] extends [A] ? true : never : never;
-/** token 用量（message_end 单条消息增量）。← core execution/types.ts AgentUsage。 */
+/** token 用量（message_end 单条消息增量）。← core execution/assembly/types.ts AgentUsage。 */
 interface AgentUsage {
     input: number;
     output: number;
@@ -56,8 +56,12 @@ interface Turn {
     closedTs?: number;
 }
 /**
- * 引擎事件（8 种，协议 event.params.event 逐字序列化——「事件与 handle 序列化逐字
- * 兼容」不变量 3 的类型面）。语义锚点 = pi（ACP 词汇对照见 core execution/types.ts 注释）。
+ * 引擎事件（9 种，协议 event.params.event 逐字序列化——「事件与 handle 序列化逐字
+ * 兼容」不变量 3 的类型面）。语义锚点 = pi（ACP 词汇对照见 core execution/assembly/types.ts 注释）。
+ *
+ * activity = 纯活性信号：双侧 reducer no-op、不开 turn、不写状态、不落 journal
+ * （core journal-wiring 对其豁免 append），只承诺「引擎活跃时周期性出现」——供宿主
+ * 无进展守护刷新判活（长工具执行期）。节流属生产者实现细节，不进协议承诺。
  */
 type AgentEvent = {
     type: "tool_start";
@@ -84,12 +88,14 @@ type AgentEvent = {
     error?: string;
 } | {
     type: "compaction";
+} | {
+    type: "activity";
 } | {
     type: "error";
     message: string;
 };
 /**
- * EngineHandle 的持久化形态（JSON v1）。协议 run 终态应答 / interact / read 的
+ * EngineHandle 的持久化形态（JSON v1）。协议 run 终态应答 / read 的
  * handle 载荷（引擎不持有宿主运行时引用，data 即全部）。
  */
 interface EngineHandleData {
@@ -98,9 +104,11 @@ interface EngineHandleData {
     engineId: string;
     /** 引擎自定义定位键值。pi = { recordId?, sessionFile? }；zcode = { sessionId, dbPath }。 */
     sessionRef: Record<string, string>;
-    /** 隔离池定位。pi 无池化恒 'shared'。 */
-    poolKey: string;
-    /** journal 绝对路径（read 第②级数据源；宿主读前校验前缀白名单）。缺省 = 无 journal。 */
+    /**
+     * journal 绝对路径（read 第②级数据源；宿主读前校验前缀白名单）。缺省 = 无 journal。
+     * [池抽象降级 2026-09-13] 原 poolKey 字段已删除——两引擎 poolKey 恒 'shared'
+     * （SDK SHARED_POOL_KEY），journal 固定落 engines/<engineId>/shared/，字段零信息量。
+     */
     journalPath?: string;
     /** probe 实测版本（漂移排查锚点）。 */
     engineVersion?: string;
@@ -109,18 +117,15 @@ interface EngineHandleData {
 }
 /**
  * [v1.x] 冷续 resume 锚点——EngineHandleData 定位键的投影子集（诊断字段
- * v/engineVersion/adapterVersion 不属锚点语义，不随锚点走）。两处消费：
- *   - run.params.chat.resume（宿主 → 引擎：冷续重开已 idle 的 session，pi 消费
- *     sessionRef.sessionFile —— 对照 core SpawnResumeOpts.sessionFile 的锚点面）；
- *   - host/roundLifecycle 载荷 anchor（引擎 → 宿主：轮次终态时回填当前锚点，
- *     宿主据此刷新冷续依据——pi 定位键形态同 EngineHandleData.sessionRef 注释）。
+ * v/engineVersion/adapterVersion 不属锚点语义，不随锚点走）。消费点：
+ *   - run.params.resume（宿主 → 引擎：冷续重开已 idle 的 session，pi 消费
+ *     sessionRef.sessionFile —— 对照 core SpawnResumeOpts.sessionFile 的锚点面）。
+ * [H1 U6 已切换] 键切换单批完成（读写端同批），锚点仅经 resume 键携带。
  * 类型层与 EngineHandleData 定位形态的对照由测试断言（Pick 可赋值闭包）锁定。
  */
 interface ResumeAnchor {
     /** 引擎定位键（pi = { recordId?, sessionFile? }；zcode = { sessionId, dbPath }）。 */
     sessionRef: Record<string, string>;
-    /** 隔离池定位（锚点补全 handle 重建所需；pi 无池化恒 'shared'）。 */
-    poolKey: string;
     /** journal 绝对路径（read 降级链第②级数据源；无 journal 缺省）。 */
     journalPath?: string;
 }
@@ -155,8 +160,16 @@ interface EngineCapabilities {
     schemaEnforcement: "native" | "emulated";
     /** 注意区分「引擎 RPC 层有此能力」与「subagent 链路已接通」。 */
     steer: "native" | "emulated" | "unsupported";
-    /** interact 控制面（message/close/cancel + idle）。 */
-    conversation: "native" | "unsupported";
+    /**
+     * [H1 D5 语义收窄] resume 能力位（chat 续聊 = 新 run + resume 锚点的承载前提；
+     * 原名字沿用——conversation 位保留、语义从「interact 长驻控制面」收窄为
+     * 「resume 续聊能力」，gate 判据与消费方不变）。
+     * [U6 / 永久会话模型 §3.2.6 要点 4] 新值 "cold" = 冷恢复会话：resume 读通道取
+     * 结构化历史 + 新 session 注入（无热 steering）。gate 判据仍是 `=== "unsupported"`
+     * 拒绝——"cold" 在 gate 面与 "native" 等价放行，差异只在续聊形态（新 session
+     * 注入 vs 原地续写）。
+     */
+    conversation: "native" | "cold" | "unsupported";
     /** 决定 persona 路由策略（file/flag/prompt 通道）。 */
     personaInjection: "file" | "flag" | "prompt";
     /** 粗粒度引擎：GUI 显示降级为阶段态。 */
@@ -190,31 +203,6 @@ interface ProbeReport {
         recovery: string;
     };
 }
-/**
- * interact 的 action（交互控制面）。interrupt: true = steer（抢占）/ false|缺省 =
- * followUp（排队）；不支持抢占的引擎忽略。
- */
-type InteractAction = {
-    kind: "message";
-    payload: string;
-    interrupt?: boolean;
-} | {
-    kind: "close";
-    payload?: {
-        force: boolean;
-    };
-} | {
-    kind: "cancel";
-};
-/** interact 的结果（失败码 = engine_session_not_resumable / engine_capability_unsupported 等）。 */
-type InteractResult = {
-    ok: true;
-    delivered: true;
-} | {
-    ok: false;
-    code: string;
-    message: string;
-};
 /** 失败分诊结构化标签。unknown（含缺省）= 可重试（语义守恒）。 */
 type AgentFailureKind = "stale_context" | "schema_deterministic" | "unknown";
 /**
@@ -237,7 +225,7 @@ interface ToolCallEntry {
     /** Args preview string. */
     input: string;
 }
-/** worktree 句柄（结构等价副本；core 权威定义在 execution/types.ts:349）。 */
+/** worktree 句柄（结构等价副本；core 权威定义在 execution/assembly/types.ts:349）。 */
 interface WorktreeHandle {
     /** checkout 目录（子 agent 工作目录）。 */
     readonly path: string;
@@ -349,4 +337,4 @@ interface AgentCallOpts {
     permissionMode?: string;
 }
 
-export type { AgentCallOpts as A, EngineCapabilities as E, InteractAction as I, ModelCatalogEntry as M, ProbeReport as P, ReplayedTurn as R, SessionView as S, ToolCall as T, WorktreeHandle as W, AgentEvent as a, AgentFailureKind as b, AgentOutcome as c, AgentOutcomeUsage as d, AgentUsage as e, AgentUsageTotal as f, AssertMutuallyAssignable as g, EngineHandleData as h, InteractResult as i, InternalToolCall as j, ResumeAnchor as k, ToolCallEntry as l, ToolCallResult as m, Turn as n };
+export type { AgentCallOpts as A, EngineCapabilities as E, InternalToolCall as I, ModelCatalogEntry as M, ProbeReport as P, ReplayedTurn as R, SessionView as S, ToolCall as T, WorktreeHandle as W, AgentEvent as a, AgentFailureKind as b, AgentOutcome as c, AgentOutcomeUsage as d, AgentUsage as e, AgentUsageTotal as f, AssertMutuallyAssignable as g, EngineHandleData as h, ResumeAnchor as i, ToolCallEntry as j, ToolCallResult as k, Turn as l };

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

@@ -7,7 +7,7 @@
  *   const _assert: _CoreSdkAgentEvent = true;
  */
 type AssertMutuallyAssignable<A, B> = [A] extends [B] ? [B] extends [A] ? true : never : never;
-/** token 用量（message_end 单条消息增量）。← core execution/types.ts AgentUsage。 */
+/** token 用量（message_end 单条消息增量）。← core execution/assembly/types.ts AgentUsage。 */
 interface AgentUsage {
     input: number;
     output: number;
@@ -56,8 +56,12 @@ interface Turn {
     closedTs?: number;
 }
 /**
- * 引擎事件（8 种，协议 event.params.event 逐字序列化——「事件与 handle 序列化逐字
- * 兼容」不变量 3 的类型面）。语义锚点 = pi（ACP 词汇对照见 core execution/types.ts 注释）。
+ * 引擎事件（9 种，协议 event.params.event 逐字序列化——「事件与 handle 序列化逐字
+ * 兼容」不变量 3 的类型面）。语义锚点 = pi（ACP 词汇对照见 core execution/assembly/types.ts 注释）。
+ *
+ * activity = 纯活性信号：双侧 reducer no-op、不开 turn、不写状态、不落 journal
+ * （core journal-wiring 对其豁免 append），只承诺「引擎活跃时周期性出现」——供宿主
+ * 无进展守护刷新判活（长工具执行期）。节流属生产者实现细节，不进协议承诺。
  */
 type AgentEvent = {
     type: "tool_start";
@@ -84,12 +88,14 @@ type AgentEvent = {
     error?: string;
 } | {
     type: "compaction";
+} | {
+    type: "activity";
 } | {
     type: "error";
     message: string;
 };
 /**
- * EngineHandle 的持久化形态（JSON v1）。协议 run 终态应答 / interact / read 的
+ * EngineHandle 的持久化形态（JSON v1）。协议 run 终态应答 / read 的
  * handle 载荷（引擎不持有宿主运行时引用，data 即全部）。
  */
 interface EngineHandleData {
@@ -98,9 +104,11 @@ interface EngineHandleData {
     engineId: string;
     /** 引擎自定义定位键值。pi = { recordId?, sessionFile? }；zcode = { sessionId, dbPath }。 */
     sessionRef: Record<string, string>;
-    /** 隔离池定位。pi 无池化恒 'shared'。 */
-    poolKey: string;
-    /** journal 绝对路径（read 第②级数据源；宿主读前校验前缀白名单）。缺省 = 无 journal。 */
+    /**
+     * journal 绝对路径（read 第②级数据源；宿主读前校验前缀白名单）。缺省 = 无 journal。
+     * [池抽象降级 2026-09-13] 原 poolKey 字段已删除——两引擎 poolKey 恒 'shared'
+     * （SDK SHARED_POOL_KEY），journal 固定落 engines/<engineId>/shared/，字段零信息量。
+     */
     journalPath?: string;
     /** probe 实测版本（漂移排查锚点）。 */
     engineVersion?: string;
@@ -109,18 +117,15 @@ interface EngineHandleData {
 }
 /**
  * [v1.x] 冷续 resume 锚点——EngineHandleData 定位键的投影子集（诊断字段
- * v/engineVersion/adapterVersion 不属锚点语义，不随锚点走）。两处消费：
- *   - run.params.chat.resume（宿主 → 引擎：冷续重开已 idle 的 session，pi 消费
- *     sessionRef.sessionFile —— 对照 core SpawnResumeOpts.sessionFile 的锚点面）；
- *   - host/roundLifecycle 载荷 anchor（引擎 → 宿主：轮次终态时回填当前锚点，
- *     宿主据此刷新冷续依据——pi 定位键形态同 EngineHandleData.sessionRef 注释）。
+ * v/engineVersion/adapterVersion 不属锚点语义，不随锚点走）。消费点：
+ *   - run.params.resume（宿主 → 引擎：冷续重开已 idle 的 session，pi 消费
+ *     sessionRef.sessionFile —— 对照 core SpawnResumeOpts.sessionFile 的锚点面）。
+ * [H1 U6 已切换] 键切换单批完成（读写端同批），锚点仅经 resume 键携带。
  * 类型层与 EngineHandleData 定位形态的对照由测试断言（Pick 可赋值闭包）锁定。
  */
 interface ResumeAnchor {
     /** 引擎定位键（pi = { recordId?, sessionFile? }；zcode = { sessionId, dbPath }）。 */
     sessionRef: Record<string, string>;
-    /** 隔离池定位（锚点补全 handle 重建所需；pi 无池化恒 'shared'）。 */
-    poolKey: string;
     /** journal 绝对路径（read 降级链第②级数据源；无 journal 缺省）。 */
     journalPath?: string;
 }
@@ -155,8 +160,16 @@ interface EngineCapabilities {
     schemaEnforcement: "native" | "emulated";
     /** 注意区分「引擎 RPC 层有此能力」与「subagent 链路已接通」。 */
     steer: "native" | "emulated" | "unsupported";
-    /** interact 控制面（message/close/cancel + idle）。 */
-    conversation: "native" | "unsupported";
+    /**
+     * [H1 D5 语义收窄] resume 能力位（chat 续聊 = 新 run + resume 锚点的承载前提；
+     * 原名字沿用——conversation 位保留、语义从「interact 长驻控制面」收窄为
+     * 「resume 续聊能力」，gate 判据与消费方不变）。
+     * [U6 / 永久会话模型 §3.2.6 要点 4] 新值 "cold" = 冷恢复会话：resume 读通道取
+     * 结构化历史 + 新 session 注入（无热 steering）。gate 判据仍是 `=== "unsupported"`
+     * 拒绝——"cold" 在 gate 面与 "native" 等价放行，差异只在续聊形态（新 session
+     * 注入 vs 原地续写）。
+     */
+    conversation: "native" | "cold" | "unsupported";
     /** 决定 persona 路由策略（file/flag/prompt 通道）。 */
     personaInjection: "file" | "flag" | "prompt";
     /** 粗粒度引擎：GUI 显示降级为阶段态。 */
@@ -190,31 +203,6 @@ interface ProbeReport {
         recovery: string;
     };
 }
-/**
- * interact 的 action（交互控制面）。interrupt: true = steer（抢占）/ false|缺省 =
- * followUp（排队）；不支持抢占的引擎忽略。
- */
-type InteractAction = {
-    kind: "message";
-    payload: string;
-    interrupt?: boolean;
-} | {
-    kind: "close";
-    payload?: {
-        force: boolean;
-    };
-} | {
-    kind: "cancel";
-};
-/** interact 的结果（失败码 = engine_session_not_resumable / engine_capability_unsupported 等）。 */
-type InteractResult = {
-    ok: true;
-    delivered: true;
-} | {
-    ok: false;
-    code: string;
-    message: string;
-};
 /** 失败分诊结构化标签。unknown（含缺省）= 可重试（语义守恒）。 */
 type AgentFailureKind = "stale_context" | "schema_deterministic" | "unknown";
 /**
@@ -237,7 +225,7 @@ interface ToolCallEntry {
     /** Args preview string. */
     input: string;
 }
-/** worktree 句柄（结构等价副本；core 权威定义在 execution/types.ts:349）。 */
+/** worktree 句柄（结构等价副本；core 权威定义在 execution/assembly/types.ts:349）。 */
 interface WorktreeHandle {
     /** checkout 目录（子 agent 工作目录）。 */
     readonly path: string;
@@ -349,4 +337,4 @@ interface AgentCallOpts {
     permissionMode?: string;
 }
 
-export type { AgentCallOpts as A, EngineCapabilities as E, InteractAction as I, ModelCatalogEntry as M, ProbeReport as P, ReplayedTurn as R, SessionView as S, ToolCall as T, WorktreeHandle as W, AgentEvent as a, AgentFailureKind as b, AgentOutcome as c, AgentOutcomeUsage as d, AgentUsage as e, AgentUsageTotal as f, AssertMutuallyAssignable as g, EngineHandleData as h, InteractResult as i, InternalToolCall as j, ResumeAnchor as k, ToolCallEntry as l, ToolCallResult as m, Turn as n };
+export type { AgentCallOpts as A, EngineCapabilities as E, InternalToolCall as I, ModelCatalogEntry as M, ProbeReport as P, ReplayedTurn as R, SessionView as S, ToolCall as T, WorktreeHandle as W, AgentEvent as a, AgentFailureKind as b, AgentOutcome as c, AgentOutcomeUsage as d, AgentUsage as e, AgentUsageTotal as f, AssertMutuallyAssignable as g, EngineHandleData as h, ResumeAnchor as i, ToolCallEntry as j, ToolCallResult as k, Turn as l };

package/dist/env.cjs

@@ -87,10 +87,7 @@ var ENGINE_ENV_DENY_LIST = [
   "XYZ_RUNTIME_TOKEN",
   "XYZ_AGENT_API_KEY",
   "XYZ_SUBAGENT_RELAY_SESSION_ID",
-  "XYZ_SUBAGENT_RELAY_RECORD_ID",
-  "XYZ_SUBAGENT_RELAY_STDIN",
-  "XYZ_SUBAGENT_RELAY_STDOUT",
-  "XYZ_SUBAGENT_RELAY_STDERR"
+  "XYZ_SUBAGENT_RELAY_RECORD_ID"
 ];
 var ENGINE_ENV_L0_INFRA_KEYS = [
   "XYZ_AGENT_DATA_DIR",

package/dist/env.d.cts

@@ -1,6 +1,9 @@
 /** L2 manifest 放行的保留前缀拒绝表（镜像 shared SSOT，勿单独改动）。 */
 declare const ENGINE_ENV_PREFIXES: readonly string[];
-/** L1 deny + 显式剥除键集（镜像 shared SSOT，勿单独改动）。 */
+/** L1 deny + 显式剥除键集（镜像 shared SSOT，勿单独改动）。
+ *  互引（场景域分化，勿互混）：dev 装配器（apps/electron/scripts/dev-instance-lib.mjs
+ *  `LEAK_ENV_KEYS`）仍剥 RELAY_STD* 三键——dev 宿主进程环境防泄漏口径独立于引擎
+ *  spawn 面；本清单（引擎侧）已退役同名三键，写入方已清零。 */
 declare const ENGINE_ENV_DENY_LIST: readonly string[];
 /** L0 注入的全部基础设施键（守卫断言：与 ENGINE_ENV_DENY_LIST 交集 = ∅）。 */
 declare const ENGINE_ENV_L0_INFRA_KEYS: readonly string[];

package/dist/env.d.ts

@@ -1,6 +1,9 @@
 /** L2 manifest 放行的保留前缀拒绝表（镜像 shared SSOT，勿单独改动）。 */
 declare const ENGINE_ENV_PREFIXES: readonly string[];
-/** L1 deny + 显式剥除键集（镜像 shared SSOT，勿单独改动）。 */
+/** L1 deny + 显式剥除键集（镜像 shared SSOT，勿单独改动）。
+ *  互引（场景域分化，勿互混）：dev 装配器（apps/electron/scripts/dev-instance-lib.mjs
+ *  `LEAK_ENV_KEYS`）仍剥 RELAY_STD* 三键——dev 宿主进程环境防泄漏口径独立于引擎
+ *  spawn 面；本清单（引擎侧）已退役同名三键，写入方已清零。 */
 declare const ENGINE_ENV_DENY_LIST: readonly string[];
 /** L0 注入的全部基础设施键（守卫断言：与 ENGINE_ENV_DENY_LIST 交集 = ∅）。 */
 declare const ENGINE_ENV_L0_INFRA_KEYS: readonly string[];

package/dist/env.js

@@ -4,7 +4,7 @@ import {
   ENGINE_ENV_PREFIXES,
   buildEngineChildEnv,
   buildOutboundChildEnv
-} from "./chunk-ZXEAW25V.js";
+} from "./chunk-BBVZK5DL.js";
 import "./chunk-75QEMUGV.js";
 import "./chunk-JSBRDJBE.js";
 export {

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

@@ -1,4 +1,4 @@
-import { a as AgentEvent, E as EngineCapabilities } from './contract-types-sSlgppBC.js';
+import { a as AgentEvent, E as EngineCapabilities } from './contract-types-C71Sqq8d.cjs';
 
 /** 协议错误对象（error 帧载荷与反向请求错误应答共用形态）。 */
 interface ProtocolError {
@@ -46,7 +46,7 @@ type ReverseResponseResult =
 {
     ok: true;
 }
-/** 人机交互类（askUser/permission）两阶段第一阶段：已受理，结果异步到达（R9-2）。 */
+/** 人机交互类（askUser）两阶段第一阶段：已受理，结果异步到达（R9-2）。 */
  | {
     ack: true;
 }
@@ -54,7 +54,6 @@ type ReverseResponseResult =
  | {
     unsupported: true;
 };
-type AnyFrame = RequestFrame | ResponseFrame | NotificationFrame | ReverseRequestFrame;
 /** ① 请求：有数字 id + method + params，且无 result/error（与②应答区分）。 */
 declare function isRequestFrame(frame: unknown): frame is RequestFrame;
 /** ② 应答：有 id（number|string）且 result/error 二选一。 */
@@ -88,15 +87,16 @@ declare class EngineSdkError extends Error {
 }
 declare function engineProtocolMismatchError(engineVersion: number): EngineSdkError;
 /**
- * [v1.x] chat 会话形态的 gate 拒绝具名错误（chat-domain 设计 §3.2 D1-A +
- * 验收 A6：manifest 无 conversation gate 位的引擎收到 chat 请求 → 同步拒）。
+ * [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 内联文案，保持两侧一致。
  */
 declare function engineConversationUnsupportedError(engineId: string): EngineSdkError;
 /**
- * [v1.x] chat 会话形态（run.params.chat / task.conversation=true）派发前的同步 gate：
+ * [v1.x] resume 会话形态（run.params.resume / task.conversation=true）派发前的同步 gate：
  * manifest conversation 位 unsupported 即抛 engineConversationUnsupportedError——
  * 进程/record 创建前同步拒（A6：run 域不受影响，仅 chat 面被拦）。
  * 判据单源：core 侧 capability-gate.assertTaskShapeSupported 的 conversation 分支
@@ -115,4 +115,4 @@ declare function engineTimeoutDetail(stdoutTail: string): string;
 /** schema_emulation_failed 的终报文案（宿主编排层「重试一次仍失败」后消费）。 */
 declare function schemaEmulationFailedDetail(error: string, tail: string): string;
 
-export { type AnyFrame as A, ENGINE_ERROR_CODE_PREFIX as E, type NotificationFrame as N, type ProtocolError as P, type RequestFrame as R, STDOUT_TAIL_ECHO_CHARS as S, ENGINE_PROTOCOL_ERROR_CODES as a, ENGINE_TIMEOUT_RECOVERY as b, type EngineProtocolErrorCode as c, EngineSdkError as d, type ErrorResponseFrame as e, type EventNotificationParams as f, type ResponseFrame as g, type ReverseRequestFrame as h, type ReverseResponseResult as i, type SuccessResponseFrame as j, assertChatConversationSupported as k, engineConversationUnsupportedError as l, engineProtocolMismatchError as m, engineTimeoutDetail as n, isEngineErrorPassthroughCode as o, isEngineProtocolErrorCode as p, isNotificationFrame as q, isRequestFrame as r, isResponseFrame as s, isReverseRequestFrame as t, schemaEmulationFailedDetail as u };
+export { ENGINE_ERROR_CODE_PREFIX as E, type NotificationFrame as N, type ProtocolError as P, type RequestFrame as R, STDOUT_TAIL_ECHO_CHARS as S, ENGINE_PROTOCOL_ERROR_CODES as a, ENGINE_TIMEOUT_RECOVERY as b, type EngineProtocolErrorCode as c, EngineSdkError as d, type ErrorResponseFrame as e, type EventNotificationParams as f, type ResponseFrame as g, type ReverseRequestFrame as h, type ReverseResponseResult as i, type SuccessResponseFrame as j, assertChatConversationSupported as k, engineConversationUnsupportedError as l, engineProtocolMismatchError as m, engineTimeoutDetail as n, isEngineErrorPassthroughCode as o, isEngineProtocolErrorCode as p, isNotificationFrame as q, isRequestFrame as r, isResponseFrame as s, isReverseRequestFrame as t, schemaEmulationFailedDetail as u };