@sema-agent/client-core 0.6.0 → 0.8.0

package/dist/host.d.ts

@@ -30,8 +30,13 @@ import { type NotificationQueuePort } from './notifications.js';
 export interface SettingsPort {
     /** 按来源取 settings(cli `utils/settings/settings.ts` 的 `getSettingsForSource`)。 */
     getSettingsForSource(source: string): unknown;
-    /** 信任门:该 hook 是否因来源不受信而跳过。**返回 true = 跳过**。 */
-    shouldSkipHookDueToTrust(hook: unknown): boolean;
+    /**
+     * 信任门:hook 是否因工作区未受信而跳过。**返回 true = 跳过**。
+     * 🔴 B6 更正:壳侧真身 `utils/hooks.shouldSkipHookDueToTrust()` 是**零参**的(门是工作区级、
+     * 不是逐条 hook 级)。B4 定口时按「逐条判」写了一个必填参,与真身不符 —— 改成可选参:
+     * 既容得下零参真身,也不妨碍将来某个端要做逐条判。库内唯一调用点(hooksWireCaps)不传参。
+     */
+    shouldSkipHookDueToTrust(hook?: unknown): boolean;
 }
 /**
  * fs 口 —— scratchpad 目录族(cli `utils/permissions/filesystem.ts`)。
@@ -49,6 +54,29 @@ export interface TimersPort {
     setTimer(ms: number, fn: () => void): unknown;
     clearTimer(handle: unknown): void;
 }
+/**
+ * session 口(**B6 引入**)—— 「现在是哪个会话 / 哪个 run 在飞」。
+ *
+ * 为什么必须是端给:这两个量在壳里分别住在 `liveSessionStore`(引擎首轮 done 回填的权威值)+
+ * `bootstrap/state`(壳 boot 时生成的 uuidv7)与 `engineToolDetach`(pty 绑定的活跃 run),
+ * **三个都是宿主生命周期资产**;web 宿主是路由参数 + BFF 会话,桌面是主进程 session-host。
+ *
+ * 🔴 缺席后果**不是**「少个装饰」:`engineSessionParam()` 恒 undefined ⇒ durable 面
+ * (taskOutput/taskStop/subagentOutput)对 session-bound run 一律 **404 fail-closed**
+ * ([1501]§三 / [1498]③),整条子代读面静默哑掉。所以本口**计 miss**。
+ *
+ * 🔴 `currentSessionId()` 绝不返回空串 —— `?session=`(空值)按「带了且不匹配」判 404
+ * ([1501] 空串陷阱);端返空串时库当缺席处理(下面 `engineSessionParam` 有归一)。
+ */
+export interface SessionPort {
+    /** 当前会话 id(壳:引擎捕获值优先、退 boot-time id);两源都缺 ⇒ undefined。 */
+    currentSessionId(): string | undefined;
+    /**
+     * 当前**活跃引擎 run** 的 id(壳 = `engineToolDetach.getActiveEngineTaskId()`,由
+     * X-Task-Id 响应头早捕获)。没有在飞的 turn ⇒ undefined/null 都收。
+     */
+    activeRunId(): string | undefined | null;
+}
 /** `installHost` 的入参 —— 全部可选,缺席即该能力不启用。 */
 export interface HostPorts {
     log?(level: AdapterLogLevel, msg: string, data?: unknown): void;
@@ -58,6 +86,8 @@ export interface HostPorts {
     timers?: TimersPort;
     settings?: SettingsPort;
     fs?: FsPort;
+    /** B6:会话/活跃 run 口(缺席 ⇒ durable 子代面对 session-bound run 恒 404,见 SessionPort)。 */
+    session?: SessionPort;
 }
 /**
  * 装配宿主口。**可多次调用做增量装配**(只覆盖本次给出的键),便于分模块装。
@@ -76,6 +106,8 @@ export declare function hostSettings(): SettingsPort | undefined;
 export declare function hostFs(): FsPort | undefined;
 /** 定时器口(缺席 = undefined,不计 miss:T40 竞速本就允许不启用)。 */
 export declare function hostTimers(): TimersPort | undefined;
+/** session 口(缺席 = undefined + 计 miss:漏装会让整条 durable 子代读面 404 静默哑掉)。 */
+export declare function hostSession(): SessionPort | undefined;
 /**
  * 🔴 宿主自检出口 —— 恒应为空对象。非空 = 有口漏装,**对应的面已经在静默失效**。
  * 含通知队列的 miss(从 notifications.ts 汇过来,宿主只需看这一个数)。

package/dist/host.js

@@ -32,6 +32,8 @@ export function installHost(ports) {
         host.settings = ports.settings;
     if ('fs' in ports)
         host.fs = ports.fs;
+    if ('session' in ports)
+        host.session = ports.session;
     if ('queue' in ports)
         installNotificationQueuePort(ports.queue ?? null);
     return () => {
@@ -58,6 +60,10 @@ export function hostFs() {
 export function hostTimers() {
     return host.timers;
 }
+/** session 口(缺席 = undefined + 计 miss:漏装会让整条 durable 子代读面 404 静默哑掉)。 */
+export function hostSession() {
+    return host.session ?? miss('session');
+}
 /**
  * 🔴 宿主自检出口 —— 恒应为空对象。非空 = 有口漏装,**对应的面已经在静默失效**。
  * 含通知队列的 miss(从 notifications.ts 汇过来,宿主只需看这一个数)。

package/dist/index.d.ts

@@ -5,6 +5,32 @@
  * 沿革:@sema-agent/wire-cc-adapter 0.1.0 = seam 类型 + id 确定性派生 + 首批踩坑纯函数;
  * 0.1.2(#52a)= adapt() 管线首批(纯投影臂全落 + 壳态耦合臂投影成 ChromeEvent + 差分守卫);
  * 0.2.0 = 迁入 sema-client-core 独立仓并改名(旧 npm 名 deprecate 指本包);
+ * 0.8.0 = **B6 批**(设计稿 §3 B6,分两轮落):
+ *   ——【前半,fleet/子代身份族】fleetClient 沿 §2.5 拆两半(帧体归库、连接归端):
+ *   `fleet/fleetProjection` + `fleet/fleetLedger` · 子代 wire 族六件(`subagent/*`)·
+ *   `engineSessionParam`(走新 `SessionPort`)· `engineWireTarget`(七份手抄 `wireConfig()` 收编
+ *   前六份,第七份 `planReviewWire` 属 B7)· G13 taskStop 409 五形 typed · Path B 记号时序修。
+ *   ——【后半,余项收官】① `detachWire` **拆**搬(判定 + cancel-arm 台账进包,信号路径的裸 fetch
+ *   发射留宿主 —— 宪法例外 census C1-4;宿主取件口 `detachCancelArm()`)· `workflowClient` 整搬
+ *   (投影器 + live 源)· `workflowMonitor` 契约(六个类型 + WPe,此前住在 TUI 渲染件里);
+ *   ② **P4 残件三**:`hooksWireCaps`(SettingsPort 的第一个真消费者;port 缺席 = 整体 fail-closed)·
+ *   `liveInitToolFace`(凭证换 §8-2 的 `resolveWireAuth`,三条动态 import 转静态)·
+ *   **model 数据表**(`model/providerPresets.{ts,json}` + `modelFamilies.json` —— `modelBudgetRule`
+ *   封顶① 的 `perModelCap` 的唯一来源;与壳树副本有 byte-identity 漂移锁);
+ *   ③ **P5**:T32/T34/T47/T48/T49(整条进包)与 T35/T36/T44(拆)逐条核实并配断言,新出
+ *   `compensations.ts` 登记表(自检口 `compensationSplitViolations()` 恒应为空)+ **P1-2 归属回落
+ *   定案**(FIFO 回落**不删** = tolerate-absent 保护臂;typed 双键在场恒赢已成对反钉;退役条件
+ *   钉在达标线 ≥ server 1.290)。
+ *   ⚠️ B6 落码事实更正:P5 那八条的**落码全在 B4**,B6 做的是核实 + 登记 + 定案,不是二次搬迁。
+ * 0.7.0 = **B5 批**(设计稿 §3 B5):① **配对台账折回**([1857] —— 0.6.0 把 `notifiedRuns`/
+ *   `cardEnqueuedRuns` 放适配器实例,与清账/记账的另一半不共享前提 = 双卡/UI 零显示/模型二收,
+ *   本批整体折回 notifications.ts 的 module 台账);② **B/D/E 层搬入**(`toolResult.ts`:
+ *   structuredToToolUseResult 14 case + wireOutputToBody 3 臂 + E 层 4 臂),`adapt()` 从此
+ *   自己铸 `tool_result` 卡与两处开卡兜底;③ **structured 白名单吃现货**([1840]§一 30 项 ——
+ *   在场则 T11/T14 正则退位、T24 的 B 层惰性退位,缺席保回落,退位由**调用计数器**钉死);
+ *   ④ **T7 诚实缺席**(§8-4:不搬 mock 合成器,改 `_sema_degraded:'wire_carried_no_output'`)与
+ *   **T20 diff hunks 进包**(`diff/patch.ts`,本包**第一个** runtime dep `diff`)。
+ *   🆕 两个 chrome 臂:`bgshell_register`(#117a 判定在库、执行留宿主)· `task_ledger_sync{source:'structured'}`。
  * 0.6.0 = **B4 批**(设计稿 §3 B4):A 层帧分派**收官**(第 14 臂 `task_progress` + 行绑定/
  *   inline stats/alias/#6 常驻台账/SubagentStart/workflow lane 三级门 + `settlePanelTasks` 三处 sweep
  *   全接线)· P0-2 tool label 侧信道补漏(0.5.0 真缺口)· **请求面合一**(`request/taskRequest.ts`:
@@ -41,7 +67,20 @@
  *   本包放实例级是**有意的**(多 session 宿主上 module 形会让两个会话互吞 SubagentStart,见 DIVERGENCE-6)。
  *   —— B3 新增:adapter/runStream.ts(`inFlightTurns` 计数,读口 `isRunStreamActive()`;
  *   两份实例 = 引擎滚动升级门恒读 false ⇒ **turn 中途热换引擎**,正是它当初要防的事)。
- * 🔴 **宿主装配**——B4 起总入口是 `installHost({log,probe,queue,timers,settings,fs})`
+ *   —— B6 新增(前半):fleet/fleetLedger.ts(`liveBgViews`;两份 ⇒ 引擎温切门恒读空 ⇒ respawn
+ *   静默杀掉在飞 bg 子代)· subagent/engineDelegatedPrompt.ts(`transcriptIdByTask`;两份 ⇒
+ *   Prompt 段恒留白而两边代码看着都对)· engineWireTarget.ts(`installed`)。
+ *   —— B6 新增(后半,按「两份实例会怎样」从重到轻排):
+ *     · **hooksWireCaps.ts**(`wireSessionStopHookPrompt` + `wireSessionStopHookCcSemantics`)——
+ *       写方 = `/goal` 命令层,读方 = 每 turn 的请求构造期 `hooksForWire()`。两份 ⇒ 目标设了、
+ *       投不出去,**而两边代码看着都对**(与 fleetLedger 同一种静默失效)。
+ *     · **detachWire.ts**(`cancelArm`)—— 写方 = `-p` 发头那一刻,读方三个:`isDetachArmed`
+ *       (400 分诊的第一道门)、`detachedTaskId`(分诊文案)、`detachCancelArm`(**宿主发射腿的
+ *       取件口**)。两份 ⇒ 头发了但 hint 判不出 + Ctrl+C 取消不掉,两个静默失效各一半。
+ *     · liveInitToolFace.ts(`cached`)—— 两份只是多探一次 `/v1/capabilities/scenarios/:name`,
+ *       **不是**静默失效;仍登记,免得下次读表的人以为它没状态。
+ *     · model/providerPresets.ts(`presetIndexCache`)—— 由不可变 JSON 派生的纯 memo,两份只费内存。
+ * 🔴 **宿主装配**——B4 起总入口是 `installHost({log,probe,queue,timers,settings,fs,session})`
  *   (`installNotificationQueuePort()` 仍是队列的真源出口,`installHost({queue})` 直通它,两者不分裂);
  *   自检口 `hostPortMisses()` 恒应为空对象,非空 = 有口漏装、对应的面已在静默失效。
  *   —— B2 起的既有说明:`installNotificationQueuePort()` ——
@@ -50,6 +89,13 @@
  *   (runStream 的两条切边:statusline 真 usage / plan-review 审批卡)· `ctx.setTimer`
  *   (T40 IDLE-FLUSH,不给 = 长工具参数生成期已生成内容仍押到下一帧才上屏)· `ctx.signal`
  *   (Esc 中断)· `ctx.log` / `ctx.probe`(诊断面)。
+ *   —— B6 的两个**计 miss** 口(缺席不是「少个装饰」):`session`(缺 ⇒ durable 子代读面对
+ *   session-bound run 一律 404 fail-closed)· `settings`(缺 ⇒ `hooksForWire()` 整体 fail-closed
+ *   返回 undefined —— 信任门是**安全门**,库不会「读不到策略就照投」)。
+ *
+ * 🔴 **补偿层账本**(B6 引入):`MIGRATED_COMPENSATIONS` + `compensationSplitViolations()` ——
+ *   哪条壳侧补偿拆成了「判定归库 / 执行留宿主」、对面挂在哪个 chrome 臂、上游到货后何时退休,
+ *   全做成数据。它**不是** `ADAPTER_DIVERGENCES`(那张表说的是 adapt 与 cli 行为**不同**的地方)。
  */
 export * from './seam.js';
 export * from './workflow.js';
@@ -102,3 +148,30 @@ export * from './request/taskRequest.js';
 export * from './clientSlice.js';
 export * from './host.js';
 export * from './scratchpadWireCaps.js';
+export * from './toolResult.js';
+export * from './diff/patch.js';
+export * from './sandboxWire.js';
+export * from './scenarioWire.js';
+export * from './finalVerifyWire.js';
+export * from './limitsWire.js';
+export * from './interactiveToolsWire.js';
+export * from './headlessPermissionModeWire.js';
+export * from './headlessReconnectWire.js';
+export * from './fleet/fleetProjection.js';
+export * from './fleet/fleetLedger.js';
+export * from './subagent/engineDelegatedPrompt.js';
+export * from './subagent/engineRowStopGate.js';
+export * from './subagent/engineSubagentOutput.js';
+export * from './subagent/engineSubagentSteer.js';
+export * from './subagent/engineTaskHandleWire.js';
+export * from './subagent/engineCompactWire.js';
+export * from './subagent/engineSubagentTail.js';
+export * from './engineSessionParam.js';
+export * from './engineWireTarget.js';
+export * from './detachWire.js';
+export * from './workflowMonitor.js';
+export * from './workflowClient.js';
+export * from './hooksWireCaps.js';
+export * from './liveInitToolFace.js';
+export * from './model/providerPresets.js';
+export * from './compensations.js';

package/dist/index.js

@@ -5,6 +5,32 @@
  * 沿革:@sema-agent/wire-cc-adapter 0.1.0 = seam 类型 + id 确定性派生 + 首批踩坑纯函数;
  * 0.1.2(#52a)= adapt() 管线首批(纯投影臂全落 + 壳态耦合臂投影成 ChromeEvent + 差分守卫);
  * 0.2.0 = 迁入 sema-client-core 独立仓并改名(旧 npm 名 deprecate 指本包);
+ * 0.8.0 = **B6 批**(设计稿 §3 B6,分两轮落):
+ *   ——【前半,fleet/子代身份族】fleetClient 沿 §2.5 拆两半(帧体归库、连接归端):
+ *   `fleet/fleetProjection` + `fleet/fleetLedger` · 子代 wire 族六件(`subagent/*`)·
+ *   `engineSessionParam`(走新 `SessionPort`)· `engineWireTarget`(七份手抄 `wireConfig()` 收编
+ *   前六份,第七份 `planReviewWire` 属 B7)· G13 taskStop 409 五形 typed · Path B 记号时序修。
+ *   ——【后半,余项收官】① `detachWire` **拆**搬(判定 + cancel-arm 台账进包,信号路径的裸 fetch
+ *   发射留宿主 —— 宪法例外 census C1-4;宿主取件口 `detachCancelArm()`)· `workflowClient` 整搬
+ *   (投影器 + live 源)· `workflowMonitor` 契约(六个类型 + WPe,此前住在 TUI 渲染件里);
+ *   ② **P4 残件三**:`hooksWireCaps`(SettingsPort 的第一个真消费者;port 缺席 = 整体 fail-closed)·
+ *   `liveInitToolFace`(凭证换 §8-2 的 `resolveWireAuth`,三条动态 import 转静态)·
+ *   **model 数据表**(`model/providerPresets.{ts,json}` + `modelFamilies.json` —— `modelBudgetRule`
+ *   封顶① 的 `perModelCap` 的唯一来源;与壳树副本有 byte-identity 漂移锁);
+ *   ③ **P5**:T32/T34/T47/T48/T49(整条进包)与 T35/T36/T44(拆)逐条核实并配断言,新出
+ *   `compensations.ts` 登记表(自检口 `compensationSplitViolations()` 恒应为空)+ **P1-2 归属回落
+ *   定案**(FIFO 回落**不删** = tolerate-absent 保护臂;typed 双键在场恒赢已成对反钉;退役条件
+ *   钉在达标线 ≥ server 1.290)。
+ *   ⚠️ B6 落码事实更正:P5 那八条的**落码全在 B4**,B6 做的是核实 + 登记 + 定案,不是二次搬迁。
+ * 0.7.0 = **B5 批**(设计稿 §3 B5):① **配对台账折回**([1857] —— 0.6.0 把 `notifiedRuns`/
+ *   `cardEnqueuedRuns` 放适配器实例,与清账/记账的另一半不共享前提 = 双卡/UI 零显示/模型二收,
+ *   本批整体折回 notifications.ts 的 module 台账);② **B/D/E 层搬入**(`toolResult.ts`:
+ *   structuredToToolUseResult 14 case + wireOutputToBody 3 臂 + E 层 4 臂),`adapt()` 从此
+ *   自己铸 `tool_result` 卡与两处开卡兜底;③ **structured 白名单吃现货**([1840]§一 30 项 ——
+ *   在场则 T11/T14 正则退位、T24 的 B 层惰性退位,缺席保回落,退位由**调用计数器**钉死);
+ *   ④ **T7 诚实缺席**(§8-4:不搬 mock 合成器,改 `_sema_degraded:'wire_carried_no_output'`)与
+ *   **T20 diff hunks 进包**(`diff/patch.ts`,本包**第一个** runtime dep `diff`)。
+ *   🆕 两个 chrome 臂:`bgshell_register`(#117a 判定在库、执行留宿主)· `task_ledger_sync{source:'structured'}`。
  * 0.6.0 = **B4 批**(设计稿 §3 B4):A 层帧分派**收官**(第 14 臂 `task_progress` + 行绑定/
  *   inline stats/alias/#6 常驻台账/SubagentStart/workflow lane 三级门 + `settlePanelTasks` 三处 sweep
  *   全接线)· P0-2 tool label 侧信道补漏(0.5.0 真缺口)· **请求面合一**(`request/taskRequest.ts`:
@@ -41,7 +67,20 @@
  *   本包放实例级是**有意的**(多 session 宿主上 module 形会让两个会话互吞 SubagentStart,见 DIVERGENCE-6)。
  *   —— B3 新增:adapter/runStream.ts(`inFlightTurns` 计数,读口 `isRunStreamActive()`;
  *   两份实例 = 引擎滚动升级门恒读 false ⇒ **turn 中途热换引擎**,正是它当初要防的事)。
- * 🔴 **宿主装配**——B4 起总入口是 `installHost({log,probe,queue,timers,settings,fs})`
+ *   —— B6 新增(前半):fleet/fleetLedger.ts(`liveBgViews`;两份 ⇒ 引擎温切门恒读空 ⇒ respawn
+ *   静默杀掉在飞 bg 子代)· subagent/engineDelegatedPrompt.ts(`transcriptIdByTask`;两份 ⇒
+ *   Prompt 段恒留白而两边代码看着都对)· engineWireTarget.ts(`installed`)。
+ *   —— B6 新增(后半,按「两份实例会怎样」从重到轻排):
+ *     · **hooksWireCaps.ts**(`wireSessionStopHookPrompt` + `wireSessionStopHookCcSemantics`)——
+ *       写方 = `/goal` 命令层,读方 = 每 turn 的请求构造期 `hooksForWire()`。两份 ⇒ 目标设了、
+ *       投不出去,**而两边代码看着都对**(与 fleetLedger 同一种静默失效)。
+ *     · **detachWire.ts**(`cancelArm`)—— 写方 = `-p` 发头那一刻,读方三个:`isDetachArmed`
+ *       (400 分诊的第一道门)、`detachedTaskId`(分诊文案)、`detachCancelArm`(**宿主发射腿的
+ *       取件口**)。两份 ⇒ 头发了但 hint 判不出 + Ctrl+C 取消不掉,两个静默失效各一半。
+ *     · liveInitToolFace.ts(`cached`)—— 两份只是多探一次 `/v1/capabilities/scenarios/:name`,
+ *       **不是**静默失效;仍登记,免得下次读表的人以为它没状态。
+ *     · model/providerPresets.ts(`presetIndexCache`)—— 由不可变 JSON 派生的纯 memo,两份只费内存。
+ * 🔴 **宿主装配**——B4 起总入口是 `installHost({log,probe,queue,timers,settings,fs,session})`
  *   (`installNotificationQueuePort()` 仍是队列的真源出口,`installHost({queue})` 直通它,两者不分裂);
  *   自检口 `hostPortMisses()` 恒应为空对象,非空 = 有口漏装、对应的面已在静默失效。
  *   —— B2 起的既有说明:`installNotificationQueuePort()` ——
@@ -50,6 +89,13 @@
  *   (runStream 的两条切边:statusline 真 usage / plan-review 审批卡)· `ctx.setTimer`
  *   (T40 IDLE-FLUSH,不给 = 长工具参数生成期已生成内容仍押到下一帧才上屏)· `ctx.signal`
  *   (Esc 中断)· `ctx.log` / `ctx.probe`(诊断面)。
+ *   —— B6 的两个**计 miss** 口(缺席不是「少个装饰」):`session`(缺 ⇒ durable 子代读面对
+ *   session-bound run 一律 404 fail-closed)· `settings`(缺 ⇒ `hooksForWire()` 整体 fail-closed
+ *   返回 undefined —— 信任门是**安全门**,库不会「读不到策略就照投」)。
+ *
+ * 🔴 **补偿层账本**(B6 引入):`MIGRATED_COMPENSATIONS` + `compensationSplitViolations()` ——
+ *   哪条壳侧补偿拆成了「判定归库 / 执行留宿主」、对面挂在哪个 chrome 臂、上游到货后何时退休,
+ *   全做成数据。它**不是** `ADAPTER_DIVERGENCES`(那张表说的是 adapt 与 cli 行为**不同**的地方)。
  */
 export * from './seam.js';
 export * from './workflow.js';
@@ -118,3 +164,60 @@ export * from './clientSlice.js';
 export * from './host.js';
 // B2 判给 B4 的宿主耦合件之一(小的那件,同时是 FsPort 的端到端证明)。
 export * from './scratchpadWireCaps.js';
+// ── B5 批:工具结果卡 B/D/E 层 + T20 客户端 diff(2026-07-27)────────────────────────────────
+export * from './toolResult.js';
+export * from './diff/patch.js';
+// ── B5 批(B4 残项第一批):S/ 七件 headless / 部署旋钮 wire(2026-07-27)──────────────────────
+// 🔴 env 默认值从 `process.env` 换成 `hostEnv()`(本包零 process;Node 下是同一对象,
+//    壳侧「不传 env 参数」的调用点行为一字节不变 —— 等价性记账见 hostEnv.ts 头注)。
+export * from './sandboxWire.js';
+export * from './scenarioWire.js';
+export * from './finalVerifyWire.js';
+export * from './limitsWire.js';
+export * from './interactiveToolsWire.js';
+export * from './headlessPermissionModeWire.js';
+export * from './headlessReconnectWire.js';
+// ── B6 批:fleet/子代身份族(2026-07-27)────────────────────────────────────────────────────────
+// `fleetClient.ts` 沿设计稿 §2.5 的那一刀拆两半:**帧体归库、连接归端**。
+// 🔴 单例清单新增三项(两份实例 = 面静默失效,不是报错):
+//   · `fleet/fleetLedger.ts` 的 `liveBgViews`  —— 写=每个 createFleetLedger,读=引擎温切门
+//     (`readEngineActiveBgTasks`)与代际让位读面(`isFleetSessionScoped`)。两份 ⇒ 温切门恒读空
+//     ⇒ respawn 静默杀掉在飞 bg 子代。
+//   · `subagent/engineDelegatedPrompt.ts` 的 `transcriptIdByTask` —— 写=本包 fleetLedger 的行帧/
+//     通知帧臂,读=取件腿。两份 ⇒ Prompt 段恒留白而两边代码看着都对。
+//   · `engineWireTarget.ts` 的 `installed` —— 非 Node 宿主的显式 wire 目标。
+export * from './fleet/fleetProjection.js';
+export * from './fleet/fleetLedger.js';
+export * from './subagent/engineDelegatedPrompt.js';
+export * from './subagent/engineRowStopGate.js';
+export * from './subagent/engineSubagentOutput.js';
+export * from './subagent/engineSubagentSteer.js';
+export * from './subagent/engineTaskHandleWire.js';
+export * from './subagent/engineCompactWire.js';
+export * from './subagent/engineSubagentTail.js';
+export * from './engineSessionParam.js';
+export * from './engineWireTarget.js';
+// B6 余项①:headless detach wire(**拆**:判定+cancel-arm 台账进包,信号路径裸 fetch 发射留宿主
+// —— 设计稿 §3 表脚注「`:221` 裸 cancel = TUI 留」;宿主取件口 = `detachCancelArm()`)。
+export * from './detachWire.js';
+// B6 余项①:workflow 监视器契约(类型 + WPe 派生)与 MF-W live 源。
+// 🔴 `workflowMonitor.ts` 是 `projectWorkflowRun()` 产物的**类型契约**——它此前住在 TUI 的
+//    `overrides/workflow-detail-dialog.tsx` 里,等于「库产出的形状,契约归渲染件所有」。
+export * from './workflowMonitor.js';
+export * from './workflowClient.js';
+// ── B6 余项②(P4 残件三):B2 判给后批的宿主耦合件收官 + model 数据表 ──────────────────────────
+// 🔴 `hooksWireCaps` 是 **SettingsPort 的第一个消费者**(B4 定的口,B6 才接上);port 缺席时它
+//    **整体 fail-closed 返回 undefined** —— 信任门是安全门,不是取值。单实例清单新增:
+//    `wireSessionStopHookPrompt`/`wireSessionStopHookCcSemantics`(`/goal` 会话级 Stop 钩子锁存)。
+export * from './hooksWireCaps.js';
+// 🔴 `liveInitToolFace` 的三条 fail-soft 动态 import 在包内变成静态 import(三件 B5 已在包内),
+//    try/catch 逐条保留(它护的另一半「函数自己抛」在包内照样成立)。单实例:探测缓存 `cached`。
+export * from './liveInitToolFace.js';
+// 🔴 model 数据表 —— `modelBudgetRule.defaultMaxTokensFor()` 的封顶① 参数 `perModelCap` 的**唯一**
+//    来源。表不在包里,那条中央规则在 web/桌面上恒拿不到 cap ⇒ 对 deepseek-chat(8192)这类模型
+//    超发 ⇒ 网关 400。搬迁期与壳树两份 JSON 由 pure 门的 byte-identity 断言锁住。
+export * from './model/providerPresets.js';
+// ── B6 余项③(P5):补偿层登记表 —— 把「哪条补偿拆了、拆缝对面是谁、什么时候能退休」做成数据。
+// 🔴 它**不是** `ADAPTER_DIVERGENCES`(那张表说的是 adapt 与 cli 行为不同的地方;本表里的东西
+//    两侧行为相同)。自检口 `compensationSplitViolations()` 恒应为空。
+export * from './compensations.js';

package/dist/interactiveToolsWire.d.ts

@@ -0,0 +1,48 @@
+/**
+ * src/sema/interactiveToolsWire.ts — headless `-p` 的 TaskRequest.interactiveTools:false stamp
+ * ([909]B 件3,采 [911]② core 正解,2026-07-16)。
+ *
+ * WHY:core 1.296 起 TaskSpec 有 `interactiveTools?: boolean` 三态旋钮(dist/core/types.d.ts:241);
+ * prepare-task.js 两处消费:
+ *   :635 plan 门   `spec.enablePlanMode === true && spec.interactiveTools !== false`
+ *   :974 AskUserQuestion roster `interactiveTools === true || (interactiveTools !== false &&
+ *        (onQuestion !== undefined || durableQuestionFace))`
+ * ⇒ `-p` 无人值守姿势 stamp `false`,AskUserQuestion/plan 门从 roster【源头】全灭(模型压根看不到
+ * 该工具)= [909]A3(headless EnterPlanMode→park 弃 86% 预算)类事故的根治,比 [884]A1 的
+ * park→error 终帧防御纵深更靠前(现在根本不 park)。
+ *
+ * 语义(headlessPermissionModeWire 同点同型 wire):
+ *   · 仅 headless `-p` 车道(本模块只被 seamQueryEngine.ask import;交互 REPL 一根毛不动);
+ *   · 显式交互意图恒赢:CLI 无 --interactive-tools 类旗(gap-check 2026-07-16:上游 CC 2.1.207
+ *     与本壳 argv 面均无,不发明);既有旗里唯一表达「我要交互门」的是 `--permission-mode plan`
+ *     (plan 流程本身要 plan-review 交互)——该旗在场时不 stamp(维持引擎缺省判据);
+ *   · SEMA_HEADLESS_INTERACTIVE_TOOLS 部署旋钮(settings env 车道):true/1 = 不 stamp(回引擎
+ *     缺省判据),false/0 = 显式 stamp false(与缺省同效,显式垫);非法值一次性 warn + 回缺省;
+ *   · 缺省 = stamp false(无人值守正解);
+ *   · 旧 server 白名单 fail-soft:server resolveSpec 逐字段白名单拼 TaskSpec,未知 body 字段静默
+ *     忽略(limits wire 同款勘察结论)——本字段发了白发不炸。gap-check 实拆 server 1.210.0 dist:
+ *     resolveSpec(main.js:1233-)【不】读 body.interactiveTools ⇒ 需 server 半场补一行白名单,
+ *     壳先备(黑板记账)。
+ */
+import { type EnvLike } from './hostEnv.js';
+/** 部署旋钮 env 键名(settings.json env 块 → 1a-envseed → process.env 同车道)。 */
+export declare const HEADLESS_INTERACTIVE_TOOLS_ENV = "SEMA_HEADLESS_INTERACTIVE_TOOLS";
+export type InteractiveToolsResolution = {
+    /** 直接展开进 TaskRequest 的字段({} = 不 stamp)。 */
+    fields: {
+        interactiveTools?: false;
+    };
+    source: 'default' | 'env' | 'plan-flag';
+    /** 非法 env 值的告警文案(调用层一次性打 stderr)。 */
+    warning?: string;
+};
+/** argv 里是否显式要了 plan 交互意图(`--permission-mode plan` / `--permission-mode=plan`;
+ *  后出现者赢,commander 同语义;`--` 之后不是 flag)。 */
+export declare function planModeExplicitlyRequested(argv: readonly string[]): boolean;
+/**
+ * 解析 headless `-p` 的 interactiveTools stamp。纯函数除告警 latch。
+ * 调用方(seamQueryEngine.ask)live-gated:mock/pty 车道永不经过这里。
+ */
+export declare function resolveHeadlessInteractiveTools(argv: readonly string[], env?: EnvLike): InteractiveToolsResolution;
+/** 测试钩子:重置一次性告警 latch。 */
+export declare function _resetInteractiveToolsWireForTest(): void;

package/dist/interactiveToolsWire.js

@@ -0,0 +1,86 @@
+/**
+ * src/sema/interactiveToolsWire.ts — headless `-p` 的 TaskRequest.interactiveTools:false stamp
+ * ([909]B 件3,采 [911]② core 正解,2026-07-16)。
+ *
+ * WHY:core 1.296 起 TaskSpec 有 `interactiveTools?: boolean` 三态旋钮(dist/core/types.d.ts:241);
+ * prepare-task.js 两处消费:
+ *   :635 plan 门   `spec.enablePlanMode === true && spec.interactiveTools !== false`
+ *   :974 AskUserQuestion roster `interactiveTools === true || (interactiveTools !== false &&
+ *        (onQuestion !== undefined || durableQuestionFace))`
+ * ⇒ `-p` 无人值守姿势 stamp `false`,AskUserQuestion/plan 门从 roster【源头】全灭(模型压根看不到
+ * 该工具)= [909]A3(headless EnterPlanMode→park 弃 86% 预算)类事故的根治,比 [884]A1 的
+ * park→error 终帧防御纵深更靠前(现在根本不 park)。
+ *
+ * 语义(headlessPermissionModeWire 同点同型 wire):
+ *   · 仅 headless `-p` 车道(本模块只被 seamQueryEngine.ask import;交互 REPL 一根毛不动);
+ *   · 显式交互意图恒赢:CLI 无 --interactive-tools 类旗(gap-check 2026-07-16:上游 CC 2.1.207
+ *     与本壳 argv 面均无,不发明);既有旗里唯一表达「我要交互门」的是 `--permission-mode plan`
+ *     (plan 流程本身要 plan-review 交互)——该旗在场时不 stamp(维持引擎缺省判据);
+ *   · SEMA_HEADLESS_INTERACTIVE_TOOLS 部署旋钮(settings env 车道):true/1 = 不 stamp(回引擎
+ *     缺省判据),false/0 = 显式 stamp false(与缺省同效,显式垫);非法值一次性 warn + 回缺省;
+ *   · 缺省 = stamp false(无人值守正解);
+ *   · 旧 server 白名单 fail-soft:server resolveSpec 逐字段白名单拼 TaskSpec,未知 body 字段静默
+ *     忽略(limits wire 同款勘察结论)——本字段发了白发不炸。gap-check 实拆 server 1.210.0 dist:
+ *     resolveSpec(main.js:1233-)【不】读 body.interactiveTools ⇒ 需 server 半场补一行白名单,
+ *     壳先备(黑板记账)。
+ */
+import { hostEnv } from './hostEnv.js';
+/** 部署旋钮 env 键名(settings.json env 块 → 1a-envseed → process.env 同车道)。 */
+export const HEADLESS_INTERACTIVE_TOOLS_ENV = 'SEMA_HEADLESS_INTERACTIVE_TOOLS';
+/** argv 里是否显式要了 plan 交互意图(`--permission-mode plan` / `--permission-mode=plan`;
+ *  后出现者赢,commander 同语义;`--` 之后不是 flag)。 */
+export function planModeExplicitlyRequested(argv) {
+    let mode;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--permission-mode') {
+            const v = argv[i + 1];
+            if (typeof v === 'string' && !v.startsWith('-')) {
+                mode = v;
+                i++;
+            }
+        }
+        else if (a?.startsWith('--permission-mode=')) {
+            mode = a.slice('--permission-mode='.length);
+        }
+        else if (a === '--') {
+            break;
+        }
+    }
+    return mode === 'plan';
+}
+// 一次性告警 latch(-p 是 one-shot 进程;测试钩子可重置)
+let warnedInvalidEnv = false;
+/**
+ * 解析 headless `-p` 的 interactiveTools stamp。纯函数除告警 latch。
+ * 调用方(seamQueryEngine.ask)live-gated:mock/pty 车道永不经过这里。
+ */
+export function resolveHeadlessInteractiveTools(argv, env = hostEnv()) {
+    // 1) 显式交互意图恒赢:--permission-mode plan ⇒ 不 stamp(plan 流程要 plan-review 门)。
+    if (planModeExplicitlyRequested(argv)) {
+        return { fields: {}, source: 'plan-flag' };
+    }
+    // 2) 部署旋钮。
+    const raw = env[HEADLESS_INTERACTIVE_TOOLS_ENV]?.trim();
+    if (raw !== undefined && raw !== '') {
+        if (raw === 'true' || raw === '1')
+            return { fields: {}, source: 'env' }; // 回引擎缺省判据
+        if (raw === 'false' || raw === '0')
+            return { fields: { interactiveTools: false }, source: 'env' };
+        const resolution = {
+            fields: { interactiveTools: false },
+            source: 'default',
+        };
+        if (!warnedInvalidEnv) {
+            warnedInvalidEnv = true;
+            resolution.warning = `sema: ${HEADLESS_INTERACTIVE_TOOLS_ENV}="${raw}" is not a boolean (expected true/1/false/0) — ignoring it, headless -p keeps interactive tools OFF by default`;
+        }
+        return resolution;
+    }
+    // 3) 缺省:无人值守 stamp false(AskUserQuestion/plan 门 roster 源头全灭)。
+    return { fields: { interactiveTools: false }, source: 'default' };
+}
+/** 测试钩子:重置一次性告警 latch。 */
+export function _resetInteractiveToolsWireForTest() {
+    warnedInvalidEnv = false;
+}

package/dist/limitsWire.d.ts

@@ -0,0 +1,89 @@
+/**
+ * src/sema/limitsWire.ts — headless `-p` run-limits wire (TB2.0 反馈批 E · P2-3-b, 2026-07-15):
+ * expose the engine's REQUEST-LEVEL pacing limits on the headless `-p` path via `TaskRequest.limits`.
+ * The server accepts `limits:{timeoutSec?,maxOutputTokens?,maxTurns?}` since 1.196.0 (positive-integer
+ * 400 gate, board [857]) and feeds the EXISTING pacing machinery (deadlineNudge / callCapByDeadline /
+ * gracefulFinalize) — the shell simply never stamped the field. This module is the CLI face.
+ *
+ * TWO FLAGS, TWO ALIGNMENT BUCKETS:
+ *  · `--deadline <sec>`   → limits.timeoutSec. Upstream CC 2.1.207 has NO deadline flag (nearest kin:
+ *    --max-turns / --task-budget / --max-budget-usd) → SUPERSET, help copy says so.
+ *  · `--max-turns <n>`    → limits.maxTurns. Upstream CC 2.1.207 HAS `--max-turns` (source 199676 /
+ *    793380) → ALIGNMENT-GAP fill: the flag was already registered (main.tsx CC-inherited surface) and
+ *    drove the local query loop, but the seam path executes turns ENGINE-side — this wire finally
+ *    carries the cap to where the turns actually run.
+ *
+ * PRECEDENCE per knob (flag > settings > none), scenarioWire 三件套同款:
+ *  a) explicit flag                                   → strict validation, FAIL-LOUD on an invalid
+ *     value (integer domain below; a mis-typed pacing bound must not quietly run unbounded).
+ *  b) settings env lane (settings.json `env` block → 1a-envseed → process.env):
+ *     `SEMA_HEADLESS_DEADLINE_SEC` / `SEMA_HEADLESS_MAX_TURNS` → SILENT degrade on an invalid value
+ *     (spec'd 静默降级 — a settings typo must never brick every headless run; unlike scenarioWire we
+ *     don't even warn, per the batch-E triage shape. SEMA_DEBUG surfaces the drop for diagnosis).
+ *  c) neither                                          → NO stamp = today's behaviour, verbatim.
+ *
+ * DOMAINS (integer, inclusive): timeoutSec 30..86400 · maxTurns 1..1000.
+ *
+ * VERSION GATE (triage risk ③ — an OLD server SILENTLY SWALLOWS unknown body fields, worse than not
+ * shipping): the self-spawned engine is release-pinned ≥1.197.0 so the dev/release lanes are safe by
+ * construction; but a user-supplied SEMA_ENGINE_URL may point at an older engine. When the user
+ * EXPLICITLY passed a flag (env-lane defaults stay quiet) and SEMA_ENGINE_URL is in play, the caller
+ * probes `${baseUrl}/health` (the engine self-describes `version` since 1.96) and prints ONE honest
+ * stderr line when version <1.196.0 — the request still goes out unchanged (warn, don't block).
+ * Unreachable /health or an unparsable version stays silent (can't confirm staleness — fail-soft).
+ */
+import { type EnvLike } from './hostEnv.js';
+/** Settings-lane env knobs (settings.json `env` block → 1a-envseed → process.env). */
+export declare const HEADLESS_DEADLINE_ENV = "SEMA_HEADLESS_DEADLINE_SEC";
+export declare const HEADLESS_MAX_TURNS_ENV = "SEMA_HEADLESS_MAX_TURNS";
+/** Integer domains (inclusive). timeoutSec: 30s..24h; maxTurns: 1..1000. */
+export declare const DEADLINE_SEC_MIN = 30;
+export declare const DEADLINE_SEC_MAX = 86400;
+export declare const MAX_TURNS_MIN = 1;
+export declare const MAX_TURNS_MAX = 1000;
+/** First server version whose /v1/tasks|/v1/tasks/stream accept body.limits (board [857]). */
+export declare const LIMITS_WIRE_MIN_ENGINE: readonly [number, number, number];
+export interface HeadlessLimits {
+    timeoutSec?: number;
+    maxTurns?: number;
+}
+export type LimitsParseResult = {
+    ok: true;
+    limits?: HeadlessLimits;
+    flaggedFlags: string[];
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Parse `--deadline` + `--max-turns` out of an argv slice. No flags ⇒ `{ok:true}` with no limits.
+ * Repeated flag ⇒ LAST wins (commander convention). Missing value / non-integer / out-of-domain ⇒
+ * fail-LOUD parse error (never a silent default — same stance as `--scenario`/`--sandbox`).
+ * `flaggedFlags` names the flags that EXPLICITLY contributed (the version-gate probe trigger).
+ */
+export declare function parseLimitsArgv(argv: string[]): LimitsParseResult;
+/**
+ * The settings-lane defaults. SILENT degrade on a bad value (batch-E triage shape — stricter than
+ * scenarioWire's warn-and-ignore: these are pacing hints, and a settings typo must neither brick nor
+ * spam every headless run). SEMA_DEBUG surfaces the drop.
+ */
+export declare function headlessLimitsFromEnv(env?: EnvLike): HeadlessLimits | undefined;
+/**
+ * Resolve the limits for a headless `-p` submit: explicit flags > settings env defaults > none
+ * (= no stamp, today's behaviour). Merge is PER-KNOB: `--deadline 300` + SEMA_HEADLESS_MAX_TURNS=50
+ * yields {timeoutSec:300, maxTurns:50}. Flag parse errors propagate fail-loud; the caller exits.
+ */
+export declare function limitsForPrint(argv: string[], env?: EnvLike): LimitsParseResult;
+/** True when the engine version string satisfies the limits-wire minimum (≥1.196.0). Unparsable ⇒ false. */
+export declare function versionSupportsLimits(v: string | undefined): boolean;
+/**
+ * Version-gate probe (triage risk ③): GET `${baseUrl}/health`, read `version`, and return ONE honest
+ * stderr line when the engine is confirmed <1.196.0 — the caller prints it and SENDS ANYWAY (the old
+ * server drops the field server-side; warn, don't block). Returns undefined when the engine is new
+ * enough, unreachable, or self-describes no parsable version (can't confirm staleness — fail-soft
+ * silent; the release-pinned self-spawn lane never even reaches this probe).
+ */
+export declare function engineLimitsSupportWarning(baseUrl: string, flaggedFlags: string[], opts?: {
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+}): Promise<string | undefined>;