@zhushanwen/subagent-engine-sdk 0.8.0 → 0.10.0

package/dist/{error-codes-C3oVToMr.d.cts → methods-C2zvZqhP.d.ts}

@@ -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-.cjs';
-
-/** 协议错误对象（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.js';
 
 /**
- * 正向方法名联合（恰好 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 };

package/dist/node-executor.cjs

@@ -30,6 +30,32 @@ module.exports = __toCommonJS(node_executor_exports);
 var import_node_child_process = require("child_process");
 
 // 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 EngineSdkError = class extends Error {
   code;
   recovery;

package/dist/node-executor.js

@@ -4,8 +4,8 @@ import {
   probeNodeExecutor,
   resetEngineNodeProbeCache,
   resolveEngineNodeLaunch
-} from "./chunk-3WC36CHI.js";
-import "./chunk-SFNTX7Q3.js";
+} from "./chunk-NTOLHLCL.js";
+import "./chunk-JZN76I3S.js";
 import "./chunk-JSBRDJBE.js";
 export {
   ENGINE_NODE_ENV,

package/dist/port-contract.d.cts

@@ -1,4 +1,5 @@
-import { b as AgentCallOpts, E as EngineHandleData, d as EngineCapabilities, P as ProbeReport, A as AgentEvent, e as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-DqOD58r-.cjs';
+import { b as AgentCallOpts, E as EngineHandleData, d as EngineCapabilities, P as ProbeReport, A as AgentEvent, e as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-jSa1g28F.cjs';
+import { S as SetModelParams, a as SetModelResult } from './methods-BLxg4ZFr.cjs';
 
 /**
  * 引擎进程内全量任务声明 = SDK AgentCallOpts 引擎面子集 + 协议 ctx 还原字段（model/
@@ -125,6 +126,15 @@ interface EnginePort {
     validateModel?(modelRef: string | undefined): {
         canonicalRef: string;
     };
+    /**
+     * [subagent-model-switch §7.3] 可选面：执行中模型热切换（协议 setModel 正向方法的
+     * 进程内承载）。实现引擎须 capabilities.setModel = 'native' 同批声明（位与方法
+     * 成对进出——capabilities 注释的消费点登记）；server 分发行在位非 native 时回
+     * engineSetModelUnsupportedError 结构化错误（契约行为 = 明确错误而非崩）。
+     * 实现语义 = 定位活跃子进程 → 命令写入 → 读应答 → 状态回读 → 应答生效值
+     * （SetModelResult），竞态窗口处置见设计 §7.3。
+     */
+    setModel?(params: SetModelParams): Promise<SetModelResult>;
     dispose?(): Promise<void>;
 }
 /** ctx.ctxModel（"provider/id" canonical 词形）→ EngineCtxModel。 */

package/dist/port-contract.d.ts

@@ -1,4 +1,5 @@
-import { b as AgentCallOpts, E as EngineHandleData, d as EngineCapabilities, P as ProbeReport, A as AgentEvent, e as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-DqOD58r-.js';
+import { b as AgentCallOpts, E as EngineHandleData, d as EngineCapabilities, P as ProbeReport, A as AgentEvent, e as ResumeAnchor, c as AgentOutcome, S as SessionView } from './contract-types-jSa1g28F.js';
+import { S as SetModelParams, a as SetModelResult } from './methods-C2zvZqhP.js';
 
 /**
  * 引擎进程内全量任务声明 = SDK AgentCallOpts 引擎面子集 + 协议 ctx 还原字段（model/
@@ -125,6 +126,15 @@ interface EnginePort {
     validateModel?(modelRef: string | undefined): {
         canonicalRef: string;
     };
+    /**
+     * [subagent-model-switch §7.3] 可选面：执行中模型热切换（协议 setModel 正向方法的
+     * 进程内承载）。实现引擎须 capabilities.setModel = 'native' 同批声明（位与方法
+     * 成对进出——capabilities 注释的消费点登记）；server 分发行在位非 native 时回
+     * engineSetModelUnsupportedError 结构化错误（契约行为 = 明确错误而非崩）。
+     * 实现语义 = 定位活跃子进程 → 命令写入 → 读应答 → 状态回读 → 应答生效值
+     * （SetModelResult），竞态窗口处置见设计 §7.3。
+     */
+    setModel?(params: SetModelParams): Promise<SetModelResult>;
     dispose?(): Promise<void>;
 }
 /** ctx.ctxModel（"provider/id" canonical 词形）→ EngineCtxModel。 */

