@sema-agent/client-core 0.77.1 → 0.77.2

package/dist/engineNoticeCodes.js

@@ -1,65 +1,3 @@
-/**
- * src/engineNoticeCodes.ts — `engine_notice` 的**码册**与 **audience 表**(0.63.0;L-167;core 7.9.x)。
- *
- * -- 「渲不渲」的判据不在这一端 --------------------------------------------------------------
- * 一条引擎通告该不该占用户的注意力,正确判据**不是**「这一端的渲染表有没有那一格」(那会随各端的
- * 施工进度晃),而是**上游有没有把这个码铸进它的成文码册**:
- *   · 码册**内**的码 = 引擎作为治理事实铸出来的,即使这一端还没有专属文案也该让人看见(通用行);
- *   · 码册**外**的码 = 转发进同一个水槽的宿主/适配器噪声,呈现面 fail-closed(只落 debug)。
- * audience 回答另一问:这条事实**说给谁听**。一条 operator 行推给终端用户是噪音;一条 user 行只落
- * operator 日志,就是把该告诉他的事瞒下了。两值而已(`user` / `operator`)—— 上游刻意不设第三值:
- * 「这条通告能不能路由到某个会话」不是 audience,而是 `sessionId` 在不在场(**逐次发射**的事实)。
- *
- * -- 为什么是镜像而不是 import ---------------------------------------------------------------
- * `@sema-agent/core` 不是本包消费者的依赖(它既不是 peer 也不是 runtime dep),而本包的 `.d.ts`
- * 一旦引用它,装了本包却没装 core 的下游会当场编译不过。这与本包 `toolResult.ts` / `retryStatus.ts` /
- * `skillsWireCaps.ts` 三处的处置同形:**按 wire 事实镜像,把代价交给门**——
- * `run-engine-notice-catalog-test.mjs` 对**实装 devDep core** 的两份产物逐码逐行双向对账,
- * core 一动这里就先红。上游自己也是这么设计的:它导出码册的理由逐字写着「a downstream table with a
- * row missing … is a mechanically detectable disagreement rather than an argument」。
- *
- * -- 提货记账(码册加员 / audience 换档)-------------------------------------------------------
- * · **core 7.10.0 +2**:`delegation.ask_unresolvable`(audience **user** —— 委派链上那只 ask 判不出
- *   归属、没有人可问,这件事的收件人是发起这次委派的**用户**)/ `config.read_face_swapped`
- *   (audience **operator** —— READ 容纳面被换过档,是部署事实)。四十八码 ⇒ **五十码**。
- * · **core 7.17.0 +1**(0.68.0 提货批,同样由本门 A1 段当天红抓出:「上游 52 / 本包 51」):
- *   `config.artifact_host_invalid`(audience **operator** —— 宿主接了 artifact 席但它的
- *   `capabilities()` 声明不过席上的不变量、或 `onMount` 抛了 ⇒ 那只工具没挂上。上游逐字:
- *   「an absent seat is silent; a broken one must not look the same」)。五十一码 ⇒ **五十二码**。
- * · **core ≤7.16.0 +1**(0.67.0 提货批,由本门的 A1 段当天红抓出 —— 不是人眼发现的):
- *   `task.interrupt_unconsumed`(audience **user**;位置在 `task.late_approval` 与
- *   `memory.capture_opted_out` 之间,`governance-codes.js:146` / `NOTICE_AUDIENCE_TABLE:165` 真字节)。
- *   ⚠️ 它**不在** core 7.14.0 / 7.15.0 / 7.16.0 任何一份 `docs/wire-consumption` 逐键表里 ——
- *   如实登记为**合同外加员**,处置随本门的双向对账走。五十码 ⇒ **五十一码**。
- * · **core 7.14.0 audience 换档(value-domain BREAKING)**:`memory.consolidation_withheld`
- *   **user → operator**(`NOTICE_AUDIENCE_TABLE:169` 真字节)。合同逐字的理由:这条通告**没有
- *   `sessionId`**(一次固化跑在任何会话之外)⇒ 一个按会话路由 `user` 行的消费方**必须停止**在那里
- *   等它;面向读者的那一半骑在回执上(`withheldFromCleanArm` / `withheldNeverSent`)。
- *   🔴 三端落点:凡按 audience 分发的面(TUI 通告行 / web 通知中心 / 桌面 toast),这条码从此**只**
- *   进运维面 —— 端不改代码也会跟着走(分发读的就是本表),但**通告文案面**若为它写过「告诉用户」
- *   的专属行,那一行要跟着挪。
- * · **7.16.0 的两个 memory 布局码不进本册**:`memory.layout_migrated` /
- *   `memory.layout_unowned_root_content` 在 core 里属 `NON_GOVERNANCE_MEMORY_CODES`
- *   (`governance-codes.js:11-27` 真字节),**不在** `ENGINE_NOTICE_CODES` / `NOTICE_AUDIENCE` 上。
- *   本包对非治理码的既有路由**不变**:码册外 ⇒ 呈现面 fail-closed(只落 debug)。把它们抄进本册
- *   会让 A1/A2 双向对账当天红 —— 那正是这张表是**抄件**而不是意见的意思。
- *
- * -- 🔴 单铸律:本模块**不抄**任何一句 core 的措辞 -------------------------------------------
- * `mcp.injection_dropped` 上游立了 `settlement.single_mint` 契约:**宿主只供事实**(哪个会话 /
- * 哪个 server 名 / 四个原因里的哪一个 / 可选哪个字段坏),**core composes** 码字、audience 行与
- * 句子。第二份措辞就是第二个会漂的源。⇒ 本模块只给码册、audience 与**事实窄读器**
- * ({@link readMcpInjectionDrop});转录直接用引擎给的 `message`。门里有一条反向钉:core 那四句
- * 出现在本包源码或产物里 => 当场红。
- */
-/**
- * 引擎**成文码册**的逐字镜像(core `ENGINE_NOTICE_CODES`,**7.23.0 = 六十七码**(7.22.0 六十六 + 7.23.0 一枚 `config.write_protection_unresolved`(#869 / C-R61 ②,operator;governance-codes.js 元组紧跟兄弟码 `config.write_protection_target_view_absent`:那一枚是「没有 target 视图」,这一枚是「有视图但解析不出这次写的目标」,`detail {reason, cause, sessionId, runId}`,`reason` 两词 `unresolved-symlink` / `unresolvable-target`,去重每 leg 每 reason 是引擎侧);7.22.0 六十六 = 7.20.1 六十五 + 7.22.0 一枚 `mcp.server_redialed`(#857,operator;governance-codes.js 元组紧跟 `mcp.revocation_probe_failed`);7.20.0 六十四 + 7.20.1 一枚 `config.write_protection_target_view_absent`;7.19.0 五十九 + 7.20.0 五枚:`config.task_root_not_canonical` / `config.execution_env_capability_invalid` / `config.forward_sink_failed` / `memory.restore_withheld` / `agents.listing_truncated`,均 operator);顺序同源)。
- * 🔴 这是一份**抄件**,不是本包的意见 —— 改它必须同 commit 附 core 坐标,且门会先红。
- * ⚠️ `EngineNotice.code` 的型面在上游**故意留 `string`**(宿主把自己的通告转发进同一个水槽是
- *    被支持的形),所以本表是**判据**不是型 —— 别拿它去窄化那个字段。
-
- * 🔴 形制:`Object.freeze` 的数组,**不是**只在类型面只读的 `readonly T[]` —— 后者一行 `.splice()`
- *    就能改,而公面消费者拿到的正是这个实例(本仓已定谳的病形,同 `RESUME_RETRY_LATER_CODES`)。
- */
 export const ENGINE_NOTICE_CODES = Object.freeze([
     'config.autocompact_window_clamped',
     'config.env_timeout_discarded',
@@ -67,25 +5,19 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'config.models_swapped',
     'config.read_face_swapped',
     'config.read_face_deployment_clamped',
-    // core 7.18.0 #748(0.68.3 提货批 CC-05):writeFace 席的两枚运维通告;位置 = governance-codes.d.ts 元组 @6/@7 真字节。
     'config.write_face_swapped',
     'config.write_face_deployment_clamped',
     'config.tool_model_gate_removed',
     'config.tool_model_gate_unknown_class',
     'config.tool_model_gate_env_invalid',
-    // 0.68.0 提货批(core 7.17.0 加员;位置 = `governance-codes.js:108` 真字节,在
-    // `config.tool_model_gate_env_invalid` 与 `config.tool_card_undeclared` 之间)。
     'config.artifact_host_invalid',
-    // core 7.20.0(0.71.0 提货):任务根非规范路径 / 远端执行环境能力声明坏值,两枚部署面通告;顺序同源(紧跟 artifact_host_invalid)。
     'config.task_root_not_canonical',
-    // core 7.20.1(0.71.4 提货,#853 C-R55):写保护判官只判拼写(spelling-only)又挂了受保护写工具 ⇒ 每 run 一条;顺序同源(紧跟 task_root_not_canonical)。
     'config.write_protection_target_view_absent',
     'config.write_protection_unresolved',
     'config.execution_env_capability_invalid',
     'config.tool_card_undeclared',
     'config.tool_face_undeclared',
     'config.tool_face_invalid',
-    // core 7.20.0:转发 sink 失败;顺序同源(紧跟 tool_face_invalid)。
     'config.forward_sink_failed',
     'config.durable_gate_unavailable',
     'config.peer_admission_out_of_range',
@@ -94,9 +26,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'peer.held_settled',
     'peer.idle_subscription',
     'classifier.denial_limit',
-    // core 7.18.0 #742(CC-05):分类器席坏配置 ⇒ 主模型代判的一条运维通告;元组 @22。
     'classifier.fallback',
-    // core 7.19.0(CC-04 core 半场):分类器席角色缺省 / 契约破裂两枚运维通告;顺序同源(紧跟 fallback)。
     'classifier.role_defaulted',
     'classifier.contract_broken',
     'checkpoint.execution_outcome_unrecorded',
@@ -104,7 +34,6 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'delegation.ask_unresolvable',
     'mcp.injection_dropped',
     'mcp.revocation_probe_failed',
-    // core 7.22.0 #857(0.72.7 提货批 CC-42):宿主请这条 run 重拨一台 MCP server 的结果;一个码管两个方向。
     'mcp.server_redialed',
     'workflow.governance_key_stripped',
     'workflow.agent_option_ignored',
@@ -121,10 +50,8 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'memory.consolidation_incomplete',
     'memory.consolidation_refused',
     'memory.consolidation_withheld',
-    // core 7.20.0:恢复被扣留;顺序同源(紧跟 consolidation_withheld)。
     'memory.restore_withheld',
     'route.fallback_to_primary',
-    // core 7.18.0 #742(CC-05):分类器候选梯子无可路由席;元组 @44。
     'route.classifier_unroutable',
     'route.base_url_changed_key_unchanged',
     'task.user_steer_undrained',
@@ -133,30 +60,17 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'task.turn_interrupted',
     'task.halt_unconsumed',
     'task.late_approval',
-    // 0.67.0 提货批:core ≤7.16.0 加员(合同外,见模块顶注提货记账段)。
     'task.interrupt_unconsumed',
     'memory.capture_opted_out',
     'memory.capture_optout_unpersisted',
-    // core 7.19.0(CC-04 core 半场):`<skills>` 披露块超字节预算 ⇒ 至少一条只列名(`detail.nameOnly[]`)或整条不列
-    //   (`detail.dropped[]`);Skill 工具仍服务全部技能。运维面事(调 skillListingBudgetFraction / skillListingMaxDescChars / 少声明)。
     'skills.listing_truncated',
-    // core 7.20.0:agent roster 清单超预算(与 skills 同族;同一个 fraction 预算);顺序同源(紧跟 skills.listing_truncated)。
     'agents.listing_truncated',
     'tool_result.offload_put_failed',
 ]);
 const CATALOG = new Set(ENGINE_NOTICE_CODES);
