@zhushanwen/subagent-engine-sdk 0.2.1 → 0.4.0

package/dist/{error-codes-DHco5-i_.d.cts → error-codes-D5YlWaBx.d.ts}

@@ -1,4 +1,4 @@
-import { a as AgentEvent, E as EngineCapabilities } from './contract-types-sSlgppBC.cjs';
+import { a as AgentEvent, E as EngineCapabilities } from './contract-types-C71Sqq8d.js';
 
 /** 协议错误对象（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 };

package/dist/index.cjs

@@ -6608,10 +6608,10 @@ __export(src_exports, {
   RELAY_EXIT_CODES: () => RELAY_EXIT_CODES,
   RELAY_PROTOCOL_VERSION: () => RELAY_PROTOCOL_VERSION,
   REVERSE_CHANNELS: () => REVERSE_CHANNELS,
-  REVERSE_CHANNEL_NAMES: () => REVERSE_CHANNEL_NAMES,
   REVERSE_CHANNEL_TIMEOUT_CLASS: () => REVERSE_CHANNEL_TIMEOUT_CLASS,
   REVERSE_REQUEST_TIMEOUT_MS: () => REVERSE_REQUEST_TIMEOUT_MS,
   SCHEMA_EMULATION_TAIL_CHARS: () => SCHEMA_EMULATION_TAIL_CHARS,
+  SHARED_POOL_KEY: () => SHARED_POOL_KEY,
   STDERR_TAIL_CHARS: () => STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS: () => STDOUT_TAIL_ECHO_CHARS,
   SUPPORTED_PROTOCOL_RANGE: () => SUPPORTED_PROTOCOL_RANGE,
@@ -6641,8 +6641,6 @@ __export(src_exports, {
   hostKindOf: () => hostKindOf,
   isEngineErrorPassthroughCode: () => isEngineErrorPassthroughCode,
   isEngineProtocolErrorCode: () => isEngineProtocolErrorCode,
-  isHostRoundLifecycleParams: () => isHostRoundLifecycleParams,
-  isHostStreamDeltaParams: () => isHostStreamDeltaParams,
   isNotificationFrame: () => isNotificationFrame,
   isPidAlive: () => isPidAlive,
   isProtocolVersionCompatible: () => isProtocolVersionCompatible,
@@ -6650,6 +6648,7 @@ __export(src_exports, {
   isRequestFrame: () => isRequestFrame,
   isResponseFrame: () => isResponseFrame,
   isReverseRequestFrame: () => isReverseRequestFrame,
+  isUiResponse: () => isUiResponse,
   killChain: () => killChain,
   notificationFrameSchema: () => notificationFrameSchema,
   parseChannel: () => parseChannel,
@@ -6672,6 +6671,7 @@ __export(src_exports, {
   reverseRequestFrameSchema: () => reverseRequestFrameSchema,
   rotateStderrLogIfNeeded: () => rotateStderrLogIfNeeded,
   runEngineCliEntry: () => runEngineCliEntry,
+  runSessionParamsSchema: () => runSessionParamsSchema,
   sanitizeSeg: () => sanitizeSeg,
   schemaEmulationFailedDetail: () => schemaEmulationFailedDetail,
   sessionIdFromHandle: () => sessionIdFromHandle,
@@ -6737,7 +6737,6 @@ var PROTOCOL_METHODS = [
   "probe",
   "run",
   "cancel",
-  "interact",
   "read",
   "listModels",
   "validateModel",
@@ -6749,44 +6748,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/error-codes.ts
 var ENGINE_PROTOCOL_ERROR_CODES = [
@@ -6838,7 +6812,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" }
   );
@@ -6939,6 +6913,7 @@ var notificationFrameSchema = {
                 "turn_end",
                 "message_end",
                 "compaction",
+                "activity",
                 "error"
               ]
             }
@@ -6976,7 +6951,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" }
+      }
+    }
+  }
+};
 
 // src/schema-emulation.ts
 var import_ajv = __toESM(require_ajv(), 1);
@@ -7477,6 +7471,9 @@ function updateFromEvent(record, event) {
     // ── compaction：不产生数据（不变）──
     case "compaction":
       return;
+    // ── activity：纯活性信号，reducer no-op（协议语义见 contract-types）──
+    case "activity":
+      return;
     default: {
       const _exhaustive = event;
       return _exhaustive;
@@ -7587,6 +7584,13 @@ function resolveJournalPath(dataDir, engineId, poolKey, taskId) {
   return (0, import_node_path.join)(resolvePoolDir(dataDir, engineId, poolKey), `journal-${sanitizeSeg(taskId)}.jsonl`);
 }
 
+// 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;
+}
+
 // src/ui-channels.ts
 var NUL = "\0";
 function normalizeChannelName(markerLiteral) {
@@ -7690,10 +7694,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",
@@ -8222,6 +8223,7 @@ function parseLine(trimmed) {
 }
 
 // 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("/");
@@ -8237,8 +8239,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);
     }
   });
@@ -8296,10 +8300,10 @@ function runEngineCliEntry(opts) {
   RELAY_EXIT_CODES,
   RELAY_PROTOCOL_VERSION,
   REVERSE_CHANNELS,
-  REVERSE_CHANNEL_NAMES,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
   REVERSE_REQUEST_TIMEOUT_MS,
   SCHEMA_EMULATION_TAIL_CHARS,
+  SHARED_POOL_KEY,
   STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS,
   SUPPORTED_PROTOCOL_RANGE,
@@ -8329,8 +8333,6 @@ function runEngineCliEntry(opts) {
   hostKindOf,
   isEngineErrorPassthroughCode,
   isEngineProtocolErrorCode,
-  isHostRoundLifecycleParams,
-  isHostStreamDeltaParams,
   isNotificationFrame,
   isPidAlive,
   isProtocolVersionCompatible,
@@ -8338,6 +8340,7 @@ function runEngineCliEntry(opts) {
   isRequestFrame,
   isResponseFrame,
   isReverseRequestFrame,
+  isUiResponse,
   killChain,
   notificationFrameSchema,
   parseChannel,
@@ -8360,6 +8363,7 @@ function runEngineCliEntry(opts) {
   reverseRequestFrameSchema,
   rotateStderrLogIfNeeded,
   runEngineCliEntry,
+  runSessionParamsSchema,
   sanitizeSeg,
   schemaEmulationFailedDetail,
   sessionIdFromHandle,

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, HostPermissionParams, HostPermissionResult, HostPoolResolvedParams, HostRoundLifecycleParams, HostStreamDeltaParams, InitializeParams, InitializeResult, InteractParams, ListModelsParams, ListModelsResult, PROTOCOL_METHODS, PingParams, PingResult, ProbeParams, ProtocolMethod, ProtocolParamsMap, ProtocolResultMap, REVERSE_CHANNELS, REVERSE_CHANNEL_NAMES, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReadParams, ReverseChannel, ReverseChannelParamsMap, ReverseChannelResultMap, ReverseRequestTimeoutClass, RoundFailedPhase, RoundIdlePhase, RoundKeyedByRecord, RoundKeyedByRun, RoundLifecyclePhase, RoundSettledPhase, RunChatParams, RunContextParams, RunParams, RunResult, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, ValidateModelParams, ValidateModelResult, errorResponseFrameSchema, isHostRoundLifecycleParams, isHostStreamDeltaParams, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, successResponseFrameSchema } from './protocol/index.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-DHco5-i_.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 InteractAction, i as InteractResult, j as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, k as ResumeAnchor, S as SessionView, T as ToolCall, l as ToolCallEntry, m as ToolCallResult, n as Turn, W as WorktreeHandle } from './contract-types-sSlgppBC.cjs';
+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 { 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';
@@ -8,7 +8,7 @@ export { DEFAULT_KILL_GRACE_MS, DEFAULT_NATIVE_INTERRUPT_GRACE_MS, HOST_TIMEOUT_
 export { ReplayRecordView, aggregateUsage, createReplayRecord, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent } from './journal-replay.cjs';
 export { XYZ_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir } from './data-dir.cjs';
 export { resolveEngineDir, resolveEnginesRoot, resolveJournalPath, resolvePoolDir, sanitizeSeg } from './paths.cjs';
-export { UiMethod, UiRequest, UiRequestHandler, UiResponse } from './ui-types.cjs';
+export { UiMethod, UiRequest, UiRequestHandler, UiResponse, isUiResponse } from './ui-types.cjs';
 export { ChannelHandler, ExtensionUiRequestLike, ParsedChannel, UiChannelRegistry, createUiChannelRegistry, parseChannel } from './ui-channels.cjs';
 export { BuildOutboundChildEnvOptions, ENGINE_ENV_DENY_LIST, ENGINE_ENV_L0_INFRA_KEYS, ENGINE_ENV_PREFIXES, EngineChildEnvOptions, EngineRelayEnv, buildEngineChildEnv, buildOutboundChildEnv } from './env.cjs';
 export { DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS, ENGINE_HOST_REQUEST_TIMEOUT_ENV, EngineChildEnv, EngineSelfDestructOptions, ReverseRequestClock, SpawnEngineChildOptions, armEngineSelfDestruct, pumpNdjsonLines, spawnEngineChild } from './spawn.cjs';
@@ -18,6 +18,6 @@ export { RELAY_ENV_NODE, RELAY_ENV_RECORD_ID, RELAY_ENV_SCRIPT, RELAY_ENV_SESSIO
 export { toErrorMessage } from './error-message.cjs';
 export { BestEffortLevel, bestEffort } from './best-effort.cjs';
 export { replayJournal } from './journal-io.cjs';
-export { EngineAgentCallOpts, EngineCtxModel, EngineHandle, EnginePort, EngineRunResult, EngineStream, RunContext, parseCtxModel } from './port-contract.cjs';
+export { EngineAgentCallOpts, EngineCtxModel, EngineHandle, EnginePort, EngineRunResult, EngineStream, RunContext, SHARED_POOL_KEY, parseCtxModel } from './port-contract.cjs';
 export { CliProtocolServerSink, RunEngineCliEntryOptions, runEngineCliEntry } from './cli-entry.cjs';
 import 'node:child_process';

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, HostPermissionParams, HostPermissionResult, HostPoolResolvedParams, HostRoundLifecycleParams, HostStreamDeltaParams, InitializeParams, InitializeResult, InteractParams, ListModelsParams, ListModelsResult, PROTOCOL_METHODS, PingParams, PingResult, ProbeParams, ProtocolMethod, ProtocolParamsMap, ProtocolResultMap, REVERSE_CHANNELS, REVERSE_CHANNEL_NAMES, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReadParams, ReverseChannel, ReverseChannelParamsMap, ReverseChannelResultMap, ReverseRequestTimeoutClass, RoundFailedPhase, RoundIdlePhase, RoundKeyedByRecord, RoundKeyedByRun, RoundLifecyclePhase, RoundSettledPhase, RunChatParams, RunContextParams, RunParams, RunResult, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, ValidateModelParams, ValidateModelResult, errorResponseFrameSchema, isHostRoundLifecycleParams, isHostStreamDeltaParams, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, successResponseFrameSchema } from './protocol/index.js';
-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-Dhss2Kmk.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 InteractAction, i as InteractResult, j as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, k as ResumeAnchor, S as SessionView, T as ToolCall, l as ToolCallEntry, m as ToolCallResult, n as Turn, W as WorktreeHandle } from './contract-types-sSlgppBC.js';
+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 { 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';
@@ -8,7 +8,7 @@ export { DEFAULT_KILL_GRACE_MS, DEFAULT_NATIVE_INTERRUPT_GRACE_MS, HOST_TIMEOUT_
 export { ReplayRecordView, aggregateUsage, createReplayRecord, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent } from './journal-replay.js';
 export { XYZ_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir } from './data-dir.js';
 export { resolveEngineDir, resolveEnginesRoot, resolveJournalPath, resolvePoolDir, sanitizeSeg } from './paths.js';
-export { UiMethod, UiRequest, UiRequestHandler, UiResponse } from './ui-types.js';
+export { UiMethod, UiRequest, UiRequestHandler, UiResponse, isUiResponse } from './ui-types.js';
 export { ChannelHandler, ExtensionUiRequestLike, ParsedChannel, UiChannelRegistry, createUiChannelRegistry, parseChannel } from './ui-channels.js';
 export { BuildOutboundChildEnvOptions, ENGINE_ENV_DENY_LIST, ENGINE_ENV_L0_INFRA_KEYS, ENGINE_ENV_PREFIXES, EngineChildEnvOptions, EngineRelayEnv, buildEngineChildEnv, buildOutboundChildEnv } from './env.js';
 export { DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS, ENGINE_HOST_REQUEST_TIMEOUT_ENV, EngineChildEnv, EngineSelfDestructOptions, ReverseRequestClock, SpawnEngineChildOptions, armEngineSelfDestruct, pumpNdjsonLines, spawnEngineChild } from './spawn.js';
@@ -18,6 +18,6 @@ export { RELAY_ENV_NODE, RELAY_ENV_RECORD_ID, RELAY_ENV_SCRIPT, RELAY_ENV_SESSIO
 export { toErrorMessage } from './error-message.js';
 export { BestEffortLevel, bestEffort } from './best-effort.js';
 export { replayJournal } from './journal-io.js';
-export { EngineAgentCallOpts, EngineCtxModel, EngineHandle, EnginePort, EngineRunResult, EngineStream, RunContext, parseCtxModel } from './port-contract.js';
+export { EngineAgentCallOpts, EngineCtxModel, EngineHandle, EnginePort, EngineRunResult, EngineStream, RunContext, SHARED_POOL_KEY, parseCtxModel } from './port-contract.js';
 export { CliProtocolServerSink, RunEngineCliEntryOptions, runEngineCliEntry } from './cli-entry.js';
 import 'node:child_process';

package/dist/index.js

@@ -5,11 +5,12 @@ import {
   replayJournal
 } from "./chunk-RDH3ZOV6.js";
 import {
+  SHARED_POOL_KEY,
   parseCtxModel
-} from "./chunk-RULLX6C6.js";
+} from "./chunk-LQR73V67.js";
 import {
   runEngineCliEntry
-} from "./chunk-N3RL6OVM.js";
+} from "./chunk-J4G2MXDS.js";
 import {
   resolveEngineDir,
   resolveEnginesRoot,
@@ -17,7 +18,9 @@ import {
   resolvePoolDir,
   sanitizeSeg
 } from "./chunk-OPMY4G4M.js";
-import "./chunk-2DIMPZCQ.js";
+import {
+  isUiResponse
+} from "./chunk-EUSM6ZX4.js";
 import {
   createUiChannelRegistry,
   parseChannel
@@ -28,7 +31,7 @@ import {
   ENGINE_ENV_PREFIXES,
   buildEngineChildEnv,
   buildOutboundChildEnv
-} from "./chunk-ZXEAW25V.js";
+} from "./chunk-BBVZK5DL.js";
 import {
   DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS,
   ENGINE_HOST_REQUEST_TIMEOUT_ENV,
@@ -42,7 +45,7 @@ import {
   probeNodeExecutor,
   resetEngineNodeProbeCache,
   resolveEngineNodeLaunch
-} from "./chunk-ZOFFJNJD.js";
+} from "./chunk-LKPVN3N6.js";
 import {
   DEFAULT_STDERR_KEEP_DAYS,
   DEFAULT_STDERR_MAX_BYTES,
@@ -70,11 +73,8 @@ import {
   FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
   PROTOCOL_METHODS,
   REVERSE_CHANNELS,
-  REVERSE_CHANNEL_NAMES,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
   errorResponseFrameSchema,
-  isHostRoundLifecycleParams,
-  isHostStreamDeltaParams,
   isNotificationFrame,
   isRequestFrame,
   isResponseFrame,
@@ -83,8 +83,9 @@ import {
   protocolErrorSchema,
   requestFrameSchema,
   reverseRequestFrameSchema,
+  runSessionParamsSchema,
   successResponseFrameSchema
-} from "./chunk-YFSN3D5N.js";
+} from "./chunk-TW2FAMAJ.js";
 import {
   SCHEMA_EMULATION_TAIL_CHARS,
   buildSchemaEmulationSegment,
@@ -104,7 +105,7 @@ import {
   abortWithFallback,
   killChain,
   synthesizeTimeoutOutcome
-} from "./chunk-LEOBWKRM.js";
+} from "./chunk-FJT23P7T.js";
 import {
   toErrorMessage
 } from "./chunk-PYO3YR7W.js";
@@ -132,7 +133,7 @@ import {
   isEngineProtocolErrorCode,
   isProtocolVersionCompatible,
   schemaEmulationFailedDetail
-} from "./chunk-PPEPBVCC.js";
+} from "./chunk-WS4WAZVR.js";
 import {
   aggregateUsage,
   createReplayRecord,
@@ -140,7 +141,7 @@ import {
   sessionIdFromHandle,
   toReplayedTurn,
   updateFromEvent
-} from "./chunk-A75XDJIC.js";
+} from "./chunk-AIG5LSGK.js";
 import {
   XYZ_DATA_DIR_ENV,
   resetDataDirWarnForTests,
@@ -189,10 +190,10 @@ export {
   RELAY_EXIT_CODES,
   RELAY_PROTOCOL_VERSION,
   REVERSE_CHANNELS,
-  REVERSE_CHANNEL_NAMES,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
   REVERSE_REQUEST_TIMEOUT_MS,
   SCHEMA_EMULATION_TAIL_CHARS,
+  SHARED_POOL_KEY,
   STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS,
   SUPPORTED_PROTOCOL_RANGE,
@@ -222,8 +223,6 @@ export {
   hostKindOf,
   isEngineErrorPassthroughCode,
   isEngineProtocolErrorCode,
-  isHostRoundLifecycleParams,
-  isHostStreamDeltaParams,
   isNotificationFrame,
   isPidAlive,
   isProtocolVersionCompatible,
@@ -231,6 +230,7 @@ export {
   isRequestFrame,
   isResponseFrame,
   isReverseRequestFrame,
+  isUiResponse,
   killChain,
   notificationFrameSchema,
   parseChannel,
@@ -253,6 +253,7 @@ export {
   reverseRequestFrameSchema,
   rotateStderrLogIfNeeded,
   runEngineCliEntry,
+  runSessionParamsSchema,
   sanitizeSeg,
   schemaEmulationFailedDetail,
   sessionIdFromHandle,

package/dist/journal-io.d.cts

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

package/dist/journal-io.d.ts

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

package/dist/journal-replay.cjs

@@ -193,6 +193,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/journal-replay.d.cts

@@ -1,4 +1,4 @@
-import { n as Turn, f as AgentUsageTotal, a as AgentEvent, S as SessionView, h as EngineHandleData, R as ReplayedTurn } from './contract-types-sSlgppBC.cjs';
+import { l as Turn, f as AgentUsageTotal, a as AgentEvent, S as SessionView, h as EngineHandleData, R as ReplayedTurn } from './contract-types-C71Sqq8d.cjs';
 
 /**
  * reducer 的 record 视图（core ExecutionRecord 的结构子集：reducer 只触碰这四个字段）。

package/dist/journal-replay.d.ts

@@ -1,4 +1,4 @@
-import { n as Turn, f as AgentUsageTotal, a as AgentEvent, S as SessionView, h as EngineHandleData, R as ReplayedTurn } from './contract-types-sSlgppBC.js';
+import { l as Turn, f as AgentUsageTotal, a as AgentEvent, S as SessionView, h as EngineHandleData, R as ReplayedTurn } from './contract-types-C71Sqq8d.js';
 
 /**
  * reducer 的 record 视图（core ExecutionRecord 的结构子集：reducer 只触碰这四个字段）。

package/dist/journal-replay.js

@@ -5,7 +5,7 @@ import {
   sessionIdFromHandle,
   toReplayedTurn,
   updateFromEvent
-} from "./chunk-A75XDJIC.js";
+} from "./chunk-AIG5LSGK.js";
 import "./chunk-JSBRDJBE.js";
 export {
   aggregateUsage,

package/dist/kill-chain.d.cts

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

package/dist/kill-chain.d.ts

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

package/dist/kill-chain.js

@@ -5,11 +5,11 @@ import {
   abortWithFallback,
   killChain,
   synthesizeTimeoutOutcome
-} from "./chunk-LEOBWKRM.js";
+} from "./chunk-FJT23P7T.js";
 import "./chunk-PYO3YR7W.js";
 import {
   STDOUT_TAIL_ECHO_CHARS
-} from "./chunk-PPEPBVCC.js";
+} from "./chunk-WS4WAZVR.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-ZOFFJNJD.js";
-import "./chunk-PPEPBVCC.js";
+} from "./chunk-LKPVN3N6.js";
+import "./chunk-WS4WAZVR.js";
 import "./chunk-JSBRDJBE.js";
 export {
   ENGINE_NODE_ENV,

package/dist/port-contract.cjs

@@ -20,9 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/port-contract.ts
 var port_contract_exports = {};
 __export(port_contract_exports, {
+  SHARED_POOL_KEY: () => SHARED_POOL_KEY,
   parseCtxModel: () => parseCtxModel
 });
 module.exports = __toCommonJS(port_contract_exports);
+var SHARED_POOL_KEY = "shared";
 function parseCtxModel(ref) {
   if (ref === void 0 || ref.trim() === "") return void 0;
   const slash = ref.indexOf("/");
@@ -31,5 +33,6 @@ function parseCtxModel(ref) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  SHARED_POOL_KEY,
   parseCtxModel
 });