package/dist/protocol/index.cjs

@@ -22,8 +22,6 @@ var protocol_exports = {};
 __export(protocol_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,
   ENGINE_ERROR_CODE_PREFIX: () => ENGINE_ERROR_CODE_PREFIX,
   ENGINE_PROTOCOL_ERROR_CODES: () => ENGINE_PROTOCOL_ERROR_CODES,
   ENGINE_PROTOCOL_SCHEMAS: () => ENGINE_PROTOCOL_SCHEMAS,
@@ -36,12 +34,17 @@ __export(protocol_exports, {
   REVERSE_CHANNELS: () => REVERSE_CHANNELS,
   REVERSE_CHANNEL_TIMEOUT_CLASS: () => REVERSE_CHANNEL_TIMEOUT_CLASS,
   REVERSE_REQUEST_TIMEOUT_MS: () => REVERSE_REQUEST_TIMEOUT_MS,
+  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,
   STDERR_TAIL_CHARS: () => STDERR_TAIL_CHARS,
   STDOUT_TAIL_ECHO_CHARS: () => STDOUT_TAIL_ECHO_CHARS,
   SUPPORTED_PROTOCOL_RANGE: () => SUPPORTED_PROTOCOL_RANGE,
   assertChatConversationSupported: () => assertChatConversationSupported,
   engineConversationUnsupportedError: () => engineConversationUnsupportedError,
   engineProtocolMismatchError: () => engineProtocolMismatchError,
+  engineSetModelUnsupportedError: () => engineSetModelUnsupportedError,
   engineTimeoutDetail: () => engineTimeoutDetail,
   errorResponseFrameSchema: () => errorResponseFrameSchema,
   isEngineErrorPassthroughCode: () => isEngineErrorPassthroughCode,
@@ -70,15 +73,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
@@ -113,7 +109,8 @@ var PROTOCOL_METHODS = [
   "listModels",
   "validateModel",
   "dispose",
-  "ping"
+  "ping",
+  "setModel"
 ];
 
 // src/protocol/reverse-channels.ts
@@ -135,6 +132,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",
@@ -144,7 +154,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);
@@ -194,6 +206,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) {
@@ -363,8 +383,6 @@ var runSessionParamsSchema = {
 0 && (module.exports = {
   AGENT_EVENT_TYPE_NAMES,
   CANCEL_SETTLE_GRACE_MS,
-  CRASH_REBUILD_BACKOFF_MS,
-  CRASH_REBUILD_MAX_ATTEMPTS,
   ENGINE_ERROR_CODE_PREFIX,
   ENGINE_PROTOCOL_ERROR_CODES,
   ENGINE_PROTOCOL_SCHEMAS,
@@ -377,12 +395,17 @@ var runSessionParamsSchema = {
   REVERSE_CHANNELS,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
   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,
   errorResponseFrameSchema,
   isEngineErrorPassthroughCode,

package/dist/protocol/index.d.cts

@@ -1,6 +1,7 @@
-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 { 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';
 import { UiRequest, UiResponse } from '../ui-types.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 { 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';
 
 /** 协议版本（引擎包 manifest `taiji.subagentEngine.protocol` 与 initialize 应答同值）。 */
 declare const ENGINE_PROTOCOL_VERSION = 1;
@@ -20,9 +21,20 @@ declare const REVERSE_REQUEST_TIMEOUT_MS = 10000;
 declare const HANDSHAKE_TIMEOUT_MS = 10000;
 /** cancel 后引擎收敛终态的窗口（ms）；超时 core 走杀链。 */
 declare const CANCEL_SETTLE_GRACE_MS = 3000;
-/** engine_crashed 后重建上限与指数退避序列（ms）：1s / 2s / 4s，超限标记不可用至宿主重启。 */
-declare const CRASH_REBUILD_MAX_ATTEMPTS = 3;
-declare const CRASH_REBUILD_BACKOFF_MS: readonly [1000, 2000, 4000];
+/**
+ * setModel 引擎侧单阶段控制窗（ms）：pi 实现等子进程 `set_model` 应答、等
+ * `get_state` 回读各占一窗（设计 subagent-model-switch §7.3——命令与回读全程带
+ * 存活检查，超时上限复用现役取消收敛窗量级：控制面单请求 = 秒级）。窗满且进程
+ * 仍存活 → `engine_state_readback_failed`；窗满时进程已退出 → 无活进程形态
+ * （`SET_MODEL_NOT_ACTIVE_CODE`）——两种处置不可混淆。
+ */
+declare const SET_MODEL_STAGE_TIMEOUT_MS = 3000;
+/**
+ * setModel 正向方法的宿主侧单请求上界（ms）：≥ 引擎侧两阶段最坏时延
+ * （2 × SET_MODEL_STAGE_TIMEOUT_MS）+ 协议余量；量级锚 = 数据面单请求
+ * REVERSE_REQUEST_TIMEOUT_MS 的 10s 先例（控制面单请求必须秒级有界——宿主不悬挂）。
+ */
+declare const SET_MODEL_REQUEST_TIMEOUT_MS = 10000;
 /** stderr 内存环形缓冲保留的尾部字符数（engine_crashed 帧携带崩溃现场）。 */
 declare const STDERR_TAIL_CHARS = 400;
 /**
@@ -141,7 +153,7 @@ declare const requestFrameSchema: {
         };
         readonly method: {
             readonly type: "string";
-            readonly enum: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping"];
+            readonly enum: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping", "setModel"];
         };
         readonly params: {};
     };
@@ -263,7 +275,7 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
             };
             readonly method: {
                 readonly type: "string";
-                readonly enum: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping"];
+                readonly enum: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping", "setModel"];
             };
             readonly params: {};
         };
@@ -434,4 +446,4 @@ declare const runSessionParamsSchema: {
     };
 };
 
-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, type HostAskUserParams, type HostAskUserResult, type HostChildSpawnedParams, type HostChildStateChangedParams, type HostHandleReadyParams, type HostLogParams, type HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReverseChannel, type ReverseRequestTimeoutClass, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema };
+export { CANCEL_SETTLE_GRACE_MS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, type HostAskUserParams, type HostAskUserResult, type HostChildSpawnedParams, type HostChildStateChangedParams, type HostHandleReadyParams, type HostLogParams, type HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReverseChannel, type 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 };

package/dist/protocol/index.d.ts

@@ -1,6 +1,7 @@
-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 { 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';
 import { UiRequest, UiResponse } from '../ui-types.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 { 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';
 
 /** 协议版本（引擎包 manifest `taiji.subagentEngine.protocol` 与 initialize 应答同值）。 */
 declare const ENGINE_PROTOCOL_VERSION = 1;
@@ -20,9 +21,20 @@ declare const REVERSE_REQUEST_TIMEOUT_MS = 10000;
 declare const HANDSHAKE_TIMEOUT_MS = 10000;
 /** cancel 后引擎收敛终态的窗口（ms）；超时 core 走杀链。 */
 declare const CANCEL_SETTLE_GRACE_MS = 3000;
-/** engine_crashed 后重建上限与指数退避序列（ms）：1s / 2s / 4s，超限标记不可用至宿主重启。 */
-declare const CRASH_REBUILD_MAX_ATTEMPTS = 3;
-declare const CRASH_REBUILD_BACKOFF_MS: readonly [1000, 2000, 4000];
+/**
+ * setModel 引擎侧单阶段控制窗（ms）：pi 实现等子进程 `set_model` 应答、等
+ * `get_state` 回读各占一窗（设计 subagent-model-switch §7.3——命令与回读全程带
+ * 存活检查，超时上限复用现役取消收敛窗量级：控制面单请求 = 秒级）。窗满且进程
+ * 仍存活 → `engine_state_readback_failed`；窗满时进程已退出 → 无活进程形态
+ * （`SET_MODEL_NOT_ACTIVE_CODE`）——两种处置不可混淆。
+ */
+declare const SET_MODEL_STAGE_TIMEOUT_MS = 3000;
+/**
+ * setModel 正向方法的宿主侧单请求上界（ms）：≥ 引擎侧两阶段最坏时延
+ * （2 × SET_MODEL_STAGE_TIMEOUT_MS）+ 协议余量；量级锚 = 数据面单请求
+ * REVERSE_REQUEST_TIMEOUT_MS 的 10s 先例（控制面单请求必须秒级有界——宿主不悬挂）。
+ */
+declare const SET_MODEL_REQUEST_TIMEOUT_MS = 10000;
 /** stderr 内存环形缓冲保留的尾部字符数（engine_crashed 帧携带崩溃现场）。 */
 declare const STDERR_TAIL_CHARS = 400;
 /**
@@ -141,7 +153,7 @@ declare const requestFrameSchema: {
         };
         readonly method: {
             readonly type: "string";
-            readonly enum: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping"];
+            readonly enum: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping", "setModel"];
         };
         readonly params: {};
     };
@@ -263,7 +275,7 @@ declare const ENGINE_PROTOCOL_SCHEMAS: {
             };
             readonly method: {
                 readonly type: "string";
-                readonly enum: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping"];
+                readonly enum: readonly ["initialize", "probe", "run", "cancel", "read", "listModels", "validateModel", "dispose", "ping", "setModel"];
             };
             readonly params: {};
         };
@@ -434,4 +446,4 @@ declare const runSessionParamsSchema: {
     };
 };
 
-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, type HostAskUserParams, type HostAskUserResult, type HostChildSpawnedParams, type HostChildStateChangedParams, type HostHandleReadyParams, type HostLogParams, type HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReverseChannel, type ReverseRequestTimeoutClass, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, errorResponseFrameSchema, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, runSessionParamsSchema, successResponseFrameSchema };
+export { CANCEL_SETTLE_GRACE_MS, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, type HostAskUserParams, type HostAskUserResult, type HostChildSpawnedParams, type HostChildStateChangedParams, type HostHandleReadyParams, type HostLogParams, type HostStreamDeltaParams, REVERSE_CHANNELS, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, type ReverseChannel, type 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 };

package/dist/protocol/index.js

@@ -12,7 +12,7 @@ import {
   reverseRequestFrameSchema,
   runSessionParamsSchema,
   successResponseFrameSchema
-} from "../chunk-DIIYVO4O.js";
+} from "../chunk-LM7P7OTA.js";
 import {
   isNotificationFrame,
   isRequestFrame,
@@ -21,8 +21,6 @@ import {
 } from "../chunk-D36ZIQQK.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,
@@ -30,24 +28,27 @@ 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 "../chunk-JSBRDJBE.js";
 export {
   AGENT_EVENT_TYPE_NAMES,
   CANCEL_SETTLE_GRACE_MS,
-  CRASH_REBUILD_BACKOFF_MS,
-  CRASH_REBUILD_MAX_ATTEMPTS,
   ENGINE_ERROR_CODE_PREFIX,
   ENGINE_PROTOCOL_ERROR_CODES,
   ENGINE_PROTOCOL_SCHEMAS,
@@ -60,12 +61,17 @@ export {
   REVERSE_CHANNELS,
   REVERSE_CHANNEL_TIMEOUT_CLASS,
   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,
   errorResponseFrameSchema,
   isEngineErrorPassthroughCode,

package/dist/server/index.cjs

@@ -51,6 +51,32 @@ function toErrorMessage(e) {
 var ENGINE_PROTOCOL_VERSION = 1;
 
 // 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 EngineSdkError = class extends Error {
   code;
   recovery;