-/**
- * 这个码在不在上游码册里。
- * 🔴 **认原始值**:呈现层的消毒器会把一整类字符换成别的字符,拿清洗值来查表等于让
- *    `memory\nsession_polluted` 这种脏码冒充册内码。消毒只进文案,不进判据。
- */
 export function engineNoticeInCatalog(code) {
     return typeof code === 'string' && CATALOG.has(code);
 }
-/**
- * 逐码的 audience 行(core `NOTICE_AUDIENCE_TABLE` 逐行镜像;与 {@link ENGINE_NOTICE_CODES}
- * **逐键 lockstep** —— 上游用编译期 `satisfies` 钉住这一点,本包用门钉住)。
- */
 export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'config.autocompact_window_clamped': 'operator',
     'config.env_timeout_discarded': 'operator',
@@ -169,7 +83,6 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'config.tool_model_gate_removed': 'operator',
     'config.tool_model_gate_unknown_class': 'operator',
     'config.tool_model_gate_env_invalid': 'operator',
-    // 0.68.0 提货批:`NOTICE_AUDIENCE_TABLE:181` 真字节 —— 一条「宿主把 artifact 席接坏了」的部署事实。
     'config.artifact_host_invalid': 'operator',
     'config.task_root_not_canonical': 'operator',
     'config.write_protection_target_view_absent': 'operator',
