@zhushanwen/subagent-engine-sdk 0.2.0 → 0.3.0

package/dist/index.cjs

@@ -6612,6 +6612,7 @@ __export(src_exports, {
   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,7 +6642,6 @@ __export(src_exports, {
   hostKindOf: () => hostKindOf,
   isEngineErrorPassthroughCode: () => isEngineErrorPassthroughCode,
   isEngineProtocolErrorCode: () => isEngineProtocolErrorCode,
-  isHostRoundLifecycleParams: () => isHostRoundLifecycleParams,
   isHostStreamDeltaParams: () => isHostStreamDeltaParams,
   isNotificationFrame: () => isNotificationFrame,
   isPidAlive: () => isPidAlive,
@@ -6650,6 +6650,7 @@ __export(src_exports, {
   isRequestFrame: () => isRequestFrame,
   isResponseFrame: () => isResponseFrame,
   isReverseRequestFrame: () => isReverseRequestFrame,
+  isUiResponse: () => isUiResponse,
   killChain: () => killChain,
   notificationFrameSchema: () => notificationFrameSchema,
   parseChannel: () => parseChannel,
@@ -6672,6 +6673,7 @@ __export(src_exports, {
   reverseRequestFrameSchema: () => reverseRequestFrameSchema,
   rotateStderrLogIfNeeded: () => rotateStderrLogIfNeeded,
   runEngineCliEntry: () => runEngineCliEntry,
+  runSessionParamsSchema: () => runSessionParamsSchema,
   sanitizeSeg: () => sanitizeSeg,
   schemaEmulationFailedDetail: () => schemaEmulationFailedDetail,
   sessionIdFromHandle: () => sessionIdFromHandle,
@@ -6737,7 +6739,6 @@ var PROTOCOL_METHODS = [
   "probe",
   "run",
   "cancel",
-  "interact",
   "read",
   "listModels",
   "validateModel",
@@ -6754,8 +6755,7 @@ var REVERSE_CHANNELS = [
   "host/poolResolved",
   "host/handleReady",
   "host/childSpawned",
-  "host/childStateChanged",
-  "host/roundLifecycle"
+  "host/childStateChanged"
 ];
 var REVERSE_CHANNEL_TIMEOUT_CLASS = {
   "host/log": "data-plane",
@@ -6764,7 +6764,6 @@ var REVERSE_CHANNEL_TIMEOUT_CLASS = {
   "host/handleReady": "data-plane",
   "host/childSpawned": "data-plane",
   "host/childStateChanged": "data-plane",
-  "host/roundLifecycle": "data-plane",
   "host/askUser": "interaction",
   "host/permission": "interaction"
 };
@@ -6776,17 +6775,6 @@ function isHostStreamDeltaParams(value) {
   if (hasRunId === hasRecordId) return false;
   return typeof v.delta === "string";
 }
-function isHostRoundLifecycleParams(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const v = value;
-  const hasRunId = typeof v.runId === "string";
-  const hasRecordId = typeof v.recordId === "string";
-  if (hasRunId === hasRecordId) return false;
-  if (v.phase === "settled" || v.phase === "idle") return true;
-  if (v.phase !== "failed") return false;
-  const err = v.error;
-  return typeof err === "object" && err !== null && typeof err.code === "string" && typeof err.message === "string";
-}
 
 // src/protocol/error-codes.ts
 var ENGINE_PROTOCOL_ERROR_CODES = [
@@ -6838,7 +6826,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 +6927,7 @@ var notificationFrameSchema = {
                 "turn_end",
                 "message_end",
                 "compaction",
+                "activity",
                 "error"
               ]
             }
@@ -6977,6 +6966,27 @@ var FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS = [
   "secret"
 ];
 var REVERSE_CHANNEL_NAMES = REVERSE_CHANNELS;
+var runSessionParamsSchema = {
+  $schema: "http://json-schema.org/draft-07/schema#",
+  title: "EngineRunSessionParams",
+  type: "object",
+  additionalProperties: false,
+  required: ["recordId"],
+  properties: {
+    recordId: { type: "string" },
+    resume: {
+      type: "object",
+      additionalProperties: false,
+      required: ["sessionRef", "poolKey"],
+      properties: {
+        // ResumeAnchor.sessionRef = Record<string, string>（引擎定位键值对）
+        sessionRef: { type: "object", additionalProperties: { type: "string" } },
+        poolKey: { type: "string" },
+        journalPath: { type: "string" }
+      }
+    }
+  }
+};
 
 // src/schema-emulation.ts
 var import_ajv = __toESM(require_ajv(), 1);
@@ -7477,6 +7487,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 +7600,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 +7710,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 +8239,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 +8255,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);
     }
   });
@@ -8300,6 +8320,7 @@ function runEngineCliEntry(opts) {
   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,7 +8350,6 @@ function runEngineCliEntry(opts) {
   hostKindOf,
   isEngineErrorPassthroughCode,
   isEngineProtocolErrorCode,
-  isHostRoundLifecycleParams,
   isHostStreamDeltaParams,
   isNotificationFrame,
   isPidAlive,
@@ -8338,6 +8358,7 @@ function runEngineCliEntry(opts) {
   isRequestFrame,
   isResponseFrame,
   isReverseRequestFrame,
+  isUiResponse,
   killChain,
   notificationFrameSchema,
   parseChannel,
@@ -8360,6 +8381,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, HostPermissionParams, HostPermissionResult, HostPoolResolvedParams, HostStreamDeltaParams, InitializeParams, InitializeResult, 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, RunContextParams, RunParams, RunResult, RunResumeParams, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, ValidateModelParams, ValidateModelResult, errorResponseFrameSchema, isHostStreamDeltaParams, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, 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-DCiilt_8.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-ByIFoLrY.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, HostPermissionParams, HostPermissionResult, HostPoolResolvedParams, HostStreamDeltaParams, InitializeParams, InitializeResult, 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, RunContextParams, RunParams, RunResult, RunResumeParams, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, ValidateModelParams, ValidateModelResult, errorResponseFrameSchema, isHostStreamDeltaParams, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, 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-BUx92qYi.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-ByIFoLrY.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,
@@ -73,7 +76,6 @@ import {
   REVERSE_CHANNEL_NAMES,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
   errorResponseFrameSchema,
-  isHostRoundLifecycleParams,
   isHostStreamDeltaParams,
   isNotificationFrame,
   isRequestFrame,
@@ -83,8 +85,9 @@ import {
   protocolErrorSchema,
   requestFrameSchema,
   reverseRequestFrameSchema,
+  runSessionParamsSchema,
   successResponseFrameSchema
-} from "./chunk-YFSN3D5N.js";
+} from "./chunk-TGDMOLZU.js";
 import {
   SCHEMA_EMULATION_TAIL_CHARS,
   buildSchemaEmulationSegment,
@@ -104,7 +107,7 @@ import {
   abortWithFallback,
   killChain,
   synthesizeTimeoutOutcome
-} from "./chunk-LEOBWKRM.js";
+} from "./chunk-FJT23P7T.js";
 import {
   toErrorMessage
 } from "./chunk-PYO3YR7W.js";
@@ -132,7 +135,7 @@ import {
   isEngineProtocolErrorCode,
   isProtocolVersionCompatible,
   schemaEmulationFailedDetail
-} from "./chunk-PPEPBVCC.js";
+} from "./chunk-WS4WAZVR.js";
 import {
   aggregateUsage,
   createReplayRecord,
@@ -140,7 +143,7 @@ import {
   sessionIdFromHandle,
   toReplayedTurn,
   updateFromEvent
-} from "./chunk-A75XDJIC.js";
+} from "./chunk-AIG5LSGK.js";
 import {
   XYZ_DATA_DIR_ENV,
   resetDataDirWarnForTests,
@@ -193,6 +196,7 @@ export {
   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,7 +226,6 @@ export {
   hostKindOf,
   isEngineErrorPassthroughCode,
   isEngineProtocolErrorCode,
-  isHostRoundLifecycleParams,
   isHostStreamDeltaParams,
   isNotificationFrame,
   isPidAlive,
@@ -231,6 +234,7 @@ export {
   isRequestFrame,
   isResponseFrame,
   isReverseRequestFrame,
+  isUiResponse,
   killChain,
   notificationFrameSchema,
   parseChannel,
@@ -253,6 +257,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-ByIFoLrY.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-ByIFoLrY.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-ByIFoLrY.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-ByIFoLrY.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-DCiilt_8.cjs';
+import { A as AgentCallOpts, c as AgentOutcome } from './contract-types-ByIFoLrY.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-BUx92qYi.js';
+import { A as AgentCallOpts, c as AgentOutcome } from './contract-types-ByIFoLrY.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
 });

package/dist/port-contract.d.cts

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