@zhushanwen/subagent-engine-sdk 0.8.0 → 0.10.0

package/dist/index.cjs

@@ -6574,8 +6574,6 @@ var src_exports = {};
 __export(src_exports, {
   AGENT_EVENT_TYPE_NAMES: () => AGENT_EVENT_TYPE_NAMES,
   CANCEL_SETTLE_GRACE_MS: () => CANCEL_SETTLE_GRACE_MS,
-  CRASH_REBUILD_BACKOFF_MS: () => CRASH_REBUILD_BACKOFF_MS,
-  CRASH_REBUILD_MAX_ATTEMPTS: () => CRASH_REBUILD_MAX_ATTEMPTS,
   DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS: () => DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS,
   DEFAULT_KILL_GRACE_MS: () => DEFAULT_KILL_GRACE_MS,
   DEFAULT_NATIVE_INTERRUPT_GRACE_MS: () => DEFAULT_NATIVE_INTERRUPT_GRACE_MS,
@@ -6614,6 +6612,10 @@ __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,
+  SET_MODEL_ERROR_CODES: () => SET_MODEL_ERROR_CODES,
+  SET_MODEL_NOT_ACTIVE_CODE: () => SET_MODEL_NOT_ACTIVE_CODE,
+  SET_MODEL_REQUEST_TIMEOUT_MS: () => SET_MODEL_REQUEST_TIMEOUT_MS,
+  SET_MODEL_STAGE_TIMEOUT_MS: () => SET_MODEL_STAGE_TIMEOUT_MS,
   SHARED_POOL_KEY: () => SHARED_POOL_KEY,
   STDERR_TAIL_CHARS: () => STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS: () => STDOUT_TAIL_ECHO_CHARS,
@@ -6639,6 +6641,7 @@ __export(src_exports, {
   createUiChannelRegistry: () => createUiChannelRegistry,
   engineConversationUnsupportedError: () => engineConversationUnsupportedError,
   engineProtocolMismatchError: () => engineProtocolMismatchError,
+  engineSetModelUnsupportedError: () => engineSetModelUnsupportedError,
   engineTimeoutDetail: () => engineTimeoutDetail,
   errorResponseFrameSchema: () => errorResponseFrameSchema,
   eventsToSessionView: () => eventsToSessionView,
@@ -6705,15 +6708,8 @@ function isProtocolVersionCompatible(version) {
 var REVERSE_REQUEST_TIMEOUT_MS = 1e4;
 var HANDSHAKE_TIMEOUT_MS = 1e4;
 var CANCEL_SETTLE_GRACE_MS = 3e3;
-var CRASH_REBUILD_MAX_ATTEMPTS = 3;
-var CRASH_REBUILD_BACKOFF_STEP_1_MS = 1e3;
-var CRASH_REBUILD_BACKOFF_STEP_2_MS = 2e3;
-var CRASH_REBUILD_BACKOFF_STEP_3_MS = 4e3;
-var CRASH_REBUILD_BACKOFF_MS = [
-  CRASH_REBUILD_BACKOFF_STEP_1_MS,
-  CRASH_REBUILD_BACKOFF_STEP_2_MS,
-  CRASH_REBUILD_BACKOFF_STEP_3_MS
-];
+var SET_MODEL_STAGE_TIMEOUT_MS = 3e3;
+var SET_MODEL_REQUEST_TIMEOUT_MS = 1e4;
 var STDERR_TAIL_CHARS = 400;
 
 // src/protocol/frames.ts
@@ -6748,7 +6744,8 @@ var PROTOCOL_METHODS = [
   "listModels",
   "validateModel",
   "dispose",
-  "ping"
+  "ping",
+  "setModel"
 ];
 
 // src/protocol/reverse-channels.ts
@@ -6770,6 +6767,19 @@ var REVERSE_CHANNEL_TIMEOUT_CLASS = {
 };
 
 // src/protocol/error-codes.ts
+var SET_MODEL_ERROR_CODES = [
+  /** 目标模型不在当前进程快照（子进程模型快照冻结于 spawn 时刻——模型本身有效，
+   *  下一轮 spawn 现取目录即可用；宿主按「写覆盖意图」处置，设计 §7.2 快照型失败行）。 */
+  "engine_model_not_in_snapshot",
+  /** 凭据校验失败（子进程 set_model checkAuth 抛错——宿主预检通过后 registry 态漂移
+   *  的权威兜底；宿主按校验型失败处置，设计 §7.5 凭据行）。 */
+  "engine_credential_missing",
+  /** 命令已发出（set_model 可能已执行）但读应答 / get_state 回读无回执、生效值未知
+   *  （非进程退出情形——退出归无活进程路径；宿主按「写覆盖意图 + 错误应答」处置，
+   *  设计 §7.5 回读失败行）。 */
+  "engine_state_readback_failed"
+];
+var SET_MODEL_NOT_ACTIVE_CODE = "engine_run_not_active";
 var ENGINE_PROTOCOL_ERROR_CODES = [
   "engine_not_found",
   "engine_protocol_mismatch",
@@ -6779,7 +6789,9 @@ var ENGINE_PROTOCOL_ERROR_CODES = [
   "engine_model_mismatch",
   "engine_handshake_timeout",
   "engine_crashed",
-  "engine_probe_failed"
+  "engine_probe_failed",
+  ...SET_MODEL_ERROR_CODES,
+  SET_MODEL_NOT_ACTIVE_CODE
 ];
 function isEngineProtocolErrorCode(value) {
   return typeof value === "string" && ENGINE_PROTOCOL_ERROR_CODES.includes(value);
@@ -6829,6 +6841,14 @@ function assertChatConversationSupported(engineId, capabilities) {
     throw engineConversationUnsupportedError(engineId);
   }
 }
+function engineSetModelUnsupportedError(engineId, declared) {
+  return new EngineSdkError(
+    "engine_capability_unsupported",
+    `engine '${engineId}' does not support hot model switching (capabilities.setModel = ${declared ?? "unsupported (undeclared)"}); the host pre-check (design \xA77.2 step 2) must not dispatch setModel to it`,
+    `Route the switch to an engine that declares capabilities.setModel = 'native', or record the override for the next run instead. If this engine actually supports hot switching, fix the manifest capabilities declaration.`,
+    { engineId, capability: "setModel", declared: declared ?? "unsupported" }
+  );
+}
 var DETAIL_ECHO_MAX_CHARS = 200;
 var STDOUT_TAIL_ECHO_CHARS = 2e3;
 function truncate(text, max) {
@@ -8404,8 +8424,6 @@ function runEngineCliEntry(opts) {
 0 && (module.exports = {
   AGENT_EVENT_TYPE_NAMES,
   CANCEL_SETTLE_GRACE_MS,
-  CRASH_REBUILD_BACKOFF_MS,
-  CRASH_REBUILD_MAX_ATTEMPTS,
   DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS,
   DEFAULT_KILL_GRACE_MS,
   DEFAULT_NATIVE_INTERRUPT_GRACE_MS,
@@ -8444,6 +8462,10 @@ function runEngineCliEntry(opts) {
   REVERSE_CHANNEL_TIMEOUT_CLASS,
   REVERSE_REQUEST_TIMEOUT_MS,
   SCHEMA_EMULATION_TAIL_CHARS,
+  SET_MODEL_ERROR_CODES,
+  SET_MODEL_NOT_ACTIVE_CODE,
+  SET_MODEL_REQUEST_TIMEOUT_MS,
+  SET_MODEL_STAGE_TIMEOUT_MS,
   SHARED_POOL_KEY,
   STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS,
@@ -8469,6 +8491,7 @@ function runEngineCliEntry(opts) {
   createUiChannelRegistry,
   engineConversationUnsupportedError,
   engineProtocolMismatchError,
+  engineSetModelUnsupportedError,
   engineTimeoutDetail,
   errorResponseFrameSchema,
   eventsToSessionView,

package/dist/index.d.cts

@@ -1,6 +1,7 @@
-export { CANCEL_SETTLE_GRACE_MS, CRASH_REBUILD_BACKOFF_MS, CRASH_REBUILD_MAX_ATTEMPTS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, HostAskUserParams, HostAskUserResult, HostChildSpawnedParams, HostChildStateChangedParams, HostHandleReadyParams, HostLogParams, HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReverseChannel, ReverseRequestTimeoutClass, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema } from './protocol/index.cjs';
-export { C as CancelParams, b as CancelResult, D as DisposeParams, c as DisposeResult, d as ENGINE_ERROR_CODE_PREFIX, e as ENGINE_PROTOCOL_ERROR_CODES, f as ENGINE_TIMEOUT_RECOVERY, g as EngineProtocolErrorCode, E as EngineSdkError, h as ErrorResponseFrame, i as EventNotificationParams, a as InitializeParams, I as InitializeResult, L as ListModelsParams, j as ListModelsResult, N as NotificationFrame, P as PROTOCOL_METHODS, k as PingParams, l as PingResult, m as ProbeParams, n as ProtocolError, o as ProtocolMethod, p as ProtocolParamsMap, q as ProtocolResultMap, r as ReadParams, s as RequestFrame, t as ResponseFrame, u as ReverseRequestFrame, v as ReverseResponseResult, R as RunContextParams, w as RunParams, x as RunResult, y as RunResumeParams, S as STDOUT_TAIL_ECHO_CHARS, z as SuccessResponseFrame, V as ValidateModelParams, A as ValidateModelResult, B as assertChatConversationSupported, F as engineConversationUnsupportedError, G as engineProtocolMismatchError, H as engineTimeoutDetail, J as isEngineErrorPassthroughCode, K as isEngineProtocolErrorCode, M as isNotificationFrame, O as isRequestFrame, Q as isResponseFrame, T as isReverseRequestFrame, U as schemaEmulationFailedDetail } from './error-codes-C3oVToMr.cjs';
-export { f as AGENT_EVENT_TYPE_NAMES, b as AgentCallOpts, A as AgentEvent, g as AgentEventTypeName, h as AgentFailureKind, c as AgentOutcome, i as AgentOutcomeUsage, j as AgentUsage, a as AgentUsageTotal, k as AssertMutuallyAssignable, d as EngineCapabilities, E as EngineHandleData, l as EngineProcessModel, I as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, e as ResumeAnchor, S as SessionView, m as ToolCall, n as ToolCallEntry, o as ToolCallResult, T as Turn, W as WorktreeHandle } from './contract-types-DqOD58r-.cjs';
+export { CANCEL_SETTLE_GRACE_MS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, HostAskUserParams, HostAskUserResult, HostChildSpawnedParams, HostChildStateChangedParams, HostHandleReadyParams, HostLogParams, HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReverseChannel, ReverseRequestTimeoutClass, SET_MODEL_REQUEST_TIMEOUT_MS, SET_MODEL_STAGE_TIMEOUT_MS, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema } from './protocol/index.cjs';
+export { a as ENGINE_ERROR_CODE_PREFIX, b as ENGINE_PROTOCOL_ERROR_CODES, c as ENGINE_TIMEOUT_RECOVERY, d as EngineProtocolErrorCode, E 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 SET_MODEL_ERROR_CODES, j as SET_MODEL_NOT_ACTIVE_CODE, k as STDOUT_TAIL_ECHO_CHARS, l as SetModelErrorCode, m as SuccessResponseFrame, n as assertChatConversationSupported, o as engineConversationUnsupportedError, p as engineProtocolMismatchError, q as engineSetModelUnsupportedError, r as engineTimeoutDetail, s as isEngineErrorPassthroughCode, t as isEngineProtocolErrorCode, u as isNotificationFrame, v as isRequestFrame, w as isResponseFrame, x as isReverseRequestFrame, y as schemaEmulationFailedDetail } from './error-codes-f-UO4a8D.cjs';
+export { C as CancelParams, c as CancelResult, D as DisposeParams, d as DisposeResult, b as InitializeParams, I as InitializeResult, L as ListModelsParams, e as ListModelsResult, P as PROTOCOL_METHODS, f as PingParams, g as PingResult, h as ProbeParams, i as ProtocolMethod, j as ProtocolParamsMap, k as ProtocolResultMap, l as ReadParams, R as RunContextParams, m as RunParams, n as RunResult, o as RunResumeParams, S as SetModelParams, a as SetModelResult, V as ValidateModelParams, p as ValidateModelResult } from './methods-BLxg4ZFr.cjs';
+export { g as AGENT_EVENT_TYPE_NAMES, b as AgentCallOpts, A as AgentEvent, h as AgentEventTypeName, i as AgentFailureKind, c as AgentOutcome, j as AgentOutcomeUsage, k as AgentUsage, a as AgentUsageTotal, l as AssertMutuallyAssignable, d as EngineCapabilities, E as EngineHandleData, m as EngineProcessModel, I as InternalToolCall, f as ModelCatalogEntry, M as ModelRef, P as ProbeReport, R as ReplayedTurn, e as ResumeAnchor, S as SessionView, n as ToolCall, o as ToolCallEntry, p as ToolCallResult, T as Turn, W as WorktreeHandle } from './contract-types-jSa1g28F.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';

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-export { CANCEL_SETTLE_GRACE_MS, CRASH_REBUILD_BACKOFF_MS, CRASH_REBUILD_MAX_ATTEMPTS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, HostAskUserParams, HostAskUserResult, HostChildSpawnedParams, HostChildStateChangedParams, HostHandleReadyParams, HostLogParams, HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReverseChannel, ReverseRequestTimeoutClass, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema } from './protocol/index.js';
-export { C as CancelParams, b as CancelResult, D as DisposeParams, c as DisposeResult, d as ENGINE_ERROR_CODE_PREFIX, e as ENGINE_PROTOCOL_ERROR_CODES, f as ENGINE_TIMEOUT_RECOVERY, g as EngineProtocolErrorCode, E as EngineSdkError, h as ErrorResponseFrame, i as EventNotificationParams, a as InitializeParams, I as InitializeResult, L as ListModelsParams, j as ListModelsResult, N as NotificationFrame, P as PROTOCOL_METHODS, k as PingParams, l as PingResult, m as ProbeParams, n as ProtocolError, o as ProtocolMethod, p as ProtocolParamsMap, q as ProtocolResultMap, r as ReadParams, s as RequestFrame, t as ResponseFrame, u as ReverseRequestFrame, v as ReverseResponseResult, R as RunContextParams, w as RunParams, x as RunResult, y as RunResumeParams, S as STDOUT_TAIL_ECHO_CHARS, z as SuccessResponseFrame, V as ValidateModelParams, A as ValidateModelResult, B as assertChatConversationSupported, F as engineConversationUnsupportedError, G as engineProtocolMismatchError, H as engineTimeoutDetail, J as isEngineErrorPassthroughCode, K as isEngineProtocolErrorCode, M as isNotificationFrame, O as isRequestFrame, Q as isResponseFrame, T as isReverseRequestFrame, U as schemaEmulationFailedDetail } from './error-codes-CiDwaODz.js';
-export { f as AGENT_EVENT_TYPE_NAMES, b as AgentCallOpts, A as AgentEvent, g as AgentEventTypeName, h as AgentFailureKind, c as AgentOutcome, i as AgentOutcomeUsage, j as AgentUsage, a as AgentUsageTotal, k as AssertMutuallyAssignable, d as EngineCapabilities, E as EngineHandleData, l as EngineProcessModel, I as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, e as ResumeAnchor, S as SessionView, m as ToolCall, n as ToolCallEntry, o as ToolCallResult, T as Turn, W as WorktreeHandle } from './contract-types-DqOD58r-.js';
+export { CANCEL_SETTLE_GRACE_MS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, HostAskUserParams, HostAskUserResult, HostChildSpawnedParams, HostChildStateChangedParams, HostHandleReadyParams, HostLogParams, HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReverseChannel, ReverseRequestTimeoutClass, SET_MODEL_REQUEST_TIMEOUT_MS, SET_MODEL_STAGE_TIMEOUT_MS, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema } from './protocol/index.js';
+export { a as ENGINE_ERROR_CODE_PREFIX, b as ENGINE_PROTOCOL_ERROR_CODES, c as ENGINE_TIMEOUT_RECOVERY, d as EngineProtocolErrorCode, E 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 SET_MODEL_ERROR_CODES, j as SET_MODEL_NOT_ACTIVE_CODE, k as STDOUT_TAIL_ECHO_CHARS, l as SetModelErrorCode, m as SuccessResponseFrame, n as assertChatConversationSupported, o as engineConversationUnsupportedError, p as engineProtocolMismatchError, q as engineSetModelUnsupportedError, r as engineTimeoutDetail, s as isEngineErrorPassthroughCode, t as isEngineProtocolErrorCode, u as isNotificationFrame, v as isRequestFrame, w as isResponseFrame, x as isReverseRequestFrame, y as schemaEmulationFailedDetail } from './error-codes-DnFru4L4.js';
+export { C as CancelParams, c as CancelResult, D as DisposeParams, d as DisposeResult, b as InitializeParams, I as InitializeResult, L as ListModelsParams, e as ListModelsResult, P as PROTOCOL_METHODS, f as PingParams, g as PingResult, h as ProbeParams, i as ProtocolMethod, j as ProtocolParamsMap, k as ProtocolResultMap, l as ReadParams, R as RunContextParams, m as RunParams, n as RunResult, o as RunResumeParams, S as SetModelParams, a as SetModelResult, V as ValidateModelParams, p as ValidateModelResult } from './methods-C2zvZqhP.js';
+export { g as AGENT_EVENT_TYPE_NAMES, b as AgentCallOpts, A as AgentEvent, h as AgentEventTypeName, i as AgentFailureKind, c as AgentOutcome, j as AgentOutcomeUsage, k as AgentUsage, a as AgentUsageTotal, l as AssertMutuallyAssignable, d as EngineCapabilities, E as EngineHandleData, m as EngineProcessModel, I as InternalToolCall, f as ModelCatalogEntry, M as ModelRef, P as ProbeReport, R as ReplayedTurn, e as ResumeAnchor, S as SessionView, n as ToolCall, o as ToolCallEntry, p as ToolCallResult, T as Turn, W as WorktreeHandle } from './contract-types-jSa1g28F.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';

package/dist/index.js

@@ -59,14 +59,14 @@ import {
   armEngineSelfDestruct,
   pumpNdjsonLines,
   spawnEngineChild
-} from "./chunk-MQPASWMA.js";
+} from "./chunk-HSNDUHFH.js";
 import {
   ENGINE_NODE_ENV,
   hostKindOf,
   probeNodeExecutor,
   resetEngineNodeProbeCache,
   resolveEngineNodeLaunch
-} from "./chunk-3WC36CHI.js";
+} from "./chunk-NTOLHLCL.js";
 import {
   DEFAULT_STDERR_KEEP_DAYS,
   DEFAULT_STDERR_MAX_BYTES,
@@ -92,7 +92,7 @@ import {
   reverseRequestFrameSchema,
   runSessionParamsSchema,
   successResponseFrameSchema
-} from "./chunk-DIIYVO4O.js";
+} from "./chunk-LM7P7OTA.js";
 import {
   isNotificationFrame,
   isRequestFrame,
@@ -121,14 +121,12 @@ import {
   probePidAlive,
   safeKill,
   synthesizeTimeoutOutcome
-} from "./chunk-F7VDVSBZ.js";
+} from "./chunk-CNCFMPEH.js";
 import {
   toErrorMessage
 } from "./chunk-PYO3YR7W.js";
 import {
   CANCEL_SETTLE_GRACE_MS,
-  CRASH_REBUILD_BACKOFF_MS,
-  CRASH_REBUILD_MAX_ATTEMPTS,
   ENGINE_ERROR_CODE_PREFIX,
   ENGINE_PROTOCOL_ERROR_CODES,
   ENGINE_PROTOCOL_VERSION,
@@ -136,18 +134,23 @@ import {
   EngineSdkError,
   HANDSHAKE_TIMEOUT_MS,
   REVERSE_REQUEST_TIMEOUT_MS,
+  SET_MODEL_ERROR_CODES,
+  SET_MODEL_NOT_ACTIVE_CODE,
+  SET_MODEL_REQUEST_TIMEOUT_MS,
+  SET_MODEL_STAGE_TIMEOUT_MS,
   STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS,
   SUPPORTED_PROTOCOL_RANGE,
   assertChatConversationSupported,
   engineConversationUnsupportedError,
   engineProtocolMismatchError,
+  engineSetModelUnsupportedError,
   engineTimeoutDetail,
   isEngineErrorPassthroughCode,
   isEngineProtocolErrorCode,
   isProtocolVersionCompatible,
   schemaEmulationFailedDetail
-} from "./chunk-SFNTX7Q3.js";
+} from "./chunk-JZN76I3S.js";
 import {
   configureLoggerSink,
   getLogger,
@@ -221,8 +224,6 @@ var RELAY_REJECT_REASONS = {
 export {
   AGENT_EVENT_TYPE_NAMES,
   CANCEL_SETTLE_GRACE_MS,
-  CRASH_REBUILD_BACKOFF_MS,
-  CRASH_REBUILD_MAX_ATTEMPTS,
   DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS,
   DEFAULT_KILL_GRACE_MS,
   DEFAULT_NATIVE_INTERRUPT_GRACE_MS,
@@ -261,6 +262,10 @@ export {
   REVERSE_CHANNEL_TIMEOUT_CLASS,
   REVERSE_REQUEST_TIMEOUT_MS,
   SCHEMA_EMULATION_TAIL_CHARS,
+  SET_MODEL_ERROR_CODES,
+  SET_MODEL_NOT_ACTIVE_CODE,
+  SET_MODEL_REQUEST_TIMEOUT_MS,
+  SET_MODEL_STAGE_TIMEOUT_MS,
   SHARED_POOL_KEY,
   STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS,
@@ -286,6 +291,7 @@ export {
   createUiChannelRegistry,
   engineConversationUnsupportedError,
   engineProtocolMismatchError,
+  engineSetModelUnsupportedError,
   engineTimeoutDetail,
   errorResponseFrameSchema,
   eventsToSessionView,

package/dist/journal-io.d.cts

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

package/dist/journal-io.d.ts

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

package/dist/journal-replay.d.cts

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

package/dist/journal-replay.d.ts

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

package/dist/kill-chain.cjs

@@ -101,6 +101,32 @@ function toErrorMessage(e) {
 }
 
 // src/protocol/error-codes.ts
+var SET_MODEL_ERROR_CODES = [
+  /** 目标模型不在当前进程快照（子进程模型快照冻结于 spawn 时刻——模型本身有效，
+   *  下一轮 spawn 现取目录即可用；宿主按「写覆盖意图」处置，设计 §7.2 快照型失败行）。 */
+  "engine_model_not_in_snapshot",
+  /** 凭据校验失败（子进程 set_model checkAuth 抛错——宿主预检通过后 registry 态漂移
+   *  的权威兜底；宿主按校验型失败处置，设计 §7.5 凭据行）。 */
+  "engine_credential_missing",
+  /** 命令已发出（set_model 可能已执行）但读应答 / get_state 回读无回执、生效值未知
+   *  （非进程退出情形——退出归无活进程路径；宿主按「写覆盖意图 + 错误应答」处置，
+   *  设计 §7.5 回读失败行）。 */
+  "engine_state_readback_failed"
+];
+var SET_MODEL_NOT_ACTIVE_CODE = "engine_run_not_active";
+var ENGINE_PROTOCOL_ERROR_CODES = [
+  "engine_not_found",
+  "engine_protocol_mismatch",
+  "engine_capability_unsupported",
+  "engine_capability_mismatch",
+  "engine_model_unknown",
+  "engine_model_mismatch",
+  "engine_handshake_timeout",
+  "engine_crashed",
+  "engine_probe_failed",
+  ...SET_MODEL_ERROR_CODES,
+  SET_MODEL_NOT_ACTIVE_CODE
+];
 var STDOUT_TAIL_ECHO_CHARS = 2e3;
 function truncate(text, max) {
   return text.length <= max ? text : `${text.slice(0, max)}...`;

package/dist/kill-chain.d.cts

@@ -1,4 +1,4 @@
-import { b as AgentCallOpts, c as AgentOutcome } from './contract-types-DqOD58r-.cjs';
+import { b as AgentCallOpts, c as AgentOutcome } from './contract-types-jSa1g28F.cjs';
 
 /**
  * 可杀子进程的结构形状（Node ChildProcess 的结构子集）。

package/dist/kill-chain.d.ts

@@ -1,4 +1,4 @@
-import { b as AgentCallOpts, c as AgentOutcome } from './contract-types-DqOD58r-.js';
+import { b as AgentCallOpts, c as AgentOutcome } from './contract-types-jSa1g28F.js';
 
 /**
  * 可杀子进程的结构形状（Node ChildProcess 的结构子集）。

package/dist/kill-chain.js

@@ -8,9 +8,9 @@ import {
   probePidAlive,
   safeKill,
   synthesizeTimeoutOutcome
-} from "./chunk-F7VDVSBZ.js";
+} from "./chunk-CNCFMPEH.js";
 import "./chunk-PYO3YR7W.js";
-import "./chunk-SFNTX7Q3.js";
+import "./chunk-JZN76I3S.js";
 import "./chunk-NXNNXGTY.js";
 import "./chunk-JSBRDJBE.js";
 export {

package/dist/{error-codes-CiDwaODz.d.ts → methods-BLxg4ZFr.d.cts}

@@ -1,76 +1,15 @@
-import { A as AgentEvent, d as EngineCapabilities, M as ModelCatalogEntry, b as AgentCallOpts, e as ResumeAnchor, E as EngineHandleData, P as ProbeReport, c as AgentOutcome, S as SessionView } from './contract-types-DqOD58r-.js';
-
-/** 协议错误对象（error 帧载荷与反向请求错误应答共用形态）。 */
-interface ProtocolError {
-    /** 错误码（error-codes.ts 词表 + 其余 engine_* 引擎自报透传）。 */
-    code: string;
-    /** 人类可读详情。 */
-    message: string;
-    /** 恢复指引：指向具体下一步（命令 / 配置路径 / 升级动作），非安慰性文案。 */
-    recovery: string;
-    /** 结构化附参（如 engine_protocol_mismatch 的双方版本）。 */
-    data?: Record<string, unknown>;
-}
-interface RequestFrame {
-    id: number;
-    method: string;
-    params: unknown;
-}
-interface SuccessResponseFrame {
-    id: number | string;
-    result: unknown;
-}
-interface ErrorResponseFrame {
-    id: number | string;
-    error: ProtocolError;
-}
-type ResponseFrame = SuccessResponseFrame | ErrorResponseFrame;
-/** event 通知载荷：runId 关联在途 run；seq 单调递增（基线①结构等价断言对象）。 */
-interface EventNotificationParams {
-    runId: string;
-    seq: number;
-    event: AgentEvent;
-}
-interface NotificationFrame {
-    method: "event";
-    params: EventNotificationParams;
-}
-interface ReverseRequestFrame {
-    id: string;
-    method: string;
-    params: unknown;
-}
-/** 反向请求的应答（core → 引擎，沿 ResponseFrame 通道回传；id = 反向请求 id 原样）。 */
-type ReverseResponseResult = 
-/** 数据面类：处理确认。 */
-{
-    ok: true;
-}
-/** 人机交互类（askUser）两阶段第一阶段：已受理，结果异步到达（R9-2）。 */
- | {
-    ack: true;
-}
-/** 未实现或宿主未知的通道（宽容语义③：由 askUser 语境泛化到全通道——宿主对未知 host/* 通道回 unsupported，引擎自行降级）。 */
- | {
-    unsupported: true;
-};
-/** ① 请求：有数字 id + method + params，且无 result/error（与②应答区分）。 */
-declare function isRequestFrame(frame: unknown): frame is RequestFrame;
-/** ② 应答：有 id（number|string）且 result/error 二选一。 */
-declare function isResponseFrame(frame: unknown): frame is ResponseFrame;
-/** ③ 通知：无 id，method === "event"，params 含 runId/seq/event。 */
-declare function isNotificationFrame(frame: unknown): frame is NotificationFrame;
-/** ④ 反向请求：有字符串 id + host/* method + params（与①的区别 = id 形态与 method 前缀）。 */
-declare function isReverseRequestFrame(frame: unknown): frame is ReverseRequestFrame;
+import { M as ModelRef, d as EngineCapabilities, f as ModelCatalogEntry, b as AgentCallOpts, e as ResumeAnchor, E as EngineHandleData, P as ProbeReport, c as AgentOutcome, S as SessionView } from './contract-types-jSa1g28F.cjs';
 
 /**
- * 正向方法名联合（恰好 9 个；PROTOCOL_METHODS 常量数组与之同源互证）。
+ * 正向方法名联合（恰好 10 个；PROTOCOL_METHODS 常量数组与之同源互证）。
  * [H1] `interact` 成员已随 chat-run 统一退役（docs/architecture/subagent-chat-run-unification.md
  * §3.3 D5：续聊轮统一为「新 run + resume 锚点」，U5 删除）。
+ * [subagent-model-switch] `setModel` 为执行中模型热切换方法（capabilities.setModel
+ * 位门控；消费点 = 宿主发送前预检，位不支持不发调用）。
  */
-type ProtocolMethod = "initialize" | "probe" | "run" | "cancel" | "read" | "listModels" | "validateModel" | "dispose" | "ping";
+type ProtocolMethod = "initialize" | "probe" | "run" | "cancel" | "read" | "listModels" | "validateModel" | "dispose" | "ping" | "setModel";
 /** 方法名全集（运行时顺序化枚举；与 ProtocolMethod 的同源关系由测试断言）。 */
-declare const PROTOCOL_METHODS: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping"];
+declare const PROTOCOL_METHODS: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping", "setModel"];
 /**
  * run 上下文（RunContext 字段映射的协议承载，设计 §3.3 RunContext 映射表）。
  */
@@ -231,6 +170,43 @@ interface PingParams {
 interface PingResult {
     pong: true;
 }
+/**
+ * [subagent-model-switch §7.3] setModel 参数——RunParams 同级的 run 定向方法
+ * （params 以 runId 寻址活跃子进程，对照 cancel）。
+ *
+ * 语义（引擎侧实装义务，权威 = 设计 §7.3）：定位活跃子进程 → 转发 pi 原生
+ * `set_model` → 读应答 → get_state 回读生效值 → 应答。请求 model 是**目标意图**
+ * （pi 部分模型族会静默替换成同族模型），生效值以应答 effectiveModel 为准。
+ * 失败经 error 帧，分型值域 = SET_MODEL_ERROR_CODES 三型
+ * （engine_model_not_in_snapshot / engine_credential_missing / engine_state_readback_failed）；
+ * 目标 run 无活跃子进程（定位时 / 命令写入 / 读应答 / 回读四个竞态窗口内退出——
+ * 同一处置）按「无活进程」形态应答 = error 帧 `SET_MODEL_NOT_ACTIVE_CODE`
+ * （engine_run_not_active，宿主转纯记账路径，§7.5 子进程已退出行）。
+ *
+ * 无 thinkingLevel 参数（D5 裁决 M1-1）：热切档位由 pi set_model 按新模型档位表
+ * 联动重设管辖（生效值以应答 effectiveThinkingLevel 为准）；用户显式档位经覆盖
+ * 记账在下一轮 spawn 由解析链裁决（§6.2 跨轮档位以解析链为准）。未来引擎真支持
+ * 档位热切时走 additive 演进（新增可选参数）。
+ *
+ * 消费链：U2 宿主编排经 EnginePort 调用（capabilities.setModel='native' 预检通过后）；
+ * U3 pi 引擎实装；U5 run 级聚合逐成员转发复用同一方法。
+ */
+interface SetModelParams {
+    /** 目标 run 的 id（RunParams.runId 同源——引擎以它定位活跃子进程）。 */
+    runId: string;
+    /** 目标模型 ref（provider + modelId；宿主编排层负责与 canonical ref 目录互校）。 */
+    model: ModelRef;
+}
+/**
+ * [subagent-model-switch §7.3] setModel 应答——**回读生效值**（get_state 同源读回，
+ * 非命令应答转述；同族替换时 effectiveModel ≠ 请求 model）。
+ */
+interface SetModelResult {
+    /** 生效模型 ref（pi 子进程活状态读回）。 */
+    effectiveModel: ModelRef;
+    /** 生效 thinking 档位（pi set_model 联动重设后的实际档位）。 */
+    effectiveThinkingLevel: string;
+}
 /** 方法 → params 类型映射。 */
 interface ProtocolParamsMap {
     initialize: InitializeParams;
@@ -242,6 +218,7 @@ interface ProtocolParamsMap {
     validateModel: ValidateModelParams;
     dispose: DisposeParams;
     ping: PingParams;
+    setModel: SetModelParams;
 }
 /** 方法 → result 类型映射。 */
 interface ProtocolResultMap {
@@ -254,58 +231,7 @@ interface ProtocolResultMap {
     validateModel: ValidateModelResult;
     dispose: DisposeResult;
     ping: PingResult;
+    setModel: SetModelResult;
 }
 
-/** 协议核心错误码（引擎 error 帧 + core 同步拦截共用的固定词表）。 */
-declare const ENGINE_PROTOCOL_ERROR_CODES: readonly ["engine_not_found", "engine_protocol_mismatch", "engine_capability_unsupported", "engine_capability_mismatch", "engine_model_unknown", "engine_model_mismatch", "engine_handshake_timeout", "engine_crashed", "engine_probe_failed"];
-type EngineProtocolErrorCode = (typeof ENGINE_PROTOCOL_ERROR_CODES)[number];
-/** unknown → 协议错误码收窄（外部输入携带错误码时的运行时 guard；其余 engine_* 走透传）。 */
-declare function isEngineProtocolErrorCode(value: unknown): value is EngineProtocolErrorCode;
-/** 其余引擎自报错误码的前缀契约（透传面；core 不解释文案）。 */
-declare const ENGINE_ERROR_CODE_PREFIX = "engine_";
-declare function isEngineErrorPassthroughCode(value: string): boolean;
-
-/**
- * 结构化引擎错误（message 恒为 `<code>: <detail>` 前缀格式——AgentOutcome.error 与
- * 协议 error 帧共用的错误码前缀约定）；recovery 指向恢复动作。
- * toStructured() 产出即协议 ProtocolError 形态（error 帧载荷直用）。
- */
-declare class EngineSdkError extends Error {
-    readonly code: string;
-    readonly recovery: string;
-    readonly data?: Record<string, unknown>;
-    constructor(code: string, detail: string, recovery: string, data?: Record<string, unknown>);
-    /** 协议 error 帧载荷投影。 */
-    toStructured(): ProtocolError;
-}
-declare function engineProtocolMismatchError(engineVersion: number): EngineSdkError;
-/**
- * 引擎 conversation 位拒绝的具名错误（[modeless 波2] 语义：无 resume 续聊通道的
- * 引擎，message 续聊资格被拒——manifest conversation 能力轴消费；[modeless 波5
- * 收尾] core capability-gate 的显式参数分支随派发参数删除退役，本构造器消费方 =
- * 引擎侧 resume gate（assertChatConversationSupported）与 message 资格门）。
- * 文案契约：错误码 engine_capability_unsupported + 「换引擎续聊 / 修 manifest /
- * 升级引擎包」恢复指引，两侧一致防漂移。
- */
-declare function engineConversationUnsupportedError(engineId: string): EngineSdkError;
-/**
- * resume 会话形态（run.params.resume——唯一会话形态键）派发前的同步 gate：
- * manifest conversation 位 unsupported 即抛 engineConversationUnsupportedError
- * ——进程/record 创建前同步拒（A6 方向防御：manifest/实装漂移时引擎侧自拒，
- * 与 core capability-gate 同一能力位，防两侧判据漂移）。[modeless 波2] 协议
- * task 的 conversation 键已删，本 gate 只对 resume 形态键生效。
- */
-declare function assertChatConversationSupported(engineId: string, capabilities: Pick<EngineCapabilities, "conversation">): void;
-/** stdout 尾部回显上限（engine_timeout / engine_run_failed 的错误规格载体系数）。 */
-declare const STDOUT_TAIL_ECHO_CHARS = 2000;
-/** engine_timeout 的恢复指引（kill-chain 超时杀链收尾文案）。 */
-declare const ENGINE_TIMEOUT_RECOVERY: string;
-/**
- * engine_timeout 的 outcome.error 文案：含 stdout 尾部 2000 字 + 恢复指引
- * （kill-chain synthesizeTimeoutOutcome 消费；与 core errors.ts engineTimeoutDetail 逐字等价）。
- */
-declare function engineTimeoutDetail(stdoutTail: string): string;
-/** schema_emulation_failed 的终报文案（宿主编排层「重试一次仍失败」后消费）。 */
-declare function schemaEmulationFailedDetail(error: string, tail: string): string;
-
-export { type ValidateModelResult as A, assertChatConversationSupported as B, type CancelParams as C, type DisposeParams as D, EngineSdkError as E, engineConversationUnsupportedError as F, engineProtocolMismatchError as G, engineTimeoutDetail as H, type InitializeResult as I, isEngineErrorPassthroughCode as J, isEngineProtocolErrorCode as K, type ListModelsParams as L, isNotificationFrame as M, type NotificationFrame as N, isRequestFrame as O, PROTOCOL_METHODS as P, isResponseFrame as Q, type RunContextParams as R, STDOUT_TAIL_ECHO_CHARS as S, isReverseRequestFrame as T, schemaEmulationFailedDetail as U, type ValidateModelParams as V, type InitializeParams as a, type CancelResult as b, type DisposeResult as c, ENGINE_ERROR_CODE_PREFIX as d, ENGINE_PROTOCOL_ERROR_CODES as e, ENGINE_TIMEOUT_RECOVERY as f, type EngineProtocolErrorCode as g, type ErrorResponseFrame as h, type EventNotificationParams as i, type ListModelsResult as j, type PingParams as k, type PingResult as l, type ProbeParams as m, type ProtocolError as n, type ProtocolMethod as o, type ProtocolParamsMap as p, type ProtocolResultMap as q, type ReadParams as r, type RequestFrame as s, type ResponseFrame as t, type ReverseRequestFrame as u, type ReverseResponseResult as v, type RunParams as w, type RunResult as x, type RunResumeParams as y, type SuccessResponseFrame as z };
+export { type CancelParams as C, type DisposeParams as D, type InitializeResult as I, type ListModelsParams as L, PROTOCOL_METHODS as P, type RunContextParams as R, type SetModelParams as S, type ValidateModelParams as V, type SetModelResult as a, type InitializeParams as b, type CancelResult as c, type DisposeResult as d, type ListModelsResult as e, type PingParams as f, type PingResult as g, type ProbeParams as h, type ProtocolMethod as i, type ProtocolParamsMap as j, type ProtocolResultMap as k, type ReadParams as l, type RunParams as m, type RunResult as n, type RunResumeParams as o, type ValidateModelResult as p };