@@ -209,8 +122,6 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'memory.consolidation_conflict': 'operator',
     'memory.consolidation_incomplete': 'operator',
     'memory.consolidation_refused': 'operator',
-    // 🔴 core 7.14.0 **value-domain BREAKING**:user → operator(见模块顶注提货记账段;
-    //    理由 = 这条通告没有 sessionId,一次固化跑在任何会话之外)。
     'memory.consolidation_withheld': 'operator',
     'memory.restore_withheld': 'operator',
     'route.fallback_to_primary': 'operator',
@@ -229,27 +140,12 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'agents.listing_truncated': 'operator',
     'tool_result.offload_put_failed': 'operator',
 });
-/**
- * 这个码是说给谁听的。**表外码一律保守判 `operator`** —— 把一个读不懂的码推给终端用户是最坏的
- * 猜法(他既看不懂也无从下手),而漏给运维看一条只是让他晚一点知道。
- */
 export function noticeAudienceOf(code) {
-    // 🔴 **自有属性判据**(异源对抗复审 [medium]):`Object.freeze` 冻的是自有属性,原型链原样还在 ⇒
-    //    一个来自 wire 的 `constructor` / `toString` / `__proto__` 会命中 `Object.prototype` 上的成员,
-    //    本口于是交出一个**函数** —— 它既不是 `user` 也不是 `operator`,按两值分发的宿主两条分支都进不去
-    //    (保守缺省也跟着被绕过)。这是本仓已定谳的病形:wire 键控的表一律按自有属性查。
     const row = typeof code === 'string' && Object.hasOwn(ENGINE_NOTICE_AUDIENCE, code)
         ? ENGINE_NOTICE_AUDIENCE[code]
         : undefined;
     return row ?? 'operator';
 }
-/**
- * `mcp.injection_dropped` 的四个掉落原因(core `MCP_INJECTION_DROP_REASONS` 逐词镜像)。
- * 消费端要自己的措辞时**键在这个词上**,绝不对 `message` 做等值匹配(那是给人读的散文)。
-
- * 🔴 形制:`Object.freeze` 的数组,**不是**只在类型面只读的 `readonly T[]` —— 后者一行 `.splice()`
- *    就能改,而公面消费者拿到的正是这个实例(本仓已定谳的病形,同 `RESUME_RETRY_LATER_CODES`)。
- */
 export const MCP_INJECTION_DROP_REASONS = Object.freeze([
     'malformed_entry',
     'name_reserved_by_deployment',
@@ -257,17 +153,6 @@ export const MCP_INJECTION_DROP_REASONS = Object.freeze([
     'over_cap',
 ]);
 const DROP_REASONS = new Set(MCP_INJECTION_DROP_REASONS);
-/**
- * `mcp.injection_dropped` 通告 → 事实;不成形 => `undefined`,绝不抛出。
- *
- * 🔴 **只认自己那一个码**:一条别的通告即使 `detail` 长得像,也不给读(读器按码分家,才不会在
- *    上游给另一个码加同名键的那天悄悄改判)。
- * 🔴 `sessionId` / `server` / `reason` 三格缺一 => 整只缺席。core 在**铸点**对同样三格直接抛
- *    `TypeError`(「一条没有会话的 user 通告投不到任何地方」);本包在**读点**判缺席而不抛 ——
- *    读点抛只会把一条读不懂的通告升级成一次崩。
- * 🔴 `reason` **按闭集读**:它是消费端分支的键,读不懂的词不许被当成一个能拿去分支的原因。
- *    (要渲一句话时,用引擎给的 `message`,见模块顶注的单铸律。)
- */
 export function readMcpInjectionDrop(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
@@ -286,46 +171,12 @@ export function readMcpInjectionDrop(notice) {
     const field = typeof o.field === 'string' && o.field.length > 0 ? o.field : undefined;
     return { sessionId, server, reason, ...(field !== undefined ? { field } : {}) };
 }
-// ══════════════════════════════════════════════════════════════════════════════════════════════
-// 0.68.0 提货批(core 7.17.0 #709 ①②)—— 两条通告的**事实窄读器**
-// ══════════════════════════════════════════════════════════════════════════════════════════════
-// 与 {@link readMcpInjectionDrop} 同一套规矩(单铸律不变:本模块只给码册、闭集与**事实**,
-// 一句措辞都不抄 —— 转录用引擎给的 `message`):
-//   · **只认自己那一个码**(读器按码分家);
-//   · 必填格缺一 ⇒ **整只缺席**(读点判缺席而不抛:读点抛只会把一条读不懂的通告升级成一次崩);
-//   · **分支用的键按闭集读**(读不懂的词不许被当成一个能拿去分支的原因);**非分支键开集透传**。
-/**
- * `delegation.ask_unresolvable` 的三个成因(core `ASK_UNRESOLVABLE_CAUSES` 逐词镜像,
- * `dist/core/ask-unresolvable-notice.d.ts:31`)。
- *
- * 🔴 **0.68.0 BREAKING(core #709 ②)**:这一位**取代**了 7.16.0 及以前那条通告 `detail` 上的
- *    `settlementKind`(core `gate-exit.ts` 的一处铸点;`settlementKind` 在 7.17.x 的 core 与 sdk
- *    真字节上**零命中**,本包按 clean-cut 不留双读,登记在 `run-retired-vocabulary-census-test.mjs`)。
- *    两者不是改名:`settlementKind` 只说得出「结算是怎么落的」,而 in-fold 拒绝那一臂**根本没有
- *    结算**骑在帧上(`mandate_unreconstructible`)—— 旧位在那一形上恒缺席。
- *
- * 三词各答「为什么这只 ask 判不出来」(上游逐字):
- *  · `approver_unavailable` —— 被问到的审批席(本 run 自己的,或委派子代身上那张冻结的祖先席)
- *    对路由问题答了 `unavailable`,而其后**没有**耐久 park 接下这次调用;
- *  · `no_approver_wired` —— 这条 run 根本没接审批席(或问答面),或者席位就是拒绝姿态串
- *    (headless 自动拒);
- *  · `mandate_unreconstructible` —— 继承来的耐久审批 mandate 绑住了这只 ask,而**这条腿没有 park
- *    设施**去兑现它,于是委派子代就地拒绝(in-fold 拒,帧上不带 settlement)。
- *
- * 🔴 形制:`Object.freeze` 的数组(同 `MCP_INJECTION_DROP_REASONS` 的已定谳病形)。
- */
 export const ASK_UNRESOLVABLE_CAUSES = Object.freeze([
     'approver_unavailable',
     'no_approver_wired',
     'mandate_unreconstructible',
 ]);
 const ASK_UNRESOLVABLE_CAUSE_SET = new Set(ASK_UNRESOLVABLE_CAUSES);
-/**
- * `delegation.ask_unresolvable` 通告 → 事实;不成形 ⇒ `undefined`,绝不抛出。
- *
- * 🔴 `cause` **按闭集读**:它是消费端分支的键(三条恢复路不同 —— 接一个耐久店 / 接一个审批席 /
- *    别在无 park 设施的腿上继承 mandate)。读不懂的词 ⇒ **整只缺席**,而不是交一个分不了支的串。
- */
 export function readAskUnresolvable(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
@@ -351,27 +202,11 @@ export function readAskUnresolvable(notice) {
         ...(typeof o.parkLaneExisted === 'boolean' ? { parkLaneExisted: o.parkLaneExisted } : {}),
     };
 }
-/**
- * 一条腿上的耐久审批 **mandate 从哪儿来**(core `DURABLE_MANDATE_SOURCES` 逐词镜像,
- * `dist/core/tool-policy.d.ts:1403`)。两词的**恢复动作不同**,这正是上游把它铸上通告的理由:
- *  · `force_durable_gate` —— per-principal 的控制面权利,与席位无关 ⇒ 要么给这套部署接一个
- *    checkpoint 店,要么撤掉这批 principal 的这项权利;
- *  · `durable_approval` —— 任务自己的 opt-in 且**没有**活审批席 ⇒ 给任务一个活席位,或者不要
- *    再传 `durableApproval`。
- *
- * 🔴 形制同上(冻结数组)。
- */
 export const DURABLE_MANDATE_SOURCES = Object.freeze([
     'force_durable_gate',
     'durable_approval',
 ]);
 const DURABLE_MANDATE_SOURCE_SET = new Set(DURABLE_MANDATE_SOURCES);
-/**
- * `config.durable_gate_unavailable` 通告 → 事实;不成形 ⇒ `undefined`,绝不抛出。
- *
- * 🔴 **两个布尔位缺席不折 `false`**:core 在铸点把它们写成必填,但「这一格读不出」与
- *    「这一格是 false」对用户的下一步不同(前者是「引擎没说」,后者是「没有人会答你这条 ask」)。
- */
 export function readDurableGateUnavailable(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
@@ -402,13 +237,6 @@ export function readDurableGateUnavailable(notice) {
 }
 const nonNegInt = (v) => typeof v === 'number' && Number.isInteger(v) && v >= 0 ? v : undefined;
 const nameList = (v) => Array.isArray(v) && v.every((x) => typeof x === 'string' && x.length > 0) ? Object.freeze([...v]) : undefined;
-/**
- * `skills.listing_truncated` 通告 → 事实;不成形 ⇒ `undefined`,绝不抛出。
- *
- * 🔴 必填 = `budgetBytes` / `total` / `kept` / `nameOnly` / `dropped`(引擎铸点恒带的五格);任一读不出 ⇒ 整只缺席。
- * 🔴 `nameOnly` / `dropped` 里混进非串 ⇒ 整只缺席(名单是渲染键,半张坏名单比没有更坏)。
- * 🔴 `kept` 照带不重算:引擎已在铸点算过;本包再算一遍 = 第二份公式,上游改口那天两边各走各的。
- */
 export function readSkillsListingTruncated(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))
         return undefined;
@@ -427,7 +255,6 @@ export function readSkillsListingTruncated(notice) {
     if (budgetBytes === undefined || total === undefined || kept === undefined || nameOnly === undefined || dropped === undefined) {
         return undefined;
     }
-    // 0.71.0:`requestedBudgetBytes` 若在场(老引擎 7.19.0)**不铸不派生**——它在 7.20.0 已删,本视图不再有它的位。
     const descMaxChars = nonNegInt(o.descMaxChars);
     const sessionId = typeof o.sessionId === 'string' && o.sessionId.length > 0 ? o.sessionId : undefined;
     return {
@@ -440,15 +267,6 @@ export function readSkillsListingTruncated(notice) {
         ...(sessionId !== undefined ? { sessionId } : {}),
     };
 }
-// ══════════════════════════════════════════════════════════════════════════════════════════════
-// 0.72.7 提货批(core 7.22.0 #857)—— `mcp.server_redialed` 的**事实窄读器**
-// ══════════════════════════════════════════════════════════════════════════════════════════════
-// 宿主请这条 run **重拨**一台 MCP server(run 句柄动词 `reconnectMcpServer`;server 侧的会话腿动词候 S-381),
-// 结果一条 operator 通告。**一个码管两个方向**:`outcome` 是数据不是两种事件;去重单位 = **每次尝试**,永不按 run
-// 折叠(折掉第二条会藏起「它还是没起来」那条)。`added` / `removed` 是**计数**,不是 server 自报的工具名(工具名是
-// server 自著文本,operator 行不是披露通道)。规矩同 {@link readMcpInjectionDrop}:只认自己那一个码;必填格缺一 ⇒
-// 整只缺席;分支键 `outcome` 按闭集读;`reason` 开集透传(非 reconnected 时才有,且**永不是唯一机读事实**)。
-/** `McpReconnectResult.outcome` 三词(core `src/core/mcp.ts` 逐字);无处置表 —— 成员资格就是全部意义。 */
 export const MCP_REDIAL_OUTCOMES = Object.freeze(['reconnected', 'refused', 'not_declared']);
 export function readMcpServerRedialed(notice) {
     if (typeof notice !== 'object' || notice === null || Array.isArray(notice))

package/dist/engineSessionParam.d.ts

@@ -1,37 +1,7 @@
-/**
- * W1 带 key 变体(design/285 批 0,P-31 正位解的取值层)——**某一个会话槽**的 session 参数值。
- *
- * 为什么必须有它:多会话宿主每个会话一个 `sessionKey` 槽(`installHostFor(key, {session})`),
- * 而零参形只认 `DEFAULT_SESSION_KEY`。fleet 台账的会话锚要跟着 ledger 的 `sessionKey` 走,
- * 取值这一跳就不能再写死默认槽(在册局限 **P-31** 的第一处断点)。
- *
- * 🔴 [1501] 空串归一**只此一处**(恒不返回空串:要么真值要么 undefined)—— 消费点绝不重铸这条规则。
- * 🔴 缺席语义与零参形逐字同:该键未装 `SessionPort`(或端自己也还没有值)⇒ `undefined` + 计该键 miss
- *    (`hostPortMissesFor(key)` 可点名),不是「少个查询参数」而是该键的 durable 读面整条 404。
- */
 export declare function engineSessionParamFor(sessionKey: string): string | undefined;
-/**
- * 当前会话的 session 参数值;undefined = 端未装 SessionPort,或端自己也还没有值。
- * 零参形 = `engineSessionParamFor(DEFAULT_SESSION_KEY)` 的兼容层(单一取值链,不抄第二份)。
- */
 export declare function engineSessionParam(): string | undefined;
-/** spread 便捷形:`{ ...engineSessionParamSpread() }` → `{ session: '<sid>' }` 或 `{}`。 */
 export declare function engineSessionParamSpread(): {
     session?: string;
 };
-/**
- * W1 带 key 变体(design/285 批 3):**某一个会话槽**此刻在飞的 run。
- *
- * 为什么必须有它(异源对抗复审 [high]):`/compact` 这类「打这条会话此刻在飞的那条 run」的动词
- * 在批 3 之后按槽取 wire target 与 `?session=`,而 run id 若还从默认槽读,就成了
- * 「**A 的 run id 发到 B 的服务器**」—— 比换锚之前更坏(之前三件一致地错在同一个槽上)。
- * 一条动词的**槽键必须一以贯之**:目标、会话、run id、能力位、pending 状态,全按同一个 key。
- */
 export declare function activeEngineRunIdFor(sessionKey: string): string | undefined;
-/**
- * 当前活跃引擎 run 的 id(壳 = `engineToolDetach.getActiveEngineTaskId()`)。
- * 库内多处 durable 动词要「宿主 run」做寻址第一跳,统一从这里取,不各自 import 端模块。
- * 零参形 = `activeEngineRunIdFor(DEFAULT_SESSION_KEY)` 的兼容层(`hostSession()` 本身就是
- * `hostSessionFor(DEFAULT_SESSION_KEY)`,取值链逐字等价,含 miss 计数那一跳)。
- */
 export declare function activeEngineRunId(): string | undefined;

package/dist/engineSessionParam.js

@@ -1,72 +1,20 @@
-/**
- * ⇄ B6 批搬迁(2026-07-27,多端改造设计稿 §3 B6 + B4「四残件」之 session-id port):
- *    cli `src/sema/engineSessionParam.ts` 搬入,唯一改动 = **取值源换 port**。
- *
- * engineSessionParam — durable run 面 `?session=` 参数的统一派生([1501]§三,server 1.246 起
- * legacy 八面软拍纪律:带了且不匹配=404,没带=warn-once 放行,二拍将把「没带」也 404;新面
- * A/B(taskOutput/taskStop)与 subagentOutput 则出生即强制)。
- *
- * 取值语义 = run 绑定的会话(本端所有 durable 动词的目标 run 都是本会话自有 run)。
- *
- * 🔴 **搬迁的唯一差分**:壳里这里是「`getLiveSessionId()`(引擎捕获值)优先,退
- * `bootstrap/state.getSessionId()`(壳 boot-time id),后者靠动态 import 落地」——**两级优先与
- * 那个动态 import 都是宿主生命周期资产**,整体上移到 `SessionPort.currentSessionId()`
- * (壳侧 shim 里原样保留那两级 + 动态 import,行为一字节不变)。库这边只剩「取一个值 + 空串归一」。
- *
- * 🔴 [1501] 空串陷阱:`?session=`(空值)按「带了且不匹配」处理=404 —— 本 helper 恒不返回
- * 空串:要么真值要么 undefined(调用方 spread 姿势 `...(s ? { session: s } : {})`)。
- *
- * 🔴 端漏装 SessionPort 的后果**不是**「少个查询参数」:session-bound run 的 taskOutput /
- * taskStop / subagentOutput 三面一律 404 fail-closed ⇒ 子代读面整条静默哑掉。所以
- * `hostSession()` 计 miss,宿主自检 `hostPortMisses()` 恒应为空。
- */
 import { hostSessionFor } from './host.js';
 import { DEFAULT_SESSION_KEY } from './sessionSlot.js';
-/**
- * W1 带 key 变体(design/285 批 0,P-31 正位解的取值层)——**某一个会话槽**的 session 参数值。
- *
- * 为什么必须有它:多会话宿主每个会话一个 `sessionKey` 槽(`installHostFor(key, {session})`),
- * 而零参形只认 `DEFAULT_SESSION_KEY`。fleet 台账的会话锚要跟着 ledger 的 `sessionKey` 走,
- * 取值这一跳就不能再写死默认槽(在册局限 **P-31** 的第一处断点)。
- *
- * 🔴 [1501] 空串归一**只此一处**(恒不返回空串:要么真值要么 undefined)—— 消费点绝不重铸这条规则。
- * 🔴 缺席语义与零参形逐字同:该键未装 `SessionPort`(或端自己也还没有值)⇒ `undefined` + 计该键 miss
- *    (`hostPortMissesFor(key)` 可点名),不是「少个查询参数」而是该键的 durable 读面整条 404。
- */
 export function engineSessionParamFor(sessionKey) {
     const sid = hostSessionFor(sessionKey)?.currentSessionId();
     return typeof sid === 'string' && sid.length > 0 ? sid : undefined;
 }
-/**
- * 当前会话的 session 参数值;undefined = 端未装 SessionPort,或端自己也还没有值。
- * 零参形 = `engineSessionParamFor(DEFAULT_SESSION_KEY)` 的兼容层(单一取值链,不抄第二份)。
- */
 export function engineSessionParam() {
     return engineSessionParamFor(DEFAULT_SESSION_KEY);
 }
-/** spread 便捷形:`{ ...engineSessionParamSpread() }` → `{ session: '<sid>' }` 或 `{}`。 */
 export function engineSessionParamSpread() {
     const s = engineSessionParam();
     return s ? { session: s } : {};
 }
-/**
- * W1 带 key 变体(design/285 批 3):**某一个会话槽**此刻在飞的 run。
- *
- * 为什么必须有它(异源对抗复审 [high]):`/compact` 这类「打这条会话此刻在飞的那条 run」的动词
- * 在批 3 之后按槽取 wire target 与 `?session=`,而 run id 若还从默认槽读,就成了
- * 「**A 的 run id 发到 B 的服务器**」—— 比换锚之前更坏(之前三件一致地错在同一个槽上)。
- * 一条动词的**槽键必须一以贯之**:目标、会话、run id、能力位、pending 状态,全按同一个 key。
- */
 export function activeEngineRunIdFor(sessionKey) {
     const id = hostSessionFor(sessionKey)?.activeRunId();
     return typeof id === 'string' && id.length > 0 ? id : undefined;
 }
-/**
- * 当前活跃引擎 run 的 id(壳 = `engineToolDetach.getActiveEngineTaskId()`)。
- * 库内多处 durable 动词要「宿主 run」做寻址第一跳,统一从这里取,不各自 import 端模块。
- * 零参形 = `activeEngineRunIdFor(DEFAULT_SESSION_KEY)` 的兼容层(`hostSession()` 本身就是
- * `hostSessionFor(DEFAULT_SESSION_KEY)`,取值链逐字等价,含 miss 计数那一跳)。
- */
 export function activeEngineRunId() {
     return activeEngineRunIdFor(DEFAULT_SESSION_KEY);
 }

package/dist/engineToolLabelStore.d.ts

@@ -1,32 +1,3 @@
-/**
- * ⇄ B1 批搬迁(2026-07-27,多端改造设计稿 §2.4.1-B):cli src/sema/engineToolLabelStore.ts 逐字搬入(零依赖;壳侧改 re-export)。
- */
-/**
- * src/sema/engineToolLabelStore.ts — core 工具**展示名**(`tool_start.label` / `tool_end.label`)的
- * 壳侧侧信道(sema-owned 新文件,零 CC 基座改动)。
- *
- * 为什么是侧信道而不是把 label 留在 tool_use block 上(P0-2 的关键判断):
- *   tool_use content block 会**进壳 transcript**(jsonl 持久 + /compact 时原样直发 provider)。
- *   Anthropic/OpenAI 两侧对 tool_use block 都是严格形 `{type,id,name,input}`,多一个 `label` 键
- *   = 400 invalid_request —— 这正是「件1 中断事故批 G」踩过的坑(裸对象 content 落 transcript,
- *   /compact 直发 ark/volces 400)。所以 bridge 在渲染前把 label 从 block 上摘掉(同
- *   eventId/parentToolCallId 待遇),存到这里,渲染面按 toolCallId 查。
- *
- * 消费面:components/messages/AssistantToolUseMessage.tsx 的 **unknown-tool fallback** ——
- * 也只在那里消费。已注册工具(壳本地 registry 命中)的卡标题恒走 CC 的 `tool.userFacingName()`,
- * 绝不被引擎 label 覆盖(CC 逐字对齐优先;core label 与 CC 的 MCP 卡形 `server - tool (MCP)` 不同形,
- * 覆盖 = 制造分叉)。
- *
- * 今天的真实命中面(2026-07-26 直连钉版 core 1.416 实测):core 只在 `label !== name` 时才上 wire
- * (runtask.js:1406),而唯一这样的一族是 **MCP 远端工具** —— `name = mcp__<server>__<tool>`、
- * `label = <server>:<tool>`(core/mcp.js:902)。即:引擎侧连着、壳侧没连的那台 MCP server 的工具,
- * 修前卡头是裸 `mcp__foo__bar`,修后是 core 的展示名 `foo:bar`。
- *
- * 生命周期:按 toolCallId 键的有界 Map(FIFO 淘汰),纯 chrome 数据,不持久、不回喂模型。
- */
-/** 登记一个 tool call 的 core 展示名(空/非串忽略)。 */
 export declare function recordEngineToolLabel(toolCallId: unknown, label: unknown): void;
-/** 读一个 tool call 的 core 展示名(未登记 ⇒ undefined,调用方回落原有形状)。 */
 export declare function engineToolLabel(toolCallId: unknown): string | undefined;
-/** 测试用:清空台账。 */
 export declare function resetEngineToolLabels(): void;

package/dist/engineToolLabelStore.js

@@ -1,39 +1,10 @@
-/**
- * ⇄ B1 批搬迁(2026-07-27,多端改造设计稿 §2.4.1-B):cli src/sema/engineToolLabelStore.ts 逐字搬入(零依赖;壳侧改 re-export)。
- */
-/**
- * src/sema/engineToolLabelStore.ts — core 工具**展示名**(`tool_start.label` / `tool_end.label`)的
- * 壳侧侧信道(sema-owned 新文件,零 CC 基座改动)。
- *
- * 为什么是侧信道而不是把 label 留在 tool_use block 上(P0-2 的关键判断):
- *   tool_use content block 会**进壳 transcript**(jsonl 持久 + /compact 时原样直发 provider)。
- *   Anthropic/OpenAI 两侧对 tool_use block 都是严格形 `{type,id,name,input}`,多一个 `label` 键
- *   = 400 invalid_request —— 这正是「件1 中断事故批 G」踩过的坑(裸对象 content 落 transcript,
- *   /compact 直发 ark/volces 400)。所以 bridge 在渲染前把 label 从 block 上摘掉(同
- *   eventId/parentToolCallId 待遇),存到这里,渲染面按 toolCallId 查。
- *
- * 消费面:components/messages/AssistantToolUseMessage.tsx 的 **unknown-tool fallback** ——
- * 也只在那里消费。已注册工具(壳本地 registry 命中)的卡标题恒走 CC 的 `tool.userFacingName()`,
- * 绝不被引擎 label 覆盖(CC 逐字对齐优先;core label 与 CC 的 MCP 卡形 `server - tool (MCP)` 不同形,
- * 覆盖 = 制造分叉)。
- *
- * 今天的真实命中面(2026-07-26 直连钉版 core 1.416 实测):core 只在 `label !== name` 时才上 wire
- * (runtask.js:1406),而唯一这样的一族是 **MCP 远端工具** —— `name = mcp__<server>__<tool>`、
- * `label = <server>:<tool>`(core/mcp.js:902)。即:引擎侧连着、壳侧没连的那台 MCP server 的工具,
- * 修前卡头是裸 `mcp__foo__bar`,修后是 core 的展示名 `foo:bar`。
- *
- * 生命周期:按 toolCallId 键的有界 Map(FIFO 淘汰),纯 chrome 数据,不持久、不回喂模型。
- */
-/** 上界:一个长会话里 tool call 无限增长,标签只是渲染辅助,超界按 FIFO 淘汰最旧的。 */
 const MAX_ENTRIES = 500;
 const labels = new Map();
-/** 登记一个 tool call 的 core 展示名(空/非串忽略)。 */
 export function recordEngineToolLabel(toolCallId, label) {
     if (typeof toolCallId !== 'string' || toolCallId.length === 0)
         return;
     if (typeof label !== 'string' || label.trim().length === 0)
         return;
-    // 已有值不覆盖:tool_start 先到,tool_end 只是补位(两者同源同值)。
     if (labels.has(toolCallId))
         return;
     if (labels.size >= MAX_ENTRIES) {
@@ -43,13 +14,11 @@ export function recordEngineToolLabel(toolCallId, label) {
     }
     labels.set(toolCallId, label.trim());
 }
-/** 读一个 tool call 的 core 展示名(未登记 ⇒ undefined,调用方回落原有形状)。 */
 export function engineToolLabel(toolCallId) {
     if (typeof toolCallId !== 'string' || toolCallId.length === 0)
         return undefined;
     return labels.get(toolCallId);
 }
-/** 测试用:清空台账。 */
 export function resetEngineToolLabels() {
     labels.clear();
 }

package/dist/engineWireSdk.d.ts

@@ -1,115 +1,25 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/engineWireSdk.ts 逐字搬入(纯半场 client 工厂;agentsWireCaps 的静态依赖,故同批过来)。
- */
-/**
- * engineWireSdk — SDK 宪法迁移批(0.0.52)的纯半场 client 工厂:壳内各 wire 子模块(compact/steer/
- * plan-review/auto-title/recap/caps 探测)从手抄 raw fetch 改接 @sema-agent/sdk AgentClient 的共用
- * 构造点。ZERO 产品依赖(只 import 外部零依赖 SDK)——agentsWireCaps/liveInitToolFace 等「纯半场/
- * 零产品图」模块可安全 import,不拖 engineTarget 的 fs 图,亦无循环依赖。
- *
- * 凭证解析 = engineTarget.resolveLiveAuthToken 的逐字镜像(#118 三态;那边是产品半场真源,这里为
- * 纯半场复刻,两处语义必须一致):
- *   · token 有            → 原样 Bearer;
- *   · 无 token ∧ loopback → { mode: 'loopback-unauthed' }(出站零 Authorization 头,绝不伪造);
- *   · 无 token ∧ 非 loopback → 'anon'(fail-closed worker 换来诚实 401;与主车道 replEntry 同姿势)。
- * ⚠️ 迁移差分记账:旧 raw fetch 在「无 token ∧ 非 loopback」时不带任何 Authorization 头;SDK 恒需
- * 合法 authToken 形,这里按主车道姿势出 'anon'——该态本就是残破配置(connect 未登录),两种姿势对
- * fail-closed worker 都是 401,对 owner-gated 路由都是 owner 不匹配,行为面等价。
- *
- * 缺省 maxRetries=0:raw fetch 原语义是单发不重试(探针有自己的预算窗;fire-and-forget 不该静默
- * 翻倍打点)。要 SDK 缺省重试的调用方显式传。principal 缺席=不发头(F-011 停发,replEntry live 车道
- * 同款)——SDK Transport 恒 stamp x-agent-principal(principal-first 宪法);旧 raw fetch 在缺
- * principal 时省略该头,迁移后恒出示,对 requirePrincipal 部署是 fail-open 改善,已记账。
- */
 import { AgentClient } from '@sema-agent/sdk';
 export type WireAuthToken = string | {
     mode: 'loopback-unauthed';
 };
-/**
- * 凭证**位**的取值形:一份串,或一个**每次发请求时被调用**的取值函数(0.62.0 放宽)。
- *
- * 🔴 为什么需要函数形:串是在**构造那一刻**被读走的 —— 底层客户端把它捕获进闭包,此后每一发请求
- *    都用那一份。引擎被别的会话换代、凭证换新之后,一个长命的 client 会一直拿**旧凭证**发请求,
- *    而端唯一的出路是把整个 client 连同它身上的状态重建一遍。函数形让「换代」只换一个值。
- * 🔴 取值时机是**每发一次请求读一次**,不是构造期读一次然后复用(那只是把快照挪了个地方)。
- * 🔴 取不到值(返回 `undefined` / 空串 / **抛错**)⇒ 按「这一刻没有凭证」走 {@link resolveWireAuth}
- *    的三态:回环出零 Authorization 头(绝不伪造),非回环出 fail-closed 的匿名身份(换一个诚实的
- *    401)。取值口坏了不该让整条 wire 变成不可用,所以抛错是 fail-soft 而不是把异常送进请求路径。
- * 🔴 凭证纪律:本包对这个值只做一件事 —— 放进出站的 Authorization 头。不落盘、不进日志、不进 URL。
- */
 export type WireAuthTokenSource = string | (() => string | undefined);
-/** loopback 判定(engineTarget.isLoopbackEngineUrl 逐字镜像;解析失败=非 loopback)。 */
 export declare function isLoopbackWireUrl(url: string): boolean;
-/**
- * §8-2 定谳的**唯一**凭证解析口(B4 收编)—— 11 处构造点的公共分母。
- *
- * 背景(设计稿 §8-2 + B4 实测):壳里今天是 **2 份三态解析**(`engineTarget.resolveLiveAuthToken`
- * 产品半场 + 本包 `wireAuthTokenFor` 纯半场,后者头注自述是前者的「逐字镜像」⇒ 两份必然漂移)
- * 外加 **11 处 `new AgentClient` 直造**,其中 7 处根本不走任何解析口,直接手写
- * `token ?? { mode:'loopback-unauthed' }` —— 那一形**丢了 'anon' 那一态**:非 loopback 且无 token
- * 时它给的是 loopback-unauthed(出站零 Authorization 头),而三态解析给 'anon'。对 fail-closed
- * worker 两者都是 401,但对 **owner-gated 路由**不是同一回事,所以这是真分歧不是等价写法。
- *
- * 🔴 **env 缺省留在端上**:`resolveLiveAuthToken` 的第二参缺省是 `process.env.SEMA_LIVE_TOKEN`,
- * 那一半**绝不进包**(本包零 `process.env` —— portability 门盯着)。壳侧 shim 保留缺省参即可:
- * `resolveLiveAuthToken(u, t = process.env.SEMA_LIVE_TOKEN) => resolveWireAuth(u, t)`。
- *
- * 三态(#118):token 有 ⇒ 原样 Bearer;无 token ∧ loopback ⇒ `{mode:'loopback-unauthed'}`
- * (出站零 Authorization 头,绝不伪造);无 token ∧ 非 loopback ⇒ `'anon'`(fail-closed 换诚实 401)。
- * `baseUrl` 允许 undefined(= `resolveLiveAuthToken` 的签名超集,本地自 spawn 态)⇒ 'anon'。
- */
 export declare function resolveWireAuth(baseUrl: string | undefined, token?: string): WireAuthToken;
-/**
- * #118 三态凭证解析(旧名,B2 引入)。
- * B4 起是 `resolveWireAuth` 的**别名**(baseUrl 必填的窄签名);两者行为逐字相同,保留是为了
- * 壳侧既有 import 零改动 —— 不设代际让位([clean-cut-no-legacy-compat] 只约束**行为面**硬切,
- * 同一函数的两个名字不是两套行为)。新代码一律用 `resolveWireAuth`。
- */
 export declare function wireAuthTokenFor(baseUrl: string, token?: string): WireAuthToken;
-/**
- * TYPESHAPE-12:「向引擎发一次探测请求需要哪些参数」的共用形状(agentsWireCaps.
- * engineSupportsTaskAgents ↔ liveInitToolFace.probeScenarioTools 此前各写一份逐字相同的 4 成员
- * 内联形)。🔴 只统一形状,不统一值:两处 `timeoutMs` 缺省值不同(3000 vs 2000)——这是既有行为
- * 差异,各自在调用点保留现值,改值属于行为变更,不在本次收编授权内。
- */
 export type EngineProbeOpts = {
     fetchImpl?: typeof fetch;
     timeoutMs?: number;
-    /** 串或取值函数({@link WireAuthTokenSource};0.62.0 放宽,串形逐字节零行为差)。 */
     authToken?: WireAuthTokenSource | undefined;
     principal?: string | undefined;
 };
 export type EngineWireClientConfig = {
     baseUrl: string;
-    /** 真 token 串;缺省经 wireAuthTokenFor 三态解析(loopback-unauthed / 'anon')。
-     *
-     *  **取值函数形**({@link WireAuthTokenSource},0.62.0):`() => string | undefined` ——
-     *  **每发一次请求读一次**,不在构造时快照。给「引擎换代后凭证换新、但 client 要接着用」那条路
-     *  (端从此只换值,不必重建 client)。三态语义逐格不变,取不到就按无 token 解析。
-     *
-     *  🔴 中继形与取值函数形**互斥且不同源**:中继是作者的显式声明(「我部署在同源反代后」),
-     *  它结构上就没有 token;取值函数是「凭证会变」,两者不会同时出现在一个配置里。
-     *
-     *  `{ mode: 'same-origin-relay' }`([C175],0.29.0)= **浏览器同源宿主的显式声明形**:凭证由
-     *  同源反代(cookie/session)承载,出站零 Authorization 头;它是 SDK 浏览器守卫的**唯一**豁免形
-     *  (AgentClient 在浏览器宿主拒绝 token/loopback-unauthed/'anon' 三态构造),且该形下 `baseUrl`
-     *  允许相对/同源路径(`''`、`'/api'`)。🔴 这个形**只能显式传入**(作者声明「我部署在同源反代后」),
-     *  绝不由 `resolveWireAuth` 三态解析推导出来 —— 解析口的三态语义一字不动,relay 形直传 SDK。 */
     token?: WireAuthTokenSource | {
         mode: 'same-origin-relay';
     };
-    /** 缺席/undefined=不发 x-agent-principal 头(owner-null;F-011 停发,replEntry live 车道同闸口
-     *  语义;显式 `| undefined` 让 EngineWireTarget.principal 直传合法——exactOptionalPropertyTypes)。 */
     principal?: string | undefined;
-    /** 每次请求的超时预算(SDK 缺省 60s)。 */
     timeoutMs?: number;
-    /** 缺省 0(raw fetch 单发语义);要 SDK 重试的调用方显式传。 */
     maxRetries?: number;
-    /** 测试注入面(探针单测的 fetch stub)。 */
     fetchImpl?: typeof fetch;
 };
-/**
- * 构造一个引擎 wire 用 AgentClient。null = 构造失败(SDK fail-closed 拒绝——不该发生:
- * wireAuthTokenFor 恒给合法形;防御性 fail-soft,调用方按各自离线/探测失败路径处理)。
- */
 export declare function makeEngineWireClient(cfg: EngineWireClientConfig): AgentClient | null;